feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 12
+configured_endpoints: 14
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-91a7db62ba0752b9bdccd4bac4c6d09c1d59b7b69788159fe13598b7a5def7ee.yml
 openapi_spec_hash: f03a889deaf6df14d678643be1e4dbe3
-config_hash: 433e7a5579323a048aa173a0ace06bfc
+config_hash: 25c1059aa958c8c2ad60ef16c318514d

api.md

@@ -8,11 +8,13 @@ Types:
 - <code><a href="./src/resources/agent/agent.ts">McpServerConfig</a></code>
 - <code><a href="./src/resources/agent/agent.ts">UserProfile</a></code>
 - <code><a href="./src/resources/agent/agent.ts">AgentListResponse</a></code>
+- <code><a href="./src/resources/agent/agent.ts">AgentGetArtifactResponse</a></code>
 - <code><a href="./src/resources/agent/agent.ts">AgentRunResponse</a></code>
 
 Methods:
 
 - <code title="get /agent">client.agent.<a href="./src/resources/agent/agent.ts">list</a>({ ...params }) -> AgentListResponse</code>
+- <code title="get /agent/artifacts/{artifactUid}">client.agent.<a href="./src/resources/agent/agent.ts">getArtifact</a>(artifactUid) -> AgentGetArtifactResponse</code>
 - <code title="post /agent/run">client.agent.<a href="./src/resources/agent/agent.ts">run</a>({ ...params }) -> AgentRunResponse</code>
 
 ## Runs
@@ -49,3 +51,13 @@ Methods:
 - <code title="delete /agent/schedules/{scheduleId}">client.agent.schedules.<a href="./src/resources/agent/schedules.ts">delete</a>(scheduleID) -> ScheduleDeleteResponse</code>
 - <code title="post /agent/schedules/{scheduleId}/pause">client.agent.schedules.<a href="./src/resources/agent/schedules.ts">pause</a>(scheduleID) -> ScheduledAgentItem</code>
 - <code title="post /agent/schedules/{scheduleId}/resume">client.agent.schedules.<a href="./src/resources/agent/schedules.ts">resume</a>(scheduleID) -> ScheduledAgentItem</code>
+
+## Sessions
+
+Types:
+
+- <code><a href="./src/resources/agent/sessions.ts">SessionCheckRedirectResponse</a></code>
+
+Methods:
+
+- <code title="get /agent/sessions/{sessionUuid}/redirect">client.agent.sessions.<a href="./src/resources/agent/sessions.ts">checkRedirect</a>(sessionUuid) -> SessionCheckRedirectResponse</code>

src/client.ts

