feat: Make conversation/session redirects public

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 21
+configured_endpoints: 22
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-348bf98eecccd80255fdcee166b5eb385d8d9743811d080f94a1ec33337abc48.yml
-openapi_spec_hash: 5da1dccadb70219c6dfdda1a440b9ad2
-config_hash: b893614299dd99b07446072ade3737d1
+openapi_spec_hash: 1952fae99172f1adaf35d800b0d63936
+config_hash: 44a1e8f98607a5cf03815a63bae63453

api.md

@@ -89,3 +89,13 @@ Types:
 Methods:
 
 - <code title="get /agent/sessions/{sessionUuid}/redirect">client.agent.sessions.<a href="./src/resources/agent/sessions.ts">checkRedirect</a>(sessionUuid) -> SessionCheckRedirectResponse</code>
+
+## Conversations
+
+Types:
+
+- <code><a href="./src/resources/agent/conversations.ts">ConversationCheckRedirectResponse</a></code>
+
+Methods:
+
+- <code title="get /agent/conversations/{conversationId}/redirect">client.agent.conversations.<a href="./src/resources/agent/conversations.ts">checkRedirect</a>(conversationID) -> ConversationCheckRedirectResponse</code>

src/client.ts

@@ -242,7 +242,14 @@ export class OzAPI {
     return;
   }
 
-  protected async authHeaders(opts: FinalRequestOptions): Promise<NullableHeaders | undefined> {
+  protected async authHeaders(
+    opts: FinalRequestOptions,
+    schemes: { bearerAuth?: boolean },
+  ): Promise<NullableHeaders | undefined> {
+    return buildHeaders([schemes.bearerAuth ? await this.bearerAuth(opts) : null]);
+  }
+
+  protected async bearerAuth(opts: FinalRequestOptions): Promise<NullableHeaders | undefined> {
     return buildHeaders([{ Authorization: `Bearer ${this.apiKey}` }]);
   }
 
@@ -693,7 +700,7 @@ export class OzAPI {
         ...(options.timeout ? { 'X-Stainless-Timeout': String(Math.trunc(options.timeout / 1000)) } : {}),
         ...getPlatformHeaders(),
       },
-      await this.authHeaders(options),
+      await this.authHeaders(options, options.__security ?? { bearerAuth: true }),
       this._options.defaultHeaders,
       bodyHeaders,
       options.headers,

src/internal/request-options.ts

@@ -75,6 +75,8 @@ export type RequestOptions = {
    */
   defaultBaseURL?: string | undefined;
 
+  __security?: { bearerAuth?: boolean };
+
   __binaryResponse?: boolean | undefined;
 };
 

src/resources/agent/agent.ts

@@ -12,6 +12,8 @@ import {
   ListAgentIdentitiesResponse,
   UpdateAgentRequest,
 } from './agent_';
+import * as ConversationsAPI from './conversations';
+import { ConversationCheckRedirectResponse, Conversations } from './conversations';
 import * as RunsAPI from './runs';
 import {
   ArtifactItem,
@@ -50,6 +52,7 @@ export class Agent extends APIResource {
   schedules: SchedulesAPI.Schedules = new SchedulesAPI.Schedules(this._client);
   agent: AgentAgentAPI.Agent = new AgentAgentAPI.Agent(this._client);
   sessions: SessionsAPI.Sessions = new SessionsAPI.Sessions(this._client);
+  conversations: ConversationsAPI.Conversations = new ConversationsAPI.Conversations(this._client);
 
   /**
    * Retrieve a list of available agents (skills) that can be used to run tasks.
@@ -1067,6 +1070,7 @@ Agent.Runs = Runs;
 Agent.Schedules = Schedules;
 Agent.Agent = AgentAPIAgent;
 Agent.Sessions = Sessions;
+Agent.Conversations = Conversations;
 
 export declare namespace Agent {
   export {
@@ -1125,4 +1129,9 @@ export declare namespace Agent {
   };
 
   export { Sessions as Sessions, type SessionCheckRedirectResponse as SessionCheckRedirectResponse };
+
+  export {
+    Conversations as Conversations,
+    type ConversationCheckRedirectResponse as ConversationCheckRedirectResponse,
+  };
 }

src/resources/agent/conversations.ts

@@ -0,0 +1,49 @@
+// 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';
+
+/**
+ * Operations for running and managing cloud agents
+ */
+export class Conversations extends APIResource {
+  /**
+   * Check whether a conversation should redirect to a live shared session. Returns a
+   * session_id if the underlying ambient agent task still has a live shared session,
+   * or an empty object if no redirect is needed.
+   *
+   * This endpoint is public (no authentication required) so that anonymous viewers
+   * can resolve a publicly-shared conversation link before signing in. Access to the
+   * underlying live session is still gated by the session-sharing service ACLs.
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.agent.conversations.checkRedirect(
+   *     'conversationId',
+   *   );
+   * ```
+   */
+  checkRedirect(
+    conversationID: string,
+    options?: RequestOptions,
+  ): APIPromise<ConversationCheckRedirectResponse> {
+    return this._client.get(path`/agent/conversations/${conversationID}/redirect`, {
+      ...options,
+      __security: {},
+    });
+  }
+}
+
+export interface ConversationCheckRedirectResponse {
+  /**
+   * The shared session UUID to redirect to (only present when redirect is needed)
+   */
+  session_id?: string;
+}
+
+export declare namespace Conversations {
+  export { type ConversationCheckRedirectResponse as ConversationCheckRedirectResponse };
+}

src/resources/agent/index.ts

@@ -21,6 +21,7 @@ export {
   type AgentListEnvironmentsParams,
   type AgentRunParams,
 } from './agent';
+export { Conversations, type ConversationCheckRedirectResponse } from './conversations';
 export {
   Runs,
   type ArtifactItem,

src/resources/agent/sessions.ts

@@ -14,6 +14,10 @@ export class Sessions extends APIResource {
    * Returns a conversation_id if the agent sandbox has finished and conversation
    * data is available, or an empty object if no redirect is needed.
    *
+   * This endpoint is public (no authentication required) so that anonymous viewers
+   * can resolve a publicly-shared session link before signing in. Access to the
+   * underlying conversation transcript is still gated by conversation link-sharing.
+   *
    * @example
    * ```ts
    * const response = await client.agent.sessions.checkRedirect(
@@ -22,7 +26,7 @@ export class Sessions extends APIResource {
    * ```
    */
   checkRedirect(sessionUuid: string, options?: RequestOptions): APIPromise<SessionCheckRedirectResponse> {
-    return this._client.get(path`/agent/sessions/${sessionUuid}/redirect`, options);
+    return this._client.get(path`/agent/sessions/${sessionUuid}/redirect`, { ...options, __security: {} });
   }
 }
 

tests/api-resources/agent/conversations.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 conversations', () => {
+  // Mock server tests are disabled
+  test.skip('checkRedirect', async () => {
+    const responsePromise = client.agent.conversations.checkRedirect('conversationId');
+    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);
+  });
+});