@bctrl/sdk 1.0.4 → 1.0.6

package/dist/types.d.ts

@@ -3,6 +3,13 @@ export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
 export type JsonObject = {
     [key: string]: JsonValue;
 };
+import type { V1ManagedRotatingProxyConfig, V1ProxyDnsResolution, V1ProxyProtocol } from './proxyTypes.js';
+import type { V1AiModelSelection, V1AiStoredModelSelection } from './aiTypes.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 { 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';
 export interface V1ListEnvelope<T> {
     data: T[];
     nextCursor: string | null;
@@ -11,10 +18,100 @@ export interface V1PageQuery {
     cursor?: string;
     limit?: number;
 }
-export interface V1SpaceCreateRequest {
+export type V1HelpAudience = 'api' | 'sdk' | 'cli';
+export interface V1HelpRequest {
+    topic?: string;
+    audience?: V1HelpAudience;
+}
+export interface V1HelpField {
     name: string;
-    region: 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;
@@ -22,94 +119,222 @@ export interface V1SpaceUpdateRequest {
 export interface V1Space {
     id: string;
     name: string;
-    region: string;
-    subaccountId?: string | null;
+    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 {
+    credentialIds?: string[];
+    defaults?: {
+        stagehand?: V1AiStoredModelSelection;
+        browserUse?: V1AiStoredModelSelection;
+    };
+}
 export interface V1SpaceEnvironment {
-    spaceId: string;
-    mounts: JsonObject;
-    updatedAt: string;
+    storage?: V1SpaceStorageMount;
+    vault?: V1SpaceVaultMount;
+    ai?: V1SpaceAiMount;
+}
+export interface V1SpaceAiMountUpdate {
+    credentialIds?: string[] | null;
+    defaults?: {
+        stagehand?: V1AiStoredModelSelection | null;
+        browserUse?: V1AiStoredModelSelection | null;
+    } | null;
 }
 export interface V1SpaceEnvironmentUpdateRequest {
-    mounts: JsonObject;
+    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;
+export type V1ProxyInput = string | ({
+    id: string;
+} & V1ManagedRotatingProxyConfig) | {
+    type?: 'custom';
+    url: string;
+    dnsResolution?: V1ProxyDnsResolution;
+    username?: string;
+    password?: string;
+} | {
+    type?: 'custom';
+    protocol: V1ProxyProtocol;
+    dnsResolution?: V1ProxyDnsResolution;
     host: string;
     port: number;
     username?: string;
     password?: string;
-} | {
-    mode: 'saved';
-    id: string;
-    overrides?: JsonObject;
-};
+} | ({
+    type: 'managed-rotating';
+} & V1ManagedRotatingProxyConfig);
 export interface V1RuntimeFingerprintCreateConfig {
-    browser?: string;
-    locale?: string;
+    /** Defaults to 'desktop' when omitted. */
+    device?: 'desktop' | 'mobile';
+    /** Defaults to 'windows' when omitted. */
+    os?: 'windows' | 'macos' | 'android' | 'ios';
+    /** Randomly selected from chrome, edge, and safari when omitted. */
+    browser?: 'chrome' | 'edge' | 'safari';
+    browserVersion?: string;
+    locale?: string | 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;
+    /** Upgrade the browser to the latest available version on each start. The
+     * fingerprint keeps its identity; only the browser version advances.
+     * Defaults to true; set false to pin the current version. */
+    autoUpgrade?: boolean;
     stealth?: V1BrowserStealth;
     proxy?: V1ProxyInput | null;
     fingerprint?: V1RuntimeFingerprintCreateConfig;
-    extensions?: string[];
+    extensionIds?: string[];
     idleTimeoutMinutes?: number;
     webRtcProxyOnly?: boolean;
     forceOpenShadowRoots?: boolean;
+    networkTraffic?: V1BrowserNetworkTrafficConfig;
 }
 export interface V1RuntimeCreateRequest {
-    spaceId: string;
-    type: V1RuntimeType;
+    spaceId?: string;
+    /** Optional; defaults to `'browser'` server-side. Only `'browser'` is accepted today. */
+    type?: V1RuntimeType;
     name?: string;
     metadata?: JsonObject;
     config?: V1BrowserRuntimeCreateConfig;
 }
 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 interface V1RuntimeUpdateRequest {
+    name?: string;
+    idleTimeoutMinutes?: number;
+    config?: V1BrowserRuntimeCreateConfig;
+}
+export interface V1RuntimeDeleteResponse {
+    id: string;
+    deleted: boolean;
+}
 export interface V1RuntimeListQuery {
     spaceId?: string;
-    status?: string | 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;
 }
+/** 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 {
+    device?: 'desktop' | 'mobile';
+    os?: 'windows' | 'macos' | 'android' | 'ios';
+    browser?: string;
+    browserVersion?: string;
+    userAgent?: string;
+    locale?: string | string[];
+    timezone?: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+}
+/**
+ * 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;
+    autoUpgrade?: boolean;
+    stealth?: V1BrowserStealth;
+    proxy?: V1RuntimeProxyRef | V1RuntimeInlineProxyConfig | null;
+    fingerprint?: V1RuntimeFingerprint;
+    extensionIds?: string[];
+    idleTimeoutMinutes?: number;
+    webRtcProxyOnly?: boolean;
+    forceOpenShadowRoots?: boolean;
+    networkTraffic?: V1BrowserNetworkTrafficConfig;
+}
 export interface V1Runtime extends V1RuntimeSummary {
-    config?: JsonObject;
+    config?: V1BrowserRuntimeConfig;
     metadata?: JsonObject | null;
 }
 export interface V1RuntimeStartRuntime {
     id: string;
+    spaceId: string;
     name: string;
     type: V1RuntimeType;
     status: V1RuntimeStatus;
 }
 export interface V1RuntimeStartRun extends V1RunSummary {
     durationMs?: number | null;
-    lastSeenAt?: string | null;
-    endedReason?: string | null;
     failureReason?: string | null;
 }
-export interface V1RuntimeStartBrowser {
-    cdpUrl: string;
-    connectionId: string;
-}
+export type V1ConnectionProtocol = 'cdp';
 export interface V1RuntimeStartResponse {
-    runtime: V1RuntimeStartRuntime;
-    run: V1RuntimeStartRun;
-    browser: V1RuntimeStartBrowser;
+    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 interface V1RunListQuery extends V1PageQuery {
     status?: string | string[];
@@ -129,39 +354,31 @@ export interface V1Run extends V1RunSummary {
     runtimeId: string;
     runtimeType: string;
     durationMs?: number | null;
-    lastSeenAt?: string | null;
-    endedReason?: string | null;
     failureReason?: string | null;
 }
+export type V1RunUsageBillingStatus = 'pending' | 'settled' | 'unavailable';
 export interface V1RunUsage {
     runId: string;
     runtimeId: string;
     runtimeType: string;
     status: string;
     computedAt: string;
-    usage: {
-        runtime: {
-            seconds: number | null;
-            billingClass: string | null;
-        };
+    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;
-            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: {
+        credits: {
             runtime: number | null;
             ai: number | null;
             proxy: number | null;
@@ -170,175 +387,276 @@ export interface V1RunUsage {
         };
     };
 }
+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;
-    runId: string;
-    runtimeId: string;
-    runtimeType: string;
-    type: string;
-    category: string;
     time: string;
-    status?: string;
-    connectionId?: string;
-    commandId?: string;
-    invocationId?: string;
-    toolCallId?: string;
-    fileId?: string;
+    type: V1RunEventType;
+    status?: V1RunEventStatus;
+    durationMs?: number;
+    pageId?: string;
+    contextId?: string;
     name?: string;
     data?: JsonObject;
 }
 export interface V1RunEventsListQuery extends V1PageQuery {
     type?: string | string[];
-    category?: string | string[];
-    connectionId?: string;
+    status?: string | string[];
+    pageId?: string;
+    contextId?: string;
 }
-export interface V1RunEventsWaitRequest {
-    cursor?: string;
-    timeoutMs?: number;
-    type?: string[];
-    category?: string[];
-    connectionId?: string;
+export type V1RunActivityCategory = 'runtime' | 'browser' | 'network' | 'console' | 'file' | 'invocation' | 'tool' | 'captcha' | 'agent' | 'llm' | 'system';
+export type V1RunActivitySeverity = 'info' | 'warning' | 'error';
+export interface V1RunActivityLinks {
+    invocationId?: string;
+    toolCallId?: string;
+    fileId?: string;
 }
-export interface V1RunEventsWaitResponse {
-    data: V1RunEvent | null;
-    cursor: string | null;
-    timedOut: boolean;
+export interface V1RunActivityItem {
+    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 type V1RunCommand = V1RunEvent & {
-    category: 'command';
-};
-export interface V1RunCommandsListQuery extends V1PageQuery {
+export interface V1RunActivityListQuery extends V1PageQuery {
     type?: string | string[];
-    connectionId?: string;
+    category?: V1RunActivityCategory | V1RunActivityCategory[];
+    severity?: V1RunActivitySeverity | V1RunActivitySeverity[];
+    invocationId?: string;
+    fileId?: string;
 }
 export interface V1RunLiveRequest {
     control?: string;
     expiresInSeconds?: number;
 }
 export interface V1RunLiveResponse {
-    iframeUrl: string;
+    url: string;
     expiresAt: string;
 }
 export interface V1RunRecordingRequest {
     expiresInSeconds?: number;
 }
 export interface V1RunRecordingResponse {
-    iframeUrl: string;
+    url: string;
     status: string;
     durationMs?: number;
     expiresAt: string;
 }
+export type V1InvocationAction = 'act' | 'observe' | 'extract' | 'browserUse' | 'stagehandAgent' | 'solveCaptcha';
+export type V1RuntimeTargetSelector = 'active' | 'new' | {
+    id: string;
+};
+export interface V1RuntimeTarget {
+    id: string;
+    runtimeId: string;
+    type: 'browser_page';
+    label: string;
+    uri?: string;
+    active: boolean;
+    metadata?: JsonObject;
+}
+export interface V1RuntimeTargetCreateRequest {
+    type?: 'browser_page';
+    uri?: string;
+    activate?: boolean;
+}
+export type V1InvocationErrorCode = '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';
+export interface V1InvocationError {
+    code: V1InvocationErrorCode;
+    message: string;
+    details?: JsonObject;
+}
 export interface V1Invocation {
     id: string;
     runId: string;
-    spaceId: string;
     runtimeId: string;
-    runtimeType: string;
-    type: string;
+    action: V1InvocationAction;
     status: string;
-    result?: JsonValue | null;
-    error?: JsonObject | null;
-    progress?: JsonObject | null;
-    artifactCount: number;
+    output?: JsonValue;
+    error?: V1InvocationError | null;
     createdAt: string;
     startedAt?: string | null;
     finishedAt?: string | null;
     durationMs?: number | null;
-    metadata?: JsonObject | null;
-}
-export interface V1InvocationResponse {
-    data: V1Invocation;
 }
+export type V1InvocationResponse = V1Invocation;
 export interface V1InvocationWaitRequest {
     timeoutMs?: number;
 }
-export interface V1InvocationWaitResponse {
-    data: V1Invocation;
-    timedOut: boolean;
+export interface V1InvocationWaitResponse extends V1Invocation {
+    waitStatus: 'completed' | 'timeout';
+    retryAfterMs?: number;
 }
-export type V1RuntimeInvocationFileInput = {
-    storagePath: string;
-    name?: string;
-} | {
+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 interface V1RuntimeInvocationFileInput {
     fileId: string;
+    runtimePath?: string;
     name?: string;
-};
+}
 interface V1RuntimeInvocationAgentFields {
-    target?: JsonObject;
-    idempotencyKey?: string;
+    target?: V1RuntimeTargetSelector;
     outputSchema?: JsonObject;
     toolsetId?: string;
+    toolIds?: string[];
     metadata?: JsonObject;
     files?: V1RuntimeInvocationFileInput[];
+    timeoutMs?: number;
+}
+interface V1RuntimeInvocationAiSelectionFields {
+    model?: V1AiModelSelection;
+    temperature?: number;
 }
 export type V1RuntimeInvocationCreateRequest = {
-    provider: 'stagehand';
-    method: 'act' | 'observe';
-    target?: JsonObject;
-    input: JsonObject;
-    idempotencyKey?: string;
+    action: 'act';
+    target?: V1RuntimeTargetSelector;
+    instruction: string;
+    stagehandAction?: JsonObject;
+    timeoutMs?: number;
+    model?: V1AiModelSelection;
+    temperature?: number;
+    metadata?: JsonObject;
+} | {
+    action: 'act';
+    target?: V1RuntimeTargetSelector;
+    stagehandAction: JsonObject;
+    instruction?: string;
+    timeoutMs?: number;
+    model?: V1AiModelSelection;
+    temperature?: number;
+    metadata?: JsonObject;
+} | {
+    action: 'observe';
+    target?: V1RuntimeTargetSelector;
+    instruction: string;
+    selector?: string;
+    timeoutMs?: number;
+    model?: V1AiModelSelection;
+    temperature?: number;
     metadata?: JsonObject;
 } | {
-    provider: 'stagehand';
-    method: 'extract';
-    target?: JsonObject;
-    input?: JsonObject;
+    action: 'extract';
+    target?: V1RuntimeTargetSelector;
+    instruction?: string;
+    selector?: string;
     outputSchema?: JsonObject;
-    idempotencyKey?: string;
+    timeoutMs?: number;
+    model?: V1AiModelSelection;
+    temperature?: number;
     metadata?: JsonObject;
-} | (V1RuntimeInvocationAgentFields & {
-    provider: 'stagehand';
-    method: 'agent';
-    input: JsonObject;
-    config?: JsonObject;
-    options?: JsonObject;
-}) | (V1RuntimeInvocationAgentFields & {
-    provider: 'browserUse';
-    method: 'agent';
-    input: JsonObject;
-    config?: JsonObject;
-    options?: JsonObject;
+} | (V1RuntimeInvocationAgentFields & V1RuntimeInvocationAiSelectionFields & {
+    action: 'stagehandAgent';
+    instruction: string;
+    maxSteps?: number;
+    variables?: JsonObject;
+    executionModel?: V1AiModelSelection;
+    systemPrompt?: string;
+    highlightCursor?: boolean;
+}) | (V1RuntimeInvocationAgentFields & V1RuntimeInvocationAiSelectionFields & {
+    action: 'browserUse';
+    instruction: string;
+    maxSteps?: number;
+    extractionModel?: V1AiModelSelection;
+    fallbackModel?: V1AiModelSelection;
+    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>>;
 }) | {
-    provider: 'bctrl';
-    method: 'solveCaptcha';
-    target?: JsonObject;
-    input?: JsonObject;
-    idempotencyKey?: string;
+    action: 'solveCaptcha';
+    target?: 'active' | {
+        id: string;
+    };
+    timeoutMs?: number;
     metadata?: JsonObject;
 };
 export interface V1File {
     id: string;
-    type: string;
-    source: 'upload' | 'runtime' | 'system';
+    source: 'upload' | 'runtime';
     name: string;
     path: string;
     contentType: string;
     sizeBytes: number;
-    spaceId?: string;
-    runtimeId?: string | null;
-    runId?: string | null;
-    metadata?: JsonObject | null;
     createdAt: string;
-    expiresAt?: string | null;
-    downloadUrl?: 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' | 'system';
+    spaceId?: string;
+    source?: 'upload' | 'runtime';
+    type?: string | string[];
+    runId?: string;
+    runtimeId?: string;
     path?: string;
     prefix?: string;
-    query?: string;
-    contentType?: string;
+    q?: string;
+    /** Only files created after this ISO timestamp. */
+    createdAfter?: string;
+    /** S3-delimiter-style directory view: `data` holds only files directly
+     * under `prefix`, and the response gains a `folders` array of immediate
+     * subfolder rollups. */
+    include?: 'folders';
+}
+/** Immediate-subfolder rollup returned by files.list with `include: 'folders'`. */
+export interface V1FileFolder {
+    name: string;
+    path: string;
+    fileCount: number;
+    totalBytes: number;
+    lastCreatedAt: string | null;
 }
+export type V1FilesListResponse = V1ListEnvelope<V1File> & {
+    folders?: V1FileFolder[];
+};
 export interface V1FileUpdateRequest {
     name?: string;
     metadata?: JsonObject | null;
 }
 export interface V1FileDeleteResponse {
-    success: true;
+    id: string;
+    deleted: true;
 }
 export interface V1FileUploadRequest {
-    spaceId: string;
+    spaceId?: string;
     file: Blob;
     name?: string;
     path?: string;
@@ -347,20 +665,18 @@ export interface V1FileUploadRequest {
 export interface V1RunFilesListQuery extends V1PageQuery {
     type?: string | string[];
 }
-export interface V1RunFilesExportRequest {
-    format: 'zip';
-    name: string;
-    filter?: {
-        type?: string[];
-    };
+export interface V1RuntimeFilesListQuery extends V1PageQuery {
+    type?: string | string[];
 }
-export type V1RuntimeFileStageRequest = {
-    storagePath: string;
+export interface V1RunFilesExportRequest {
     name?: string;
-} | {
+    type?: string[];
+}
+export interface V1RuntimeFileStageRequest {
     fileId: string;
+    runtimePath?: string;
     name?: string;
-};
+}
 export interface V1RuntimeStagedFile {
     id: string;
     runtimeId: string;
@@ -372,21 +688,124 @@ export interface V1RuntimeStagedFile {
 export interface V1RuntimeFileUploadRequest {
     file: Blob;
     name?: string;
-    storagePath?: string;
+    /** Durable BCTRL storage destination. */
+    destinationPath?: string;
+    runtimePath?: string;
     metadata?: JsonObject;
 }
-export interface V1RuntimeFileUploadResponse {
-    file: V1File;
-    staged: V1RuntimeStagedFile;
-}
 export interface V1RuntimeFileCollectRequest {
-    path: string;
-    storagePath?: string;
+    runtimePath: string;
+    /** Durable BCTRL storage destination. */
+    destinationPath?: string;
     name?: string;
-    artifact?: {
-        kind?: string;
-        name?: string;
-        metadata?: JsonObject;
+    type?: string;
+    metadata?: JsonObject;
+}
+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 V1ToolExecution = {
+    type: 'webhook';
+    url: string;
+    auth?: {
+        type: 'none';
+    } | {
+        type: 'hmac';
+        secretId: string;
     };
+    timeoutMs?: number;
+} | {
+    type: 'hosted_function';
+    functionVersionId: string;
+    functionId?: string;
+} | {
+    type: 'mcp_tool';
+    serverId: string;
+    toolName: string;
+} | {
+    type: 'hosted_workflow';
+    workflowId: string;
+} | {
+    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 {};