@bctrl/sdk 1.0.5 → 1.0.6

package/README.md

@@ -1,71 +1,72 @@
-# @bctrl/sdk
-
-TypeScript SDK for BCTRL v1 spaces, browser runtimes, invocations, runs, and files.
-
-## Install
-
-```bash
-npm install @bctrl/sdk
-```
-
-Node 18+ is required.
-
-## Quick start
-
-```ts
-import { Bctrl } from '@bctrl/sdk';
-
-const bctrl = new Bctrl({
-  apiKey: process.env.BCTRL_API_KEY!,
-});
-
-const space = await bctrl.spaces.create({
-  name: 'my-task',
-});
-
-const createdRuntime = await space.runtimes.create({
-  type: 'browser',
-  name: 'browser-task',
-  config: {
-    profile: false,
-  },
-});
-const started = await createdRuntime.start();
-console.log(started.run.id, started.browser.cdpUrl);
-
-const invocation = await started.runtime.invocations.create({
-  provider: 'stagehand',
-  method: 'act',
-  input: { instruction: 'Open https://example.com' },
-});
-
-const result = await invocation.wait({ timeoutMs: 60_000 });
-console.log(result.data.status);
-```
-
-The public SDK targets `https://api.bctrl.ai/v1`. For local development, pass a
-local origin or v1 base URL:
-
-```ts
-const bctrl = new Bctrl({
-  apiKey: process.env.BCTRL_API_KEY!,
-  baseUrl: 'http://localhost:8787',
-});
-```
-
-`baseUrl` may include or omit `/v1`; the client normalizes either form.
-
-## Entry points
-
-- `@bctrl/sdk`: v1 client, resources, errors, and public types
-
-## Documentation
-
-- SDK reference: https://platform.bctrl.ai/api-reference/sdk/overview
-- Product site: https://bctrl.ai
-
-## Telemetry
-
-The published SDK does not include vendor-owned telemetry or usage analytics.
-
-If you want observability around SDK calls, instrument your application directly with your own logging or error tracking.
+# @bctrl/sdk
+
+TypeScript SDK for BCTRL v1 spaces, browser runtimes, invocations, runs, and files.
+
+## Install
+
+```bash
+npm install @bctrl/sdk
+```
+
+Node 18+ is required.
+
+## Quick start
+
+```ts
+import { Bctrl } from '@bctrl/sdk';
+import { z } from 'zod';
+
+const bctrl = new Bctrl({
+  apiKey: process.env.BCTRL_API_KEY!,
+});
+
+const runtime = await bctrl.runtimes.create({
+  type: 'browser',
+  name: 'browser-task',
+});
+const started = await bctrl.runtimes.start(runtime.id);
+console.log(started.runId, started.connectUrl);
+
+const invocation = await bctrl.runtimes.invocations.createAndWait(
+  started.runtimeId,
+  {
+    action: 'extract',
+    instruction: 'Extract the page title.',
+    schema: z.object({
+      title: z.string(),
+    }),
+  },
+  { timeoutMs: 60_000 }
+);
+
+console.log(invocation.status, invocation.output);
+
+await bctrl.runtimes.stop(started.runtimeId);
+```
+
+The public SDK targets `https://api.bctrl.ai/v1`. For local development, pass a
+local origin or v1 base URL:
+
+```ts
+const bctrl = new Bctrl({
+  apiKey: process.env.BCTRL_API_KEY!,
+  baseUrl: 'http://localhost:8787',
+});
+```
+
+`baseUrl` may include or omit `/v1`; the client normalizes either form.
+
+## Entry points
+
+- `@bctrl/sdk`: v1 client, resources, errors, and public types
+
+## Documentation
+
+- SDK reference: https://platform.bctrl.ai/api-reference/sdk/overview
+- Product site: https://bctrl.ai
+
+## Telemetry
+
+The published SDK does not include vendor-owned telemetry or usage analytics.
+
+If you want observability around SDK calls, instrument your application directly with your own logging or error tracking.

package/dist/ai.d.ts

@@ -0,0 +1,23 @@
+import type { V1HttpClient } from './http.js';
+import type { V1AiCredential, V1AiCredentialCreateRequest, V1AiCredentialDeleteResponse, V1AiCredentialListQuery, V1AiCredentialTestResponse, V1AiCredentialUpdateRequest, V1AiModelListQuery, V1AiModelListResponse, V1ListEnvelope } from './types.js';
+export declare class V1AiModelsClient {
+    private readonly http;
+    constructor(http: V1HttpClient);
+    list(query?: V1AiModelListQuery): Promise<V1AiModelListResponse>;
+}
+export declare class V1AiCredentialsClient {
+    private readonly http;
+    constructor(http: V1HttpClient);
+    list(query?: V1AiCredentialListQuery): Promise<V1ListEnvelope<V1AiCredential>>;
+    iter(query?: V1AiCredentialListQuery): AsyncGenerator<V1AiCredential, void, undefined>;
+    create(request: V1AiCredentialCreateRequest): Promise<V1AiCredential>;
+    get(credentialId: string): Promise<V1AiCredential>;
+    update(credentialId: string, request: V1AiCredentialUpdateRequest): Promise<V1AiCredential>;
+    delete(credentialId: string): Promise<V1AiCredentialDeleteResponse>;
+    test(credentialId: string): Promise<V1AiCredentialTestResponse>;
+}
+export declare class V1AiClient {
+    readonly models: V1AiModelsClient;
+    readonly credentials: V1AiCredentialsClient;
+    constructor(http: V1HttpClient);
+}