@@ -19,6 +19,7 @@ import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
 import {
   Agent,
+  AgentGetArtifactResponse,
   AgentListParams,
   AgentListResponse,
   AgentRunParams,
@@ -742,6 +743,7 @@ export declare namespace OzAPI {
     type McpServerConfig as McpServerConfig,
     type UserProfile as UserProfile,
     type AgentListResponse as AgentListResponse,
+    type AgentGetArtifactResponse as AgentGetArtifactResponse,
     type AgentRunResponse as AgentRunResponse,
     type AgentListParams as AgentListParams,
     type AgentRunParams as AgentRunParams,

src/resources/agent/agent.ts

@@ -21,12 +21,16 @@ import {
   ScheduledAgentItem,
   Schedules,
 } from './schedules';
+import * as SessionsAPI from './sessions';
+import { SessionCheckRedirectResponse, Sessions } from './sessions';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
 
 export class Agent extends APIResource {
   runs: RunsAPI.Runs = new RunsAPI.Runs(this._client);
   schedules: SchedulesAPI.Schedules = new SchedulesAPI.Schedules(this._client);
+  sessions: SessionsAPI.Sessions = new SessionsAPI.Sessions(this._client);
 
   /**
    * Retrieve a list of available agents (skills) that can be used to run tasks.
@@ -44,6 +48,21 @@ export class Agent extends APIResource {
     return this._client.get('/agent', { query, ...options });
   }
 
+  /**
+   * Retrieve an artifact by its UUID. For screenshot artifacts, returns a
+   * time-limited signed download URL.
+   *
+   * @example
+   * ```ts
+   * const response = await client.agent.getArtifact(
+   *   'artifactUid',
+   * );
+   * ```
+   */
+  getArtifact(artifactUid: string, options?: RequestOptions): APIPromise<AgentGetArtifactResponse> {
+    return this._client.get(path`/agent/artifacts/${artifactUid}`, options);
+  }
+
   /**
    * Spawn a cloud agent with a prompt and optional configuration. The agent will be
    * queued for execution and assigned a unique run ID.
@@ -302,6 +321,58 @@ export interface AgentListResponse {
   agents: Array<AgentSkill>;
 }
 
+/**
+ * Response for artifact retrieval. Currently supports screenshot artifacts.
+ */
+export interface AgentGetArtifactResponse {
+  /**
+   * Type of the artifact (e.g., SCREENSHOT)
+   */
+  artifact_type: string;
+
+  /**
+   * Unique identifier (UUID) for the artifact
+   */
+  artifact_uid: string;
+
+  /**
+   * Timestamp when the artifact was created (RFC3339)
+   */
+  created_at: string;
+
+  /**
+   * Response data for a screenshot artifact, including a signed download URL.
+   */
+  data: AgentGetArtifactResponse.Data;
+}
+
+export namespace AgentGetArtifactResponse {
+  /**
+   * Response data for a screenshot artifact, including a signed download URL.
+   */
+  export interface Data {
+    /**
+     * MIME type of the screenshot (e.g., image/png)
+     */
+    content_type: string;
+
+    /**
+     * Time-limited signed URL to download the screenshot
+     */
+    download_url: string;
+
+    /**
+     * Timestamp when the download URL expires (RFC3339)
+     */
+    expires_at: string;
+
+    /**
+     * Optional description of the screenshot
+     */
+    description?: string;
+  }
+}
+
 export interface AgentRunResponse {
   /**
    * Unique identifier for the created run
@@ -427,6 +498,7 @@ export namespace AgentRunParams {
 
 Agent.Runs = Runs;
 Agent.Schedules = Schedules;
+Agent.Sessions = Sessions;
 
 export declare namespace Agent {
   export {
@@ -436,6 +508,7 @@ export declare namespace Agent {
     type McpServerConfig as McpServerConfig,
     type UserProfile as UserProfile,
     type AgentListResponse as AgentListResponse,
+    type AgentGetArtifactResponse as AgentGetArtifactResponse,
     type AgentRunResponse as AgentRunResponse,
     type AgentListParams as AgentListParams,
     type AgentRunParams as AgentRunParams,
@@ -460,4 +533,6 @@ export declare namespace Agent {
     type ScheduleCreateParams as ScheduleCreateParams,
     type ScheduleUpdateParams as ScheduleUpdateParams,
   };
+
+  export { Sessions as Sessions, type SessionCheckRedirectResponse as SessionCheckRedirectResponse };
 }

src/resources/agent/index.ts

@@ -8,6 +8,7 @@ export {
   type McpServerConfig,
   type UserProfile,
   type AgentListResponse,
+  type AgentGetArtifactResponse,
   type AgentRunResponse,
   type AgentListParams,
   type AgentRunParams,
@@ -30,3 +31,4 @@ export {
   type ScheduleCreateParams,
   type ScheduleUpdateParams,
 } from './schedules';
+export { Sessions, type SessionCheckRedirectResponse } from './sessions';

src/resources/agent/sessions.ts

@@ -0,0 +1,35 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Sessions extends APIResource {
+  /**
+   * Check whether a shared session should redirect to a conversation transcript.
+   * Returns a conversation_id if the agent sandbox has finished and conversation
+   * data is available, or an empty object if no redirect is needed.
+   *
+   * @example
+   * ```ts
+   * const response = await client.agent.sessions.checkRedirect(
+   *   'sessionUuid',
+   * );
+   * ```
+   */
+  checkRedirect(sessionUuid: string, options?: RequestOptions): APIPromise<SessionCheckRedirectResponse> {
+    return this._client.get(path`/agent/sessions/${sessionUuid}/redirect`, options);
+  }
+}
+
+export interface SessionCheckRedirectResponse {
+  /**
+   * The conversation ID to redirect to (only present when redirect is needed)
+   */
+  conversation_id?: string;
+}
+
+export declare namespace Sessions {
+  export { type SessionCheckRedirectResponse as SessionCheckRedirectResponse };
+}

src/resources/index.ts

@@ -8,6 +8,7 @@ export {
   type McpServerConfig,
   type UserProfile,
   type AgentListResponse,
+  type AgentGetArtifactResponse,
   type AgentRunResponse,
   type AgentListParams,
   type AgentRunParams,

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

@@ -35,6 +35,18 @@ describe('resource agent', () => {
     ).rejects.toThrow(OzAPI.NotFoundError);
   });
 
+  // Mock server tests are disabled
+  test.skip('getArtifact', async () => {
+    const responsePromise = client.agent.getArtifact('artifactUid');
+    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);
+  });
+
   // Mock server tests are disabled
   test.skip('run', async () => {
     const responsePromise = client.agent.run({});

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

@@ -0,0 +1,22 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import OzAPI from 'oz-agent-sdk';
+
+const client = new OzAPI({
+  apiKey: 'My API Key',
+  baseURL: process.env['TEST_API_BASE_URL'] ?? 'http://127.0.0.1:4010',
+});
+
+describe('resource sessions', () => {
+  // Mock server tests are disabled
+  test.skip('checkRedirect', async () => {
+    const responsePromise = client.agent.sessions.checkRedirect('sessionUuid');
+    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);
+  });
+});