diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 6bf0293..d419563 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
{
- ".": "1.0.0-alpha.1"
+ ".": "1.0.0-alpha.2"
}
diff --git a/.stats.yml b/.stats.yml
index 7759d9b..440c077 100644
--- a/.stats.yml
+++ b/.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
diff --git a/CHANGELOG.md b/CHANGELOG.md
index c302b6b..8bd4361 100644
--- a/CHANGELOG.md
+++ b/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)
diff --git a/api.md b/api.md
index bbf7e8c..2cd83c2 100644
--- a/api.md
+++ b/api.md
@@ -2,10 +2,11 @@
Types:
+- AgentSkill
- AmbientAgentConfig
- CloudEnvironmentConfig
- McpServerConfig
-- RunCreatorInfo
+- UserProfile
- AgentListResponse
- AgentRunResponse
diff --git a/package.json b/package.json
index 7f15278..37ffbcd 100644
--- a/package.json
+++ b/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",
diff --git a/src/client.ts b/src/client.ts
index ccacd81..ba8239d 100644
--- a/src/client.ts
+++ b/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,
diff --git a/src/resources/agent/agent.ts b/src/resources/agent/agent.ts
index bd993c4..b216091 100644
--- a/src/resources/agent/agent.ts
+++ b/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;
+}
+
+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;
+
+ 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;
-}
-
-export namespace AgentListResponse {
- export interface Agent {
- /**
- * Human-readable name of the agent
- */
- name: string;
-
- /**
- * Available variants of this agent
- */
- variants: Array;
- }
-
- 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;
-
- 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;
}
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,
diff --git a/src/resources/agent/index.ts b/src/resources/agent/index.ts
index b0de51a..836d198 100644
--- a/src/resources/agent/index.ts
+++ b/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,
diff --git a/src/resources/agent/runs.ts b/src/resources/agent/runs.ts
index 60d03e0..da277c2 100644
--- a/src/resources/agent/runs.ts
+++ b/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;
+
+ /**
+ * Filter runs updated after this timestamp (RFC3339 format)
+ */
+ updated_after?: string;
}
export declare namespace Runs {
diff --git a/src/resources/agent/schedules.ts b/src/resources/agent/schedules.ts
index d94e58c..aca3397 100644
--- a/src/resources/agent/schedules.ts
+++ b/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 {
diff --git a/src/resources/index.ts b/src/resources/index.ts
index 2451ba5..82cdcf6 100644
--- a/src/resources/index.ts
+++ b/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,
diff --git a/src/version.ts b/src/version.ts
index 622c028..de96d7a 100644
--- a/src/version.ts
+++ b/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
diff --git a/tests/api-resources/agent/runs.test.ts b/tests/api-resources/agent/runs.test.ts
index 2a52707..de20a8d 100644
--- a/tests/api-resources/agent/runs.test.ts
+++ b/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' },
),