@bctrl/sdk 1.0.2 → 1.0.3

package/README.md

@@ -1,6 +1,6 @@
 # @bctrl/sdk
 
-TypeScript SDK for BCTRL v2 spaces, browser runtimes, invocations, runs, and files.
+TypeScript SDK for BCTRL v1 spaces, browser runtimes, invocations, runs, and files.
 
 ## Install
 
@@ -24,10 +24,14 @@ const space = await bctrl.spaces.create({
   region: 'us-east-1',
 });
 
-const browser = await space.browsers.launch({
+const runtime = await space.runtimes.create({
+  type: 'browser',
   name: 'browser-task',
-  state: 'ephemeral',
+  config: {
+    browser: { profile: false },
+  },
 });
+const { runtime: browser } = await runtime.start();
 
 const connection = await browser.connect();
 console.log(connection.wsUrl);
@@ -42,8 +46,8 @@ const result = await invocation.wait({ timeoutMs: 60_000 });
 console.log(result.data.status);
 ```
 
-The public SDK targets `https://api.bctrl.ai/v2`. For local development, pass a
-local origin or v2 base URL:
+The public SDK targets `https://api.bctrl.ai/v1`. For local development, pass a
+local origin or v1 base URL:
 
 ```ts
 const bctrl = new Bctrl({
@@ -52,11 +56,11 @@ const bctrl = new Bctrl({
 });
 ```
 
-`baseUrl` may include or omit `/v2`; the client normalizes either form.
+`baseUrl` may include or omit `/v1`; the client normalizes either form.
 
 ## Entry points
 
-- `@bctrl/sdk`: v2 client, resources, errors, and public types
+- `@bctrl/sdk`: v1 client, resources, errors, and public types
 
 ## Documentation
 

package/dist/bctrl.d.ts

@@ -1,11 +1,11 @@
-import { V2FilesClient } from './files.js';
-import { type V2ClientOptions } from './http.js';
-import { V2InvocationsClient } from './invocations.js';
-import { V2RunsClient } from './runs.js';
-import { V2RuntimesClient } from './runtimes.js';
-import { V2SpacesClient } from './spaces.js';
-export type BctrlV2Options = V2ClientOptions;
-export declare class BctrlV2 {
+import { V1FilesClient } from './files.js';
+import { type V1ClientOptions } from './http.js';
+import { V1InvocationsClient } from './invocations.js';
+import { V1RunsClient } from './runs.js';
+import { V1RuntimesClient } from './runtimes.js';
+import { V1SpacesClient } from './spaces.js';
+export type BctrlV1Options = V1ClientOptions;
+export declare class BctrlV1 {
     private readonly http;
     private _spaces;
     private _runtimes;
@@ -13,11 +13,11 @@ export declare class BctrlV2 {
     private _invocations;
     private _files;
     static isControllerBusy(error: unknown): boolean;
-    constructor(options?: BctrlV2Options);
-    get spaces(): V2SpacesClient;
-    get runtimes(): V2RuntimesClient;
-    get runs(): V2RunsClient;
-    get invocations(): V2InvocationsClient;
-    get files(): V2FilesClient;
+    constructor(options?: BctrlV1Options);
+    get spaces(): V1SpacesClient;
+    get runtimes(): V1RuntimesClient;
+    get runs(): V1RunsClient;
+    get invocations(): V1InvocationsClient;
+    get files(): V1FilesClient;
 }
-export { BctrlV2 as Bctrl };
+export { BctrlV1 as Bctrl };

package/dist/bctrl.js

@@ -1,11 +1,11 @@
 import { isControllerBusy } from './errors.js';
-import { V2FilesClient } from './files.js';
-import { V2HttpClient } from './http.js';
-import { V2InvocationsClient } from './invocations.js';
-import { V2RunsClient } from './runs.js';
-import { V2RuntimesClient } from './runtimes.js';
-import { V2SpacesClient } from './spaces.js';
-export class BctrlV2 {
+import { V1FilesClient } from './files.js';
+import { V1HttpClient } from './http.js';
+import { V1InvocationsClient } from './invocations.js';
+import { V1RunsClient } from './runs.js';
+import { V1RuntimesClient } from './runtimes.js';
+import { V1SpacesClient } from './spaces.js';
+export class BctrlV1 {
     http;
     _spaces = null;
     _runtimes = null;
@@ -16,27 +16,27 @@ export class BctrlV2 {
         return isControllerBusy(error);
     }
     constructor(options = {}) {
-        this.http = new V2HttpClient(options);
+        this.http = new V1HttpClient(options);
     }
     get spaces() {
-        this._spaces ??= new V2SpacesClient(this.http);
+        this._spaces ??= new V1SpacesClient(this.http);
         return this._spaces;
     }
     get runtimes() {
-        this._runtimes ??= new V2RuntimesClient(this.http);
+        this._runtimes ??= new V1RuntimesClient(this.http);
         return this._runtimes;
     }
     get runs() {
-        this._runs ??= new V2RunsClient(this.http);
+        this._runs ??= new V1RunsClient(this.http);
         return this._runs;
     }
     get invocations() {
-        this._invocations ??= new V2InvocationsClient(this.http);
+        this._invocations ??= new V1InvocationsClient(this.http);
         return this._invocations;
     }
     get files() {
-        this._files ??= new V2FilesClient(this.http);
+        this._files ??= new V1FilesClient(this.http);
         return this._files;
     }
 }
-export { BctrlV2 as Bctrl };
+export { BctrlV1 as Bctrl };

package/dist/errors.d.ts

@@ -1,4 +1,4 @@
-export interface V2ErrorContext {
+export interface V1ErrorContext {
     status?: number;
     code?: string;
     requestId?: string;
@@ -7,43 +7,43 @@ export interface V2ErrorContext {
 }
 export declare class BctrlError extends Error {
     readonly code: string;
-    readonly context?: V2ErrorContext;
-    constructor(message: string, code: string, context?: V2ErrorContext);
+    readonly context?: V1ErrorContext;
+    constructor(message: string, code: string, context?: V1ErrorContext);
     toJSON(): Record<string, unknown>;
 }
 export declare class BctrlApiError extends BctrlError {
-    constructor(message: string, code?: string, context?: V2ErrorContext);
+    constructor(message: string, code?: string, context?: V1ErrorContext);
     get status(): number | undefined;
     get requestId(): string | undefined;
 }
 export declare class BctrlAuthenticationError extends BctrlApiError {
-    constructor(message: string, code?: string, context?: V2ErrorContext);
+    constructor(message: string, code?: string, context?: V1ErrorContext);
 }
 export declare class BctrlPermissionError extends BctrlApiError {
-    constructor(message: string, code?: string, context?: V2ErrorContext);
+    constructor(message: string, code?: string, context?: V1ErrorContext);
 }
 export declare class BctrlNotFoundError extends BctrlApiError {
-    constructor(message: string, code?: string, context?: V2ErrorContext);
+    constructor(message: string, code?: string, context?: V1ErrorContext);
 }
 export declare class BctrlConflictError extends BctrlApiError {
-    constructor(message: string, code?: string, context?: V2ErrorContext);
+    constructor(message: string, code?: string, context?: V1ErrorContext);
 }
 export declare class BctrlRateLimitError extends BctrlApiError {
-    constructor(message: string, code?: string, context?: V2ErrorContext);
+    constructor(message: string, code?: string, context?: V1ErrorContext);
 }
 export declare class BctrlValidationError extends BctrlApiError {
-    constructor(message: string, code?: string, context?: V2ErrorContext);
+    constructor(message: string, code?: string, context?: V1ErrorContext);
 }
 export declare class BctrlNetworkError extends BctrlError {
-    constructor(message: string, context?: V2ErrorContext);
+    constructor(message: string, context?: V1ErrorContext);
 }
 export declare class BctrlNotReadyError extends BctrlError {
-    constructor(message: string, context?: V2ErrorContext);
+    constructor(message: string, context?: V1ErrorContext);
 }
 export declare class BctrlUnsupportedError extends BctrlError {
-    constructor(message: string, context?: V2ErrorContext);
+    constructor(message: string, context?: V1ErrorContext);
 }
-export declare function createV2HttpError(input: {
+export declare function createV1HttpError(input: {
     status: number;
     message: string;
     code?: string;

package/dist/errors.js

@@ -82,7 +82,7 @@ export class BctrlUnsupportedError extends BctrlError {
         this.name = 'BctrlUnsupportedError';
     }
 }
-export function createV2HttpError(input) {
+export function createV1HttpError(input) {
     const context = {
         status: input.status,
         requestId: input.requestId,

package/dist/files.d.ts

@@ -1,31 +1,31 @@
-import type { V2HttpClient } from './http.js';
-import type { V2File, V2FileDeleteResponse, V2FilesListQuery, V2FileUpdateRequest, V2FileUploadRequest, V2ListEnvelope, V2RunFilesExportRequest, V2RunFilesListQuery } from './types.js';
-export declare class V2FileResource {
+import type { V1HttpClient } from './http.js';
+import type { V1File, V1FileDeleteResponse, V1FilesListQuery, V1FileUpdateRequest, V1FileUploadRequest, V1ListEnvelope, V1RunFilesExportRequest, V1RunFilesListQuery } from './types.js';
+export declare class V1FileResource {
     private readonly http;
-    readonly data: V2File;
-    constructor(http: V2HttpClient, data: V2File);
+    readonly data: V1File;
+    constructor(http: V1HttpClient, data: V1File);
     get id(): string;
-    refresh(): Promise<V2FileResource>;
+    refresh(): Promise<V1FileResource>;
     content(): Promise<Response>;
-    update(request: V2FileUpdateRequest): Promise<V2FileResource>;
-    delete(): Promise<V2FileDeleteResponse>;
+    update(request: V1FileUpdateRequest): Promise<V1FileResource>;
+    delete(): Promise<V1FileDeleteResponse>;
 }
-export declare class V2FilesClient {
+export declare class V1FilesClient {
     private readonly http;
-    constructor(http: V2HttpClient);
-    list(query: V2FilesListQuery): Promise<V2ListEnvelope<V2File>>;
-    iter(query: V2FilesListQuery): AsyncGenerator<V2File, void, undefined>;
-    get(id: string): Promise<V2FileResource>;
-    update(id: string, request: V2FileUpdateRequest): Promise<V2FileResource>;
+    constructor(http: V1HttpClient);
+    list(query: V1FilesListQuery): Promise<V1ListEnvelope<V1File>>;
+    iter(query: V1FilesListQuery): AsyncGenerator<V1File, void, undefined>;
+    get(id: string): Promise<V1FileResource>;
+    update(id: string, request: V1FileUpdateRequest): Promise<V1FileResource>;
     content(id: string): Promise<Response>;
-    delete(id: string): Promise<V2FileDeleteResponse>;
-    upload(request: V2FileUploadRequest): Promise<V2FileResource>;
+    delete(id: string): Promise<V1FileDeleteResponse>;
+    upload(request: V1FileUploadRequest): Promise<V1FileResource>;
 }
-export declare class V2RunFilesClient {
+export declare class V1RunFilesClient {
     private readonly http;
     private readonly runId;
-    constructor(http: V2HttpClient, runId: string);
-    list(query?: V2RunFilesListQuery): Promise<V2ListEnvelope<V2File>>;
-    iter(query?: V2RunFilesListQuery): AsyncGenerator<V2File, void, undefined>;
-    export(request: V2RunFilesExportRequest): Promise<V2FileResource>;
+    constructor(http: V1HttpClient, runId: string);
+    list(query?: V1RunFilesListQuery): Promise<V1ListEnvelope<V1File>>;
+    iter(query?: V1RunFilesListQuery): AsyncGenerator<V1File, void, undefined>;
+    export(request: V1RunFilesExportRequest): Promise<V1FileResource>;
 }

package/dist/files.js

@@ -1,5 +1,5 @@
-import { iterateV2Pages } from './pagination.js';
-export class V2FileResource {
+import { iterateV1Pages } from './pagination.js';
+export class V1FileResource {
     http;
     data;
     constructor(http, data) {
@@ -10,19 +10,19 @@ export class V2FileResource {
         return this.data.id;
     }
     refresh() {
-        return new V2FilesClient(this.http).get(this.id);
+        return new V1FilesClient(this.http).get(this.id);
     }
     async content() {
-        return new V2FilesClient(this.http).content(this.id);
+        return new V1FilesClient(this.http).content(this.id);
     }
     async update(request) {
-        return new V2FilesClient(this.http).update(this.id, request);
+        return new V1FilesClient(this.http).update(this.id, request);
     }
     delete() {
-        return new V2FilesClient(this.http).delete(this.id);
+        return new V1FilesClient(this.http).delete(this.id);
     }
 }
-export class V2FilesClient {
+export class V1FilesClient {
     http;
     constructor(http) {
         this.http = http;
@@ -31,18 +31,18 @@ export class V2FilesClient {
         return this.http.request('/files', { query });
     }
     iter(query) {
-        return iterateV2Pages(query, (pageQuery) => this.list(pageQuery));
+        return iterateV1Pages(query, (pageQuery) => this.list(pageQuery));
     }
     async get(id) {
         const file = await this.http.request(`/files/${encodeURIComponent(id)}`);
-        return new V2FileResource(this.http, file);
+        return new V1FileResource(this.http, file);
     }
     async update(id, request) {
         const file = await this.http.request(`/files/${encodeURIComponent(id)}`, {
             method: 'PATCH',
             body: request,
         });
-        return new V2FileResource(this.http, file);
+        return new V1FileResource(this.http, file);
     }
     content(id) {
         return this.http.raw(`/files/${encodeURIComponent(id)}/content`);
@@ -71,10 +71,10 @@ export class V2FilesClient {
             query: { spaceId: request.spaceId },
             body: form,
         });
-        return new V2FileResource(this.http, file);
+        return new V1FileResource(this.http, file);
     }
 }
-export class V2RunFilesClient {
+export class V1RunFilesClient {
     http;
     runId;
     constructor(http, runId) {
@@ -85,13 +85,13 @@ export class V2RunFilesClient {
         return this.http.request(`/runs/${encodeURIComponent(this.runId)}/files`, { query });
     }
     iter(query = {}) {
-        return iterateV2Pages(query, (pageQuery) => this.list(pageQuery));
+        return iterateV1Pages(query, (pageQuery) => this.list(pageQuery));
     }
     async export(request) {
         const file = await this.http.request(`/runs/${encodeURIComponent(this.runId)}/files/export`, {
             method: 'POST',
             body: request,
         });
-        return new V2FileResource(this.http, file);
+        return new V1FileResource(this.http, file);
     }
 }

package/dist/http.d.ts

@@ -1,18 +1,18 @@
-export interface V2ClientOptions {
+export interface V1ClientOptions {
     apiKey?: string;
     baseUrl?: string;
 }
-export interface V2RequestOptions {
+export interface V1RequestOptions {
     method?: 'GET' | 'POST' | 'PATCH' | 'DELETE';
     query?: object;
     body?: unknown;
     headers?: Record<string, string>;
     timeoutMs?: number;
 }
-export declare class V2HttpClient {
+export declare class V1HttpClient {
     readonly baseUrl: string;
     readonly apiKey: string;
-    constructor(options: V2ClientOptions);
-    request<T>(path: string, options?: V2RequestOptions): Promise<T>;
-    raw(path: string, options?: V2RequestOptions): Promise<Response>;
+    constructor(options: V1ClientOptions);
+    request<T>(path: string, options?: V1RequestOptions): Promise<T>;
+    raw(path: string, options?: V1RequestOptions): Promise<Response>;
 }

package/dist/http.js

@@ -1,18 +1,18 @@
-import { BctrlNetworkError, createV2HttpError } from './errors.js';
+import { BctrlNetworkError, createV1HttpError } from './errors.js';
 import { BCTRL_PRODUCTION_ORIGIN, fetchWithTimeout, resolveApiKey, stripTrailingSlash, } from './utils.js';
 import { SDK_VERSION } from './version.js';
-const V2_PREFIX = '/v2';
-function resolveV2ApiBaseUrl(baseUrl) {
-    const raw = stripTrailingSlash(baseUrl?.trim() || BCTRL_PRODUCTION_ORIGIN);
-    if (raw.endsWith(V2_PREFIX)) {
+const API_PREFIX = '/v1';
+function resolveV1ApiBaseUrl(baseUrl) {
+    const raw = stripTrailingSlash(baseUrl?.trim() ||
+        process.env.BCTRL_BASE_URL?.trim() ||
+        process.env.BCTRL_API_BASE_URL?.trim() ||
+        BCTRL_PRODUCTION_ORIGIN);
+    if (raw.endsWith(API_PREFIX)) {
         return raw;
     }
-    if (raw.endsWith('/v1')) {
-        return `${raw.slice(0, -3)}${V2_PREFIX}`;
-    }
-    return `${raw}${V2_PREFIX}`;
+    return `${raw}${API_PREFIX}`;
 }
-function resolveV2ApiKey(apiKey) {
+function resolveV1ApiKey(apiKey) {
     return resolveApiKey(apiKey ?? process.env.BCTRL_API_KEY ?? '');
 }
 function appendQuery(params, key, value) {
@@ -50,7 +50,7 @@ function responseRequestId(response) {
 function isRecord(value) {
     return Boolean(value && typeof value === 'object' && !Array.isArray(value));
 }
-function parseV2ErrorBody(parsed, fallbackText) {
+function parseV1ErrorBody(parsed, fallbackText) {
     if (isRecord(parsed) && typeof parsed.error === 'string') {
         return {
             error: parsed.error,
@@ -70,12 +70,12 @@ function isBodyInit(value) {
         value instanceof URLSearchParams ||
         value instanceof ArrayBuffer);
 }
-export class V2HttpClient {
+export class V1HttpClient {
     baseUrl;
     apiKey;
     constructor(options) {
-        this.baseUrl = resolveV2ApiBaseUrl(options.baseUrl);
-        this.apiKey = resolveV2ApiKey(options.apiKey);
+        this.baseUrl = resolveV1ApiBaseUrl(options.baseUrl);
+        this.apiKey = resolveV1ApiKey(options.apiKey);
     }
     async request(path, options = {}) {
         const response = await this.raw(path, options);
@@ -92,7 +92,7 @@ export class V2HttpClient {
             Accept: 'application/json',
             Authorization: `Bearer ${this.apiKey}`,
             'x-sdk-version': SDK_VERSION,
-            'User-Agent': `@bctrl/sdk/${SDK_VERSION} v2`,
+            'User-Agent': `@bctrl/sdk/${SDK_VERSION} v1`,
             ...options.headers,
         };
         const init = {
@@ -121,8 +121,8 @@ export class V2HttpClient {
         if (!response.ok) {
             const text = await response.text();
             const parsed = parseResponseBody(text);
-            const errorBody = parseV2ErrorBody(parsed, text);
-            throw createV2HttpError({
+            const errorBody = parseV1ErrorBody(parsed, text);
+            throw createV1HttpError({
                 status: response.status,
                 message: errorBody.error,
                 code: errorBody.code,

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export { Bctrl, BctrlV2, type BctrlV2Options } from './bctrl.js';
+export { Bctrl, BctrlV1, type BctrlV1Options } from './bctrl.js';
 export { BctrlError, BctrlApiError, BctrlAuthenticationError, BctrlConflictError, BctrlNetworkError, BctrlNotFoundError, BctrlNotReadyError, BctrlPermissionError, BctrlRateLimitError, BctrlUnsupportedError, BctrlValidationError, isControllerBusy, } from './errors.js';
-export { V2BrowserResource, V2SpaceBrowsersClient } from './browsers.js';
-export { V2FileResource, V2FilesClient, V2RunFilesClient } from './files.js';
-export { V2InvocationsClient, V2InvocationResource, V2RuntimeInvocationsClient, } from './invocations.js';
-export { V2RuntimeConnectionResource, V2RuntimeConnectionsClient, V2RuntimeFilesClient, V2RuntimeResource, V2RuntimeRunsClient, V2RuntimesClient, } from './runtimes.js';
-export { V2RunCommandsClient, V2RunEventsClient, V2RunResource, V2RunsClient, } from './runs.js';
-export { V2SpaceEnvironmentClient, V2SpaceResource, V2SpaceRuntimesClient, V2SpacesClient, } from './spaces.js';
+export { V1FileResource, V1FilesClient, V1RunFilesClient } from './files.js';
+export { V1InvocationsClient, V1InvocationResource, V1RuntimeBrowserUseInvocationsClient, V1RuntimeInvocationsClient, V1RuntimeStagehandInvocationsClient, } from './invocations.js';
+export type { BrowserUseAgentOptions, StagehandActOptions, StagehandAgentOptions, StagehandExtractOptions, StagehandObserveOptions, StagehandVariablePrimitive, StagehandVariableValue, StagehandVariables, } from './invocations.js';
+export { V1RuntimeConnectionResource, V1RuntimeConnectionsClient, V1RuntimeFilesClient, V1RuntimeResource, V1RuntimeRunsClient, V1RuntimesClient, } from './runtimes.js';
+export { V1RunCommandsClient, V1RunEventsClient, V1RunResource, V1RunsClient, } from './runs.js';
+export { V1SpaceEnvironmentClient, V1SpaceResource, V1SpaceRuntimesClient, V1SpacesClient, } from './spaces.js';
 export type * from './types.js';

package/dist/index.js

@@ -1,8 +1,7 @@
-export { Bctrl, BctrlV2 } from './bctrl.js';
+export { Bctrl, BctrlV1 } from './bctrl.js';
 export { BctrlError, BctrlApiError, BctrlAuthenticationError, BctrlConflictError, BctrlNetworkError, BctrlNotFoundError, BctrlNotReadyError, BctrlPermissionError, BctrlRateLimitError, BctrlUnsupportedError, BctrlValidationError, isControllerBusy, } from './errors.js';
-export { V2BrowserResource, V2SpaceBrowsersClient } from './browsers.js';
-export { V2FileResource, V2FilesClient, V2RunFilesClient } from './files.js';
-export { V2InvocationsClient, V2InvocationResource, V2RuntimeInvocationsClient, } from './invocations.js';
-export { V2RuntimeConnectionResource, V2RuntimeConnectionsClient, V2RuntimeFilesClient, V2RuntimeResource, V2RuntimeRunsClient, V2RuntimesClient, } from './runtimes.js';
-export { V2RunCommandsClient, V2RunEventsClient, V2RunResource, V2RunsClient, } from './runs.js';
-export { V2SpaceEnvironmentClient, V2SpaceResource, V2SpaceRuntimesClient, V2SpacesClient, } from './spaces.js';
+export { V1FileResource, V1FilesClient, V1RunFilesClient } from './files.js';
+export { V1InvocationsClient, V1InvocationResource, V1RuntimeBrowserUseInvocationsClient, V1RuntimeInvocationsClient, V1RuntimeStagehandInvocationsClient, } from './invocations.js';
+export { V1RuntimeConnectionResource, V1RuntimeConnectionsClient, V1RuntimeFilesClient, V1RuntimeResource, V1RuntimeRunsClient, V1RuntimesClient, } from './runtimes.js';
+export { V1RunCommandsClient, V1RunEventsClient, V1RunResource, V1RunsClient, } from './runs.js';
+export { V1SpaceEnvironmentClient, V1SpaceResource, V1SpaceRuntimesClient, V1SpacesClient, } from './spaces.js';

package/dist/invocations.d.ts

@@ -1,24 +1,86 @@
-import type { V2HttpClient } from './http.js';
-import type { V2Invocation, V2RuntimeInvocationCreateRequest, V2InvocationWaitRequest, V2InvocationWaitResponse } from './types.js';
-export declare class V2InvocationResource {
+import type { V1HttpClient } from './http.js';
+import type { JsonObject, V1Invocation, V1RuntimeInvocationCreateRequest, V1RuntimeInvocationFileInput, V1InvocationWaitRequest, V1InvocationWaitResponse } from './types.js';
+type JsonSchemaLike = JsonObject | {
+    toJSONSchema: () => unknown;
+};
+export type StagehandVariablePrimitive = string | number | boolean;
+export type StagehandVariableValue = StagehandVariablePrimitive | {
+    value: StagehandVariablePrimitive;
+    description?: string;
+};
+export type StagehandVariables = Record<string, StagehandVariableValue>;
+interface RuntimeInvocationCommonOptions {
+    target?: JsonObject;
+    idempotencyKey?: string;
+    metadata?: JsonObject;
+}
+interface RuntimeAgentCommonOptions extends RuntimeInvocationCommonOptions {
+    toolsetId?: string;
+    files?: V1RuntimeInvocationFileInput[];
+    outputSchema?: JsonObject;
+}
+export interface StagehandActOptions extends RuntimeInvocationCommonOptions {
+    instruction: string;
+    timeoutMs?: number;
+}
+export interface StagehandObserveOptions extends RuntimeInvocationCommonOptions {
+    instruction: string;
+    selector?: string;
+    timeoutMs?: number;
+}
+export type StagehandExtractOptions<TSchema extends JsonSchemaLike | undefined = undefined> = RuntimeInvocationCommonOptions & {
+    instruction: string;
+    schema?: TSchema;
+};
+export interface StagehandAgentOptions extends RuntimeAgentCommonOptions {
+    instruction: string;
+    maxSteps?: number;
+    timeoutMs?: number;
+    variables?: StagehandVariables;
+    config?: JsonObject;
+    options?: JsonObject;
+}
+export interface BrowserUseAgentOptions extends RuntimeAgentCommonOptions {
+    instruction: string;
+    maxSteps?: number;
+    config?: JsonObject;
+    options?: JsonObject;
+}
+export declare class V1InvocationResource {
     private readonly http;
-    readonly data: V2Invocation;
-    constructor(http: V2HttpClient, data: V2Invocation);
+    readonly data: V1Invocation;
+    constructor(http: V1HttpClient, data: V1Invocation);
     get id(): string;
-    refresh(): Promise<V2Invocation>;
-    wait(request?: V2InvocationWaitRequest): Promise<V2InvocationWaitResponse>;
-    cancel(): Promise<V2Invocation>;
+    refresh(): Promise<V1Invocation>;
+    wait(request?: V1InvocationWaitRequest): Promise<V1InvocationWaitResponse>;
+    cancel(): Promise<V1Invocation>;
 }
-export declare class V2InvocationsClient {
+export declare class V1InvocationsClient {
     private readonly http;
-    constructor(http: V2HttpClient);
-    get(id: string): Promise<V2InvocationResource>;
-    wait(id: string, request?: V2InvocationWaitRequest): Promise<V2InvocationWaitResponse>;
-    cancel(id: string): Promise<V2InvocationResource>;
+    constructor(http: V1HttpClient);
+    get(id: string): Promise<V1InvocationResource>;
+    wait(id: string, request?: V1InvocationWaitRequest): Promise<V1InvocationWaitResponse>;
+    cancel(id: string): Promise<V1InvocationResource>;
 }
-export declare class V2RuntimeInvocationsClient {
+export declare class V1RuntimeInvocationsClient {
     private readonly http;
     private readonly runtimeId;
-    constructor(http: V2HttpClient, runtimeId: string);
-    create(request: V2RuntimeInvocationCreateRequest): Promise<V2InvocationResource>;
+    readonly stagehand: V1RuntimeStagehandInvocationsClient;
+    readonly browserUse: V1RuntimeBrowserUseInvocationsClient;
+    constructor(http: V1HttpClient, runtimeId: string);
+    create(request: V1RuntimeInvocationCreateRequest): Promise<V1InvocationResource>;
+}
+export declare class V1RuntimeStagehandInvocationsClient {
+    private readonly invocations;
+    constructor(invocations: V1RuntimeInvocationsClient);
+    act(options: StagehandActOptions): Promise<V1InvocationResource>;
+    observe(options: StagehandObserveOptions): Promise<V1InvocationResource>;
+    extract<TSchema extends JsonSchemaLike | undefined = undefined>(options: StagehandExtractOptions<TSchema>): Promise<V1InvocationResource>;
+    agent(options: StagehandAgentOptions): Promise<V1InvocationResource>;
+}
+export declare class V1RuntimeBrowserUseInvocationsClient {
+    private readonly invocations;
+    constructor(invocations: V1RuntimeInvocationsClient);
+    agent(options: BrowserUseAgentOptions): Promise<V1InvocationResource>;
 }
+export {};