@bctrl/sdk 1.0.5 → 1.0.7

package/dist/types.d.ts

@@ -3,8 +3,10 @@ export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
 export type JsonObject = {
     [key: string]: JsonValue;
 };
+import type { V1ManagedRotatingProxyConfig, V1ProxyDnsResolution, V1ProxyProtocol } from './proxyTypes.js';
+import type { OpenApiQuery, OpenApiSchemas } from './openapi.js';
 export type { V1AccountUsage, V1ApiKey, V1ApiKeyCreateRequest, V1ApiKeyCreateResponse, V1ApiKeyDeleteResponse, V1ApiKeyListQuery, V1AuthScope, V1AuthWhoamiResponse, V1Plan, V1Subaccount, V1SubaccountArchiveResponse, V1SubaccountCreateRequest, V1SubaccountGetQuery, V1SubaccountLimits, V1SubaccountListQuery, V1SubaccountUpdateRequest, V1SubaccountUsage, V1SubaccountUsageListQuery, V1SubaccountUsageListResponse, } from './accountTypes.js';
-export type { V1AiProvider, V1AiProviderCreateRequest, V1AiProviderDeleteResponse, V1AiProviderGetQuery, V1AiProviderListQuery, V1AiProviderModel, V1AiProviderProvider, V1AiProviderStatus, V1AiProviderTestResponse, V1AiProviderUpdateRequest, } from './aiProviderTypes.js';
+export type { V1AiCredential, V1AiCredentialCreateRequest, V1AiCredentialDeleteResponse, V1AiCredentialListQuery, V1AiCredentialProvider, V1AiCredentialStatus, V1AiCredentialTestResponse, V1AiCredentialUpdateRequest, V1AiModel, V1AiModelEngine, V1AiModelListQuery, V1AiModelListResponse, V1AiModelSelection, V1AiModelSelectionAuth, V1AiModelSelectionObject, V1AiModelStatus, V1AiStoredModelSelection, V1AiStoredModelSelectionAuth, } from './aiTypes.js';
 export type { V1BrowserExtension, V1BrowserExtensionDeleteResponse, V1BrowserExtensionFormat, V1BrowserExtensionImportRequest, V1BrowserExtensionListQuery, V1BrowserExtensionSource, V1BrowserExtensionUpdateRequest, V1BrowserExtensionUploadRequest, } from './browserExtensionTypes.js';
 export type { V1ToolCall, V1ToolCallActor, V1ToolCallListQuery, V1ToolCallStatus, V1ToolCallTool, } from './toolCallTypes.js';
 export type { V1Toolset, V1ToolsetBuiltinName, V1ToolsetCreateRequest, V1ToolsetDeleteResponse, V1ToolsetListQuery, V1ToolsetUpdateRequest, } from './toolsetTypes.js';
@@ -16,249 +18,78 @@ export interface V1PageQuery {
     cursor?: string;
     limit?: number;
 }
