@bctrl/sdk 1.0.2 → 1.0.3

package/dist/spaces.js

@@ -1,7 +1,6 @@
-import { V2SpaceBrowsersClient } from './browsers.js';
-import { iterateV2Pages } from './pagination.js';
-import { V2RuntimesClient } from './runtimes.js';
-export class V2SpaceEnvironmentClient {
+import { iterateV1Pages } from './pagination.js';
+import { V1RuntimesClient } from './runtimes.js';
+export class V1SpaceEnvironmentClient {
     http;
     spaceId;
     constructor(http, spaceId) {
@@ -18,7 +17,7 @@ export class V2SpaceEnvironmentClient {
         });
     }
 }
-export class V2SpaceRuntimesClient {
+export class V1SpaceRuntimesClient {
     http;
     spaceId;
     constructor(http, spaceId) {
@@ -26,45 +25,46 @@ export class V2SpaceRuntimesClient {
         this.spaceId = spaceId;
     }
     list(query = {}) {
-        return new V2RuntimesClient(this.http).list({ ...query, spaceId: this.spaceId });
+        return new V1RuntimesClient(this.http).list({ ...query, spaceId: this.spaceId });
     }
     iter(query = {}) {
-        return new V2RuntimesClient(this.http).iter({ ...query, spaceId: this.spaceId });
+        return new V1RuntimesClient(this.http).iter({ ...query, spaceId: this.spaceId });
     }
     async create(request) {
-        return new V2RuntimesClient(this.http).createInSpace(this.spaceId, request);
+        return new V1RuntimesClient(this.http).createInSpace(this.spaceId, request);
     }
     async get(runtimeId) {
-        return new V2RuntimesClient(this.http).get(runtimeId);
+        return new V1RuntimesClient(this.http).get(runtimeId);
     }
     stop(runtimeId) {
-        return new V2RuntimesClient(this.http).stop(runtimeId);
+        return new V1RuntimesClient(this.http).stop(runtimeId);
+    }
+    start(runtimeId) {
+        return new V1RuntimesClient(this.http).start(runtimeId);
     }
 }
-export class V2SpaceResource {
+export class V1SpaceResource {
     http;
     data;
     environment;
     runtimes;
-    browsers;
     constructor(http, data) {
         this.http = http;
         this.data = data;
-        this.environment = new V2SpaceEnvironmentClient(http, data.id);
-        this.runtimes = new V2SpaceRuntimesClient(http, data.id);
-        this.browsers = new V2SpaceBrowsersClient(http, data.id);
+        this.environment = new V1SpaceEnvironmentClient(http, data.id);
+        this.runtimes = new V1SpaceRuntimesClient(http, data.id);
     }
     get id() {
         return this.data.id;
     }
     refresh() {
-        return new V2SpacesClient(this.http).get(this.id);
+        return new V1SpacesClient(this.http).get(this.id);
     }
     async update(request) {
-        return new V2SpacesClient(this.http).update(this.id, request);
+        return new V1SpacesClient(this.http).update(this.id, request);
     }
 }
-export class V2SpacesClient {
+export class V1SpacesClient {
     http;
     constructor(http) {
         this.http = http;
@@ -73,24 +73,24 @@ export class V2SpacesClient {
         return this.http.request('/spaces');
     }
     iter() {
-        return iterateV2Pages({}, () => this.list());
+        return iterateV1Pages({}, () => this.list());
     }
     async create(request) {
         const space = await this.http.request('/spaces', {
             method: 'POST',
             body: request,
         });
-        return new V2SpaceResource(this.http, space);
+        return new V1SpaceResource(this.http, space);
     }
     async get(id) {
         const space = await this.http.request(`/spaces/${encodeURIComponent(id)}`);
-        return new V2SpaceResource(this.http, space);
+        return new V1SpaceResource(this.http, space);
     }
     async update(id, request) {
         const space = await this.http.request(`/spaces/${encodeURIComponent(id)}`, {
             method: 'PATCH',
             body: request,
         });
-        return new V2SpaceResource(this.http, space);
+        return new V1SpaceResource(this.http, space);
     }
 }

package/dist/types.d.ts

@@ -3,23 +3,23 @@ export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
 export type JsonObject = {
     [key: string]: JsonValue;
 };
-export interface V2ListEnvelope<T> {
+export interface V1ListEnvelope<T> {
     data: T[];
     nextCursor: string | null;
 }
-export interface V2PageQuery {
+export interface V1PageQuery {
     cursor?: string;
     limit?: number;
 }
-export interface V2SpaceCreateRequest {
+export interface V1SpaceCreateRequest {
     name: string;
     region: string;
     subaccountId?: string | null;
 }
-export interface V2SpaceUpdateRequest {
+export interface V1SpaceUpdateRequest {
     name?: string;
 }
-export interface V2Space {
+export interface V1Space {
     id: string;
     name: string;
     region: string;
@@ -27,18 +27,18 @@ export interface V2Space {
     createdAt: string;
     updatedAt: string;
 }
-export interface V2SpaceEnvironment {
+export interface V1SpaceEnvironment {
     spaceId: string;
     mounts: JsonObject;
     updatedAt: string;
 }
-export interface V2SpaceEnvironmentUpdateRequest {
+export interface V1SpaceEnvironmentUpdateRequest {
     mounts: JsonObject;
 }
-export type V2RuntimeType = 'browser';
-export type V2RuntimeStatus = 'active' | 'stopped' | 'failed';
-export type V2BrowserStealth = 'medium' | 'high' | 'ultra';
-export type V2ProxyInput = {
+export type V1RuntimeType = 'browser';
+export type V1RuntimeStatus = 'active' | 'stopped' | 'failed';
+export type V1BrowserStealth = 'medium' | 'high' | 'ultra';
+export type V1ProxyInput = {
     mode: 'custom';
     protocol: string;
     host: string;
@@ -50,51 +50,51 @@ export type V2ProxyInput = {
     id: string;
     overrides?: JsonObject;
 };
-export interface V2RuntimeFingerprintCreateConfig {
+export interface V1RuntimeFingerprintCreateConfig {
     browser?: string;
     locale?: string;
 }
-export interface V2RuntimeLifecycleConfig {
+export interface V1RuntimeLifecycleConfig {
     idleTimeoutMinutes?: number;
 }
-export interface V2BrowserRuntimeCreateConfig {
+export interface V1BrowserRuntimeCreateConfig {
     browser?: {
         profile?: boolean;
     };
-    stealth?: V2BrowserStealth;
-    proxy?: V2ProxyInput | null;
-    fingerprint?: V2RuntimeFingerprintCreateConfig;
+    stealth?: V1BrowserStealth;
+    proxy?: V1ProxyInput | null;
+    fingerprint?: V1RuntimeFingerprintCreateConfig;
     extensions?: string[];
-    lifecycle?: V2RuntimeLifecycleConfig;
+    lifecycle?: V1RuntimeLifecycleConfig;
 }
-export interface V2RuntimeCreateRequest {
+export interface V1RuntimeCreateRequest {
     spaceId: string;
-    type: V2RuntimeType;
+    type: V1RuntimeType;
     name?: string;
     metadata?: JsonObject;
-    config?: V2BrowserRuntimeCreateConfig;
+    config?: V1BrowserRuntimeCreateConfig;
 }
-export type V2SpaceRuntimeCreateRequest = Omit<V2RuntimeCreateRequest, 'spaceId'>;
-export interface V2RuntimeListQuery {
+export type V1SpaceRuntimeCreateRequest = Omit<V1RuntimeCreateRequest, 'spaceId'>;
+export interface V1RuntimeListQuery {
     spaceId?: string;
     status?: string | string[];
     limit?: number;
 }
-export interface V2RuntimeSummary {
+export interface V1RuntimeSummary {
     id: string;
     name: string;
-    type: V2RuntimeType;
-    status: V2RuntimeStatus;
+    type: V1RuntimeType;
+    status: V1RuntimeStatus;
     activeRunId: string | null;
     createdAt: string;
     updatedAt: string;
 }
-export interface V2Runtime extends V2RuntimeSummary {
+export interface V1Runtime extends V1RuntimeSummary {
     config?: JsonObject;
     metadata?: JsonObject | null;
 }
-export type V2ConnectionProtocol = 'cdp' | 'cua' | 'rdp' | 'vnc' | 'mcp' | 'http';
-export type V2ConnectionEndpoint = {
+export type V1ConnectionProtocol = 'cdp' | 'cua' | 'rdp' | 'vnc' | 'mcp' | 'http';
+export type V1ConnectionEndpoint = {
     type: 'websocket';
     url: string;
 } | {
@@ -110,14 +110,14 @@ export type V2ConnectionEndpoint = {
     type: 'composite';
     endpoints: Record<string, string>;
 };
-export interface V2RuntimeConnectionCreateRequest {
+export interface V1RuntimeConnectionCreateRequest {
     protocol: 'cdp';
     options?: JsonObject;
 }
-export type V2RuntimeConnectionCreateOptions = Partial<V2RuntimeConnectionCreateRequest>;
-export interface V2RuntimeConnection {
+export type V1RuntimeConnectionCreateOptions = Partial<V1RuntimeConnectionCreateRequest>;
+export interface V1RuntimeConnection {
     id: string;
-    protocol: V2ConnectionProtocol;
+    protocol: V1ConnectionProtocol;
     status: string;
     runId: string;
     createdAt: string;
@@ -125,27 +125,27 @@ export interface V2RuntimeConnection {
     closedAt?: string | null;
     revokedAt?: string | null;
 }
-export interface V2RuntimeConnectionCreateResponse extends V2RuntimeConnection {
-    endpoint: V2ConnectionEndpoint;
+export interface V1RuntimeConnectionCreateResponse extends V1RuntimeConnection {
+    endpoint: V1ConnectionEndpoint;
 }
-export interface V2RuntimeStartResponse {
-    runtime: V2Runtime;
-    run: V2Run;
+export interface V1RuntimeStartResponse {
+    runtime: V1Runtime;
+    run: V1Run;
 }
-export interface V2RunListQuery extends V2PageQuery {
+export interface V1RunListQuery extends V1PageQuery {
     status?: string | string[];
     spaceId?: string;
     runtimeId?: string;
 }
-export type V2RuntimeRunListQuery = Omit<V2RunListQuery, 'spaceId' | 'runtimeId'>;
-export interface V2RunSummary {
+export type V1RuntimeRunListQuery = Omit<V1RunListQuery, 'spaceId' | 'runtimeId'>;
+export interface V1RunSummary {
     id: string;
     status: string;
     createdAt: string;
     startedAt: string;
     finishedAt?: string | null;
 }
-export interface V2Run extends V2RunSummary {
+export interface V1Run extends V1RunSummary {
     spaceId: string;
     runtimeId: string;
     runtimeType: string;
@@ -154,7 +154,44 @@ export interface V2Run extends V2RunSummary {
     endedReason?: string | null;
     failureReason?: string | null;
 }
-export interface V2RunEvent {
+export interface V1RunUsage {
+    runId: string;
+    runtimeId: string;
+    runtimeType: string;
+    status: string;
+    computedAt: string;
+    usage: {
+        runtime: {
+            seconds: number | null;
+            billingClass: string | null;
+        };
+        aiTokens: {
+            input: number | null;
+            output: number | null;
+            total: number | null;
+        };
+        proxyBytes: number | null;
+        captchaSolves: number;
+        files: {
+            count: number;
+            bytes: number;
+        };
+        invocations: number;
+        toolCalls: number;
+    };
+    billing: {
+        status: 'pending' | 'settled' | 'unavailable';
+        creditCost: number | null;
+        breakdown: {
+            runtime: number | null;
+            ai: number | null;
+            proxy: number | null;
+            captcha: number | null;
+            files: number | null;
+        };
+    };
+}
+export interface V1RunEvent {
     id: string;
     runId: string;
     runtimeId: string;
@@ -171,48 +208,48 @@ export interface V2RunEvent {
     name?: string;
     data?: JsonObject;
 }
-export interface V2RunEventsListQuery extends V2PageQuery {
+export interface V1RunEventsListQuery extends V1PageQuery {
     type?: string | string[];
     category?: string | string[];
     connectionId?: string;
 }
-export interface V2RunEventsWaitRequest {
+export interface V1RunEventsWaitRequest {
     cursor?: string;
     timeoutMs?: number;
     type?: string[];
     category?: string[];
     connectionId?: string;
 }
-export interface V2RunEventsWaitResponse {
-    data: V2RunEvent | null;
+export interface V1RunEventsWaitResponse {
+    data: V1RunEvent | null;
     cursor: string | null;
     timedOut: boolean;
 }
-export type V2RunCommand = V2RunEvent & {
+export type V1RunCommand = V1RunEvent & {
     category: 'command';
 };
-export interface V2RunCommandsListQuery extends V2PageQuery {
+export interface V1RunCommandsListQuery extends V1PageQuery {
     type?: string | string[];
     connectionId?: string;
 }
-export interface V2RunLiveRequest {
+export interface V1RunLiveRequest {
     control?: string;
     expiresInSeconds?: number;
 }
-export interface V2RunLiveResponse {
+export interface V1RunLiveResponse {
     iframeUrl: string;
     expiresAt: string;
 }
-export interface V2RunRecordingRequest {
+export interface V1RunRecordingRequest {
     expiresInSeconds?: number;
 }
-export interface V2RunRecordingResponse {
+export interface V1RunRecordingResponse {
     iframeUrl: string;
     status: string;
     durationMs?: number;
     expiresAt: string;
 }
-export interface V2Invocation {
+export interface V1Invocation {
     id: string;
     runId: string;
     spaceId: string;
@@ -230,32 +267,32 @@ export interface V2Invocation {
     durationMs?: number | null;
     metadata?: JsonObject | null;
 }
-export interface V2InvocationResponse {
-    data: V2Invocation;
+export interface V1InvocationResponse {
+    data: V1Invocation;
 }
-export interface V2InvocationWaitRequest {
+export interface V1InvocationWaitRequest {
     timeoutMs?: number;
 }
-export interface V2InvocationWaitResponse {
-    data: V2Invocation;
+export interface V1InvocationWaitResponse {
+    data: V1Invocation;
     timedOut: boolean;
 }
-export type V2RuntimeInvocationFileInput = {
+export type V1RuntimeInvocationFileInput = {
     storagePath: string;
     name?: string;
 } | {
     fileId: string;
     name?: string;
 };
-interface V2RuntimeInvocationAgentFields {
+interface V1RuntimeInvocationAgentFields {
     target?: JsonObject;
     idempotencyKey?: string;
     outputSchema?: JsonObject;
     toolsetId?: string;
     metadata?: JsonObject;
-    files?: V2RuntimeInvocationFileInput[];
+    files?: V1RuntimeInvocationFileInput[];
 }
-export type V2RuntimeInvocationCreateRequest = {
+export type V1RuntimeInvocationCreateRequest = {
     provider: 'stagehand';
     method: 'act' | 'observe';
     target?: JsonObject;
@@ -270,13 +307,13 @@ export type V2RuntimeInvocationCreateRequest = {
     outputSchema?: JsonObject;
     idempotencyKey?: string;
     metadata?: JsonObject;
-} | (V2RuntimeInvocationAgentFields & {
+} | (V1RuntimeInvocationAgentFields & {
     provider: 'stagehand';
     method: 'agent';
     input: JsonObject;
     config?: JsonObject;
     options?: JsonObject;
-}) | (V2RuntimeInvocationAgentFields & {
+}) | (V1RuntimeInvocationAgentFields & {
     provider: 'browserUse';
     method: 'agent';
     input: JsonObject;
@@ -290,7 +327,7 @@ export type V2RuntimeInvocationCreateRequest = {
     idempotencyKey?: string;
     metadata?: JsonObject;
 };
-export interface V2File {
+export interface V1File {
     id: string;
     type: string;
     source: 'upload' | 'runtime' | 'system';
@@ -306,7 +343,7 @@ export interface V2File {
     expiresAt?: string | null;
     downloadUrl?: string;
 }
-export interface V2FilesListQuery extends V2PageQuery {
+export interface V1FilesListQuery extends V1PageQuery {
     spaceId: string;
     source?: 'upload' | 'runtime' | 'system';
     path?: string;
@@ -314,38 +351,38 @@ export interface V2FilesListQuery extends V2PageQuery {
     query?: string;
     contentType?: string;
 }
-export interface V2FileUpdateRequest {
+export interface V1FileUpdateRequest {
     name?: string;
     metadata?: JsonObject | null;
 }
-export interface V2FileDeleteResponse {
+export interface V1FileDeleteResponse {
     success: true;
 }
-export interface V2FileUploadRequest {
+export interface V1FileUploadRequest {
     spaceId: string;
     file: Blob;
     name?: string;
     path?: string;
     metadata?: JsonObject;
 }
-export interface V2RunFilesListQuery extends V2PageQuery {
+export interface V1RunFilesListQuery extends V1PageQuery {
     type?: string | string[];
 }
-export interface V2RunFilesExportRequest {
+export interface V1RunFilesExportRequest {
     format: 'zip';
     name: string;
     filter?: {
         type?: string[];
     };
 }
-export type V2RuntimeFileStageRequest = {
+export type V1RuntimeFileStageRequest = {
     storagePath: string;
     name?: string;
 } | {
     fileId: string;
     name?: string;
 };
-export interface V2RuntimeStagedFile {
+export interface V1RuntimeStagedFile {
     id: string;
     runtimeId: string;
     runtimePath: string;
@@ -353,17 +390,17 @@ export interface V2RuntimeStagedFile {
     sizeBytes: number;
     expiresAt: string | null;
 }
-export interface V2RuntimeFileUploadRequest {
+export interface V1RuntimeFileUploadRequest {
     file: Blob;
     name?: string;
     storagePath?: string;
     metadata?: JsonObject;
 }
-export interface V2RuntimeFileUploadResponse {
-    file: V2File;
-    staged: V2RuntimeStagedFile;
+export interface V1RuntimeFileUploadResponse {
+    file: V1File;
+    staged: V1RuntimeStagedFile;
 }
-export interface V2RuntimeFileCollectRequest {
+export interface V1RuntimeFileCollectRequest {
     path: string;
     storagePath?: string;
     name?: string;
@@ -373,14 +410,4 @@ export interface V2RuntimeFileCollectRequest {
         metadata?: JsonObject;
     };
 }
-export interface BrowserLaunchOptions {
-    name: string;
-    state?: 'ephemeral' | 'profile';
-    metadata?: JsonObject;
-    lifecycle?: V2RuntimeLifecycleConfig;
-    stealth?: V2BrowserStealth;
-    proxy?: V2ProxyInput | null;
-    fingerprint?: V2RuntimeFingerprintCreateConfig;
-    extensions?: string[];
-}
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bctrl/sdk",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "BCTRL SDK - Remote browser automation",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,9 +11,20 @@
       "import": "./dist/index.js"
     }
   },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "pnpm run clean && tsc -p tsconfig.json",
+    "prepack": "pnpm run build",
+    "dev": "tsc --watch",
+    "test": "tsx --test tests/v1/*.test.ts tests/v1/e2e/*.test.ts",
+    "test:v1": "tsx --test tests/v1/*.test.ts tests/v1/e2e/*.test.ts",
+    "test:v1:e2e": "BCTRL_E2E=1 tsx --test tests/v1/e2e/**/*.test.ts",
+    "typecheck": "tsc --noEmit"
+  },
   "keywords": [],
   "author": "",
   "license": "ISC",
+  "packageManager": "pnpm@10.12.4",
   "devDependencies": {
     "@types/node": "^25.0.3",
     "@typescript-eslint/eslint-plugin": "^8.56.0",
@@ -24,14 +35,5 @@
   },
   "files": [
     "dist"
-  ],
-  "scripts": {
-    "clean": "rm -rf dist",
-    "build": "pnpm run clean && tsc -p tsconfig.json",
-    "dev": "tsc --watch",
-    "test": "tsx --test tests/v2/*.test.ts tests/v2/e2e/*.test.ts",
-    "test:v2": "tsx --test tests/v2/*.test.ts tests/v2/e2e/*.test.ts",
-    "test:v2:e2e": "BCTRL_E2E=1 tsx --test tests/v2/e2e/**/*.test.ts",
-    "typecheck": "tsc --noEmit"
-  }
-}
+  ]
+}

package/dist/browsers.d.ts

@@ -1,24 +0,0 @@
-import type { V2HttpClient } from './http.js';
-import type { V2RuntimeInvocationsClient } from './invocations.js';
-import { V2RuntimeConnectionResource, V2RuntimeResource } from './runtimes.js';
-import { V2RunResource } from './runs.js';
-import type { BrowserLaunchOptions, V2Runtime, V2RuntimeConnectionCreateOptions } from './types.js';
-export declare class V2BrowserResource {
-    private readonly http;
-    private readonly spaceId;
-    readonly runtime: V2RuntimeResource;
-    constructor(http: V2HttpClient, spaceId: string, runtime: V2RuntimeResource);
-    get id(): string;
-    get data(): V2Runtime;
-    get invocations(): V2RuntimeInvocationsClient;
-    connect(request?: V2RuntimeConnectionCreateOptions): Promise<V2RuntimeConnectionResource>;
-    run(): Promise<V2RunResource>;
-    stop(): Promise<V2Runtime>;
-    refresh(): Promise<V2BrowserResource>;
-}
-export declare class V2SpaceBrowsersClient {
-    private readonly http;
-    private readonly spaceId;
-    constructor(http: V2HttpClient, spaceId: string);
-    launch(options: BrowserLaunchOptions): Promise<V2BrowserResource>;
-}