feat: Surface platform credits in the public 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/warp-api-933dc0de5653397e66fc2618c9aeb6dc1b65bc327fe36346bb59f0bd0c25b2bd.yml
-openapi_spec_hash: fed1d156b2b419f2bee85db21d5870f5
-config_hash: ea21d91999803fd188cdbfdf2c654914
+configured_endpoints: 23
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-439930897f625c088be1b09e394f4053e45060cd2daab7454dfcf6c775cba1fb.yml
+openapi_spec_hash: f0382bea9210d76f906665e8a825a05b
+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 {

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;
   }
 
   /**

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

@@ -65,4 +65,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);
+  });
 });