feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 22
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-f5a88aa4f1991447272228b7024ebfbec99d31706b8806058917a3f90dd39d00.yml
-openapi_spec_hash: 1952fae99172f1adaf35d800b0d63936
-config_hash: 44a1e8f98607a5cf03815a63bae63453
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-8eb8e46de29b887cbcb25b90fec55d34e11ff82b174b7a5c1d1ce4ba4d7c2fb4.yml
+openapi_spec_hash: a071b7c932453dc870e7e6cf39df0535
+config_hash: c15534df6c8d861059e44d9dd5483b3f

src/resources/agent/agent.ts

@@ -300,8 +300,9 @@ export namespace AmbientAgentConfig {
      * - oz: Warp's built-in harness (default)
      * - claude: Claude Code harness
      * - gemini: Gemini CLI harness
+     * - codex: Codex CLI harness
      */
-    type?: 'oz' | 'claude' | 'gemini';
+    type?: 'oz' | 'claude' | 'gemini' | 'codex';
   }
 
   /**

src/resources/agent/agent_.ts

@@ -85,42 +85,201 @@ export interface AgentResponse {
    */
   name: string;
 
+  /**
+   * Secrets that this agent may access by default.
+   */
+  secrets: Array<AgentResponse.Secret>;
+
+  /**
+   * Ordered list of normalized skill specs associated with this agent. Always
+   * present; empty when no skills are attached.
+   */
+  skills: Array<string>;
+
   /**
    * Unique identifier for the agent
    */
   uid: string;
+
+  /**
+   * Optional description of the agent
+   */
+  description?: string | null;
+}
+
+export namespace AgentResponse {
+  /**
+   * Reference to a managed secret by name.
+   */
+  export interface Secret {
+    /**
+     * Name of the managed secret.
+     */
+    name: string;
+  }
 }
 
 export interface CreateAgentRequest {
   /**
    * A name for the agent
    */
   name: string;
+
+  /**
+   * Optional description of the agent
+   */
+  description?: string | null;
+
+  /**
+   * Optional list of secrets associated with the agent. Duplicate names within a
+   * single request are rejected.
+   */
+  secrets?: Array<CreateAgentRequest.Secret>;
+
+  /**
+   * Optional list of skill specs to associate with the agent. Format:
+   * "{owner}/{repo}:{skill_path}" (e.g.,
+   * "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md"). Each spec is validated
+   * and normalized at attach time using the team's GitHub credentials; inaccessible
+   * or malformed specs are rejected.
+   */
+  skills?: Array<string>;
+}
+
+export namespace CreateAgentRequest {
+  /**
+   * Reference to a managed secret by name.
+   */
+  export interface Secret {
+    /**
+     * Name of the managed secret.
+     */
+    name: string;
+  }
 }
 
 export interface ListAgentIdentitiesResponse {
   agents: Array<AgentResponse>;
 }
 
+/**
+ * Partial update for an agent. Each field is optional:
+ *
+ * - Omitted or `null`: leave the field unchanged.
+ * - Empty value: clear the field.
+ * - Non-empty: replace the field wholesale with the provided value.
+ */
 export interface UpdateAgentRequest {
+  /**
+   * Replacement description. Omit or pass `null` to leave unchanged, or use an empty
+   * value to clear.
+   */
+  description?: string | null;
+
   /**
    * The new name for the agent
    */
   name?: string;
+
+  /**
+   * Replacement list of secrets. Omit to leave unchanged, pass an empty array to
+   * clear, or pass a non-empty array to replace. Duplicate names are rejected.
+   */
+  secrets?: Array<UpdateAgentRequest.Secret> | null;
+
+  /**
+   * Replacement list of skill specs. Omit to leave unchanged, pass an empty array to
+   * clear, or pass a non-empty array to replace.
+   */
+  skills?: Array<string> | null;
+}
+
+export namespace UpdateAgentRequest {
+  /**
+   * Reference to a managed secret by name.
+   */
+  export interface Secret {
+    /**
+     * Name of the managed secret.
+     */
+    name: string;
+  }
 }
 
 export interface AgentCreateParams {
   /**
    * A name for the agent
    */
   name: string;
+
+  /**
+   * Optional description of the agent
+   */
+  description?: string | null;
+
+  /**
+   * Optional list of secrets associated with the agent. Duplicate names within a
+   * single request are rejected.
+   */
+  secrets?: Array<AgentCreateParams.Secret>;
+
+  /**
+   * Optional list of skill specs to associate with the agent. Format:
+   * "{owner}/{repo}:{skill_path}" (e.g.,
+   * "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md"). Each spec is validated
+   * and normalized at attach time using the team's GitHub credentials; inaccessible
+   * or malformed specs are rejected.
+   */
+  skills?: Array<string>;
+}
+
+export namespace AgentCreateParams {
+  /**
+   * Reference to a managed secret by name.
+   */
+  export interface Secret {
+    /**
+     * Name of the managed secret.
+     */
+    name: string;
+  }
 }
 
 export interface AgentUpdateParams {
+  /**
+   * Replacement description. Omit or pass `null` to leave unchanged, or use an empty
+   * value to clear.
+   */
+  description?: string | null;
+
   /**
    * The new name for the agent
    */
   name?: string;
+
+  /**
+   * Replacement list of secrets. Omit to leave unchanged, pass an empty array to
+   * clear, or pass a non-empty array to replace. Duplicate names are rejected.
+   */
+  secrets?: Array<AgentUpdateParams.Secret> | null;
+
+  /**
+   * Replacement list of skill specs. Omit to leave unchanged, pass an empty array to
+   * clear, or pass a non-empty array to replace.
+   */
+  skills?: Array<string> | null;
+}
+
+export namespace AgentUpdateParams {
+  /**
+   * Reference to a managed secret by name.
+   */
+  export interface Secret {
+    /**
+     * Name of the managed secret.
+     */
+    name: string;
+  }
 }
 
 export declare namespace Agent {

src/resources/agent/runs.ts

@@ -345,6 +345,8 @@ export interface RunItem {
    */
   execution_location?: 'LOCAL' | 'REMOTE';
 
+  executor?: AgentAPI.UserProfile;
+
   /**
    * Whether the sandbox environment is currently running
    */
@@ -655,6 +657,12 @@ export interface RunListParams extends RunsCursorPageParams {
    */
   execution_location?: 'LOCAL' | 'REMOTE';
 
+  /**
+   * Filter by the user or agent that executed the run. This will often be the same
+   * as the creator, but not always: users may delegate tasks to agents.
+   */
+  executor?: string;
+
   /**
    * Filter by model ID
    */

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

@@ -22,7 +22,12 @@ describe('resource agent', () => {
 
   // Mock server tests are disabled
   test.skip('create: required and optional params', async () => {
-    const response = await client.agent.agent.create({ name: 'name' });
+    const response = await client.agent.agent.create({
+      name: 'name',
+      description: 'description',
+      secrets: [{ name: 'name' }],
+      skills: ['string'],
+    });
   });
 
   // Mock server tests are disabled

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

@@ -46,6 +46,7 @@ describe('resource runs', () => {
           cursor: 'cursor',
           environment_id: 'environment_id',
           execution_location: 'LOCAL',
+          executor: 'executor',
           limit: 1,
           model_id: 'model_id',
           name: 'name',