-export type V1HelpAudience = 'api' | 'sdk' | 'cli';
-export interface V1HelpRequest {
-    topic?: string;
-    audience?: V1HelpAudience;
-}
-export interface V1HelpField {
-    name: string;
-    type: string;
-    required?: boolean;
-    description?: string;
-    values?: string[];
-}
-export interface V1HelpFlag {
-    name: string;
-    value?: string;
-    description: string;
-}
-export interface V1HelpIo {
-    fields: V1HelpField[];
-}
-export interface V1HelpApiOperation {
-    method: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
-    path: string;
-    operationId?: string;
-    requestFields?: string[];
-    responseFields?: string[];
-}
-export interface V1HelpSdkMethod {
-    language: string;
-    method: string;
-    package?: string;
-}
-export interface V1HelpCliCommand {
-    command: string;
-    usage: string;
-    flags?: V1HelpFlag[];
-}
-export interface V1HelpExample {
-    title?: string;
-    audience?: V1HelpAudience;
-    command?: string;
-    language?: string;
-    code?: string;
-    request?: JsonObject;
-}
-export interface V1HelpNextStep {
-    title?: string;
-    topic?: string;
-    audience?: V1HelpAudience;
-    method?: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
-    path?: string;
-    command?: string;
-}
-export interface V1HelpTopic {
-    topic: string;
-    aliases?: string[];
-    title: string;
-    summary: string;
-    audiences: V1HelpAudience[];
-    method?: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
-    path?: string;
-    operationId?: string;
-}
-export interface V1HelpOverviewResponse {
-    kind: 'overview';
-    audience?: V1HelpAudience;
-    summary: string;
-    topics: V1HelpTopic[];
-    examples?: V1HelpExample[];
-    next?: V1HelpNextStep[];
-}
-export interface V1HelpTopicResponse {
-    kind: 'topic';
-    topic: string;
-    aliases?: string[];
-    audience?: V1HelpAudience;
-    title?: string;
-    summary: string;
-    input?: V1HelpIo;
-    output?: V1HelpIo;
-    api?: V1HelpApiOperation;
-    sdk?: V1HelpSdkMethod[];
-    cli?: V1HelpCliCommand;
-    examples?: V1HelpExample[];
-    next?: V1HelpNextStep[];
-}
-export type V1HelpResponse = V1HelpOverviewResponse | V1HelpTopicResponse;
-export interface V1SpaceListQuery extends V1PageQuery {
-    subaccountId?: string;
-}
-export interface V1SpaceCreateRequest {
-    name?: string;
-    subaccountId?: string | null;
-    environment?: V1SpaceEnvironment;
-}
-export interface V1SpaceUpdateRequest {
-    name?: string;
-}
-export interface V1Space {
-    id: string;
-    name: string;
-    subaccountId?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-export interface V1SpaceDeleteResponse {
-    id: string;
-    deleted: true;
-}
-export interface V1SpaceStorageMount {
-    namespace: string;
-}
-export interface V1SpaceVaultMount {
-    allow?: string[];
-    deny?: string[];
-    allowRawReads?: boolean;
-}
-export interface V1SpaceAiMount {
-    aiProviderIds?: string[];
-    defaults?: {
-        stagehand?: string;
-        browserUse?: string;
-    };
-}
-export interface V1SpaceEnvironment {
-    storage?: V1SpaceStorageMount;
-    vault?: V1SpaceVaultMount;
-    ai?: V1SpaceAiMount;
-}
-export interface V1SpaceAiMountUpdate {
-    aiProviderIds?: string[] | null;
-    defaults?: {
-        stagehand?: string | null;
-        browserUse?: string | null;
-    } | null;
-}
-export interface V1SpaceEnvironmentUpdateRequest {
-    storage?: V1SpaceStorageMount | null;
-    vault?: V1SpaceVaultMount | null;
-    ai?: V1SpaceAiMountUpdate | null;
-}
-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;
-    port: number;
-    username?: string;
-    password?: string;
-} | {
-    mode: 'saved';
-    id: string;
-    overrides?: JsonObject;
-};
-export interface V1RuntimeFingerprintCreateConfig {
-    browser?: string;
-    locale?: string;
-}
-export type V1BrowserNetworkTrafficSaver = 'none' | 'light' | 'medium' | 'high';
-export type V1BrowserNetworkTrafficResourceType = 'media' | 'texttrack' | 'font' | 'image' | 'ping' | 'prefetch' | 'beacon';
-export interface V1BrowserNetworkTrafficConfig {
-    saver?: V1BrowserNetworkTrafficSaver;
-    blockAds?: boolean;
-    blockTrackers?: boolean;
-    blockResourceTypes?: V1BrowserNetworkTrafficResourceType[];
-    urlAllowlist?: string[];
-    urlBlocklist?: string[];
-}
-export interface V1BrowserRuntimeCreateConfig {
-    profile?: boolean;
-    stealth?: V1BrowserStealth;
-    proxy?: V1ProxyInput | null;
-    fingerprint?: V1RuntimeFingerprintCreateConfig;
-    extensionIds?: string[];
-    idleTimeoutMinutes?: number;
-    webRtcProxyOnly?: boolean;
-    forceOpenShadowRoots?: boolean;
-    networkTraffic?: V1BrowserNetworkTrafficConfig;
-}
-export interface V1RuntimeCreateRequest {
-    spaceId?: string;
-    /** Optional; defaults to `'browser'` server-side. Only `'browser'` is accepted today. */
-    type?: V1RuntimeType;
-    name?: string;
-    metadata?: JsonObject;
-    config?: V1BrowserRuntimeCreateConfig;
-}
+export type V1HelpAudience = NonNullable<OpenApiSchemas['HelpRequest']['audience']>;
+export type V1HelpRequest = OpenApiSchemas['HelpRequest'];
+export type V1HelpField = OpenApiSchemas['HelpField'];
+export type V1HelpFlag = OpenApiSchemas['HelpFlag'];
+export type V1HelpIo = OpenApiSchemas['HelpIo'];
+export type V1HelpApiOperation = OpenApiSchemas['HelpApiOperation'];
+export type V1HelpSdkMethod = OpenApiSchemas['HelpSdkMethod'];
+export type V1HelpCliCommand = OpenApiSchemas['HelpCliCommand'];
+export type V1HelpExample = OpenApiSchemas['HelpExample'];
+export type V1HelpNextStep = OpenApiSchemas['HelpNextStep'];
+export type V1HelpTopic = OpenApiSchemas['HelpTopic'];
+export type V1HelpOverviewResponse = OpenApiSchemas['HelpOverviewResponse'];
+export type V1HelpTopicResponse = OpenApiSchemas['HelpTopicResponse'];
+export type V1HelpResponse = OpenApiSchemas['HelpResponse'];
+export type V1SpaceListQuery = OpenApiQuery<'spaces.list'>;
+export type V1SpaceCreateRequest = OpenApiSchemas['SpaceCreateRequest'];
+export type V1SpaceUpdateRequest = OpenApiSchemas['SpaceUpdateRequest'];
+export type V1Space = OpenApiSchemas['Space'];
+export type V1SpaceDeleteResponse = OpenApiSchemas['SpaceDeleteResponse'];
+export type V1SpaceStorageMount = OpenApiSchemas['EnvironmentStorageMountOutput'];
+export type V1SpaceVaultMount = NonNullable<OpenApiSchemas['EnvironmentMountsOutput']['vault']>;
+export type V1SpaceAiMount = NonNullable<OpenApiSchemas['EnvironmentMountsOutput']['ai']>;
+export type V1SpaceEnvironment = OpenApiSchemas['EnvironmentMountsOutput'];
+export type V1SpaceAiMountUpdate = NonNullable<OpenApiSchemas['SpaceEnvironmentUpdateRequest']['ai']>;
+export type V1SpaceEnvironmentUpdateRequest = OpenApiSchemas['SpaceEnvironmentUpdateRequest'];
+export type V1RuntimeType = OpenApiSchemas['Runtime']['type'];
+export type V1RuntimeStatus = OpenApiSchemas['Runtime']['status'];
+export type V1BrowserStealth = NonNullable<OpenApiSchemas['BrowserRuntimeCreateConfig']['stealth']>;
+export type V1ProxyInput = OpenApiSchemas['RuntimeProxyInput'];
+export type V1RuntimeFingerprintCreateConfig = NonNullable<OpenApiSchemas['BrowserRuntimeCreateConfig']['fingerprint']>;
+export type V1BrowserNetworkTrafficSaver = NonNullable<OpenApiSchemas['BrowserNetworkTrafficConfig']['saver']>;
+export type V1BrowserNetworkTrafficResourceType = NonNullable<OpenApiSchemas['BrowserNetworkTrafficConfig']['blockResourceTypes']>[number];
+export type V1BrowserNetworkTrafficConfig = OpenApiSchemas['BrowserNetworkTrafficConfig'];
+export type V1BrowserRuntimeCreateConfig = OpenApiSchemas['BrowserRuntimeCreateConfig'];
+export type V1RuntimeCreateRequest = OpenApiSchemas['RuntimeCreateRequest'];
 export type V1SpaceRuntimeCreateRequest = Omit<V1RuntimeCreateRequest, 'spaceId'>;
