feat(api): add models for agent skill, user profile

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 12
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-3ee19d97da1711b8dfcba85f38c3c345fa96aaf78ea7f025e1ae490d17e97517.yml
 openapi_spec_hash: 2d03e7a248b1be5bd5600b62912cdab8
-config_hash: 9db55bfa03e8dd5e251342bd7491408c
+config_hash: 07820b17df23cbea39cb77fa05292538

api.md

@@ -2,10 +2,11 @@
 
 Types:
 
+- <code><a href="./src/resources/agent/agent.ts">AgentSkill</a></code>
 - <code><a href="./src/resources/agent/agent.ts">AmbientAgentConfig</a></code>
 - <code><a href="./src/resources/agent/agent.ts">CloudEnvironmentConfig</a></code>
 - <code><a href="./src/resources/agent/agent.ts">McpServerConfig</a></code>
-- <code><a href="./src/resources/agent/agent.ts">RunCreatorInfo</a></code>
+- <code><a href="./src/resources/agent/agent.ts">UserProfile</a></code>
 - <code><a href="./src/resources/agent/agent.ts">AgentListResponse</a></code>
 - <code><a href="./src/resources/agent/agent.ts">AgentRunResponse</a></code>
 

src/client.ts

@@ -23,10 +23,11 @@ import {
   AgentListResponse,
   AgentRunParams,
   AgentRunResponse,
+  AgentSkill,
   AmbientAgentConfig,
   CloudEnvironmentConfig,
   McpServerConfig,
-  RunCreatorInfo,
+  UserProfile,
 } from './resources/agent/agent';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
