feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 23
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-410e07a5c3a6e0ff043e5f414d501e171d4dd9f8c91b3404cd9e3e93afebae46.yml
-openapi_spec_hash: ab7a6a235e8b2484df1747c69a096ab0
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-4bc83c682f151e3779dabdac7cc9c83ec591510b4befc86a3b2995ccd6e61151.yml
+openapi_spec_hash: 35d33a8f98079873af81763e7381046e
 config_hash: 236823a4936c76818117c16aa5c188df

src/resources/agent/agent.ts

@@ -284,13 +284,23 @@ export interface AmbientAgentConfig {
   session_sharing?: AmbientAgentConfig.SessionSharing;
 
   /**
-   * Skill specification identifying which agent skill to use. Format:
+   * Skill specification identifying the primary agent skill to use. Format:
    * "{owner}/{repo}:{skill_path}" Example:
-   * "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md" Use the list agents
-   * endpoint to discover available skills.
+   * "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md" Mutually exclusive with
+   * skills in create/update requests. Responses include the first skills entry here
+   * for backward compatibility. Use the list agents endpoint to discover available
+   * skills.
    */
   skill_spec?: string;
 
+  /**
+   * Ordered skill specifications to attach to the run. Format:
+   * "{owner}/{repo}:{skill_path}" Example:
+   * "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md" Mutually exclusive with
+   * skill_spec in create/update requests.
+   */
+  skills?: Array<string>;
+
   /**
    * Self-hosted worker ID that should execute this task. If not specified or set to
    * "warp", the task runs on Warp-hosted workers.
@@ -1089,7 +1099,7 @@ export interface AgentRunParams {
 
   /**
    * The prompt/instruction for the agent to execute. Required unless a skill is
-   * specified via the skill field or config.skill_spec.
+   * specified via the skill field, config.skill_spec, or config.skills.
    */
   prompt?: string;
 

src/resources/agent/agent_.ts

@@ -146,6 +146,16 @@ export interface AgentResponse {
    */
   description?: string | null;
 
+  /**
+   * Default cloud environment ID for runs executed by this agent. The precedence
+   * order for environment resolution is:
+   *
+   * 1. The environment specified on the run itself
+   * 2. The agent's default environment
+   * 3. An empty environment
+   */
+  environment_id?: string;
+
   /**
    * Authentication secrets for third-party harnesses. Only the secret for the
    * harness specified gets injected into the environment.
@@ -263,6 +273,12 @@ export interface CreateAgentRequest {
    */
   description?: string | null;
 
+  /**
+   * Optional default cloud environment ID for runs executed by this agent. The
+   * environment must be owned by the same team as the agent.
+   */
+  environment_id?: string | null;
+
   /**
    * Authentication secrets for third-party harnesses. Only the secret for the
    * harness specified gets injected into the environment.
@@ -412,6 +428,12 @@ export interface UpdateAgentRequest {
    */
   description?: string | null;
 
+  /**
+   * Replacement default cloud environment ID. Omit or pass `null` to leave
+   * unchanged, or pass an empty string to clear.
+   */
+  environment_id?: string | null;
+
   /**
    * Authentication secrets for third-party harnesses. Only the secret for the
    * harness specified gets injected into the environment.
@@ -553,6 +575,12 @@ export interface AgentCreateParams {
    */
   description?: string | null;
 
+  /**
+   * Optional default cloud environment ID for runs executed by this agent. The
+   * environment must be owned by the same team as the agent.
+   */
+  environment_id?: string | null;
+
   /**
    * Authentication secrets for third-party harnesses. Only the secret for the
    * harness specified gets injected into the environment.
@@ -691,6 +719,12 @@ export interface AgentUpdateParams {
    */
   description?: string | null;
 
+  /**
+   * Replacement default cloud environment ID. Omit or pass `null` to leave
+   * unchanged, or pass an empty string to clear.
+   */
+  environment_id?: string | null;
+
   /**
    * Authentication secrets for third-party harnesses. Only the secret for the
    * harness specified gets injected into the environment.

src/resources/agent/schedules.ts

@@ -258,7 +258,7 @@ export interface ScheduleCreateParams {
 
   /**
    * The prompt/instruction for the agent to execute. Required unless
-   * agent_config.skill_spec is provided.
+   * agent_config.skill_spec or agent_config.skills is provided.
    */
   prompt?: string;
 
@@ -304,7 +304,7 @@ export interface ScheduleUpdateParams {
 
   /**
    * The prompt/instruction for the agent to execute. Required unless
-   * agent_config.skill_spec is provided.
+   * agent_config.skill_spec or agent_config.skills is provided.
    */
   prompt?: string;
 }

tests/api-resources/agent/agent_.test.ts

@@ -27,6 +27,7 @@ describe('resource agent', () => {
       base_harness: 'base_harness',
       base_model: 'base_model',
       description: 'description',
+      environment_id: 'environment_id',
       harness_auth_secrets: {
         claude_auth_secret_name: 'claude_auth_secret_name',
         codex_auth_secret_name: 'codex_auth_secret_name',

tests/api-resources/agent/schedules.test.ts

@@ -60,6 +60,7 @@ describe('resource schedules', () => {
         name: 'name',
         session_sharing: { public_access: 'VIEWER' },
         skill_spec: 'skill_spec',
+        skills: ['string'],
         worker_host: 'worker_host',
       },
       agent_uid: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
@@ -136,6 +137,7 @@ describe('resource schedules', () => {
         name: 'name',
         session_sharing: { public_access: 'VIEWER' },
         skill_spec: 'skill_spec',
+        skills: ['string'],
         worker_host: 'worker_host',
       },
       agent_uid: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',