asteroid-odyssey 1.7.116 → 1.7.133

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/index.d.mts +2050 -2051
  2. package/dist/index.d.ts +2050 -2051
  3. package/package.json +1 -1
package/dist/index.d.mts CHANGED
@@ -308,1651 +308,1237 @@ type Options$1<TData extends TDataShape = TDataShape, ThrowOnError extends boole
308
308
  type ClientOptions = {
309
309
  baseUrl: 'https://odyssey.asteroid.ai/agents/v2' | (string & {});
310
310
  };
311
- type AgentsAgentAvailableTool = {
312
- name: string;
313
- description: string;
314
- capability: string;
315
- isRequired: boolean;
311
+ type CommonUuid = string;
312
+ type CommonUnauthorizedErrorBody = {
313
+ code: 401;
314
+ message: string;
316
315
  };
317
- type AgentsAgentAvailableToolsResponse = {
318
- tools: Array<AgentsAgentAvailableTool>;
316
+ type CommonSortDirection = 'asc' | 'desc';
317
+ type CommonPaymentRequiredErrorBody = {
318
+ code: 402;
319
+ message: string;
319
320
  };
320
- type AgentsAgentBase = {
321
- id: CommonUuid;
322
- name: string;
323
- createdAt: string;
324
- organizationId?: CommonUuid;
325
- userId: CommonUuid;
321
+ type CommonOsError = {
322
+ message: string;
326
323
  };
327
- type AgentsAgentCreateRequest = {
328
- organizationId: CommonUuid;
329
- name: string;
330
- workflow: AgentsWorkflowCreateWorkflowRequest;
324
+ type CommonNotFoundErrorBody = {
325
+ code: 404;
326
+ message: string;
331
327
  };
332
- type AgentsAgentCreateResponse = {
333
- id: CommonUuid;
328
+ type CommonInternalServerErrorBody = {
329
+ code: 500;
330
+ message: string;
334
331
  };
335
- type AgentsAgentExecuteAgentRequest = {
332
+ type CommonForbiddenErrorBody = {
333
+ code: 403;
334
+ message: string;
335
+ };
336
+ type CommonError = {
337
+ code: number;
338
+ message: string;
339
+ };
340
+ type CommonConflictErrorBody = {
341
+ code: 409;
342
+ message: string;
343
+ };
344
+ type CommonBadRequestErrorBody = {
345
+ code: 400;
346
+ message: string;
347
+ };
348
+ /**
349
+ * A workflow (commit) representing an immutable snapshot of agent configuration
350
+ */
351
+ type AgentsWorkflowWorkflowSnapshot = {
336
352
  /**
337
- * The ID of the agent profile to use for this execution. Mutually exclusive with agentProfilePoolId.
353
+ * The unique ID of this workflow
338
354
  */
339
- agentProfileId?: CommonUuid;
355
+ id: CommonUuid;
340
356
  /**
341
- * The ID of the agent profile pool to select a profile from. Mutually exclusive with agentProfileId.
357
+ * The agent ID this workflow belongs to
342
358
  */
343
- agentProfilePoolId?: CommonUuid;
359
+ agentId: CommonUuid;
344
360
  /**
345
- * Inputs to be merged into the placeholders defined in prompts
361
+ * The ID of the parent workflow this was derived from (for lineage tracking)
346
362
  */
347
- inputs?: {
348
- [key: string]: unknown;
349
- };
363
+ parentId?: CommonUuid;
350
364
  /**
351
- * Deprecated: Use 'inputs' instead. Inputs to be merged into the placeholders defined in prompts
352
- *
353
- * @deprecated
365
+ * The monotonic per-agent snapshot version number.
354
366
  */
355
- dynamicData?: {
356
- [key: string]: unknown;
357
- };
367
+ version: number;
358
368
  /**
359
- * Array of temporary files to attach to the execution. Must have been pre-uploaded using the stage file endpoint
369
+ * Whether this snapshot is the agent's published version (the API default). At most one snapshot per agent is published.
360
370
  */
361
- tempFiles?: Array<AgentsFilesTempFile>;
371
+ isPublished: boolean;
362
372
  /**
363
- * Optional metadata key-value pairs (string keys and string values) for organizing and filtering executions
373
+ * The rules/instructions for this workflow
364
374
  */
365
- metadata?: {
366
- [key: string]: unknown;
367
- };
375
+ rules: string;
368
376
  /**
369
- * The version of the agent to execute. If not provided, the latest version will be used.
377
+ * The settings for this workflow
370
378
  */
371
- version?: number;
379
+ settings: AgentsGraphModelsSettings;
372
380
  /**
373
- * Per-execution runtime options that override or extend the agent's default settings.
381
+ * The workflow graph
374
382
  */
375
- executionOptions?: AgentsAgentExecutionOptions;
376
- };
377
- type AgentsAgentExecuteAgentResponse = {
383
+ graph: AgentsGraphModelsAgentGraph;
378
384
  /**
379
- * The ID of the newly created execution
385
+ * Optional environment template. Defaults to browser/anchor if not provided.
380
386
  */
381
- executionId: CommonUuid;
382
- };
383
- /**
384
- * Per-execution runtime options.
385
- */
386
- type AgentsAgentExecutionOptions = {
387
+ environmentTemplate?: AgentsWorkflowEnvironmentTemplate;
387
388
  /**
388
- * Scopes shared-file storage to a per-entity subdirectory under each node's shared folder. The value is normalised to a filesystem-safe slug by the server.
389
+ * Typed input definitions for workflow execution. Includes names referenced in prompts, which default to optional strings.
389
390
  */
390
- sharedStorageKey?: string;
391
+ inputs: Array<AgentsWorkflowInput>;
391
392
  /**
392
- * Soft timeout in minutes. When the execution has been running longer than this value, a message is injected on every subsequent step urging the agent to wrap up and produce output. Must be greater than 0 and less than the agent's hard timeout (max_timeout_mins).
393
+ * The files stored on this workflow version. Empty when the workflow has no files.
393
394
  */
394
- softTimeoutMins?: number;
395
- };
396
- type AgentsAgentSortField = 'name' | 'created_at';
397
- type AgentsAgentUpdateRequest = {
395
+ files: Array<AgentsWorkflowWorkflowFile>;
398
396
  /**
399
- * New name for the agent.
397
+ * When this workflow was created. For the editable head this is restamped on each in-place edit, so it doubles as the last-edited time.
400
398
  */
401
- name?: string;
402
- };
403
- type AgentsContextUserContextResponse = {
404
- userId: CommonUuid;
405
- email: string;
406
- organizations: Array<AgentsContextUserOrganization>;
407
- };
408
- type AgentsContextUserOrganization = {
409
- id: CommonUuid;
410
- name: string;
411
- };
412
- /**
413
- * Engagement-activity rows for every organisation that has run an execution or built an agent.
414
- */
415
- type AgentsCustomerActivityCustomerActivityList = {
416
- rows: Array<AgentsCustomerActivityCustomerActivityRow>;
399
+ createdAt: string;
417
400
  /**
418
- * When the snapshot was computed (server time).
401
+ * The email of the user who created this workflow.
419
402
  */
420
- computedAt: string;
403
+ author?: string;
404
+ /**
405
+ * Monotonic optimistic-concurrency revision. Only meaningful for the editable head: supply it as baseRev on the next head patch; a stale baseRev is rejected with 409. Frozen snapshots never receive in-place patches.
406
+ */
407
+ rev: number;
421
408
  };
422
409
  /**
423
- * Per-organisation engagement-activity row for the admin customers dashboard. Owned by the agents service; the frontend joins it onto billing identity on organisationId.
410
+ * A file stored on a workflow version. Content is fetched via the workflow-scoped shared-file download endpoints using this id.
424
411
  */
425
- type AgentsCustomerActivityCustomerActivityRow = {
412
+ type AgentsWorkflowWorkflowFile = {
426
413
  /**
427
- * Organisation ID (usersdb organisation UUID).
414
+ * The unique ID of this file within the workflow version
428
415
  */
429
- organisationId: CommonUuid;
416
+ id: CommonUuid;
430
417
  /**
431
- * Timestamp of the most recent execution. Absent when the org never ran one.
418
+ * The file path, relative to the agent's shared directory
432
419
  */
433
- lastActivityAt?: string;
420
+ filePath: string;
434
421
  /**
435
- * Total agents (workflow groups) ever created by the org.
422
+ * The file's base name
436
423
  */
437
- agentCount: number;
424
+ fileName: string;
438
425
  /**
439
- * Executions created in the last 7 days.
426
+ * The file size in bytes
440
427
  */
441
- execs7d: number;
428
+ fileSize: number;
442
429
  /**
443
- * Executions created in the last 30 days.
430
+ * The file's MIME type, when known
444
431
  */
445
- execs30d: number;
432
+ mimeType?: string;
446
433
  /**
447
- * Distinct UTC days with at least one execution created in the last 14 days. Raw baseline for the digest's sudden-stop signal.
434
+ * Hex-encoded SHA-256 of the file contents, when known
448
435
  */
449
- activeDays14d: number;
436
+ checksum?: string;
450
437
  /**
451
- * Count of ExecutionFailed/ExecutionActionFailed events carrying an os_error (infrastructure/sandbox failure, as opposed to a task failure) in the last 7 days.
438
+ * When this file was first added to the workflow lineage
452
439
  */
453
- osErrorCount7d: number;
440
+ createdAt: string;
454
441
  /**
455
- * completed / (completed+failed) over runs that ended in the last 7 days, 0..1. Absent when fewer than 5 finished runs (volume floor).
442
+ * When this file was last modified
456
443
  */
457
- successRate7d?: number;
444
+ updatedAt: string;
445
+ };
446
+ /**
447
+ * A typed input variable a workflow declares. Referenced as {{.name}} in prompts.
448
+ */
449
+ type AgentsWorkflowInput = {
458
450
  /**
459
- * Risk from inactivity: red >14d, amber 7-14d, green <7d since last activity. Never-active orgs are red.
451
+ * The variable name. Matches [a-zA-Z_][a-zA-Z0-9_]* and is unique within the workflow.
460
452
  */
461
- inactivityRisk: AgentsCustomerActivityRiskLevel;
453
+ name: string;
462
454
  /**
463
- * Risk from success rate: red <30%, amber 30-70%, green >70%. Absent below the volume floor.
455
+ * A single-field JSON Schema fragment describing the input's type, e.g. {type: "string"}, {type: "number"}, {type: "object", properties: {...}}. Validated adaptively at execution time.
464
456
  */
465
- qualityRisk?: AgentsCustomerActivityRiskLevel;
457
+ schema: {
458
+ [key: string]: unknown;
459
+ };
466
460
  /**
467
- * Worse of the two risks. The frontend weights this by MRR to derive the dashboard priority sort.
461
+ * Whether a value must be supplied at execution time. Defaults to false.
468
462
  */
469
- overallRisk: AgentsCustomerActivityRiskLevel;
470
- };
471
- /**
472
- * Window-stats rows for every org with executions in the trailing baseline.
473
- */
474
- type AgentsCustomerActivityCustomerWindowStatsList = {
475
- rows: Array<AgentsCustomerActivityCustomerWindowStatsRow>;
476
- computedAt: string;
477
- };
478
- /**
479
- * Per-org trailing 7-day windows for the customer-health digest deltas.
480
- */
481
- type AgentsCustomerActivityCustomerWindowStatsRow = {
482
- organisationId: CommonUuid;
483
- windows: Array<AgentsCustomerActivityOrgWindowStat>;
463
+ required: boolean;
464
+ /**
465
+ * Optional value used when the input is omitted at execution time.
466
+ */
467
+ defaultValue?: unknown;
468
+ /**
469
+ * Optional human-readable description of the input.
470
+ */
471
+ description?: string;
484
472
  };
485
473
  /**
486
- * Kind of high-intent activity event surfaced in the customer-health digest.
474
+ * Operating system the environment sandbox runs
487
475
  */
488
- type AgentsCustomerActivityNotableActivityKind = 'first_scheduled_agent' | 'first_api_execution' | 'first_agent_built' | 'first_successful_execution' | 'friction';
476
+ type AgentsWorkflowOsType = 'linux' | 'windows';
489
477
  /**
490
- * Notable-activity events in the lookback window. Used by the customer-health Slack digest.
478
+ * OS provider type
491
479
  */
492
- type AgentsCustomerActivityNotableActivityList = {
493
- events: Array<AgentsCustomerActivityNotableActivityRow>;
494
- /**
495
- * Inclusive lower bound on occurredAt (UTC).
496
- */
497
- since: string;
498
- };
480
+ type AgentsWorkflowOsProvider = 'daytona' | 'local';
499
481
  /**
500
- * An org tripped a high-intent activity event within the lookback window.
482
+ * OS environment template configuration
501
483
  */
502
- type AgentsCustomerActivityNotableActivityRow = {
484
+ type AgentsWorkflowOsTemplateConfig = {
503
485
  /**
504
- * Organisation ID (usersdb organisation UUID).
486
+ * OS provider type
505
487
  */
506
- organisationId: CommonUuid;
488
+ provider: AgentsWorkflowOsProvider;
507
489
  /**
508
- * Which event was tripped.
490
+ * Name of the snapshot to use. If omitted or empty, the server uses the configured default snapshot for the selected osType.
509
491
  */
510
- kind: AgentsCustomerActivityNotableActivityKind;
492
+ snapshotName?: string;
511
493
  /**
512
- * When the event occurred (for friction: the most recent qualifying run).
494
+ * Whether the snapshot is public
513
495
  */
514
- occurredAt: string;
496
+ public: boolean;
515
497
  /**
516
- * Optional human-readable detail for the digest line. Absent when no detail applies.
498
+ * Operating system the sandbox runs. Defaults to linux. Setting to windows is admin-only and selects the Windows snapshot/image.
517
499
  */
518
- detail?: string;
500
+ osType?: AgentsWorkflowOsType;
519
501
  };
520
502
  /**
521
- * One 7-day window of an org's execution activity for digest deltas. windowIndex 0 = most recent complete 7 days; 1..12 = trailing baseline.
522
- */
523
- type AgentsCustomerActivityOrgWindowStat = {
524
- windowIndex: number;
525
- execCount: number;
526
- /**
527
- * Runs that produced an execution_result outcome in the window.
528
- */
529
- outcomeTotal: number;
530
- /**
531
- * Agent-recorded outcome label -> count. Label-agnostic; never assume a fixed set.
532
- */
533
- outcomeCounts: {
534
- [key: string]: unknown;
535
- };
536
- };
537
- /**
538
- * Traffic-light engagement-risk level derived from execution activity.
503
+ * Browser provider type
539
504
  */
540
- type AgentsCustomerActivityRiskLevel = 'red' | 'amber' | 'green';
505
+ type AgentsWorkflowBrowserProvider = 'anchor' | 'steel';
541
506
  /**
542
- * Request to search Asteroid documentation
507
+ * Browser environment template configuration
543
508
  */
544
- type AgentsDocsSearchDocsRequest = {
509
+ type AgentsWorkflowBrowserTemplateConfig = {
545
510
  /**
546
- * Search query to find relevant documentation
511
+ * Browser provider type
547
512
  */
548
- query: string;
513
+ provider: AgentsWorkflowBrowserProvider;
549
514
  };
550
515
  /**
551
- * Response containing documentation search results
516
+ * Type of execution environment
552
517
  */
553
- type AgentsDocsSearchDocsResponse = {
554
- /**
555
- * Search results matching the query
556
- */
557
- results: Array<AgentsDocsSearchResult>;
558
- };
518
+ type AgentsWorkflowEnvironmentType = 'browser' | 'os';
559
519
  /**
560
- * A single documentation search result
520
+ * Environment template for workflow execution
561
521
  */
562
- type AgentsDocsSearchResult = {
522
+ type AgentsWorkflowEnvironmentTemplate = {
563
523
  /**
564
- * Result title
524
+ * Type of environment (browser or os)
565
525
  */
566
- title: string;
526
+ type: AgentsWorkflowEnvironmentType;
567
527
  /**
568
- * Result content/snippet
528
+ * Environment-specific configuration
569
529
  */
530
+ config: AgentsWorkflowBrowserTemplateConfig | AgentsWorkflowOsTemplateConfig;
531
+ };
532
+ type AgentsGraphModelsNodesSize = {
533
+ width: number;
534
+ height: number;
535
+ };
536
+ type AgentsGraphModelsStickyNote = {
537
+ id: CommonUuid;
570
538
  content: string;
571
- /**
572
- * Source URL
573
- */
574
- url?: string;
539
+ color?: string;
540
+ position?: AgentsGraphModelsNodesPosition;
541
+ size?: AgentsGraphModelsNodesSize;
542
+ };
543
+ type AgentsGraphModelsNodesPosition = {
544
+ x: number;
545
+ y: number;
546
+ };
547
+ type AgentsGraphModelsTransitionsPropertiesOutcomeSuccessProperties = {
548
+ type: 'outcome_success';
549
+ };
550
+ type AgentsGraphModelsTransitionsPropertiesSelectorProperties = {
551
+ type: 'selector';
552
+ name: string;
553
+ selectors: Array<string>;
554
+ };
555
+ type AgentsGraphModelsTransitionsPropertiesIrisProperties = {
556
+ type: 'iris';
557
+ };
558
+ type AgentsGraphModelsTransitionsTransitionPropertiesUnion = ({
559
+ type: 'iris';
560
+ } & AgentsGraphModelsTransitionsPropertiesIrisProperties) | ({
561
+ type: 'selector';
562
+ } & AgentsGraphModelsTransitionsPropertiesSelectorProperties) | ({
563
+ type: 'outcome_success';
564
+ } & AgentsGraphModelsTransitionsPropertiesOutcomeSuccessProperties);
565
+ type AgentsGraphModelsTransitionsTransitionType = 'iris' | 'selector' | 'outcome_success';
566
+ type AgentsGraphModelsTransitionsTransition = {
567
+ id: CommonUuid;
568
+ from: CommonUuid;
569
+ to: CommonUuid;
570
+ type: AgentsGraphModelsTransitionsTransitionType;
571
+ require_confirmation: boolean;
572
+ description?: string;
573
+ schema?: {
574
+ [key: string]: unknown;
575
+ };
576
+ properties: AgentsGraphModelsTransitionsTransitionPropertiesUnion;
577
+ };
578
+ type AgentsGraphModelsNodesPropertiesOutcomeString = string;
579
+ type AgentsGraphModelsNodesPropertiesOutputProperties = {
580
+ type: 'output';
581
+ instructionsEnabled?: boolean;
582
+ instructions?: string;
583
+ schema?: {
584
+ [key: string]: unknown;
585
+ };
586
+ outcomes: Array<AgentsGraphModelsNodesPropertiesOutcomeString>;
587
+ model?: string;
575
588
  };
576
589
  /**
577
- * API key reference used for authentication
590
+ * @deprecated
578
591
  */
579
- type AgentsExecutionApiKeyRef = {
580
- /**
581
- * API key ID
582
- */
583
- id: CommonUuid;
584
- /**
585
- * API key name
586
- */
592
+ type AgentsGraphModelsNodesPropertiesUrlProperties = {
593
+ type: 'url';
594
+ url: string;
595
+ };
596
+ type AgentsGraphModelsNodesPropertiesApiMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
597
+ /**
598
+ * @deprecated
599
+ */
600
+ type AgentsGraphModelsNodesPropertiesApiProperties = {
601
+ type: 'api';
602
+ method: AgentsGraphModelsNodesPropertiesApiMethod;
603
+ url: string;
604
+ body: {
605
+ [key: string]: unknown;
606
+ };
607
+ headers: {
608
+ [key: string]: unknown;
609
+ };
610
+ };
611
+ type AgentsGraphModelsNodesPropertiesPlaywrightScriptProperties = {
612
+ type: 'playwright_script';
613
+ script: string;
614
+ llm_vars: Array<AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVar>;
615
+ };
616
+ type AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVarType = 'string' | 'number' | 'boolean';
617
+ type AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVar = {
587
618
  name: string;
619
+ type: AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVarType;
620
+ description: string;
621
+ };
622
+ type AgentsGraphModelsNodesPropertiesIrisPlaywrightScriptProperties = {
623
+ script: string;
624
+ llm_vars: Array<AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVar>;
625
+ freeze_script: boolean;
588
626
  };
589
627
  /**
590
- * API-triggered execution context
628
+ * Coarse environment-level capability toggles for an AI node.
591
629
  */
592
- type AgentsExecutionApiTriggerContext = {
630
+ type AgentsGraphModelsNodesPropertiesNodeCapabilities = {
631
+ browser_use: boolean;
632
+ computer_use: boolean;
633
+ ask_user_question: boolean;
634
+ };
635
+ type AgentsGraphModelsNodesPropertiesIrisProperties = {
636
+ type: 'iris';
637
+ instructions: string;
638
+ capabilities?: AgentsGraphModelsNodesPropertiesNodeCapabilities;
639
+ snapshot_compression: boolean;
640
+ compression_strategies?: Array<string>;
641
+ temperature: number;
642
+ playwright_script_properties?: AgentsGraphModelsNodesPropertiesIrisPlaywrightScriptProperties;
643
+ input_schema?: {
644
+ [key: string]: unknown;
645
+ };
593
646
  /**
594
- * Trigger source discriminator
647
+ * Relative path (within the node's own shared directory) of the
648
+ * Playwright script that the runtime should execute before the LLM.
649
+ * Setting this turns the node into a fast-path scripted node — combine
650
+ * with `script_failure_action: "cancel_execution"` to skip the LLM
651
+ * entirely on success and cancel on failure.
652
+ *
653
+ * The path is resolved at runtime against the node's shared
654
+ * directory — i.e. `shared/<node-key>/<script_filepath>` on disk in
655
+ * the sandbox. `<node-key>` is owned by the runtime (currently the
656
+ * node's slug, may move to its UUID), so authors do not have to
657
+ * encode it and renaming a node does not break the path.
658
+ *
659
+ * Examples (typical):
660
+ * - `./scripts/main.js`
661
+ * - `./scripts/login.js`
662
+ *
663
+ * A leading `./` is optional but canonical — both `scripts/main.js` and
664
+ * `./scripts/main.js` are accepted, and the platform normalizes to the
665
+ * `./`-prefixed form when it writes this value back out.
666
+ *
667
+ * Constraints:
668
+ * - Must be relative (no leading `/`).
669
+ * - Must NOT start with `shared/` — it is already relative to the
670
+ * node's shared directory; the runtime adds the `shared/<node-key>/`
671
+ * prefix.
672
+ * - Must end in `.js`.
673
+ * - Must not contain `..` segments or duplicate slashes.
674
+ * - May contain a single `{{shared_storage_key}}` placeholder, which
675
+ * the runtime substitutes with the execution's `shared_storage_key`
676
+ * so a single workflow can target per-tenant script trees (e.g.
677
+ * `{{shared_storage_key}}/scripts/main.js` →
678
+ * `shared/<node-key>/<storage-key>/scripts/main.js`).
595
679
  */
596
- source: 'api';
680
+ script_filepath?: string;
597
681
  /**
598
- * Runner information
682
+ * What happens when a script fails on a scripted node.
683
+ * `fallback_to_ai` (default): fall back to LLM-driven execution.
684
+ * `cancel_execution`: cancel the execution immediately.
599
685
  */
600
- runner: AgentsExecutionTriggerRunner;
686
+ script_failure_action?: 'fallback_to_ai' | 'cancel_execution';
687
+ thinking_mode?: 'adaptive' | 'enabled' | 'disabled';
688
+ thinking_budget_tokens?: number;
689
+ thinking_effort?: 'low' | 'medium' | 'high' | 'max';
601
690
  /**
602
- * API key used for authentication (may be hidden for privacy when admin-triggered)
691
+ * Server-side advisor model the executor consults mid-generation. When set,
692
+ * the node's executor (`model`) defers to this stronger model for harder
693
+ * sub-decisions. Available on the bifrost and anthropic providers; ignored
694
+ * on bedrock.
603
695
  */
604
- apiKey?: AgentsExecutionApiKeyRef;
696
+ advisor_model?: string;
697
+ model: string;
605
698
  };
606
- type AgentsExecutionActionName = 'element_click' | 'element_type' | 'element_select' | 'element_hover' | 'element_drag' | 'element_wait' | 'element_fill_form' | 'element_get_text' | 'element_file_upload' | 'coord_move' | 'coord_click' | 'coord_double_click' | 'coord_triple_click' | 'coord_drag' | 'coord_scroll' | 'nav_to' | 'nav_back' | 'nav_refresh' | 'nav_tabs' | 'nav_close_browser' | 'nav_resize_browser' | 'nav_install_browser' | 'nav_zoom_in' | 'nav_zoom_out' | 'obs_snapshot' | 'obs_snapshot_with_selectors' | 'obs_screenshot' | 'obs_console_messages' | 'obs_network_requests' | 'obs_extract_html' | 'script_eval' | 'script_playwright' | 'script_playwright_llm_vars' | 'script_hybrid_playwright' | 'browser_run_code' | 'browser_press_key' | 'browser_handle_dialog' | 'browser_read_clipboard' | 'browser_solve_captcha' | 'file_list' | 'file_read' | 'file_stage' | 'file_download' | 'file_pdf_save' | 'scratchpad_read' | 'scratchpad_write' | 'scriptpad_run_function' | 'scriptpad_search_replace' | 'scriptpad_read' | 'scriptpad_write' | 'ext_google_sheets_get_data' | 'ext_google_sheets_set_data' | 'ext_get_mail' | 'ext_send_mail' | 'ext_api_call' | 'util_wait_time' | 'util_get_datetime' | 'util_generate_totp_secret' | 'util_send_user_message' | 'agent_query_context' | 'agent_compile_workflow' | 'llm_call' | 'advisor' | 'sdk_bash' | 'sdk_read' | 'sdk_write' | 'sdk_edit' | 'sdk_glob' | 'sdk_grep' | 'sdk_skill' | 'handoff_prepare' | 'read_file';
607
- type AgentsExecutionActivity = {
699
+ type AgentsGraphModelsNodesPropertiesStartProperties = {
700
+ type: 'start';
701
+ };
702
+ type AgentsGraphModelsNodesNodePropertiesUnion = ({
703
+ type: 'start';
704
+ } & AgentsGraphModelsNodesPropertiesStartProperties) | ({
705
+ type: 'iris';
706
+ } & AgentsGraphModelsNodesPropertiesIrisProperties) | ({
707
+ type: 'playwright_script';
708
+ } & AgentsGraphModelsNodesPropertiesPlaywrightScriptProperties) | ({
709
+ type: 'api';
710
+ } & AgentsGraphModelsNodesPropertiesApiProperties) | ({
711
+ type: 'url';
712
+ } & AgentsGraphModelsNodesPropertiesUrlProperties) | ({
713
+ type: 'output';
714
+ } & AgentsGraphModelsNodesPropertiesOutputProperties);
715
+ type AgentsGraphModelsNodesNodeType = 'start' | 'iris' | 'playwright_script' | 'api' | 'url' | 'output';
716
+ type AgentsGraphModelsNodesNode = {
608
717
  id: CommonUuid;
609
- payload: AgentsExecutionActivityPayloadUnion;
610
- executionId: CommonUuid;
611
- timestamp: string;
718
+ name: string;
719
+ type: AgentsGraphModelsNodesNodeType;
720
+ properties: AgentsGraphModelsNodesNodePropertiesUnion;
721
+ position?: AgentsGraphModelsNodesPosition;
722
+ /**
723
+ * Deprecated: field is no longer populated and will be removed.
724
+ *
725
+ * @deprecated
726
+ */
727
+ description?: string;
612
728
  };
613
- type AgentsExecutionActivityActionCompletedInfo = ({
614
- actionName: 'ext_api_call';
615
- } & AgentsExecutionExtApiCallCompletedDetails) | ({
616
- actionName: 'scratchpad_read';
617
- } & AgentsExecutionScratchpadReadCompletedDetails) | ({
618
- actionName: 'scratchpad_write';
619
- } & AgentsExecutionScratchpadWriteCompletedDetails) | ({
620
- actionName: 'script_playwright';
621
- } & AgentsExecutionScriptPlaywrightCompletedDetails) | ({
622
- actionName: 'script_hybrid_playwright';
623
- } & AgentsExecutionScriptHybridPlaywrightCompletedDetails) | ({
624
- actionName: 'browser_run_code';
625
- } & AgentsExecutionBrowserRunCodeCompletedDetails) | ({
626
- actionName: 'script_eval';
627
- } & AgentsExecutionScriptEvalCompletedDetails) | ({
628
- actionName: 'file_read';
629
- } & AgentsExecutionFileReadCompletedDetails) | ({
630
- actionName: 'file_list';
631
- } & AgentsExecutionFileListCompletedDetails) | ({
632
- actionName: 'file_stage';
633
- } & AgentsExecutionFileStageCompletedDetails) | ({
634
- actionName: 'element_file_upload';
635
- } & AgentsExecutionElementFileUploadCompletedDetails) | ({
636
- actionName: 'ext_get_mail';
637
- } & AgentsExecutionExtGetMailCompletedDetails) | ({
638
- actionName: 'scriptpad_run_function';
639
- } & AgentsExecutionScriptPadRunFunctionCompletedDetails) | ({
640
- actionName: 'scriptpad_read';
641
- } & AgentsExecutionScriptpadReadCompletedDetails) | ({
642
- actionName: 'scriptpad_write';
643
- } & AgentsExecutionScriptpadWriteCompletedDetails) | ({
644
- actionName: 'scriptpad_search_replace';
645
- } & AgentsExecutionScriptpadSearchReplaceCompletedDetails) | ({
646
- actionName: 'obs_snapshot_with_selectors';
647
- } & AgentsExecutionObsSnapshotWithSelectorsCompletedDetails) | ({
648
- actionName: 'util_get_datetime';
649
- } & AgentsExecutionUtilGetDatetimeCompletedDetails) | ({
650
- actionName: 'nav_to';
651
- } & AgentsExecutionNavToCompletedDetails) | ({
652
- actionName: 'agent_query_context';
653
- } & AgentsExecutionAgentQueryContextCompletedDetails) | ({
654
- actionName: 'sdk_bash';
655
- } & AgentsExecutionSdkBashCompletedDetails) | ({
656
- actionName: 'sdk_read';
657
- } & AgentsExecutionSdkReadCompletedDetails) | ({
658
- actionName: 'sdk_write';
659
- } & AgentsExecutionSdkWriteCompletedDetails) | ({
660
- actionName: 'sdk_edit';
661
- } & AgentsExecutionSdkEditCompletedDetails) | ({
662
- actionName: 'sdk_glob';
663
- } & AgentsExecutionSdkGlobCompletedDetails) | ({
664
- actionName: 'sdk_grep';
665
- } & AgentsExecutionSdkGrepCompletedDetails) | ({
666
- actionName: 'sdk_skill';
667
- } & AgentsExecutionSdkSkillCompletedDetails) | ({
668
- actionName: 'read_file';
669
- } & AgentsExecutionReadFileCompletedDetails) | ({
670
- actionName: 'handoff_prepare';
671
- } & AgentsExecutionHandoffPrepareCompletedDetails) | ({
672
- actionName: 'ext_send_mail';
673
- } & AgentsExecutionExtSendMailCompletedDetails) | ({
674
- actionName: 'advisor';
675
- } & AgentsExecutionAdvisorCompletedDetails);
676
- type AgentsExecutionActivityActionCompletedPayload = {
677
- activityType: 'action_completed';
678
- message: string;
679
- actionId: string;
680
- actionName: AgentsExecutionActionName;
681
- duration?: number;
682
- info?: AgentsExecutionActivityActionCompletedInfo;
683
- display?: AgentsExecutionActivityDisplay;
684
- };
685
- type AgentsExecutionActivityActionFailedPayload = {
686
- activityType: 'action_failed';
687
- message: string;
688
- actionName: AgentsExecutionActionName;
689
- actionId: string;
690
- duration?: number;
691
- display?: AgentsExecutionActivityDisplay;
692
- };
693
- type AgentsExecutionActivityActionStartedInfo = ({
694
- actionName: 'nav_to';
695
- } & AgentsExecutionNavToStartedDetails) | ({
696
- actionName: 'scratchpad_read';
697
- } & AgentsExecutionScratchpadReadStartedDetails) | ({
698
- actionName: 'scratchpad_write';
699
- } & AgentsExecutionScratchpadWriteStartedDetails) | ({
700
- actionName: 'scriptpad_run_function';
701
- } & AgentsExecutionScriptpadRunFunctionStartedDetails) | ({
702
- actionName: 'script_playwright';
703
- } & AgentsExecutionScriptPlaywrightStartedDetails) | ({
704
- actionName: 'script_hybrid_playwright';
705
- } & AgentsExecutionScriptHybridPlaywrightStartedDetails) | ({
706
- actionName: 'browser_run_code';
707
- } & AgentsExecutionBrowserRunCodeStartedDetails) | ({
708
- actionName: 'script_eval';
709
- } & AgentsExecutionScriptEvalStartedDetails) | ({
710
- actionName: 'scriptpad_search_replace';
711
- } & AgentsExecutionScriptpadSearchReplaceStartedDetails) | ({
712
- actionName: 'util_get_datetime';
713
- } & AgentsExecutionUtilGetDatetimeStartedDetails) | ({
714
- actionName: 'scriptpad_read';
715
- } & AgentsExecutionScriptpadReadStartedDetails) | ({
716
- actionName: 'llm_call';
717
- } & AgentsExecutionLlmCallStartedDetails) | ({
718
- actionName: 'agent_query_context';
719
- } & AgentsExecutionAgentQueryContextStartedDetails) | ({
720
- actionName: 'sdk_bash';
721
- } & AgentsExecutionSdkBashStartedDetails) | ({
722
- actionName: 'sdk_read';
723
- } & AgentsExecutionSdkReadStartedDetails) | ({
724
- actionName: 'sdk_write';
725
- } & AgentsExecutionSdkWriteStartedDetails) | ({
726
- actionName: 'sdk_edit';
727
- } & AgentsExecutionSdkEditStartedDetails) | ({
728
- actionName: 'sdk_glob';
729
- } & AgentsExecutionSdkGlobStartedDetails) | ({
730
- actionName: 'sdk_grep';
731
- } & AgentsExecutionSdkGrepStartedDetails) | ({
732
- actionName: 'sdk_skill';
733
- } & AgentsExecutionSdkSkillStartedDetails) | ({
734
- actionName: 'read_file';
735
- } & AgentsExecutionReadFileStartedDetails) | ({
736
- actionName: 'handoff_prepare';
737
- } & AgentsExecutionHandoffPrepareStartedDetails) | ({
738
- actionName: 'ext_send_mail';
739
- } & AgentsExecutionExtSendMailStartedDetails);
740
- type AgentsExecutionActivityActionStartedPayload = {
741
- activityType: 'action_started';
742
- message: string;
743
- actionName: AgentsExecutionActionName;
744
- actionId: string;
745
- info?: AgentsExecutionActivityActionStartedInfo;
746
- display?: AgentsExecutionActivityDisplay;
729
+ type AgentsGraphModelsAgentGraph = {
730
+ nodes: Array<AgentsGraphModelsNodesNode>;
731
+ transitions: Array<AgentsGraphModelsTransitionsTransition>;
732
+ sticky_notes: Array<AgentsGraphModelsStickyNote>;
747
733
  };
748
- type AgentsExecutionActivityCompactionPerformedPayload = {
749
- activityType: 'compaction_performed';
750
- summaryTokens: number;
751
- durationMs: number;
752
- display?: AgentsExecutionActivityDisplay;
734
+ /**
735
+ * LLM provider for the new agent loop
736
+ */
737
+ type AgentsGraphModelsLlmProvider = 'bedrock' | 'anthropic' | 'bifrost';
738
+ /**
739
+ * Text input method for browser automation
740
+ */
741
+ type AgentsGraphModelsTypeInputMethod = 'type' | 'paste' | 'auto';
742
+ /**
743
+ * Configuration settings for workflow execution
744
+ */
745
+ type AgentsGraphModelsSettings = {
746
+ /**
747
+ * Browser viewport width in pixels
748
+ */
749
+ viewport_width: number;
750
+ /**
751
+ * Browser viewport height in pixels
752
+ */
753
+ viewport_height: number;
754
+ /**
755
+ * Whether to trim screenshots
756
+ */
757
+ trim_screenshots: boolean;
758
+ /**
759
+ * Maximum timeout in minutes
760
+ */
761
+ max_timeout_mins: number;
762
+ /**
763
+ * Text input method for browser automation
764
+ */
765
+ type_input_method: AgentsGraphModelsTypeInputMethod;
766
+ /**
767
+ * Whether to summarize execution results
768
+ */
769
+ summarise?: boolean;
770
+ /**
771
+ * Whether to use the new agent loop for execution (beta)
772
+ */
773
+ new_agent_loop?: boolean;
774
+ /**
775
+ * Exact Daytona snapshot name for agent-loop (admin-only)
776
+ */
777
+ agent_loop_snapshot?: string;
778
+ /**
779
+ * LLM provider override for the new agent loop (admin-only in UI; defaults to server config)
780
+ */
781
+ llm_provider?: AgentsGraphModelsLlmProvider;
782
+ /**
783
+ * Reserved for internal use.
784
+ */
785
+ advanced_tracing?: boolean;
753
786
  };
754
- type AgentsExecutionActivityCompactionStartedPayload = {
755
- activityType: 'compaction_started';
756
- display?: AgentsExecutionActivityDisplay;
787
+ /**
788
+ * Lightweight workflow reference for listing workflows without full data
789
+ */
790
+ type AgentsWorkflowWorkflowRef = {
791
+ /**
792
+ * The unique ID of this workflow
793
+ */
794
+ id: CommonUuid;
795
+ /**
796
+ * The ID of the parent workflow this was derived from (for lineage tracking)
797
+ */
798
+ parentId?: CommonUuid;
799
+ /**
800
+ * The monotonic per-agent snapshot version number.
801
+ */
802
+ version: number;
803
+ /**
804
+ * Whether this snapshot is the agent's published version (the API default). At most one snapshot per agent is published.
805
+ */
806
+ isPublished: boolean;
807
+ /**
808
+ * When this workflow was created
809
+ */
810
+ createdAt: string;
811
+ /**
812
+ * The email of the user who created this workflow.
813
+ */
814
+ author?: string;
815
+ /**
816
+ * Whether this snapshot can be deleted (not published and never executed)
817
+ */
818
+ isDeletable: boolean;
757
819
  };
758
- type AgentsExecutionActivityDisplay = {
759
- turnId?: string;
760
- groupId?: string;
761
- summaryText?: string;
762
- presentationLevel?: AgentsExecutionActivityPresentationLevel;
820
+ /**
821
+ * Output schemas keyed by output node name. Only output nodes that have a schema configured are included; the value is that node's JSON schema.
822
+ */
823
+ type AgentsWorkflowWorkflowOutputSchemas = {
824
+ [key: string]: unknown;
763
825
  };
764
- type AgentsExecutionActivityFileAddedPayload = {
765
- activityType: 'file_added';
766
- fileId: CommonUuid;
767
- fileName: string;
768
- mimeType: string;
769
- fileSize: number;
770
- source: 'upload' | 'download' | 'agent';
771
- presignedUrl: string;
826
+ /**
827
+ * The typed inputs a workflow declares
828
+ */
829
+ type AgentsWorkflowWorkflowInputs = {
830
+ /**
831
+ * Typed input definitions the workflow accepts at execution time
832
+ */
833
+ inputs: Array<AgentsWorkflowInput>;
772
834
  };
773
- type AgentsExecutionActivityGenericPayload = {
774
- activityType: 'generic';
775
- message: string;
776
- display?: AgentsExecutionActivityDisplay;
777
- };
778
- type AgentsExecutionActivityInputSchemaResolvedPayload = {
779
- activityType: 'input_schema_resolved';
780
- nodeId: CommonUuid;
781
- nodeName: string;
782
- properties: Array<string>;
783
- resolved: {
784
- [key: string]: unknown;
785
- };
786
- display?: AgentsExecutionActivityDisplay;
787
- };
788
- type AgentsExecutionActivityPayloadUnion = ({
789
- activityType: 'terminal';
790
- } & AgentsExecutionTerminalPayload) | ({
791
- activityType: 'generic';
792
- } & AgentsExecutionActivityGenericPayload) | ({
793
- activityType: 'reasoning';
794
- } & AgentsExecutionActivityReasoningPayload) | ({
795
- activityType: 'compaction_started';
796
- } & AgentsExecutionActivityCompactionStartedPayload) | ({
797
- activityType: 'compaction_performed';
798
- } & AgentsExecutionActivityCompactionPerformedPayload) | ({
799
- activityType: 'step_started';
800
- } & AgentsExecutionActivityStepStartedPayload) | ({
801
- activityType: 'step_completed';
802
- } & AgentsExecutionActivityStepCompletedPayload) | ({
803
- activityType: 'transitioned_node';
804
- } & AgentsExecutionActivityTransitionedNodePayload) | ({
805
- activityType: 'status_changed';
806
- } & AgentsExecutionActivityStatusChangedPayload) | ({
807
- activityType: 'action_started';
808
- } & AgentsExecutionActivityActionStartedPayload) | ({
809
- activityType: 'action_completed';
810
- } & AgentsExecutionActivityActionCompletedPayload) | ({
811
- activityType: 'action_failed';
812
- } & AgentsExecutionActivityActionFailedPayload) | ({
813
- activityType: 'user_message_received';
814
- } & AgentsExecutionActivityUserMessageReceivedPayload) | ({
815
- activityType: 'file_added';
816
- } & AgentsExecutionActivityFileAddedPayload) | ({
817
- activityType: 'workflow_updated';
818
- } & AgentsExecutionActivityWorkflowUpdatedPayload) | ({
819
- activityType: 'playwright_script_generated';
820
- } & AgentsExecutionActivityPlaywrightScriptGeneratedPayload) | ({
821
- activityType: 'script_variables_substituted';
822
- } & AgentsExecutionActivityScriptVariablesSubstitutedPayload) | ({
823
- activityType: 'input_schema_resolved';
824
- } & AgentsExecutionActivityInputSchemaResolvedPayload) | ({
825
- activityType: 'todos_updated';
826
- } & AgentsExecutionActivityTodosUpdatedPayload);
827
- type AgentsExecutionActivityPlaywrightScriptGeneratedPayload = {
828
- activityType: 'playwright_script_generated';
829
- nodeId: CommonUuid;
830
- nodeName: string;
831
- script: string;
832
- llmVars?: Array<AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVar>;
833
- context: string;
834
- oldScript?: string;
835
- };
836
- type AgentsExecutionActivityPresentationLevel = 'primary' | 'secondary' | 'system';
837
- type AgentsExecutionActivityReasoningPayload = {
838
- activityType: 'reasoning';
839
- reasoning: string;
840
- display?: AgentsExecutionActivityDisplay;
841
- };
842
- type AgentsExecutionActivityScriptVariablesSubstitutedPayload = {
843
- activityType: 'script_variables_substituted';
844
- nodeId: CommonUuid;
845
- nodeName: string;
846
- scriptFileName: string;
847
- placeholders: Array<string>;
848
- variables: {
849
- [key: string]: unknown;
850
- };
851
- substituted: boolean;
852
- display?: AgentsExecutionActivityDisplay;
853
- };
854
- type AgentsExecutionActivityStatusChangedPayload = {
855
- activityType: 'status_changed';
856
- status: AgentsExecutionStatus;
857
- completedPayload?: AgentsExecutionCompletedPayload;
858
- failedPayload?: AgentsExecutionFailedPayload;
859
- pausedPayload?: AgentsExecutionPausedPayload;
860
- awaitingConfirmationPayload?: AgentsExecutionAwaitingConfirmationPayload;
861
- cancelledPayload?: AgentsExecutionCancelledPayload;
862
- };
863
- type AgentsExecutionActivityStepCompletedPayload = {
864
- activityType: 'step_completed';
865
- stepNumber: number;
866
- };
867
- type AgentsExecutionActivityStepStartedPayload = {
868
- activityType: 'step_started';
869
- stepNumber: number;
870
- };
871
- type AgentsExecutionActivityTodosUpdatedPayload = {
872
- activityType: 'todos_updated';
873
- todos: Array<AgentsExecutionTodo>;
874
- display?: AgentsExecutionActivityDisplay;
875
- };
876
- type AgentsExecutionActivityTransitionedNodePayload = {
877
- activityType: 'transitioned_node';
878
- newNodeUUID: CommonUuid;
879
- newNodeName: string;
880
- newNodeType: string;
881
- fromNodeDuration?: number;
882
- transitionType?: AgentsGraphModelsTransitionsTransitionType;
835
+ /**
836
+ * Response after syncing execution to workflow
837
+ */
838
+ type AgentsWorkflowSyncExecutionResponse = {
883
839
  /**
884
- * Output variables provided by the from node
840
+ * The ID of the execution that was synced
885
841
  */
886
- fromNodeOutput?: Array<AgentsExecutionNodeOutputItem>;
842
+ executionId: CommonUuid;
887
843
  /**
888
- * A summary of the work done in the previous node
844
+ * The ID of the workflow the execution is now synced to
889
845
  */
890
- fromNodeSummary?: string;
891
- };
892
- type AgentsExecutionActivityUserMessageReceivedPayload = {
893
- activityType: 'user_message_received';
894
- message: string;
895
- userUUID: CommonUuid;
896
- };
897
- type AgentsExecutionActivityWorkflowUpdatedPayload = {
898
- activityType: 'workflow_updated';
899
- workflowUpdate: Array<AgentsExecutionWorkflowUpdate>;
900
- };
901
- type AgentsExecutionAdvisorCompletedDetails = {
902
- actionName: 'advisor';
903
- advice: string;
904
- };
905
- type AgentsExecutionAgentQueryContextCompletedDetails = {
906
- actionName: 'agent_query_context';
907
- query: string;
908
- answer: string;
909
- };
910
- type AgentsExecutionAgentQueryContextStartedDetails = {
911
- actionName: 'agent_query_context';
912
- query: string;
913
- };
914
- type AgentsExecutionAskUserQuestion = {
915
- questions: Array<AgentsExecutionQuestionItem>;
916
- };
917
- type AgentsExecutionAwaitingConfirmationPayload = {
918
- reason: string;
919
- };
920
- type AgentsExecutionBrowserRunCodeCompletedDetails = {
921
- actionName: 'browser_run_code';
922
- success: boolean;
923
- result: string;
924
- consoleLogs: Array<string>;
925
- failedLine?: number;
926
- };
927
- type AgentsExecutionBrowserRunCodeStartedDetails = {
928
- actionName: 'browser_run_code';
929
- code: string;
930
- };
931
- type AgentsExecutionCancelReason = 'timeout' | 'max_steps' | 'user_requested' | 'script_failed' | 'no_activity' | 'budget_exceeded';
932
- type AgentsExecutionCancelledPayload = {
933
- reason: AgentsExecutionCancelReason;
846
+ workflowId: CommonUuid;
934
847
  };
935
848
  /**
936
- * User comment on an execution
849
+ * Request to sync an execution to a workflow
937
850
  */
938
- type AgentsExecutionComment = {
939
- /**
940
- * Unique identifier for the comment
941
- */
942
- id: CommonUuid;
851
+ type AgentsWorkflowSyncExecutionRequest = {
943
852
  /**
944
- * Execution this comment belongs to
853
+ * The ID of the execution to sync
945
854
  */
946
855
  executionId: CommonUuid;
856
+ };
857
+ /**
858
+ * Response after publishing a workflow
859
+ */
860
+ type AgentsWorkflowPublishWorkflowResponse = {
947
861
  /**
948
- * User who created the comment
949
- */
950
- userId: CommonUuid;
951
- /**
952
- * Comment content
953
- */
954
- content: string;
955
- /**
956
- * Whether the comment is public
862
+ * The ID of the published workflow
957
863
  */
958
- public: boolean;
864
+ workflowId: CommonUuid;
959
865
  /**
960
- * When the comment was created
866
+ * The assigned version number
961
867
  */
962
- createdAt: string;
868
+ version: number;
869
+ };
870
+ /**
871
+ * Response after starting workflow execution
872
+ */
873
+ type AgentsWorkflowExecuteWorkflowResponse = {
963
874
  /**
964
- * When the comment was last updated
875
+ * The ID of the newly created execution
965
876
  */
966
- updatedAt?: string;
967
- };
968
- type AgentsExecutionCompletedPayload = {
969
- outcome: string;
970
- reasoning: string;
971
- result: unknown;
972
- };
973
- type AgentsExecutionElementFileUploadCompletedDetails = {
974
- actionName: 'element_file_upload';
975
- fileNames: Array<string>;
877
+ executionId: CommonUuid;
976
878
  };
977
879
  /**
978
- * Execution result containing outcome, reasoning, and result data
880
+ * Request to execute a workflow by ID
979
881
  */
980
- type AgentsExecutionExecutionResult = {
882
+ type AgentsWorkflowExecuteWorkflowRequest = {
981
883
  /**
982
- * Unique identifier for the result
884
+ * Input variables to be merged into the placeholders defined in prompts
983
885
  */
984
- id: CommonUuid;
886
+ inputVariables?: {
887
+ [key: string]: unknown;
888
+ };
985
889
  /**
986
- * Execution this result belongs to
890
+ * Optional metadata key-value pairs for organizing and filtering executions
987
891
  */
988
- executionId: CommonUuid;
892
+ metadata?: {
893
+ [key: string]: unknown;
894
+ };
989
895
  /**
990
- * Outcome of the execution (success or failure)
896
+ * The ID of the agent profile to use. Note this is not the agent ID
991
897
  */
992
- outcome: string;
898
+ agentProfileId?: CommonUuid;
993
899
  /**
994
- * AI reasoning for the outcome
900
+ * The ID of the agent profile pool to select a profile from. Mutually exclusive with agentProfileId.
995
901
  */
996
- reasoning: string;
902
+ agentProfilePoolId?: CommonUuid;
997
903
  /**
998
- * Result data as JSON
904
+ * Array of temporary files to attach to the execution. Must have been pre-uploaded using the stage file endpoint
999
905
  */
1000
- result: unknown;
906
+ tempFiles?: Array<AgentsFilesTempFile>;
1001
907
  /**
1002
- * When the result was created
908
+ * Per-execution runtime options that override or extend the agent's default settings.
1003
909
  */
1004
- createdAt: string;
910
+ executionOptions?: AgentsAgentExecutionOptions;
911
+ /**
912
+ * ID of the execution this is a rerun of. Sets parent_execution_id on the new execution and has_been_rerun on the parent.
913
+ */
914
+ parentExecutionId?: CommonUuid;
1005
915
  };
1006
- type AgentsExecutionExtApiCallCompletedDetails = {
1007
- actionName: 'ext_api_call';
1008
- statusCode: string;
1009
- responseBody: string;
1010
- requestMethod?: string;
1011
- requestUrl?: string;
1012
- };
1013
- type AgentsExecutionExtGetMailCompletedDetails = {
1014
- actionName: 'ext_get_mail';
1015
- emailCount: number;
1016
- emails: Array<unknown>;
1017
- };
1018
- type AgentsExecutionExtSendMailCompletedDetails = {
1019
- actionName: 'ext_send_mail';
1020
- success: boolean;
1021
- emailId?: string;
1022
- };
1023
- type AgentsExecutionExtSendMailStartedDetails = {
1024
- actionName: 'ext_send_mail';
1025
- to: Array<string>;
1026
- subject: string;
1027
- cc?: Array<string>;
1028
- bcc?: Array<string>;
1029
- bodyPreview?: string;
1030
- };
1031
- type AgentsExecutionFailedPayload = {
1032
- reason: string;
1033
- os_error?: CommonOsError;
1034
- };
1035
- type AgentsExecutionFileListCompletedDetails = {
1036
- actionName: 'file_list';
1037
- fileNames: Array<string>;
1038
- };
1039
- type AgentsExecutionFileReadCompletedDetails = {
1040
- actionName: 'file_read';
1041
- fileNames: Array<string>;
1042
- errorCount?: number;
1043
- totalSizeBytes?: number;
1044
- };
1045
- type AgentsExecutionFileStageCompletedDetails = {
1046
- actionName: 'file_stage';
1047
- fileNames: Array<string>;
1048
- };
1049
- type AgentsExecutionHandoffPrepareCompletedDetails = {
1050
- actionName: 'handoff_prepare';
1051
- success: boolean;
1052
- };
1053
- type AgentsExecutionHandoffPrepareStartedDetails = {
1054
- actionName: 'handoff_prepare';
1055
- target?: string;
1056
- summary?: string;
1057
- variables?: Array<AgentsExecutionHandoffPrepareVariable>;
916
+ /**
917
+ * Per-execution runtime options.
918
+ */
919
+ type AgentsAgentExecutionOptions = {
920
+ /**
921
+ * Scopes shared-file storage to a per-entity subdirectory under each node's shared folder. The value is normalised to a filesystem-safe slug by the server.
922
+ */
923
+ sharedStorageKey?: string;
924
+ /**
925
+ * Soft timeout in minutes. When the execution has been running longer than this value, a message is injected on every subsequent step urging the agent to wrap up and produce output. Must be greater than 0 and less than the agent's hard timeout (max_timeout_mins).
926
+ */
927
+ softTimeoutMins?: number;
1058
928
  };
1059
- type AgentsExecutionHandoffPrepareVariable = {
929
+ type AgentsFilesTempFile = {
930
+ id: CommonUuid;
1060
931
  name: string;
1061
- value: string;
1062
932
  };
1063
933
  /**
1064
- * Human-applied label for categorizing executions
934
+ * Response after creating a workflow
1065
935
  */
1066
- type AgentsExecutionHumanLabel = {
936
+ type AgentsWorkflowCreateWorkflowResponse = {
1067
937
  /**
1068
- * Unique identifier for the label
938
+ * The ID of the newly created workflow
1069
939
  */
1070
- id: CommonUuid;
940
+ workflowId: CommonUuid;
941
+ };
942
+ /**
943
+ * Request to create a new unpublished workflow
944
+ */
945
+ type AgentsWorkflowCreateWorkflowRequest = {
1071
946
  /**
1072
- * Organization this label belongs to
947
+ * Optional parent workflow ID to derive from
1073
948
  */
1074
- organizationId: CommonUuid;
949
+ parentId?: CommonUuid;
1075
950
  /**
1076
- * Display name of the label
951
+ * The rules/instructions for this workflow
1077
952
  */
1078
- name: string;
953
+ rules: string;
1079
954
  /**
1080
- * Hex color code for the label (e.g., #FF5733)
955
+ * The settings for this workflow
1081
956
  */
1082
- color: string;
957
+ settings: AgentsGraphModelsSettings;
1083
958
  /**
1084
- * When the label was created
959
+ * The workflow graph
1085
960
  */
1086
- createdAt: string;
1087
- };
1088
- type AgentsExecutionLlmCallPurpose = 'iris_pick_next_action' | 'transition_pick_next_node' | 'output_populate_result' | 'generate_hybrid_playwright_code' | 'generate_playwright_variables';
1089
- type AgentsExecutionLlmCallStartedDetails = {
1090
- actionName: 'llm_call';
1091
- purpose: AgentsExecutionLlmCallPurpose;
961
+ graph: AgentsGraphModelsAgentGraph;
962
+ /**
963
+ * Optional environment template. Defaults to browser/anchor if not provided.
964
+ */
965
+ environmentTemplate?: AgentsWorkflowEnvironmentTemplate;
966
+ /**
967
+ * Typed input definitions for this workflow. Names referenced in prompts but omitted here default to optional strings.
968
+ */
969
+ inputs?: Array<AgentsWorkflowInput>;
1092
970
  };
1093
971
  /**
1094
- * Represents a single execution in a list view
972
+ * Response from schema validation
1095
973
  */
1096
- type AgentsExecutionListItem = {
974
+ type AgentsSchemaValidateSchemaResponse = {
1097
975
  /**
1098
- * The unique identifier of the execution
976
+ * Whether the schema is valid
1099
977
  */
1100
- id: CommonUuid;
978
+ valid: boolean;
1101
979
  /**
1102
- * The ID of the agent that was executed
980
+ * List of validation error messages (empty if valid)
1103
981
  */
1104
- agentId: CommonUuid;
982
+ errors: Array<string>;
983
+ };
984
+ /**
985
+ * Request to validate a JSON schema against OpenAI structured output requirements
986
+ */
987
+ type AgentsSchemaValidateSchemaRequest = {
1105
988
  /**
1106
- * The ID of the workflow that was executed
989
+ * The JSON schema to validate
1107
990
  */
1108
- workflowId: CommonUuid;
991
+ schema: {
992
+ [key: string]: unknown;
993
+ };
994
+ };
995
+ /**
996
+ * Request to update an existing agent profile
997
+ */
998
+ type AgentsProfileUpdateAgentProfileRequest = {
1109
999
  /**
1110
- * The current status of the execution
1000
+ * New name for the profile
1111
1001
  */
1112
- status: AgentsExecutionStatus;
1002
+ name?: string;
1113
1003
  /**
1114
- * When the execution was created
1004
+ * New description for the profile
1115
1005
  */
1116
- createdAt: string;
1006
+ description?: string;
1117
1007
  /**
1118
- * When the execution reached a terminal state (if applicable)
1008
+ * Proxy configuration mode
1119
1009
  */
1120
- terminalAt?: string;
1010
+ proxyMode?: AgentsProfileProxyMode;
1121
1011
  /**
1122
- * The organization this execution belongs to
1012
+ * Country code for proxy location (for managed proxy mode)
1123
1013
  */
1124
- organizationId: CommonUuid;
1014
+ proxyCC?: AgentsProfileCountryCode;
1125
1015
  /**
1126
- * The agent display name
1016
+ * Type of managed proxy to use (for managed proxy mode)
1127
1017
  */
1128
- agentName: string;
1018
+ proxyType?: AgentsProfileProxyType;
1129
1019
  /**
1130
- * The name of the agent profile used for this execution (if any)
1020
+ * Custom proxy configuration (for custom proxy mode)
1131
1021
  */
1132
- agentProfileName?: string;
1022
+ customProxy?: AgentsProfileCustomProxyConfigInput;
1133
1023
  /**
1134
- * The ID of the agent profile used for this execution (if any)
1024
+ * Proxy gateway preset ID (for gateway proxy mode)
1135
1025
  */
1136
- agentProfileId?: CommonUuid;
1026
+ proxyGatewayPresetId?: CommonUuid;
1137
1027
  /**
1138
- * Input variables used for this execution
1028
+ * Whether the captcha solver should be active (managed proxy only)
1139
1029
  */
1140
- inputs?: {
1141
- [key: string]: unknown;
1142
- };
1030
+ captchaSolverActive?: boolean;
1143
1031
  /**
1144
- * Execution result with outcome, reasoning, and result data
1032
+ * Operating system to emulate
1145
1033
  */
1146
- executionResult?: AgentsExecutionExecutionResult;
1034
+ operatingSystem?: AgentsProfileOperatingSystem;
1147
1035
  /**
1148
- * Execution duration in seconds (only present for terminal executions)
1036
+ * Whether to enable extra stealth mode
1149
1037
  */
1150
- duration?: number;
1038
+ extraStealth?: boolean;
1151
1039
  /**
1152
- * Human-applied labels for this execution
1040
+ * Whether to allow third-party cookies
1153
1041
  */
1154
- humanLabels: Array<AgentsExecutionHumanLabel>;
1042
+ allow3rdCookies?: boolean;
1155
1043
  /**
1156
- * Comments on this execution
1044
+ * Whether to persist browser cache between sessions
1157
1045
  */
1158
- comments: Array<AgentsExecutionComment>;
1046
+ cachePersistence?: boolean;
1159
1047
  /**
1160
- * Optional metadata key-value pairs attached to this execution
1048
+ * Whether to enable ad blocking
1161
1049
  */
1162
- metadata?: {
1163
- [key: string]: unknown;
1164
- };
1050
+ adblockActive?: boolean;
1165
1051
  /**
1166
- * Recording URL for playback (if an environment was used and execution is terminal)
1052
+ * Whether to enable popup blocking (requires adblock to be active)
1167
1053
  */
1168
- recordingUrl?: string;
1054
+ popupBlockerActive?: boolean;
1169
1055
  /**
1170
- * Live view URL for debugging (if an environment is active and execution is running)
1056
+ * Whether to force popups to open as tabs
1171
1057
  */
1172
- liveViewUrl?: string;
1058
+ forcePopupsAsTabsActive?: boolean;
1173
1059
  /**
1174
- * Deprecated: Use 'recordingUrl' instead.
1175
- *
1176
- * @deprecated
1060
+ * Whether to enable media blocking (images, videos, etc.)
1177
1061
  */
1178
- browserRecordingUrl?: string;
1062
+ mediaBlockerActive?: boolean;
1179
1063
  /**
1180
- * Deprecated: Use 'liveViewUrl' instead.
1181
- *
1182
- * @deprecated
1064
+ * Whether to enable the built-in PDF viewer (if disabled, PDFs are downloaded)
1183
1065
  */
1184
- browserLiveViewUrl?: string;
1066
+ pdfViewerActive?: boolean;
1185
1067
  /**
1186
- * Context about how and by whom this execution was triggered (discriminated by source)
1068
+ * Whether browser tracing is enabled (admin only)
1187
1069
  */
1188
- triggerContext?: AgentsExecutionTriggerContext;
1070
+ tracingEnabled?: boolean;
1189
1071
  /**
1190
- * Per-execution runtime options (e.g. shared storage key)
1072
+ * Stable org extension IDs to attach to this profile
1191
1073
  */
1192
- executionOptions?: AgentsAgentExecutionOptions;
1074
+ extensionIds?: Array<CommonUuid>;
1193
1075
  /**
1194
- * Whether this execution has been rerun at least once
1076
+ * Optional custom prefix for the agent's inbox email address. If set, the inbox will be {prefix}@agentmail.asteroid.ai.
1195
1077
  */
1196
- hasBeenRerun: boolean;
1078
+ inboxEmailPrefix?: string;
1197
1079
  /**
1198
- * ID of the execution this was rerun from, if applicable
1080
+ * Credentials to add to the profile
1199
1081
  */
1200
- parentExecutionId?: CommonUuid;
1082
+ credentialsToAdd?: Array<AgentsProfileCredential>;
1201
1083
  /**
1202
- * Script failures recorded for this execution (omitted when none occurred)
1084
+ * Credentials to update by name (matched case-insensitively)
1203
1085
  */
1204
- scriptFailures?: Array<AgentsExecutionScriptFailure>;
1205
- };
1206
- type AgentsExecutionNavToCompletedDetails = {
1207
- actionName: 'nav_to';
1208
- pageTitle?: string;
1209
- };
1210
- type AgentsExecutionNavToStartedDetails = {
1211
- actionName: 'nav_to';
1212
- url: string;
1213
- };
1214
- type AgentsExecutionNodeDetails = {
1215
- nodeID: CommonUuid;
1216
- nodeName: string;
1217
- nodeType: string;
1218
- };
1219
- /**
1220
- * A single output variable with a name and value
1221
- */
1222
- type AgentsExecutionNodeOutputItem = {
1086
+ credentialsToUpdate?: Array<AgentsProfileCredentialUpdate>;
1223
1087
  /**
1224
- * The name of the output variable
1088
+ * IDs of credentials to remove from the profile
1225
1089
  */
1226
- name: string;
1090
+ credentialsToDelete?: Array<CommonUuid>;
1227
1091
  /**
1228
- * The value of the output variable
1092
+ * Cookies to add to the profile
1229
1093
  */
1230
- value: string;
1231
- };
1232
- type AgentsExecutionObsSnapshotWithSelectorsCompletedDetails = {
1233
- actionName: 'obs_snapshot_with_selectors';
1234
- url: string;
1235
- title: string;
1236
- };
1237
- type AgentsExecutionPausedPayload = {
1238
- reason: string;
1239
- question?: AgentsExecutionAskUserQuestion;
1240
- };
1241
- type AgentsExecutionQuestionItem = {
1242
- question: string;
1243
- header: string;
1244
- options: Array<AgentsExecutionQuestionOption>;
1245
- multiSelect?: boolean;
1246
- };
1247
- type AgentsExecutionQuestionOption = {
1248
- label: string;
1249
- description: string;
1250
- };
1251
- type AgentsExecutionReadFileCompletedDetails = {
1252
- actionName: 'read_file';
1253
- contentType: 'image' | 'document' | 'text' | 'unknown';
1254
- mimeType?: string;
1255
- content?: string;
1256
- };
1257
- type AgentsExecutionReadFileStartedDetails = {
1258
- actionName: 'read_file';
1259
- filePath: string;
1260
- };
1261
- type AgentsExecutionRulesDetails = {
1262
- rules: string;
1094
+ cookiesToAdd?: Array<AgentsProfileCookie>;
1095
+ /**
1096
+ * IDs of cookies to remove from the profile
1097
+ */
1098
+ cookiesToDelete?: Array<CommonUuid>;
1263
1099
  };
1264
1100
  /**
1265
- * Schedule reference for schedule-triggered executions
1101
+ * SameSite attribute for cookies
1266
1102
  */
1267
- type AgentsExecutionScheduleRef = {
1103
+ type AgentsProfileSameSite = 'Strict' | 'Lax' | 'None';
1104
+ /**
1105
+ * A browser cookie stored for an agent profile
1106
+ */
1107
+ type AgentsProfileCookie = {
1268
1108
  /**
1269
- * Schedule ID
1109
+ * Unique identifier for the cookie
1270
1110
  */
1271
- id: CommonUuid;
1111
+ id?: CommonUuid;
1272
1112
  /**
1273
- * Cron expression of the schedule
1113
+ * Display name for the cookie
1274
1114
  */
1275
- cronExpression: string;
1115
+ name: string;
1116
+ /**
1117
+ * The cookie key/name as sent in HTTP headers
1118
+ */
1119
+ key: string;
1120
+ /**
1121
+ * The cookie value
1122
+ */
1123
+ value: string;
1124
+ /**
1125
+ * When the cookie expires (optional)
1126
+ */
1127
+ expiry?: string;
1128
+ /**
1129
+ * The domain for which the cookie is valid
1130
+ */
1131
+ domain: string;
1132
+ /**
1133
+ * Whether the cookie should only be sent over HTTPS
1134
+ */
1135
+ secure: boolean;
1136
+ /**
1137
+ * SameSite attribute for the cookie
1138
+ */
1139
+ sameSite: AgentsProfileSameSite;
1140
+ /**
1141
+ * Whether the cookie should be accessible only via HTTP(S)
1142
+ */
1143
+ httpOnly: boolean;
1144
+ /**
1145
+ * When the cookie was created
1146
+ */
1147
+ createdAt?: string;
1276
1148
  };
1277
1149
  /**
1278
- * Schedule-triggered execution context
1150
+ * Request to update an existing credential by name
1279
1151
  */
1280
- type AgentsExecutionScheduleTriggerContext = {
1152
+ type AgentsProfileCredentialUpdate = {
1281
1153
  /**
1282
- * Trigger source discriminator
1154
+ * Name of the credential to update (case-insensitive, will be matched as uppercase)
1283
1155
  */
1284
- source: 'schedule';
1156
+ name: string;
1285
1157
  /**
1286
- * Schedule that triggered the execution
1158
+ * New credential value (plaintext - will be encrypted server-side)
1287
1159
  */
1288
- schedule: AgentsExecutionScheduleRef;
1289
- };
1290
- type AgentsExecutionScratchpadReadCompletedDetails = {
1291
- actionName: 'scratchpad_read';
1292
- content?: string;
1293
- contentTruncated?: boolean;
1294
- };
1295
- type AgentsExecutionScratchpadReadStartedDetails = {
1296
- actionName: 'scratchpad_read';
1297
- operation: 'read';
1160
+ data: string;
1298
1161
  };
1299
- type AgentsExecutionScratchpadWriteCompletedDetails = {
1300
- actionName: 'scratchpad_write';
1301
- linesChanged: number;
1302
- totalLines: number;
1303
- patchesApplied: number;
1304
- content?: string;
1305
- contentTruncated?: boolean;
1162
+ /**
1163
+ * A credential stored for an agent profile
1164
+ */
1165
+ type AgentsProfileCredential = {
1166
+ /**
1167
+ * Unique identifier for the credential
1168
+ */
1169
+ id?: CommonUuid;
1170
+ /**
1171
+ * Display name for the credential (will be uppercased)
1172
+ */
1173
+ name: string;
1174
+ /**
1175
+ * The credential value (plaintext - will be encrypted server-side)
1176
+ */
1177
+ data: string;
1178
+ /**
1179
+ * When the credential was created
1180
+ */
1181
+ createdAt?: string;
1306
1182
  };
1307
- type AgentsExecutionScratchpadWriteStartedDetails = {
1308
- actionName: 'scratchpad_write';
1309
- operation: 'write';
1183
+ /**
1184
+ * Operating system to emulate in the browser
1185
+ */
1186
+ type AgentsProfileOperatingSystem = 'macos' | 'windows';
1187
+ /**
1188
+ * Custom proxy server configuration for input (includes password)
1189
+ */
1190
+ type AgentsProfileCustomProxyConfigInput = {
1191
+ /**
1192
+ * Proxy server address including protocol and port (e.g., 'socks5://proxy.example.com:1080' or 'http://proxy.example.com:8080')
1193
+ */
1194
+ server: string;
1195
+ /**
1196
+ * Proxy authentication username
1197
+ */
1198
+ username: string;
1199
+ /**
1200
+ * Proxy authentication password
1201
+ */
1202
+ password: string;
1310
1203
  };
1311
- type AgentsExecutionScriptEvalCompletedDetails = {
1312
- actionName: 'script_eval';
1313
- result: unknown;
1204
+ /**
1205
+ * Type of managed proxy to use for browser sessions
1206
+ */
1207
+ type AgentsProfileProxyType = 'basic';
1208
+ /**
1209
+ * Two-letter country code for proxy location
1210
+ */
1211
+ type AgentsProfileCountryCode = 'us' | 'uk' | 'fr' | 'it' | 'jp' | 'au' | 'de' | 'fi' | 'ca';
1212
+ /**
1213
+ * Proxy configuration mode
1214
+ */
1215
+ type AgentsProfileProxyMode = 'none' | 'managed' | 'custom' | 'gateway';
1216
+ /**
1217
+ * Request to update an existing agent profile pool
1218
+ */
1219
+ type AgentsProfileUpdateAgentProfilePoolRequest = {
1220
+ /**
1221
+ * New name for the pool
1222
+ */
1223
+ name?: string;
1224
+ /**
1225
+ * New selection strategy for the pool
1226
+ */
1227
+ selectionStrategy?: AgentsProfileSelectionStrategy;
1228
+ /**
1229
+ * Whether multiple executions can use the same profile concurrently
1230
+ */
1231
+ allowConcurrentUse?: boolean;
1314
1232
  };
1315
- type AgentsExecutionScriptEvalStartedDetails = {
1316
- actionName: 'script_eval';
1317
- element?: string;
1318
- ref?: string;
1319
- function: string;
1233
+ /**
1234
+ * Strategy for selecting an available profile from a pool
1235
+ */
1236
+ type AgentsProfileSelectionStrategy = 'least_recently_used' | 'most_recently_used';
1237
+ /**
1238
+ * Available fields for sorting agent profiles
1239
+ */
1240
+ type AgentsProfileSortField = 'name' | 'created_at' | 'updated_at';
1241
+ /**
1242
+ * Request to remove profiles from a pool
1243
+ */
1244
+ type AgentsProfileRemoveProfilesFromPoolRequest = {
1245
+ /**
1246
+ * Profile IDs to remove from the pool
1247
+ */
1248
+ profileIds: Array<CommonUuid>;
1320
1249
  };
1321
1250
  /**
1322
- * A single failed run of a scripted iris node's script
1251
+ * Full content of a single email in the agent profile's inbox
1323
1252
  */
1324
- type AgentsExecutionScriptFailure = {
1253
+ type AgentsProfileProfileInboxEmailDetail = {
1325
1254
  /**
1326
- * ID of the node whose script failed
1255
+ * Unique email ID from Resend
1327
1256
  */
1328
- nodeId?: string;
1257
+ id: string;
1329
1258
  /**
1330
- * Display name of the node whose script failed
1259
+ * Sender address
1331
1260
  */
1332
- nodeName?: string;
1261
+ from: string;
1333
1262
  /**
1334
- * Relative path of the script file that failed
1263
+ * Recipient addresses
1335
1264
  */
1336
- scriptFilepath?: string;
1265
+ to: Array<string>;
1337
1266
  /**
1338
- * Error message reported by the failed script
1267
+ * Email subject
1339
1268
  */
1340
- error?: string;
1269
+ subject: string;
1341
1270
  /**
1342
- * 1-based line number where the script failed, if known
1271
+ * When the email was received
1343
1272
  */
1344
- failedLine?: number;
1273
+ createdAt: string;
1345
1274
  /**
1346
- * Execution step (iteration) at which the failure occurred
1275
+ * Plain-text body, if available
1347
1276
  */
1348
- step?: number;
1277
+ text?: string;
1349
1278
  /**
1350
- * Identifier correlating this failure to its activity event
1279
+ * HTML body, if available
1351
1280
  */
1352
- actionId?: string;
1281
+ html?: string;
1353
1282
  /**
1354
- * When the failure occurred
1283
+ * CC recipients, if any
1355
1284
  */
1356
- occurredAt: string;
1357
- };
1358
- type AgentsExecutionScriptHybridPlaywrightCompletedDetails = {
1359
- actionName: 'script_hybrid_playwright';
1360
- success: boolean;
1361
- result: string;
1362
- consoleLogs: Array<string>;
1363
- failedLine?: number;
1285
+ cc?: Array<string>;
1286
+ /**
1287
+ * BCC recipients, if any
1288
+ */
1289
+ bcc?: Array<string>;
1290
+ /**
1291
+ * Reply-to addresses, if any
1292
+ */
1293
+ replyTo?: Array<string>;
1364
1294
  };
1365
- type AgentsExecutionScriptHybridPlaywrightStartedDetails = {
1366
- actionName: 'script_hybrid_playwright';
1367
- llmVars?: Array<string>;
1368
- };
1369
- type AgentsExecutionScriptPadRunFunctionCompletedDetails = {
1370
- actionName: 'scriptpad_run_function';
1371
- success: boolean;
1372
- result: string;
1373
- consoleLogs: Array<string>;
1374
- failedLine?: number;
1375
- };
1376
- type AgentsExecutionScriptPlaywrightCompletedDetails = {
1377
- actionName: 'script_playwright';
1378
- success: boolean;
1379
- result: string;
1380
- consoleLogs: Array<string>;
1381
- failedLine?: number;
1382
- };
1383
- type AgentsExecutionScriptPlaywrightStartedDetails = {
1384
- actionName: 'script_playwright';
1385
- llmVars?: Array<string>;
1386
- };
1387
- type AgentsExecutionScriptpadReadCompletedDetails = {
1388
- actionName: 'scriptpad_read';
1389
- content: string;
1390
- };
1391
- type AgentsExecutionScriptpadReadStartedDetails = {
1392
- actionName: 'scriptpad_read';
1393
- offset: number;
1394
- limit: number;
1395
- };
1396
- type AgentsExecutionScriptpadRunFunctionStartedDetails = {
1397
- actionName: 'scriptpad_run_function';
1398
- functionName: string;
1399
- arguments: unknown;
1400
- };
1401
- type AgentsExecutionScriptpadSearchReplaceCompletedDetails = {
1402
- actionName: 'scriptpad_search_replace';
1403
- linesReplaced: number;
1404
- linesReplacedWith: number;
1405
- oldTotalLines: number;
1406
- newTotalLines: number;
1407
- oldScriptpad?: string;
1408
- newScriptpad?: string;
1409
- };
1410
- type AgentsExecutionScriptpadSearchReplaceStartedDetails = {
1411
- actionName: 'scriptpad_search_replace';
1412
- search: string;
1413
- replace: string;
1414
- replaceAll: boolean;
1415
- };
1416
- type AgentsExecutionScriptpadWriteCompletedDetails = {
1417
- actionName: 'scriptpad_write';
1418
- linesChanged: number;
1419
- totalLines: number;
1420
- patchesApplied: number;
1421
- scriptpad?: string;
1422
- };
1423
- type AgentsExecutionSdkBashCompletedDetails = {
1424
- actionName: 'sdk_bash';
1425
- output: string;
1426
- exitCode?: number;
1427
- };
1428
- type AgentsExecutionSdkBashStartedDetails = {
1429
- actionName: 'sdk_bash';
1430
- command: string;
1431
- description?: string;
1432
- };
1433
- type AgentsExecutionSdkEditCompletedDetails = {
1434
- actionName: 'sdk_edit';
1435
- success: boolean;
1436
- };
1437
- type AgentsExecutionSdkEditStartedDetails = {
1438
- actionName: 'sdk_edit';
1439
- filePath: string;
1440
- oldString: string;
1441
- newString: string;
1442
- replaceAll?: boolean;
1443
- };
1444
- type AgentsExecutionSdkGlobCompletedDetails = {
1445
- actionName: 'sdk_glob';
1446
- files: Array<string>;
1447
- };
1448
- type AgentsExecutionSdkGlobStartedDetails = {
1449
- actionName: 'sdk_glob';
1450
- pattern: string;
1451
- path?: string;
1452
- };
1453
- type AgentsExecutionSdkGrepCompletedDetails = {
1454
- actionName: 'sdk_grep';
1455
- output: string;
1456
- outputMode?: string;
1457
- };
1458
- type AgentsExecutionSdkGrepStartedDetails = {
1459
- actionName: 'sdk_grep';
1460
- pattern: string;
1461
- path?: string;
1462
- glob?: string;
1463
- outputMode?: string;
1464
- };
1465
- type AgentsExecutionSdkReadCompletedDetails = {
1466
- actionName: 'sdk_read';
1467
- content: string;
1468
- };
1469
- type AgentsExecutionSdkReadStartedDetails = {
1470
- actionName: 'sdk_read';
1471
- filePath: string;
1472
- offset?: number;
1473
- limit?: number;
1474
- };
1475
- type AgentsExecutionSdkSkillCompletedDetails = {
1476
- actionName: 'sdk_skill';
1477
- output?: string;
1478
- };
1479
- type AgentsExecutionSdkSkillStartedDetails = {
1480
- actionName: 'sdk_skill';
1481
- skill: string;
1482
- args?: string;
1483
- };
1484
- type AgentsExecutionSdkWriteCompletedDetails = {
1485
- actionName: 'sdk_write';
1486
- success: boolean;
1487
- };
1488
- type AgentsExecutionSdkWriteStartedDetails = {
1489
- actionName: 'sdk_write';
1490
- filePath: string;
1491
- };
1492
- /**
1493
- * Fields that can be used for sorting executions
1494
- */
1495
- type AgentsExecutionSortField = 'created_at' | 'status';
1496
- type AgentsExecutionStatus = 'starting' | 'running' | 'paused' | 'awaiting_confirmation' | 'completed' | 'cancelled' | 'failed' | 'paused_by_agent';
1497
- type AgentsExecutionTerminalPayload = {
1498
- activityType: 'terminal';
1499
- reason: 'unsubscribe' | 'complete' | 'error';
1500
- message?: string;
1501
- };
1502
- type AgentsExecutionTodo = {
1503
- content: string;
1504
- activeForm?: string;
1505
- status: AgentsExecutionTodoStatus;
1506
- };
1507
- type AgentsExecutionTodoStatus = 'pending' | 'in_progress' | 'completed';
1508
- type AgentsExecutionTransitionDetails = {
1509
- transitionID: CommonUuid;
1510
- transitionType: string;
1511
- };
1512
- /**
1513
- * Discriminated union of trigger contexts (discriminated by source)
1514
- */
1515
- type AgentsExecutionTriggerContext = ({
1516
- source: 'api';
1517
- } & AgentsExecutionApiTriggerContext) | ({
1518
- source: 'ui';
1519
- } & AgentsExecutionUiTriggerContext) | ({
1520
- source: 'schedule';
1521
- } & AgentsExecutionScheduleTriggerContext);
1522
1295
  /**
1523
- * Runner information - who triggered the execution
1296
+ * A single email in the agent profile's inbox (summary only — use the detail endpoint to fetch the body)
1524
1297
  */
1525
- type AgentsExecutionTriggerRunner = {
1526
- /**
1527
- * User ID of the runner
1528
- */
1529
- userId: CommonUuid;
1298
+ type AgentsProfileProfileInboxEmail = {
1530
1299
  /**
1531
- * Email of the runner
1300
+ * Unique email ID from Resend
1532
1301
  */
1533
- email: string;
1302
+ id: string;
1534
1303
  /**
1535
- * Whether the user is an admin (may be hidden for privacy)
1304
+ * Sender address
1536
1305
  */
1537
- isAdmin?: boolean;
1538
- };
1539
- /**
1540
- * UI-triggered execution context
1541
- */
1542
- type AgentsExecutionUiTriggerContext = {
1306
+ from: string;
1543
1307
  /**
1544
- * Trigger source discriminator
1308
+ * Recipient addresses
1545
1309
  */
1546
- source: 'ui';
1310
+ to: Array<string>;
1547
1311
  /**
1548
- * Runner information
1312
+ * Email subject
1549
1313
  */
1550
- runner: AgentsExecutionTriggerRunner;
1551
- };
1552
- type AgentsExecutionUpdateExecutionStatusRequest = {
1314
+ subject: string;
1553
1315
  /**
1554
- * The new status to set for the execution
1316
+ * When the email was received
1555
1317
  */
1556
- status: AgentsExecutionUpdateableStatus;
1557
- };
1558
- type AgentsExecutionUpdateType = 'add' | 'edit' | 'delete';
1559
- /**
1560
- * Status values that can be set via the update endpoint
1561
- */
1562
- type AgentsExecutionUpdateableStatus = 'running' | 'paused' | 'cancelled';
1563
- type AgentsExecutionUserMessagesAddTextBody = {
1564
- message: string;
1565
- };
1566
- type AgentsExecutionUtilGetDatetimeCompletedDetails = {
1567
- actionName: 'util_get_datetime';
1568
- usedBrowserTimezone: boolean;
1569
- datetime: string;
1570
- tzTimezoneIdentifier: string;
1571
- };
1572
- type AgentsExecutionUtilGetDatetimeStartedDetails = {
1573
- actionName: 'util_get_datetime';
1574
- tzTimezoneIdentifier: string;
1575
- };
1576
- type AgentsExecutionWorkflowUpdate = {
1577
- updateType: AgentsExecutionUpdateType;
1578
- rulesDetails?: AgentsExecutionRulesDetails;
1579
- nodeDetails?: AgentsExecutionNodeDetails;
1580
- transitionDetails?: AgentsExecutionTransitionDetails;
1581
- };
1582
- /**
1583
- * A file tracked in the agent filesystem
1584
- */
1585
- type AgentsFilesAgentFile = {
1586
- id: CommonUuid;
1587
- agentId: CommonUuid;
1588
- filePath: string;
1589
- fileName: string;
1590
- fileSize: number;
1591
- mimeType?: string;
1592
1318
  createdAt: string;
1593
- updatedAt: string;
1594
- executionId: CommonUuid;
1595
- directory: AgentsFilesAgentFileDirectory;
1596
- createdBy: AgentsFilesAgentFileCreatedBy;
1597
- downloadUrl: string;
1598
1319
  };
1599
1320
  /**
1600
- * Creator of the file
1601
- */
1602
- type AgentsFilesAgentFileCreatedBy = 'user' | 'agent' | 'environment' | 'system';
1603
- /**
1604
- * Directory types within the agent filesystem
1321
+ * Available fields for sorting agent profile pools
1605
1322
  */
1606
- type AgentsFilesAgentFileDirectory = 'uploads' | 'downloads' | 'workspace' | 'shared' | 'debug' | 'tracing';
1323
+ type AgentsProfilePoolSortField = 'name' | 'created_at' | 'updated_at';
1607
1324
  /**
1608
- * Files grouped by their agent directory
1325
+ * Request to duplicate an agent profile
1609
1326
  */
1610
- type AgentsFilesAgentFilesDirectoryListing = {
1611
- uploads?: Array<AgentsFilesAgentFile>;
1612
- downloads?: Array<AgentsFilesAgentFile>;
1613
- workspace?: Array<AgentsFilesAgentFile>;
1614
- shared?: Array<AgentsFilesAgentFile>;
1615
- debug?: Array<AgentsFilesAgentFile>;
1327
+ type AgentsProfileDuplicateAgentProfileRequest = {
1616
1328
  /**
1617
- * Reserved for internal use.
1329
+ * Target organization ID. Defaults to the source profile's organization if omitted.
1618
1330
  */
1619
- tracing?: Array<AgentsFilesAgentFile>;
1331
+ organizationId?: CommonUuid;
1620
1332
  };
1621
1333
  /**
1622
- * Response containing all agent files for an execution, grouped by directory
1334
+ * Custom proxy server configuration for output (excludes password)
1623
1335
  */
1624
- type AgentsFilesAgentFilesResponse = {
1625
- directories: AgentsFilesAgentFilesDirectoryListing;
1626
- lastUpdated?: string;
1627
- };
1628
- type AgentsFilesFile = {
1629
- id: CommonUuid;
1630
- executionId: CommonUuid;
1631
- agentId: CommonUuid;
1632
- filePath: string;
1633
- fileName: string;
1634
- fileExt: string;
1635
- fileSize: number;
1636
- fileType: string;
1637
- mimeType: string;
1638
- createdAt: string;
1639
- downloadUrl: string;
1336
+ type AgentsProfileCustomProxyConfigOutput = {
1640
1337
  /**
1641
- * @deprecated
1338
+ * Proxy server address
1642
1339
  */
1643
- signedUrl: string;
1644
- };
1645
- type AgentsFilesFilePart = Blob | File;
1646
- /**
1647
- * Request to set the frozen status of a shared file
1648
- */
1649
- type AgentsFilesSetFrozenRequest = {
1650
- isFrozen: boolean;
1340
+ server: string;
1341
+ /**
1342
+ * Proxy authentication username
1343
+ */
1344
+ username: string;
1651
1345
  };
1652
1346
  /**
1653
- * A file in the agent's persistent shared storage
1347
+ * Request to create a new agent profile
1654
1348
  */
1655
- type AgentsFilesSharedFile = {
1656
- id: CommonUuid;
1657
- agentId: CommonUuid;
1658
- filePath: string;
1659
- fileName: string;
1660
- fileSize: number;
1661
- mimeType?: string;
1662
- createdAt: string;
1663
- updatedAt: string;
1664
- version: number;
1665
- isFrozen: boolean;
1666
- lastModifiedByExecutionId?: CommonUuid;
1667
- downloadUrl: string;
1349
+ type AgentsProfileCreateAgentProfileRequest = {
1668
1350
  /**
1669
- * Hex-encoded SHA-256 of the file contents. Used for change and rename detection when diffing versions. Absent when the checksum is unknown.
1351
+ * Name of the agent profile (must be unique within organization)
1670
1352
  */
1671
- checksum?: string;
1353
+ name: string;
1354
+ /**
1355
+ * Description of the agent profile
1356
+ */
1357
+ description: string;
1358
+ /**
1359
+ * The ID of the organization that the profile belongs to
1360
+ */
1361
+ organizationId: CommonUuid;
1362
+ /**
1363
+ * Proxy configuration mode
1364
+ */
1365
+ proxyMode?: AgentsProfileProxyMode;
1366
+ /**
1367
+ * Country code for proxy location (for managed proxy mode)
1368
+ */
1369
+ proxyCC?: AgentsProfileCountryCode;
1370
+ /**
1371
+ * Type of managed proxy to use (required for managed proxy mode)
1372
+ */
1373
+ proxyType?: AgentsProfileProxyType;
1374
+ /**
1375
+ * Custom proxy configuration (required for custom proxy mode)
1376
+ */
1377
+ customProxy?: AgentsProfileCustomProxyConfigInput;
1378
+ /**
1379
+ * Proxy gateway preset ID (required for gateway proxy mode)
1380
+ */
1381
+ proxyGatewayPresetId?: CommonUuid;
1382
+ /**
1383
+ * Whether the captcha solver should be active (managed proxy only)
1384
+ */
1385
+ captchaSolverActive?: boolean;
1386
+ /**
1387
+ * Whether to use the same IP address for all executions (managed proxy only)
1388
+ */
1389
+ stickyIP?: boolean;
1390
+ /**
1391
+ * Operating system to emulate
1392
+ */
1393
+ operatingSystem?: AgentsProfileOperatingSystem;
1394
+ /**
1395
+ * Whether to enable extra stealth mode
1396
+ */
1397
+ extraStealth?: boolean;
1398
+ /**
1399
+ * Whether to allow third-party cookies
1400
+ */
1401
+ allow3rdCookies?: boolean;
1402
+ /**
1403
+ * Whether to persist browser cache between sessions
1404
+ */
1405
+ cachePersistence?: boolean;
1406
+ /**
1407
+ * Whether to enable ad blocking
1408
+ */
1409
+ adblockActive?: boolean;
1410
+ /**
1411
+ * Whether to enable popup blocking (requires adblock to be active)
1412
+ */
1413
+ popupBlockerActive?: boolean;
1414
+ /**
1415
+ * Whether to force popups to open as tabs
1416
+ */
1417
+ forcePopupsAsTabsActive?: boolean;
1418
+ /**
1419
+ * Whether to enable media blocking (images, videos, etc.)
1420
+ */
1421
+ mediaBlockerActive?: boolean;
1422
+ /**
1423
+ * Whether to enable the built-in PDF viewer (if disabled, PDFs are downloaded)
1424
+ */
1425
+ pdfViewerActive?: boolean;
1426
+ /**
1427
+ * Whether browser tracing is enabled (admin only, defaults to true)
1428
+ */
1429
+ tracingEnabled?: boolean;
1430
+ /**
1431
+ * Stable org extension IDs to attach to this profile
1432
+ */
1433
+ extensionIds?: Array<CommonUuid>;
1434
+ /**
1435
+ * Optional custom prefix for the agent's inbox email address. If set, the inbox will be {prefix}@agentmail.asteroid.ai.
1436
+ */
1437
+ inboxEmailPrefix?: string;
1438
+ /**
1439
+ * Initial credentials to create with the profile
1440
+ */
1441
+ credentials?: Array<AgentsProfileCredential>;
1442
+ /**
1443
+ * Initial cookies to create with the profile
1444
+ */
1445
+ cookies?: Array<AgentsProfileCookie>;
1672
1446
  };
1673
1447
  /**
1674
- * Response after uploading shared files
1448
+ * Request to create a new agent profile pool
1675
1449
  */
1676
- type AgentsFilesSharedFileUploadResponse = {
1677
- files: Array<AgentsFilesSharedFile>;
1450
+ type AgentsProfileCreateAgentProfilePoolRequest = {
1451
+ /**
1452
+ * Name of the agent profile pool (must be unique within organization)
1453
+ */
1454
+ name: string;
1455
+ /**
1456
+ * The ID of the organization that the pool belongs to
1457
+ */
1458
+ organizationId: CommonUuid;
1459
+ /**
1460
+ * Strategy for selecting an available profile from the pool
1461
+ */
1462
+ selectionStrategy?: AgentsProfileSelectionStrategy;
1463
+ /**
1464
+ * Whether multiple executions can use the same profile concurrently
1465
+ */
1466
+ allowConcurrentUse?: boolean;
1678
1467
  };
1679
1468
  /**
1680
- * Response containing all shared files for an agent
1469
+ * An agent profile that is a member of a pool
1681
1470
  */
1682
- type AgentsFilesSharedFilesResponse = {
1683
- files: Array<AgentsFilesSharedFile>;
1684
- totalSize: number;
1685
- };
1686
- type AgentsFilesTempFile = {
1471
+ type AgentsProfileAgentProfilePoolMember = {
1472
+ /**
1473
+ * Unique identifier for the agent profile
1474
+ */
1687
1475
  id: CommonUuid;
1476
+ /**
1477
+ * Name of the agent profile
1478
+ */
1688
1479
  name: string;
1689
- };
1690
- type AgentsFilesTempFilesResponse = {
1691
- tempFiles: Array<AgentsFilesTempFile>;
1692
- };
1693
- type AgentsGraphModelsAgentGraph = {
1694
- nodes: Array<AgentsGraphModelsNodesNode>;
1695
- transitions: Array<AgentsGraphModelsTransitionsTransition>;
1696
- sticky_notes: Array<AgentsGraphModelsStickyNote>;
1480
+ /**
1481
+ * The ID of the organization that owns this profile
1482
+ */
1483
+ organizationId: CommonUuid;
1484
+ /**
1485
+ * When the profile was created
1486
+ */
1487
+ createdAt: string;
1488
+ /**
1489
+ * When the profile was last updated
1490
+ */
1491
+ updatedAt: string;
1697
1492
  };
1698
1493
  /**
1699
- * LLM provider for the new agent loop
1494
+ * A pool of agent profiles that can be used for credential rotation
1700
1495
  */
1701
- type AgentsGraphModelsLlmProvider = 'bedrock' | 'anthropic' | 'bifrost';
1702
- type AgentsGraphModelsNodesNode = {
1496
+ type AgentsProfileAgentProfilePool = {
1497
+ /**
1498
+ * Unique identifier for the agent profile pool
1499
+ */
1703
1500
  id: CommonUuid;
1501
+ /**
1502
+ * Name of the agent profile pool (unique within organization)
1503
+ */
1704
1504
  name: string;
1705
- type: AgentsGraphModelsNodesNodeType;
1706
- properties: AgentsGraphModelsNodesNodePropertiesUnion;
1707
- position?: AgentsGraphModelsNodesPosition;
1708
1505
  /**
1709
- * Deprecated: field is no longer populated and will be removed.
1710
- *
1711
- * @deprecated
1506
+ * The ID of the organization that owns this pool
1712
1507
  */
1713
- description?: string;
1714
- };
1715
- type AgentsGraphModelsNodesNodePropertiesUnion = ({
1716
- type: 'start';
1717
- } & AgentsGraphModelsNodesPropertiesStartProperties) | ({
1718
- type: 'iris';
1719
- } & AgentsGraphModelsNodesPropertiesIrisProperties) | ({
1720
- type: 'playwright_script';
1721
- } & AgentsGraphModelsNodesPropertiesPlaywrightScriptProperties) | ({
1722
- type: 'api';
1723
- } & AgentsGraphModelsNodesPropertiesApiProperties) | ({
1724
- type: 'url';
1725
- } & AgentsGraphModelsNodesPropertiesUrlProperties) | ({
1726
- type: 'output';
1727
- } & AgentsGraphModelsNodesPropertiesOutputProperties);
1728
- type AgentsGraphModelsNodesNodeType = 'start' | 'iris' | 'playwright_script' | 'api' | 'url' | 'output';
1729
- type AgentsGraphModelsNodesPosition = {
1730
- x: number;
1731
- y: number;
1508
+ organizationId: CommonUuid;
1509
+ /**
1510
+ * Strategy for selecting an available profile from the pool
1511
+ */
1512
+ selectionStrategy: AgentsProfileSelectionStrategy;
1513
+ /**
1514
+ * Whether multiple executions can use the same profile concurrently
1515
+ */
1516
+ allowConcurrentUse: boolean;
1517
+ /**
1518
+ * When the pool was created
1519
+ */
1520
+ createdAt: string;
1521
+ /**
1522
+ * When the pool was last updated
1523
+ */
1524
+ updatedAt: string;
1732
1525
  };
1733
- type AgentsGraphModelsNodesPropertiesApiMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
1734
1526
  /**
1735
- * @deprecated
1527
+ * Response for listing the emails in an agent profile's inbox
1736
1528
  */
1737
- type AgentsGraphModelsNodesPropertiesApiProperties = {
1738
- type: 'api';
1739
- method: AgentsGraphModelsNodesPropertiesApiMethod;
1740
- url: string;
1741
- body: {
1742
- [key: string]: unknown;
1743
- };
1744
- headers: {
1745
- [key: string]: unknown;
1746
- };
1747
- };
1748
- type AgentsGraphModelsNodesPropertiesIrisPlaywrightScriptProperties = {
1749
- script: string;
1750
- llm_vars: Array<AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVar>;
1751
- freeze_script: boolean;
1752
- };
1753
- type AgentsGraphModelsNodesPropertiesIrisProperties = {
1754
- type: 'iris';
1755
- instructions: string;
1756
- capabilities?: AgentsGraphModelsNodesPropertiesNodeCapabilities;
1757
- snapshot_compression: boolean;
1758
- compression_strategies?: Array<string>;
1759
- temperature: number;
1760
- playwright_script_properties?: AgentsGraphModelsNodesPropertiesIrisPlaywrightScriptProperties;
1761
- input_schema?: {
1762
- [key: string]: unknown;
1763
- };
1764
- /**
1765
- * Relative path (within the node's own shared directory) of the
1766
- * Playwright script that the runtime should execute before the LLM.
1767
- * Setting this turns the node into a fast-path scripted node — combine
1768
- * with `script_failure_action: "cancel_execution"` to skip the LLM
1769
- * entirely on success and cancel on failure.
1770
- *
1771
- * The path is resolved at runtime against the node's shared
1772
- * directory — i.e. `shared/<node-key>/<script_filepath>` on disk in
1773
- * the sandbox. `<node-key>` is owned by the runtime (currently the
1774
- * node's slug, may move to its UUID), so authors do not have to
1775
- * encode it and renaming a node does not break the path.
1776
- *
1777
- * Examples (typical):
1778
- * - `./scripts/main.js`
1779
- * - `./scripts/login.js`
1780
- *
1781
- * A leading `./` is optional but canonical — both `scripts/main.js` and
1782
- * `./scripts/main.js` are accepted, and the platform normalizes to the
1783
- * `./`-prefixed form when it writes this value back out.
1784
- *
1785
- * Constraints:
1786
- * - Must be relative (no leading `/`).
1787
- * - Must NOT start with `shared/` — it is already relative to the
1788
- * node's shared directory; the runtime adds the `shared/<node-key>/`
1789
- * prefix.
1790
- * - Must end in `.js`.
1791
- * - Must not contain `..` segments or duplicate slashes.
1792
- * - May contain a single `{{shared_storage_key}}` placeholder, which
1793
- * the runtime substitutes with the execution's `shared_storage_key`
1794
- * so a single workflow can target per-tenant script trees (e.g.
1795
- * `{{shared_storage_key}}/scripts/main.js` →
1796
- * `shared/<node-key>/<storage-key>/scripts/main.js`).
1797
- */
1798
- script_filepath?: string;
1799
- /**
1800
- * What happens when a script fails on a scripted node.
1801
- * `fallback_to_ai` (default): fall back to LLM-driven execution.
1802
- * `cancel_execution`: cancel the execution immediately.
1803
- */
1804
- script_failure_action?: 'fallback_to_ai' | 'cancel_execution';
1805
- thinking_mode?: 'adaptive' | 'enabled' | 'disabled';
1806
- thinking_budget_tokens?: number;
1807
- thinking_effort?: 'low' | 'medium' | 'high' | 'max';
1808
- /**
1809
- * Server-side advisor model the executor consults mid-generation. When set,
1810
- * the node's executor (`model`) defers to this stronger model for harder
1811
- * sub-decisions. Available on the bifrost and anthropic providers; ignored
1812
- * on bedrock.
1813
- */
1814
- advisor_model?: string;
1815
- model: string;
1816
- };
1817
- /**
1818
- * Coarse environment-level capability toggles for an AI node.
1819
- */
1820
- type AgentsGraphModelsNodesPropertiesNodeCapabilities = {
1821
- browser_use: boolean;
1822
- computer_use: boolean;
1823
- ask_user_question: boolean;
1824
- };
1825
- type AgentsGraphModelsNodesPropertiesOutcomeString = string;
1826
- type AgentsGraphModelsNodesPropertiesOutputProperties = {
1827
- type: 'output';
1828
- instructionsEnabled?: boolean;
1829
- instructions?: string;
1830
- schema?: {
1831
- [key: string]: unknown;
1832
- };
1833
- outcomes: Array<AgentsGraphModelsNodesPropertiesOutcomeString>;
1834
- model?: string;
1835
- };
1836
- type AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVar = {
1837
- name: string;
1838
- type: AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVarType;
1839
- description: string;
1840
- };
1841
- type AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVarType = 'string' | 'number' | 'boolean';
1842
- type AgentsGraphModelsNodesPropertiesPlaywrightScriptProperties = {
1843
- type: 'playwright_script';
1844
- script: string;
1845
- llm_vars: Array<AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVar>;
1846
- };
1847
- type AgentsGraphModelsNodesPropertiesStartProperties = {
1848
- type: 'start';
1849
- };
1850
- /**
1851
- * @deprecated
1852
- */
1853
- type AgentsGraphModelsNodesPropertiesUrlProperties = {
1854
- type: 'url';
1855
- url: string;
1856
- };
1857
- type AgentsGraphModelsNodesSize = {
1858
- width: number;
1859
- height: number;
1860
- };
1861
- /**
1862
- * Configuration settings for workflow execution
1863
- */
1864
- type AgentsGraphModelsSettings = {
1865
- /**
1866
- * Browser viewport width in pixels
1867
- */
1868
- viewport_width: number;
1869
- /**
1870
- * Browser viewport height in pixels
1871
- */
1872
- viewport_height: number;
1873
- /**
1874
- * Whether to trim screenshots
1875
- */
1876
- trim_screenshots: boolean;
1877
- /**
1878
- * Maximum timeout in minutes
1879
- */
1880
- max_timeout_mins: number;
1881
- /**
1882
- * Text input method for browser automation
1883
- */
1884
- type_input_method: AgentsGraphModelsTypeInputMethod;
1885
- /**
1886
- * Whether to summarize execution results
1887
- */
1888
- summarise?: boolean;
1889
- /**
1890
- * Whether to use the new agent loop for execution (beta)
1891
- */
1892
- new_agent_loop?: boolean;
1893
- /**
1894
- * Exact Daytona snapshot name for agent-loop (admin-only)
1895
- */
1896
- agent_loop_snapshot?: string;
1529
+ type AgentsProfileAgentProfileInboxEmailsResponse = {
1897
1530
  /**
1898
- * LLM provider override for the new agent loop (admin-only in UI; defaults to server config)
1531
+ * Emails addressed to this profile's inbox
1899
1532
  */
1900
- llm_provider?: AgentsGraphModelsLlmProvider;
1533
+ emails: Array<AgentsProfileProfileInboxEmail>;
1901
1534
  /**
1902
- * Reserved for internal use.
1535
+ * Number of emails returned
1903
1536
  */
1904
- advanced_tracing?: boolean;
1905
- };
1906
- type AgentsGraphModelsStickyNote = {
1907
- id: CommonUuid;
1908
- content: string;
1909
- color?: string;
1910
- position?: AgentsGraphModelsNodesPosition;
1911
- size?: AgentsGraphModelsNodesSize;
1912
- };
1913
- type AgentsGraphModelsTransitionsPropertiesIrisProperties = {
1914
- type: 'iris';
1915
- };
1916
- type AgentsGraphModelsTransitionsPropertiesOutcomeSuccessProperties = {
1917
- type: 'outcome_success';
1918
- };
1919
- type AgentsGraphModelsTransitionsPropertiesSelectorProperties = {
1920
- type: 'selector';
1921
- name: string;
1922
- selectors: Array<string>;
1923
- };
1924
- type AgentsGraphModelsTransitionsTransition = {
1925
- id: CommonUuid;
1926
- from: CommonUuid;
1927
- to: CommonUuid;
1928
- type: AgentsGraphModelsTransitionsTransitionType;
1929
- require_confirmation: boolean;
1930
- description?: string;
1931
- schema?: {
1932
- [key: string]: unknown;
1933
- };
1934
- properties: AgentsGraphModelsTransitionsTransitionPropertiesUnion;
1935
- };
1936
- type AgentsGraphModelsTransitionsTransitionPropertiesUnion = ({
1937
- type: 'iris';
1938
- } & AgentsGraphModelsTransitionsPropertiesIrisProperties) | ({
1939
- type: 'selector';
1940
- } & AgentsGraphModelsTransitionsPropertiesSelectorProperties) | ({
1941
- type: 'outcome_success';
1942
- } & AgentsGraphModelsTransitionsPropertiesOutcomeSuccessProperties);
1943
- type AgentsGraphModelsTransitionsTransitionType = 'iris' | 'selector' | 'outcome_success';
1944
- /**
1945
- * Text input method for browser automation
1946
- */
1947
- type AgentsGraphModelsTypeInputMethod = 'type' | 'paste' | 'auto';
1948
- /**
1949
- * Request to add profiles to a pool
1950
- */
1951
- type AgentsProfileAddProfilesToPoolRequest = {
1537
+ emailCount: number;
1952
1538
  /**
1953
- * Profile IDs to add to the pool
1539
+ * Whether Resend has more emails beyond this page
1954
1540
  */
1955
- profileIds: Array<CommonUuid>;
1541
+ hasMore: boolean;
1956
1542
  };
1957
1543
  /**
1958
1544
  * An agent profile containing browser configuration and credentials
@@ -2072,1033 +1658,1446 @@ type AgentsProfileAgentProfile = {
2072
1658
  updatedAt: string;
2073
1659
  };
2074
1660
  /**
2075
- * Response for listing the emails in an agent profile's inbox
1661
+ * Request to add profiles to a pool
2076
1662
  */
2077
- type AgentsProfileAgentProfileInboxEmailsResponse = {
2078
- /**
2079
- * Emails addressed to this profile's inbox
2080
- */
2081
- emails: Array<AgentsProfileProfileInboxEmail>;
2082
- /**
2083
- * Number of emails returned
2084
- */
2085
- emailCount: number;
1663
+ type AgentsProfileAddProfilesToPoolRequest = {
2086
1664
  /**
2087
- * Whether Resend has more emails beyond this page
1665
+ * Profile IDs to add to the pool
2088
1666
  */
2089
- hasMore: boolean;
1667
+ profileIds: Array<CommonUuid>;
2090
1668
  };
2091
1669
  /**
2092
- * A pool of agent profiles that can be used for credential rotation
1670
+ * A file in the agent's persistent shared storage
2093
1671
  */
2094
- type AgentsProfileAgentProfilePool = {
2095
- /**
2096
- * Unique identifier for the agent profile pool
2097
- */
1672
+ type AgentsFilesSharedFile = {
2098
1673
  id: CommonUuid;
1674
+ agentId: CommonUuid;
1675
+ filePath: string;
1676
+ fileName: string;
1677
+ fileSize: number;
1678
+ mimeType?: string;
1679
+ createdAt: string;
1680
+ updatedAt: string;
1681
+ version: number;
1682
+ isFrozen: boolean;
1683
+ lastModifiedByExecutionId?: CommonUuid;
1684
+ downloadUrl: string;
2099
1685
  /**
2100
- * Name of the agent profile pool (unique within organization)
2101
- */
2102
- name: string;
2103
- /**
2104
- * The ID of the organization that owns this pool
2105
- */
2106
- organizationId: CommonUuid;
2107
- /**
2108
- * Strategy for selecting an available profile from the pool
2109
- */
2110
- selectionStrategy: AgentsProfileSelectionStrategy;
2111
- /**
2112
- * Whether multiple executions can use the same profile concurrently
2113
- */
2114
- allowConcurrentUse: boolean;
2115
- /**
2116
- * When the pool was created
1686
+ * Hex-encoded SHA-256 of the file contents. Used for change and rename detection when diffing versions. Absent when the checksum is unknown.
2117
1687
  */
1688
+ checksum?: string;
1689
+ };
1690
+ type AgentsFilesTempFilesResponse = {
1691
+ tempFiles: Array<AgentsFilesTempFile>;
1692
+ };
1693
+ /**
1694
+ * Response containing all shared files for an agent
1695
+ */
1696
+ type AgentsFilesSharedFilesResponse = {
1697
+ files: Array<AgentsFilesSharedFile>;
1698
+ totalSize: number;
1699
+ };
1700
+ /**
1701
+ * Response after uploading shared files
1702
+ */
1703
+ type AgentsFilesSharedFileUploadResponse = {
1704
+ files: Array<AgentsFilesSharedFile>;
1705
+ };
1706
+ /**
1707
+ * Request to set the frozen status of a shared file
1708
+ */
1709
+ type AgentsFilesSetFrozenRequest = {
1710
+ isFrozen: boolean;
1711
+ };
1712
+ type AgentsFilesFilePart = Blob | File;
1713
+ type AgentsFilesFile = {
1714
+ id: CommonUuid;
1715
+ executionId: CommonUuid;
1716
+ agentId: CommonUuid;
1717
+ filePath: string;
1718
+ fileName: string;
1719
+ fileExt: string;
1720
+ fileSize: number;
1721
+ fileType: string;
1722
+ mimeType: string;
2118
1723
  createdAt: string;
1724
+ downloadUrl: string;
2119
1725
  /**
2120
- * When the pool was last updated
1726
+ * @deprecated
2121
1727
  */
2122
- updatedAt: string;
1728
+ signedUrl: string;
2123
1729
  };
2124
1730
  /**
2125
- * An agent profile that is a member of a pool
1731
+ * Response containing all agent files for an execution, grouped by directory
2126
1732
  */
2127
- type AgentsProfileAgentProfilePoolMember = {
2128
- /**
2129
- * Unique identifier for the agent profile
2130
- */
1733
+ type AgentsFilesAgentFilesResponse = {
1734
+ directories: AgentsFilesAgentFilesDirectoryListing;
1735
+ lastUpdated?: string;
1736
+ };
1737
+ /**
1738
+ * Creator of the file
1739
+ */
1740
+ type AgentsFilesAgentFileCreatedBy = 'user' | 'agent' | 'environment' | 'system';
1741
+ /**
1742
+ * Directory types within the agent filesystem
1743
+ */
1744
+ type AgentsFilesAgentFileDirectory = 'uploads' | 'downloads' | 'workspace' | 'shared' | 'debug' | 'tracing';
1745
+ /**
1746
+ * A file tracked in the agent filesystem
1747
+ */
1748
+ type AgentsFilesAgentFile = {
2131
1749
  id: CommonUuid;
2132
- /**
2133
- * Name of the agent profile
2134
- */
2135
- name: string;
2136
- /**
2137
- * The ID of the organization that owns this profile
2138
- */
2139
- organizationId: CommonUuid;
2140
- /**
2141
- * When the profile was created
2142
- */
1750
+ agentId: CommonUuid;
1751
+ filePath: string;
1752
+ fileName: string;
1753
+ fileSize: number;
1754
+ mimeType?: string;
2143
1755
  createdAt: string;
2144
- /**
2145
- * When the profile was last updated
2146
- */
2147
1756
  updatedAt: string;
1757
+ executionId: CommonUuid;
1758
+ directory: AgentsFilesAgentFileDirectory;
1759
+ createdBy: AgentsFilesAgentFileCreatedBy;
1760
+ downloadUrl: string;
2148
1761
  };
2149
1762
  /**
2150
- * A browser cookie stored for an agent profile
1763
+ * Files grouped by their agent directory
2151
1764
  */
2152
- type AgentsProfileCookie = {
2153
- /**
2154
- * Unique identifier for the cookie
2155
- */
2156
- id?: CommonUuid;
2157
- /**
2158
- * Display name for the cookie
2159
- */
2160
- name: string;
2161
- /**
2162
- * The cookie key/name as sent in HTTP headers
2163
- */
2164
- key: string;
1765
+ type AgentsFilesAgentFilesDirectoryListing = {
1766
+ uploads?: Array<AgentsFilesAgentFile>;
1767
+ downloads?: Array<AgentsFilesAgentFile>;
1768
+ workspace?: Array<AgentsFilesAgentFile>;
1769
+ shared?: Array<AgentsFilesAgentFile>;
1770
+ debug?: Array<AgentsFilesAgentFile>;
2165
1771
  /**
2166
- * The cookie value
1772
+ * Reserved for internal use.
2167
1773
  */
2168
- value: string;
1774
+ tracing?: Array<AgentsFilesAgentFile>;
1775
+ };
1776
+ type AgentsExecutionWorkflowUpdate = {
1777
+ updateType: AgentsExecutionUpdateType;
1778
+ rulesDetails?: AgentsExecutionRulesDetails;
1779
+ nodeDetails?: AgentsExecutionNodeDetails;
1780
+ transitionDetails?: AgentsExecutionTransitionDetails;
1781
+ };
1782
+ type AgentsExecutionTransitionDetails = {
1783
+ transitionID: CommonUuid;
1784
+ transitionType: string;
1785
+ };
1786
+ type AgentsExecutionNodeDetails = {
1787
+ nodeID: CommonUuid;
1788
+ nodeName: string;
1789
+ nodeType: string;
1790
+ };
1791
+ type AgentsExecutionRulesDetails = {
1792
+ rules: string;
1793
+ };
1794
+ type AgentsExecutionUpdateType = 'add' | 'edit' | 'delete';
1795
+ type AgentsExecutionUtilGetDatetimeStartedDetails = {
1796
+ actionName: 'util_get_datetime';
1797
+ tzTimezoneIdentifier: string;
1798
+ };
1799
+ type AgentsExecutionUtilGetDatetimeCompletedDetails = {
1800
+ actionName: 'util_get_datetime';
1801
+ usedBrowserTimezone: boolean;
1802
+ datetime: string;
1803
+ tzTimezoneIdentifier: string;
1804
+ };
1805
+ type AgentsExecutionUserMessagesAddTextBody = {
1806
+ message: string;
1807
+ };
1808
+ /**
1809
+ * Status values that can be set via the update endpoint
1810
+ */
1811
+ type AgentsExecutionUpdateableStatus = 'running' | 'paused' | 'cancelled';
1812
+ type AgentsExecutionUpdateExecutionStatusRequest = {
2169
1813
  /**
2170
- * When the cookie expires (optional)
1814
+ * The new status to set for the execution
2171
1815
  */
2172
- expiry?: string;
1816
+ status: AgentsExecutionUpdateableStatus;
1817
+ };
1818
+ /**
1819
+ * UI-triggered execution context
1820
+ */
1821
+ type AgentsExecutionUiTriggerContext = {
2173
1822
  /**
2174
- * The domain for which the cookie is valid
1823
+ * Trigger source discriminator
2175
1824
  */
2176
- domain: string;
1825
+ source: 'ui';
2177
1826
  /**
2178
- * Whether the cookie should only be sent over HTTPS
1827
+ * Runner information
2179
1828
  */
2180
- secure: boolean;
1829
+ runner: AgentsExecutionTriggerRunner;
1830
+ };
1831
+ /**
1832
+ * Runner information - who triggered the execution
1833
+ */
1834
+ type AgentsExecutionTriggerRunner = {
2181
1835
  /**
2182
- * SameSite attribute for the cookie
1836
+ * User ID of the runner
2183
1837
  */
2184
- sameSite: AgentsProfileSameSite;
1838
+ userId: CommonUuid;
2185
1839
  /**
2186
- * Whether the cookie should be accessible only via HTTP(S)
1840
+ * Email of the runner
2187
1841
  */
2188
- httpOnly: boolean;
1842
+ email: string;
2189
1843
  /**
2190
- * When the cookie was created
1844
+ * Whether the user is an admin (may be hidden for privacy)
2191
1845
  */
2192
- createdAt?: string;
1846
+ isAdmin?: boolean;
2193
1847
  };
2194
1848
  /**
2195
- * Two-letter country code for proxy location
1849
+ * Discriminated union of trigger contexts (discriminated by source)
2196
1850
  */
2197
- type AgentsProfileCountryCode = 'us' | 'uk' | 'fr' | 'it' | 'jp' | 'au' | 'de' | 'fi' | 'ca';
1851
+ type AgentsExecutionTriggerContext = ({
1852
+ source: 'api';
1853
+ } & AgentsExecutionApiTriggerContext) | ({
1854
+ source: 'ui';
1855
+ } & AgentsExecutionUiTriggerContext) | ({
1856
+ source: 'schedule';
1857
+ } & AgentsExecutionScheduleTriggerContext);
2198
1858
  /**
2199
- * Request to create a new agent profile pool
1859
+ * Schedule reference for schedule-triggered executions
2200
1860
  */
2201
- type AgentsProfileCreateAgentProfilePoolRequest = {
1861
+ type AgentsExecutionScheduleRef = {
2202
1862
  /**
2203
- * Name of the agent profile pool (must be unique within organization)
1863
+ * Schedule ID
2204
1864
  */
2205
- name: string;
1865
+ id: CommonUuid;
2206
1866
  /**
2207
- * The ID of the organization that the pool belongs to
1867
+ * Cron expression of the schedule
2208
1868
  */
2209
- organizationId: CommonUuid;
1869
+ cronExpression: string;
1870
+ };
1871
+ /**
1872
+ * Schedule-triggered execution context
1873
+ */
1874
+ type AgentsExecutionScheduleTriggerContext = {
2210
1875
  /**
2211
- * Strategy for selecting an available profile from the pool
1876
+ * Trigger source discriminator
2212
1877
  */
2213
- selectionStrategy?: AgentsProfileSelectionStrategy;
1878
+ source: 'schedule';
2214
1879
  /**
2215
- * Whether multiple executions can use the same profile concurrently
1880
+ * Schedule that triggered the execution
2216
1881
  */
2217
- allowConcurrentUse?: boolean;
1882
+ schedule: AgentsExecutionScheduleRef;
2218
1883
  };
2219
1884
  /**
2220
- * Request to create a new agent profile
1885
+ * API key reference used for authentication
2221
1886
  */
2222
- type AgentsProfileCreateAgentProfileRequest = {
1887
+ type AgentsExecutionApiKeyRef = {
2223
1888
  /**
2224
- * Name of the agent profile (must be unique within organization)
1889
+ * API key ID
2225
1890
  */
2226
- name: string;
1891
+ id: CommonUuid;
2227
1892
  /**
2228
- * Description of the agent profile
1893
+ * API key name
2229
1894
  */
2230
- description: string;
1895
+ name: string;
1896
+ };
1897
+ /**
1898
+ * API-triggered execution context
1899
+ */
1900
+ type AgentsExecutionApiTriggerContext = {
2231
1901
  /**
2232
- * The ID of the organization that the profile belongs to
1902
+ * Trigger source discriminator
2233
1903
  */
2234
- organizationId: CommonUuid;
1904
+ source: 'api';
2235
1905
  /**
2236
- * Proxy configuration mode
1906
+ * Runner information
2237
1907
  */
2238
- proxyMode?: AgentsProfileProxyMode;
1908
+ runner: AgentsExecutionTriggerRunner;
2239
1909
  /**
2240
- * Country code for proxy location (for managed proxy mode)
2241
- */
2242
- proxyCC?: AgentsProfileCountryCode;
2243
- /**
2244
- * Type of managed proxy to use (required for managed proxy mode)
2245
- */
2246
- proxyType?: AgentsProfileProxyType;
2247
- /**
2248
- * Custom proxy configuration (required for custom proxy mode)
2249
- */
2250
- customProxy?: AgentsProfileCustomProxyConfigInput;
2251
- /**
2252
- * Proxy gateway preset ID (required for gateway proxy mode)
2253
- */
2254
- proxyGatewayPresetId?: CommonUuid;
2255
- /**
2256
- * Whether the captcha solver should be active (managed proxy only)
2257
- */
2258
- captchaSolverActive?: boolean;
2259
- /**
2260
- * Whether to use the same IP address for all executions (managed proxy only)
2261
- */
2262
- stickyIP?: boolean;
2263
- /**
2264
- * Operating system to emulate
2265
- */
2266
- operatingSystem?: AgentsProfileOperatingSystem;
2267
- /**
2268
- * Whether to enable extra stealth mode
2269
- */
2270
- extraStealth?: boolean;
2271
- /**
2272
- * Whether to allow third-party cookies
2273
- */
2274
- allow3rdCookies?: boolean;
2275
- /**
2276
- * Whether to persist browser cache between sessions
2277
- */
2278
- cachePersistence?: boolean;
2279
- /**
2280
- * Whether to enable ad blocking
2281
- */
2282
- adblockActive?: boolean;
2283
- /**
2284
- * Whether to enable popup blocking (requires adblock to be active)
2285
- */
2286
- popupBlockerActive?: boolean;
2287
- /**
2288
- * Whether to force popups to open as tabs
2289
- */
2290
- forcePopupsAsTabsActive?: boolean;
2291
- /**
2292
- * Whether to enable media blocking (images, videos, etc.)
2293
- */
2294
- mediaBlockerActive?: boolean;
2295
- /**
2296
- * Whether to enable the built-in PDF viewer (if disabled, PDFs are downloaded)
2297
- */
2298
- pdfViewerActive?: boolean;
2299
- /**
2300
- * Whether browser tracing is enabled (admin only, defaults to true)
1910
+ * API key used for authentication (may be hidden for privacy when admin-triggered)
2301
1911
  */
2302
- tracingEnabled?: boolean;
1912
+ apiKey?: AgentsExecutionApiKeyRef;
1913
+ };
1914
+ type AgentsExecutionTodoStatus = 'pending' | 'in_progress' | 'completed';
1915
+ type AgentsExecutionTodo = {
1916
+ content: string;
1917
+ activeForm?: string;
1918
+ status: AgentsExecutionTodoStatus;
1919
+ };
1920
+ type AgentsExecutionTerminalPayload = {
1921
+ activityType: 'terminal';
1922
+ reason: 'unsubscribe' | 'complete' | 'error';
1923
+ message?: string;
1924
+ };
1925
+ type AgentsExecutionStatus = 'starting' | 'running' | 'paused' | 'awaiting_confirmation' | 'completed' | 'cancelled' | 'failed' | 'paused_by_agent';
1926
+ /**
1927
+ * Fields that can be used for sorting executions
1928
+ */
1929
+ type AgentsExecutionSortField = 'created_at' | 'status';
1930
+ type AgentsExecutionSdkWriteStartedDetails = {
1931
+ actionName: 'sdk_write';
1932
+ filePath: string;
1933
+ };
1934
+ type AgentsExecutionSdkWriteCompletedDetails = {
1935
+ actionName: 'sdk_write';
1936
+ success: boolean;
1937
+ };
1938
+ type AgentsExecutionSdkSkillStartedDetails = {
1939
+ actionName: 'sdk_skill';
1940
+ skill: string;
1941
+ args?: string;
1942
+ };
1943
+ type AgentsExecutionSdkSkillCompletedDetails = {
1944
+ actionName: 'sdk_skill';
1945
+ output?: string;
1946
+ };
1947
+ type AgentsExecutionSdkReadStartedDetails = {
1948
+ actionName: 'sdk_read';
1949
+ filePath: string;
1950
+ offset?: number;
1951
+ limit?: number;
1952
+ };
1953
+ type AgentsExecutionSdkReadCompletedDetails = {
1954
+ actionName: 'sdk_read';
1955
+ content: string;
1956
+ };
1957
+ type AgentsExecutionSdkGrepStartedDetails = {
1958
+ actionName: 'sdk_grep';
1959
+ pattern: string;
1960
+ path?: string;
1961
+ glob?: string;
1962
+ outputMode?: string;
1963
+ };
1964
+ type AgentsExecutionSdkGrepCompletedDetails = {
1965
+ actionName: 'sdk_grep';
1966
+ output: string;
1967
+ outputMode?: string;
1968
+ };
1969
+ type AgentsExecutionSdkGlobStartedDetails = {
1970
+ actionName: 'sdk_glob';
1971
+ pattern: string;
1972
+ path?: string;
1973
+ };
1974
+ type AgentsExecutionSdkGlobCompletedDetails = {
1975
+ actionName: 'sdk_glob';
1976
+ files: Array<string>;
1977
+ };
1978
+ type AgentsExecutionSdkEditStartedDetails = {
1979
+ actionName: 'sdk_edit';
1980
+ filePath: string;
1981
+ oldString: string;
1982
+ newString: string;
1983
+ replaceAll?: boolean;
1984
+ };
1985
+ type AgentsExecutionSdkEditCompletedDetails = {
1986
+ actionName: 'sdk_edit';
1987
+ success: boolean;
1988
+ };
1989
+ type AgentsExecutionSdkBashStartedDetails = {
1990
+ actionName: 'sdk_bash';
1991
+ command: string;
1992
+ description?: string;
1993
+ };
1994
+ type AgentsExecutionSdkBashCompletedDetails = {
1995
+ actionName: 'sdk_bash';
1996
+ output: string;
1997
+ exitCode?: number;
1998
+ };
1999
+ type AgentsExecutionScriptpadWriteCompletedDetails = {
2000
+ actionName: 'scriptpad_write';
2001
+ linesChanged: number;
2002
+ totalLines: number;
2003
+ patchesApplied: number;
2004
+ scriptpad?: string;
2005
+ };
2006
+ type AgentsExecutionScriptpadSearchReplaceStartedDetails = {
2007
+ actionName: 'scriptpad_search_replace';
2008
+ search: string;
2009
+ replace: string;
2010
+ replaceAll: boolean;
2011
+ };
2012
+ type AgentsExecutionScriptpadSearchReplaceCompletedDetails = {
2013
+ actionName: 'scriptpad_search_replace';
2014
+ linesReplaced: number;
2015
+ linesReplacedWith: number;
2016
+ oldTotalLines: number;
2017
+ newTotalLines: number;
2018
+ oldScriptpad?: string;
2019
+ newScriptpad?: string;
2020
+ };
2021
+ type AgentsExecutionScriptpadRunFunctionStartedDetails = {
2022
+ actionName: 'scriptpad_run_function';
2023
+ functionName: string;
2024
+ arguments: unknown;
2025
+ };
2026
+ type AgentsExecutionScriptpadReadStartedDetails = {
2027
+ actionName: 'scriptpad_read';
2028
+ offset: number;
2029
+ limit: number;
2030
+ };
2031
+ type AgentsExecutionScriptpadReadCompletedDetails = {
2032
+ actionName: 'scriptpad_read';
2033
+ content: string;
2034
+ };
2035
+ type AgentsExecutionScriptPlaywrightStartedDetails = {
2036
+ actionName: 'script_playwright';
2037
+ llmVars?: Array<string>;
2038
+ };
2039
+ type AgentsExecutionScriptPlaywrightCompletedDetails = {
2040
+ actionName: 'script_playwright';
2041
+ success: boolean;
2042
+ result: string;
2043
+ consoleLogs: Array<string>;
2044
+ failedLine?: number;
2045
+ };
2046
+ type AgentsExecutionScriptPadRunFunctionCompletedDetails = {
2047
+ actionName: 'scriptpad_run_function';
2048
+ success: boolean;
2049
+ result: string;
2050
+ consoleLogs: Array<string>;
2051
+ failedLine?: number;
2052
+ };
2053
+ type AgentsExecutionScriptHybridPlaywrightStartedDetails = {
2054
+ actionName: 'script_hybrid_playwright';
2055
+ llmVars?: Array<string>;
2056
+ };
2057
+ type AgentsExecutionScriptHybridPlaywrightCompletedDetails = {
2058
+ actionName: 'script_hybrid_playwright';
2059
+ success: boolean;
2060
+ result: string;
2061
+ consoleLogs: Array<string>;
2062
+ failedLine?: number;
2063
+ };
2064
+ /**
2065
+ * A single failed run of a scripted iris node's script
2066
+ */
2067
+ type AgentsExecutionScriptFailure = {
2303
2068
  /**
2304
- * Stable org extension IDs to attach to this profile
2069
+ * ID of the node whose script failed
2305
2070
  */
2306
- extensionIds?: Array<CommonUuid>;
2071
+ nodeId?: string;
2307
2072
  /**
2308
- * Optional custom prefix for the agent's inbox email address. If set, the inbox will be {prefix}@agentmail.asteroid.ai.
2073
+ * Display name of the node whose script failed
2309
2074
  */
2310
- inboxEmailPrefix?: string;
2075
+ nodeName?: string;
2311
2076
  /**
2312
- * Initial credentials to create with the profile
2077
+ * Relative path of the script file that failed
2313
2078
  */
2314
- credentials?: Array<AgentsProfileCredential>;
2079
+ scriptFilepath?: string;
2315
2080
  /**
2316
- * Initial cookies to create with the profile
2081
+ * Error message reported by the failed script
2317
2082
  */
2318
- cookies?: Array<AgentsProfileCookie>;
2319
- };
2320
- /**
2321
- * A credential stored for an agent profile
2322
- */
2323
- type AgentsProfileCredential = {
2083
+ error?: string;
2324
2084
  /**
2325
- * Unique identifier for the credential
2085
+ * 1-based line number where the script failed, if known
2326
2086
  */
2327
- id?: CommonUuid;
2087
+ failedLine?: number;
2328
2088
  /**
2329
- * Display name for the credential (will be uppercased)
2089
+ * Execution step (iteration) at which the failure occurred
2330
2090
  */
2331
- name: string;
2091
+ step?: number;
2332
2092
  /**
2333
- * The credential value (plaintext - will be encrypted server-side)
2093
+ * Identifier correlating this failure to its activity event
2334
2094
  */
2335
- data: string;
2095
+ actionId?: string;
2336
2096
  /**
2337
- * When the credential was created
2097
+ * When the failure occurred
2338
2098
  */
2339
- createdAt?: string;
2099
+ occurredAt: string;
2100
+ };
2101
+ type AgentsExecutionScriptEvalStartedDetails = {
2102
+ actionName: 'script_eval';
2103
+ element?: string;
2104
+ ref?: string;
2105
+ function: string;
2106
+ };
2107
+ type AgentsExecutionScriptEvalCompletedDetails = {
2108
+ actionName: 'script_eval';
2109
+ result: unknown;
2110
+ };
2111
+ type AgentsExecutionScratchpadWriteStartedDetails = {
2112
+ actionName: 'scratchpad_write';
2113
+ operation: 'write';
2114
+ };
2115
+ type AgentsExecutionScratchpadWriteCompletedDetails = {
2116
+ actionName: 'scratchpad_write';
2117
+ linesChanged: number;
2118
+ totalLines: number;
2119
+ patchesApplied: number;
2120
+ content?: string;
2121
+ contentTruncated?: boolean;
2122
+ };
2123
+ type AgentsExecutionScratchpadReadStartedDetails = {
2124
+ actionName: 'scratchpad_read';
2125
+ operation: 'read';
2126
+ };
2127
+ type AgentsExecutionScratchpadReadCompletedDetails = {
2128
+ actionName: 'scratchpad_read';
2129
+ content?: string;
2130
+ contentTruncated?: boolean;
2131
+ };
2132
+ type AgentsExecutionReadFileStartedDetails = {
2133
+ actionName: 'read_file';
2134
+ filePath: string;
2135
+ };
2136
+ type AgentsExecutionReadFileCompletedDetails = {
2137
+ actionName: 'read_file';
2138
+ contentType: 'image' | 'document' | 'text' | 'unknown';
2139
+ mimeType?: string;
2140
+ content?: string;
2141
+ };
2142
+ type AgentsExecutionQuestionOption = {
2143
+ label: string;
2144
+ description: string;
2145
+ };
2146
+ type AgentsExecutionQuestionItem = {
2147
+ question: string;
2148
+ header: string;
2149
+ options: Array<AgentsExecutionQuestionOption>;
2150
+ multiSelect?: boolean;
2151
+ };
2152
+ type AgentsExecutionPausedPayload = {
2153
+ reason: string;
2154
+ question?: AgentsExecutionAskUserQuestion;
2155
+ };
2156
+ type AgentsExecutionAskUserQuestion = {
2157
+ questions: Array<AgentsExecutionQuestionItem>;
2158
+ };
2159
+ type AgentsExecutionObsSnapshotWithSelectorsCompletedDetails = {
2160
+ actionName: 'obs_snapshot_with_selectors';
2161
+ url: string;
2162
+ title: string;
2340
2163
  };
2341
2164
  /**
2342
- * Request to update an existing credential by name
2165
+ * A single output variable with a name and value
2343
2166
  */
2344
- type AgentsProfileCredentialUpdate = {
2167
+ type AgentsExecutionNodeOutputItem = {
2345
2168
  /**
2346
- * Name of the credential to update (case-insensitive, will be matched as uppercase)
2169
+ * The name of the output variable
2347
2170
  */
2348
2171
  name: string;
2349
2172
  /**
2350
- * New credential value (plaintext - will be encrypted server-side)
2173
+ * The value of the output variable
2351
2174
  */
2352
- data: string;
2175
+ value: string;
2176
+ };
2177
+ type AgentsExecutionNavToStartedDetails = {
2178
+ actionName: 'nav_to';
2179
+ url: string;
2180
+ };
2181
+ type AgentsExecutionNavToCompletedDetails = {
2182
+ actionName: 'nav_to';
2183
+ pageTitle?: string;
2353
2184
  };
2354
2185
  /**
2355
- * Custom proxy server configuration for input (includes password)
2186
+ * Represents a single execution in a list view
2356
2187
  */
2357
- type AgentsProfileCustomProxyConfigInput = {
2188
+ type AgentsExecutionListItem = {
2358
2189
  /**
2359
- * Proxy server address including protocol and port (e.g., 'socks5://proxy.example.com:1080' or 'http://proxy.example.com:8080')
2190
+ * The unique identifier of the execution
2360
2191
  */
2361
- server: string;
2192
+ id: CommonUuid;
2362
2193
  /**
2363
- * Proxy authentication username
2194
+ * The ID of the agent that was executed
2364
2195
  */
2365
- username: string;
2196
+ agentId: CommonUuid;
2366
2197
  /**
2367
- * Proxy authentication password
2198
+ * The ID of the workflow that was executed
2368
2199
  */
2369
- password: string;
2370
- };
2371
- /**
2372
- * Custom proxy server configuration for output (excludes password)
2373
- */
2374
- type AgentsProfileCustomProxyConfigOutput = {
2200
+ workflowId: CommonUuid;
2375
2201
  /**
2376
- * Proxy server address
2202
+ * The current status of the execution
2377
2203
  */
2378
- server: string;
2204
+ status: AgentsExecutionStatus;
2379
2205
  /**
2380
- * Proxy authentication username
2206
+ * When the execution was created
2381
2207
  */
2382
- username: string;
2383
- };
2384
- /**
2385
- * Request to duplicate an agent profile
2386
- */
2387
- type AgentsProfileDuplicateAgentProfileRequest = {
2208
+ createdAt: string;
2388
2209
  /**
2389
- * Target organization ID. Defaults to the source profile's organization if omitted.
2210
+ * When the execution reached a terminal state (if applicable)
2390
2211
  */
2391
- organizationId?: CommonUuid;
2392
- };
2393
- /**
2394
- * Operating system to emulate in the browser
2395
- */
2396
- type AgentsProfileOperatingSystem = 'macos' | 'windows';
2397
- /**
2398
- * Available fields for sorting agent profile pools
2399
- */
2400
- type AgentsProfilePoolSortField = 'name' | 'created_at' | 'updated_at';
2401
- /**
2402
- * A single email in the agent profile's inbox (summary only — use the detail endpoint to fetch the body)
2403
- */
2404
- type AgentsProfileProfileInboxEmail = {
2212
+ terminalAt?: string;
2405
2213
  /**
2406
- * Unique email ID from Resend
2214
+ * The organization this execution belongs to
2407
2215
  */
2408
- id: string;
2216
+ organizationId: CommonUuid;
2409
2217
  /**
2410
- * Sender address
2218
+ * The agent display name
2411
2219
  */
2412
- from: string;
2220
+ agentName: string;
2413
2221
  /**
2414
- * Recipient addresses
2222
+ * The name of the agent profile used for this execution (if any)
2415
2223
  */
2416
- to: Array<string>;
2224
+ agentProfileName?: string;
2417
2225
  /**
2418
- * Email subject
2226
+ * The ID of the agent profile used for this execution (if any)
2419
2227
  */
2420
- subject: string;
2228
+ agentProfileId?: CommonUuid;
2421
2229
  /**
2422
- * When the email was received
2230
+ * Input variables used for this execution
2423
2231
  */
2424
- createdAt: string;
2425
- };
2426
- /**
2427
- * Full content of a single email in the agent profile's inbox
2428
- */
2429
- type AgentsProfileProfileInboxEmailDetail = {
2232
+ inputs?: {
2233
+ [key: string]: unknown;
2234
+ };
2430
2235
  /**
2431
- * Unique email ID from Resend
2236
+ * Execution result with outcome, reasoning, and result data
2432
2237
  */
2433
- id: string;
2238
+ executionResult?: AgentsExecutionExecutionResult;
2434
2239
  /**
2435
- * Sender address
2240
+ * Execution duration in seconds (only present for terminal executions)
2436
2241
  */
2437
- from: string;
2242
+ duration?: number;
2438
2243
  /**
2439
- * Recipient addresses
2244
+ * Human-applied labels for this execution
2440
2245
  */
2441
- to: Array<string>;
2246
+ humanLabels: Array<AgentsExecutionHumanLabel>;
2442
2247
  /**
2443
- * Email subject
2248
+ * Comments on this execution
2444
2249
  */
2445
- subject: string;
2250
+ comments: Array<AgentsExecutionComment>;
2446
2251
  /**
2447
- * When the email was received
2252
+ * Optional metadata key-value pairs attached to this execution
2448
2253
  */
2449
- createdAt: string;
2254
+ metadata?: {
2255
+ [key: string]: unknown;
2256
+ };
2450
2257
  /**
2451
- * Plain-text body, if available
2258
+ * Recording URL for playback (if an environment was used and execution is terminal)
2452
2259
  */
2453
- text?: string;
2260
+ recordingUrl?: string;
2454
2261
  /**
2455
- * HTML body, if available
2262
+ * Live view URL for debugging (if an environment is active and execution is running)
2456
2263
  */
2457
- html?: string;
2264
+ liveViewUrl?: string;
2458
2265
  /**
2459
- * CC recipients, if any
2266
+ * Deprecated: Use 'recordingUrl' instead.
2267
+ *
2268
+ * @deprecated
2460
2269
  */
2461
- cc?: Array<string>;
2270
+ browserRecordingUrl?: string;
2462
2271
  /**
2463
- * BCC recipients, if any
2272
+ * Deprecated: Use 'liveViewUrl' instead.
2273
+ *
2274
+ * @deprecated
2464
2275
  */
2465
- bcc?: Array<string>;
2276
+ browserLiveViewUrl?: string;
2466
2277
  /**
2467
- * Reply-to addresses, if any
2278
+ * Context about how and by whom this execution was triggered (discriminated by source)
2468
2279
  */
2469
- replyTo?: Array<string>;
2470
- };
2471
- /**
2472
- * Proxy configuration mode
2473
- */
2474
- type AgentsProfileProxyMode = 'none' | 'managed' | 'custom' | 'gateway';
2475
- /**
2476
- * Type of managed proxy to use for browser sessions
2477
- */
2478
- type AgentsProfileProxyType = 'basic';
2479
- /**
2480
- * Request to remove profiles from a pool
2481
- */
2482
- type AgentsProfileRemoveProfilesFromPoolRequest = {
2280
+ triggerContext?: AgentsExecutionTriggerContext;
2483
2281
  /**
2484
- * Profile IDs to remove from the pool
2282
+ * Per-execution runtime options (e.g. shared storage key)
2485
2283
  */
2486
- profileIds: Array<CommonUuid>;
2487
- };
2488
- /**
2489
- * SameSite attribute for cookies
2490
- */
2491
- type AgentsProfileSameSite = 'Strict' | 'Lax' | 'None';
2492
- /**
2493
- * Strategy for selecting an available profile from a pool
2494
- */
2495
- type AgentsProfileSelectionStrategy = 'least_recently_used' | 'most_recently_used';
2496
- /**
2497
- * Available fields for sorting agent profiles
2498
- */
2499
- type AgentsProfileSortField = 'name' | 'created_at' | 'updated_at';
2500
- /**
2501
- * Request to update an existing agent profile pool
2502
- */
2503
- type AgentsProfileUpdateAgentProfilePoolRequest = {
2284
+ executionOptions?: AgentsAgentExecutionOptions;
2504
2285
  /**
2505
- * New name for the pool
2286
+ * Whether this execution has been rerun at least once
2506
2287
  */
2507
- name?: string;
2288
+ hasBeenRerun: boolean;
2508
2289
  /**
2509
- * New selection strategy for the pool
2290
+ * ID of the execution this was rerun from, if applicable
2510
2291
  */
2511
- selectionStrategy?: AgentsProfileSelectionStrategy;
2292
+ parentExecutionId?: CommonUuid;
2512
2293
  /**
2513
- * Whether multiple executions can use the same profile concurrently
2294
+ * Script failures recorded for this execution (omitted when none occurred)
2514
2295
  */
2515
- allowConcurrentUse?: boolean;
2296
+ scriptFailures?: Array<AgentsExecutionScriptFailure>;
2516
2297
  };
2517
2298
  /**
2518
- * Request to update an existing agent profile
2299
+ * User comment on an execution
2519
2300
  */
2520
- type AgentsProfileUpdateAgentProfileRequest = {
2301
+ type AgentsExecutionComment = {
2521
2302
  /**
2522
- * New name for the profile
2523
- */
2524
- name?: string;
2525
- /**
2526
- * New description for the profile
2527
- */
2528
- description?: string;
2529
- /**
2530
- * Proxy configuration mode
2531
- */
2532
- proxyMode?: AgentsProfileProxyMode;
2533
- /**
2534
- * Country code for proxy location (for managed proxy mode)
2535
- */
2536
- proxyCC?: AgentsProfileCountryCode;
2537
- /**
2538
- * Type of managed proxy to use (for managed proxy mode)
2539
- */
2540
- proxyType?: AgentsProfileProxyType;
2541
- /**
2542
- * Custom proxy configuration (for custom proxy mode)
2303
+ * Unique identifier for the comment
2543
2304
  */
2544
- customProxy?: AgentsProfileCustomProxyConfigInput;
2305
+ id: CommonUuid;
2545
2306
  /**
2546
- * Proxy gateway preset ID (for gateway proxy mode)
2307
+ * Execution this comment belongs to
2547
2308
  */
2548
- proxyGatewayPresetId?: CommonUuid;
2309
+ executionId: CommonUuid;
2549
2310
  /**
2550
- * Whether the captcha solver should be active (managed proxy only)
2311
+ * User who created the comment
2551
2312
  */
2552
- captchaSolverActive?: boolean;
2313
+ userId: CommonUuid;
2553
2314
  /**
2554
- * Operating system to emulate
2315
+ * Comment content
2555
2316
  */
2556
- operatingSystem?: AgentsProfileOperatingSystem;
2317
+ content: string;
2557
2318
  /**
2558
- * Whether to enable extra stealth mode
2319
+ * Whether the comment is public
2559
2320
  */
2560
- extraStealth?: boolean;
2321
+ public: boolean;
2561
2322
  /**
2562
- * Whether to allow third-party cookies
2323
+ * When the comment was created
2563
2324
  */
2564
- allow3rdCookies?: boolean;
2325
+ createdAt: string;
2565
2326
  /**
2566
- * Whether to persist browser cache between sessions
2327
+ * When the comment was last updated
2567
2328
  */
2568
- cachePersistence?: boolean;
2329
+ updatedAt?: string;
2330
+ };
2331
+ /**
2332
+ * Human-applied label for categorizing executions
2333
+ */
2334
+ type AgentsExecutionHumanLabel = {
2569
2335
  /**
2570
- * Whether to enable ad blocking
2336
+ * Unique identifier for the label
2571
2337
  */
2572
- adblockActive?: boolean;
2338
+ id: CommonUuid;
2573
2339
  /**
2574
- * Whether to enable popup blocking (requires adblock to be active)
2340
+ * Organization this label belongs to
2575
2341
  */
2576
- popupBlockerActive?: boolean;
2342
+ organizationId: CommonUuid;
2577
2343
  /**
2578
- * Whether to force popups to open as tabs
2344
+ * Display name of the label
2579
2345
  */
2580
- forcePopupsAsTabsActive?: boolean;
2346
+ name: string;
2581
2347
  /**
2582
- * Whether to enable media blocking (images, videos, etc.)
2348
+ * Hex color code for the label (e.g., #FF5733)
2583
2349
  */
2584
- mediaBlockerActive?: boolean;
2350
+ color: string;
2585
2351
  /**
2586
- * Whether to enable the built-in PDF viewer (if disabled, PDFs are downloaded)
2352
+ * When the label was created
2587
2353
  */
2588
- pdfViewerActive?: boolean;
2354
+ createdAt: string;
2355
+ };
2356
+ /**
2357
+ * Execution result containing outcome, reasoning, and result data
2358
+ */
2359
+ type AgentsExecutionExecutionResult = {
2589
2360
  /**
2590
- * Whether browser tracing is enabled (admin only)
2361
+ * Unique identifier for the result
2591
2362
  */
2592
- tracingEnabled?: boolean;
2363
+ id: CommonUuid;
2593
2364
  /**
2594
- * Stable org extension IDs to attach to this profile
2365
+ * Execution this result belongs to
2595
2366
  */
2596
- extensionIds?: Array<CommonUuid>;
2367
+ executionId: CommonUuid;
2597
2368
  /**
2598
- * Optional custom prefix for the agent's inbox email address. If set, the inbox will be {prefix}@agentmail.asteroid.ai.
2369
+ * Outcome of the execution (success or failure)
2599
2370
  */
2600
- inboxEmailPrefix?: string;
2371
+ outcome: string;
2601
2372
  /**
2602
- * Credentials to add to the profile
2373
+ * AI reasoning for the outcome
2603
2374
  */
2604
- credentialsToAdd?: Array<AgentsProfileCredential>;
2375
+ reasoning: string;
2605
2376
  /**
2606
- * Credentials to update by name (matched case-insensitively)
2377
+ * Result data as JSON
2607
2378
  */
2608
- credentialsToUpdate?: Array<AgentsProfileCredentialUpdate>;
2379
+ result: unknown;
2609
2380
  /**
2610
- * IDs of credentials to remove from the profile
2381
+ * When the result was created
2611
2382
  */
2612
- credentialsToDelete?: Array<CommonUuid>;
2383
+ createdAt: string;
2384
+ };
2385
+ type AgentsExecutionLlmCallStartedDetails = {
2386
+ actionName: 'llm_call';
2387
+ purpose: AgentsExecutionLlmCallPurpose;
2388
+ };
2389
+ type AgentsExecutionLlmCallPurpose = 'iris_pick_next_action' | 'transition_pick_next_node' | 'output_populate_result' | 'generate_hybrid_playwright_code' | 'generate_playwright_variables';
2390
+ type AgentsExecutionHandoffPrepareVariable = {
2391
+ name: string;
2392
+ value: string;
2393
+ };
2394
+ type AgentsExecutionHandoffPrepareStartedDetails = {
2395
+ actionName: 'handoff_prepare';
2396
+ target?: string;
2397
+ summary?: string;
2398
+ variables?: Array<AgentsExecutionHandoffPrepareVariable>;
2399
+ };
2400
+ type AgentsExecutionHandoffPrepareCompletedDetails = {
2401
+ actionName: 'handoff_prepare';
2402
+ success: boolean;
2403
+ };
2404
+ type AgentsExecutionFileStageCompletedDetails = {
2405
+ actionName: 'file_stage';
2406
+ fileNames: Array<string>;
2407
+ };
2408
+ type AgentsExecutionFileReadCompletedDetails = {
2409
+ actionName: 'file_read';
2410
+ fileNames: Array<string>;
2411
+ errorCount?: number;
2412
+ totalSizeBytes?: number;
2413
+ };
2414
+ type AgentsExecutionFileListCompletedDetails = {
2415
+ actionName: 'file_list';
2416
+ fileNames: Array<string>;
2417
+ };
2418
+ type AgentsExecutionFailedPayload = {
2419
+ reason: string;
2420
+ os_error?: CommonOsError;
2421
+ };
2422
+ type AgentsExecutionExtSendMailStartedDetails = {
2423
+ actionName: 'ext_send_mail';
2424
+ to: Array<string>;
2425
+ subject: string;
2426
+ cc?: Array<string>;
2427
+ bcc?: Array<string>;
2428
+ bodyPreview?: string;
2429
+ };
2430
+ type AgentsExecutionExtSendMailCompletedDetails = {
2431
+ actionName: 'ext_send_mail';
2432
+ success: boolean;
2433
+ emailId?: string;
2434
+ };
2435
+ type AgentsExecutionExtGetMailCompletedDetails = {
2436
+ actionName: 'ext_get_mail';
2437
+ emailCount: number;
2438
+ emails: Array<unknown>;
2439
+ };
2440
+ type AgentsExecutionExtApiCallCompletedDetails = {
2441
+ actionName: 'ext_api_call';
2442
+ statusCode: string;
2443
+ responseBody: string;
2444
+ requestMethod?: string;
2445
+ requestUrl?: string;
2446
+ };
2447
+ type AgentsExecutionElementFileUploadCompletedDetails = {
2448
+ actionName: 'element_file_upload';
2449
+ fileNames: Array<string>;
2450
+ };
2451
+ type AgentsExecutionCompletedPayload = {
2452
+ outcome: string;
2453
+ reasoning: string;
2454
+ result: unknown;
2455
+ };
2456
+ type AgentsExecutionCancelledPayload = {
2457
+ reason: AgentsExecutionCancelReason;
2458
+ };
2459
+ type AgentsExecutionCancelReason = 'timeout' | 'max_steps' | 'user_requested' | 'script_failed' | 'no_activity' | 'budget_exceeded';
2460
+ type AgentsExecutionBrowserRunCodeStartedDetails = {
2461
+ actionName: 'browser_run_code';
2462
+ code: string;
2463
+ };
2464
+ type AgentsExecutionBrowserRunCodeCompletedDetails = {
2465
+ actionName: 'browser_run_code';
2466
+ success: boolean;
2467
+ result: string;
2468
+ consoleLogs: Array<string>;
2469
+ failedLine?: number;
2470
+ };
2471
+ type AgentsExecutionAwaitingConfirmationPayload = {
2472
+ reason: string;
2473
+ };
2474
+ type AgentsExecutionAgentQueryContextStartedDetails = {
2475
+ actionName: 'agent_query_context';
2476
+ query: string;
2477
+ };
2478
+ type AgentsExecutionAgentQueryContextCompletedDetails = {
2479
+ actionName: 'agent_query_context';
2480
+ query: string;
2481
+ answer: string;
2482
+ };
2483
+ type AgentsExecutionAdvisorCompletedDetails = {
2484
+ actionName: 'advisor';
2485
+ advice: string;
2486
+ };
2487
+ type AgentsExecutionActivityWorkflowUpdatedPayload = {
2488
+ activityType: 'workflow_updated';
2489
+ workflowUpdate: Array<AgentsExecutionWorkflowUpdate>;
2490
+ };
2491
+ type AgentsExecutionActivityUserMessageReceivedPayload = {
2492
+ activityType: 'user_message_received';
2493
+ message: string;
2494
+ userUUID: CommonUuid;
2495
+ };
2496
+ type AgentsExecutionActivityTransitionedNodePayload = {
2497
+ activityType: 'transitioned_node';
2498
+ newNodeUUID: CommonUuid;
2499
+ newNodeName: string;
2500
+ newNodeType: string;
2501
+ fromNodeDuration?: number;
2502
+ transitionType?: AgentsGraphModelsTransitionsTransitionType;
2613
2503
  /**
2614
- * Cookies to add to the profile
2504
+ * Output variables provided by the from node
2615
2505
  */
2616
- cookiesToAdd?: Array<AgentsProfileCookie>;
2506
+ fromNodeOutput?: Array<AgentsExecutionNodeOutputItem>;
2617
2507
  /**
2618
- * IDs of cookies to remove from the profile
2508
+ * A summary of the work done in the previous node
2619
2509
  */
2620
- cookiesToDelete?: Array<CommonUuid>;
2510
+ fromNodeSummary?: string;
2621
2511
  };
2622
- /**
2623
- * Request to validate a JSON schema against OpenAI structured output requirements
2624
- */
2625
- type AgentsSchemaValidateSchemaRequest = {
2626
- /**
2627
- * The JSON schema to validate
2628
- */
2629
- schema: {
2512
+ type AgentsExecutionActivityTodosUpdatedPayload = {
2513
+ activityType: 'todos_updated';
2514
+ todos: Array<AgentsExecutionTodo>;
2515
+ display?: AgentsExecutionActivityDisplay;
2516
+ };
2517
+ type AgentsExecutionActivityPresentationLevel = 'primary' | 'secondary' | 'system';
2518
+ type AgentsExecutionActivityDisplay = {
2519
+ turnId?: string;
2520
+ groupId?: string;
2521
+ summaryText?: string;
2522
+ presentationLevel?: AgentsExecutionActivityPresentationLevel;
2523
+ };
2524
+ type AgentsExecutionActivityStepStartedPayload = {
2525
+ activityType: 'step_started';
2526
+ stepNumber: number;
2527
+ };
2528
+ type AgentsExecutionActivityStepCompletedPayload = {
2529
+ activityType: 'step_completed';
2530
+ stepNumber: number;
2531
+ };
2532
+ type AgentsExecutionActivityStatusChangedPayload = {
2533
+ activityType: 'status_changed';
2534
+ status: AgentsExecutionStatus;
2535
+ completedPayload?: AgentsExecutionCompletedPayload;
2536
+ failedPayload?: AgentsExecutionFailedPayload;
2537
+ pausedPayload?: AgentsExecutionPausedPayload;
2538
+ awaitingConfirmationPayload?: AgentsExecutionAwaitingConfirmationPayload;
2539
+ cancelledPayload?: AgentsExecutionCancelledPayload;
2540
+ };
2541
+ type AgentsExecutionActivityScriptVariablesSubstitutedPayload = {
2542
+ activityType: 'script_variables_substituted';
2543
+ nodeId: CommonUuid;
2544
+ nodeName: string;
2545
+ scriptFileName: string;
2546
+ placeholders: Array<string>;
2547
+ variables: {
2630
2548
  [key: string]: unknown;
2631
2549
  };
2550
+ substituted: boolean;
2551
+ display?: AgentsExecutionActivityDisplay;
2632
2552
  };
2633
- /**
2634
- * Response from schema validation
2635
- */
2636
- type AgentsSchemaValidateSchemaResponse = {
2637
- /**
2638
- * Whether the schema is valid
2639
- */
2640
- valid: boolean;
2641
- /**
2642
- * List of validation error messages (empty if valid)
2643
- */
2644
- errors: Array<string>;
2553
+ type AgentsExecutionActivityReasoningPayload = {
2554
+ activityType: 'reasoning';
2555
+ reasoning: string;
2556
+ display?: AgentsExecutionActivityDisplay;
2557
+ };
2558
+ type AgentsExecutionActivityPlaywrightScriptGeneratedPayload = {
2559
+ activityType: 'playwright_script_generated';
2560
+ nodeId: CommonUuid;
2561
+ nodeName: string;
2562
+ script: string;
2563
+ llmVars?: Array<AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVar>;
2564
+ context: string;
2565
+ oldScript?: string;
2566
+ };
2567
+ type AgentsExecutionActivityPayloadUnion = ({
2568
+ activityType: 'terminal';
2569
+ } & AgentsExecutionTerminalPayload) | ({
2570
+ activityType: 'generic';
2571
+ } & AgentsExecutionActivityGenericPayload) | ({
2572
+ activityType: 'reasoning';
2573
+ } & AgentsExecutionActivityReasoningPayload) | ({
2574
+ activityType: 'compaction_started';
2575
+ } & AgentsExecutionActivityCompactionStartedPayload) | ({
2576
+ activityType: 'compaction_performed';
2577
+ } & AgentsExecutionActivityCompactionPerformedPayload) | ({
2578
+ activityType: 'step_started';
2579
+ } & AgentsExecutionActivityStepStartedPayload) | ({
2580
+ activityType: 'step_completed';
2581
+ } & AgentsExecutionActivityStepCompletedPayload) | ({
2582
+ activityType: 'transitioned_node';
2583
+ } & AgentsExecutionActivityTransitionedNodePayload) | ({
2584
+ activityType: 'status_changed';
2585
+ } & AgentsExecutionActivityStatusChangedPayload) | ({
2586
+ activityType: 'action_started';
2587
+ } & AgentsExecutionActivityActionStartedPayload) | ({
2588
+ activityType: 'action_completed';
2589
+ } & AgentsExecutionActivityActionCompletedPayload) | ({
2590
+ activityType: 'action_failed';
2591
+ } & AgentsExecutionActivityActionFailedPayload) | ({
2592
+ activityType: 'user_message_received';
2593
+ } & AgentsExecutionActivityUserMessageReceivedPayload) | ({
2594
+ activityType: 'file_added';
2595
+ } & AgentsExecutionActivityFileAddedPayload) | ({
2596
+ activityType: 'workflow_updated';
2597
+ } & AgentsExecutionActivityWorkflowUpdatedPayload) | ({
2598
+ activityType: 'playwright_script_generated';
2599
+ } & AgentsExecutionActivityPlaywrightScriptGeneratedPayload) | ({
2600
+ activityType: 'script_variables_substituted';
2601
+ } & AgentsExecutionActivityScriptVariablesSubstitutedPayload) | ({
2602
+ activityType: 'input_schema_resolved';
2603
+ } & AgentsExecutionActivityInputSchemaResolvedPayload) | ({
2604
+ activityType: 'todos_updated';
2605
+ } & AgentsExecutionActivityTodosUpdatedPayload);
2606
+ type AgentsExecutionActivityInputSchemaResolvedPayload = {
2607
+ activityType: 'input_schema_resolved';
2608
+ nodeId: CommonUuid;
2609
+ nodeName: string;
2610
+ properties: Array<string>;
2611
+ resolved: {
2612
+ [key: string]: unknown;
2613
+ };
2614
+ display?: AgentsExecutionActivityDisplay;
2615
+ };
2616
+ type AgentsExecutionActivityFileAddedPayload = {
2617
+ activityType: 'file_added';
2618
+ fileId: CommonUuid;
2619
+ fileName: string;
2620
+ mimeType: string;
2621
+ fileSize: number;
2622
+ source: 'upload' | 'download' | 'agent';
2623
+ presignedUrl: string;
2624
+ };
2625
+ type AgentsExecutionActivityActionFailedPayload = {
2626
+ activityType: 'action_failed';
2627
+ message: string;
2628
+ actionName: AgentsExecutionActionName;
2629
+ actionId: string;
2630
+ duration?: number;
2631
+ display?: AgentsExecutionActivityDisplay;
2632
+ };
2633
+ type AgentsExecutionActionName = 'element_click' | 'element_type' | 'element_select' | 'element_hover' | 'element_drag' | 'element_wait' | 'element_fill_form' | 'element_get_text' | 'element_file_upload' | 'coord_move' | 'coord_click' | 'coord_double_click' | 'coord_triple_click' | 'coord_drag' | 'coord_scroll' | 'nav_to' | 'nav_back' | 'nav_refresh' | 'nav_tabs' | 'nav_close_browser' | 'nav_resize_browser' | 'nav_install_browser' | 'nav_zoom_in' | 'nav_zoom_out' | 'obs_snapshot' | 'obs_snapshot_with_selectors' | 'obs_screenshot' | 'obs_console_messages' | 'obs_network_requests' | 'obs_extract_html' | 'script_eval' | 'script_playwright' | 'script_playwright_llm_vars' | 'script_hybrid_playwright' | 'browser_run_code' | 'browser_press_key' | 'browser_handle_dialog' | 'browser_read_clipboard' | 'browser_solve_captcha' | 'file_list' | 'file_read' | 'file_stage' | 'file_download' | 'file_pdf_save' | 'scratchpad_read' | 'scratchpad_write' | 'scriptpad_run_function' | 'scriptpad_search_replace' | 'scriptpad_read' | 'scriptpad_write' | 'ext_google_sheets_get_data' | 'ext_google_sheets_set_data' | 'ext_get_mail' | 'ext_send_mail' | 'ext_api_call' | 'util_wait_time' | 'util_get_datetime' | 'util_generate_totp_secret' | 'util_send_user_message' | 'agent_query_context' | 'agent_compile_workflow' | 'llm_call' | 'advisor' | 'sdk_bash' | 'sdk_read' | 'sdk_write' | 'sdk_edit' | 'sdk_glob' | 'sdk_grep' | 'sdk_skill' | 'handoff_prepare' | 'read_file';
2634
+ type AgentsExecutionActivityActionCompletedInfo = ({
2635
+ actionName: 'ext_api_call';
2636
+ } & AgentsExecutionExtApiCallCompletedDetails) | ({
2637
+ actionName: 'scratchpad_read';
2638
+ } & AgentsExecutionScratchpadReadCompletedDetails) | ({
2639
+ actionName: 'scratchpad_write';
2640
+ } & AgentsExecutionScratchpadWriteCompletedDetails) | ({
2641
+ actionName: 'script_playwright';
2642
+ } & AgentsExecutionScriptPlaywrightCompletedDetails) | ({
2643
+ actionName: 'script_hybrid_playwright';
2644
+ } & AgentsExecutionScriptHybridPlaywrightCompletedDetails) | ({
2645
+ actionName: 'browser_run_code';
2646
+ } & AgentsExecutionBrowserRunCodeCompletedDetails) | ({
2647
+ actionName: 'script_eval';
2648
+ } & AgentsExecutionScriptEvalCompletedDetails) | ({
2649
+ actionName: 'file_read';
2650
+ } & AgentsExecutionFileReadCompletedDetails) | ({
2651
+ actionName: 'file_list';
2652
+ } & AgentsExecutionFileListCompletedDetails) | ({
2653
+ actionName: 'file_stage';
2654
+ } & AgentsExecutionFileStageCompletedDetails) | ({
2655
+ actionName: 'element_file_upload';
2656
+ } & AgentsExecutionElementFileUploadCompletedDetails) | ({
2657
+ actionName: 'ext_get_mail';
2658
+ } & AgentsExecutionExtGetMailCompletedDetails) | ({
2659
+ actionName: 'scriptpad_run_function';
2660
+ } & AgentsExecutionScriptPadRunFunctionCompletedDetails) | ({
2661
+ actionName: 'scriptpad_read';
2662
+ } & AgentsExecutionScriptpadReadCompletedDetails) | ({
2663
+ actionName: 'scriptpad_write';
2664
+ } & AgentsExecutionScriptpadWriteCompletedDetails) | ({
2665
+ actionName: 'scriptpad_search_replace';
2666
+ } & AgentsExecutionScriptpadSearchReplaceCompletedDetails) | ({
2667
+ actionName: 'obs_snapshot_with_selectors';
2668
+ } & AgentsExecutionObsSnapshotWithSelectorsCompletedDetails) | ({
2669
+ actionName: 'util_get_datetime';
2670
+ } & AgentsExecutionUtilGetDatetimeCompletedDetails) | ({
2671
+ actionName: 'nav_to';
2672
+ } & AgentsExecutionNavToCompletedDetails) | ({
2673
+ actionName: 'agent_query_context';
2674
+ } & AgentsExecutionAgentQueryContextCompletedDetails) | ({
2675
+ actionName: 'sdk_bash';
2676
+ } & AgentsExecutionSdkBashCompletedDetails) | ({
2677
+ actionName: 'sdk_read';
2678
+ } & AgentsExecutionSdkReadCompletedDetails) | ({
2679
+ actionName: 'sdk_write';
2680
+ } & AgentsExecutionSdkWriteCompletedDetails) | ({
2681
+ actionName: 'sdk_edit';
2682
+ } & AgentsExecutionSdkEditCompletedDetails) | ({
2683
+ actionName: 'sdk_glob';
2684
+ } & AgentsExecutionSdkGlobCompletedDetails) | ({
2685
+ actionName: 'sdk_grep';
2686
+ } & AgentsExecutionSdkGrepCompletedDetails) | ({
2687
+ actionName: 'sdk_skill';
2688
+ } & AgentsExecutionSdkSkillCompletedDetails) | ({
2689
+ actionName: 'read_file';
2690
+ } & AgentsExecutionReadFileCompletedDetails) | ({
2691
+ actionName: 'handoff_prepare';
2692
+ } & AgentsExecutionHandoffPrepareCompletedDetails) | ({
2693
+ actionName: 'ext_send_mail';
2694
+ } & AgentsExecutionExtSendMailCompletedDetails) | ({
2695
+ actionName: 'advisor';
2696
+ } & AgentsExecutionAdvisorCompletedDetails);
2697
+ type AgentsExecutionActivityActionCompletedPayload = {
2698
+ activityType: 'action_completed';
2699
+ message: string;
2700
+ actionId: string;
2701
+ actionName: AgentsExecutionActionName;
2702
+ duration?: number;
2703
+ info?: AgentsExecutionActivityActionCompletedInfo;
2704
+ display?: AgentsExecutionActivityDisplay;
2705
+ };
2706
+ type AgentsExecutionActivityActionStartedInfo = ({
2707
+ actionName: 'nav_to';
2708
+ } & AgentsExecutionNavToStartedDetails) | ({
2709
+ actionName: 'scratchpad_read';
2710
+ } & AgentsExecutionScratchpadReadStartedDetails) | ({
2711
+ actionName: 'scratchpad_write';
2712
+ } & AgentsExecutionScratchpadWriteStartedDetails) | ({
2713
+ actionName: 'scriptpad_run_function';
2714
+ } & AgentsExecutionScriptpadRunFunctionStartedDetails) | ({
2715
+ actionName: 'script_playwright';
2716
+ } & AgentsExecutionScriptPlaywrightStartedDetails) | ({
2717
+ actionName: 'script_hybrid_playwright';
2718
+ } & AgentsExecutionScriptHybridPlaywrightStartedDetails) | ({
2719
+ actionName: 'browser_run_code';
2720
+ } & AgentsExecutionBrowserRunCodeStartedDetails) | ({
2721
+ actionName: 'script_eval';
2722
+ } & AgentsExecutionScriptEvalStartedDetails) | ({
2723
+ actionName: 'scriptpad_search_replace';
2724
+ } & AgentsExecutionScriptpadSearchReplaceStartedDetails) | ({
2725
+ actionName: 'util_get_datetime';
2726
+ } & AgentsExecutionUtilGetDatetimeStartedDetails) | ({
2727
+ actionName: 'scriptpad_read';
2728
+ } & AgentsExecutionScriptpadReadStartedDetails) | ({
2729
+ actionName: 'llm_call';
2730
+ } & AgentsExecutionLlmCallStartedDetails) | ({
2731
+ actionName: 'agent_query_context';
2732
+ } & AgentsExecutionAgentQueryContextStartedDetails) | ({
2733
+ actionName: 'sdk_bash';
2734
+ } & AgentsExecutionSdkBashStartedDetails) | ({
2735
+ actionName: 'sdk_read';
2736
+ } & AgentsExecutionSdkReadStartedDetails) | ({
2737
+ actionName: 'sdk_write';
2738
+ } & AgentsExecutionSdkWriteStartedDetails) | ({
2739
+ actionName: 'sdk_edit';
2740
+ } & AgentsExecutionSdkEditStartedDetails) | ({
2741
+ actionName: 'sdk_glob';
2742
+ } & AgentsExecutionSdkGlobStartedDetails) | ({
2743
+ actionName: 'sdk_grep';
2744
+ } & AgentsExecutionSdkGrepStartedDetails) | ({
2745
+ actionName: 'sdk_skill';
2746
+ } & AgentsExecutionSdkSkillStartedDetails) | ({
2747
+ actionName: 'read_file';
2748
+ } & AgentsExecutionReadFileStartedDetails) | ({
2749
+ actionName: 'handoff_prepare';
2750
+ } & AgentsExecutionHandoffPrepareStartedDetails) | ({
2751
+ actionName: 'ext_send_mail';
2752
+ } & AgentsExecutionExtSendMailStartedDetails);
2753
+ type AgentsExecutionActivityActionStartedPayload = {
2754
+ activityType: 'action_started';
2755
+ message: string;
2756
+ actionName: AgentsExecutionActionName;
2757
+ actionId: string;
2758
+ info?: AgentsExecutionActivityActionStartedInfo;
2759
+ display?: AgentsExecutionActivityDisplay;
2760
+ };
2761
+ type AgentsExecutionActivityCompactionPerformedPayload = {
2762
+ activityType: 'compaction_performed';
2763
+ summaryTokens: number;
2764
+ durationMs: number;
2765
+ display?: AgentsExecutionActivityDisplay;
2766
+ };
2767
+ type AgentsExecutionActivityCompactionStartedPayload = {
2768
+ activityType: 'compaction_started';
2769
+ display?: AgentsExecutionActivityDisplay;
2645
2770
  };
2646
- /**
2647
- * Browser provider type
2648
- */
2649
- type AgentsWorkflowBrowserProvider = 'anchor' | 'steel';
2650
- /**
2651
- * Browser environment template configuration
2652
- */
2653
- type AgentsWorkflowBrowserTemplateConfig = {
2654
- /**
2655
- * Browser provider type
2656
- */
2657
- provider: AgentsWorkflowBrowserProvider;
2771
+ type AgentsExecutionActivityGenericPayload = {
2772
+ activityType: 'generic';
2773
+ message: string;
2774
+ display?: AgentsExecutionActivityDisplay;
2775
+ };
2776
+ type AgentsExecutionActivity = {
2777
+ id: CommonUuid;
2778
+ payload: AgentsExecutionActivityPayloadUnion;
2779
+ executionId: CommonUuid;
2780
+ timestamp: string;
2658
2781
  };
2659
2782
  /**
2660
- * Request to create a new unpublished workflow
2783
+ * A single documentation search result
2661
2784
  */
2662
- type AgentsWorkflowCreateWorkflowRequest = {
2663
- /**
2664
- * Optional parent workflow ID to derive from
2665
- */
2666
- parentId?: CommonUuid;
2667
- /**
2668
- * The rules/instructions for this workflow
2669
- */
2670
- rules: string;
2671
- /**
2672
- * The settings for this workflow
2673
- */
2674
- settings: AgentsGraphModelsSettings;
2675
- /**
2676
- * The workflow graph
2677
- */
2678
- graph: AgentsGraphModelsAgentGraph;
2785
+ type AgentsDocsSearchResult = {
2679
2786
  /**
2680
- * Optional environment template. Defaults to browser/anchor if not provided.
2787
+ * Result title
2681
2788
  */
2682
- environmentTemplate?: AgentsWorkflowEnvironmentTemplate;
2789
+ title: string;
2683
2790
  /**
2684
- * Typed input definitions for this workflow. Names referenced in prompts but omitted here default to optional strings.
2791
+ * Result content/snippet
2685
2792
  */
2686
- inputs?: Array<AgentsWorkflowInput>;
2687
- };
2688
- /**
2689
- * Response after creating a workflow
2690
- */
2691
- type AgentsWorkflowCreateWorkflowResponse = {
2793
+ content: string;
2692
2794
  /**
2693
- * The ID of the newly created workflow
2795
+ * Source URL
2694
2796
  */
2695
- workflowId: CommonUuid;
2797
+ url?: string;
2696
2798
  };
2697
2799
  /**
2698
- * Environment template for workflow execution
2800
+ * Response containing documentation search results
2699
2801
  */
2700
- type AgentsWorkflowEnvironmentTemplate = {
2701
- /**
2702
- * Type of environment (browser or os)
2703
- */
2704
- type: AgentsWorkflowEnvironmentType;
2802
+ type AgentsDocsSearchDocsResponse = {
2705
2803
  /**
2706
- * Environment-specific configuration
2804
+ * Search results matching the query
2707
2805
  */
2708
- config: AgentsWorkflowBrowserTemplateConfig | AgentsWorkflowOsTemplateConfig;
2806
+ results: Array<AgentsDocsSearchResult>;
2709
2807
  };
2710
2808
  /**
2711
- * Type of execution environment
2712
- */
2713
- type AgentsWorkflowEnvironmentType = 'browser' | 'os';
2714
- /**
2715
- * Request to execute a workflow by ID
2809
+ * Request to search Asteroid documentation
2716
2810
  */
2717
- type AgentsWorkflowExecuteWorkflowRequest = {
2718
- /**
2719
- * Input variables to be merged into the placeholders defined in prompts
2720
- */
2721
- inputVariables?: {
2722
- [key: string]: unknown;
2723
- };
2724
- /**
2725
- * Optional metadata key-value pairs for organizing and filtering executions
2726
- */
2727
- metadata?: {
2728
- [key: string]: unknown;
2729
- };
2730
- /**
2731
- * The ID of the agent profile to use. Note this is not the agent ID
2732
- */
2733
- agentProfileId?: CommonUuid;
2734
- /**
2735
- * The ID of the agent profile pool to select a profile from. Mutually exclusive with agentProfileId.
2736
- */
2737
- agentProfilePoolId?: CommonUuid;
2738
- /**
2739
- * Array of temporary files to attach to the execution. Must have been pre-uploaded using the stage file endpoint
2740
- */
2741
- tempFiles?: Array<AgentsFilesTempFile>;
2742
- /**
2743
- * Per-execution runtime options that override or extend the agent's default settings.
2744
- */
2745
- executionOptions?: AgentsAgentExecutionOptions;
2811
+ type AgentsDocsSearchDocsRequest = {
2746
2812
  /**
2747
- * ID of the execution this is a rerun of. Sets parent_execution_id on the new execution and has_been_rerun on the parent.
2813
+ * Search query to find relevant documentation
2748
2814
  */
2749
- parentExecutionId?: CommonUuid;
2815
+ query: string;
2750
2816
  };
2751
2817
  /**
2752
- * Response after starting workflow execution
2818
+ * Traffic-light engagement-risk level derived from execution activity.
2753
2819
  */
2754
- type AgentsWorkflowExecuteWorkflowResponse = {
2755
- /**
2756
- * The ID of the newly created execution
2757
- */
2758
- executionId: CommonUuid;
2759
- };
2820
+ type AgentsCustomerActivityRiskLevel = 'red' | 'amber' | 'green';
2760
2821
  /**
2761
- * A typed input variable a workflow declares. Referenced as {{.name}} in prompts.
2822
+ * One 7-day window of an org's execution activity for digest deltas. windowIndex 0 = most recent complete 7 days; 1..12 = trailing baseline.
2762
2823
  */
2763
- type AgentsWorkflowInput = {
2824
+ type AgentsCustomerActivityOrgWindowStat = {
2825
+ windowIndex: number;
2826
+ execCount: number;
2764
2827
  /**
2765
- * The variable name. Matches [a-zA-Z_][a-zA-Z0-9_]* and is unique within the workflow.
2828
+ * Runs that produced an execution_result outcome in the window.
2766
2829
  */
2767
- name: string;
2830
+ outcomeTotal: number;
2768
2831
  /**
2769
- * A single-field JSON Schema fragment describing the input's type, e.g. {type: "string"}, {type: "number"}, {type: "object", properties: {...}}. Validated adaptively at execution time.
2832
+ * Agent-recorded outcome label -> count. Label-agnostic; never assume a fixed set.
2770
2833
  */
2771
- schema: {
2834
+ outcomeCounts: {
2772
2835
  [key: string]: unknown;
2773
2836
  };
2774
- /**
2775
- * Whether a value must be supplied at execution time. Defaults to false.
2776
- */
2777
- required: boolean;
2778
- /**
2779
- * Optional value used when the input is omitted at execution time.
2780
- */
2781
- defaultValue?: unknown;
2782
- /**
2783
- * Optional human-readable description of the input.
2784
- */
2785
- description?: string;
2786
2837
  };
2787
2838
  /**
2788
- * OS provider type
2789
- */
2790
- type AgentsWorkflowOsProvider = 'daytona' | 'local';
2791
- /**
2792
- * OS environment template configuration
2839
+ * An org tripped a high-intent activity event within the lookback window.
2793
2840
  */
2794
- type AgentsWorkflowOsTemplateConfig = {
2795
- /**
2796
- * OS provider type
2797
- */
2798
- provider: AgentsWorkflowOsProvider;
2799
- /**
2800
- * Name of the snapshot to use. If omitted or empty, the server uses the configured default snapshot for the selected osType.
2801
- */
2802
- snapshotName?: string;
2803
- /**
2804
- * Whether the snapshot is public
2805
- */
2806
- public: boolean;
2841
+ type AgentsCustomerActivityNotableActivityRow = {
2807
2842
  /**
2808
- * Operating system the sandbox runs. Defaults to linux. Setting to windows is admin-only and selects the Windows snapshot/image.
2843
+ * Organisation ID (usersdb organisation UUID).
2809
2844
  */
2810
- osType?: AgentsWorkflowOsType;
2811
- };
2812
- /**
2813
- * Operating system the environment sandbox runs
2814
- */
2815
- type AgentsWorkflowOsType = 'linux' | 'windows';
2816
- /**
2817
- * Response after publishing a workflow
2818
- */
2819
- type AgentsWorkflowPublishWorkflowResponse = {
2845
+ organisationId: CommonUuid;
2820
2846
  /**
2821
- * The ID of the published workflow
2847
+ * Which event was tripped.
2822
2848
  */
2823
- workflowId: CommonUuid;
2849
+ kind: AgentsCustomerActivityNotableActivityKind;
2824
2850
  /**
2825
- * The assigned version number
2851
+ * When the event occurred (for friction: the most recent qualifying run).
2826
2852
  */
2827
- version: number;
2828
- };
2829
- /**
2830
- * Request to sync an execution to a workflow
2831
- */
2832
- type AgentsWorkflowSyncExecutionRequest = {
2853
+ occurredAt: string;
2833
2854
  /**
2834
- * The ID of the execution to sync
2855
+ * Optional human-readable detail for the digest line. Absent when no detail applies.
2835
2856
  */
2836
- executionId: CommonUuid;
2857
+ detail?: string;
2837
2858
  };
2838
2859
  /**
2839
- * Response after syncing execution to workflow
2860
+ * Kind of high-intent activity event surfaced in the customer-health digest.
2840
2861
  */
2841
- type AgentsWorkflowSyncExecutionResponse = {
2842
- /**
2843
- * The ID of the execution that was synced
2844
- */
2845
- executionId: CommonUuid;
2846
- /**
2847
- * The ID of the workflow the execution is now synced to
2848
- */
2849
- workflowId: CommonUuid;
2850
- };
2862
+ type AgentsCustomerActivityNotableActivityKind = 'first_scheduled_agent' | 'first_api_execution' | 'first_agent_built' | 'first_successful_execution' | 'friction';
2851
2863
  /**
2852
- * A file stored on a workflow version. Content is fetched via the workflow-scoped shared-file download endpoints using this id.
2864
+ * Notable-activity events in the lookback window. Used by the customer-health Slack digest.
2853
2865
  */
2854
- type AgentsWorkflowWorkflowFile = {
2855
- /**
2856
- * The unique ID of this file within the workflow version
2857
- */
2858
- id: CommonUuid;
2859
- /**
2860
- * The file path, relative to the agent's shared directory
2861
- */
2862
- filePath: string;
2863
- /**
2864
- * The file's base name
2865
- */
2866
- fileName: string;
2867
- /**
2868
- * The file size in bytes
2869
- */
2870
- fileSize: number;
2871
- /**
2872
- * The file's MIME type, when known
2873
- */
2874
- mimeType?: string;
2875
- /**
2876
- * Hex-encoded SHA-256 of the file contents, when known
2877
- */
2878
- checksum?: string;
2879
- /**
2880
- * When this file was first added to the workflow lineage
2881
- */
2882
- createdAt: string;
2866
+ type AgentsCustomerActivityNotableActivityList = {
2867
+ events: Array<AgentsCustomerActivityNotableActivityRow>;
2883
2868
  /**
2884
- * When this file was last modified
2869
+ * Inclusive lower bound on occurredAt (UTC).
2885
2870
  */
2886
- updatedAt: string;
2871
+ since: string;
2887
2872
  };
2888
2873
  /**
2889
- * The typed inputs a workflow declares
2874
+ * Per-org trailing 7-day windows for the customer-health digest deltas.
2890
2875
  */
2891
- type AgentsWorkflowWorkflowInputs = {
2892
- /**
2893
- * Typed input definitions the workflow accepts at execution time
2894
- */
2895
- inputs: Array<AgentsWorkflowInput>;
2876
+ type AgentsCustomerActivityCustomerWindowStatsRow = {
2877
+ organisationId: CommonUuid;
2878
+ windows: Array<AgentsCustomerActivityOrgWindowStat>;
2896
2879
  };
2897
2880
  /**
2898
- * Output schemas keyed by output node name. Only output nodes that have a schema configured are included; the value is that node's JSON schema.
2881
+ * Window-stats rows for every org with executions in the trailing baseline.
2899
2882
  */
2900
- type AgentsWorkflowWorkflowOutputSchemas = {
2901
- [key: string]: unknown;
2883
+ type AgentsCustomerActivityCustomerWindowStatsList = {
2884
+ rows: Array<AgentsCustomerActivityCustomerWindowStatsRow>;
2885
+ computedAt: string;
2902
2886
  };
2903
2887
  /**
2904
- * Lightweight workflow reference for listing workflows without full data
2888
+ * Per-organisation engagement-activity row for the admin customers dashboard. Owned by the agents service; the frontend joins it onto billing identity on organisationId.
2905
2889
  */
2906
- type AgentsWorkflowWorkflowRef = {
2890
+ type AgentsCustomerActivityCustomerActivityRow = {
2907
2891
  /**
2908
- * The unique ID of this workflow
2892
+ * Organisation ID (usersdb organisation UUID).
2909
2893
  */
2910
- id: CommonUuid;
2894
+ organisationId: CommonUuid;
2911
2895
  /**
2912
- * The ID of the parent workflow this was derived from (for lineage tracking)
2896
+ * Timestamp of the most recent execution. Absent when the org never ran one.
2913
2897
  */
2914
- parentId?: CommonUuid;
2898
+ lastActivityAt?: string;
2915
2899
  /**
2916
- * The monotonic per-agent snapshot version number.
2900
+ * Total agents (workflow groups) ever created by the org.
2917
2901
  */
2918
- version: number;
2902
+ agentCount: number;
2919
2903
  /**
2920
- * Whether this snapshot is the agent's published version (the API default). At most one snapshot per agent is published.
2904
+ * Executions created in the last 7 days.
2921
2905
  */
2922
- isPublished: boolean;
2906
+ execs7d: number;
2923
2907
  /**
2924
- * When this workflow was created
2908
+ * Executions created in the last 30 days.
2925
2909
  */
2926
- createdAt: string;
2910
+ execs30d: number;
2927
2911
  /**
2928
- * The email of the user who created this workflow.
2912
+ * Distinct UTC days with at least one execution created in the last 14 days. Raw baseline for the digest's sudden-stop signal.
2929
2913
  */
2930
- author?: string;
2914
+ activeDays14d: number;
2931
2915
  /**
2932
- * Whether this snapshot can be deleted (not published and never executed)
2916
+ * Count of ExecutionFailed/ExecutionActionFailed events carrying an os_error (infrastructure/sandbox failure, as opposed to a task failure) in the last 7 days.
2933
2917
  */
2934
- isDeletable: boolean;
2935
- };
2936
- /**
2937
- * A workflow (commit) representing an immutable snapshot of agent configuration
2938
- */
2939
- type AgentsWorkflowWorkflowSnapshot = {
2918
+ osErrorCount7d: number;
2940
2919
  /**
2941
- * The unique ID of this workflow
2920
+ * completed / (completed+failed) over runs that ended in the last 7 days, 0..1. Absent when fewer than 5 finished runs (volume floor).
2942
2921
  */
2943
- id: CommonUuid;
2922
+ successRate7d?: number;
2944
2923
  /**
2945
- * The agent ID this workflow belongs to
2924
+ * Risk from inactivity: red >14d, amber 7-14d, green <7d since last activity. Never-active orgs are red.
2946
2925
  */
2947
- agentId: CommonUuid;
2926
+ inactivityRisk: AgentsCustomerActivityRiskLevel;
2948
2927
  /**
2949
- * The ID of the parent workflow this was derived from (for lineage tracking)
2928
+ * Risk from success rate: red <30%, amber 30-70%, green >70%. Absent below the volume floor.
2950
2929
  */
2951
- parentId?: CommonUuid;
2930
+ qualityRisk?: AgentsCustomerActivityRiskLevel;
2952
2931
  /**
2953
- * The monotonic per-agent snapshot version number.
2932
+ * Worse of the two risks. The frontend weights this by MRR to derive the dashboard priority sort.
2954
2933
  */
2955
- version: number;
2934
+ overallRisk: AgentsCustomerActivityRiskLevel;
2935
+ };
2936
+ /**
2937
+ * Engagement-activity rows for every organisation that has run an execution or built an agent.
2938
+ */
2939
+ type AgentsCustomerActivityCustomerActivityList = {
2940
+ rows: Array<AgentsCustomerActivityCustomerActivityRow>;
2956
2941
  /**
2957
- * Whether this snapshot is the agent's published version (the API default). At most one snapshot per agent is published.
2942
+ * When the snapshot was computed (server time).
2958
2943
  */
2959
- isPublished: boolean;
2944
+ computedAt: string;
2945
+ };
2946
+ type AgentsContextUserOrganization = {
2947
+ id: CommonUuid;
2948
+ name: string;
2949
+ };
2950
+ type AgentsContextUserContextResponse = {
2951
+ userId: CommonUuid;
2952
+ email: string;
2953
+ organizations: Array<AgentsContextUserOrganization>;
2954
+ };
2955
+ type AgentsAgentUpdateRequest = {
2960
2956
  /**
2961
- * The rules/instructions for this workflow
2957
+ * New name for the agent.
2962
2958
  */
2963
- rules: string;
2959
+ name?: string;
2960
+ };
2961
+ type AgentsAgentSortField = 'name' | 'created_at';
2962
+ type AgentsAgentExecuteAgentResponse = {
2964
2963
  /**
2965
- * The settings for this workflow
2964
+ * The ID of the newly created execution
2966
2965
  */
2967
- settings: AgentsGraphModelsSettings;
2966
+ executionId: CommonUuid;
2967
+ };
2968
+ type AgentsAgentExecuteAgentRequest = {
2968
2969
  /**
2969
- * The workflow graph
2970
+ * The ID of the agent profile to use for this execution. Mutually exclusive with agentProfilePoolId.
2970
2971
  */
2971
- graph: AgentsGraphModelsAgentGraph;
2972
+ agentProfileId?: CommonUuid;
2972
2973
  /**
2973
- * Optional environment template. Defaults to browser/anchor if not provided.
2974
+ * The ID of the agent profile pool to select a profile from. Mutually exclusive with agentProfileId.
2974
2975
  */
2975
- environmentTemplate?: AgentsWorkflowEnvironmentTemplate;
2976
+ agentProfilePoolId?: CommonUuid;
2976
2977
  /**
2977
- * Typed input definitions for workflow execution. Includes names referenced in prompts, which default to optional strings.
2978
+ * Inputs to be merged into the placeholders defined in prompts
2978
2979
  */
2979
- inputs: Array<AgentsWorkflowInput>;
2980
+ inputs?: {
2981
+ [key: string]: unknown;
2982
+ };
2980
2983
  /**
2981
- * The files stored on this workflow version. Empty when the workflow has no files.
2984
+ * Deprecated: Use 'inputs' instead. Inputs to be merged into the placeholders defined in prompts
2985
+ *
2986
+ * @deprecated
2982
2987
  */
2983
- files: Array<AgentsWorkflowWorkflowFile>;
2988
+ dynamicData?: {
2989
+ [key: string]: unknown;
2990
+ };
2984
2991
  /**
2985
- * When this workflow was created. For the editable head this is restamped on each in-place edit, so it doubles as the last-edited time.
2992
+ * Array of temporary files to attach to the execution. Must have been pre-uploaded using the stage file endpoint
2986
2993
  */
2987
- createdAt: string;
2994
+ tempFiles?: Array<AgentsFilesTempFile>;
2988
2995
  /**
2989
- * The email of the user who created this workflow.
2996
+ * Optional metadata key-value pairs (string keys and string values) for organizing and filtering executions
2990
2997
  */
2991
- author?: string;
2998
+ metadata?: {
2999
+ [key: string]: unknown;
3000
+ };
2992
3001
  /**
2993
- * Monotonic optimistic-concurrency revision. Only meaningful for the editable head: supply it as baseRev on the next head patch; a stale baseRev is rejected with 409. Frozen snapshots never receive in-place patches.
3002
+ * The version of the agent to execute. If not provided, the latest version will be used.
2994
3003
  */
2995
- rev: number;
2996
- };
2997
- type CommonBadRequestErrorBody = {
2998
- code: 400;
2999
- message: string;
3000
- };
3001
- type CommonConflictErrorBody = {
3002
- code: 409;
3003
- message: string;
3004
- };
3005
- type CommonError = {
3006
- code: number;
3007
- message: string;
3008
- };
3009
- type CommonForbiddenErrorBody = {
3010
- code: 403;
3011
- message: string;
3004
+ version?: number;
3005
+ /**
3006
+ * Per-execution runtime options that override or extend the agent's default settings.
3007
+ */
3008
+ executionOptions?: AgentsAgentExecutionOptions;
3012
3009
  };
3013
- type CommonInternalServerErrorBody = {
3014
- code: 500;
3015
- message: string;
3010
+ type AgentsAgentCreateResponse = {
3011
+ id: CommonUuid;
3016
3012
  };
3017
- type CommonNotFoundErrorBody = {
3018
- code: 404;
3019
- message: string;
3013
+ type AgentsAgentCreateRequest = {
3014
+ organizationId: CommonUuid;
3015
+ name: string;
3016
+ workflow: AgentsWorkflowCreateWorkflowRequest;
3020
3017
  };
3021
- type CommonOsError = {
3022
- message: string;
3018
+ type AgentsAgentBase = {
3019
+ id: CommonUuid;
3020
+ name: string;
3021
+ createdAt: string;
3022
+ organizationId?: CommonUuid;
3023
+ userId: CommonUuid;
3023
3024
  };
3024
- type CommonPaymentRequiredErrorBody = {
3025
- code: 402;
3026
- message: string;
3025
+ type AgentsAgentAvailableToolsResponse = {
3026
+ tools: Array<AgentsAgentAvailableTool>;
3027
3027
  };
3028
- type CommonSortDirection = 'asc' | 'desc';
3029
- type CommonUnauthorizedErrorBody = {
3030
- code: 401;
3031
- message: string;
3028
+ type AgentsAgentAvailableTool = {
3029
+ name: string;
3030
+ description: string;
3031
+ capability: string;
3032
+ isRequired: boolean;
3032
3033
  };
3033
- type CommonUuid = string;
3034
- type Version = 'v1';
3035
- type AgentsAgentSearch = string;
3036
- /**
3037
- * Filter by agent ID
3038
- */
3039
- type AgentsExecutionSearchAgentId = CommonUuid;
3034
+ type CommonPaginationPageSize = number;
3035
+ type CommonPaginationPage = number;
3040
3036
  /**
3041
- * Filter by agent profile IDs (can specify multiple, there is an 'OR' condition applied to these)
3037
+ * Search profiles by name (partial match)
3042
3038
  */
3043
- type AgentsExecutionSearchAgentProfileIds = Array<CommonUuid>;
3039
+ type AgentsProfileSearch = string;
3044
3040
  /**
3045
- * Filter executions created after this timestamp
3041
+ * Search pools by name (partial match)
3046
3042
  */
3047
- type AgentsExecutionSearchCreatedAfter = string;
3043
+ type AgentsProfilePoolSearch = string;
3048
3044
  /**
3049
- * Filter executions created before this timestamp
3045
+ * Filter by workflow version number
3050
3046
  */
3051
- type AgentsExecutionSearchCreatedBefore = string;
3047
+ type AgentsExecutionSearchWorkflowVersion = number;
3052
3048
  /**
3053
- * Search by execution ID (partial, case-insensitive match)
3049
+ * Filter by execution status (can specify multiple, there is an 'OR' condition applied to these)
3054
3050
  */
3055
- type AgentsExecutionSearchExecutionId = string;
3051
+ type AgentsExecutionSearchStatus = Array<AgentsExecutionStatus>;
3056
3052
  /**
3057
- * Filter by whether the execution recorded any script failures
3053
+ * Filter by execution result outcome (partial, case-insensitive match)
3058
3054
  */
3059
- type AgentsExecutionSearchHasScriptFailures = boolean;
3055
+ type AgentsExecutionSearchOutcomeLabel = string;
3060
3056
  /**
3061
- * Filter by human labels (can specify multiple label IDs, there is an 'OR' condition applied to these)
3057
+ * Filter by metadata value - must be used together with metadataKey
3062
3058
  */
3063
- type AgentsExecutionSearchHumanLabels = Array<CommonUuid>;
3059
+ type AgentsExecutionSearchMetadataValue = string;
3064
3060
  /**
3065
- * Filter by input variable key - must be used together with inputsValue
3061
+ * Filter by metadata key - must be used together with metadataValue
3066
3062
  */
3067
- type AgentsExecutionSearchInputsKey = string;
3063
+ type AgentsExecutionSearchMetadataKey = string;
3068
3064
  /**
3069
3065
  * Filter by input variable value (partial, case-insensitive match) - must be used together with inputsKey
3070
3066
  */
3071
3067
  type AgentsExecutionSearchInputsValue = string;
3072
3068
  /**
3073
- * Filter by metadata key - must be used together with metadataValue
3069
+ * Filter by input variable key - must be used together with inputsValue
3074
3070
  */
3075
- type AgentsExecutionSearchMetadataKey = string;
3071
+ type AgentsExecutionSearchInputsKey = string;
3076
3072
  /**
3077
- * Filter by metadata value - must be used together with metadataKey
3073
+ * Filter by human labels (can specify multiple label IDs, there is an 'OR' condition applied to these)
3078
3074
  */
3079
- type AgentsExecutionSearchMetadataValue = string;
3075
+ type AgentsExecutionSearchHumanLabels = Array<CommonUuid>;
3080
3076
  /**
3081
- * Filter by execution result outcome (partial, case-insensitive match)
3077
+ * Filter by whether the execution recorded any script failures
3082
3078
  */
3083
- type AgentsExecutionSearchOutcomeLabel = string;
3079
+ type AgentsExecutionSearchHasScriptFailures = boolean;
3084
3080
  /**
3085
- * Filter by execution status (can specify multiple, there is an 'OR' condition applied to these)
3081
+ * Search by execution ID (partial, case-insensitive match)
3086
3082
  */
3087
- type AgentsExecutionSearchStatus = Array<AgentsExecutionStatus>;
3083
+ type AgentsExecutionSearchExecutionId = string;
3088
3084
  /**
3089
- * Filter by workflow version number
3085
+ * Filter executions created before this timestamp
3090
3086
  */
3091
- type AgentsExecutionSearchWorkflowVersion = number;
3087
+ type AgentsExecutionSearchCreatedBefore = string;
3092
3088
  /**
3093
- * Search pools by name (partial match)
3089
+ * Filter executions created after this timestamp
3094
3090
  */
3095
- type AgentsProfilePoolSearch = string;
3091
+ type AgentsExecutionSearchCreatedAfter = string;
3096
3092
  /**
3097
- * Search profiles by name (partial match)
3093
+ * Filter by agent profile IDs (can specify multiple, there is an 'OR' condition applied to these)
3098
3094
  */
3099
- type AgentsProfileSearch = string;
3100
- type CommonPaginationPage = number;
3101
- type CommonPaginationPageSize = number;
3095
+ type AgentsExecutionSearchAgentProfileIds = Array<CommonUuid>;
3096
+ /**
3097
+ * Filter by agent ID
3098
+ */
3099
+ type AgentsExecutionSearchAgentId = CommonUuid;
3100
+ type AgentsAgentSearch = string;
3102
3101
  type AdminCustomerActivityListData = {
3103
3102
  body?: never;
3104
3103
  path?: never;
@@ -5579,7 +5578,7 @@ declare const agentExecutePost: <ThrowOnError extends boolean = false>(options:
5579
5578
  /**
5580
5579
  * Get Agent Shared Files
5581
5580
  *
5582
- * Deprecated: resolves the agent's latest published workflow version's shared files. Use the workflow-scoped endpoint to target a specific version.
5581
+ * Deprecated: implicitly resolves the agent's latest published workflow version and returns that version's files. Use GET /agents/{agentId}/workflows/{workflowId}/agent-files to target an explicit workflow version instead.
5583
5582
  *
5584
5583
  * @deprecated
5585
5584
  */
@@ -5587,7 +5586,7 @@ declare const agentSharedFilesGet: <ThrowOnError extends boolean = false>(option
5587
5586
  /**
5588
5587
  * Upload Agent Shared Files
5589
5588
  *
5590
- * Deprecated: uploads to the agent's latest published version, deriving a new workflow version. Use the workflow-scoped endpoint.
5589
+ * Deprecated: implicitly uploads to the agent's latest published workflow version, deriving a new workflow version behind the scenes. Use POST /agents/{agentId}/workflows/{workflowId}/agent-files to upload to an explicit workflow version instead.
5591
5590
  *
5592
5591
  * @deprecated
5593
5592
  */
@@ -5595,7 +5594,7 @@ declare const agentSharedFilesUpload: <ThrowOnError extends boolean = false>(opt
5595
5594
  /**
5596
5595
  * Delete All Agent Shared Files
5597
5596
  *
5598
- * Delete all shared files for an agent.
5597
+ * Deprecated: delete all shared files from the agent's latest published workflow version. Use the batch DELETE /agents/{agentId}/workflows/{workflowId}/agent-files endpoint to target an explicit workflow version instead.
5599
5598
  *
5600
5599
  * @deprecated
5601
5600
  */
@@ -5603,7 +5602,7 @@ declare const agentSharedFilesDeleteAll: <ThrowOnError extends boolean = false>(
5603
5602
  /**
5604
5603
  * Delete Agent Shared File
5605
5604
  *
5606
- * Delete a file from the agent's persistent shared storage.
5605
+ * Deprecated: delete a file from the agent's latest published workflow version. Use DELETE /agents/{agentId}/workflows/{workflowId}/agent-files/{fileId} to target an explicit workflow version instead.
5607
5606
  *
5608
5607
  * @deprecated
5609
5608
  */
@@ -5611,7 +5610,7 @@ declare const agentSharedFilesDelete: <ThrowOnError extends boolean = false>(opt
5611
5610
  /**
5612
5611
  * Update Agent Shared File
5613
5612
  *
5614
- * Replace the contents of a shared file. The request body must contain exactly one file.
5613
+ * Deprecated: replace the contents of a shared file in the agent's latest published workflow version. The request body must contain exactly one file. Use PUT /agents/{agentId}/workflows/{workflowId}/agent-files/{fileId} to target an explicit workflow version instead.
5615
5614
  *
5616
5615
  * @deprecated
5617
5616
  */
@@ -5619,7 +5618,7 @@ declare const agentSharedFilesUpdate: <ThrowOnError extends boolean = false>(opt
5619
5618
  /**
5620
5619
  * Download shared file
5621
5620
  *
5622
- * Deprecated: redirects to a short-lived signed URL for a file in the agent's latest published version. Use the workflow-scoped endpoint.
5621
+ * Deprecated: redirects to a short-lived signed URL for a file in the agent's latest published workflow version. Use GET /agents/{agentId}/workflows/{workflowId}/agent-files/{fileId}/download to target an explicit workflow version instead.
5623
5622
  *
5624
5623
  * @deprecated
5625
5624
  */
@@ -5799,4 +5798,4 @@ declare const schemaValidationValidate: <ThrowOnError extends boolean = false>(o
5799
5798
  */
5800
5799
  declare const tempFilesStage: <ThrowOnError extends boolean = false>(options: Options<TempFilesStageData, ThrowOnError>) => RequestResult<TempFilesStageResponses, TempFilesStageErrors, ThrowOnError, "fields">;
5801
5800
 
5802
- export { type AdminCustomerActivityListData, type AdminCustomerActivityListError, type AdminCustomerActivityListErrors, type AdminCustomerActivityListResponse, type AdminCustomerActivityListResponses, type AdminCustomerActivityNotableListData, type AdminCustomerActivityNotableListError, type AdminCustomerActivityNotableListErrors, type AdminCustomerActivityNotableListResponse, type AdminCustomerActivityNotableListResponses, type AdminCustomerActivityWindowStatsListData, type AdminCustomerActivityWindowStatsListError, type AdminCustomerActivityWindowStatsListErrors, type AdminCustomerActivityWindowStatsListResponse, type AdminCustomerActivityWindowStatsListResponses, type AgentByIdDeleteData, type AgentByIdDeleteError, type AgentByIdDeleteErrors, type AgentByIdDeleteResponse, type AgentByIdDeleteResponses, type AgentByIdUpdateData, type AgentByIdUpdateError, type AgentByIdUpdateErrors, type AgentByIdUpdateResponses, type AgentCreateData, type AgentCreateError, type AgentCreateErrors, type AgentCreateResponse, type AgentCreateResponses, type AgentExecutePostData, type AgentExecutePostError, type AgentExecutePostErrors, type AgentExecutePostResponse, type AgentExecutePostResponses, type AgentListData, type AgentListError, type AgentListErrors, type AgentListResponse, type AgentListResponses, type AgentProfileClearBrowserCacheData, type AgentProfileClearBrowserCacheError, type AgentProfileClearBrowserCacheErrors, type AgentProfileClearBrowserCacheResponse, type AgentProfileClearBrowserCacheResponses, type AgentProfileDeleteData, type AgentProfileDeleteError, type AgentProfileDeleteErrors, type AgentProfileDeleteResponse, type AgentProfileDeleteResponses, type AgentProfileDuplicateData, type AgentProfileDuplicateError, type AgentProfileDuplicateErrors, type AgentProfileDuplicateResponse, type AgentProfileDuplicateResponses, type AgentProfileGetData, type AgentProfileGetError, type AgentProfileGetErrors, type AgentProfileGetInboxEmailData, type AgentProfileGetInboxEmailError, type AgentProfileGetInboxEmailErrors, type AgentProfileGetInboxEmailResponse, type AgentProfileGetInboxEmailResponses, type AgentProfileGetInboxEmailsData, type AgentProfileGetInboxEmailsError, type AgentProfileGetInboxEmailsErrors, type AgentProfileGetInboxEmailsResponse, type AgentProfileGetInboxEmailsResponses, type AgentProfileGetResponse, type AgentProfileGetResponses, type AgentProfilePoolDeleteData, type AgentProfilePoolDeleteError, type AgentProfilePoolDeleteErrors, type AgentProfilePoolDeleteResponse, type AgentProfilePoolDeleteResponses, type AgentProfilePoolGetData, type AgentProfilePoolGetError, type AgentProfilePoolGetErrors, type AgentProfilePoolGetResponse, type AgentProfilePoolGetResponses, type AgentProfilePoolMembersAddData, type AgentProfilePoolMembersAddError, type AgentProfilePoolMembersAddErrors, type AgentProfilePoolMembersAddResponse, type AgentProfilePoolMembersAddResponses, type AgentProfilePoolMembersListData, type AgentProfilePoolMembersListError, type AgentProfilePoolMembersListErrors, type AgentProfilePoolMembersListResponse, type AgentProfilePoolMembersListResponses, type AgentProfilePoolMembersRemoveData, type AgentProfilePoolMembersRemoveError, type AgentProfilePoolMembersRemoveErrors, type AgentProfilePoolMembersRemoveResponse, type AgentProfilePoolMembersRemoveResponses, type AgentProfilePoolUpdateData, type AgentProfilePoolUpdateError, type AgentProfilePoolUpdateErrors, type AgentProfilePoolUpdateResponse, type AgentProfilePoolUpdateResponses, type AgentProfilePoolsCreateData, type AgentProfilePoolsCreateError, type AgentProfilePoolsCreateErrors, type AgentProfilePoolsCreateResponse, type AgentProfilePoolsCreateResponses, type AgentProfilePoolsListData, type AgentProfilePoolsListError, type AgentProfilePoolsListErrors, type AgentProfilePoolsListResponse, type AgentProfilePoolsListResponses, type AgentProfileUpdateData, type AgentProfileUpdateError, type AgentProfileUpdateErrors, type AgentProfileUpdateResponse, type AgentProfileUpdateResponses, type AgentProfilesCreateData, type AgentProfilesCreateError, type AgentProfilesCreateErrors, type AgentProfilesCreateResponse, type AgentProfilesCreateResponses, type AgentProfilesListData, type AgentProfilesListError, type AgentProfilesListErrors, type AgentProfilesListResponse, type AgentProfilesListResponses, type AgentSharedFileDownloadRedirectData, type AgentSharedFileDownloadRedirectError, type AgentSharedFileDownloadRedirectErrors, type AgentSharedFilesDeleteAllData, type AgentSharedFilesDeleteAllError, type AgentSharedFilesDeleteAllErrors, type AgentSharedFilesDeleteAllResponse, type AgentSharedFilesDeleteAllResponses, type AgentSharedFilesDeleteData, type AgentSharedFilesDeleteError, type AgentSharedFilesDeleteErrors, type AgentSharedFilesDeleteResponse, type AgentSharedFilesDeleteResponses, type AgentSharedFilesFreezeData, type AgentSharedFilesFreezeError, type AgentSharedFilesFreezeErrors, type AgentSharedFilesFreezeResponse, type AgentSharedFilesFreezeResponses, type AgentSharedFilesGetData, type AgentSharedFilesGetError, type AgentSharedFilesGetErrors, type AgentSharedFilesGetResponse, type AgentSharedFilesGetResponses, type AgentSharedFilesUpdateData, type AgentSharedFilesUpdateError, type AgentSharedFilesUpdateErrors, type AgentSharedFilesUpdateResponse, type AgentSharedFilesUpdateResponses, type AgentSharedFilesUploadData, type AgentSharedFilesUploadError, type AgentSharedFilesUploadErrors, type AgentSharedFilesUploadResponse, type AgentSharedFilesUploadResponses, type AgentWorkflowsCreateData, type AgentWorkflowsCreateError, type AgentWorkflowsCreateErrors, type AgentWorkflowsCreateResponse, type AgentWorkflowsCreateResponses, type AgentWorkflowsDeleteWorkflowData, type AgentWorkflowsDeleteWorkflowError, type AgentWorkflowsDeleteWorkflowErrors, type AgentWorkflowsDeleteWorkflowResponse, type AgentWorkflowsDeleteWorkflowResponses, type AgentWorkflowsExecuteData, type AgentWorkflowsExecuteError, type AgentWorkflowsExecuteErrors, type AgentWorkflowsExecuteResponse, type AgentWorkflowsExecuteResponses, type AgentWorkflowsGetData, type AgentWorkflowsGetError, type AgentWorkflowsGetErrors, type AgentWorkflowsGetInputsData, type AgentWorkflowsGetInputsError, type AgentWorkflowsGetInputsErrors, type AgentWorkflowsGetInputsResponse, type AgentWorkflowsGetInputsResponses, type AgentWorkflowsGetOutputSchemasData, type AgentWorkflowsGetOutputSchemasError, type AgentWorkflowsGetOutputSchemasErrors, type AgentWorkflowsGetOutputSchemasResponse, type AgentWorkflowsGetOutputSchemasResponses, type AgentWorkflowsGetResponse, type AgentWorkflowsGetResponses, type AgentWorkflowsListData, type AgentWorkflowsListError, type AgentWorkflowsListErrors, type AgentWorkflowsListResponse, type AgentWorkflowsListResponses, type AgentWorkflowsPublishData, type AgentWorkflowsPublishError, type AgentWorkflowsPublishErrors, type AgentWorkflowsPublishResponse, type AgentWorkflowsPublishResponses, type AgentWorkflowsSyncExecutionData, type AgentWorkflowsSyncExecutionError, type AgentWorkflowsSyncExecutionErrors, type AgentWorkflowsSyncExecutionResponse, type AgentWorkflowsSyncExecutionResponses, type AgentsAgentAvailableTool, type AgentsAgentAvailableToolsResponse, type AgentsAgentBase, type AgentsAgentCreateRequest, type AgentsAgentCreateResponse, type AgentsAgentExecuteAgentRequest, type AgentsAgentExecuteAgentResponse, type AgentsAgentExecutionOptions, type AgentsAgentSearch, type AgentsAgentSortField, type AgentsAgentUpdateRequest, type AgentsContextUserContextResponse, type AgentsContextUserOrganization, type AgentsCustomerActivityCustomerActivityList, type AgentsCustomerActivityCustomerActivityRow, type AgentsCustomerActivityCustomerWindowStatsList, type AgentsCustomerActivityCustomerWindowStatsRow, type AgentsCustomerActivityNotableActivityKind, type AgentsCustomerActivityNotableActivityList, type AgentsCustomerActivityNotableActivityRow, type AgentsCustomerActivityOrgWindowStat, type AgentsCustomerActivityRiskLevel, type AgentsDocsSearchDocsRequest, type AgentsDocsSearchDocsResponse, type AgentsDocsSearchResult, type AgentsExecutionActionName, type AgentsExecutionActivity, type AgentsExecutionActivityActionCompletedInfo, type AgentsExecutionActivityActionCompletedPayload, type AgentsExecutionActivityActionFailedPayload, type AgentsExecutionActivityActionStartedInfo, type AgentsExecutionActivityActionStartedPayload, type AgentsExecutionActivityCompactionPerformedPayload, type AgentsExecutionActivityCompactionStartedPayload, type AgentsExecutionActivityDisplay, type AgentsExecutionActivityFileAddedPayload, type AgentsExecutionActivityGenericPayload, type AgentsExecutionActivityInputSchemaResolvedPayload, type AgentsExecutionActivityPayloadUnion, type AgentsExecutionActivityPlaywrightScriptGeneratedPayload, type AgentsExecutionActivityPresentationLevel, type AgentsExecutionActivityReasoningPayload, type AgentsExecutionActivityScriptVariablesSubstitutedPayload, type AgentsExecutionActivityStatusChangedPayload, type AgentsExecutionActivityStepCompletedPayload, type AgentsExecutionActivityStepStartedPayload, type AgentsExecutionActivityTodosUpdatedPayload, type AgentsExecutionActivityTransitionedNodePayload, type AgentsExecutionActivityUserMessageReceivedPayload, type AgentsExecutionActivityWorkflowUpdatedPayload, type AgentsExecutionAdvisorCompletedDetails, type AgentsExecutionAgentQueryContextCompletedDetails, type AgentsExecutionAgentQueryContextStartedDetails, type AgentsExecutionApiKeyRef, type AgentsExecutionApiTriggerContext, type AgentsExecutionAskUserQuestion, type AgentsExecutionAwaitingConfirmationPayload, type AgentsExecutionBrowserRunCodeCompletedDetails, type AgentsExecutionBrowserRunCodeStartedDetails, type AgentsExecutionCancelReason, type AgentsExecutionCancelledPayload, type AgentsExecutionComment, type AgentsExecutionCompletedPayload, type AgentsExecutionElementFileUploadCompletedDetails, type AgentsExecutionExecutionResult, type AgentsExecutionExtApiCallCompletedDetails, type AgentsExecutionExtGetMailCompletedDetails, type AgentsExecutionExtSendMailCompletedDetails, type AgentsExecutionExtSendMailStartedDetails, type AgentsExecutionFailedPayload, type AgentsExecutionFileListCompletedDetails, type AgentsExecutionFileReadCompletedDetails, type AgentsExecutionFileStageCompletedDetails, type AgentsExecutionHandoffPrepareCompletedDetails, type AgentsExecutionHandoffPrepareStartedDetails, type AgentsExecutionHandoffPrepareVariable, type AgentsExecutionHumanLabel, type AgentsExecutionListItem, type AgentsExecutionLlmCallPurpose, type AgentsExecutionLlmCallStartedDetails, type AgentsExecutionNavToCompletedDetails, type AgentsExecutionNavToStartedDetails, type AgentsExecutionNodeDetails, type AgentsExecutionNodeOutputItem, type AgentsExecutionObsSnapshotWithSelectorsCompletedDetails, type AgentsExecutionPausedPayload, type AgentsExecutionQuestionItem, type AgentsExecutionQuestionOption, type AgentsExecutionReadFileCompletedDetails, type AgentsExecutionReadFileStartedDetails, type AgentsExecutionRulesDetails, type AgentsExecutionScheduleRef, type AgentsExecutionScheduleTriggerContext, type AgentsExecutionScratchpadReadCompletedDetails, type AgentsExecutionScratchpadReadStartedDetails, type AgentsExecutionScratchpadWriteCompletedDetails, type AgentsExecutionScratchpadWriteStartedDetails, type AgentsExecutionScriptEvalCompletedDetails, type AgentsExecutionScriptEvalStartedDetails, type AgentsExecutionScriptFailure, type AgentsExecutionScriptHybridPlaywrightCompletedDetails, type AgentsExecutionScriptHybridPlaywrightStartedDetails, type AgentsExecutionScriptPadRunFunctionCompletedDetails, type AgentsExecutionScriptPlaywrightCompletedDetails, type AgentsExecutionScriptPlaywrightStartedDetails, type AgentsExecutionScriptpadReadCompletedDetails, type AgentsExecutionScriptpadReadStartedDetails, type AgentsExecutionScriptpadRunFunctionStartedDetails, type AgentsExecutionScriptpadSearchReplaceCompletedDetails, type AgentsExecutionScriptpadSearchReplaceStartedDetails, type AgentsExecutionScriptpadWriteCompletedDetails, type AgentsExecutionSdkBashCompletedDetails, type AgentsExecutionSdkBashStartedDetails, type AgentsExecutionSdkEditCompletedDetails, type AgentsExecutionSdkEditStartedDetails, type AgentsExecutionSdkGlobCompletedDetails, type AgentsExecutionSdkGlobStartedDetails, type AgentsExecutionSdkGrepCompletedDetails, type AgentsExecutionSdkGrepStartedDetails, type AgentsExecutionSdkReadCompletedDetails, type AgentsExecutionSdkReadStartedDetails, type AgentsExecutionSdkSkillCompletedDetails, type AgentsExecutionSdkSkillStartedDetails, type AgentsExecutionSdkWriteCompletedDetails, type AgentsExecutionSdkWriteStartedDetails, type AgentsExecutionSearchAgentId, type AgentsExecutionSearchAgentProfileIds, type AgentsExecutionSearchCreatedAfter, type AgentsExecutionSearchCreatedBefore, type AgentsExecutionSearchExecutionId, type AgentsExecutionSearchHasScriptFailures, type AgentsExecutionSearchHumanLabels, type AgentsExecutionSearchInputsKey, type AgentsExecutionSearchInputsValue, type AgentsExecutionSearchMetadataKey, type AgentsExecutionSearchMetadataValue, type AgentsExecutionSearchOutcomeLabel, type AgentsExecutionSearchStatus, type AgentsExecutionSearchWorkflowVersion, type AgentsExecutionSortField, type AgentsExecutionStatus, type AgentsExecutionTerminalPayload, type AgentsExecutionTodo, type AgentsExecutionTodoStatus, type AgentsExecutionTransitionDetails, type AgentsExecutionTriggerContext, type AgentsExecutionTriggerRunner, type AgentsExecutionUiTriggerContext, type AgentsExecutionUpdateExecutionStatusRequest, type AgentsExecutionUpdateType, type AgentsExecutionUpdateableStatus, type AgentsExecutionUserMessagesAddTextBody, type AgentsExecutionUtilGetDatetimeCompletedDetails, type AgentsExecutionUtilGetDatetimeStartedDetails, type AgentsExecutionWorkflowUpdate, type AgentsFilesAgentFile, type AgentsFilesAgentFileCreatedBy, type AgentsFilesAgentFileDirectory, type AgentsFilesAgentFilesDirectoryListing, type AgentsFilesAgentFilesResponse, type AgentsFilesFile, type AgentsFilesFilePart, type AgentsFilesSetFrozenRequest, type AgentsFilesSharedFile, type AgentsFilesSharedFileUploadResponse, type AgentsFilesSharedFilesResponse, type AgentsFilesTempFile, type AgentsFilesTempFilesResponse, type AgentsGraphModelsAgentGraph, type AgentsGraphModelsLlmProvider, type AgentsGraphModelsNodesNode, type AgentsGraphModelsNodesNodePropertiesUnion, type AgentsGraphModelsNodesNodeType, type AgentsGraphModelsNodesPosition, type AgentsGraphModelsNodesPropertiesApiMethod, type AgentsGraphModelsNodesPropertiesApiProperties, type AgentsGraphModelsNodesPropertiesIrisPlaywrightScriptProperties, type AgentsGraphModelsNodesPropertiesIrisProperties, type AgentsGraphModelsNodesPropertiesNodeCapabilities, type AgentsGraphModelsNodesPropertiesOutcomeString, type AgentsGraphModelsNodesPropertiesOutputProperties, type AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVar, type AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVarType, type AgentsGraphModelsNodesPropertiesPlaywrightScriptProperties, type AgentsGraphModelsNodesPropertiesStartProperties, type AgentsGraphModelsNodesPropertiesUrlProperties, type AgentsGraphModelsNodesSize, type AgentsGraphModelsSettings, type AgentsGraphModelsStickyNote, type AgentsGraphModelsTransitionsPropertiesIrisProperties, type AgentsGraphModelsTransitionsPropertiesOutcomeSuccessProperties, type AgentsGraphModelsTransitionsPropertiesSelectorProperties, type AgentsGraphModelsTransitionsTransition, type AgentsGraphModelsTransitionsTransitionPropertiesUnion, type AgentsGraphModelsTransitionsTransitionType, type AgentsGraphModelsTypeInputMethod, type AgentsProfileAddProfilesToPoolRequest, type AgentsProfileAgentProfile, type AgentsProfileAgentProfileInboxEmailsResponse, type AgentsProfileAgentProfilePool, type AgentsProfileAgentProfilePoolMember, type AgentsProfileCookie, type AgentsProfileCountryCode, type AgentsProfileCreateAgentProfilePoolRequest, type AgentsProfileCreateAgentProfileRequest, type AgentsProfileCredential, type AgentsProfileCredentialUpdate, type AgentsProfileCustomProxyConfigInput, type AgentsProfileCustomProxyConfigOutput, type AgentsProfileDuplicateAgentProfileRequest, type AgentsProfileOperatingSystem, type AgentsProfilePoolSearch, type AgentsProfilePoolSortField, type AgentsProfileProfileInboxEmail, type AgentsProfileProfileInboxEmailDetail, type AgentsProfileProxyMode, type AgentsProfileProxyType, type AgentsProfileRemoveProfilesFromPoolRequest, type AgentsProfileSameSite, type AgentsProfileSearch, type AgentsProfileSelectionStrategy, type AgentsProfileSortField, type AgentsProfileUpdateAgentProfilePoolRequest, type AgentsProfileUpdateAgentProfileRequest, type AgentsSchemaValidateSchemaRequest, type AgentsSchemaValidateSchemaResponse, type AgentsWorkflowBrowserProvider, type AgentsWorkflowBrowserTemplateConfig, type AgentsWorkflowCreateWorkflowRequest, type AgentsWorkflowCreateWorkflowResponse, type AgentsWorkflowEnvironmentTemplate, type AgentsWorkflowEnvironmentType, type AgentsWorkflowExecuteWorkflowRequest, type AgentsWorkflowExecuteWorkflowResponse, type AgentsWorkflowInput, type AgentsWorkflowOsProvider, type AgentsWorkflowOsTemplateConfig, type AgentsWorkflowOsType, type AgentsWorkflowPublishWorkflowResponse, type AgentsWorkflowSyncExecutionRequest, type AgentsWorkflowSyncExecutionResponse, type AgentsWorkflowWorkflowFile, type AgentsWorkflowWorkflowInputs, type AgentsWorkflowWorkflowOutputSchemas, type AgentsWorkflowWorkflowRef, type AgentsWorkflowWorkflowSnapshot, type AvailableToolsListData, type AvailableToolsListError, type AvailableToolsListErrors, type AvailableToolsListResponse, type AvailableToolsListResponses, type ClientOptions, type CommonBadRequestErrorBody, type CommonConflictErrorBody, type CommonError, type CommonForbiddenErrorBody, type CommonInternalServerErrorBody, type CommonNotFoundErrorBody, type CommonOsError, type CommonPaginationPage, type CommonPaginationPageSize, type CommonPaymentRequiredErrorBody, type CommonSortDirection, type CommonUnauthorizedErrorBody, type CommonUuid, type ContextGetData, type ContextGetError, type ContextGetErrors, type ContextGetResponse, type ContextGetResponses, type CreateClientConfig, type DocsSearchSearchData, type DocsSearchSearchError, type DocsSearchSearchErrors, type DocsSearchSearchResponse, type DocsSearchSearchResponses, type ExecutionActivitiesGetData, type ExecutionActivitiesGetError, type ExecutionActivitiesGetErrors, type ExecutionActivitiesGetResponse, type ExecutionActivitiesGetResponses, type ExecutionAgentFileDownloadRedirectData, type ExecutionAgentFileDownloadRedirectError, type ExecutionAgentFileDownloadRedirectErrors, type ExecutionAgentFilesGetData, type ExecutionAgentFilesGetError, type ExecutionAgentFilesGetErrors, type ExecutionAgentFilesGetResponse, type ExecutionAgentFilesGetResponses, type ExecutionContextFileDownloadRedirectData, type ExecutionContextFileDownloadRedirectError, type ExecutionContextFileDownloadRedirectErrors, type ExecutionContextFilesGetData, type ExecutionContextFilesGetError, type ExecutionContextFilesGetErrors, type ExecutionContextFilesGetResponse, type ExecutionContextFilesGetResponses, type ExecutionContextFilesUploadData, type ExecutionContextFilesUploadError, type ExecutionContextFilesUploadErrors, type ExecutionContextFilesUploadResponse, type ExecutionContextFilesUploadResponses, type ExecutionDebugFileDownloadRedirectData, type ExecutionDebugFileDownloadRedirectError, type ExecutionDebugFileDownloadRedirectErrors, type ExecutionFileDownloadRedirectData, type ExecutionFileDownloadRedirectError, type ExecutionFileDownloadRedirectErrors, type ExecutionFilesGetData, type ExecutionFilesGetError, type ExecutionFilesGetErrors, type ExecutionFilesGetResponse, type ExecutionFilesGetResponses, type ExecutionGetData, type ExecutionGetError, type ExecutionGetErrors, type ExecutionGetResponse, type ExecutionGetResponses, type ExecutionRecordingRedirectData, type ExecutionRecordingRedirectError, type ExecutionRecordingRedirectErrors, type ExecutionStatusUpdateData, type ExecutionStatusUpdateError, type ExecutionStatusUpdateErrors, type ExecutionStatusUpdateResponse, type ExecutionStatusUpdateResponses, type ExecutionUserMessagesAddData, type ExecutionUserMessagesAddError, type ExecutionUserMessagesAddErrors, type ExecutionUserMessagesAddResponse, type ExecutionUserMessagesAddResponses, type ExecutionsListData, type ExecutionsListError, type ExecutionsListErrors, type ExecutionsListResponse, type ExecutionsListResponses, type Options, type SchemaValidationValidateData, type SchemaValidationValidateError, type SchemaValidationValidateErrors, type SchemaValidationValidateResponse, type SchemaValidationValidateResponses, type TempFilesStageData, type TempFilesStageError, type TempFilesStageErrors, type TempFilesStageResponse, type TempFilesStageResponses, type Version, adminCustomerActivityList, adminCustomerActivityNotableList, adminCustomerActivityWindowStatsList, agentByIdDelete, agentByIdUpdate, agentCreate, agentExecutePost, agentList, agentProfileClearBrowserCache, agentProfileDelete, agentProfileDuplicate, agentProfileGet, agentProfileGetInboxEmail, agentProfileGetInboxEmails, agentProfilePoolDelete, agentProfilePoolGet, agentProfilePoolMembersAdd, agentProfilePoolMembersList, agentProfilePoolMembersRemove, agentProfilePoolUpdate, agentProfilePoolsCreate, agentProfilePoolsList, agentProfileUpdate, agentProfilesCreate, agentProfilesList, agentSharedFileDownloadRedirect, agentSharedFilesDelete, agentSharedFilesDeleteAll, agentSharedFilesFreeze, agentSharedFilesGet, agentSharedFilesUpdate, agentSharedFilesUpload, agentWorkflowsCreate, agentWorkflowsDeleteWorkflow, agentWorkflowsExecute, agentWorkflowsGet, agentWorkflowsGetInputs, agentWorkflowsGetOutputSchemas, agentWorkflowsList, agentWorkflowsPublish, agentWorkflowsSyncExecution, availableToolsList, client, contextGet, docsSearchSearch, executionActivitiesGet, executionAgentFileDownloadRedirect, executionAgentFilesGet, executionContextFileDownloadRedirect, executionContextFilesGet, executionContextFilesUpload, executionDebugFileDownloadRedirect, executionFileDownloadRedirect, executionFilesGet, executionGet, executionRecordingRedirect, executionStatusUpdate, executionUserMessagesAdd, executionsList, schemaValidationValidate, tempFilesStage };
5801
+ export { type AdminCustomerActivityListData, type AdminCustomerActivityListError, type AdminCustomerActivityListErrors, type AdminCustomerActivityListResponse, type AdminCustomerActivityListResponses, type AdminCustomerActivityNotableListData, type AdminCustomerActivityNotableListError, type AdminCustomerActivityNotableListErrors, type AdminCustomerActivityNotableListResponse, type AdminCustomerActivityNotableListResponses, type AdminCustomerActivityWindowStatsListData, type AdminCustomerActivityWindowStatsListError, type AdminCustomerActivityWindowStatsListErrors, type AdminCustomerActivityWindowStatsListResponse, type AdminCustomerActivityWindowStatsListResponses, type AgentByIdDeleteData, type AgentByIdDeleteError, type AgentByIdDeleteErrors, type AgentByIdDeleteResponse, type AgentByIdDeleteResponses, type AgentByIdUpdateData, type AgentByIdUpdateError, type AgentByIdUpdateErrors, type AgentByIdUpdateResponses, type AgentCreateData, type AgentCreateError, type AgentCreateErrors, type AgentCreateResponse, type AgentCreateResponses, type AgentExecutePostData, type AgentExecutePostError, type AgentExecutePostErrors, type AgentExecutePostResponse, type AgentExecutePostResponses, type AgentListData, type AgentListError, type AgentListErrors, type AgentListResponse, type AgentListResponses, type AgentProfileClearBrowserCacheData, type AgentProfileClearBrowserCacheError, type AgentProfileClearBrowserCacheErrors, type AgentProfileClearBrowserCacheResponse, type AgentProfileClearBrowserCacheResponses, type AgentProfileDeleteData, type AgentProfileDeleteError, type AgentProfileDeleteErrors, type AgentProfileDeleteResponse, type AgentProfileDeleteResponses, type AgentProfileDuplicateData, type AgentProfileDuplicateError, type AgentProfileDuplicateErrors, type AgentProfileDuplicateResponse, type AgentProfileDuplicateResponses, type AgentProfileGetData, type AgentProfileGetError, type AgentProfileGetErrors, type AgentProfileGetInboxEmailData, type AgentProfileGetInboxEmailError, type AgentProfileGetInboxEmailErrors, type AgentProfileGetInboxEmailResponse, type AgentProfileGetInboxEmailResponses, type AgentProfileGetInboxEmailsData, type AgentProfileGetInboxEmailsError, type AgentProfileGetInboxEmailsErrors, type AgentProfileGetInboxEmailsResponse, type AgentProfileGetInboxEmailsResponses, type AgentProfileGetResponse, type AgentProfileGetResponses, type AgentProfilePoolDeleteData, type AgentProfilePoolDeleteError, type AgentProfilePoolDeleteErrors, type AgentProfilePoolDeleteResponse, type AgentProfilePoolDeleteResponses, type AgentProfilePoolGetData, type AgentProfilePoolGetError, type AgentProfilePoolGetErrors, type AgentProfilePoolGetResponse, type AgentProfilePoolGetResponses, type AgentProfilePoolMembersAddData, type AgentProfilePoolMembersAddError, type AgentProfilePoolMembersAddErrors, type AgentProfilePoolMembersAddResponse, type AgentProfilePoolMembersAddResponses, type AgentProfilePoolMembersListData, type AgentProfilePoolMembersListError, type AgentProfilePoolMembersListErrors, type AgentProfilePoolMembersListResponse, type AgentProfilePoolMembersListResponses, type AgentProfilePoolMembersRemoveData, type AgentProfilePoolMembersRemoveError, type AgentProfilePoolMembersRemoveErrors, type AgentProfilePoolMembersRemoveResponse, type AgentProfilePoolMembersRemoveResponses, type AgentProfilePoolUpdateData, type AgentProfilePoolUpdateError, type AgentProfilePoolUpdateErrors, type AgentProfilePoolUpdateResponse, type AgentProfilePoolUpdateResponses, type AgentProfilePoolsCreateData, type AgentProfilePoolsCreateError, type AgentProfilePoolsCreateErrors, type AgentProfilePoolsCreateResponse, type AgentProfilePoolsCreateResponses, type AgentProfilePoolsListData, type AgentProfilePoolsListError, type AgentProfilePoolsListErrors, type AgentProfilePoolsListResponse, type AgentProfilePoolsListResponses, type AgentProfileUpdateData, type AgentProfileUpdateError, type AgentProfileUpdateErrors, type AgentProfileUpdateResponse, type AgentProfileUpdateResponses, type AgentProfilesCreateData, type AgentProfilesCreateError, type AgentProfilesCreateErrors, type AgentProfilesCreateResponse, type AgentProfilesCreateResponses, type AgentProfilesListData, type AgentProfilesListError, type AgentProfilesListErrors, type AgentProfilesListResponse, type AgentProfilesListResponses, type AgentSharedFileDownloadRedirectData, type AgentSharedFileDownloadRedirectError, type AgentSharedFileDownloadRedirectErrors, type AgentSharedFilesDeleteAllData, type AgentSharedFilesDeleteAllError, type AgentSharedFilesDeleteAllErrors, type AgentSharedFilesDeleteAllResponse, type AgentSharedFilesDeleteAllResponses, type AgentSharedFilesDeleteData, type AgentSharedFilesDeleteError, type AgentSharedFilesDeleteErrors, type AgentSharedFilesDeleteResponse, type AgentSharedFilesDeleteResponses, type AgentSharedFilesFreezeData, type AgentSharedFilesFreezeError, type AgentSharedFilesFreezeErrors, type AgentSharedFilesFreezeResponse, type AgentSharedFilesFreezeResponses, type AgentSharedFilesGetData, type AgentSharedFilesGetError, type AgentSharedFilesGetErrors, type AgentSharedFilesGetResponse, type AgentSharedFilesGetResponses, type AgentSharedFilesUpdateData, type AgentSharedFilesUpdateError, type AgentSharedFilesUpdateErrors, type AgentSharedFilesUpdateResponse, type AgentSharedFilesUpdateResponses, type AgentSharedFilesUploadData, type AgentSharedFilesUploadError, type AgentSharedFilesUploadErrors, type AgentSharedFilesUploadResponse, type AgentSharedFilesUploadResponses, type AgentWorkflowsCreateData, type AgentWorkflowsCreateError, type AgentWorkflowsCreateErrors, type AgentWorkflowsCreateResponse, type AgentWorkflowsCreateResponses, type AgentWorkflowsDeleteWorkflowData, type AgentWorkflowsDeleteWorkflowError, type AgentWorkflowsDeleteWorkflowErrors, type AgentWorkflowsDeleteWorkflowResponse, type AgentWorkflowsDeleteWorkflowResponses, type AgentWorkflowsExecuteData, type AgentWorkflowsExecuteError, type AgentWorkflowsExecuteErrors, type AgentWorkflowsExecuteResponse, type AgentWorkflowsExecuteResponses, type AgentWorkflowsGetData, type AgentWorkflowsGetError, type AgentWorkflowsGetErrors, type AgentWorkflowsGetInputsData, type AgentWorkflowsGetInputsError, type AgentWorkflowsGetInputsErrors, type AgentWorkflowsGetInputsResponse, type AgentWorkflowsGetInputsResponses, type AgentWorkflowsGetOutputSchemasData, type AgentWorkflowsGetOutputSchemasError, type AgentWorkflowsGetOutputSchemasErrors, type AgentWorkflowsGetOutputSchemasResponse, type AgentWorkflowsGetOutputSchemasResponses, type AgentWorkflowsGetResponse, type AgentWorkflowsGetResponses, type AgentWorkflowsListData, type AgentWorkflowsListError, type AgentWorkflowsListErrors, type AgentWorkflowsListResponse, type AgentWorkflowsListResponses, type AgentWorkflowsPublishData, type AgentWorkflowsPublishError, type AgentWorkflowsPublishErrors, type AgentWorkflowsPublishResponse, type AgentWorkflowsPublishResponses, type AgentWorkflowsSyncExecutionData, type AgentWorkflowsSyncExecutionError, type AgentWorkflowsSyncExecutionErrors, type AgentWorkflowsSyncExecutionResponse, type AgentWorkflowsSyncExecutionResponses, type AgentsAgentAvailableTool, type AgentsAgentAvailableToolsResponse, type AgentsAgentBase, type AgentsAgentCreateRequest, type AgentsAgentCreateResponse, type AgentsAgentExecuteAgentRequest, type AgentsAgentExecuteAgentResponse, type AgentsAgentExecutionOptions, type AgentsAgentSearch, type AgentsAgentSortField, type AgentsAgentUpdateRequest, type AgentsContextUserContextResponse, type AgentsContextUserOrganization, type AgentsCustomerActivityCustomerActivityList, type AgentsCustomerActivityCustomerActivityRow, type AgentsCustomerActivityCustomerWindowStatsList, type AgentsCustomerActivityCustomerWindowStatsRow, type AgentsCustomerActivityNotableActivityKind, type AgentsCustomerActivityNotableActivityList, type AgentsCustomerActivityNotableActivityRow, type AgentsCustomerActivityOrgWindowStat, type AgentsCustomerActivityRiskLevel, type AgentsDocsSearchDocsRequest, type AgentsDocsSearchDocsResponse, type AgentsDocsSearchResult, type AgentsExecutionActionName, type AgentsExecutionActivity, type AgentsExecutionActivityActionCompletedInfo, type AgentsExecutionActivityActionCompletedPayload, type AgentsExecutionActivityActionFailedPayload, type AgentsExecutionActivityActionStartedInfo, type AgentsExecutionActivityActionStartedPayload, type AgentsExecutionActivityCompactionPerformedPayload, type AgentsExecutionActivityCompactionStartedPayload, type AgentsExecutionActivityDisplay, type AgentsExecutionActivityFileAddedPayload, type AgentsExecutionActivityGenericPayload, type AgentsExecutionActivityInputSchemaResolvedPayload, type AgentsExecutionActivityPayloadUnion, type AgentsExecutionActivityPlaywrightScriptGeneratedPayload, type AgentsExecutionActivityPresentationLevel, type AgentsExecutionActivityReasoningPayload, type AgentsExecutionActivityScriptVariablesSubstitutedPayload, type AgentsExecutionActivityStatusChangedPayload, type AgentsExecutionActivityStepCompletedPayload, type AgentsExecutionActivityStepStartedPayload, type AgentsExecutionActivityTodosUpdatedPayload, type AgentsExecutionActivityTransitionedNodePayload, type AgentsExecutionActivityUserMessageReceivedPayload, type AgentsExecutionActivityWorkflowUpdatedPayload, type AgentsExecutionAdvisorCompletedDetails, type AgentsExecutionAgentQueryContextCompletedDetails, type AgentsExecutionAgentQueryContextStartedDetails, type AgentsExecutionApiKeyRef, type AgentsExecutionApiTriggerContext, type AgentsExecutionAskUserQuestion, type AgentsExecutionAwaitingConfirmationPayload, type AgentsExecutionBrowserRunCodeCompletedDetails, type AgentsExecutionBrowserRunCodeStartedDetails, type AgentsExecutionCancelReason, type AgentsExecutionCancelledPayload, type AgentsExecutionComment, type AgentsExecutionCompletedPayload, type AgentsExecutionElementFileUploadCompletedDetails, type AgentsExecutionExecutionResult, type AgentsExecutionExtApiCallCompletedDetails, type AgentsExecutionExtGetMailCompletedDetails, type AgentsExecutionExtSendMailCompletedDetails, type AgentsExecutionExtSendMailStartedDetails, type AgentsExecutionFailedPayload, type AgentsExecutionFileListCompletedDetails, type AgentsExecutionFileReadCompletedDetails, type AgentsExecutionFileStageCompletedDetails, type AgentsExecutionHandoffPrepareCompletedDetails, type AgentsExecutionHandoffPrepareStartedDetails, type AgentsExecutionHandoffPrepareVariable, type AgentsExecutionHumanLabel, type AgentsExecutionListItem, type AgentsExecutionLlmCallPurpose, type AgentsExecutionLlmCallStartedDetails, type AgentsExecutionNavToCompletedDetails, type AgentsExecutionNavToStartedDetails, type AgentsExecutionNodeDetails, type AgentsExecutionNodeOutputItem, type AgentsExecutionObsSnapshotWithSelectorsCompletedDetails, type AgentsExecutionPausedPayload, type AgentsExecutionQuestionItem, type AgentsExecutionQuestionOption, type AgentsExecutionReadFileCompletedDetails, type AgentsExecutionReadFileStartedDetails, type AgentsExecutionRulesDetails, type AgentsExecutionScheduleRef, type AgentsExecutionScheduleTriggerContext, type AgentsExecutionScratchpadReadCompletedDetails, type AgentsExecutionScratchpadReadStartedDetails, type AgentsExecutionScratchpadWriteCompletedDetails, type AgentsExecutionScratchpadWriteStartedDetails, type AgentsExecutionScriptEvalCompletedDetails, type AgentsExecutionScriptEvalStartedDetails, type AgentsExecutionScriptFailure, type AgentsExecutionScriptHybridPlaywrightCompletedDetails, type AgentsExecutionScriptHybridPlaywrightStartedDetails, type AgentsExecutionScriptPadRunFunctionCompletedDetails, type AgentsExecutionScriptPlaywrightCompletedDetails, type AgentsExecutionScriptPlaywrightStartedDetails, type AgentsExecutionScriptpadReadCompletedDetails, type AgentsExecutionScriptpadReadStartedDetails, type AgentsExecutionScriptpadRunFunctionStartedDetails, type AgentsExecutionScriptpadSearchReplaceCompletedDetails, type AgentsExecutionScriptpadSearchReplaceStartedDetails, type AgentsExecutionScriptpadWriteCompletedDetails, type AgentsExecutionSdkBashCompletedDetails, type AgentsExecutionSdkBashStartedDetails, type AgentsExecutionSdkEditCompletedDetails, type AgentsExecutionSdkEditStartedDetails, type AgentsExecutionSdkGlobCompletedDetails, type AgentsExecutionSdkGlobStartedDetails, type AgentsExecutionSdkGrepCompletedDetails, type AgentsExecutionSdkGrepStartedDetails, type AgentsExecutionSdkReadCompletedDetails, type AgentsExecutionSdkReadStartedDetails, type AgentsExecutionSdkSkillCompletedDetails, type AgentsExecutionSdkSkillStartedDetails, type AgentsExecutionSdkWriteCompletedDetails, type AgentsExecutionSdkWriteStartedDetails, type AgentsExecutionSearchAgentId, type AgentsExecutionSearchAgentProfileIds, type AgentsExecutionSearchCreatedAfter, type AgentsExecutionSearchCreatedBefore, type AgentsExecutionSearchExecutionId, type AgentsExecutionSearchHasScriptFailures, type AgentsExecutionSearchHumanLabels, type AgentsExecutionSearchInputsKey, type AgentsExecutionSearchInputsValue, type AgentsExecutionSearchMetadataKey, type AgentsExecutionSearchMetadataValue, type AgentsExecutionSearchOutcomeLabel, type AgentsExecutionSearchStatus, type AgentsExecutionSearchWorkflowVersion, type AgentsExecutionSortField, type AgentsExecutionStatus, type AgentsExecutionTerminalPayload, type AgentsExecutionTodo, type AgentsExecutionTodoStatus, type AgentsExecutionTransitionDetails, type AgentsExecutionTriggerContext, type AgentsExecutionTriggerRunner, type AgentsExecutionUiTriggerContext, type AgentsExecutionUpdateExecutionStatusRequest, type AgentsExecutionUpdateType, type AgentsExecutionUpdateableStatus, type AgentsExecutionUserMessagesAddTextBody, type AgentsExecutionUtilGetDatetimeCompletedDetails, type AgentsExecutionUtilGetDatetimeStartedDetails, type AgentsExecutionWorkflowUpdate, type AgentsFilesAgentFile, type AgentsFilesAgentFileCreatedBy, type AgentsFilesAgentFileDirectory, type AgentsFilesAgentFilesDirectoryListing, type AgentsFilesAgentFilesResponse, type AgentsFilesFile, type AgentsFilesFilePart, type AgentsFilesSetFrozenRequest, type AgentsFilesSharedFile, type AgentsFilesSharedFileUploadResponse, type AgentsFilesSharedFilesResponse, type AgentsFilesTempFile, type AgentsFilesTempFilesResponse, type AgentsGraphModelsAgentGraph, type AgentsGraphModelsLlmProvider, type AgentsGraphModelsNodesNode, type AgentsGraphModelsNodesNodePropertiesUnion, type AgentsGraphModelsNodesNodeType, type AgentsGraphModelsNodesPosition, type AgentsGraphModelsNodesPropertiesApiMethod, type AgentsGraphModelsNodesPropertiesApiProperties, type AgentsGraphModelsNodesPropertiesIrisPlaywrightScriptProperties, type AgentsGraphModelsNodesPropertiesIrisProperties, type AgentsGraphModelsNodesPropertiesNodeCapabilities, type AgentsGraphModelsNodesPropertiesOutcomeString, type AgentsGraphModelsNodesPropertiesOutputProperties, type AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVar, type AgentsGraphModelsNodesPropertiesPlaywrightScriptLlmVarType, type AgentsGraphModelsNodesPropertiesPlaywrightScriptProperties, type AgentsGraphModelsNodesPropertiesStartProperties, type AgentsGraphModelsNodesPropertiesUrlProperties, type AgentsGraphModelsNodesSize, type AgentsGraphModelsSettings, type AgentsGraphModelsStickyNote, type AgentsGraphModelsTransitionsPropertiesIrisProperties, type AgentsGraphModelsTransitionsPropertiesOutcomeSuccessProperties, type AgentsGraphModelsTransitionsPropertiesSelectorProperties, type AgentsGraphModelsTransitionsTransition, type AgentsGraphModelsTransitionsTransitionPropertiesUnion, type AgentsGraphModelsTransitionsTransitionType, type AgentsGraphModelsTypeInputMethod, type AgentsProfileAddProfilesToPoolRequest, type AgentsProfileAgentProfile, type AgentsProfileAgentProfileInboxEmailsResponse, type AgentsProfileAgentProfilePool, type AgentsProfileAgentProfilePoolMember, type AgentsProfileCookie, type AgentsProfileCountryCode, type AgentsProfileCreateAgentProfilePoolRequest, type AgentsProfileCreateAgentProfileRequest, type AgentsProfileCredential, type AgentsProfileCredentialUpdate, type AgentsProfileCustomProxyConfigInput, type AgentsProfileCustomProxyConfigOutput, type AgentsProfileDuplicateAgentProfileRequest, type AgentsProfileOperatingSystem, type AgentsProfilePoolSearch, type AgentsProfilePoolSortField, type AgentsProfileProfileInboxEmail, type AgentsProfileProfileInboxEmailDetail, type AgentsProfileProxyMode, type AgentsProfileProxyType, type AgentsProfileRemoveProfilesFromPoolRequest, type AgentsProfileSameSite, type AgentsProfileSearch, type AgentsProfileSelectionStrategy, type AgentsProfileSortField, type AgentsProfileUpdateAgentProfilePoolRequest, type AgentsProfileUpdateAgentProfileRequest, type AgentsSchemaValidateSchemaRequest, type AgentsSchemaValidateSchemaResponse, type AgentsWorkflowBrowserProvider, type AgentsWorkflowBrowserTemplateConfig, type AgentsWorkflowCreateWorkflowRequest, type AgentsWorkflowCreateWorkflowResponse, type AgentsWorkflowEnvironmentTemplate, type AgentsWorkflowEnvironmentType, type AgentsWorkflowExecuteWorkflowRequest, type AgentsWorkflowExecuteWorkflowResponse, type AgentsWorkflowInput, type AgentsWorkflowOsProvider, type AgentsWorkflowOsTemplateConfig, type AgentsWorkflowOsType, type AgentsWorkflowPublishWorkflowResponse, type AgentsWorkflowSyncExecutionRequest, type AgentsWorkflowSyncExecutionResponse, type AgentsWorkflowWorkflowFile, type AgentsWorkflowWorkflowInputs, type AgentsWorkflowWorkflowOutputSchemas, type AgentsWorkflowWorkflowRef, type AgentsWorkflowWorkflowSnapshot, type AvailableToolsListData, type AvailableToolsListError, type AvailableToolsListErrors, type AvailableToolsListResponse, type AvailableToolsListResponses, type ClientOptions, type CommonBadRequestErrorBody, type CommonConflictErrorBody, type CommonError, type CommonForbiddenErrorBody, type CommonInternalServerErrorBody, type CommonNotFoundErrorBody, type CommonOsError, type CommonPaginationPage, type CommonPaginationPageSize, type CommonPaymentRequiredErrorBody, type CommonSortDirection, type CommonUnauthorizedErrorBody, type CommonUuid, type ContextGetData, type ContextGetError, type ContextGetErrors, type ContextGetResponse, type ContextGetResponses, type CreateClientConfig, type DocsSearchSearchData, type DocsSearchSearchError, type DocsSearchSearchErrors, type DocsSearchSearchResponse, type DocsSearchSearchResponses, type ExecutionActivitiesGetData, type ExecutionActivitiesGetError, type ExecutionActivitiesGetErrors, type ExecutionActivitiesGetResponse, type ExecutionActivitiesGetResponses, type ExecutionAgentFileDownloadRedirectData, type ExecutionAgentFileDownloadRedirectError, type ExecutionAgentFileDownloadRedirectErrors, type ExecutionAgentFilesGetData, type ExecutionAgentFilesGetError, type ExecutionAgentFilesGetErrors, type ExecutionAgentFilesGetResponse, type ExecutionAgentFilesGetResponses, type ExecutionContextFileDownloadRedirectData, type ExecutionContextFileDownloadRedirectError, type ExecutionContextFileDownloadRedirectErrors, type ExecutionContextFilesGetData, type ExecutionContextFilesGetError, type ExecutionContextFilesGetErrors, type ExecutionContextFilesGetResponse, type ExecutionContextFilesGetResponses, type ExecutionContextFilesUploadData, type ExecutionContextFilesUploadError, type ExecutionContextFilesUploadErrors, type ExecutionContextFilesUploadResponse, type ExecutionContextFilesUploadResponses, type ExecutionDebugFileDownloadRedirectData, type ExecutionDebugFileDownloadRedirectError, type ExecutionDebugFileDownloadRedirectErrors, type ExecutionFileDownloadRedirectData, type ExecutionFileDownloadRedirectError, type ExecutionFileDownloadRedirectErrors, type ExecutionFilesGetData, type ExecutionFilesGetError, type ExecutionFilesGetErrors, type ExecutionFilesGetResponse, type ExecutionFilesGetResponses, type ExecutionGetData, type ExecutionGetError, type ExecutionGetErrors, type ExecutionGetResponse, type ExecutionGetResponses, type ExecutionRecordingRedirectData, type ExecutionRecordingRedirectError, type ExecutionRecordingRedirectErrors, type ExecutionStatusUpdateData, type ExecutionStatusUpdateError, type ExecutionStatusUpdateErrors, type ExecutionStatusUpdateResponse, type ExecutionStatusUpdateResponses, type ExecutionUserMessagesAddData, type ExecutionUserMessagesAddError, type ExecutionUserMessagesAddErrors, type ExecutionUserMessagesAddResponse, type ExecutionUserMessagesAddResponses, type ExecutionsListData, type ExecutionsListError, type ExecutionsListErrors, type ExecutionsListResponse, type ExecutionsListResponses, type Options, type SchemaValidationValidateData, type SchemaValidationValidateError, type SchemaValidationValidateErrors, type SchemaValidationValidateResponse, type SchemaValidationValidateResponses, type TempFilesStageData, type TempFilesStageError, type TempFilesStageErrors, type TempFilesStageResponse, type TempFilesStageResponses, adminCustomerActivityList, adminCustomerActivityNotableList, adminCustomerActivityWindowStatsList, agentByIdDelete, agentByIdUpdate, agentCreate, agentExecutePost, agentList, agentProfileClearBrowserCache, agentProfileDelete, agentProfileDuplicate, agentProfileGet, agentProfileGetInboxEmail, agentProfileGetInboxEmails, agentProfilePoolDelete, agentProfilePoolGet, agentProfilePoolMembersAdd, agentProfilePoolMembersList, agentProfilePoolMembersRemove, agentProfilePoolUpdate, agentProfilePoolsCreate, agentProfilePoolsList, agentProfileUpdate, agentProfilesCreate, agentProfilesList, agentSharedFileDownloadRedirect, agentSharedFilesDelete, agentSharedFilesDeleteAll, agentSharedFilesFreeze, agentSharedFilesGet, agentSharedFilesUpdate, agentSharedFilesUpload, agentWorkflowsCreate, agentWorkflowsDeleteWorkflow, agentWorkflowsExecute, agentWorkflowsGet, agentWorkflowsGetInputs, agentWorkflowsGetOutputSchemas, agentWorkflowsList, agentWorkflowsPublish, agentWorkflowsSyncExecution, availableToolsList, client, contextGet, docsSearchSearch, executionActivitiesGet, executionAgentFileDownloadRedirect, executionAgentFilesGet, executionContextFileDownloadRedirect, executionContextFilesGet, executionContextFilesUpload, executionDebugFileDownloadRedirect, executionFileDownloadRedirect, executionFilesGet, executionGet, executionRecordingRedirect, executionStatusUpdate, executionUserMessagesAdd, executionsList, schemaValidationValidate, tempFilesStage };