package/dist/ai.js

@@ -0,0 +1,51 @@
+import { iterateV1Pages } from './pagination.js';
+export class V1AiModelsClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    list(query = {}) {
+        return this.http.request('/ai/models', { query });
+    }
+}
+export class V1AiCredentialsClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    list(query = {}) {
+        return this.http.request('/ai/credentials', { query });
+    }
+    iter(query = {}) {
+        return iterateV1Pages(query, (pageQuery) => this.list(pageQuery));
+    }
+    create(request) {
+        return this.http.request('/ai/credentials', {
+            method: 'POST',
+            body: request,
+        });
+    }
+    get(credentialId) {
+        return this.http.request(`/ai/credentials/${encodeURIComponent(credentialId)}`);
+    }
+    update(credentialId, request) {
+        return this.http.request(`/ai/credentials/${encodeURIComponent(credentialId)}`, {
+            method: 'PATCH',
+            body: request,
+        });
+    }
+    delete(credentialId) {
+        return this.http.request(`/ai/credentials/${encodeURIComponent(credentialId)}`, { method: 'DELETE' });
+    }
+    test(credentialId) {
+        return this.http.request(`/ai/credentials/${encodeURIComponent(credentialId)}/test`, { method: 'POST' });
+    }
+}
+export class V1AiClient {
+    models;
+    credentials;
+    constructor(http) {
+        this.models = new V1AiModelsClient(http);
+        this.credentials = new V1AiCredentialsClient(http);
+    }
+}

package/dist/aiTypes.d.ts