@@ -721,10 +722,11 @@ export declare namespace WarpAPI {
 
   export {
     Agent as Agent,
+    type AgentSkill as AgentSkill,
     type AmbientAgentConfig as AmbientAgentConfig,
     type CloudEnvironmentConfig as CloudEnvironmentConfig,
     type McpServerConfig as McpServerConfig,
-    type RunCreatorInfo as RunCreatorInfo,
+    type UserProfile as UserProfile,
     type AgentListResponse as AgentListResponse,
     type AgentRunResponse as AgentRunResponse,
     type AgentListParams as AgentListParams,

src/resources/agent/agent.ts

@@ -60,6 +60,76 @@ export class Agent extends APIResource {
   }
 }
 
+export interface AgentSkill {
+  /**
+   * Human-readable name of the agent
+   */
+  name: string;
+
+  /**
+   * Available variants of this agent
+   */
+  variants: Array<AgentSkill.Variant>;
+}
+
+export namespace AgentSkill {
+  export interface Variant {
+    /**
+     * Stable identifier for this skill variant. Format: "{owner}/{repo}:{skill_path}"
+     * Example: "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md"
+     */
+    id: string;
+
+    /**
+     * Base prompt/instructions for the agent
+     */
+    base_prompt: string;
+
+    /**
+     * Description of the agent variant
+     */
+    description: string;
+
+    /**
+     * Environments where this agent variant is available
+     */
+    environments: Array<Variant.Environment>;
+
+    source: Variant.Source;
+  }
+
+  export namespace Variant {
+    export interface Environment {
+      /**
+       * Human-readable name of the environment
+       */
+      name: string;
+
+      /**
+       * Unique identifier for the environment
+       */
+      uid: string;
+    }
+
+    export interface Source {
+      /**
+       * GitHub repository name
+       */
+      name: string;
+
+      /**
+       * GitHub repository owner
+       */
+      owner: string;
+
+      /**
+       * Path to the skill definition file within the repository
+       */
+      skill_path: string;
+    }
+  }
+}
+
 /**
  * Configuration for an ambient agent run
  */
@@ -184,7 +254,7 @@ export interface McpServerConfig {
   warp_id?: string;
 }
 
-export interface RunCreatorInfo {
+export interface UserProfile {
   /**
    * Display name of the creator
    */
@@ -210,79 +280,7 @@ export interface AgentListResponse {
   /**
    * List of available agents
    */
-  agents: Array<AgentListResponse.Agent>;
-}
-
-export namespace AgentListResponse {
-  export interface Agent {
-    /**
-     * Human-readable name of the agent
-     */
-    name: string;
-
-    /**
-     * Available variants of this agent
-     */
-    variants: Array<Agent.Variant>;
-  }
-
-  export namespace Agent {
-    export interface Variant {
-      /**
-       * Stable identifier for this skill variant. Format: "{owner}/{repo}:{skill_path}"
-       * Example: "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md"
-       */
-      id: string;
-
-      /**
-       * Base prompt/instructions for the agent
-       */
-      base_prompt: string;
-
-      /**
-       * Description of the agent variant
-       */
-      description: string;
-
-      /**
-       * Environments where this agent variant is available
-       */
-      environments: Array<Variant.Environment>;
-
-      source: Variant.Source;
-    }
-
-    export namespace Variant {
-      export interface Environment {
-        /**
-         * Human-readable name of the environment
-         */
-        name: string;
-
-        /**
-         * Unique identifier for the environment
-         */
-        uid: string;
-      }
-
-      export interface Source {
-        /**
-         * GitHub repository name
-         */
-        name: string;
-
-        /**
-         * GitHub repository owner
-         */
-        owner: string;
-
-        /**
-         * Path to the skill definition file within the repository
-         */
-        skill_path: string;
-      }
-    }
-  }
+  agents: Array<AgentSkill>;
 }
 
 export interface AgentRunResponse {
@@ -339,10 +337,11 @@ Agent.Schedules = Schedules;
 
 export declare namespace Agent {
   export {
+    type AgentSkill as AgentSkill,
     type AmbientAgentConfig as AmbientAgentConfig,
     type CloudEnvironmentConfig as CloudEnvironmentConfig,
     type McpServerConfig as McpServerConfig,
-    type RunCreatorInfo as RunCreatorInfo,
+    type UserProfile as UserProfile,
     type AgentListResponse as AgentListResponse,
     type AgentRunResponse as AgentRunResponse,
     type AgentListParams as AgentListParams,

src/resources/agent/index.ts

@@ -2,10 +2,11 @@
 
 export {
   Agent,
+  type AgentSkill,
   type AmbientAgentConfig,
   type CloudEnvironmentConfig,
   type McpServerConfig,
-  type RunCreatorInfo,
+  type UserProfile,
   type AgentListResponse,
   type AgentRunResponse,
   type AgentListParams,

src/resources/agent/runs.ts

@@ -170,7 +170,7 @@ export interface RunItem {
    */
   conversation_id?: string;
 
-  creator?: AgentAPI.RunCreatorInfo;
+  creator?: AgentAPI.UserProfile;
 
   /**
    * Whether the sandbox environment is currently running

src/resources/agent/schedules.ts

@@ -162,7 +162,7 @@ export interface ScheduledAgentItem {
    */
   agent_config?: AgentAPI.AmbientAgentConfig;
 
-  created_by?: AgentAPI.RunCreatorInfo;
+  created_by?: AgentAPI.UserProfile;
 
   /**
    * Configuration for a cloud environment used by scheduled agents
@@ -179,7 +179,7 @@ export interface ScheduledAgentItem {
    */
   last_spawn_error?: string | null;
 
-  updated_by?: AgentAPI.RunCreatorInfo;
+  updated_by?: AgentAPI.UserProfile;
 }
 
 export namespace ScheduledAgentItem {

src/resources/index.ts

@@ -2,10 +2,11 @@
 
 export {
   Agent,
+  type AgentSkill,
   type AmbientAgentConfig,
   type CloudEnvironmentConfig,
   type McpServerConfig,
-  type RunCreatorInfo,
+  type UserProfile,
   type AgentListResponse,
   type AgentRunResponse,
   type AgentListParams,