release: 1.4.0-alpha.1

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.4.0-alpha.0"
+  ".": "1.4.0-alpha.1"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 22
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-c58f2ee13e97acdf607650e199cb1377d2767c6bd6183b5f1212fa2666bb5f04.yml
-openapi_spec_hash: 19295b9e19b2ab3093087d9b11a6095f
-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

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.4.0-alpha.1 (2026-05-06)
+
+Full Changelog: [v1.4.0-alpha.0...v1.4.0-alpha.1](https://github.com/warpdotdev/oz-sdk-typescript/compare/v1.4.0-alpha.0...v1.4.0-alpha.1)
+
+### Features
+
+* [REMOTE-1538] Support base model on named agents ([3a54264](https://github.com/warpdotdev/oz-sdk-typescript/commit/3a54264de3e6baf3b379c92e48a00cbc9830831a))
+* Surface platform credits in the public API ([01c55d8](https://github.com/warpdotdev/oz-sdk-typescript/commit/01c55d8fc871536332ea72cdfa2bc804466c4aba))
+
 ## 1.4.0-alpha.0 (2026-05-03)
 
 Full Changelog: [v1.3.0...v1.4.0-alpha.0](https://github.com/warpdotdev/oz-sdk-typescript/compare/v1.3.0...v1.4.0-alpha.0)

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
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "oz-agent-sdk",
-  "version": "1.4.0-alpha.0",
+  "version": "1.4.0-alpha.1",
   "description": "The official TypeScript library for the Oz API API",
   "author": "Oz API <>",
   "types": "dist/index.d.ts",

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/version.ts

@@ -1 +1 @@
-export const VERSION = '1.4.0-alpha.0'; // x-release-please-version
+export const VERSION = '1.4.0-alpha.1'; // x-release-please-version

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);
+  });
 });