@@ -0,0 +1,97 @@
+import type { JsonObject, V1PageQuery } from './types.js';
+export type V1AiCredentialProvider = 'openai' | 'anthropic' | 'google' | 'azure' | 'groq' | 'deepseek' | 'mistral' | 'cerebras' | 'openrouter' | 'xai' | 'perplexity' | 'togetherai' | 'vercel-ai-gateway' | 'custom';
+export type V1AiModelStatus = 'recommended' | 'supported' | 'experimental';
+export type V1AiModelEngine = 'stagehand' | 'browserUse';
+export interface V1AiModel {
+    id: string;
+    provider: V1AiCredentialProvider;
+    displayName: string;
+    managed: boolean;
+    status: V1AiModelStatus;
+    engines: V1AiModelEngine[];
+    supportsTools: boolean;
+    supportsVision: boolean;
+    supportsStructuredOutput: boolean;
+    supportsReasoningEffort: boolean;
+    supportsThinkingBudget: boolean;
+}
+export interface V1AiModelListQuery {
+    provider?: V1AiCredentialProvider;
+    status?: V1AiModelStatus;
+    managed?: boolean;
+    engine?: V1AiModelEngine;
+}
+export interface V1AiModelListResponse {
+    data: V1AiModel[];
+}
+export type V1AiCredentialStatus = 'enabled' | 'disabled';
+export interface V1AiCredential {
+    id: string;
+    name: string;
+    provider: V1AiCredentialProvider;
+    status: V1AiCredentialStatus;
+    subaccountId?: string;
+    defaultModel?: string;
+    baseUrl?: string;
+    hasApiKey: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface V1AiCredentialListQuery extends V1PageQuery {
+    provider?: V1AiCredentialProvider;
+    name?: string;
+    status?: V1AiCredentialStatus;
+}
+export interface V1AiCredentialCreateRequest {
+    provider: V1AiCredentialProvider;
+    name?: string;
+    apiKey?: string;
+    defaultModel?: string;
+    baseUrl?: string;
+    status?: V1AiCredentialStatus;
+    subaccountId?: string | null;
+    test?: boolean;
+}
+export interface V1AiCredentialUpdateRequest {
+    name?: string;
+    apiKey?: string | null;
+    defaultModel?: string | null;
+    baseUrl?: string | null;
+    status?: V1AiCredentialStatus;
+}
+export interface V1AiCredentialDeleteResponse {
+    id: string;
+    deleted: true;
+}
+export interface V1AiCredentialTestResponse {
+    ok: boolean;
+    checkedAt: string;
+    latencyMs?: number;
+    error?: string;
+}
+export type V1AiModelSelectionAuth = 'managed' | {
+    credential: string;
+} | {
+    apiKey: string;
+};
+export interface V1AiModelSelectionObject {
+    model: string;
+    auth?: V1AiModelSelectionAuth;
+    provider?: V1AiCredentialProvider;
+    baseUrl?: string;
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    reasoningEffort?: 'none' | 'low' | 'medium' | 'high' | 'xhigh';
+    thinkingBudgetTokens?: number;
+    responseFormat?: 'text' | 'json';
+    responseSchema?: JsonObject;
+    providerOptions?: JsonObject;
+}
+export type V1AiModelSelection = string | V1AiModelSelectionObject;
+export type V1AiStoredModelSelectionAuth = 'managed' | {
+    credential: string;
+};
+export type V1AiStoredModelSelection = string | (Omit<V1AiModelSelectionObject, 'auth' | 'baseUrl'> & {
+    auth?: V1AiStoredModelSelectionAuth;
+});

package/dist/bctrl.d.ts

@@ -1,5 +1,5 @@
 import { V1AccountClient, V1ApiKeysClient, V1AuthClient, V1SubaccountsClient, V1UsageClient } from './account.js';
-import { V1AiProvidersClient } from './aiProviders.js';
+import { V1AiClient } from './ai.js';
 import { V1BrowserExtensionsClient } from './browserExtensions.js';
 import { V1FilesClient } from './files.js';
 import { V1HelpClient } from './help.js';
@@ -26,7 +26,7 @@ export declare class BctrlV1 {
     private _vault;
     private _proxies;
     private _browserExtensions;
-    private _aiProviders;
+    private _ai;
     private _account;
     private _apiKeys;
     private _auth;
@@ -45,7 +45,7 @@ export declare class BctrlV1 {
     get vault(): V1VaultClient;
     get proxies(): V1ProxiesClient;
     get browserExtensions(): V1BrowserExtensionsClient;
-    get aiProviders(): V1AiProvidersClient;
+    get ai(): V1AiClient;
     get account(): V1AccountClient;
     get apiKeys(): V1ApiKeysClient;
     get auth(): V1AuthClient;

package/dist/bctrl.js

@@ -1,5 +1,5 @@
 import { V1AccountClient, V1ApiKeysClient, V1AuthClient, V1SubaccountsClient, V1UsageClient, } from './account.js';
-import { V1AiProvidersClient } from './aiProviders.js';
+import { V1AiClient } from './ai.js';
 import { V1BrowserExtensionsClient } from './browserExtensions.js';
 import { isControllerBusy } from './errors.js';
 import { V1FilesClient } from './files.js';
@@ -26,7 +26,7 @@ export class BctrlV1 {
     _vault = null;
     _proxies = null;
     _browserExtensions = null;
-    _aiProviders = null;
+    _ai = null;
     _account = null;
     _apiKeys = null;
     _auth = null;
@@ -82,9 +82,9 @@ export class BctrlV1 {
         this._browserExtensions ??= new V1BrowserExtensionsClient(this.http);
         return this._browserExtensions;
     }
-    get aiProviders() {
-        this._aiProviders ??= new V1AiProvidersClient(this.http);
-        return this._aiProviders;
+    get ai() {
+        this._ai ??= new V1AiClient(this.http);
+        return this._ai;
     }
     get account() {
         this._account ??= new V1AccountClient(this.http);

package/dist/files.d.ts

@@ -1,9 +1,9 @@
 import type { V1HttpClient } from './http.js';
-import type { V1File, V1FileDeleteResponse, V1FilesListQuery, V1FileUpdateRequest, V1FileUploadRequest, V1ListEnvelope } from './types.js';
+import type { V1File, V1FileDeleteResponse, V1FilesListQuery, V1FilesListResponse, V1FileUpdateRequest, V1FileUploadRequest } from './types.js';
 export declare class V1FilesClient {
     private readonly http;
     constructor(http: V1HttpClient);
-    list(query?: V1FilesListQuery): Promise<V1ListEnvelope<V1File>>;
+    list(query?: V1FilesListQuery): Promise<V1FilesListResponse>;
     iter(query?: V1FilesListQuery): AsyncGenerator<V1File, void, undefined>;
     get(id: string): Promise<V1File>;
     update(id: string, request: V1FileUpdateRequest): Promise<V1File>;

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 export { Bctrl, BctrlV1, type BctrlV1Options } from './bctrl.js';
 export { V1AccountClient, V1ApiKeysClient, V1AuthClient, V1SubaccountsClient, V1SubaccountUsageClient, V1UsageClient, } from './account.js';
-export { V1AiProvidersClient } from './aiProviders.js';
+export { V1AiClient, V1AiCredentialsClient, V1AiModelsClient } from './ai.js';
 export { V1BrowserExtensionsClient } from './browserExtensions.js';
 export { BctrlError, BctrlApiError, BctrlAuthenticationError, BctrlConflictError, BctrlNetworkError, BctrlNotFoundError, BctrlNotReadyError, BctrlPermissionError, BctrlRateLimitError, BctrlUnsupportedError, BctrlValidationError, isControllerBusy, } from './errors.js';
 export { V1FilesClient } from './files.js';
 export { V1HelpClient } from './help.js';
 export { V1RuntimeBrowserUseInvocationsNamespaceClient, V1RuntimeInvocationsNamespaceClient, V1RuntimeStagehandInvocationsNamespaceClient, } from './invocations.js';
 export type { BrowserUseAgentOptions, V1InvocationCreateAndWaitOptions, V1InvocationWaitOptions, V1RuntimeInvocationCreateInput, StagehandActOptions, StagehandAgentOptions, StagehandExtractOptions, StagehandObserveOptions, StagehandVariablePrimitive, StagehandVariableValue, StagehandVariables, } from './invocations.js';
-export { V1RuntimeFilesNamespaceClient, V1RuntimeRunsNamespaceClient, V1RuntimesClient, } from './runtimes.js';
+export { V1RuntimeFilesNamespaceClient, V1RuntimeRunsNamespaceClient, V1RuntimeTargetsNamespaceClient, V1RuntimesClient, } from './runtimes.js';
 export { V1ProxiesClient, V1ProxyPoolsClient } from './proxies.js';
 export { V1RunActivityNamespaceClient, V1RunEventsNamespaceClient, V1RunFilesNamespaceClient, V1RunInvocationsNamespaceClient, V1RunsClient, } from './runs.js';
 export { toOutputSchema, type JsonSchemaLike, type JsonSchemaObject } from './schemas.js';

package/dist/index.js

@@ -1,12 +1,12 @@
 export { Bctrl, BctrlV1 } from './bctrl.js';
 export { V1AccountClient, V1ApiKeysClient, V1AuthClient, V1SubaccountsClient, V1SubaccountUsageClient, V1UsageClient, } from './account.js';
-export { V1AiProvidersClient } from './aiProviders.js';
+export { V1AiClient, V1AiCredentialsClient, V1AiModelsClient } from './ai.js';
 export { V1BrowserExtensionsClient } from './browserExtensions.js';
 export { BctrlError, BctrlApiError, BctrlAuthenticationError, BctrlConflictError, BctrlNetworkError, BctrlNotFoundError, BctrlNotReadyError, BctrlPermissionError, BctrlRateLimitError, BctrlUnsupportedError, BctrlValidationError, isControllerBusy, } from './errors.js';
 export { V1FilesClient } from './files.js';
 export { V1HelpClient } from './help.js';
 export { V1RuntimeBrowserUseInvocationsNamespaceClient, V1RuntimeInvocationsNamespaceClient, V1RuntimeStagehandInvocationsNamespaceClient, } from './invocations.js';
-export { V1RuntimeFilesNamespaceClient, V1RuntimeRunsNamespaceClient, V1RuntimesClient, } from './runtimes.js';
+export { V1RuntimeFilesNamespaceClient, V1RuntimeRunsNamespaceClient, V1RuntimeTargetsNamespaceClient, V1RuntimesClient, } from './runtimes.js';
 export { V1ProxiesClient, V1ProxyPoolsClient } from './proxies.js';
 export { V1RunActivityNamespaceClient, V1RunEventsNamespaceClient, V1RunFilesNamespaceClient, V1RunInvocationsNamespaceClient, V1RunsClient, } from './runs.js';
 export { toOutputSchema } from './schemas.js';

package/dist/invocations.d.ts

@@ -1,6 +1,6 @@
 import { type V1HttpClient, type V1IdempotencyOptions } from './http.js';
 import { type JsonSchemaLike } from './schemas.js';
-import type { JsonObject, V1Invocation, V1InvocationPage, V1RuntimeInvocationCreateRequest, V1RuntimeInvocationFileInput, V1InvocationWaitRequest, V1InvocationWaitResponse } from './types.js';
+import type { JsonObject, V1Invocation, V1RuntimeInvocationCreateRequest, V1RuntimeInvocationFileInput, V1RuntimeTargetSelector, V1InvocationWaitRequest, V1InvocationWaitResponse, V1AiModelSelection } from './types.js';
 export type StagehandVariablePrimitive = string | number | boolean;
 export type StagehandVariableValue = StagehandVariablePrimitive | {
     value: StagehandVariablePrimitive;
@@ -8,7 +8,7 @@ export type StagehandVariableValue = StagehandVariablePrimitive | {
 };
 export type StagehandVariables = Record<string, StagehandVariableValue>;
 interface RuntimeInvocationCommonOptions {
-    page?: V1InvocationPage;
+    target?: V1RuntimeTargetSelector;
     metadata?: JsonObject;
 }
 interface RuntimeAgentCommonOptions extends RuntimeInvocationCommonOptions {
@@ -16,12 +16,10 @@ interface RuntimeAgentCommonOptions extends RuntimeInvocationCommonOptions {
     toolIds?: string[];
     files?: V1RuntimeInvocationFileInput[];
     schema?: JsonSchemaLike;
-    outputSchema?: JsonObject;
     timeoutMs?: number;
 }
 interface AiSelectionOptions {
-    aiProviderId?: string;
-    model?: string;
+    model?: V1AiModelSelection;
     temperature?: number;
 }
 export interface StagehandActOptions extends RuntimeInvocationCommonOptions, AiSelectionOptions {
@@ -44,15 +42,15 @@ export interface StagehandAgentOptions extends RuntimeAgentCommonOptions, AiSele
     instruction: string;
     maxSteps?: number;
     variables?: StagehandVariables;
-    executionAiProviderId?: string;
+    executionModel?: V1AiModelSelection;
     systemPrompt?: string;
     highlightCursor?: boolean;
 }
 export interface BrowserUseAgentOptions extends RuntimeAgentCommonOptions, AiSelectionOptions {
     instruction: string;
     maxSteps?: number;
-    extractionAiProviderId?: string;
-    fallbackAiProviderId?: string;
+    extractionModel?: V1AiModelSelection;
+    fallbackModel?: V1AiModelSelection;
     useVision?: boolean | 'auto';
     visionDetailLevel?: 'low' | 'high' | 'auto';
     flashMode?: boolean;
@@ -70,7 +68,6 @@ export interface BrowserUseAgentOptions extends RuntimeAgentCommonOptions, AiSel
 }
 type InvocationCreateWithSchema<T extends V1RuntimeInvocationCreateRequest> = Omit<T, 'outputSchema'> & {
     schema?: JsonSchemaLike;
-    outputSchema?: JsonObject;
 };
 type ExtractInvocationCreateRequest = Extract<V1RuntimeInvocationCreateRequest, {
     action: 'extract';

package/dist/invocations.js

@@ -162,9 +162,6 @@ function prepareInvocationCreateRequest(request) {
     if (!hasInvocationSchema(request)) {
         return request;
     }
-    if ('outputSchema' in request && request.outputSchema !== undefined) {
-        throw new TypeError('Pass either schema or outputSchema, not both');
-    }
     const { schema, ...body } = request;
     return {
         ...body,

package/dist/proxyTypes.d.ts

@@ -1,4 +1,5 @@
 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';
@@ -12,6 +13,7 @@ export interface V1ProxyBase {
 }
 export interface V1ManagedRotatingProxyConfig {
     protocol?: V1ProxyProtocol;
+    dnsResolution?: V1ProxyDnsResolution;
     ipFamily?: 'dual-stack' | 'ipv4-only';
     preference?: V1ManagedRotatingPreference;
     rotation?: V1ManagedRotatingRotation;
@@ -28,6 +30,7 @@ export interface V1ManagedRotatingProxyConfig {
 export type V1Proxy = (V1ProxyBase & {
     type: 'custom';
     protocol: V1ProxyProtocol;
+    dnsResolution?: V1ProxyDnsResolution;
     host: string;
     port: number;
     username?: string | null;
@@ -56,6 +59,7 @@ export type V1ProxyCreateRequest = {
     name?: string;
     url?: string;
     protocol?: V1ProxyProtocol;
+    dnsResolution?: V1ProxyDnsResolution;
     host?: string;
     port?: number;
     username?: string;
@@ -73,6 +77,7 @@ export interface V1ProxyUpdateRequest extends Partial<V1ManagedRotatingProxyConf
     name?: string;
     url?: string;
     protocol?: V1ProxyProtocol;
+    dnsResolution?: V1ProxyDnsResolution;
     host?: string;
     port?: number;
     username?: string | null;

package/dist/runtimes.d.ts

@@ -1,17 +1,22 @@
 import { type V1HttpClient, type V1IdempotencyOptions } from './http.js';
 import { V1RuntimeInvocationsNamespaceClient } from './invocations.js';
-import type { V1ListEnvelope, V1File, V1Runtime, V1RuntimeCreateRequest, V1RuntimeFileCollectRequest, V1RuntimeFilesListQuery, V1RuntimeFileStageRequest, V1RuntimeFileUploadRequest, V1RuntimeStagedFile, V1RuntimeListQuery, V1RuntimeRunListQuery, V1RuntimeStartResponse, V1RuntimeStopResponse, V1RunSummary, V1SpaceRuntimeCreateRequest } from './types.js';
+import type { V1ListEnvelope, V1File, V1Runtime, V1RuntimeCreateRequest, V1RuntimeDeleteResponse, V1RuntimeFileCollectRequest, V1RuntimeFilesListQuery, V1RuntimeFileStageRequest, V1RuntimeFileUploadRequest, V1RuntimeStagedFile, V1RuntimeListQuery, V1RuntimeRunListQuery, V1RuntimeStartResponse, V1RuntimeStopResponse, V1RuntimeTarget, V1RuntimeTargetCreateRequest, V1RuntimeUpdateRequest, V1RunSummary, V1SpaceRuntimeCreateRequest } from './types.js';
 export type V1RuntimeStartResult = V1RuntimeStartResponse;
 export declare class V1RuntimesClient {
     private readonly http;
     readonly files: V1RuntimeFilesNamespaceClient;
     readonly runs: V1RuntimeRunsNamespaceClient;
     readonly invocations: V1RuntimeInvocationsNamespaceClient;
+    readonly targets: V1RuntimeTargetsNamespaceClient;
     constructor(http: V1HttpClient);
     list(query?: V1RuntimeListQuery): Promise<V1ListEnvelope<V1Runtime>>;
     iter(query?: V1RuntimeListQuery): AsyncGenerator<V1Runtime, void, undefined>;
     create(request: V1RuntimeCreateRequest): Promise<V1Runtime>;
     createInSpace(spaceId: string, request: V1SpaceRuntimeCreateRequest): Promise<V1Runtime>;
+    update(id: string, request: V1RuntimeUpdateRequest): Promise<V1Runtime>;
+    delete(id: string, options?: {
+        force?: boolean;
+    }): Promise<V1RuntimeDeleteResponse>;
     get(id: string): Promise<V1Runtime>;
     stop(id: string): Promise<V1RuntimeStopResponse>;
     start(id: string, options?: V1IdempotencyOptions): Promise<V1RuntimeStartResult>;
@@ -31,3 +36,15 @@ export declare class V1RuntimeFilesNamespaceClient {
     stage(runtimeId: string, request: V1RuntimeFileStageRequest): Promise<V1RuntimeStagedFile>;
     collect(runtimeId: string, request: V1RuntimeFileCollectRequest): Promise<V1File>;
 }
+export declare class V1RuntimeTargetsNamespaceClient {
+    private readonly http;
+    constructor(http: V1HttpClient);
+    list(runtimeId: string): Promise<V1ListEnvelope<V1RuntimeTarget>>;
+    create(runtimeId: string, request?: V1RuntimeTargetCreateRequest): Promise<V1RuntimeTarget>;
+    get(runtimeId: string, targetId: string): Promise<V1RuntimeTarget>;
+    activate(runtimeId: string, targetId: string): Promise<V1RuntimeTarget>;
+    delete(runtimeId: string, targetId: string): Promise<{
+        id: string;
+        deleted: boolean;
+    }>;
+}

package/dist/runtimes.js

@@ -62,16 +62,39 @@ class V1RuntimeFilesClient {
         });
     }
 }
+class V1RuntimeTargetsClient {
+    http;
+    runtimeId;
+    constructor(http, runtimeId) {
+        this.http = http;
+        this.runtimeId = runtimeId;
+    }
+    list() {
+        return this.http.request(`/runtimes/${encodeURIComponent(this.runtimeId)}/targets`);
+    }
+    create(request = {}) {
+        return this.http.request(`/runtimes/${encodeURIComponent(this.runtimeId)}/targets`, {
+            method: 'POST',
+            body: request,
+        });
+    }
+    get(targetId) {
+        return this.http.request(`/runtimes/${encodeURIComponent(this.runtimeId)}/targets/${encodeURIComponent(targetId)}`);
+    }
+    activate(targetId) {
+        return this.http.request(`/runtimes/${encodeURIComponent(this.runtimeId)}/targets/${encodeURIComponent(targetId)}/activate`, { method: 'POST' });
+    }
+    delete(targetId) {
+        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;
-    if (!request.name?.trim()) {
-        throw new BctrlValidationError('name is required when config.profile is true', 'runtime.profile_name_required');
-    }
-    const unsupported = ['stealth', 'proxy', 'fingerprint', 'extensionIds'].filter((key) => request.config?.[key] !== undefined);
+    const unsupported = ['stealth', 'fingerprint', 'extensionIds'].filter((key) => request.config?.[key] !== undefined);
     if (unsupported.length > 0) {
-        throw new BctrlValidationError('Only config.profile, config.idleTimeoutMinutes, config.webRtcProxyOnly, config.forceOpenShadowRoots, and config.networkTraffic are supported for profile-backed browser runtimes', 'runtime.profile_config_unsupported', { unsupported });
+        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 {
@@ -79,11 +102,13 @@ export class V1RuntimesClient {
     files;
     runs;
     invocations;
+    targets;
     constructor(http) {
         this.http = http;
         this.files = new V1RuntimeFilesNamespaceClient(http);
         this.runs = new V1RuntimeRunsNamespaceClient(http);
         this.invocations = new V1RuntimeInvocationsNamespaceClient(http);
+        this.targets = new V1RuntimeTargetsNamespaceClient(http);
     }
     list(query = {}) {
         return this.http.request('/runtimes', { query });
@@ -105,6 +130,15 @@ export class V1RuntimesClient {
             body: { ...request, spaceId },
         });
     }
+    update(id, request) {
+        return this.http.request(`/runtimes/${encodeURIComponent(id)}`, {
+            method: 'PATCH',
+            body: request,
+        });
+    }
+    delete(id, options = {}) {
+        return this.http.request(`/runtimes/${encodeURIComponent(id)}${options.force ? '?force=true' : ''}`, { method: 'DELETE' });
+    }
     get(id) {
         return this.http.request(`/runtimes/${encodeURIComponent(id)}`);
     }
@@ -153,3 +187,24 @@ export class V1RuntimeFilesNamespaceClient {
         return new V1RuntimeFilesClient(this.http, runtimeId).collect(request);
     }
 }
+export class V1RuntimeTargetsNamespaceClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    list(runtimeId) {
+        return new V1RuntimeTargetsClient(this.http, runtimeId).list();
+    }
+    create(runtimeId, request = {}) {
+        return new V1RuntimeTargetsClient(this.http, runtimeId).create(request);
+    }
+    get(runtimeId, targetId) {
+        return new V1RuntimeTargetsClient(this.http, runtimeId).get(targetId);
+    }
+    activate(runtimeId, targetId) {
+        return new V1RuntimeTargetsClient(this.http, runtimeId).activate(targetId);
+    }
+    delete(runtimeId, targetId) {
+        return new V1RuntimeTargetsClient(this.http, runtimeId).delete(targetId);
+    }
+}

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 { 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 { 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';
@@ -134,10 +136,10 @@ export interface V1SpaceVaultMount {
     allowRawReads?: boolean;
 }
 export interface V1SpaceAiMount {
-    aiProviderIds?: string[];
+    credentialIds?: string[];
     defaults?: {
-        stagehand?: string;
-        browserUse?: string;
+        stagehand?: V1AiStoredModelSelection;
+        browserUse?: V1AiStoredModelSelection;
     };
 }
 export interface V1SpaceEnvironment {
@@ -146,10 +148,10 @@ export interface V1SpaceEnvironment {
     ai?: V1SpaceAiMount;
 }
 export interface V1SpaceAiMountUpdate {
-    aiProviderIds?: string[] | null;
+    credentialIds?: string[] | null;
     defaults?: {
-        stagehand?: string | null;
-        browserUse?: string | null;
+        stagehand?: V1AiStoredModelSelection | null;
+        browserUse?: V1AiStoredModelSelection | null;
     } | null;
 }
 export interface V1SpaceEnvironmentUpdateRequest {
@@ -160,21 +162,34 @@ export interface V1SpaceEnvironmentUpdateRequest {
 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';
@@ -188,6 +203,10 @@ export interface V1BrowserNetworkTrafficConfig {
 }
 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;
@@ -206,6 +225,17 @@ export interface V1RuntimeCreateRequest {
     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?: V1RuntimeStatus | V1RuntimeStatus[];
@@ -229,16 +259,30 @@ export interface V1RuntimeProxyRef {
     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;
+    locale?: string | string[];
     timezone?: string;
     viewport?: {
         width: number;
         height: number;
     };
-    browser?: string;
 }
 /**
  * Type-specific browser runtime config returned on the runtime resource. No open
@@ -246,8 +290,9 @@ export interface V1RuntimeFingerprint {
  */
 export interface V1BrowserRuntimeConfig {
     profile: boolean;
+    autoUpgrade?: boolean;
     stealth?: V1BrowserStealth;
-    proxy?: V1RuntimeProxyRef | null;
+    proxy?: V1RuntimeProxyRef | V1RuntimeInlineProxyConfig | null;
     fingerprint?: V1RuntimeFingerprint;
     extensionIds?: string[];
     idleTimeoutMinutes?: number;
@@ -394,21 +439,37 @@ export interface V1RunLiveRequest {
     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 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 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;
@@ -458,7 +519,7 @@ export interface V1RuntimeInvocationFileInput {
     name?: string;
 }
 interface V1RuntimeInvocationAgentFields {
-    page?: V1InvocationPage;
+    target?: V1RuntimeTargetSelector;
     outputSchema?: JsonObject;
     toolsetId?: string;
     toolIds?: string[];
@@ -467,49 +528,44 @@ interface V1RuntimeInvocationAgentFields {
     timeoutMs?: number;
 }
 interface V1RuntimeInvocationAiSelectionFields {
-    aiProviderId?: string;
-    model?: string;
+    model?: V1AiModelSelection;
     temperature?: number;
 }
 export type V1RuntimeInvocationCreateRequest = {
     action: 'act';
-    page?: V1InvocationPage;
+    target?: V1RuntimeTargetSelector;
     instruction: string;
     stagehandAction?: JsonObject;
     timeoutMs?: number;
-    aiProviderId?: string;
-    model?: string;
+    model?: V1AiModelSelection;
     temperature?: number;
     metadata?: JsonObject;
 } | {
     action: 'act';
-    page?: V1InvocationPage;
+    target?: V1RuntimeTargetSelector;
     stagehandAction: JsonObject;
     instruction?: string;
     timeoutMs?: number;
-    aiProviderId?: string;
-    model?: string;
+    model?: V1AiModelSelection;
     temperature?: number;
     metadata?: JsonObject;
 } | {
     action: 'observe';
-    page?: V1InvocationPage;
+    target?: V1RuntimeTargetSelector;
     instruction: string;
     selector?: string;
     timeoutMs?: number;
-    aiProviderId?: string;
-    model?: string;
+    model?: V1AiModelSelection;
     temperature?: number;
     metadata?: JsonObject;
 } | {
     action: 'extract';
-    page?: V1InvocationPage;
+    target?: V1RuntimeTargetSelector;
     instruction?: string;
     selector?: string;
     outputSchema?: JsonObject;
     timeoutMs?: number;
-    aiProviderId?: string;
-    model?: string;
+    model?: V1AiModelSelection;
     temperature?: number;
     metadata?: JsonObject;
 } | (V1RuntimeInvocationAgentFields & V1RuntimeInvocationAiSelectionFields & {
@@ -517,15 +573,15 @@ export type V1RuntimeInvocationCreateRequest = {
     instruction: string;
     maxSteps?: number;
     variables?: JsonObject;
-    executionAiProviderId?: string;
+    executionModel?: V1AiModelSelection;
     systemPrompt?: string;
     highlightCursor?: boolean;
 }) | (V1RuntimeInvocationAgentFields & V1RuntimeInvocationAiSelectionFields & {
     action: 'browserUse';
     instruction: string;
     maxSteps?: number;
-    extractionAiProviderId?: string;
-    fallbackAiProviderId?: string;
+    extractionModel?: V1AiModelSelection;
+    fallbackModel?: V1AiModelSelection;
     useVision?: boolean | 'auto';
     visionDetailLevel?: 'low' | 'high' | 'auto';
     flashMode?: boolean;
@@ -542,7 +598,9 @@ export type V1RuntimeInvocationCreateRequest = {
     sensitiveData?: Record<string, string | Record<string, string>>;
 }) | {
     action: 'solveCaptcha';
-    page?: 'active';
+    target?: 'active' | {
+        id: string;
+    };
     timeoutMs?: number;
     metadata?: JsonObject;
 };
@@ -571,7 +629,24 @@ export interface V1FilesListQuery extends V1PageQuery {
     path?: string;
     prefix?: 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;
@@ -626,7 +701,7 @@ export interface V1RuntimeFileCollectRequest {
     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 { 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 = {

package/package.json

@@ -1,46 +1,46 @@
-{
-  "name": "@bctrl/sdk",
-  "version": "1.0.5",
-  "description": "BCTRL SDK - Remote browser automation",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./node": {
-      "types": "./dist/node.d.ts",
-      "import": "./dist/node.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",
-  "dependencies": {
-    "zod": "^4.3.6"
-  },
-  "packageManager": "pnpm@10.12.4",
-  "devDependencies": {
-    "@types/node": "^25.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.56.0",
-    "@typescript-eslint/parser": "^8.56.0",
-    "eslint": "^10.0.0",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3"
-  },
-  "files": [
-    "dist"
-  ]
-}
+{
+  "name": "@bctrl/sdk",
+  "version": "1.0.6",
+  "description": "BCTRL SDK - Remote browser automation",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
+    }
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "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",
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "packageManager": "pnpm@10.12.4",
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.56.0",
+    "@typescript-eslint/parser": "^8.56.0",
+    "eslint": "^10.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "files": [
+    "dist"
+  ]
+}

package/dist/aiProviderTypes.d.ts

@@ -1,58 +0,0 @@
-import type { V1PageQuery } from './types.js';
-export type V1AiProviderProvider = 'openai' | 'anthropic' | 'google' | 'groq' | 'deepseek' | 'mistral' | 'cerebras' | 'openrouter' | 'xai' | 'perplexity' | 'togetherai' | 'vercel-ai-gateway' | 'custom';
-export type V1AiProviderStatus = 'enabled' | 'disabled';
-export interface V1AiProviderModel {
-    id: string;
-    name?: string;
-    inputModalities?: string[];
-    outputModalities?: string[];
-}
-export interface V1AiProvider {
-    id: string;
-    name?: string;
-    provider: V1AiProviderProvider;
-    status: V1AiProviderStatus;
-    subaccountId?: string;
-    defaultModel?: string;
-    baseUrl?: string;
-    hasApiKey: boolean;
-    models?: V1AiProviderModel[];
-    createdAt: string;
-    updatedAt: string;
-}
-export interface V1AiProviderListQuery extends V1PageQuery {
-    provider?: V1AiProviderProvider;
-    status?: V1AiProviderStatus;
-    include?: 'models' | 'models'[];
-    subaccountId?: string;
-}
-export interface V1AiProviderGetQuery {
-    include?: 'models' | 'models'[];
-}
-export interface V1AiProviderCreateRequest {
-    provider: V1AiProviderProvider;
-    name?: string;
-    apiKey?: string;
-    defaultModel?: string;
-    baseUrl?: string;
-    status?: V1AiProviderStatus;
-    subaccountId?: string | null;
-    test?: boolean;
-}
-export interface V1AiProviderUpdateRequest {
-    name?: string;
-    apiKey?: string | null;
-    defaultModel?: string | null;
-    baseUrl?: string | null;
-    status?: V1AiProviderStatus;
-}
-export interface V1AiProviderDeleteResponse {
-    id: string;
-    deleted: true;
-}
-export interface V1AiProviderTestResponse {
-    ok: boolean;
-    checkedAt: string;
-    latencyMs?: number;
-    error?: string;
-}

package/dist/aiProviders.d.ts

@@ -1,13 +0,0 @@
-import type { V1HttpClient } from './http.js';
-import type { V1AiProvider, V1AiProviderCreateRequest, V1AiProviderDeleteResponse, V1AiProviderGetQuery, V1AiProviderListQuery, V1AiProviderTestResponse, V1AiProviderUpdateRequest, V1ListEnvelope } from './types.js';
-export declare class V1AiProvidersClient {
-    private readonly http;
-    constructor(http: V1HttpClient);
-    list(query?: V1AiProviderListQuery): Promise<V1ListEnvelope<V1AiProvider>>;
-    iter(query?: V1AiProviderListQuery): AsyncGenerator<V1AiProvider, void, undefined>;
-    create(request: V1AiProviderCreateRequest): Promise<V1AiProvider>;
-    get(aiProviderId: string, query?: V1AiProviderGetQuery): Promise<V1AiProvider>;
-    update(aiProviderId: string, request: V1AiProviderUpdateRequest): Promise<V1AiProvider>;
-    delete(aiProviderId: string): Promise<V1AiProviderDeleteResponse>;
-    test(aiProviderId: string): Promise<V1AiProviderTestResponse>;
-}

package/dist/aiProviders.js

@@ -1,36 +0,0 @@
-import { iterateV1Pages } from './pagination.js';
-export class V1AiProvidersClient {
-    http;
-    constructor(http) {
-        this.http = http;
-    }
-    list(query = {}) {
-        return this.http.request('/ai-providers', { query });
-    }
-    iter(query = {}) {
-        return iterateV1Pages(query, (pageQuery) => this.list(pageQuery));
-    }
-    create(request) {
-        return this.http.request('/ai-providers', {
-            method: 'POST',
-            body: request,
-        });
-    }
-    get(aiProviderId, query = {}) {
-        return this.http.request(`/ai-providers/${encodeURIComponent(aiProviderId)}`, {
-            query,
-        });
-    }
-    update(aiProviderId, request) {
-        return this.http.request(`/ai-providers/${encodeURIComponent(aiProviderId)}`, {
-            method: 'PATCH',
-            body: request,
-        });
-    }
-    delete(aiProviderId) {
-        return this.http.request(`/ai-providers/${encodeURIComponent(aiProviderId)}`, { method: 'DELETE' });
-    }
-    test(aiProviderId) {
-        return this.http.request(`/ai-providers/${encodeURIComponent(aiProviderId)}/test`, { method: 'POST' });
-    }
-}