feat: Enhance agent authentication with optional login page URL and auth ch…

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 74
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-3a68acd8c46e121c66be5b4c30bb4e962967840ca0f31070905baa39635fbc2d.yml
-openapi_spec_hash: 9453963fbb01de3e0afb462b16cdf115
-config_hash: 6dbe88d2ba9df1ec46cedbfdb7d00000
+configured_endpoints: 80
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-8a37652fa586b8932466d16285359a89988505f850787f8257d0c4c7053da173.yml
+openapi_spec_hash: 042765a113f6d08109e8146b302323ec
+config_hash: 113f1e5bc3567628a5d51c70bc00969d

api.md

@@ -246,3 +246,34 @@ Methods:
 - <code title="post /browser_pools/{id_or_name}/acquire">client.browserPools.<a href="./src/resources/browser-pools.ts">acquire</a>(idOrName, { ...params }) -> BrowserPoolAcquireResponse</code>
 - <code title="post /browser_pools/{id_or_name}/flush">client.browserPools.<a href="./src/resources/browser-pools.ts">flush</a>(idOrName) -> void</code>
 - <code title="post /browser_pools/{id_or_name}/release">client.browserPools.<a href="./src/resources/browser-pools.ts">release</a>(idOrName, { ...params }) -> void</code>
+
+# Agents
+
+## Auth
+
+Types:
+
+- <code><a href="./src/resources/agents/auth/auth.ts">AgentAuthDiscoverResponse</a></code>
+- <code><a href="./src/resources/agents/auth/auth.ts">AgentAuthInvocationResponse</a></code>
+- <code><a href="./src/resources/agents/auth/auth.ts">AgentAuthStartResponse</a></code>
+- <code><a href="./src/resources/agents/auth/auth.ts">AgentAuthSubmitResponse</a></code>
+- <code><a href="./src/resources/agents/auth/auth.ts">AuthAgent</a></code>
+- <code><a href="./src/resources/agents/auth/auth.ts">DiscoveredField</a></code>
+
+Methods:
+
+- <code title="get /agents/auth/{id}">client.agents.auth.<a href="./src/resources/agents/auth/auth.ts">retrieve</a>(id) -> AuthAgent</code>
+- <code title="post /agents/auth/start">client.agents.auth.<a href="./src/resources/agents/auth/auth.ts">start</a>({ ...params }) -> AgentAuthStartResponse</code>
+
+### Invocations
+
+Types:
+
+- <code><a href="./src/resources/agents/auth/invocations.ts">InvocationExchangeResponse</a></code>
+
+Methods:
+
+- <code title="get /agents/auth/invocations/{invocation_id}">client.agents.auth.invocations.<a href="./src/resources/agents/auth/invocations.ts">retrieve</a>(invocationID) -> AgentAuthInvocationResponse</code>
+- <code title="post /agents/auth/invocations/{invocation_id}/discover">client.agents.auth.invocations.<a href="./src/resources/agents/auth/invocations.ts">discover</a>(invocationID, { ...params }) -> AgentAuthDiscoverResponse</code>
+- <code title="post /agents/auth/invocations/{invocation_id}/exchange">client.agents.auth.invocations.<a href="./src/resources/agents/auth/invocations.ts">exchange</a>(invocationID, { ...params }) -> InvocationExchangeResponse</code>
+- <code title="post /agents/auth/invocations/{invocation_id}/submit">client.agents.auth.invocations.<a href="./src/resources/agents/auth/invocations.ts">submit</a>(invocationID, { ...params }) -> AgentAuthSubmitResponse</code>

src/client.ts

@@ -76,6 +76,7 @@ import {
   ProxyListResponse,
   ProxyRetrieveResponse,
 } from './resources/proxies';
+import { Agents } from './resources/agents/agents';
 import {
   BrowserCreateParams,
   BrowserCreateResponse,
@@ -859,6 +860,7 @@ export class Kernel {
   proxies: API.Proxies = new API.Proxies(this);
   extensions: API.Extensions = new API.Extensions(this);
   browserPools: API.BrowserPools = new API.BrowserPools(this);
+  agents: API.Agents = new API.Agents(this);
 }
 
 Kernel.Deployments = Deployments;
@@ -869,6 +871,7 @@ Kernel.Profiles = Profiles;
 Kernel.Proxies = Proxies;
 Kernel.Extensions = Extensions;
 Kernel.BrowserPools = BrowserPools;
+Kernel.Agents = Agents;
 
 export declare namespace Kernel {
   export type RequestOptions = Opts.RequestOptions;
@@ -966,6 +969,8 @@ export declare namespace Kernel {
     type BrowserPoolReleaseParams as BrowserPoolReleaseParams,
   };
 
+  export { Agents as Agents };
+
   export type AppAction = API.AppAction;
   export type BrowserExtension = API.BrowserExtension;
   export type BrowserProfile = API.BrowserProfile;

src/resources/agents.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './agents/index';

src/resources/agents/agents.ts

@@ -0,0 +1,33 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as AuthAPI from './auth/auth';
+import {
+  AgentAuthDiscoverResponse,
+  AgentAuthInvocationResponse,
+  AgentAuthStartResponse,
+  AgentAuthSubmitResponse,
+  Auth,
+  AuthAgent,
+  AuthStartParams,
+  DiscoveredField,
+} from './auth/auth';
+
+export class Agents extends APIResource {
+  auth: AuthAPI.Auth = new AuthAPI.Auth(this._client);
+}
+
+Agents.Auth = Auth;
+
+export declare namespace Agents {
+  export {
+    Auth as Auth,
+    type AgentAuthDiscoverResponse as AgentAuthDiscoverResponse,
+    type AgentAuthInvocationResponse as AgentAuthInvocationResponse,
+    type AgentAuthStartResponse as AgentAuthStartResponse,
+    type AgentAuthSubmitResponse as AgentAuthSubmitResponse,
+    type AuthAgent as AuthAgent,
+    type DiscoveredField as DiscoveredField,
+    type AuthStartParams as AuthStartParams,
+  };
+}

src/resources/agents/auth.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './auth/index';