asteroid-odyssey 1.8.174 → 1.8.176

package/dist/index.d.mts

@@ -433,9 +433,6 @@ type AgentsAgentExecuteAgentRequest = {
     onCapacityLimit?: AgentsAgentOnCapacityLimit;
 };
 type AgentsAgentExecuteAgentResponse = {
-    /**
-     * The ID of the newly created execution
-     */
     executionId: CommonUuid;
     /**
      * The execution's initial status: "starting" when it began immediately, "queued" when it
@@ -518,9 +515,6 @@ type AgentsAgentExecuteAgentSyncRequest = {
     timeoutSeconds?: number;
 };
 type AgentsAgentExecuteAgentSyncResponse = {
-    /**
-     * The ID of the newly created execution
-     */
     executionId: CommonUuid;
     /**
      * The execution's status when the call returned: terminal on 200, the current status on 202
@@ -617,46 +611,28 @@ type AgentsCustomEnvironmentActiveHours = {
      * IANA time zone the windows are evaluated in, such as Europe/London
      */
     timezone: string;
-    /**
-     * The windows
-     */
     windows: Array<AgentsCustomEnvironmentTimeWindow>;
 };
 /**
  * A cookie injected into every session of the environment
  */
 type AgentsCustomEnvironmentBrowserCookie = {
-    /**
-     * Display name for the cookie
-     */
     name: string;
     /**
      * The cookie key as sent in HTTP headers
      */
     key: string;
-    /**
-     * The cookie value
-     */
     value: string;
-    /**
-     * Domain the cookie applies to
-     */
     domain: string;
     /**
      * When the cookie expires. Absent means a session cookie.
      */
     expiry?: string;
-    /**
-     * Only send over HTTPS
-     */
     secure: boolean;
     /**
      * Hidden from page scripts
      */
     httpOnly: boolean;
-    /**
-     * SameSite policy
-     */
     sameSite: AgentsProfileSameSite;
 };
 /**
@@ -664,9 +640,6 @@ type AgentsCustomEnvironmentBrowserCookie = {
  */
 type AgentsCustomEnvironmentBrowserSettings = {
     type: "browser";
-    /**
-     * How the browser egresses
-     */
     proxy: AgentsCustomEnvironmentProxySettings;
     /**
      * Operating system the browser emulates
@@ -676,17 +649,11 @@ type AgentsCustomEnvironmentBrowserSettings = {
      * Extra anti-detection measures
      */
     extraStealth: boolean;
-    /**
-     * Allow third-party cookies
-     */
     allow3rdCookies: boolean;
     /**
      * Persist the browser cache between sessions
      */
     cachePersistence: boolean;
-    /**
-     * Block ads
-     */
     adblockActive: boolean;
     /**
      * Block popups. Requires adblock.
@@ -696,17 +663,8 @@ type AgentsCustomEnvironmentBrowserSettings = {
      * Open popups as tabs
      */
     forcePopupsAsTabsActive: boolean;
-    /**
-     * Block media downloads
-     */
     mediaBlockerActive: boolean;
-    /**
-     * Render PDFs in the browser
-     */
     pdfViewerActive: boolean;
-    /**
-     * Record the session trace
-     */
     tracingEnabled: boolean;
     /**
      * Extensions loaded into every session
@@ -721,13 +679,7 @@ type AgentsCustomEnvironmentBrowserSettings = {
  * A custom environment: a reusable environment definition — base machine, profile source, and optionally a warm pool that keeps initialised copies ready. Any member of the organisation may manage it. An OS base may name the organisation's own snapshots or public ones; only admins may name any other.
  */
 type AgentsCustomEnvironmentCustomEnvironment = {
-    /**
-     * Unique identifier for the custom environment
-     */
     id: CommonUuid;
-    /**
-     * Organisation the environment belongs to
-     */
     organizationId: CommonUuid;
     /**
      * Name, unique within the organisation
@@ -769,13 +721,7 @@ type AgentsCustomEnvironmentCustomEnvironment = {
      * Live environments the warm pool owns that no member points at: provisioned by a warmup that never registered them. Nothing reclaims one before its expiry. Resolved when the environment is read.
      */
     orphanedEnvironmentIds: Array<CommonUuid>;
-    /**
-     * Creation timestamp
-     */
     createdAt: string;
-    /**
-     * Last update timestamp
-     */
     updatedAt: string;
 };
 /**
@@ -787,9 +733,6 @@ type AgentsCustomEnvironmentCustomProxySettings = {
      * Proxy server address including protocol and port, such as socks5://proxy.example.com:1080
      */
     server: string;
-    /**
-     * Proxy authentication username
-     */
     username: string;
     /**
      * Proxy authentication password. Required on create; omit on update to keep the stored one.
@@ -800,31 +743,19 @@ type AgentsCustomEnvironmentCustomProxySettings = {
  * The machine a custom environment boots
  */
 type AgentsCustomEnvironmentEnvironmentBase = {
-    /**
-     * Type of environment (browser or os)
-     */
     type: AgentsWorkflowEnvironmentType;
-    /**
-     * Environment-specific configuration
-     */
     config: AgentsCustomEnvironmentEnvironmentBaseBrowserConfig | AgentsCustomEnvironmentEnvironmentBaseOsConfig;
 };
 /**
  * Browser base of a custom environment
  */
 type AgentsCustomEnvironmentEnvironmentBaseBrowserConfig = {
-    /**
-     * Browser provider type
-     */
     provider: AgentsWorkflowBrowserProvider;
 };
 /**
  * OS base of a custom environment: the workflow OS configuration plus the snapshot it boots
  */
 type AgentsCustomEnvironmentEnvironmentBaseOsConfig = {
-    /**
-     * OS provider type
-     */
     provider: AgentsWorkflowOsProvider;
     /**
      * Operating system the sandbox runs. Defaults to linux. Setting to windows is admin-only and selects the Windows snapshot/image.
@@ -854,9 +785,6 @@ type AgentsCustomEnvironmentEnvironmentSettings = ({
  */
 type AgentsCustomEnvironmentGatewayProxySettings = {
     mode: "gateway";
-    /**
-     * The proxy gateway preset
-     */
     proxyGatewayPresetId: CommonUuid;
 };
 /**
@@ -918,9 +846,6 @@ type AgentsCustomEnvironmentInitialization = {
  */
 type AgentsCustomEnvironmentLinuxSettings = {
     type: "linux";
-    /**
-     * How the sandbox egresses
-     */
     proxy: AgentsCustomEnvironmentSandboxProxySettings;
 };
 /**
@@ -970,9 +895,6 @@ type AgentsCustomEnvironmentProfilePoolSource = {
      * @deprecated
      */
     agentProfilePoolId?: CommonUuid;
-    /**
-     * The profile group
-     */
     profileGroupId: CommonUuid;
 };
 /**
@@ -1022,9 +944,6 @@ type AgentsCustomEnvironmentSandboxCustomProxySettings = {
      * SOCKS5 server address including port, such as socks5://proxy.example.com:1080
      */
     server: string;
-    /**
-     * Proxy authentication username
-     */
     username: string;
     /**
      * Proxy authentication password. Required on create; omit on update to keep the stored one.
@@ -1080,9 +999,6 @@ type AgentsCustomEnvironmentSingleProfileSource = {
      * @deprecated
      */
     agentProfileId?: CommonUuid;
-    /**
-     * The login profile
-     */
     profileId: CommonUuid;
 };
 /**
@@ -1095,9 +1011,6 @@ type AgentsCustomEnvironmentSingleUseReusePolicy = {
  * Hours on given days. A window never crosses midnight: express an overnight span as two windows.
  */
 type AgentsCustomEnvironmentTimeWindow = {
-    /**
-     * Days the window applies on
-     */
     days: Array<AgentsCustomEnvironmentWeekday>;
     /**
      * Start of the window as an ISO 8601 time of day (HH:MM:SS), inclusive
@@ -1133,9 +1046,6 @@ type AgentsCustomEnvironmentWarmCacheConfig = {
  * Warm cache login state of one profile
  */
 type AgentsCustomEnvironmentWarmCacheLogin = {
-    /**
-     * The profile
-     */
     profileId: CommonUuid;
     /**
      * When the profile last logged in successfully
@@ -1158,13 +1068,7 @@ type AgentsCustomEnvironmentWarmCacheLoginAttempt = {
      * The login execution. Absent until the run is dispatched, and when dispatch failed.
      */
     executionId?: CommonUuid;
-    /**
-     * The environment the login ran in
-     */
     environmentId: CommonUuid;
-    /**
-     * When the login started
-     */
     startedAt: string;
     /**
      * When the login failed or timed out. Absent while it runs.
@@ -1187,9 +1091,6 @@ type AgentsCustomEnvironmentWarmPoolConfig = {
      * Member max age in minutes, not a hard retirement time. The replacement boots ahead of it, by the pool's recent warmup time; the member stays claimable past it until the replacement is ready, for a grace of at most half the max age or 15 minutes.
      */
     maxAgeMins: number;
-    /**
-     * How long a pooled environment lives
-     */
     reuse: AgentsCustomEnvironmentReusePolicy;
     /**
      * Agent that initialises each member. Absent means a member is available as soon as it has booted.
@@ -1200,17 +1101,8 @@ type AgentsCustomEnvironmentWarmPoolConfig = {
  * A pre-warmed environment inside a warm pool
  */
 type AgentsCustomEnvironmentWarmPoolMember = {
-    /**
-     * The pooled environment
-     */
     environmentId: CommonUuid;
-    /**
-     * Lifecycle state of the member
-     */
     state: AgentsCustomEnvironmentWarmPoolMemberState;
-    /**
-     * Executions currently attached to the environment
-     */
     attachedExecutionIds: Array<CommonUuid>;
     /**
      * Deprecated: use profileId. Agent profile the member holds for its whole life.
@@ -1247,18 +1139,12 @@ type AgentsCustomEnvironmentWarmPoolSizeSchedule = {
      * IANA time zone the windows are evaluated in, such as Europe/London
      */
     timezone: string;
-    /**
-     * The windows
-     */
     windows: Array<AgentsCustomEnvironmentWarmPoolSizeWindow>;
 };
 /**
  * Hours on given days during which the pool holds a different target size
  */
 type AgentsCustomEnvironmentWarmPoolSizeWindow = {
-    /**
-     * Days the window applies on
-     */
     days: Array<AgentsCustomEnvironmentWeekday>;
     /**
      * Start of the window as an ISO 8601 time of day (HH:MM:SS), inclusive
@@ -1282,9 +1168,6 @@ type AgentsCustomEnvironmentWeekday = "mon" | "tue" | "wed" | "thu" | "fri" | "s
  */
 type AgentsCustomEnvironmentWindowsSettings = {
     type: "windows";
-    /**
-     * How the sandbox egresses
-     */
     proxy: AgentsCustomEnvironmentSandboxProxySettings;
 };
 /**
@@ -1382,9 +1265,6 @@ type AgentsCustomerActivityNotableActivityRow = {
      * Organisation ID (usersdb organisation UUID).
      */
     organisationId: CommonUuid;
-    /**
-     * Which event was tripped.
-     */
     kind: AgentsCustomerActivityNotableActivityKind;
     /**
      * When the event occurred (for friction: the most recent qualifying run).
@@ -1420,22 +1300,13 @@ type AgentsCustomerActivityRiskLevel = "red" | "amber" | "green";
  * Request to search Asteroid documentation
  */
 type AgentsDocsSearchDocsRequest = {
-    /**
-     * Search query to find relevant documentation
-     */
     query: string;
-    /**
-     * Content format
-     */
     format?: AgentsDocsSearchDocsReturnFormat;
 };
 /**
  * Response containing documentation search results
  */
 type AgentsDocsSearchDocsResponse = {
-    /**
-     * Search results matching the query
-     */
     results: Array<AgentsDocsSearchResult>;
 };
 /**
@@ -1446,17 +1317,8 @@ type AgentsDocsSearchDocsReturnFormat = "mdx" | "text";
  * A single documentation search result
  */
 type AgentsDocsSearchResult = {
-    /**
-     * Result title
-     */
     title: string;
-    /**
-     * Result content/snippet
-     */
     content: string;
-    /**
-     * Source URL
-     */
     url?: string;
 };
 /**
@@ -1474,30 +1336,15 @@ type AgentsEnvironmentAstroEnvironmentOwner = {
      * The workflow the conversation is building.
      */
     workflowId: CommonUuid;
-    /**
-     * The astro chat that booted the environment.
-     */
     chatId: CommonUuid;
 };
 /**
  * A single environment: what it is, its provider state, and how to drive it. `state` is the same shape the execution endpoint returns, so the LiveView/OsLiveView components render either without branching.
  */
 type AgentsEnvironmentEnvironment = {
-    /**
-     * Environment identifier.
-     */
     id: CommonUuid;
-    /**
-     * The organisation the environment belongs to.
-     */
     organizationId: CommonUuid;
-    /**
-     * Who the environment belongs to, and the identity that owner carries.
-     */
     owner: AgentsEnvironmentEnvironmentOwner;
-    /**
-     * Browser or OS.
-     */
     environmentType: AgentsWorkflowEnvironmentType;
     /**
      * Operating system for OS environments. Absent for browser environments; linux when an OS environment predates explicit osType storage.
@@ -1521,9 +1368,6 @@ type AgentsEnvironmentEnvironment = {
      * Whether a playable recording has been persisted (GCS object or provider URL). The playable URL itself is minted on the by-id read.
      */
     hasRecording: boolean;
-    /**
-     * When the environment row was created.
-     */
     createdAt: string;
     /**
      * When the environment first became ready, if it reached that state.
@@ -1541,9 +1385,6 @@ type AgentsEnvironmentEnvironment = {
      * Environment state (browser or OS): live-view URL, viewport, provider config and a freshly-minted recording URL when one exists.
      */
     state: AgentsExecutionEnvironmentState;
-    /**
-     * How to connect to it.
-     */
     connection: AgentsEnvironmentEnvironmentConnection;
 };
 /**
@@ -1589,21 +1430,9 @@ type AgentsEnvironmentEnvironmentStatus = "requested" | "provisioning" | "ready"
  * An environment as it appears in a list. Carries everything a row needs; the provider `state` is fetched with the environment itself, because resolving it mints a signed recording URL per environment and a list would mint one per row.
  */
 type AgentsEnvironmentEnvironmentSummary = {
-    /**
-     * Environment identifier.
-     */
     id: CommonUuid;
-    /**
-     * The organisation the environment belongs to.
-     */
     organizationId: CommonUuid;
-    /**
-     * Who the environment belongs to, and the identity that owner carries.
-     */
     owner: AgentsEnvironmentEnvironmentOwner;
-    /**
-     * Browser or OS.
-     */
     environmentType: AgentsWorkflowEnvironmentType;
     /**
      * Operating system for OS environments. Absent for browser environments; linux when an OS environment predates explicit osType storage.
@@ -1627,9 +1456,6 @@ type AgentsEnvironmentEnvironmentSummary = {
      * Whether a playable recording has been persisted (GCS object or provider URL). The playable URL itself is minted on the by-id read.
      */
     hasRecording: boolean;
-    /**
-     * When the environment row was created.
-     */
     createdAt: string;
     /**
      * When the environment first became ready, if it reached that state.
@@ -1655,13 +1481,7 @@ type AgentsEnvironmentExecutionEnvironmentOwner = {
      * @deprecated
      */
     agentId: CommonUuid;
-    /**
-     * The workflow the execution runs.
-     */
     workflowId: CommonUuid;
-    /**
-     * The execution that booted the environment.
-     */
     executionId: CommonUuid;
 };
 /**
@@ -1697,9 +1517,6 @@ type AgentsEnvironmentExternalEnvironmentOwner = {
      * @deprecated
      */
     agentId: CommonUuid;
-    /**
-     * The workflow the environment is bound to.
-     */
     workflowId: CommonUuid;
     /**
      * The API key that booted it, when one did. Absent for environments booted by a signed-in user.
@@ -1710,9 +1527,6 @@ type AgentsEnvironmentExternalEnvironmentOwner = {
  * Response for the list endpoint, ordered by createdAt DESC. Empty array when nothing matches the filters.
  */
 type AgentsEnvironmentListEnvironmentsResponse = {
-    /**
-     * The matching environments.
-     */
     environments: Array<AgentsEnvironmentEnvironmentSummary>;
 };
 /**
@@ -1799,9 +1613,6 @@ type AgentsEnvironmentStartEnvironmentRequest = {
  */
 type AgentsEnvironmentWarmPoolEnvironmentOwner = {
     type: "warm_pool";
-    /**
-     * The warm pool the environment belongs to.
-     */
     warmPoolId: CommonUuid;
 };
 /**
@@ -1818,26 +1629,14 @@ type AgentsEnvironmentWorkflowEnvironmentSource = {
  * API key reference used for authentication
  */
 type AgentsExecutionApiKeyRef = {
-    /**
-     * API key ID
-     */
     id: CommonUuid;
-    /**
-     * API key name
-     */
     name: string;
 };
 /**
  * API-triggered execution context
  */
 type AgentsExecutionApiTriggerContext = {
-    /**
-     * Trigger source discriminator
-     */
     source: "api";
-    /**
-     * Runner information
-     */
     runner: AgentsExecutionTriggerRunner;
     /**
      * Who started the execution. For an org key, read this and not `runner`: an org key has no user.
@@ -2166,17 +1965,8 @@ type AgentsExecutionAgentQueryContextStartedDetails = {
  * Anchor browser provider configuration
  */
 type AgentsExecutionAnchorProviderConfig = {
-    /**
-     * Provider type discriminator
-     */
     type: "anchor";
-    /**
-     * Anchor session ID
-     */
     sessionId?: CommonUuid;
-    /**
-     * Anchor session URL
-     */
     sessionUrl?: string;
 };
 type AgentsExecutionAskUserQuestion = {
@@ -2204,21 +1994,12 @@ type AgentsExecutionBrowserRunCodeStartedDetails = {
  * Browser environment state
  */
 type AgentsExecutionBrowserState = {
-    /**
-     * Environment type discriminator
-     */
     environmentType: "browser";
     /**
      * Browser provider name as stored on the environment. `anchor` for every environment this build can boot; an environment created by a provider that has since been removed reports that provider's name.
      */
     provider: string;
-    /**
-     * Browser viewport width
-     */
     width: number;
-    /**
-     * Browser viewport height
-     */
     height: number;
     /**
      * Live view/debugger URL
@@ -2240,9 +2021,6 @@ type AgentsExecutionBrowserState = {
      * Browser's public IP address (detected at startup)
      */
     browserIp?: string;
-    /**
-     * Provider-specific configuration
-     */
     providerConfig?: AgentsExecutionBrowserProviderConfig;
 };
 type AgentsExecutionCancelReason = "timeout" | "max_steps" | "user_requested" | "script_failed" | "no_activity" | "budget_exceeded" | "no_warm_environment";
@@ -2253,33 +2031,15 @@ type AgentsExecutionCancelledPayload = {
  * User comment on an execution
  */
 type AgentsExecutionComment = {
-    /**
-     * Unique identifier for the comment
-     */
     id: CommonUuid;
-    /**
-     * Execution this comment belongs to
-     */
     executionId: CommonUuid;
     /**
      * User who created the comment
      */
     userId: CommonUuid;
-    /**
-     * Comment content
-     */
     content: string;
-    /**
-     * Whether the comment is public
-     */
     public: boolean;
-    /**
-     * When the comment was created
-     */
     createdAt: string;
-    /**
-     * When the comment was last updated
-     */
     updatedAt?: string;
 };
 type AgentsExecutionCompletedPayload = {
@@ -2291,13 +2051,7 @@ type AgentsExecutionCompletedPayload = {
  * Daytona OS provider configuration
  */
 type AgentsExecutionDaytonaProviderConfig = {
-    /**
-     * Daytona sandbox ID
-     */
     sandboxId?: string;
-    /**
-     * Sandbox URL
-     */
     sandboxUrl?: string;
 };
 type AgentsExecutionElementFileUploadCompletedDetails = {
@@ -2309,9 +2063,6 @@ type AgentsExecutionElementFileUploadCompletedDetails = {
  */
 type AgentsExecutionEnvironmentState = AgentsExecutionBrowserState | AgentsExecutionOsState;
 type AgentsExecutionExecutionAggregates = {
-    /**
-     * Counts grouped by execution status
-     */
     status_counts: AgentsExecutionStatusCounts;
     /**
      * Top outcome labels and their counts
@@ -2328,42 +2079,21 @@ type AgentsExecutionExecutionOutcomeCounts = {
  * Execution result containing outcome, reasoning, and result data
  */
 type AgentsExecutionExecutionResult = {
-    /**
-     * Unique identifier for the result
-     */
     id: CommonUuid;
-    /**
-     * Execution this result belongs to
-     */
     executionId: CommonUuid;
     /**
      * Outcome of the execution (success or failure)
      */
     outcome: string;
-    /**
-     * AI reasoning for the outcome
-     */
     reasoning: string;
-    /**
-     * Result data as JSON
-     */
     result: unknown;
-    /**
-     * When the result was created
-     */
     createdAt: string;
 };
 /**
  * The status an execution was moved to
  */
 type AgentsExecutionExecutionStatusChange = {
-    /**
-     * The unique identifier of the execution
-     */
     executionId: CommonUuid;
-    /**
-     * The status the execution now has
-     */
     status: AgentsExecutionUpdateableStatus;
 };
 type AgentsExecutionExtApiCallCompletedDetails = {
@@ -2427,25 +2157,13 @@ type AgentsExecutionHandoffPrepareVariable = {
  * Human-applied label for categorizing executions
  */
 type AgentsExecutionHumanLabel = {
-    /**
-     * Unique identifier for the label
-     */
     id: CommonUuid;
-    /**
-     * Organization this label belongs to
-     */
     organizationId: CommonUuid;
-    /**
-     * Display name of the label
-     */
     name: string;
     /**
      * Hex color code for the label (e.g., #FF5733)
      */
     color: string;
-    /**
-     * When the label was created
-     */
     createdAt: string;
 };
 type AgentsExecutionInputResolutionSource = "workflow_input" | "node_output" | "llm";
@@ -2458,9 +2176,6 @@ type AgentsExecutionLlmCallStartedDetails = {
  * Represents a single execution in a list view
  */
 type AgentsExecutionListItem = {
-    /**
-     * The unique identifier of the execution
-     */
     id: CommonUuid;
     /**
      * Deprecated: use workflowId. The ID of the workflow that was executed
@@ -2468,33 +2183,15 @@ type AgentsExecutionListItem = {
      * @deprecated
      */
     agentId: CommonUuid;
-    /**
-     * The ID of the workflow that was executed
-     */
     workflowId: CommonUuid;
-    /**
-     * The ID of the workflow version that was executed
-     */
     workflowVersionId: CommonUuid;
-    /**
-     * The current status of the execution
-     */
     status: AgentsExecutionStatus;
-    /**
-     * When the execution was created
-     */
     createdAt: string;
     /**
      * When the execution actually started running; absent while queued. createdAt means "enqueued at" for executions that waited in the queue.
      */
     startedAt?: string;
-    /**
-     * When the execution reached a terminal state (if applicable)
-     */
     terminalAt?: string;
-    /**
-     * The organization this execution belongs to
-     */
     organizationId: CommonUuid;
     /**
      * Deprecated: use workflowName. The workflow display name
@@ -2502,9 +2199,6 @@ type AgentsExecutionListItem = {
      * @deprecated
      */
     agentName: string;
-    /**
-     * The workflow display name
-     */
     workflowName: string;
     /**
      * Deprecated: use profileName. The name of the agent profile used for this execution (if any)
@@ -2518,39 +2212,18 @@ type AgentsExecutionListItem = {
      * @deprecated
      */
     agentProfileId?: CommonUuid;
-    /**
-     * The name of the login profile used for this execution (if any)
-     */
     profileName?: string;
-    /**
-     * The ID of the login profile used for this execution (if any)
-     */
     profileId?: CommonUuid;
-    /**
-     * Input variables used for this execution
-     */
     inputs?: {
         [key: string]: unknown;
     };
-    /**
-     * Execution result with outcome, reasoning, and result data
-     */
     executionResult?: AgentsExecutionExecutionResult;
     /**
      * Execution duration in seconds (only present for terminal executions)
      */
     duration?: number;
-    /**
-     * Human-applied labels for this execution
-     */
     humanLabels: Array<AgentsExecutionHumanLabel>;
-    /**
-     * Comments on this execution
-     */
     comments: Array<AgentsExecutionComment>;
-    /**
-     * Optional metadata key-value pairs attached to this execution
-     */
     metadata?: {
         [key: string]: unknown;
     };
@@ -2586,9 +2259,6 @@ type AgentsExecutionListItem = {
      * Per-execution runtime options (e.g. variant key)
      */
     executionOptions?: AgentsAgentExecutionOptions;
-    /**
-     * Whether this execution has been rerun at least once
-     */
     hasBeenRerun: boolean;
     /**
      * ID of the execution this was rerun from, if applicable
@@ -2615,13 +2285,7 @@ type AgentsExecutionNavToStartedDetails = {
  * A single output variable with a name and value
  */
 type AgentsExecutionNodeOutputItem = {
-    /**
-     * The name of the output variable
-     */
     name: string;
-    /**
-     * The value of the output variable
-     */
     value: string;
 };
 type AgentsExecutionObsSnapshotWithSelectorsCompletedDetails = {
@@ -2633,29 +2297,11 @@ type AgentsExecutionObsSnapshotWithSelectorsCompletedDetails = {
  * OS environment state
  */
 type AgentsExecutionOsState = {
-    /**
-     * Environment type discriminator
-     */
     environmentType: "os";
-    /**
-     * OS provider name
-     */
     provider: AgentsWorkflowOsProvider;
-    /**
-     * Screen width
-     */
     width: number;
-    /**
-     * Screen height
-     */
     height: number;
-    /**
-     * Live view URL
-     */
     liveViewUrl?: string;
-    /**
-     * Recording URL
-     */
     recordingUrl?: string;
     /**
      * Whether a recording exists (provider URL or durable GCS object persisted). Use this to gate the player rather than recordingUrl, which is empty for GCS-only recordings.
@@ -2669,15 +2315,9 @@ type AgentsExecutionOsState = {
      * Environment's public egress IP address (detected at startup)
      */
     egressIp?: string;
-    /**
-     * Provider-specific configuration
-     */
     providerConfig?: AgentsExecutionDaytonaProviderConfig;
 };
 type AgentsExecutionOutcomeCount = {
-    /**
-     * The outcome label as set on the execution result
-     */
     label: string;
     /**
      * Number of executions with this outcome (within the requested filter)
@@ -2737,9 +2377,6 @@ type AgentsExecutionRerunExecutionRequest = {
  * Schedule reference for schedule-triggered executions
  */
 type AgentsExecutionScheduleRef = {
-    /**
-     * Schedule ID
-     */
     id: CommonUuid;
     /**
      * Cron expression of the schedule
@@ -2750,13 +2387,7 @@ type AgentsExecutionScheduleRef = {
  * Schedule-triggered execution context
  */
 type AgentsExecutionScheduleTriggerContext = {
-    /**
-     * Trigger source discriminator
-     */
     source: "schedule";
-    /**
-     * Schedule that triggered the execution
-     */
     schedule: AgentsExecutionScheduleRef;
 };
 type AgentsExecutionScratchpadReadCompletedDetails = {
@@ -2794,21 +2425,12 @@ type AgentsExecutionScriptEvalStartedDetails = {
  * A single failed run of a scripted iris node's script
  */
 type AgentsExecutionScriptFailure = {
-    /**
-     * ID of the node whose script failed
-     */
     nodeId?: string;
-    /**
-     * Display name of the node whose script failed
-     */
     nodeName?: string;
     /**
      * Relative path of the script file that failed
      */
     scriptFilepath?: string;
-    /**
-     * Error message reported by the failed script
-     */
     error?: string;
     /**
      * 1-based line number where the script failed, if known
@@ -2822,9 +2444,6 @@ type AgentsExecutionScriptFailure = {
      * Identifier correlating this failure to its activity event
      */
     actionId?: string;
-    /**
-     * When the failure occurred
-     */
     occurredAt: string;
 };
 type AgentsExecutionScriptHybridPlaywrightCompletedDetails = {
@@ -3005,13 +2624,7 @@ type AgentsExecutionTriggerContext = ({
  * Runner information - who triggered the execution
  */
 type AgentsExecutionTriggerRunner = {
-    /**
-     * User ID of the runner
-     */
     userId: CommonUuid;
-    /**
-     * Email of the runner
-     */
     email: string;
     /**
      * Whether the user is an admin (may be hidden for privacy)
@@ -3022,13 +2635,7 @@ type AgentsExecutionTriggerRunner = {
  * UI-triggered execution context
  */
 type AgentsExecutionUiTriggerContext = {
-    /**
-     * Trigger source discriminator
-     */
     source: "ui";
-    /**
-     * Runner information
-     */
     runner: AgentsExecutionTriggerRunner;
     /**
      * Who started the execution.
@@ -3036,9 +2643,6 @@ type AgentsExecutionUiTriggerContext = {
     actor?: CommonActor;
 };
 type AgentsExecutionUpdateExecutionStatusRequest = {
-    /**
-     * The new status to set for the execution
-     */
     status: AgentsExecutionUpdateableStatus;
 };
 /**
@@ -3046,6 +2650,9 @@ type AgentsExecutionUpdateExecutionStatusRequest = {
  */
 type AgentsExecutionUpdateableStatus = "running" | "paused" | "cancelled";
 type AgentsExecutionUserMessagesAddTextBody = {
+    /**
+     * The message the agent receives.
+     */
     message: string;
 };
 type AgentsExecutionUtilGetDatetimeCompletedDetails = {
@@ -3062,9 +2669,6 @@ type AgentsExecutionUtilGetDatetimeStartedDetails = {
  * Warmup-triggered execution context: launched by a warm pool's replenisher
  */
 type AgentsExecutionWarmupTriggerContext = {
-    /**
-     * Trigger source discriminator
-     */
     source: "warmup";
     /**
      * Warm pool whose replenisher launched the execution
@@ -3075,9 +2679,6 @@ type AgentsExecutionWarmupTriggerContext = {
  * Execution batch with status counts
  */
 type AgentsExecutionBatchBase = {
-    /**
-     * Unique identifier for the batch
-     */
     id: CommonUuid;
     /**
      * Deprecated: use workflowId. Workflow ID this batch belongs to
@@ -3085,21 +2686,12 @@ type AgentsExecutionBatchBase = {
      * @deprecated
      */
     agentId: CommonUuid;
-    /**
-     * Workflow ID this batch belongs to
-     */
     workflowId: CommonUuid;
-    /**
-     * Human-readable name for the batch
-     */
     name: string;
     /**
      * When to start triggering executions
      */
     startAt: string;
-    /**
-     * Batch configuration
-     */
     config: AgentsExecutionBatchBatchConfig;
     /**
      * Batches sharing a group share one concurrency budget rather than each getting
@@ -3107,41 +2699,17 @@ type AgentsExecutionBatchBase = {
      * carries the id of the schedule that produced it.
      */
     concurrencyGroupId: CommonUuid;
-    /**
-     * Current batch status
-     */
     status: AgentsExecutionBatchStatus;
-    /**
-     * Number of pending items
-     */
     pendingCount: number;
-    /**
-     * Number of triggered items
-     */
     triggeredCount: number;
-    /**
-     * Number of cancelled items
-     */
     cancelledCount: number;
-    /**
-     * Number of items awaiting capacity
-     */
     awaitingCapacityCount: number;
     /**
      * Number of items that could not be triggered and will not be retried
      */
     failedCount: number;
-    /**
-     * Total number of items
-     */
     totalCount: number;
-    /**
-     * Creation timestamp
-     */
     createdAt: string;
-    /**
-     * Last update timestamp
-     */
     updatedAt: string;
 };
 /**
@@ -3160,9 +2728,6 @@ type AgentsExecutionBatchBatchItem = {
      * The workflow to execute. Its published version runs unless workflowVersionId is set. A workflow version ID is still accepted here and runs that version (deprecated). Defaults to the batch's workflow.
      */
     workflowId?: CommonUuid;
-    /**
-     * The workflow version to execute
-     */
     workflowVersionId?: CommonUuid;
     /**
      * Deprecated: use profileId. Optional agent profile to use.
@@ -3198,9 +2763,6 @@ type AgentsExecutionBatchBatchItem = {
     inputs?: {
         [key: string]: unknown;
     };
-    /**
-     * Metadata for the execution
-     */
     metadata?: {
         [key: string]: unknown;
     };
@@ -3223,34 +2785,19 @@ type AgentsExecutionBatchCreateRequest = {
      * Workflow ID for this batch. Set this or agentId.
      */
     workflowId?: CommonUuid;
-    /**
-     * Human-readable name for the batch
-     */
     name: string;
     /**
      * When to start triggering executions
      */
     startAt: string;
-    /**
-     * Batch configuration
-     */
     config: AgentsExecutionBatchBatchConfig;
-    /**
-     * Items to execute in this batch
-     */
     items: Array<AgentsExecutionBatchBatchItem>;
 };
 /**
  * Max concurrent execution configuration
  */
 type AgentsExecutionBatchMaxConcurrentConfig = {
-    /**
-     * Config type discriminator
-     */
     type: "maxConcurrent";
-    /**
-     * Maximum number of executions running at the same time
-     */
     maxConcurrent: number;
 };
 /**
@@ -3261,9 +2808,6 @@ type AgentsExecutionBatchStatus = "pending" | "running" | "paused" | "completed"
  * Time-based batching configuration
  */
 type AgentsExecutionBatchTimeBatchingConfig = {
-    /**
-     * Config type discriminator
-     */
     type: "timeBatching";
     /**
      * Maximum number of executions to trigger in each batch
@@ -3651,25 +3195,16 @@ type AgentsInsightUpdateInsightRequest = {
  * Metadata about a language model
  */
 type AgentsModelsModelMetadata = {
-    /**
-     * Unique identifier (UUID)
-     */
     id: CommonUuid;
     /**
      * Model slug (e.g., 'asteroid-fast')
      */
     slug: string;
-    /**
-     * Display name for the model
-     */
     displayName: string;
     /**
      * Detailed description of the model's characteristics and use cases
      */
     description: string;
-    /**
-     * Model supports computer use
-     */
     supportsComputerUse: boolean;
     /**
      * The provider. Absent for Asteroid aliases, which resolve to a concrete model at runtime.
@@ -3684,43 +3219,28 @@ type AgentsModelsModelProvider = "openai" | "anthropic" | "google";
  * Response containing all available models
  */
 type AgentsModelsModelsResponse = {
-    /**
-     * List of all available models
-     */
     models: Array<AgentsModelsModelMetadata>;
 };
 /**
  * Request to add profiles to a pool
  */
 type AgentsProfileAddProfilesToPoolRequest = {
-    /**
-     * Profile IDs to add to the pool
-     */
     profileIds: Array<CommonUuid>;
 };
 /**
  * An agent profile containing browser configuration and credentials
  */
 type AgentsProfileAgentProfile = {
-    /**
-     * Unique identifier for the agent profile
-     */
     id: CommonUuid;
     /**
      * Name of the agent profile (unique within organization)
      */
     name: string;
-    /**
-     * Description of the agent profile
-     */
     description: string;
     /**
      * The ID of the organization that owns this profile
      */
     organizationId: CommonUuid;
-    /**
-     * Proxy configuration mode
-     */
     proxyMode: AgentsProfileProxyMode;
     /**
      * Country code for proxy location (for managed proxy mode)
@@ -3746,13 +3266,7 @@ type AgentsProfileAgentProfile = {
      * Whether to use the same IP address for all executions (managed proxy only)
      */
     stickyIP: boolean;
-    /**
-     * Operating system to emulate
-     */
     operatingSystem?: AgentsProfileOperatingSystem;
-    /**
-     * Whether extra stealth mode is enabled
-     */
     extraStealth: boolean;
     /**
      * Whether to allow third-party cookies
@@ -3762,9 +3276,6 @@ type AgentsProfileAgentProfile = {
      * Whether to persist browser cache between sessions
      */
     cachePersistence: boolean;
-    /**
-     * Whether to enable ad blocking
-     */
     adblockActive: boolean;
     /**
      * Whether to enable popup blocking (requires adblock to be active)
@@ -3812,30 +3323,15 @@ type AgentsProfileAgentProfile = {
      * @deprecated
      */
     credentials: Array<AgentsProfileCredential>;
-    /**
-     * List of cookies associated with this profile
-     */
     cookies: Array<AgentsProfileCookie>;
-    /**
-     * When the profile was created
-     */
     createdAt: string;
-    /**
-     * When the profile was last updated
-     */
     updatedAt: string;
 };
 /**
  * Response for listing the emails in an agent profile's inbox
  */
 type AgentsProfileAgentProfileInboxEmailsResponse = {
-    /**
-     * Emails addressed to this profile's inbox
-     */
     emails: Array<AgentsProfileProfileInboxEmail>;
-    /**
-     * Number of emails returned
-     */
     emailCount: number;
     /**
      * Whether Resend has more emails beyond this page
@@ -3846,9 +3342,6 @@ type AgentsProfileAgentProfileInboxEmailsResponse = {
  * A pool of agent profiles that can be used for credential rotation
  */
 type AgentsProfileAgentProfilePool = {
-    /**
-     * Unique identifier for the agent profile pool
-     */
     id: CommonUuid;
     /**
      * Name of the agent profile pool (unique within organization)
@@ -3858,46 +3351,25 @@ type AgentsProfileAgentProfilePool = {
      * The ID of the organization that owns this pool
      */
     organizationId: CommonUuid;
-    /**
-     * Strategy for selecting an available profile from the pool
-     */
     selectionStrategy: AgentsProfileSelectionStrategy;
     /**
      * Whether multiple executions can use the same profile concurrently
      */
     allowConcurrentUse: boolean;
-    /**
-     * When the pool was created
-     */
     createdAt: string;
-    /**
-     * When the pool was last updated
-     */
     updatedAt: string;
 };
 /**
  * An agent profile that is a member of a pool
  */
 type AgentsProfileAgentProfilePoolMember = {
-    /**
-     * Unique identifier for the agent profile
-     */
     id: CommonUuid;
-    /**
-     * Name of the agent profile
-     */
     name: string;
     /**
      * The ID of the organization that owns this profile
      */
     organizationId: CommonUuid;
-    /**
-     * When the profile was created
-     */
     createdAt: string;
-    /**
-     * When the profile was last updated
-     */
     updatedAt: string;
 };
 /**
@@ -3929,45 +3401,24 @@ type AgentsProfileAgentProfileVaultItemRef = {
  * A browser cookie stored for an agent profile
  */
 type AgentsProfileCookie = {
-    /**
-     * Unique identifier for the cookie
-     */
     id?: CommonUuid;
-    /**
-     * Display name for the cookie
-     */
     name: string;
     /**
      * The cookie key/name as sent in HTTP headers
      */
     key: string;
-    /**
-     * The cookie value
-     */
     value: string;
-    /**
-     * When the cookie expires (optional)
-     */
     expiry?: string;
-    /**
-     * The domain for which the cookie is valid
-     */
     domain: string;
     /**
      * Whether the cookie should only be sent over HTTPS
      */
     secure: boolean;
-    /**
-     * SameSite attribute for the cookie
-     */
     sameSite: AgentsProfileSameSite;
     /**
      * Whether the cookie should be accessible only via HTTP(S)
      */
     httpOnly: boolean;
-    /**
-     * When the cookie was created
-     */
     createdAt?: string;
 };
 /**
@@ -3986,9 +3437,6 @@ type AgentsProfileCreateAgentProfilePoolRequest = {
      * The ID of the organization that the pool belongs to. Defaults to the one organization the caller acts in, such as an API key's. Required when the caller belongs to several.
      */
     organizationId?: CommonUuid;
-    /**
-     * Strategy for selecting an available profile from the pool
-     */
     selectionStrategy?: AgentsProfileSelectionStrategy;
     /**
      * Whether multiple executions can use the same profile concurrently
@@ -4003,17 +3451,12 @@ type AgentsProfileCreateAgentProfileRequest = {
      * Name of the agent profile (must be unique within organization)
      */
     name: string;
-    /**
-     * Description of the agent profile
-     */
     description: string;
     /**
      * The ID of the organization that the profile belongs to. Defaults to the one organization the caller acts in, such as an API key's. Required when the caller belongs to several.
      */
     organizationId?: CommonUuid;
     /**
-     * Proxy configuration mode
-     *
      * @deprecated
      */
     proxyMode?: AgentsProfileProxyMode;
@@ -4054,14 +3497,10 @@ type AgentsProfileCreateAgentProfileRequest = {
      */
     stickyIP?: boolean;
     /**
-     * Operating system to emulate
-     *
      * @deprecated
      */
     operatingSystem?: AgentsProfileOperatingSystem;
     /**
-     * Whether to enable extra stealth mode
-     *
      * @deprecated
      */
     extraStealth?: boolean;
@@ -4078,8 +3517,6 @@ type AgentsProfileCreateAgentProfileRequest = {
      */
     cachePersistence?: boolean;
     /**
-     * Whether to enable ad blocking
-     *
      * @deprecated
      */
     adblockActive?: boolean;
@@ -4142,8 +3579,6 @@ type AgentsProfileCreateAgentProfileRequest = {
      */
     credentials?: Array<AgentsProfileCredential>;
     /**
-     * Initial cookies to create with the profile
-     *
      * @deprecated
      */
     cookies?: Array<AgentsProfileCookie>;
@@ -4152,9 +3587,6 @@ type AgentsProfileCreateAgentProfileRequest = {
  * A credential stored for an agent profile
  */
 type AgentsProfileCredential = {
-    /**
-     * Unique identifier for the credential
-     */
     id?: CommonUuid;
     /**
      * Display name for the credential (will be uppercased)
@@ -4164,9 +3596,6 @@ type AgentsProfileCredential = {
      * The credential value (plaintext - will be encrypted server-side)
      */
     data: string;
-    /**
-     * When the credential was created
-     */
     createdAt?: string;
 };
 /**
@@ -4190,26 +3619,14 @@ type AgentsProfileCustomProxyConfigInput = {
      * Proxy server address including protocol and port (e.g., 'socks5://proxy.example.com:1080' or 'http://proxy.example.com:8080')
      */
     server: string;
-    /**
-     * Proxy authentication username
-     */
     username: string;
-    /**
-     * Proxy authentication password
-     */
     password: string;
 };
 /**
  * Custom proxy server configuration for output (excludes password)
  */
 type AgentsProfileCustomProxyConfigOutput = {
-    /**
-     * Proxy server address
-     */
     server: string;
-    /**
-     * Proxy authentication username
-     */
     username: string;
 };
 /**
@@ -4245,21 +3662,9 @@ type AgentsProfileProfileInboxEmail = {
      * Unique email ID from Resend
      */
     id: string;
-    /**
-     * Sender address
-     */
     from: string;
-    /**
-     * Recipient addresses
-     */
     to: Array<string>;
-    /**
-     * Email subject
-     */
     subject: string;
-    /**
-     * When the email was received
-     */
     createdAt: string;
 };
 /**
@@ -4270,41 +3675,14 @@ type AgentsProfileProfileInboxEmailDetail = {
      * Unique email ID from Resend
      */
     id: string;
-    /**
-     * Sender address
-     */
     from: string;
-    /**
-     * Recipient addresses
-     */
     to: Array<string>;
-    /**
-     * Email subject
-     */
     subject: string;
-    /**
-     * When the email was received
-     */
     createdAt: string;
-    /**
-     * Plain-text body, if available
-     */
     text?: string;
-    /**
-     * HTML body, if available
-     */
     html?: string;
-    /**
-     * CC recipients, if any
-     */
     cc?: Array<string>;
-    /**
-     * BCC recipients, if any
-     */
     bcc?: Array<string>;
-    /**
-     * Reply-to addresses, if any
-     */
     replyTo?: Array<string>;
 };
 /**
@@ -4319,9 +3697,6 @@ type AgentsProfileProxyType = "basic";
  * Request to remove profiles from a pool
  */
 type AgentsProfileRemoveProfilesFromPoolRequest = {
-    /**
-     * Profile IDs to remove from the pool
-     */
     profileIds: Array<CommonUuid>;
 };
 /**
@@ -4340,13 +3715,7 @@ type AgentsProfileSortField = "name" | "created_at" | "updated_at";
  * Request to update an existing agent profile pool
  */
 type AgentsProfileUpdateAgentProfilePoolRequest = {
-    /**
-     * New name for the pool
-     */
     name?: string;
-    /**
-     * New selection strategy for the pool
-     */
     selectionStrategy?: AgentsProfileSelectionStrategy;
     /**
      * Whether multiple executions can use the same profile concurrently
@@ -4357,17 +3726,9 @@ type AgentsProfileUpdateAgentProfilePoolRequest = {
  * Request to update an existing agent profile
  */
 type AgentsProfileUpdateAgentProfileRequest = {
-    /**
-     * New name for the profile
-     */
     name?: string;
-    /**
-     * New description for the profile
-     */
     description?: string;
     /**
-     * Proxy configuration mode
-     *
      * @deprecated
      */
     proxyMode?: AgentsProfileProxyMode;
@@ -4402,14 +3763,10 @@ type AgentsProfileUpdateAgentProfileRequest = {
      */
     captchaSolverActive?: boolean;
     /**
-     * Operating system to emulate
-     *
      * @deprecated
      */
     operatingSystem?: AgentsProfileOperatingSystem;
     /**
-     * Whether to enable extra stealth mode
-     *
      * @deprecated
      */
     extraStealth?: boolean;
@@ -4426,8 +3783,6 @@ type AgentsProfileUpdateAgentProfileRequest = {
      */
     cachePersistence?: boolean;
     /**
-     * Whether to enable ad blocking
-     *
      * @deprecated
      */
     adblockActive?: boolean;
@@ -4522,14 +3877,10 @@ type AgentsProfileUpdateAgentProfileRequest = {
      */
     credentialsToDelete?: Array<CommonUuid>;
     /**
-     * Cookies to add to the profile
-     *
      * @deprecated
      */
     cookiesToAdd?: Array<AgentsProfileCookie>;
     /**
-     * IDs of cookies to remove from the profile
-     *
      * @deprecated
      */
     cookiesToDelete?: Array<CommonUuid>;
@@ -4581,9 +3932,6 @@ type AgentsScheduleBase = {
      */
     executionOptions?: AgentsAgentExecutionOptions;
     nextRunAt?: string;
-    /**
-     * When the schedule last fired.
-     */
     lastRunAt?: string;
     /**
      * Why the last tick failed, or absent when it succeeded. Set when a tick could not start its execution or batch, for example a sheet with more rows than one run may queue.
@@ -4644,13 +3992,22 @@ type AgentsScheduleCreateRequest = {
      * Profile group to select a profile from for each execution. Mutually exclusive with profileId.
      */
     profileGroupId?: CommonUuid;
+    /**
+     * Five-field cron expression.
+     */
     cronExpression: string;
     /**
      * IANA time zone the cron expression is evaluated in. Defaults to UTC.
      */
     timezone?: string;
     enabled?: boolean;
+    /**
+     * When true, enabling the schedule after it was disabled runs it once right away. Creating it does not.
+     */
     runOnEnable?: boolean;
+    /**
+     * Workflow version number to run. Omit it to run the published version.
+     */
     version?: number;
     inputs?: {
         [key: string]: unknown;
@@ -4686,13 +4043,22 @@ type AgentsScheduleUpdateRequest = {
      * Profile group to select a profile from for each execution. Mutually exclusive with profileId.
      */
     profileGroupId?: CommonUuid;
+    /**
+     * Five-field cron expression.
+     */
     cronExpression?: string;
     /**
      * IANA time zone the cron expression is evaluated in.
      */
     timezone?: string;
     enabled?: boolean;
+    /**
+     * When true, enabling the schedule after it was disabled runs it once right away.
+     */
     runOnEnable?: boolean;
+    /**
+     * Workflow version number to run. Omit it to keep the current one.
+     */
     version?: number;
     inputs?: {
         [key: string]: unknown;
@@ -4717,13 +4083,7 @@ type AgentsScheduleUpdateRequest = {
 };
 type AgentsScheduledExecutionBase = {
     id: CommonUuid;
-    /**
-     * The ID of the workflow the scheduled execution runs
-     */
     workflowId: CommonUuid;
-    /**
-     * The ID of the workflow version the scheduled execution runs
-     */
     workflowVersionId: CommonUuid;
     /**
      * Deprecated: use workflowId. The ID of the workflow the scheduled execution runs
@@ -4760,15 +4120,18 @@ type AgentsScheduledExecutionBase = {
     inputVars: {
         [key: string]: unknown;
     };
-    /**
-     * Input variables for the execution
-     */
     inputs: {
         [key: string]: unknown;
     };
+    /**
+     * String key/value pairs to label and filter executions.
+     */
     metadata: {
         [key: string]: unknown;
     };
+    /**
+     * When to start the run, in ISO 8601.
+     */
     executeAt?: string;
     status: AgentsScheduledExecutionStatus;
     executionId?: CommonUuid;
@@ -4799,9 +4162,6 @@ type AgentsScheduledExecutionCreateRequest = {
      * @deprecated
      */
     agentProfileId?: CommonUuid;
-    /**
-     * Login profile the execution runs with
-     */
     profileId?: CommonUuid;
     /**
      * Deprecated: use inputs.
@@ -4811,15 +4171,18 @@ type AgentsScheduledExecutionCreateRequest = {
     inputVars?: {
         [key: string]: unknown;
     };
-    /**
-     * Input variables for the execution
-     */
     inputs?: {
         [key: string]: unknown;
     };
+    /**
+     * String key/value pairs to label and filter executions.
+     */
     metadata?: {
         [key: string]: unknown;
     };
+    /**
+     * When to start the run, in ISO 8601.
+     */
     executeAt: string;
     /**
      * Per-execution runtime options applied when this execution is triggered.
@@ -4827,6 +4190,9 @@ type AgentsScheduledExecutionCreateRequest = {
     executionOptions?: AgentsAgentExecutionOptions;
 };
 type AgentsScheduledExecutionRescheduleRequest = {
+    /**
+     * When to start the run, in ISO 8601.
+     */
     executeAt: string;
 };
 type AgentsScheduledExecutionStatus = "pending" | "triggered" | "cancelled" | "awaiting_capacity" | "batch_paused" | "failed";
@@ -4834,9 +4200,6 @@ type AgentsScheduledExecutionStatus = "pending" | "triggered" | "cancelled" | "a
  * Request to validate a JSON schema against OpenAI structured output requirements
  */
 type AgentsSchemaValidateSchemaRequest = {
-    /**
-     * The JSON schema to validate
-     */
     schema: {
         [key: string]: unknown;
     };
@@ -4845,9 +4208,6 @@ type AgentsSchemaValidateSchemaRequest = {
  * Response from schema validation
  */
 type AgentsSchemaValidateSchemaResponse = {
-    /**
-     * Whether the schema is valid
-     */
     valid: boolean;
     /**
      * List of validation error messages (empty if valid)
@@ -4864,18 +4224,12 @@ type AgentsTagAgentWorkflowTagName = {
      * Group name. Protected group names resolve to the protected group; anything else is a user-defined group.
      */
     group: string;
-    /**
-     * Tag name
-     */
     name: string;
 };
 /**
  * Exactly one of groupId and protectedGroupKey selects the group.
  */
 type AgentsTagCreateWorkflowTagRequest = {
-    /**
-     * Group to create the tag in
-     */
     groupId?: CommonUuid;
     /**
      * Protected group to create the tag in, materializing its row if needed
@@ -4902,9 +4256,6 @@ type AgentsTagPatchAgentWorkflowTagsRequest = {
      * Tags to add by name, created when missing
      */
     create?: Array<AgentsTagAgentWorkflowTagName>;
-    /**
-     * Tag ids to remove
-     */
     remove?: Array<CommonUuid>;
 };
 type AgentsTagSetAgentWorkflowTagsRequest = {
@@ -4941,17 +4292,8 @@ type AgentsTagUpdateWorkflowTagRequest = {
  * Org-scoped workflow tag. Portal-group tags can link to a catalog portal, which supplies the logo.
  */
 type AgentsTagWorkflowTag = {
-    /**
-     * Unique identifier for the tag
-     */
     id: CommonUuid;
-    /**
-     * Organization this tag belongs to
-     */
     organizationId: CommonUuid;
-    /**
-     * Group the tag belongs to
-     */
     groupId: CommonUuid;
     /**
      * Name of the group the tag belongs to, so clients can render group::tag without listing groups
@@ -4979,26 +4321,14 @@ type AgentsTagWorkflowTag = {
      * Number of workflows carrying this tag. Present on the organization list only.
      */
     workflowCount?: number;
-    /**
-     * When the tag was created
-     */
     createdAt: string;
-    /**
-     * When the tag was last updated
-     */
     updatedAt: string;
 };
 /**
  * Org-scoped group of workflow tags. A tag renders as group::tag, so names may not contain '::'.
  */
 type AgentsTagWorkflowTagGroup = {
-    /**
-     * Unique identifier for the group
-     */
     id: CommonUuid;
-    /**
-     * Organization this group belongs to
-     */
     organizationId: CommonUuid;
     /**
      * Group name, unique per organization case-insensitively
@@ -5016,13 +4346,7 @@ type AgentsTagWorkflowTagGroup = {
      * Number of tags in the group. Present on the organization list only.
      */
     tagCount?: number;
-    /**
-     * When the group was created
-     */
     createdAt: string;
-    /**
-     * When the group was last updated
-     */
     updatedAt: string;
 };
 /**
@@ -5059,6 +4383,9 @@ type AgentsVaultCreateVaultItemRequest = {
      * Inline field blueprint. Required when templateId is omitted.
      */
     fields?: Array<AgentsVaultFieldSpecInput>;
+    /**
+     * Field values as `key`/`value` pairs.
+     */
     values: Array<AgentsVaultFieldValue>;
 };
 type AgentsVaultCreateVaultShareLinkRequest = {
@@ -5066,8 +4393,17 @@ type AgentsVaultCreateVaultShareLinkRequest = {
      * The organization. Defaults to the one organization the caller acts in, such as an API key's. Required when the caller belongs to several.
      */
     organizationId?: CommonUuid;
+    /**
+     * Title shown to the recipient of the secret request.
+     */
     title: string;
+    /**
+     * Explanation shown to the recipient of the secret request.
+     */
     description?: string;
+    /**
+     * Name of the secret the request creates.
+     */
     name: string;
     /**
      * Optional UPPER_SNAKE key. Derived from name when omitted.
@@ -5099,6 +4435,9 @@ type AgentsVaultCreateVaultTemplateRequest = {
     name: string;
     description?: string;
     fields: Array<AgentsVaultFieldSpecInput>;
+    /**
+     * How the fields are laid out as steps when someone fills in a secret request.
+     */
     steps?: Array<AgentsVaultTemplateStep>;
 };
 type AgentsVaultDuplicateVaultTemplateRequest = {
@@ -5194,6 +4533,9 @@ type AgentsVaultItemKey = string;
  */
 type AgentsVaultItemKind = "login" | "api_key" | "card" | "custom";
 type AgentsVaultRotateVaultItemRequest = {
+    /**
+     * New field values as `key`/`value` pairs.
+     */
     values: Array<AgentsVaultFieldValue>;
 };
 /**
@@ -5242,6 +4584,9 @@ type AgentsVaultUpdateVaultTemplateRequest = {
     name?: string;
     description?: string;
     fields?: Array<AgentsVaultFieldSpecInput>;
+    /**
+     * How the fields are laid out as steps when someone fills in a secret request.
+     */
     steps?: Array<AgentsVaultTemplateStep>;
 };
 /**
@@ -5319,9 +4664,6 @@ type AgentsVaultVaultShareLink = {
      * Submits that resolved this link but did not complete it: invalid values, a dead link, or a lost race.
      */
     failedSubmits: number;
-    /**
-     * When the most recent failed submit happened.
-     */
     lastFailedSubmitAt?: string;
     /**
      * Who made it. `createdBy` holds a user id only, so read this for a record an API key made.
@@ -5335,9 +4677,6 @@ type AgentsVaultVaultShareLink = {
  * Create response. token is the raw link secret and is returned once; the server stores only its hash.
  */
 type AgentsVaultVaultShareLinkCreated = {
-    /**
-     * The created share link.
-     */
     link: AgentsVaultVaultShareLink;
     /**
      * Raw token for the recipient URL. Returned once.
@@ -5425,9 +4764,6 @@ type AgentsWorkflowBrowserTemplateConfig = {
  * Response after creating a workflow
  */
 type AgentsWorkflowCreateWorkflowResponse = {
-    /**
-     * The ID of the newly created workflow
-     */
     workflowId: CommonUuid;
 };
 /**
@@ -5495,9 +4831,6 @@ type AgentsWorkflowExecuteWorkflowRequest = {
  * Response after starting workflow execution
  */
 type AgentsWorkflowExecuteWorkflowResponse = {
-    /**
-     * The ID of the newly created execution
-     */
     executionId: CommonUuid;
 };
 /**
@@ -5508,21 +4841,12 @@ type AgentsWorkflowExternalCreateWorkflowRequest = {
      * Optional parent workflow ID to derive from
      */
     parentId?: CommonUuid;
-    /**
-     * The rules/instructions for this workflow
-     */
     rules: string;
-    /**
-     * The workflow graph
-     */
     graph: AgentsGraphModelsAgentGraph;
     /**
      * Typed input definitions for this workflow. Names referenced in prompts but omitted here default to optional strings.
      */
     inputs?: Array<AgentsWorkflowInput>;
-    /**
-     * The settings for this workflow
-     */
     settings: AgentsGraphModelsExternalSettings;
     /**
      * Optional environment template. On a new version, omit it to keep the template of the workflow's latest version (its editable head); on a new workflow, omitting it means a browser. Omits admin-only OS fields.
@@ -5533,22 +4857,13 @@ type AgentsWorkflowExternalCreateWorkflowRequest = {
  * Environment template on the external API. Omits admin-only OS fields.
  */
 type AgentsWorkflowExternalEnvironmentTemplate = {
-    /**
-     * Type of environment (browser or os)
-     */
     type: AgentsWorkflowEnvironmentType;
-    /**
-     * Environment-specific configuration
-     */
     config: AgentsWorkflowBrowserTemplateConfig | AgentsWorkflowExternalOsTemplateConfig;
 };
 /**
  * Customer-facing OS environment template configuration. Admin-only fields live on OsTemplateConfig.
  */
 type AgentsWorkflowExternalOsTemplateConfig = {
-    /**
-     * OS provider type
-     */
     provider: AgentsWorkflowOsProvider;
     /**
      * Operating system the sandbox runs. Defaults to linux. Setting to windows is admin-only and selects the Windows snapshot/image.
@@ -5571,13 +4886,7 @@ type AgentsWorkflowExternalOsTemplateConfig = {
  * A workflow (commit) representing an immutable snapshot of agent configuration
  */
 type AgentsWorkflowExternalWorkflowSnapshot = {
-    /**
-     * The unique ID of this workflow
-     */
     id: CommonUuid;
-    /**
-     * The agent ID this workflow belongs to
-     */
     agentId: CommonUuid;
     /**
      * The ID of the parent workflow this was derived from (for lineage tracking)
@@ -5591,13 +4900,7 @@ type AgentsWorkflowExternalWorkflowSnapshot = {
      * Whether this is the workflow's published version (the API default). At most one version per workflow is published.
      */
     isPublished: boolean;
-    /**
-     * The rules/instructions for this workflow
-     */
     rules: string;
-    /**
-     * The workflow graph
-     */
     graph: AgentsGraphModelsAgentGraph;
     /**
      * Typed input definitions for workflow execution. Includes names referenced in prompts, which default to optional strings.
@@ -5619,9 +4922,6 @@ type AgentsWorkflowExternalWorkflowSnapshot = {
      * Monotonic optimistic-concurrency revision. Only meaningful for the editable head: supply it as baseRev on the next head patch. Agent-file-only patches overlay the current head if it has moved; structural-file patches are rejected with 409 when stale. Frozen snapshots never receive in-place patches.
      */
     rev: number;
-    /**
-     * The settings for this workflow
-     */
     settings: AgentsGraphModelsExternalSettings;
     /**
      * Optional environment template. Defaults to browser/anchor if not provided. Omits admin-only OS fields.
@@ -5650,9 +4950,6 @@ type AgentsWorkflowInput = {
      * Optional value used when the input is omitted at execution time.
      */
     defaultValue?: unknown;
-    /**
-     * Optional human-readable description of the input.
-     */
     description?: string;
 };
 /**
@@ -5671,13 +4968,7 @@ type AgentsWorkflowOsType = "linux" | "windows";
  * Response after publishing a workflow
  */
 type AgentsWorkflowPublishWorkflowResponse = {
-    /**
-     * The ID of the published workflow
-     */
     workflowId: CommonUuid;
-    /**
-     * The assigned version number
-     */
     version: number;
 };
 /**
@@ -5693,17 +4984,11 @@ type AgentsWorkflowRevertWorkflowHeadRequest = {
  * A file stored on a workflow version. Content is fetched via the workflow-scoped shared-file download endpoints using this id.
  */
 type AgentsWorkflowWorkflowFile = {
-    /**
-     * The unique ID of this file within the workflow version
-     */
     id: CommonUuid;
     /**
      * The file path, relative to the workflow's shared directory
      */
     filePath: string;
-    /**
-     * The file's base name
-     */
     fileName: string;
     /**
      * The file size in bytes
@@ -5721,9 +5006,6 @@ type AgentsWorkflowWorkflowFile = {
      * When this file was first added to the workflow lineage
      */
     createdAt: string;
-    /**
-     * When this file was last modified
-     */
     updatedAt: string;
 };
 /**
@@ -5841,18 +5123,12 @@ type AgentsWorkflowWorkflowFilesPatchRequest = {
      * Files to upsert.
      */
     writes: Array<AgentsWorkflowWorkflowFileWrite>;
-    /**
-     * Paths of files to delete.
-     */
     deletes: Array<string>;
 };
 /**
  * The typed inputs a workflow declares
  */
 type AgentsWorkflowWorkflowInputs = {
-    /**
-     * Typed input definitions the workflow accepts at execution time
-     */
     inputs: Array<AgentsWorkflowInput>;
 };
 /**
@@ -5865,9 +5141,6 @@ type AgentsWorkflowWorkflowOutputSchemas = {
  * Lightweight workflow reference for listing workflows without full data
  */
 type AgentsWorkflowWorkflowRef = {
-    /**
-     * The unique ID of this workflow
-     */
     id: CommonUuid;
     /**
      * The ID of the parent workflow this was derived from (for lineage tracking)
@@ -5881,9 +5154,6 @@ type AgentsWorkflowWorkflowRef = {
      * Whether this is the workflow's published version (the API default). At most one version per workflow is published.
      */
     isPublished: boolean;
-    /**
-     * When this workflow was created
-     */
     createdAt: string;
     /**
      * The email of the user who created this workflow.
@@ -5902,9 +5172,6 @@ type AgentsWorkflowWorkflowValidationIssue = {
      * Whether this issue blocks running the workflow (error) or is advisory (warning).
      */
     severity: AgentsWorkflowWorkflowValidationSeverity;
-    /**
-     * Human-readable description of the problem.
-     */
     message: string;
     /**
      * Path to the offending field, e.g. ["nodes", "My Node", "model"].
@@ -5949,9 +5216,6 @@ type CommonBadRequestErrorBody = {
      * Short summary of the problem type
      */
     title?: string;
-    /**
-     * The HTTP status code
-     */
     status?: number;
     /**
      * Explanation of this occurrence. Same text as message
@@ -5977,9 +5241,6 @@ type CommonConflictErrorBody = {
      * Short summary of the problem type
      */
     title?: string;
-    /**
-     * The HTTP status code
-     */
     status?: number;
     /**
      * Explanation of this occurrence. Same text as message
@@ -6001,9 +5262,6 @@ type CommonError = {
      * Short summary of the problem type
      */
     title?: string;
-    /**
-     * The HTTP status code
-     */
     status?: number;
     /**
      * Explanation of this occurrence. Same text as message
@@ -6042,9 +5300,6 @@ type CommonForbiddenErrorBody = {
      * Short summary of the problem type
      */
     title?: string;
-    /**
-     * The HTTP status code
-     */
     status?: number;
     /**
      * Explanation of this occurrence. Same text as message
@@ -6075,9 +5330,6 @@ type CommonInternalServerErrorBody = {
      * Short summary of the problem type
      */
     title?: string;
-    /**
-     * The HTTP status code
-     */
     status?: number;
     /**
      * Explanation of this occurrence. Same text as message
@@ -6099,9 +5351,6 @@ type CommonNotFoundErrorBody = {
      * Short summary of the problem type
      */
     title?: string;
-    /**
-     * The HTTP status code
-     */
     status?: number;
     /**
      * Explanation of this occurrence. Same text as message
@@ -6126,9 +5375,6 @@ type CommonPaymentRequiredErrorBody = {
      * Short summary of the problem type
      */
     title?: string;
-    /**
-     * The HTTP status code
-     */
     status?: number;
     /**
      * Explanation of this occurrence. Same text as message
@@ -6155,9 +5401,6 @@ type CommonTooManyRequestsErrorBody = {
      * Short summary of the problem type
      */
     title?: string;
-    /**
-     * The HTTP status code
-     */
     status?: number;
     /**
      * Explanation of this occurrence. Same text as message
@@ -6179,9 +5422,6 @@ type CommonUnauthorizedErrorBody = {
      * Short summary of the problem type
      */
     title?: string;
-    /**
-     * The HTTP status code
-     */
     status?: number;
     /**
      * Explanation of this occurrence. Same text as message
@@ -6202,21 +5442,12 @@ type WorkflowsVersionCreateRequest = {
      * Optional parent workflow ID to derive from
      */
     parentId?: CommonUuid;
-    /**
-     * The rules/instructions for this workflow
-     */
     rules: string;
-    /**
-     * The workflow graph
-     */
     graph: AgentsGraphModelsAgentGraph;
     /**
      * Typed input definitions for this workflow. Names referenced in prompts but omitted here default to optional strings.
      */
     inputs?: Array<AgentsWorkflowInput>;
-    /**
-     * The settings for this workflow
-     */
     settings: AgentsGraphModelsExternalSettings;
     /**
      * Optional environment template. On a new version, omit it to keep the template of the workflow's latest version (its editable head); on a new workflow, omitting it means a browser. Omits admin-only OS fields.
@@ -6227,9 +5458,6 @@ type WorkflowsVersionCreateRequest = {
  * Response after creating a workflow version
  */
 type WorkflowsVersionCreateResponse = {
-    /**
-     * The ID of the new version
-     */
     versionId: CommonUuid;
 };
 /**
@@ -6293,9 +5521,6 @@ type WorkflowsVersionExecuteRequest = {
  * Response after starting a workflow version execution
  */
 type WorkflowsVersionExecuteResponse = {
-    /**
-     * The ID of the newly created execution
-     */
     executionId: CommonUuid;
 };
 /**
@@ -6322,9 +5547,6 @@ type WorkflowsVersionFileTree = {
      * Every variant key the workflow's files carry, sorted, regardless of any variants filter on the read — a narrowed tree still names what it could ask for. Absent unless the workflow has variant mode enabled.
      */
     variantKeys?: Array<string>;
-    /**
-     * The ID of the version this tree renders
-     */
     versionId: CommonUuid;
     /**
      * The name of the workflow. A client that lays the directory out under a per-workflow folder derives the folder from it.
@@ -6343,18 +5565,12 @@ type WorkflowsVersionFilesPatchRequest = {
      * Files to upsert.
      */
     writes: Array<AgentsWorkflowWorkflowFileWrite>;
-    /**
-     * Paths of files to delete.
-     */
     deletes: Array<string>;
 };
 /**
  * The typed inputs a workflow version declares
  */
 type WorkflowsVersionInputs = {
-    /**
-     * Typed input definitions the workflow accepts at execution time
-     */
     inputs: Array<AgentsWorkflowInput>;
 };
 /**
@@ -6378,22 +5594,13 @@ type WorkflowsVersionOutputSchemas = {
  * Response after publishing a workflow version
  */
 type WorkflowsVersionPublishResponse = {
-    /**
-     * The ID of the published version
-     */
     versionId: CommonUuid;
-    /**
-     * The assigned version number
-     */
     version: number;
 };
 /**
  * Lightweight reference to a workflow version, for listing versions without their full content
  */
 type WorkflowsVersionRef = {
-    /**
-     * The unique ID of this workflow
-     */
     id: CommonUuid;
     /**
      * The ID of the parent workflow this was derived from (for lineage tracking)
@@ -6407,9 +5614,6 @@ type WorkflowsVersionRef = {
      * Whether this is the workflow's published version (the API default). At most one version per workflow is published.
      */
     isPublished: boolean;
-    /**
-     * When this workflow was created
-     */
     createdAt: string;
     /**
      * The email of the user who created this workflow.
@@ -6433,9 +5637,6 @@ type WorkflowsVersionRevertHeadRequest = {
  * An immutable snapshot of a workflow's configuration
  */
 type WorkflowsVersionSnapshot = {
-    /**
-     * The unique ID of this workflow
-     */
     id: CommonUuid;
     /**
      * The ID of the parent workflow this was derived from (for lineage tracking)
@@ -6449,13 +5650,7 @@ type WorkflowsVersionSnapshot = {
      * Whether this is the workflow's published version (the API default). At most one version per workflow is published.
      */
     isPublished: boolean;
-    /**
-     * The rules/instructions for this workflow
-     */
     rules: string;
-    /**
-     * The workflow graph
-     */
     graph: AgentsGraphModelsAgentGraph;
     /**
      * Typed input definitions for workflow execution. Includes names referenced in prompts, which default to optional strings.
@@ -6477,13 +5672,7 @@ type WorkflowsVersionSnapshot = {
      * Monotonic optimistic-concurrency revision. Only meaningful for the editable head: supply it as baseRev on the next head patch. Agent-file-only patches overlay the current head if it has moved; structural-file patches are rejected with 409 when stale. Frozen snapshots never receive in-place patches.
      */
     rev: number;
-    /**
-     * The ID of the workflow this version belongs to
-     */
     workflowId: CommonUuid;
-    /**
-     * The settings for this version
-     */
     settings: AgentsGraphModelsExternalSettings;
     /**
      * Optional environment template. Defaults to browser/anchor if not provided.
@@ -6542,9 +5731,6 @@ type WorkflowsWorkflowCreateResponse = {
  * A workflow and the selected version
  */
 type WorkflowsWorkflowDetail = {
-    /**
-     * The workflow
-     */
     workflow: WorkflowsWorkflowBase;
     /**
      * The selected version: the published one unless a version number was requested
@@ -6572,9 +5758,6 @@ type WorkflowsWorkflowDuplicateRequest = {
  * Response after duplicating a workflow
  */
 type WorkflowsWorkflowDuplicateResponse = {
-    /**
-     * The ID of the new workflow
-     */
     id: CommonUuid;
     /**
      * The ID of the new workflow's first version
@@ -6654,9 +5837,6 @@ type WorkflowsWorkflowExecuteRequest = {
  * Response after starting a workflow execution
  */
 type WorkflowsWorkflowExecuteResponse = {
-    /**
-     * The ID of the newly created execution
-     */
     executionId: CommonUuid;
     /**
      * The execution's initial status: "starting" when it began immediately, "queued" when it
@@ -6742,9 +5922,6 @@ type WorkflowsWorkflowExecuteSyncRequest = {
  * Response from executing a workflow and waiting for the result
  */
 type WorkflowsWorkflowExecuteSyncResponse = {
-    /**
-     * The ID of the newly created execution
-     */
     executionId: CommonUuid;
     /**
      * The execution's status when the call returned: terminal on 200, the current status on 202
@@ -6774,9 +5951,6 @@ type WorkflowsWorkflowPatchTagsRequest = {
      * Tags to add by name, created when missing
      */
     create?: Array<AgentsTagAgentWorkflowTagName>;
-    /**
-     * Tag ids to remove
-     */
     remove?: Array<CommonUuid>;
 };
 /**
@@ -6828,9 +6002,6 @@ type WorkflowsWorkflowSchedule = {
      */
     executionOptions?: AgentsAgentExecutionOptions;
     nextRunAt?: string;
-    /**
-     * When the schedule last fired.
-     */
     lastRunAt?: string;
     /**
      * Why the last tick failed, or absent when it succeeded. Set when a tick could not start its execution or batch, for example a sheet with more rows than one run may queue.
@@ -6842,9 +6013,6 @@ type WorkflowsWorkflowSchedule = {
     actor?: CommonActor;
     createdAt: string;
     updatedAt: string;
-    /**
-     * The ID of the workflow the schedule executes
-     */
     workflowId: CommonUuid;
 };
 /**
@@ -6872,13 +6040,22 @@ type WorkflowsWorkflowScheduleCreateRequest = {
      * Profile group to select a profile from for each execution. Mutually exclusive with profileId.
      */
     profileGroupId?: CommonUuid;
+    /**
+     * Five-field cron expression.
+     */
     cronExpression: string;
     /**
      * IANA time zone the cron expression is evaluated in. Defaults to UTC.
      */
     timezone?: string;
     enabled?: boolean;
+    /**
+     * When true, enabling the schedule after it was disabled runs it once right away. Creating it does not.
+     */
     runOnEnable?: boolean;
+    /**
+     * Workflow version number to run. Omit it to run the published version.
+     */
     version?: number;
     inputs?: {
         [key: string]: unknown;
@@ -6917,13 +6094,22 @@ type WorkflowsWorkflowScheduleUpdateRequest = {
      * Profile group to select a profile from for each execution. Mutually exclusive with profileId.
      */
     profileGroupId?: CommonUuid;
+    /**
+     * Five-field cron expression.
+     */
     cronExpression?: string;
     /**
      * IANA time zone the cron expression is evaluated in.
      */
     timezone?: string;
     enabled?: boolean;
+    /**
+     * When true, enabling the schedule after it was disabled runs it once right away.
+     */
     runOnEnable?: boolean;
+    /**
+     * Workflow version number to run. Omit it to keep the current one.
+     */
     version?: number;
     inputs?: {
         [key: string]: unknown;
@@ -6964,6 +6150,9 @@ type WorkflowsWorkflowUpdateRequest = {
      */
     name?: string;
 };
+/**
+ * Return results whose name contains this text, case-insensitive.
+ */
 type AgentsAgentSearch = string;
 /**
  * Filter executions created within this long before now: number-unit pairs with units w, d, h, m, longest first, e.g. 30m, 24h, 7d, 1d12h. Maximum 10 years. Cannot be combined with createdAfter
@@ -6989,21 +6178,12 @@ type AgentsExecutionSearchAgentId = CommonUuid;
  * @deprecated
  */
 type AgentsExecutionSearchAgentProfileIds = Array<CommonUuid>;
-/**
- * Filter executions created after this timestamp
- */
 type AgentsExecutionSearchCreatedAfter = string;
-/**
- * Filter executions created before this timestamp
- */
 type AgentsExecutionSearchCreatedBefore = string;
 /**
  * Search by execution ID (partial, case-insensitive match)
  */
 type AgentsExecutionSearchExecutionId = string;
-/**
- * Filter by whether the execution recorded any script failures
- */
 type AgentsExecutionSearchHasScriptFailures = boolean;
 /**
  * Filter by human labels (can specify multiple label IDs, there is an 'OR' condition applied to these)
@@ -7041,13 +6221,7 @@ type AgentsExecutionSearchStatus = Array<AgentsExecutionStatus>;
  * Filter by how the execution was triggered (can specify multiple, there is an 'OR' condition applied to these)
  */
 type AgentsExecutionSearchTriggerSource = Array<"api" | "ui" | "schedule" | "warmup">;
-/**
- * Filter by workflow version number
- */
 type AgentsExecutionSearchWorkflowVersion = number;
-/**
- * Filter by workflow ID
- */
 type AgentsExecutionWorkflowFilter = CommonUuid;
 /**
  * Deprecated: use workflowId. Filter by workflow ID
@@ -7055,9 +6229,6 @@ type AgentsExecutionWorkflowFilter = CommonUuid;
  * @deprecated
  */
 type AgentsExecutionBatchListFilterAgentId = CommonUuid;
-/**
- * Filter by batch status
- */
 type AgentsExecutionBatchListFilterStatus = AgentsExecutionBatchStatus;
 /**
  * Filter by workflow ID. Set this or agentId.
@@ -7099,9 +6270,6 @@ type AgentsScheduledExecutionListFilterStatus = AgentsScheduledExecutionStatus;
  * Filter by workflow ID. A workflow version ID is still accepted here and filters by that version (deprecated). Set this or workflowVersionId.
  */
 type AgentsScheduledExecutionListFilterWorkflowId = CommonUuid;
-/**
- * Filter by workflow version ID
- */
 type AgentsScheduledExecutionListFilterWorkflowVersionId = CommonUuid;
 /**
  * Case-insensitive substring match on the secret name or item key
@@ -7242,9 +6410,6 @@ type AgentProfilePoolsListData = {
     body?: never;
     path?: never;
     query?: {
-        /**
-         * Filter by organization ID
-         */
         organizationId?: CommonUuid;
         pageSize?: number;
         page?: number;
@@ -7292,10 +6457,7 @@ type AgentProfilePoolsListResponses = {
     };
 };
 type AgentProfilePoolsListResponse = AgentProfilePoolsListResponses[keyof AgentProfilePoolsListResponses];
-type AgentProfilePoolsCreateData = {
-    /**
-     * Agent profile pool to create
-     */
+type AgentProfilePoolsCreateData = {
     body: AgentsProfileCreateAgentProfilePoolRequest;
     path?: never;
     query?: never;
@@ -7334,9 +6496,6 @@ type AgentProfilePoolsCreateResponse = AgentProfilePoolsCreateResponses[keyof Ag
 type AgentProfilePoolDeleteData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent profile pool
-         */
         poolId: CommonUuid;
     };
     query?: never;
@@ -7375,9 +6534,6 @@ type AgentProfilePoolDeleteResponse = AgentProfilePoolDeleteResponses[keyof Agen
 type AgentProfilePoolGetData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent profile pool
-         */
         poolId: CommonUuid;
     };
     query?: never;
@@ -7414,14 +6570,8 @@ type AgentProfilePoolGetResponses = {
 };
 type AgentProfilePoolGetResponse = AgentProfilePoolGetResponses[keyof AgentProfilePoolGetResponses];
 type AgentProfilePoolUpdateData = {
-    /**
-     * Fields to update
-     */
     body: AgentsProfileUpdateAgentProfilePoolRequest;
     path: {
-        /**
-         * The ID of the agent profile pool
-         */
         poolId: CommonUuid;
     };
     query?: never;
@@ -7458,14 +6608,8 @@ type AgentProfilePoolUpdateResponses = {
 };
 type AgentProfilePoolUpdateResponse = AgentProfilePoolUpdateResponses[keyof AgentProfilePoolUpdateResponses];
 type AgentProfilePoolMembersRemoveData = {
-    /**
-     * Profile IDs to remove
-     */
     body: AgentsProfileRemoveProfilesFromPoolRequest;
     path: {
-        /**
-         * The ID of the agent profile pool
-         */
         poolId: CommonUuid;
     };
     query?: never;
@@ -7504,9 +6648,6 @@ type AgentProfilePoolMembersRemoveResponse = AgentProfilePoolMembersRemoveRespon
 type AgentProfilePoolMembersListData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent profile pool
-         */
         poolId: CommonUuid;
     };
     query?: {
@@ -7551,14 +6692,8 @@ type AgentProfilePoolMembersListResponses = {
 };
 type AgentProfilePoolMembersListResponse = AgentProfilePoolMembersListResponses[keyof AgentProfilePoolMembersListResponses];
 type AgentProfilePoolMembersAddData = {
-    /**
-     * Profile IDs to add
-     */
     body: AgentsProfileAddProfilesToPoolRequest;
     path: {
-        /**
-         * The ID of the agent profile pool
-         */
         poolId: CommonUuid;
     };
     query?: never;
@@ -7598,9 +6733,6 @@ type AgentProfilesListData = {
     body?: never;
     path?: never;
     query?: {
-        /**
-         * Filter by organization ID
-         */
         organizationId?: CommonUuid;
         pageSize?: number;
         page?: number;
@@ -7661,9 +6793,6 @@ type AgentProfilesListResponses = {
 };
 type AgentProfilesListResponse = AgentProfilesListResponses[keyof AgentProfilesListResponses];
 type AgentProfilesCreateData = {
-    /**
-     * Agent profile to create
-     */
     body: AgentsProfileCreateAgentProfileRequest;
     path?: never;
     query?: never;
@@ -7706,9 +6835,6 @@ type AgentProfilesCreateResponse = AgentProfilesCreateResponses[keyof AgentProfi
 type AgentProfileDeleteData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent profile
-         */
         profileId: CommonUuid;
     };
     query?: never;
@@ -7747,9 +6873,6 @@ type AgentProfileDeleteResponse = AgentProfileDeleteResponses[keyof AgentProfile
 type AgentProfileGetData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent profile
-         */
         profileId: CommonUuid;
     };
     query?: never;
@@ -7786,14 +6909,8 @@ type AgentProfileGetResponses = {
 };
 type AgentProfileGetResponse = AgentProfileGetResponses[keyof AgentProfileGetResponses];
 type AgentProfileUpdateData = {
-    /**
-     * Fields to update
-     */
     body: AgentsProfileUpdateAgentProfileRequest;
     path: {
-        /**
-         * The ID of the agent profile
-         */
         profileId: CommonUuid;
     };
     query?: never;
@@ -7836,9 +6953,6 @@ type AgentProfileUpdateResponse = AgentProfileUpdateResponses[keyof AgentProfile
 type AgentProfileClearBrowserCacheData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent profile
-         */
         profileId: CommonUuid;
     };
     query?: never;
@@ -7882,9 +6996,6 @@ type AgentProfileDuplicateData = {
      */
     body?: AgentsProfileDuplicateAgentProfileRequest;
     path: {
-        /**
-         * The ID of the agent profile to duplicate
-         */
         profileId: CommonUuid;
     };
     query?: never;
@@ -7923,15 +7034,9 @@ type AgentProfileDuplicateResponse = AgentProfileDuplicateResponses[keyof AgentP
 type AgentProfileGetInboxEmailsData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent profile
-         */
         profileId: CommonUuid;
     };
     query?: {
-        /**
-         * Maximum number of emails to return
-         */
         limit?: number;
     };
     url: "/agents/v2/agent-profiles/{profileId}/inbox-emails";
@@ -7969,9 +7074,6 @@ type AgentProfileGetInboxEmailsResponse = AgentProfileGetInboxEmailsResponses[ke
 type AgentProfileGetInboxEmailData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent profile
-         */
         profileId: CommonUuid;
         /**
          * The Resend email ID
@@ -8018,6 +7120,9 @@ type AgentListData = {
         organizationId?: CommonUuid;
         pageSize?: number;
         page?: number;
+        /**
+         * Return results whose name contains this text, case-insensitive.
+         */
         searchName?: string;
         sortField?: AgentsAgentSortField;
         sortDirection?: CommonSortDirection;
@@ -8130,9 +7235,6 @@ type AvailableToolsListResponse = AvailableToolsListResponses[keyof AvailableToo
 type AgentByIdDeleteData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent
-         */
         agentId: CommonUuid;
     };
     query?: never;
@@ -8171,9 +7273,6 @@ type AgentByIdDeleteResponse = AgentByIdDeleteResponses[keyof AgentByIdDeleteRes
 type AgentByIdUpdateData = {
     body: AgentsAgentUpdateRequest;
     path: {
-        /**
-         * The ID of the agent
-         */
         agentId: CommonUuid;
     };
     query?: never;
@@ -8213,14 +7312,8 @@ type AgentByIdUpdateResponses = {
     200: unknown;
 };
 type AgentExecutePostData = {
-    /**
-     * Execution request parameters
-     */
     body: AgentsAgentExecuteAgentRequest;
     path: {
-        /**
-         * The ID of the agent to execute
-         */
         agentId: CommonUuid;
     };
     query?: never;
@@ -8241,14 +7334,8 @@ type AgentExecutePostResponses = {
 };
 type AgentExecutePostResponse = AgentExecutePostResponses[keyof AgentExecutePostResponses];
 type AgentExecuteSyncPostData = {
-    /**
-     * Execution request parameters
-     */
     body: AgentsAgentExecuteAgentSyncRequest;
     path: {
-        /**
-         * The ID of the agent to execute
-         */
         agentId: CommonUuid;
     };
     query?: never;
@@ -8275,9 +7362,6 @@ type AgentExecuteSyncPostResponse = AgentExecuteSyncPostResponses[keyof AgentExe
 type AgentWorkflowHeadGetFilesData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent
-         */
         agentId: CommonUuid;
     };
     query?: {
@@ -8335,14 +7419,8 @@ type AgentWorkflowHeadGetFilesResponses = {
 };
 type AgentWorkflowHeadGetFilesResponse = AgentWorkflowHeadGetFilesResponses[keyof AgentWorkflowHeadGetFilesResponses];
 type AgentWorkflowHeadPatchFilesData = {
-    /**
-     * The file writes and deletes to apply
-     */
     body: AgentsWorkflowWorkflowFilesPatchRequest;
     path: {
-        /**
-         * The ID of the agent
-         */
         agentId: CommonUuid;
     };
     query?: never;
@@ -8385,9 +7463,6 @@ type AgentWorkflowHeadPatchFilesResponse = AgentWorkflowHeadPatchFilesResponses[
 type AgentWorkflowHeadPublishHeadData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent
-         */
         agentId: CommonUuid;
     };
     query?: never;
@@ -8426,9 +7501,6 @@ type AgentWorkflowHeadPublishHeadResponse = AgentWorkflowHeadPublishHeadResponse
 type AgentWorkflowsListData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent
-         */
         agentId: CommonUuid;
     };
     query?: never;
@@ -8465,14 +7537,8 @@ type AgentWorkflowsListResponses = {
 };
 type AgentWorkflowsListResponse = AgentWorkflowsListResponses[keyof AgentWorkflowsListResponses];
 type AgentWorkflowsCreateData = {
-    /**
-     * Workflow creation request
-     */
     body: AgentsWorkflowExternalCreateWorkflowRequest;
     path: {
-        /**
-         * The ID of the agent
-         */
         agentId: CommonUuid;
     };
     query?: never;
@@ -8509,14 +7575,8 @@ type AgentWorkflowsCreateResponses = {
 };
 type AgentWorkflowsCreateResponse = AgentWorkflowsCreateResponses[keyof AgentWorkflowsCreateResponses];
 type AgentWorkflowsValidateData = {
-    /**
-     * The workflow spec to validate
-     */
     body: AgentsWorkflowExternalCreateWorkflowRequest;
     path: {
-        /**
-         * The ID of the agent
-         */
         agentId: CommonUuid;
     };
     query?: never;
@@ -8555,13 +7615,7 @@ type AgentWorkflowsValidateResponse = AgentWorkflowsValidateResponses[keyof Agen
 type AgentWorkflowsDeleteWorkflowData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent
-         */
         agentId: CommonUuid;
-        /**
-         * The ID of the workflow to delete
-         */
         workflowId: CommonUuid;
     };
     query?: never;
@@ -8600,13 +7654,7 @@ type AgentWorkflowsDeleteWorkflowResponse = AgentWorkflowsDeleteWorkflowResponse
 type AgentWorkflowsGetData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent
-         */
         agentId: CommonUuid;
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
     };
     query?: never;
@@ -8643,18 +7691,9 @@ type AgentWorkflowsGetResponses = {
 };
 type AgentWorkflowsGetResponse = AgentWorkflowsGetResponses[keyof AgentWorkflowsGetResponses];
 type AgentWorkflowsExecuteData = {
-    /**
-     * Execution request parameters
-     */
     body: AgentsWorkflowExecuteWorkflowRequest;
     path: {
-        /**
-         * The ID of the agent
-         */
         agentId: CommonUuid;
-        /**
-         * The ID of the workflow to execute
-         */
         workflowId: CommonUuid;
     };
     query?: never;
@@ -8697,13 +7736,7 @@ type AgentWorkflowsExecuteResponse = AgentWorkflowsExecuteResponses[keyof AgentW
 type AgentWorkflowsGetFilesByVersionData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent
-         */
         agentId: CommonUuid;
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
     };
     query?: {
@@ -8763,13 +7796,7 @@ type AgentWorkflowsGetFilesByVersionResponse = AgentWorkflowsGetFilesByVersionRe
 type AgentWorkflowsGetInputsData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent
-         */
         agentId: CommonUuid;
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
     };
     query?: never;
@@ -8808,13 +7835,7 @@ type AgentWorkflowsGetInputsResponse = AgentWorkflowsGetInputsResponses[keyof Ag
 type AgentWorkflowsGetOutputSchemasData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent
-         */
         agentId: CommonUuid;
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
     };
     query?: never;
@@ -8853,13 +7874,7 @@ type AgentWorkflowsGetOutputSchemasResponse = AgentWorkflowsGetOutputSchemasResp
 type AgentWorkflowsPublishData = {
     body?: never;
     path: {
-        /**
-         * The ID of the agent
-         */
         agentId: CommonUuid;
-        /**
-         * The ID of the workflow to publish
-         */
         workflowId: CommonUuid;
     };
     query?: never;
@@ -8932,9 +7947,6 @@ type ContextGetResponses = {
 };
 type ContextGetResponse = ContextGetResponses[keyof ContextGetResponses];
 type DocsSearchSearchData = {
-    /**
-     * The search request
-     */
     body: AgentsDocsSearchDocsRequest;
     path?: never;
     query?: never;
@@ -9000,13 +8012,7 @@ type ExecutionsListData = {
          * Filter by execution status (can specify multiple, there is an 'OR' condition applied to these)
          */
         status?: Array<AgentsExecutionStatus>;
-        /**
-         * Filter executions created after this timestamp
-         */
         createdAfter?: string;
-        /**
-         * Filter executions created before this timestamp
-         */
         createdBefore?: string;
         /**
          * Filter by human labels (can specify multiple label IDs, there is an 'OR' condition applied to these)
@@ -9032,13 +8038,7 @@ type ExecutionsListData = {
          * Filter by input variable value (partial, case-insensitive match) - must be used together with inputsKey
          */
         inputsValue?: string;
-        /**
-         * Filter by workflow version number
-         */
         workflowVersion?: number;
-        /**
-         * Filter by whether the execution recorded any script failures
-         */
         hasScriptFailures?: boolean;
         /**
          * Filter by how the execution was triggered (can specify multiple, there is an 'OR' condition applied to these)
@@ -9050,9 +8050,6 @@ type ExecutionsListData = {
         phase?: Array<AgentsExecutionPhase>;
         sortField?: AgentsExecutionSortField;
         sortDirection?: CommonSortDirection;
-        /**
-         * Filter by workflow ID
-         */
         workflowId?: CommonUuid;
         /**
          * Filter executions created within this long before now: number-unit pairs with units w, d, h, m, longest first, e.g. 30m, 24h, 7d, 1d12h. Maximum 10 years. Cannot be combined with createdAfter
@@ -9111,9 +8108,6 @@ type ExecutionsListResponse = ExecutionsListResponses[keyof ExecutionsListRespon
 type ExecutionGetData = {
     body?: never;
     path: {
-        /**
-         * The unique identifier of the execution
-         */
         executionId: CommonUuid;
     };
     query?: never;
@@ -9152,9 +8146,6 @@ type ExecutionGetResponse = ExecutionGetResponses[keyof ExecutionGetResponses];
 type ExecutionActivitiesGetData = {
     body?: never;
     path: {
-        /**
-         * The unique identifier of the execution
-         */
         executionId: CommonUuid;
     };
     query?: {
@@ -9162,9 +8153,6 @@ type ExecutionActivitiesGetData = {
          * Sort order for activities by timestamp
          */
         order?: "asc" | "desc";
-        /**
-         * Maximum number of activities to return
-         */
         limit?: number;
     };
     url: "/agents/v2/executions/{executionId}/activities";
@@ -9240,9 +8228,6 @@ type ExecutionAgentFileDownloadRedirectError = ExecutionAgentFileDownloadRedirec
 type ExecutionCancelData = {
     body?: never;
     path: {
-        /**
-         * The unique identifier of the execution
-         */
         executionId: CommonUuid;
     };
     query?: never;
@@ -9401,9 +8386,6 @@ type ExecutionFileDownloadRedirectError = ExecutionFileDownloadRedirectErrors[ke
 type ExecutionPauseData = {
     body?: never;
     path: {
-        /**
-         * The unique identifier of the execution
-         */
         executionId: CommonUuid;
     };
     query?: never;
@@ -9442,9 +8424,6 @@ type ExecutionPauseResponse = ExecutionPauseResponses[keyof ExecutionPauseRespon
 type ExecutionRecordingRedirectData = {
     body?: never;
     path: {
-        /**
-         * The unique identifier of the execution
-         */
         executionId: CommonUuid;
     };
     query?: {
@@ -9484,9 +8463,6 @@ type ExecutionRerunData = {
      */
     body?: AgentsExecutionRerunExecutionRequest;
     path: {
-        /**
-         * The unique identifier of the execution to rerun
-         */
         executionId: CommonUuid;
     };
     query?: never;
@@ -9529,9 +8505,6 @@ type ExecutionRerunResponse = ExecutionRerunResponses[keyof ExecutionRerunRespon
 type ExecutionResumeData = {
     body?: never;
     path: {
-        /**
-         * The unique identifier of the execution
-         */
         executionId: CommonUuid;
     };
     query?: never;
@@ -9568,14 +8541,8 @@ type ExecutionResumeResponses = {
 };
 type ExecutionResumeResponse = ExecutionResumeResponses[keyof ExecutionResumeResponses];
 type ExecutionStatusUpdateData = {
-    /**
-     * The status update request
-     */
     body: AgentsExecutionUpdateExecutionStatusRequest;
     path: {
-        /**
-         * The unique identifier of the execution
-         */
         executionId: CommonUuid;
     };
     query?: never;
@@ -9612,14 +8579,8 @@ type ExecutionStatusUpdateResponses = {
 };
 type ExecutionStatusUpdateResponse = ExecutionStatusUpdateResponses[keyof ExecutionStatusUpdateResponses];
 type ExecutionUserMessagesAddData = {
-    /**
-     * The message content to send
-     */
     body: AgentsExecutionUserMessagesAddTextBody;
     path: {
-        /**
-         * The unique identifier of the execution
-         */
         executionId: CommonUuid;
     };
     query?: never;
@@ -9659,9 +8620,6 @@ type ProfileGroupsListData = {
     body?: never;
     path?: never;
     query?: {
-        /**
-         * Filter by organization ID
-         */
         organizationId?: CommonUuid;
         pageSize?: number;
         page?: number;
@@ -9710,9 +8668,6 @@ type ProfileGroupsListResponses = {
 };
 type ProfileGroupsListResponse = ProfileGroupsListResponses[keyof ProfileGroupsListResponses];
 type ProfileGroupsCreateData = {
-    /**
-     * Profile group to create
-     */
     body: AgentsProfileCreateAgentProfilePoolRequest;
     path?: never;
     query?: never;
@@ -9751,9 +8706,6 @@ type ProfileGroupsCreateResponse = ProfileGroupsCreateResponses[keyof ProfileGro
 type ProfileGroupDeleteData = {
     body?: never;
     path: {
-        /**
-         * The ID of the profile group
-         */
         groupId: CommonUuid;
     };
     query?: never;
@@ -9792,9 +8744,6 @@ type ProfileGroupDeleteResponse = ProfileGroupDeleteResponses[keyof ProfileGroup
 type ProfileGroupGetData = {
     body?: never;
     path: {
-        /**
-         * The ID of the profile group
-         */
         groupId: CommonUuid;
     };
     query?: never;
@@ -9831,14 +8780,8 @@ type ProfileGroupGetResponses = {
 };
 type ProfileGroupGetResponse = ProfileGroupGetResponses[keyof ProfileGroupGetResponses];
 type ProfileGroupUpdateData = {
-    /**
-     * Fields to update
-     */
     body: AgentsProfileUpdateAgentProfilePoolRequest;
     path: {
-        /**
-         * The ID of the profile group
-         */
         groupId: CommonUuid;
     };
     query?: never;
@@ -9875,14 +8818,8 @@ type ProfileGroupUpdateResponses = {
 };
 type ProfileGroupUpdateResponse = ProfileGroupUpdateResponses[keyof ProfileGroupUpdateResponses];
 type ProfileGroupMembersRemoveData = {
-    /**
-     * Profile IDs to remove
-     */
     body: AgentsProfileRemoveProfilesFromPoolRequest;
     path: {
-        /**
-         * The ID of the profile group
-         */
         groupId: CommonUuid;
     };
     query?: never;
@@ -9921,9 +8858,6 @@ type ProfileGroupMembersRemoveResponse = ProfileGroupMembersRemoveResponses[keyo
 type ProfileGroupMembersListData = {
     body?: never;
     path: {
-        /**
-         * The ID of the profile group
-         */
         groupId: CommonUuid;
     };
     query?: {
@@ -9968,14 +8902,8 @@ type ProfileGroupMembersListResponses = {
 };
 type ProfileGroupMembersListResponse = ProfileGroupMembersListResponses[keyof ProfileGroupMembersListResponses];
 type ProfileGroupMembersAddData = {
-    /**
-     * Profile IDs to add
-     */
     body: AgentsProfileAddProfilesToPoolRequest;
     path: {
-        /**
-         * The ID of the profile group
-         */
         groupId: CommonUuid;
     };
     query?: never;
@@ -10015,9 +8943,6 @@ type ProfilesListData = {
     body?: never;
     path?: never;
     query?: {
-        /**
-         * Filter by organization ID
-         */
         organizationId?: CommonUuid;
         pageSize?: number;
         page?: number;
@@ -10078,9 +9003,6 @@ type ProfilesListResponses = {
 };
 type ProfilesListResponse = ProfilesListResponses[keyof ProfilesListResponses];
 type ProfilesCreateData = {
-    /**
-     * Profile to create
-     */
     body: AgentsProfileCreateAgentProfileRequest;
     path?: never;
     query?: never;
@@ -10123,9 +9045,6 @@ type ProfilesCreateResponse = ProfilesCreateResponses[keyof ProfilesCreateRespon
 type ProfileDeleteData = {
     body?: never;
     path: {
-        /**
-         * The ID of the profile
-         */
         profileId: CommonUuid;
     };
     query?: never;
@@ -10164,9 +9083,6 @@ type ProfileDeleteResponse = ProfileDeleteResponses[keyof ProfileDeleteResponses
 type ProfileGetData = {
     body?: never;
     path: {
-        /**
-         * The ID of the profile
-         */
         profileId: CommonUuid;
     };
     query?: never;
@@ -10203,14 +9119,8 @@ type ProfileGetResponses = {
 };
 type ProfileGetResponse = ProfileGetResponses[keyof ProfileGetResponses];
 type ProfileUpdateData = {
-    /**
-     * Fields to update
-     */
     body: AgentsProfileUpdateAgentProfileRequest;
     path: {
-        /**
-         * The ID of the profile
-         */
         profileId: CommonUuid;
     };
     query?: never;
@@ -10253,9 +9163,6 @@ type ProfileUpdateResponse = ProfileUpdateResponses[keyof ProfileUpdateResponses
 type ProfileClearBrowserCacheData = {
     body?: never;
     path: {
-        /**
-         * The ID of the profile
-         */
         profileId: CommonUuid;
     };
     query?: never;
@@ -10299,9 +9206,6 @@ type ProfileDuplicateData = {
      */
     body?: AgentsProfileDuplicateAgentProfileRequest;
     path: {
-        /**
-         * The ID of the profile to duplicate
-         */
         profileId: CommonUuid;
     };
     query?: never;
@@ -10340,15 +9244,9 @@ type ProfileDuplicateResponse = ProfileDuplicateResponses[keyof ProfileDuplicate
 type ProfileGetInboxEmailsData = {
     body?: never;
     path: {
-        /**
-         * The ID of the profile
-         */
         profileId: CommonUuid;
     };
     query?: {
-        /**
-         * Maximum number of emails to return
-         */
         limit?: number;
     };
     url: "/agents/v2/profiles/{profileId}/inbox-emails";
@@ -10386,9 +9284,6 @@ type ProfileGetInboxEmailsResponse = ProfileGetInboxEmailsResponses[keyof Profil
 type ProfileGetInboxEmailData = {
     body?: never;
     path: {
-        /**
-         * The ID of the profile
-         */
         profileId: CommonUuid;
         /**
          * The Resend email ID
@@ -10429,9 +9324,6 @@ type ProfileGetInboxEmailResponses = {
 };
 type ProfileGetInboxEmailResponse = ProfileGetInboxEmailResponses[keyof ProfileGetInboxEmailResponses];
 type SchemaValidationValidateData = {
-    /**
-     * The schema to validate
-     */
     body: AgentsSchemaValidateSchemaRequest;
     path?: never;
     query?: never;
@@ -10893,6 +9785,9 @@ type SecretsListResponse = SecretsListResponses[keyof SecretsListResponses];
 type SecretsCreateData = {
     body: AgentsVaultCreateVaultItemRequest;
     headers?: {
+        /**
+         * A key unique within the organization. Reusing it returns the secret already created with that key instead of creating a second one.
+         */
         "Idempotency-Key"?: string;
     };
     path?: never;
@@ -11101,6 +9996,9 @@ type SecretFieldDeleteData = {
     body?: never;
     path: {
         secretId: CommonUuid;
+        /**
+         * The field's key, in UPPER_SNAKE case.
+         */
         fieldKey: AgentsVaultFieldKey;
     };
     query?: never;
@@ -12018,9 +10916,15 @@ type WorkflowListData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * The organization. Defaults to the one organization the caller acts in, such as an API key's. Required when the caller belongs to several.
+         */
         organizationId?: CommonUuid;
         pageSize?: number;
         page?: number;
+        /**
+         * Return results whose name contains this text, case-insensitive.
+         */
         searchName?: string;
         sortField?: AgentsAgentSortField;
         sortDirection?: CommonSortDirection;
@@ -12143,9 +11047,6 @@ type WorkflowAvailableToolsListResponses = {
 };
 type WorkflowAvailableToolsListResponse = WorkflowAvailableToolsListResponses[keyof WorkflowAvailableToolsListResponses];
 type WorkflowSpecValidationValidateData = {
-    /**
-     * The workflow spec to validate
-     */
     body: AgentsWorkflowExternalCreateWorkflowRequest;
     path?: never;
     query?: never;
@@ -12184,9 +11085,6 @@ type WorkflowSpecValidationValidateResponse = WorkflowSpecValidationValidateResp
 type WorkflowByIdDeleteData = {
     body?: never;
     path: {
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
     };
     query?: never;
@@ -12225,9 +11123,6 @@ type WorkflowByIdDeleteResponse = WorkflowByIdDeleteResponses[keyof WorkflowById
 type WorkflowByIdUpdateData = {
     body: WorkflowsWorkflowUpdateRequest;
     path: {
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
     };
     query?: never;
@@ -12267,14 +11162,8 @@ type WorkflowByIdUpdateResponses = {
     200: unknown;
 };
 type WorkflowExecutePostData = {
-    /**
-     * Execution request parameters
-     */
     body: WorkflowsWorkflowExecuteRequest;
     path: {
-        /**
-         * The ID of the workflow to execute
-         */
         workflowId: CommonUuid;
     };
     query?: never;
@@ -12295,14 +11184,8 @@ type WorkflowExecutePostResponses = {
 };
 type WorkflowExecutePostResponse = WorkflowExecutePostResponses[keyof WorkflowExecutePostResponses];
 type WorkflowExecuteSyncPostData = {
-    /**
-     * Execution request parameters
-     */
     body: WorkflowsWorkflowExecuteSyncRequest;
     path: {
-        /**
-         * The ID of the workflow to execute
-         */
         workflowId: CommonUuid;
     };
     query?: never;
@@ -12329,9 +11212,6 @@ type WorkflowExecuteSyncPostResponse = WorkflowExecuteSyncPostResponses[keyof Wo
 type WorkflowHeadGetFilesData = {
     body?: never;
     path: {
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
     };
     query?: {
@@ -12389,14 +11269,8 @@ type WorkflowHeadGetFilesResponses = {
 };
 type WorkflowHeadGetFilesResponse = WorkflowHeadGetFilesResponses[keyof WorkflowHeadGetFilesResponses];
 type WorkflowHeadPatchFilesData = {
-    /**
-     * The file writes and deletes to apply
-     */
     body: WorkflowsVersionFilesPatchRequest;
     path: {
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
     };
     query?: never;
@@ -12439,9 +11313,6 @@ type WorkflowHeadPatchFilesResponse = WorkflowHeadPatchFilesResponses[keyof Work
 type WorkflowHeadPublishData = {
     body?: never;
     path: {
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
     };
     query?: never;
@@ -12480,9 +11351,6 @@ type WorkflowHeadPublishResponse = WorkflowHeadPublishResponses[keyof WorkflowHe
 type WorkflowVersionsListData = {
     body?: never;
     path: {
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
     };
     query?: never;
@@ -12519,14 +11387,8 @@ type WorkflowVersionsListResponses = {
 };
 type WorkflowVersionsListResponse = WorkflowVersionsListResponses[keyof WorkflowVersionsListResponses];
 type WorkflowVersionsCreateData = {
-    /**
-     * Version creation request
-     */
     body: WorkflowsVersionCreateRequest;
     path: {
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
     };
     query?: never;
@@ -12563,14 +11425,8 @@ type WorkflowVersionsCreateResponses = {
 };
 type WorkflowVersionsCreateResponse = WorkflowVersionsCreateResponses[keyof WorkflowVersionsCreateResponses];
 type WorkflowVersionsValidateData = {
-    /**
-     * The version spec to validate
-     */
     body: WorkflowsVersionCreateRequest;
     path: {
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
     };
     query?: never;
@@ -12609,13 +11465,7 @@ type WorkflowVersionsValidateResponse = WorkflowVersionsValidateResponses[keyof
 type WorkflowVersionsDeleteData = {
     body?: never;
     path: {
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
-        /**
-         * The ID of the version to delete
-         */
         versionId: CommonUuid;
     };
     query?: never;
@@ -12654,13 +11504,7 @@ type WorkflowVersionsDeleteResponse = WorkflowVersionsDeleteResponses[keyof Work
 type WorkflowVersionsGetData = {
     body?: never;
     path: {
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
-        /**
-         * The ID of the version
-         */
         versionId: CommonUuid;
     };
     query?: never;
@@ -12697,18 +11541,9 @@ type WorkflowVersionsGetResponses = {
 };
 type WorkflowVersionsGetResponse = WorkflowVersionsGetResponses[keyof WorkflowVersionsGetResponses];
 type WorkflowVersionsExecuteData = {
-    /**
-     * Execution request parameters
-     */
     body: WorkflowsVersionExecuteRequest;
     path: {
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
-        /**
-         * The ID of the version to execute
-         */
         versionId: CommonUuid;
     };
     query?: never;
@@ -12751,13 +11586,7 @@ type WorkflowVersionsExecuteResponse = WorkflowVersionsExecuteResponses[keyof Wo
 type WorkflowVersionsGetFilesData = {
     body?: never;
     path: {
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
-        /**
-         * The ID of the version
-         */
         versionId: CommonUuid;
     };
     query?: {
@@ -12817,13 +11646,7 @@ type WorkflowVersionsGetFilesResponse = WorkflowVersionsGetFilesResponses[keyof
 type WorkflowVersionsGetInputsData = {
     body?: never;
     path: {
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
-        /**
-         * The ID of the version
-         */
         versionId: CommonUuid;
     };
     query?: never;
@@ -12862,13 +11685,7 @@ type WorkflowVersionsGetInputsResponse = WorkflowVersionsGetInputsResponses[keyo
 type WorkflowVersionsGetOutputSchemasData = {
     body?: never;
     path: {
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
-        /**
-         * The ID of the version
-         */
         versionId: CommonUuid;
     };
     query?: never;
@@ -12907,13 +11724,7 @@ type WorkflowVersionsGetOutputSchemasResponse = WorkflowVersionsGetOutputSchemas
 type WorkflowVersionsPublishData = {
     body?: never;
     path: {
-        /**
-         * The ID of the workflow
-         */
         workflowId: CommonUuid;
-        /**
-         * The ID of the version to publish
-         */
         versionId: CommonUuid;
     };
     query?: never;