+/** PATCH /v1/runtimes/{runtimeId} — name and idleTimeoutMinutes are editable
+ * any time; `config` only while the runtime is stopped. */
+export type V1RuntimeUpdateRequest = OpenApiSchemas['RuntimeUpdateRequest'];
+export type V1RuntimeDeleteResponse = OpenApiSchemas['RuntimeDeleteResponse'];
 export interface V1RuntimeListQuery {
     spaceId?: string;
     status?: V1RuntimeStatus | V1RuntimeStatus[];
     cursor?: string;
     limit?: number;
 }
-export interface V1RuntimeSummary {
-    id: string;
-    spaceId: string;
-    name: string;
-    type: V1RuntimeType;
-    status: V1RuntimeStatus;
-    activeRunId: string | null;
-    lastActivityAt?: string;
-    createdAt: string;
-    updatedAt: string;
-}
+export type V1RuntimeSummary = OpenApiSchemas['RuntimeSummary'];
 /** Saved-resource reference for a proxy attached to a runtime (response side). */
 export interface V1RuntimeProxyRef {
     id: string;
     type: 'custom' | 'managed-rotating' | 'managed-static';
     name: string;
 }
+export type V1RuntimeInlineProxyConfig = {
+    type: 'custom';
+    protocol: V1ProxyProtocol;
+    dnsResolution?: V1ProxyDnsResolution;
+    host: string;
+    port: number;
+    username?: string | null;
+    hasPassword: boolean;
+} | ({
+    type: 'managed-rotating';
+} & V1ManagedRotatingProxyConfig);
 /** Resolved fingerprint reported on a runtime's config (response side). */
