feat: [REMOTE-1481] [3/N] Add executor filter to run list API

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%2Fwarp-api-f5a88aa4f1991447272228b7024ebfbec99d31706b8806058917a3f90dd39d00.yml
-openapi_spec_hash: 1952fae99172f1adaf35d800b0d63936
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-c115a70d043bb17e7591b51464aa8666f7124fb137334d422a4281b1d9ee373f.yml
+openapi_spec_hash: 66546de6547990d8367b531ab9e0302a
 config_hash: 44a1e8f98607a5cf03815a63bae63453

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/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',