@bctrl/sdk 1.0.6 → 1.0.7

package/dist/generated/openapi-types.js

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export {};

package/dist/invocations.d.ts

@@ -22,9 +22,12 @@ interface AiSelectionOptions {
     model?: V1AiModelSelection;
     temperature?: number;
 }
+type StagehandActionInput = Extract<V1RuntimeInvocationCreateRequest, {
+    action: 'act';
+}>['stagehandAction'];
 export interface StagehandActOptions extends RuntimeInvocationCommonOptions, AiSelectionOptions {
     instruction: string;
-    stagehandAction?: JsonObject;
+    stagehandAction?: StagehandActionInput;
     timeoutMs?: number;
 }
 export interface StagehandObserveOptions extends RuntimeInvocationCommonOptions, AiSelectionOptions {

package/dist/node.d.ts

@@ -5,8 +5,106 @@ type V1HostedToolCreateRequest = Extract<V1ToolCreateRequest, {
 }>;
 export declare function createHostedToolFromFile(client: BctrlV1, request: Omit<V1HostedToolCreateRequest, 'source'> & {
     filePath: string;
-}): Promise<import("./types.js").V1Tool>;
+}): Promise<{
+    builtin: "files" | "vault" | "captcha";
+    createdAt: string;
+    description: string | null;
+    id: string;
+    inputSchema: {
+        [key: string]: unknown;
+    };
+    metadata?: import("./generated/openapi-types.js").components["schemas"]["ToolMetadata"] | null;
+    name: string;
+    outputSchema: {
+        [key: string]: unknown;
+    };
+    spaceId: string | null;
+    status: "enabled" | "disabled";
+    type: "builtin";
+    updatedAt: string;
+} | {
+    createdAt: string;
+    currentVersionId: string | null;
+    description: string | null;
+    id: string;
+    inputSchema: {
+        [key: string]: unknown;
+    };
+    metadata?: import("./generated/openapi-types.js").components["schemas"]["ToolMetadata"] | null;
+    name: string;
+    outputSchema: {
+        [key: string]: unknown;
+    };
+    spaceId: string | null;
+    status: "enabled" | "disabled";
+    type: "hosted";
+    updatedAt: string;
+} | {
+    createdAt: string;
+    description: string | null;
+    id: string;
+    inputSchema: {
+        [key: string]: unknown;
+    };
+    metadata?: import("./generated/openapi-types.js").components["schemas"]["ToolMetadata"] | null;
+    name: string;
+    outputSchema: {
+        [key: string]: unknown;
+    };
+    serverId: string;
+    spaceId: string | null;
+    status: "enabled" | "disabled";
+    toolName: string;
+    type: "mcp";
+    updatedAt: string;
+} | {
+    authSecretId?: string;
+    createdAt: string;
+    description: string | null;
+    id: string;
+    inputSchema: {
+        [key: string]: unknown;
+    };
+    metadata?: import("./generated/openapi-types.js").components["schemas"]["ToolMetadata"] | null;
+    name: string;
+    outputSchema: {
+        [key: string]: unknown;
+    };
+    spaceId: string | null;
+    status: "enabled" | "disabled";
+    timeoutMs?: number;
+    type: "webhook";
+    updatedAt: string;
+    url: string;
+} | {
+    createdAt: string;
+    description: string | null;
+    id: string;
+    inputSchema: {
+        [key: string]: unknown;
+    };
+    metadata?: import("./generated/openapi-types.js").components["schemas"]["ToolMetadata"] | null;
+    name: string;
+    outputSchema: {
+        [key: string]: unknown;
+    };
+    spaceId: string | null;
+    status: "enabled" | "disabled";
+    type: "workflow";
+    updatedAt: string;
+    workflowId: string;
+}>;
 export declare function createToolVersionFromFile(client: BctrlV1, toolId: string, request: Omit<V1ToolVersionCreateRequest, 'source'> & {
     filePath: string;
-}): Promise<import("./types.js").V1ToolVersion>;
+}): Promise<{
+    createdAt: string;
+    current: boolean;
+    envKeys: string[];
+    id: string;
+    metadata?: import("./generated/openapi-types.js").components["schemas"]["ToolMetadata"] | null;
+    source: string;
+    timeoutMs: number;
+    toolId: string;
+    version: number;
+}>;
 export {};

package/dist/openapi.d.ts