-export interface V1RuntimeFingerprint {
-    userAgent?: string;
-    locale?: string;
-    timezone?: string;
-    viewport?: {
-        width: number;
-        height: number;
-    };
-    browser?: string;
-}
+export type V1RuntimeFingerprint = OpenApiSchemas['RuntimeFingerprint'];
 /**
  * Type-specific browser runtime config returned on the runtime resource. No open
  * JSON fallback arm — only the documented browser knobs are surfaced.
  */
-export interface V1BrowserRuntimeConfig {
-    profile: boolean;
-    stealth?: V1BrowserStealth;
-    proxy?: V1RuntimeProxyRef | null;
-    fingerprint?: V1RuntimeFingerprint;
-    extensionIds?: string[];
-    idleTimeoutMinutes?: number;
-    webRtcProxyOnly?: boolean;
-    forceOpenShadowRoots?: boolean;
-    networkTraffic?: V1BrowserNetworkTrafficConfig;
-}
-export interface V1Runtime extends V1RuntimeSummary {
-    config?: V1BrowserRuntimeConfig;
-    metadata?: JsonObject | null;
-}
+export type V1BrowserRuntimeConfig = OpenApiSchemas['BrowserRuntimeConfig'];
+export type V1Runtime = OpenApiSchemas['Runtime'];
 export interface V1RuntimeStartRuntime {
     id: string;
     spaceId: string;
@@ -271,96 +102,42 @@ export interface V1RuntimeStartRun extends V1RunSummary {
     failureReason?: string | null;
 }
 export type V1ConnectionProtocol = 'cdp';
-export interface V1RuntimeStartResponse {
-    runtimeId: string;
-    runId: string;
-    status: V1RuntimeStatus;
-    /**
-     * The minted public, credentialed, run-scoped connect endpoint — the product's
-     * entry point. Protocol-neutral (see `protocol`). A start ALWAYS mints a fresh
-     * connection, so this is required (unlike the optional field on the runtime
-     * detail). The connection is run-lifetime, so no expiry is surfaced.
-     */
-    connectUrl: string;
-    protocol: V1ConnectionProtocol;
-    started: boolean;
-}
-export interface V1RuntimeStopResponse {
-    runtimeId: string;
-    runId: string | null;
-    status: V1RuntimeStatus;
-    stopped: boolean;
-}
+export type V1RuntimeStartResponse = OpenApiSchemas['RuntimeStartResponse'];
+export type V1RuntimeStopResponse = OpenApiSchemas['RuntimeStopResponse'];
 export interface V1RunListQuery extends V1PageQuery {
     status?: string | string[];
     spaceId?: string;
     runtimeId?: string;
 }
 export type V1RuntimeRunListQuery = Omit<V1RunListQuery, 'spaceId' | 'runtimeId'>;
-export interface V1RunSummary {
-    id: string;
-    status: string;
-    createdAt: string;
-    startedAt: string;
-    finishedAt?: string | null;
-}
-export interface V1Run extends V1RunSummary {
-    spaceId: string;
-    runtimeId: string;
-    runtimeType: string;
-    durationMs?: number | null;
-    failureReason?: string | null;
-}
+export type V1RunSummary = OpenApiSchemas['RunSummary'];
+export type V1Run = OpenApiSchemas['Run'];
 export type V1RunUsageBillingStatus = 'pending' | 'settled' | 'unavailable';
-export interface V1RunUsage {
-    runId: string;
-    runtimeId: string;
-    runtimeType: string;
-    status: string;
-    computedAt: string;
-    creditsUsed: number | null;
-    billingStatus: V1RunUsageBillingStatus;
-    runtimeSeconds: number | null;
-    proxyBytes: number | null;
-    aiTokensTotal: number | null;
-    captchaSolves: number;
-    invocations: number;
-    toolCalls: number;
-    filesCount: number;
-    filesBytes: number;
-    breakdown: {
-        aiTokens: {
-            input: number | null;
-            output: number | null;
-        };
-        credits: {
-            runtime: number | null;
-            ai: number | null;
-            proxy: number | null;
-            captcha: number | null;
-            files: number | null;
-        };
-    };
-}
-export type V1RunEventType = 'runtime.lifecycle' | 'navigation' | 'network.request' | 'network.response' | 'network.failed' | 'console.message';
-export type V1RunEventStatus = 'started' | 'stopped' | 'failed' | 'finished' | 'received';
-export interface V1RunEvent {
-    id: string;
+export type V1RunUsage = OpenApiSchemas['RunUsage'];
+export type V1RunEventType = OpenApiSchemas['RunEvent']['type'];
+export type V1RunEventStatus = NonNullable<OpenApiSchemas['RunEvent']['status']>;
+export type V1RunEvent = OpenApiSchemas['RunEvent'];
+export type V1RunEventsListQuery = OpenApiQuery<'runs.events.list'>;
+export interface V1RunStreamHeartbeat {
     time: string;
-    type: V1RunEventType;
-    status?: V1RunEventStatus;
-    durationMs?: number;
-    pageId?: string;
-    contextId?: string;
-    name?: string;
-    data?: JsonObject;
 }
-export interface V1RunEventsListQuery extends V1PageQuery {
-    type?: string | string[];
-    status?: string | string[];
-    pageId?: string;
-    contextId?: string;
+export interface V1RunStreamEnded {
+    runId: string;
+    status: V1Run['status'];
+    finishedAt: string | null;
+    failure: NonNullable<V1Run['failure']> | null;
 }
+export type V1RunEventStreamFrame = {
+    event: 'run.event';
+    id: string;
+    data: V1RunEvent;
+} | {
+    event: 'heartbeat';
+    data: V1RunStreamHeartbeat;
+} | {
+    event: 'run.ended';
+    data: V1RunStreamEnded;
+};
 export type V1RunActivityCategory = 'runtime' | 'browser' | 'network' | 'console' | 'file' | 'invocation' | 'tool' | 'captcha' | 'agent' | 'llm' | 'system';
 export type V1RunActivitySeverity = 'info' | 'warning' | 'error';
 export interface V1RunActivityLinks {
@@ -368,218 +145,48 @@ export interface V1RunActivityLinks {
     toolCallId?: string;
     fileId?: string;
 }
-export interface V1RunActivityItem {
+export type V1RunActivityItem = OpenApiSchemas['RunActivityItem'];
+export type V1RunActivityListQuery = OpenApiQuery<'runs.activity.list'>;
+export type V1RunActivityStreamFrame = {
+    event: 'run.activity';
     id: string;
-    type: string;
-    category: V1RunActivityCategory;
-    message: string;
-    time: string;
-    status?: string;
-    severity?: V1RunActivitySeverity;
-    durationMs?: number;
-    parentId?: string;
-    data?: JsonObject;
-    links?: V1RunActivityLinks;
-    children?: V1RunActivityItem[];
-}
-export interface V1RunActivityListQuery extends V1PageQuery {
-    type?: string | string[];
-    category?: V1RunActivityCategory | V1RunActivityCategory[];
-    severity?: V1RunActivitySeverity | V1RunActivitySeverity[];
-    invocationId?: string;
-    fileId?: string;
-}
-export interface V1RunLiveRequest {
-    control?: string;
-    expiresInSeconds?: number;
-}
-export interface V1RunLiveResponse {
-    iframeUrl: string;
-    expiresAt: string;
-}
-export interface V1RunRecordingRequest {
-    expiresInSeconds?: number;
-}
-export interface V1RunRecordingResponse {
-    iframeUrl: string;
-    status: string;
-    durationMs?: number;
-    expiresAt: string;
-}
-export type V1InvocationAction = 'act' | 'observe' | 'extract' | 'browserUse' | 'stagehandAgent' | 'solveCaptcha';
-export type V1InvocationPage = 'active' | 'new';
-export type V1InvocationErrorCode = 'invocation.failed' | 'invocation.cancelled' | 'invocation.timed_out' | 'invocation.dispatch_preparation_failed' | 'invocation.dispatch_unavailable' | 'invocation.target_create_failed' | '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';
-export interface V1InvocationError {
-    code: V1InvocationErrorCode;
-    message: string;
-    details?: JsonObject;
-}
-export interface V1Invocation {
-    id: string;
-    runId: string;
-    runtimeId: string;
-    action: V1InvocationAction;
-    status: string;
-    output?: JsonValue;
-    error?: V1InvocationError | null;
-    createdAt: string;
-    startedAt?: string | null;
-    finishedAt?: string | null;
-    durationMs?: number | null;
-}
+    data: V1RunActivityItem;
+} | {
+    event: 'heartbeat';
+    data: V1RunStreamHeartbeat;
+} | {
+    event: 'run.ended';
+    data: V1RunStreamEnded;
+};
+export type V1RunLiveRequest = OpenApiSchemas['RunLiveRequest'];
+export type V1RunLiveResponse = OpenApiSchemas['RunLiveResponse'];
+export type V1RunRecordingRequest = OpenApiSchemas['RunRecordingRequest'];
+export type V1RunRecordingResponse = OpenApiSchemas['RunRecordingResponse'];
+export type V1InvocationAction = OpenApiSchemas['Invocation']['action'];
+export type V1RuntimeTargetSelector = OpenApiSchemas['RuntimeTargetSelector'];
+export type V1RuntimeTarget = OpenApiSchemas['RuntimeTarget'];
+export type V1RuntimeTargetCreateRequest = OpenApiSchemas['RuntimeTargetCreateRequest'];
+export type V1InvocationErrorCode = NonNullable<NonNullable<OpenApiSchemas['Invocation']['error']>['code']>;
+export type V1InvocationError = NonNullable<OpenApiSchemas['Invocation']['error']>;
+export type V1Invocation = OpenApiSchemas['Invocation'];
 export type V1InvocationResponse = V1Invocation;
-export interface V1InvocationWaitRequest {
-    timeoutMs?: number;
-}
-export interface V1InvocationWaitResponse extends V1Invocation {
-    waitStatus: 'completed' | 'timeout';
-    retryAfterMs?: number;
-}
-export interface V1InvocationSummary {
-    id: string;
-    runId: string;
-    runtimeId: string;
-    action: V1InvocationAction;
-    status: string;
-    createdAt: string;
-    finishedAt?: string | null;
-    durationMs?: number | null;
-    error?: V1InvocationError | null;
-}
-export interface V1RunInvocationsListQuery {
-    cursor?: string;
-    limit?: number;
-    status?: string | string[];
-    action?: V1InvocationAction | V1InvocationAction[];
-}
+export type V1InvocationWaitRequest = OpenApiSchemas['InvocationWaitRequest'];
+export type V1InvocationWaitResponse = OpenApiSchemas['InvocationWait'];
+export type V1InvocationSummary = OpenApiSchemas['InvocationSummary'];
+export type V1RunInvocationsListQuery = OpenApiQuery<'runs.invocations.list'>;
 export interface V1RuntimeInvocationFileInput {
     fileId: string;
     runtimePath?: string;
     name?: string;
 }
-interface V1RuntimeInvocationAgentFields {
-    page?: V1InvocationPage;
-    outputSchema?: JsonObject;
-    toolsetId?: string;
-    toolIds?: string[];
-    metadata?: JsonObject;
-    files?: V1RuntimeInvocationFileInput[];
-    timeoutMs?: number;
-}
-interface V1RuntimeInvocationAiSelectionFields {
-    aiProviderId?: string;
-    model?: string;
-    temperature?: number;
-}
-export type V1RuntimeInvocationCreateRequest = {
-    action: 'act';
-    page?: V1InvocationPage;
-    instruction: string;
-    stagehandAction?: JsonObject;
-    timeoutMs?: number;
-    aiProviderId?: string;
-    model?: string;
-    temperature?: number;
-    metadata?: JsonObject;
-} | {
-    action: 'act';
-    page?: V1InvocationPage;
-    stagehandAction: JsonObject;
-    instruction?: string;
-    timeoutMs?: number;
-    aiProviderId?: string;
-    model?: string;
-    temperature?: number;
-    metadata?: JsonObject;
-} | {
-    action: 'observe';
-    page?: V1InvocationPage;
-    instruction: string;
-    selector?: string;
-    timeoutMs?: number;
-    aiProviderId?: string;
-    model?: string;
-    temperature?: number;
-    metadata?: JsonObject;
-} | {
-    action: 'extract';
-    page?: V1InvocationPage;
-    instruction?: string;
-    selector?: string;
-    outputSchema?: JsonObject;
-    timeoutMs?: number;
-    aiProviderId?: string;
-    model?: string;
-    temperature?: number;
-    metadata?: JsonObject;
-} | (V1RuntimeInvocationAgentFields & V1RuntimeInvocationAiSelectionFields & {
-    action: 'stagehandAgent';
-    instruction: string;
-    maxSteps?: number;
-    variables?: JsonObject;
-    executionAiProviderId?: string;
-    systemPrompt?: string;
-    highlightCursor?: boolean;
-}) | (V1RuntimeInvocationAgentFields & V1RuntimeInvocationAiSelectionFields & {
-    action: 'browserUse';
-    instruction: string;
-    maxSteps?: number;
-    extractionAiProviderId?: string;
-    fallbackAiProviderId?: string;
-    useVision?: boolean | 'auto';
-    visionDetailLevel?: 'low' | 'high' | 'auto';
-    flashMode?: boolean;
-    enablePlanning?: boolean;
-    maxFailures?: number;
-    stepTimeoutMs?: number;
-    maxActionsPerStep?: number;
-    maxHistoryItems?: number | null;
-    useThinking?: boolean;
-    directlyOpenUrl?: boolean;
-    includeAttributes?: string[];
-    overrideSystemMessage?: string;
-    extendSystemMessage?: string;
-    sensitiveData?: Record<string, string | Record<string, string>>;
-}) | {
-    action: 'solveCaptcha';
-    page?: 'active';
-    timeoutMs?: number;
-    metadata?: JsonObject;
-};
-export interface V1File {
-    id: string;
-    source: 'upload' | 'runtime';
-    name: string;
-    path: string;
-    contentType: string;
-    sizeBytes: number;
-    createdAt: string;
-    spaceId: string;
-    downloadUrl: string;
-    runId?: string;
-    runtimeId?: string;
-    type?: string;
-    metadata?: JsonObject | null;
-    expiresAt?: string;
-}
-export interface V1FilesListQuery extends V1PageQuery {
-    spaceId?: string;
-    source?: 'upload' | 'runtime';
-    type?: string | string[];
-    runId?: string;
-    runtimeId?: string;
-    path?: string;
-    prefix?: string;
-    q?: string;
-}
-export interface V1FileUpdateRequest {
-    name?: string;
-    metadata?: JsonObject | null;
-}
-export interface V1FileDeleteResponse {
-    id: string;
-    deleted: true;
-}
+export type V1RuntimeInvocationCreateRequest = OpenApiSchemas['RuntimeInvocationCreateRequest'];
+export type V1File = OpenApiSchemas['File'];
+export type V1FilesListQuery = OpenApiQuery<'files.list'>;
+/** Immediate-subfolder rollup returned by files.list with `include: 'folders'`. */
+export type V1FileFolder = OpenApiSchemas['FileFolder'];
+export type V1FilesListResponse = OpenApiSchemas['FileListResponse'];
+export type V1FileUpdateRequest = OpenApiSchemas['FileUpdateRequest'];
+export type V1FileDeleteResponse = OpenApiSchemas['FileDeleteResponse'];
 export interface V1FileUploadRequest {
     spaceId?: string;
     file: Blob;
@@ -587,29 +194,11 @@ export interface V1FileUploadRequest {
     path?: string;
     metadata?: JsonObject;
 }
-export interface V1RunFilesListQuery extends V1PageQuery {
-    type?: string | string[];
-}
-export interface V1RuntimeFilesListQuery extends V1PageQuery {
-    type?: string | string[];
-}
-export interface V1RunFilesExportRequest {
-    name?: string;
-    type?: string[];
-}
-export interface V1RuntimeFileStageRequest {
-    fileId: string;
-    runtimePath?: string;
-    name?: string;
-}
-export interface V1RuntimeStagedFile {
-    id: string;
-    runtimeId: string;
-    runtimePath: string;
-    name: string;
-    sizeBytes: number;
-    expiresAt: string | null;
-}
+export type V1RunFilesListQuery = OpenApiQuery<'runs.files.list'>;
+export type V1RuntimeFilesListQuery = OpenApiQuery<'runtimes.files.list'>;
+export type V1RunFilesExportRequest = OpenApiSchemas['RunsFilesExportRequest'];
+export type V1RuntimeFileStageRequest = OpenApiSchemas['RuntimeFileStageRequest'];
+export type V1RuntimeStagedFile = OpenApiSchemas['RuntimeStagedFile'];
 export interface V1RuntimeFileUploadRequest {
     file: Blob;
     name?: string;
@@ -618,17 +207,10 @@ export interface V1RuntimeFileUploadRequest {
     runtimePath?: string;
     metadata?: JsonObject;
 }
-export interface V1RuntimeFileCollectRequest {
-    runtimePath: string;
-    /** Durable BCTRL storage destination. */
-    destinationPath?: string;
-    name?: string;
-    type?: string;
-    metadata?: JsonObject;
-}
-export type { V1ManagedRotatingDevice, V1ManagedRotatingPreference, V1ManagedRotatingProxyConfig, V1ManagedRotatingRotation, V1Proxy, V1ProxyBase, V1ProxyCreateRequest, V1ProxyDeleteResponse, V1ProxyListQuery, V1ProxyPool, V1ProxyPoolListQuery, V1ProxyProtocol, V1ProxyTestResponse, V1ProxyType, V1ProxyUpdateRequest, } from './proxyTypes.js';
+export type V1RuntimeFileCollectRequest = OpenApiSchemas['RuntimeFileCollectRequest'];
+export type { V1ManagedRotatingDevice, V1ManagedRotatingPreference, V1ManagedRotatingProxyConfig, V1ManagedRotatingRotation, V1Proxy, V1ProxyBase, V1ProxyCreateRequest, V1ProxyDeleteResponse, V1ProxyDnsResolution, V1ProxyListQuery, V1ProxyPool, V1ProxyPoolListQuery, V1ProxyProtocol, V1ProxyTestResponse, V1ProxyType, V1ProxyUpdateRequest, } from './proxyTypes.js';
 export type { V1VaultSecret, V1VaultSecretDeleteResponse, V1VaultSecretListQuery, V1VaultSecretPatchRequest, V1VaultSecretType, V1VaultSecretUpsertRequest, V1VaultSecretValue, V1VaultTotpResponse, } from './vaultTypes.js';
-export type V1ToolExecutionType = 'webhook' | 'mcp_tool' | 'hosted_function' | 'hosted_workflow' | 'bctrl_builtin';
+export type V1ToolExecutionType = OpenApiSchemas['ToolCallTool']['executionType'];
 export type V1ToolExecution = {
     type: 'webhook';
     url: string;
@@ -654,83 +236,10 @@ export type V1ToolExecution = {
     type: 'bctrl_builtin';
     name: 'files' | 'vault' | 'captcha';
 };
-export type V1ToolType = 'webhook' | 'hosted' | 'mcp' | 'workflow' | 'builtin';
-export interface V1ToolBase {
-    id: string;
-    spaceId: string | null;
-    name: string;
-    description: string | null;
-    inputSchema: JsonObject;
-    outputSchema: JsonObject;
-    status: 'enabled' | 'disabled';
-    metadata?: JsonObject | null;
-    createdAt: string;
-    updatedAt: string;
-}
-export type V1Tool = (V1ToolBase & {
-    type: 'webhook';
-    url: string;
-    authSecretId?: string;
-    timeoutMs?: number;
-}) | (V1ToolBase & {
-    type: 'hosted';
-    currentVersionId: string | null;
-}) | (V1ToolBase & {
-    type: 'mcp';
-    serverId: string;
-    toolName: string;
-}) | (V1ToolBase & {
-    type: 'workflow';
-    workflowId: string;
-}) | (V1ToolBase & {
-    type: 'builtin';
-    builtin: 'files' | 'vault' | 'captcha';
-});
-interface V1ToolBaseCreateRequest {
-    spaceId?: string;
-    name: string;
-    description?: string | null;
-    inputSchema?: JsonObject;
-    outputSchema?: JsonObject;
-    status?: 'enabled' | 'disabled';
-    metadata?: JsonObject | null;
-}
-export type V1ToolCreateRequest = (V1ToolBaseCreateRequest & {
-    type: 'webhook';
-    url: string;
-    authSecretId?: string;
-    timeoutMs?: number;
-}) | (V1ToolBaseCreateRequest & {
-    type: 'hosted';
-    source: string;
-    timeoutMs?: number;
-    env?: Record<string, string>;
-});
-export interface V1ToolUpdateRequest {
-    name?: string;
-    description?: string | null;
-    inputSchema?: JsonObject;
-    outputSchema?: JsonObject;
-    status?: 'enabled' | 'disabled';
-    timeoutMs?: number;
-    authSecretId?: string | null;
-    metadata?: JsonObject | null;
-}
-export interface V1ToolVersion {
-    id: string;
-    toolId: string;
-    version: number;
-    source: string;
-    timeoutMs: number;
-    envKeys: string[];
-    metadata?: JsonObject | null;
-    current: boolean;
-    createdAt: string;
-}
-export interface V1ToolVersionCreateRequest {
-    source: string;
-    timeoutMs?: number;
-    env?: Record<string, string>;
-    metadata?: JsonObject | null;
-    promote?: boolean;
-}
+export type V1ToolType = OpenApiSchemas['Tool']['type'];
+export type V1ToolBase = Pick<OpenApiSchemas['BuiltinTool'], 'id' | 'spaceId' | 'name' | 'description' | 'inputSchema' | 'outputSchema' | 'status' | 'metadata' | 'createdAt' | 'updatedAt'>;
+export type V1Tool = OpenApiSchemas['Tool'];
+export type V1ToolCreateRequest = OpenApiSchemas['ToolCreateRequest'];
+export type V1ToolUpdateRequest = OpenApiSchemas['ToolUpdateRequest'];
+export type V1ToolVersion = OpenApiSchemas['ToolVersion'];
+export type V1ToolVersionCreateRequest = OpenApiSchemas['ToolVersionCreateRequest'];