feat: [APP-3106] Specs: Explicit QueryMode for cloud agent run creation

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-8eb8e46de29b887cbcb25b90fec55d34e11ff82b174b7a5c1d1ce4ba4d7c2fb4.yml
-openapi_spec_hash: a071b7c932453dc870e7e6cf39df0535
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-f4c3bab952ad19ea9d246794add1bda6d3911eb32d8372f0d7271b52267b6d0b.yml
+openapi_spec_hash: 9fd38bfc2e640fb456258f50fccacf88
 config_hash: c15534df6c8d861059e44d9dd5483b3f

src/resources/agent/agent.ts

@@ -1010,6 +1010,13 @@ export interface AgentRunParams {
    */
   interactive?: boolean;
 
+  /**
+   * Optional query mode for the run. Defaults to `normal` when omitted. The server
+   * does not infer mode from prompt prefixes such as `/plan`, so callers should pass
+   * this field explicitly to request non-normal behavior.
+   */
+  mode?: 'normal' | 'plan' | 'orchestrate';
+
   /**
    * Optional run ID of the parent that spawned this run. Used for orchestration
    * hierarchies.

src/resources/agent/runs.ts

@@ -731,6 +731,12 @@ export interface RunSubmitFollowupParams {
    * The follow-up message to send to the run.
    */
   message: string;
+
+  /**
+   * Optional query mode for the follow-up. Defaults to `normal` when omitted. The
+   * server does not infer mode from prompt prefixes such as `/plan`.
+   */
+  mode?: 'normal' | 'plan' | 'orchestrate';
 }
 
 export declare namespace Runs {

src/resources/agent/schedules.ts

@@ -245,6 +245,12 @@ export interface ScheduleCreateParams {
    */
   enabled?: boolean;
 
+  /**
+   * Optional query mode applied to every triggered run. Defaults to `normal` when
+   * omitted. The server does not infer mode from prompt prefixes such as `/plan`.
+   */
+  mode?: 'normal' | 'plan' | 'orchestrate';
+
   /**
    * The prompt/instruction for the agent to execute. Required unless
    * agent_config.skill_spec is provided.
@@ -285,6 +291,12 @@ export interface ScheduleUpdateParams {
    */
   agent_uid?: string;
 
+  /**
+   * Optional query mode applied to every triggered run. Defaults to `normal` when
+   * omitted. The server does not infer mode from prompt prefixes such as `/plan`.
+   */
+  mode?: 'normal' | 'plan' | 'orchestrate';
+
   /**
    * The prompt/instruction for the agent to execute. Required unless
    * agent_config.skill_spec is provided.

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

@@ -103,6 +103,6 @@ describe('resource runs', () => {
 
   // Mock server tests are disabled
   test.skip('submitFollowup: required and optional params', async () => {
-    const response = await client.agent.runs.submitFollowup('runId', { message: 'message' });
+    const response = await client.agent.runs.submitFollowup('runId', { message: 'message', mode: 'normal' });
   });
 });

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

@@ -53,6 +53,7 @@ describe('resource schedules', () => {
       },
       agent_uid: 'agent_uid',
       enabled: true,
+      mode: 'normal',
       prompt: 'Review open pull requests and provide feedback',
       team: true,
     });
@@ -116,6 +117,7 @@ describe('resource schedules', () => {
         worker_host: 'worker_host',
       },
       agent_uid: 'agent_uid',
+      mode: 'normal',
       prompt: 'prompt',
     });
   });