@@ -0,0 +1,7 @@
+import type { components, operations } from './generated/openapi-types.js';
+export type OpenApiSchemas = components['schemas'];
+export type OpenApiQuery<OperationId extends keyof operations> = operations[OperationId] extends {
+    parameters: {
+        query?: infer Query;
+    };
+} ? NonNullable<Query> : never;

package/dist/openapi.js

@@ -0,0 +1 @@
+export {};

package/dist/proxyTypes.d.ts

@@ -1,9 +1,10 @@
-export type V1ProxyProtocol = 'http' | 'socks5';
-export type V1ProxyDnsResolution = 'local' | 'proxy';
-export type V1ProxyType = 'custom' | 'managed-rotating' | 'managed-static';
-export type V1ManagedRotatingPreference = 'balanced' | 'speed' | 'quality' | 'coverage';
-export type V1ManagedRotatingRotation = 'sticky' | 'rotating';
-export type V1ManagedRotatingDevice = 'windows' | 'macos' | 'linux' | 'android' | 'ios';
+import type { OpenApiQuery, OpenApiSchemas } from './openapi.js';
+export type V1ProxyProtocol = NonNullable<OpenApiSchemas['ProxyManagedRotatingCreateRequest']['protocol']>;
+export type V1ProxyDnsResolution = NonNullable<OpenApiSchemas['ProxyManagedRotatingCreateRequest']['dnsResolution']>;
+export type V1ProxyType = OpenApiSchemas['Proxy']['type'];
+export type V1ManagedRotatingPreference = NonNullable<OpenApiSchemas['ProxyManagedRotatingCreateRequest']['preference']>;
+export type V1ManagedRotatingRotation = NonNullable<OpenApiSchemas['ProxyManagedRotatingCreateRequest']['rotation']>;
+export type V1ManagedRotatingDevice = NonNullable<OpenApiSchemas['ProxyManagedRotatingCreateRequest']['device']>;
 export interface V1ProxyBase {
     id: string;
     name: string;
@@ -11,109 +12,12 @@ export interface V1ProxyBase {
     createdAt: string;
     updatedAt: string;
 }
-export interface V1ManagedRotatingProxyConfig {
-    protocol?: V1ProxyProtocol;
-    dnsResolution?: V1ProxyDnsResolution;
-    ipFamily?: 'dual-stack' | 'ipv4-only';
-    preference?: V1ManagedRotatingPreference;
-    rotation?: V1ManagedRotatingRotation;
-    stickyKey?: string;
-    country?: string;
-    region?: string;
-    state?: string;
-    city?: string;
-    isp?: string;
-    geoStrict?: boolean;
-    device?: V1ManagedRotatingDevice;
-    deviceStrict?: boolean;
-}
-export type V1Proxy = (V1ProxyBase & {
-    type: 'custom';
-    protocol: V1ProxyProtocol;
-    dnsResolution?: V1ProxyDnsResolution;
-    host: string;
-    port: number;
-    username?: string | null;
-    hasPassword: boolean;
-}) | (V1ProxyBase & V1ManagedRotatingProxyConfig & {
-    type: 'managed-rotating';
-}) | (V1ProxyBase & {
-    type: 'managed-static';
-    status: 'provisioning' | 'active' | 'expired' | 'renewal_failed';
-    poolId: string;
-    autoRenew: boolean;
-    assignedIp?: string;
-    location?: {
-        country: string;
-        city?: string;
-    };
-    expiresAt?: string;
-    renewsAt?: string | null;
-    pricing?: {
-        priceCredits: number;
-        termDays: number;
-    };
-});
-export type V1ProxyCreateRequest = {
-    type: 'custom';
-    name?: string;
-    url?: string;
-    protocol?: V1ProxyProtocol;
-    dnsResolution?: V1ProxyDnsResolution;
-    host?: string;
-    port?: number;
-    username?: string;
-    password?: string;
-} | ({
-    type: 'managed-rotating';
-    name?: string;
-} & V1ManagedRotatingProxyConfig) | {
-    type: 'managed-static';
-    name?: string;
-    poolId: string;
-    autoRenew?: boolean;
-};
-export interface V1ProxyUpdateRequest extends Partial<V1ManagedRotatingProxyConfig> {
-    name?: string;
-    url?: string;
-    protocol?: V1ProxyProtocol;
-    dnsResolution?: V1ProxyDnsResolution;
-    host?: string;
-    port?: number;
-    username?: string | null;
-    password?: string | null;
-    autoRenew?: boolean;
-}
-interface V1ProxyPageQuery {
-    cursor?: string;
-    limit?: number;
-}
-export interface V1ProxyListQuery extends V1ProxyPageQuery {
-}
-export interface V1ProxyDeleteResponse {
-    id: string;
-    deleted: true;
-}
-export interface V1ProxyTestResponse {
-    ok: boolean;
-    latencyMs?: number;
-    error?: string;
-    httpStatus?: number | null;
-    exitIp?: string | null;
-    country?: string | null;
-}
-export interface V1ProxyPool {
-    id: string;
-    label: string;
-    country: string;
-    category: 'tickets' | 'sneakers' | 'social' | 'retail';
-    termDays: number;
-    priceCredits: number;
-    availableCount: number;
-}
-export interface V1ProxyPoolListQuery extends V1ProxyPageQuery {
-    country?: string;
-    category?: V1ProxyPool['category'];
-    available?: boolean;
-}
-export {};
+export type V1ManagedRotatingProxyConfig = Omit<OpenApiSchemas['ProxyManagedRotatingCreateRequest'], 'name' | 'type'>;
+export type V1Proxy = OpenApiSchemas['Proxy'];
+export type V1ProxyCreateRequest = OpenApiSchemas['ProxyCreateRequest'];
+export type V1ProxyUpdateRequest = OpenApiSchemas['ProxyUpdateRequest'];
+export type V1ProxyListQuery = OpenApiQuery<'proxies.list'>;
+export type V1ProxyDeleteResponse = OpenApiSchemas['ProxyDeleteResponse'];
+export type V1ProxyTestResponse = OpenApiSchemas['ProxyTestResponse'];
+export type V1ProxyPool = OpenApiSchemas['ProxyPool'];
+export type V1ProxyPoolListQuery = OpenApiQuery<'proxies.pools.list'>;

package/dist/runs.d.ts

@@ -1,5 +1,5 @@
 import { type V1HttpClient, type V1IdempotencyOptions } from './http.js';
-import type { V1ListEnvelope, V1File, V1InvocationSummary, V1Run, V1RunEvent, V1RunEventsListQuery, V1RunListQuery, V1RunLiveRequest, V1RunLiveResponse, V1RunRecordingRequest, V1RunRecordingResponse, V1RunActivityItem, V1RunActivityListQuery, V1RunFilesExportRequest, V1RunFilesListQuery, V1RunInvocationsListQuery, V1RunUsage } from './types.js';
+import type { V1ListEnvelope, V1File, V1Run, V1RunEvent, V1RunEventsListQuery, V1RunListQuery, V1RunLiveRequest, V1RunLiveResponse, V1RunRecordingRequest, V1RunRecordingResponse, V1RunActivityItem, V1RunActivityListQuery, V1RunFilesExportRequest, V1RunFilesListQuery, V1RunInvocationsListQuery, V1RunUsage } from './types.js';
 export declare class V1RunsClient {
     private readonly http;
     readonly events: V1RunEventsNamespaceClient;
@@ -31,14 +31,94 @@ export declare class V1RunActivityNamespaceClient {
 export declare class V1RunFilesNamespaceClient {
     private readonly http;
     constructor(http: V1HttpClient);
-    list(runId: string, query?: V1RunFilesListQuery): Promise<V1ListEnvelope<V1File>>;
-    iter(runId: string, query?: V1RunFilesListQuery): AsyncGenerator<V1File, void, undefined>;
+    list(runId: string, query?: V1RunFilesListQuery): Promise<V1ListEnvelope<{
+        contentType: string;
+        createdAt: string;
+        downloadUrl: string;
+        expiresAt?: string;
+        id: string;
+        metadata?: import("./generated/openapi-types.js").components["schemas"]["JsonObject"] | null;
+        name: string;
+        path: string;
+        runId?: string;
+        runtimeId?: string;
+        sizeBytes: number;
+        source: "upload" | "runtime";
+        spaceId: string;
+        type?: string;
+    }>>;
+    iter(runId: string, query?: V1RunFilesListQuery): AsyncGenerator<{
+        contentType: string;
+        createdAt: string;
+        downloadUrl: string;
+        expiresAt?: string;
+        id: string;
+        metadata?: import("./generated/openapi-types.js").components["schemas"]["JsonObject"] | null;
+        name: string;
+        path: string;
+        runId?: string;
+        runtimeId?: string;
+        sizeBytes: number;
+        source: "upload" | "runtime";
+        spaceId: string;
+        type?: string;
+    }, void, undefined>;
     export(runId: string, request?: V1RunFilesExportRequest, options?: V1IdempotencyOptions): Promise<V1File>;
 }
 export declare class V1RunInvocationsNamespaceClient {
     private readonly http;
     constructor(http: V1HttpClient);
-    list(runId: string, query?: V1RunInvocationsListQuery): Promise<V1ListEnvelope<V1InvocationSummary>>;
-    iter(runId: string, query?: V1RunInvocationsListQuery): AsyncGenerator<V1InvocationSummary, void, undefined>;
-    get(runId: string, invocationId: string): Promise<import("./types.js").V1Invocation>;
+    list(runId: string, query?: V1RunInvocationsListQuery): Promise<V1ListEnvelope<{
+        action: "act" | "observe" | "extract" | "browserUse" | "stagehandAgent" | "solveCaptcha";
+        createdAt: string;
+        durationMs?: number | null;
+        error?: {
+            code?: string;
+            details?: {
+                [key: string]: unknown;
+            };
+            message: string;
+        } | null;
+        finishedAt?: string | null;
+        id: string;
+        runId: string;
+        runtimeId: string;
+        status: "queued" | "dispatching" | "running" | "cancelling" | "succeeded" | "failed" | "cancelled" | "timed_out";
+    }>>;
+    iter(runId: string, query?: V1RunInvocationsListQuery): AsyncGenerator<{
+        action: "act" | "observe" | "extract" | "browserUse" | "stagehandAgent" | "solveCaptcha";
+        createdAt: string;
+        durationMs?: number | null;
+        error?: {
+            code?: string;
+            details?: {
+                [key: string]: unknown;
+            };
+            message: string;
+        } | null;
+        finishedAt?: string | null;
+        id: string;
+        runId: string;
+        runtimeId: string;
+        status: "queued" | "dispatching" | "running" | "cancelling" | "succeeded" | "failed" | "cancelled" | "timed_out";
+    }, void, undefined>;
+    get(runId: string, invocationId: string): Promise<{
+        action: "act" | "observe" | "extract" | "browserUse" | "stagehandAgent" | "solveCaptcha";
+        createdAt: string;
+        durationMs?: number | null;
+        error?: {
+            code: "invocation.failed" | "invocation.cancelled" | "invocation.timed_out" | "invocation.dispatch_preparation_failed" | "invocation.dispatch_unavailable" | "invocation.captcha_not_found" | "invocation.captcha_solve_failed" | "invocation.output_validation_failed" | "invocation.stagehand_failed" | "invocation.stagehand_incomplete" | "invocation.browser_use_failed" | "invocation.browser_use_interrupted" | "invocation.browser_use_incomplete";
+            details?: {
+                [key: string]: unknown;
+            };
+            message: string;
+        } | null;
+        finishedAt?: string | null;
+        id: string;
+        output?: import("./generated/openapi-types.js").components["schemas"]["JsonValue"];
+        runId: string;
+        runtimeId: string;
+        startedAt?: string | null;
+        status: "queued" | "dispatching" | "running" | "cancelling" | "succeeded" | "failed" | "cancelled" | "timed_out";
+    }>;
 }

package/dist/runtimes.js

@@ -1,4 +1,3 @@
-import { BctrlValidationError } from './errors.js';
 import { v1IdempotencyHeaders } from './http.js';
 import { V1RuntimeInvocationsNamespaceClient } from './invocations.js';
 import { iterateV1Pages } from './pagination.js';
@@ -88,15 +87,6 @@ class V1RuntimeTargetsClient {
         return this.http.request(`/runtimes/${encodeURIComponent(this.runtimeId)}/targets/${encodeURIComponent(targetId)}`, { method: 'DELETE' });
     }
 }
-function validateRuntimeCreateRequest(request) {
-    const profileBacked = request.config?.profile === true;
-    if (!profileBacked)
-        return;
-    const unsupported = ['stealth', 'fingerprint', 'extensionIds'].filter((key) => request.config?.[key] !== undefined);
-    if (unsupported.length > 0) {
-        throw new BctrlValidationError('Only config.profile, config.proxy, config.autoUpgrade, config.idleTimeoutMinutes, config.webRtcProxyOnly, config.forceOpenShadowRoots, and config.networkTraffic are supported for profile-backed browser runtimes', 'runtime.profile_config_unsupported', { unsupported });
-    }
-}
 export class V1RuntimesClient {
     http;
     files;
@@ -117,14 +107,12 @@ export class V1RuntimesClient {
         return iterateV1Pages(query, (pageQuery) => this.list(pageQuery));
     }
     async create(request) {
-        validateRuntimeCreateRequest(request);
         return this.http.request('/runtimes', {
             method: 'POST',
             body: request,
         });
     }
     async createInSpace(spaceId, request) {
-        validateRuntimeCreateRequest(request);
         return this.http.request('/runtimes', {
             method: 'POST',
             body: { ...request, spaceId },

package/dist/toolCallTypes.d.ts

@@ -1,41 +1,6 @@
-import type { JsonObject, JsonValue, V1PageQuery, V1ToolType } from './types.js';
-export type V1ToolCallActor = 'test' | 'agent' | 'invocation';
-export type V1ToolCallStatus = 'succeeded' | 'failed';
-export interface V1ToolCallTool {
-    id: string;
-    name: string;
-    type: V1ToolType;
-}
-export interface V1ToolCall {
-    id: string;
-    toolCallId: string;
-    spaceId: string;
-    runId?: string | null;
-    invocationId?: string | null;
-    toolsetId?: string | null;
-    tool: V1ToolCallTool;
-    actor: V1ToolCallActor;
-    status: V1ToolCallStatus;
-    redactedInput?: JsonValue;
-    redactedOutput?: JsonValue;
-    redactedError?: JsonObject | null;
-    inputSummary?: JsonObject | null;
-    outputSummary?: JsonObject | null;
-    error?: {
-        code: string;
-        message: string;
-        details?: JsonObject;
-    } | null;
-    startedAt: string;
-    finishedAt: string;
-    durationMs: number;
-    createdAt: string;
-}
-export interface V1ToolCallListQuery extends V1PageQuery {
-    spaceId?: string;
-    runId?: string;
-    invocationId?: string;
-    toolId?: string;
-    status?: V1ToolCallStatus;
-    actor?: V1ToolCallActor;
-}
+import type { OpenApiQuery, OpenApiSchemas } from './openapi.js';
+export type V1ToolCallActor = OpenApiSchemas['ToolCall']['actor'];
+export type V1ToolCallStatus = OpenApiSchemas['ToolCall']['status'];
+export type V1ToolCallTool = OpenApiSchemas['ToolCallTool'];
+export type V1ToolCall = OpenApiSchemas['ToolCall'];
+export type V1ToolCallListQuery = OpenApiQuery<'tool-calls.list'>;

package/dist/toolsetTypes.d.ts

@@ -1,32 +1,7 @@
-import type { JsonObject, V1PageQuery } from './types.js';
-export type V1ToolsetBuiltinName = 'files' | 'vault' | 'captcha';
-export interface V1Toolset {
-    id: string;
-    spaceId: string;
-    name: string;
-    builtins: V1ToolsetBuiltinName[];
-    toolIds: string[];
-    metadata?: JsonObject | null;
-    createdAt: string;
-    updatedAt: string;
-}
-export interface V1ToolsetListQuery extends V1PageQuery {
-    spaceId?: string;
-}
-export interface V1ToolsetCreateRequest {
-    spaceId?: string;
-    name: string;
-    builtins?: V1ToolsetBuiltinName[];
-    toolIds?: string[];
-    metadata?: JsonObject | null;
-}
-export interface V1ToolsetUpdateRequest {
-    name?: string;
-    builtins?: V1ToolsetBuiltinName[];
-    toolIds?: string[];
-    metadata?: JsonObject | null;
-}
-export interface V1ToolsetDeleteResponse {
-    id: string;
-    deleted: true;
-}
+import type { OpenApiQuery, OpenApiSchemas } from './openapi.js';
+export type V1ToolsetBuiltinName = OpenApiSchemas['Toolset']['builtins'][number];
+export type V1Toolset = OpenApiSchemas['Toolset'];
+export type V1ToolsetListQuery = OpenApiQuery<'toolsets.list'>;
+export type V1ToolsetCreateRequest = OpenApiSchemas['ToolsetCreateRequest'];
+export type V1ToolsetUpdateRequest = OpenApiSchemas['ToolsetUpdateRequest'];
+export type V1ToolsetDeleteResponse = OpenApiSchemas['ToolsetDeleteResponse'];