release: 1.0.0-alpha.2

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.0.0-alpha.1"
+  ".": "1.0.0-alpha.2"
 }

.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
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-077b393072edf39858013851e3d539f3323ff77abbdcc98be663e67320cdd8c4.yml
+openapi_spec_hash: 4d140fc4f076fe917ed56e6033a948d8
+config_hash: 07820b17df23cbea39cb77fa05292538

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.0.0-alpha.2 (2026-02-04)
+
+Full Changelog: [v1.0.0-alpha.1...v1.0.0-alpha.2](https://github.com/warpdotdev/warp-sdk-typescript/compare/v1.0.0-alpha.1...v1.0.0-alpha.2)
+
+### Features
+
+* **api:** add addnl filters to runs endpoint ([b9e8309](https://github.com/warpdotdev/warp-sdk-typescript/commit/b9e8309221253b555c3d280c0bee086b578fcc23))
+* **api:** add models for agent skill, user profile ([d7275a8](https://github.com/warpdotdev/warp-sdk-typescript/commit/d7275a8224054c4f81a8aaeebfbe5c1dcfc4e3fd))
+
 ## 1.0.0-alpha.1 (2026-02-02)
 
 Full Changelog: [v1.0.0-alpha.0...v1.0.0-alpha.1](https://github.com/warpdotdev/warp-sdk-typescript/compare/v1.0.0-alpha.0...v1.0.0-alpha.1)

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>
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "warp-agent-sdk",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.2",
   "description": "The official TypeScript library for the Warp API API",
   "author": "Warp API <>",
   "types": "dist/index.d.ts",

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
@@ -323,7 +323,7 @@ export interface RunListParams {
   /**
    * Filter runs by environment ID
    */
-  environmentId?: string;
+  environment_id?: string;
 
   /**
    * Maximum number of runs to return
@@ -335,6 +335,16 @@ export interface RunListParams {
    */
   model_id?: string;
 
+  /**
+   * Filter runs by the scheduled agent ID that created them
+   */
+  schedule_id?: string;
+
+  /**
+   * Filter runs by skill spec (e.g., "owner/repo:path/to/SKILL.md")
+   */
+  skill_spec?: string;
+
   /**
    * Filter by run source type
    */
@@ -345,6 +355,11 @@ export interface RunListParams {
    * states.
    */
   state?: Array<RunState>;
+
+  /**
+   * Filter runs updated after this timestamp (RFC3339 format)
+   */
+  updated_after?: string;
 }
 
 export declare namespace Runs {

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,

src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.0.0-alpha.1'; // x-release-please-version
+export const VERSION = '1.0.0-alpha.2'; // x-release-please-version

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

@@ -43,11 +43,14 @@ describe('resource runs', () => {
           created_before: '2019-12-27T18:11:19.117Z',
           creator: 'creator',
           cursor: 'cursor',
-          environmentId: 'environmentId',
+          environment_id: 'environment_id',
           limit: 1,
           model_id: 'model_id',
+          schedule_id: 'schedule_id',
+          skill_spec: 'skill_spec',
           source: 'LINEAR',
           state: ['QUEUED'],
+          updated_after: '2019-12-27T18:11:19.117Z',
         },
         { path: '/_stainless_unknown_path' },
       ),