feat(api): api update

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-1fecc5f5d6ee664d804b81bd1aa6eec4d3f170ffa788d214fead4f7e95ab9d4e.yml
-openapi_spec_hash: 82990b03bd5a93e45bfc79db56ae7fc0
-config_hash: f52e7636f248f25c4ea0b086e7326816
+configured_endpoints: 23
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-e752e75a35d88b84870729ef94b0c32783172983420cbff1b204ca14375553f7.yml
+openapi_spec_hash: 34787afc1e1c84a643431a0f0eb352ae
+config_hash: 5a6e285f6e3a958a887b31b972a3f49c

api.md

@@ -79,6 +79,7 @@ Methods:
 - <code title="put /agent/identities/{uid}">client.agent.agent.<a href="./src/resources/agent/agent_.ts">update</a>(uid, { ...params }) -> AgentResponse</code>
 - <code title="get /agent/identities">client.agent.agent.<a href="./src/resources/agent/agent_.ts">list</a>() -> ListAgentIdentitiesResponse</code>
 - <code title="delete /agent/identities/{uid}">client.agent.agent.<a href="./src/resources/agent/agent_.ts">delete</a>(uid) -> void</code>
+- <code title="get /agent/identities/{uid}">client.agent.agent.<a href="./src/resources/agent/agent_.ts">get</a>(uid) -> AgentResponse</code>
 
 ## Sessions
 

src/resources/agent/agent_.ts

@@ -67,6 +67,20 @@ export class Agent extends APIResource {
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
+
+  /**
+   * Retrieve a single agent by its unique identifier. The response includes an
+   * `available` flag indicating whether the agent is within the team's plan limit
+   * and may be used for runs.
+   *
+   * @example
+   * ```ts
+   * const agentResponse = await client.agent.agent.get('uid');
+   * ```
+   */
+  get(uid: string, options?: RequestOptions): APIPromise<AgentResponse> {
+    return this._client.get(path`/agent/identities/${uid}`, options);
+  }
 }
 
 export interface AgentResponse {
@@ -101,6 +115,16 @@ export interface AgentResponse {
    */
   uid: string;
 
+  /**
+   * Base model for runs executed by this agent. The precedence order for model
+   * resolution is:
+   *
+   * 1. The model specified on the run itself
+   * 2. The agent's base model
+   * 3. The team's default model
+   */
+  base_model?: string;
+
   /**
    * Optional description of the agent
    */
@@ -125,6 +149,11 @@ export interface CreateAgentRequest {
    */
   name: string;
 
+  /**
+   * Optional base model for runs executed by this agent.
+   */
+  base_model?: string | null;
+
   /**
    * Optional description of the agent
    */
@@ -171,6 +200,12 @@ export interface ListAgentIdentitiesResponse {
  * - Non-empty: replace the field wholesale with the provided value.
  */
 export interface UpdateAgentRequest {
+  /**
+   * Replacement base model. Omit or pass `null` to leave unchanged, or pass an empty
+   * string to clear.
+   */
+  base_model?: string | null;
+
   /**
    * Replacement description. Omit or pass `null` to leave unchanged, or use an empty
    * value to clear.
@@ -213,6 +248,11 @@ export interface AgentCreateParams {
    */
   name: string;
 
+  /**
+   * Optional base model for runs executed by this agent.
+   */
+  base_model?: string | null;
+
   /**
    * Optional description of the agent
    */
@@ -248,6 +288,12 @@ export namespace AgentCreateParams {
 }
 
 export interface AgentUpdateParams {
+  /**
+   * Replacement base model. Omit or pass `null` to leave unchanged, or pass an empty
+   * string to clear.
+   */
+  base_model?: string | null;
+
   /**
    * Replacement description. Omit or pass `null` to leave unchanged, or use an empty
    * value to clear.

src/resources/agent/runs.ts

@@ -455,6 +455,11 @@ export namespace RunItem {
      * Cost of LLM inference for the run
      */
     inference_cost?: number;
+
+    /**
+     * Cost of platform usage for the run
+     */
+    platform_cost?: number;
   }
 
   /**

src/resources/agent/schedules.ts

@@ -178,11 +178,6 @@ export interface ScheduledAgentItem {
    */
   agent_config?: AgentAPI.AmbientAgentConfig;
 
-  /**
-   * UID of the agent that this schedule runs as
-   */
-  agent_uid?: string;
-
   created_by?: AgentAPI.UserProfile;
 
   /**

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

@@ -24,6 +24,7 @@ describe('resource agent', () => {
   test.skip('create: required and optional params', async () => {
     const response = await client.agent.agent.create({
       name: 'name',
+      base_model: 'base_model',
       description: 'description',
       secrets: [{ name: 'name' }],
       skills: ['string'],
@@ -65,4 +66,16 @@ describe('resource agent', () => {
     expect(dataAndResponse.data).toBe(response);
     expect(dataAndResponse.response).toBe(rawResponse);
   });
+
+  // Mock server tests are disabled
+  test.skip('get', async () => {
+    const responsePromise = client.agent.agent.get('uid');
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
 });

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

@@ -51,7 +51,7 @@ describe('resource schedules', () => {
         skill_spec: 'skill_spec',
         worker_host: 'worker_host',
       },
-      agent_uid: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+      agent_uid: 'agent_uid',
       enabled: true,
       mode: 'normal',
       prompt: 'Review open pull requests and provide feedback',
@@ -116,7 +116,7 @@ describe('resource schedules', () => {
         skill_spec: 'skill_spec',
         worker_host: 'worker_host',
       },
-      agent_uid: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+      agent_uid: 'agent_uid',
       mode: 'normal',
       prompt: 'prompt',
     });