@bctrl/sdk 1.0.1 → 1.0.3

package/dist/browser-extensions/client.js

@@ -1,72 +0,0 @@
-import { fetchWithTimeout, parseErrorDetails, parseJsonResponse } from '../utils/http.js';
-import { SDK_VERSION } from '../version.js';
-function buildHeaders(apiKey) {
-    return {
-        'x-sdk-version': SDK_VERSION,
-        Authorization: `Bearer ${apiKey}`,
-    };
-}
-function buildJsonHeaders(apiKey) {
-    return {
-        ...buildHeaders(apiKey),
-        'Content-Type': 'application/json',
-    };
-}
-async function expectJson(response, context) {
-    if (!response.ok) {
-        const details = parseErrorDetails(await response.text());
-        throw new Error(`${context}: ${details.message}`);
-    }
-    return parseJsonResponse(response, context);
-}
-function toBlob(data) {
-    if (data instanceof Blob)
-        return data;
-    return new Blob([new Uint8Array(data)]);
-}
-export class BrowserExtensionsClient {
-    baseUrl;
-    apiKey;
-    constructor(baseUrl, apiKey) {
-        this.baseUrl = baseUrl;
-        this.apiKey = apiKey;
-    }
-    async list() {
-        const response = await fetchWithTimeout(`${this.baseUrl}/browser-extensions`, {
-            headers: buildHeaders(this.apiKey),
-        });
-        const data = await expectJson(response, 'List browser extensions');
-        return data.extensions;
-    }
-    async upload(request) {
-        const formData = new FormData();
-        formData.append('file', toBlob(request.file), request.filename);
-        const response = await fetchWithTimeout(`${this.baseUrl}/browser-extensions/upload`, {
-            method: 'POST',
-            headers: buildHeaders(this.apiKey),
-            body: formData,
-        });
-        return expectJson(response, 'Upload browser extension');
-    }
-    async importFromUrl(request) {
-        const response = await fetchWithTimeout(`${this.baseUrl}/browser-extensions/import-url`, {
-            method: 'POST',
-            headers: buildJsonHeaders(this.apiKey),
-            body: JSON.stringify(request),
-        });
-        return expectJson(response, 'Import browser extension');
-    }
-    async get(id) {
-        const response = await fetchWithTimeout(`${this.baseUrl}/browser-extensions/${encodeURIComponent(id)}`, {
-            headers: buildHeaders(this.apiKey),
-        });
-        return expectJson(response, 'Get browser extension');
-    }
-    async delete(id) {
-        const response = await fetchWithTimeout(`${this.baseUrl}/browser-extensions/${encodeURIComponent(id)}`, {
-            method: 'DELETE',
-            headers: buildHeaders(this.apiKey),
-        });
-        return expectJson(response, 'Delete browser extension');
-    }
-}

package/dist/browser-extensions/index.d.ts

@@ -1,2 +0,0 @@
-export { BrowserExtensionsClient } from './client.js';
-export type { BrowserExtensionUploadRequest } from './client.js';

package/dist/browser-extensions/index.js

@@ -1 +0,0 @@
-export { BrowserExtensionsClient } from './client.js';

package/dist/browser-profiles/client.d.ts

@@ -1,11 +0,0 @@
-import type { BrowserProfile, BrowserProfileCreateRequest, BrowserProfileDeleteResponse, BrowserProfileDetail, BrowserProfileUpdateRequest } from '../contracts/public-api.js';
-export declare class BrowserProfilesClient {
-    private readonly baseUrl;
-    private readonly apiKey;
-    constructor(baseUrl: string, apiKey: string);
-    list(): Promise<BrowserProfile[]>;
-    create(request: BrowserProfileCreateRequest): Promise<BrowserProfileDetail>;
-    get(id: string): Promise<BrowserProfileDetail>;
-    update(id: string, request: BrowserProfileUpdateRequest): Promise<BrowserProfileDetail>;
-    delete(id: string): Promise<BrowserProfileDeleteResponse>;
-}

package/dist/browser-profiles/client.js

@@ -1,63 +0,0 @@
-import { fetchWithTimeout, parseErrorDetails, parseJsonResponse } from '../utils/http.js';
-import { SDK_VERSION } from '../version.js';
-function buildHeaders(apiKey, withJsonBody = false) {
-    const headers = {
-        'x-sdk-version': SDK_VERSION,
-        Authorization: `Bearer ${apiKey}`,
-    };
-    if (withJsonBody) {
-        headers['Content-Type'] = 'application/json';
-    }
-    return headers;
-}
-async function expectJson(response, context) {
-    if (!response.ok) {
-        const details = parseErrorDetails(await response.text());
-        throw new Error(`${context}: ${details.message}`);
-    }
-    return parseJsonResponse(response, context);
-}
-export class BrowserProfilesClient {
-    baseUrl;
-    apiKey;
-    constructor(baseUrl, apiKey) {
-        this.baseUrl = baseUrl;
-        this.apiKey = apiKey;
-    }
-    async list() {
-        const response = await fetchWithTimeout(`${this.baseUrl}/browser-profiles`, {
-            headers: buildHeaders(this.apiKey),
-        });
-        const data = await expectJson(response, 'List browser profiles');
-        return data.profiles;
-    }
-    async create(request) {
-        const response = await fetchWithTimeout(`${this.baseUrl}/browser-profiles`, {
-            method: 'POST',
-            headers: buildHeaders(this.apiKey, true),
-            body: JSON.stringify(request),
-        });
-        return expectJson(response, 'Create browser profile');
-    }
-    async get(id) {
-        const response = await fetchWithTimeout(`${this.baseUrl}/browser-profiles/${encodeURIComponent(id)}`, {
-            headers: buildHeaders(this.apiKey),
-        });
-        return expectJson(response, 'Get browser profile');
-    }
-    async update(id, request) {
-        const response = await fetchWithTimeout(`${this.baseUrl}/browser-profiles/${encodeURIComponent(id)}`, {
-            method: 'PATCH',
-            headers: buildHeaders(this.apiKey, true),
-            body: JSON.stringify(request),
-        });
-        return expectJson(response, 'Update browser profile');
-    }
-    async delete(id) {
-        const response = await fetchWithTimeout(`${this.baseUrl}/browser-profiles/${encodeURIComponent(id)}`, {
-            method: 'DELETE',
-            headers: buildHeaders(this.apiKey),
-        });
-        return expectJson(response, 'Delete browser profile');
-    }
-}

package/dist/browser-profiles/index.d.ts

@@ -1 +0,0 @@
-export { BrowserProfilesClient } from './client.js';

package/dist/browser-profiles/index.js

@@ -1 +0,0 @@
-export { BrowserProfilesClient } from './client.js';

package/dist/captcha/index.d.ts

@@ -1 +0,0 @@
-export { CaptchaNamespace } from './namespace.js';

package/dist/captcha/index.js

@@ -1 +0,0 @@
-export { CaptchaNamespace } from './namespace.js';

package/dist/captcha/namespace.d.ts

@@ -1,34 +0,0 @@
-/**
- * CaptchaNamespace — SDK methods for captcha detection and solving
- *
- * Provides `detect()` and `solve()` methods that send RPC calls
- * to the browser-host via the page target.
- */
-import type { CaptchaDetectArgs, CaptchaDetectResult, CaptchaSolveArgs, CaptchaSolveResult } from '../contracts/captcha.js';
-import type { RpcSender } from '../internal/transport.js';
-export declare class CaptchaNamespace {
-    private sendRpc;
-    private getActivePageId;
-    constructor(sendRpc: RpcSender, getActivePageId: () => string | undefined);
-    /**
-     * Detect captchas on the current page.
-     *
-     * @example
-     * const result = await session.captcha.detect();
-     * if (result.found) {
-     *   console.log('Found captchas:', result.captchas);
-     * }
-     */
-    detect(options?: CaptchaDetectArgs): Promise<CaptchaDetectResult>;
-    /**
-     * Detect and solve a captcha on the current page.
-     * Detects the captcha type, sends to solver backend, and injects the token.
-     *
-     * @example
-     * const result = await session.captcha.solve();
-     * if (result.success) {
-     *   console.log(`Solved ${result.type} in ${result.duration}ms`);
-     * }
-     */
-    solve(options?: CaptchaSolveArgs): Promise<CaptchaSolveResult>;
-}

package/dist/captcha/namespace.js

@@ -1,41 +0,0 @@
-/**
- * CaptchaNamespace — SDK methods for captcha detection and solving
- *
- * Provides `detect()` and `solve()` methods that send RPC calls
- * to the browser-host via the page target.
- */
-export class CaptchaNamespace {
-    sendRpc;
-    getActivePageId;
-    constructor(sendRpc, getActivePageId) {
-        this.sendRpc = sendRpc;
-        this.getActivePageId = getActivePageId;
-    }
-    /**
-     * Detect captchas on the current page.
-     *
-     * @example
-     * const result = await session.captcha.detect();
-     * if (result.found) {
-     *   console.log('Found captchas:', result.captchas);
-     * }
-     */
-    async detect(options) {
-        const pageId = this.getActivePageId();
-        return this.sendRpc('page', 'captcha.detect', [options ?? {}], { pageId });
-    }
-    /**
-     * Detect and solve a captcha on the current page.
-     * Detects the captcha type, sends to solver backend, and injects the token.
-     *
-     * @example
-     * const result = await session.captcha.solve();
-     * if (result.success) {
-     *   console.log(`Solved ${result.type} in ${result.duration}ms`);
-     * }
-     */
-    async solve(options) {
-        const pageId = this.getActivePageId();
-        return this.sendRpc('page', 'captcha.solve', [options ?? {}], { pageId });
-    }
-}

package/dist/client/index.d.ts

@@ -1 +0,0 @@
-export * from './rpc.js';

package/dist/client/index.js

@@ -1 +0,0 @@
-export * from './rpc.js';

package/dist/client/rpc.d.ts

@@ -1,83 +0,0 @@
-import type { RpcTarget } from '../internal/transport.js';
-import type { BrowserDriver } from '../contracts/runtime.js';
-import type { VaultSessionPolicy } from '../contracts/vault.js';
-import type { SessionStoragePolicy } from '../contracts/storage.js';
-/**
- * RPC call to control-plane
- * @param endpoint - Full URL of the endpoint
- * @param body - Request body
- * @param timeout - Optional timeout in milliseconds (default: DEFAULT_TIMEOUT_MS)
- */
-export declare function rpc<T>(endpoint: string, body: Record<string, unknown>, timeout?: number): Promise<T>;
-/**
- * Start an ephemeral browser session through the API gateway (no driver connected).
- * @param baseUrl - Versioned API base URL of the gateway (e.g., 'http://localhost:8787/v1')
- * @param options - Session start options
- */
-export declare function startSession(baseUrl: string, options?: {
-    apiKey?: string;
-    humanize?: boolean;
-    humanizePersonaId?: number;
-    proxy?: {
-        type: 'http' | 'socks5';
-        host: string;
-        port: number;
-        username?: string;
-        password?: string;
-    } | null;
-    storage?: SessionStoragePolicy;
-    solveCaptchas?: boolean;
-    vault?: VaultSessionPolicy;
-}): Promise<{
-    id: string;
-    status: 'active' | 'stopped';
-    storageWorkspace?: string;
-}>;
-/**
- * Connect a driver to an existing started session on the control-plane.
- */
-export declare function connectSessionDriver(baseUrl: string, sessionId: string, driver: BrowserDriver, apiKey?: string): Promise<{
-    id: string;
-    currentDriver: BrowserDriver;
-    defaultContextId?: string;
-    defaultPageId?: string;
-    storageWorkspace?: string;
-}>;
-/**
- * Stop a session on the control-plane
- * @param baseUrl - Versioned API base URL of the control-plane
- * @param sessionId - Session ID to stop
- * @param apiKey - Optional API key
- */
-export declare function stopSession(baseUrl: string, sessionId: string, apiKey?: string): Promise<void>;
-/**
- * Send RPC/EXECUTE command through the canonical automation endpoint.
- * @param baseUrl - Versioned API base URL of the control-plane
- * @param sessionId - Session ID
- * @param command - RPC or EXECUTE command
- * @param timeout - Optional timeout in milliseconds
- */
-type SendCommandInput = {
-    type: 'RPC';
-    correlationId?: string;
-    target: RpcTarget;
-    method: string;
-    args: unknown[];
-    contextId?: string;
-    pageId?: string;
-    handleId?: string;
-} | {
-    type: 'EXECUTE';
-    correlationId?: string;
-    code: string;
-    args?: Record<string, unknown>;
-    pageId?: string;
-    options?: {
-        timeoutMs?: number;
-        logs?: 'off' | 'capture';
-        scriptId?: string;
-        scriptName?: string;
-    };
-};
-export declare function sendCommand<T>(baseUrl: string, sessionId: string, command: SendCommandInput, apiKey?: string, timeout?: number): Promise<T>;
-export {};

package/dist/client/rpc.js

@@ -1,354 +0,0 @@
-// ============================================================================
-// RPC Client - HTTP calls to control-plane
-// ============================================================================
-import { parseJsonResponse, fetchWithTimeout, DEFAULT_TIMEOUT_MS, LONG_TIMEOUT_MS, } from '../utils/http.js';
-import { fromErrorResponse, AuthenticationError, SessionError, TimeoutError, } from '../errors.js';
-import * as telemetry from '../telemetry.js';
-import { SDK_VERSION } from '../version.js';
-import { CONTEXT_REF_TARGETS, HANDLE_TARGETS, PAGE_REF_TARGETS, } from '../internal/rpc-targets.js';
-/**
- * Map an HTTP status code + response text to a typed BctrlError.
- */
-function httpStatusToError(status, text, fallbackMessage) {
-    if (status === 401 || status === 403)
-        return new AuthenticationError(`Authentication failed: ${text}`);
-    if (status === 404)
-        return new SessionError(`Not found: ${text}`, 'NOT_FOUND');
-    if (status === 504)
-        return new TimeoutError(`Gateway timeout: ${text}`);
-    if (status === 503)
-        return new SessionError(`Service unavailable: ${text}`, 'CONNECTION_ERROR');
-    return fromErrorResponse(fallbackMessage ?? `HTTP ${status}: ${text}`);
-}
-/**
- * Extract timeout (ms) from an RPC method options argument if present.
- * Many automation APIs use the last arg as an options object with `timeout`.
- */
-function getRpcOptionsTimeoutMs(args) {
-    if (!Array.isArray(args) || args.length === 0)
-        return undefined;
-    const lastArg = args[args.length - 1];
-    if (!lastArg || typeof lastArg !== 'object' || Array.isArray(lastArg))
-        return undefined;
-    const timeoutRaw = lastArg.timeout;
-    if (typeof timeoutRaw !== 'number' || !Number.isFinite(timeoutRaw) || timeoutRaw <= 0) {
-        return undefined;
-    }
-    return Math.floor(timeoutRaw);
-}
-/**
- * Methods that are expected to wait on browser state and may run longer than 30s.
- */
-function isLongRunningRpcMethod(method) {
-    return (method.startsWith('wait') ||
-        method === 'goto' ||
-        method === 'reload' ||
-        method === 'setContent');
-}
-const AGENT_RPC_TIMEOUT_MS = 5 * 60 * 1000;
-function isLongRunningAgentRpc(target, method) {
-    if (target === 'browserUse') {
-        return method === 'agent.execute' || method === 'codeAgent.execute';
-    }
-    if (target === 'stagehand') {
-        return method === 'agent.execute';
-    }
-    return false;
-}
-function trimTrailingUndefined(args) {
-    if (!Array.isArray(args))
-        return args;
-    let end = args.length;
-    while (end > 0 && args[end - 1] === undefined) {
-        end -= 1;
-    }
-    return end === args.length ? args : args.slice(0, end);
-}
-function parseAutomationEnvelope(text) {
-    if (!text)
-        return null;
-    try {
-        const parsed = JSON.parse(text);
-        return parsed && typeof parsed === 'object' ? parsed : null;
-    }
-    catch {
-        return null;
-    }
-}
-function buildAutomationError(error, fallbackMessage) {
-    const message = error?.message || fallbackMessage;
-    const hint = error?.hint;
-    const diagnostic = error?.diagnostic;
-    const context = {};
-    if (hint)
-        context.hint = hint;
-    if (diagnostic)
-        context.diagnostic = diagnostic;
-    return fromErrorResponse(hint ? `${message} (${hint})` : message, error?.code, Object.keys(context).length > 0 ? context : undefined);
-}
-/**
- * RPC call to control-plane
- * @param endpoint - Full URL of the endpoint
- * @param body - Request body
- * @param timeout - Optional timeout in milliseconds (default: DEFAULT_TIMEOUT_MS)
- */
-export async function rpc(endpoint, body, timeout) {
-    const response = await fetchWithTimeout(endpoint, {
-        method: 'POST',
-        headers: {
-            'Content-Type': 'application/json',
-            'x-sdk-version': SDK_VERSION,
-        },
-        body: JSON.stringify(body),
-    }, timeout ?? DEFAULT_TIMEOUT_MS);
-    // Read request ID from response for error context
-    const requestId = response.headers.get('x-request-id') ?? undefined;
-    if (!response.ok) {
-        const text = await response.text();
-        const err = httpStatusToError(response.status, text);
-        telemetry.captureError(err, {
-            endpoint,
-            method: 'POST',
-            statusCode: response.status,
-            errorCode: err.code,
-            requestId,
-        });
-        throw err;
-    }
-    const data = await parseJsonResponse(response, `RPC ${endpoint}`);
-    if (data.status === 'error') {
-        const err = fromErrorResponse(data.error || 'Unknown error', data.errorCode, data.errorContext);
-        telemetry.captureError(err, {
-            endpoint,
-            method: 'POST',
-            statusCode: response.status,
-            errorCode: data.errorCode,
-            requestId,
-        });
-        throw err;
-    }
-    return data.result;
-}
-/**
- * Start an ephemeral browser session through the API gateway (no driver connected).
- * @param baseUrl - Versioned API base URL of the gateway (e.g., 'http://localhost:8787/v1')
- * @param options - Session start options
- */
-export async function startSession(baseUrl, options = {}) {
-    const headers = {
-        'Content-Type': 'application/json',
-        'x-sdk-version': SDK_VERSION,
-    };
-    if (options.apiKey) {
-        headers['Authorization'] = `Bearer ${options.apiKey}`;
-    }
-    const response = await fetchWithTimeout(`${baseUrl}/sessions`, {
-        method: 'POST',
-        headers,
-        body: JSON.stringify({
-            humanize: options.humanize,
-            humanizePersonaId: options.humanizePersonaId,
-            proxy: options.proxy,
-            storage: options.storage,
-            solveCaptchas: options.solveCaptchas,
-            vault: options.vault,
-        }),
-    });
-    if (!response.ok) {
-        const text = await response.text();
-        const requestId = response.headers.get('x-request-id') ?? undefined;
-        const err = httpStatusToError(response.status, text, `Failed to start session: ${text}`);
-        telemetry.captureError(err, {
-            endpoint: `${baseUrl}/sessions`,
-            method: 'POST',
-            statusCode: response.status,
-            errorCode: err.code,
-            requestId,
-        });
-        throw err;
-    }
-    const data = await parseJsonResponse(response, 'Start session');
-    return {
-        id: data.id,
-        status: data.status,
-        storageWorkspace: data.storageWorkspace,
-    };
-}
-/**
- * Connect a driver to an existing started session on the control-plane.
- */
-export async function connectSessionDriver(baseUrl, sessionId, driver, apiKey) {
-    const headers = {
-        'Content-Type': 'application/json',
-        'x-sdk-version': SDK_VERSION,
-    };
-    if (apiKey) {
-        headers['Authorization'] = `Bearer ${apiKey}`;
-    }
-    const response = await fetchWithTimeout(`${baseUrl}/sessions/${sessionId}/connect`, {
-        method: 'POST',
-        headers,
-        body: JSON.stringify({ driver }),
-    });
-    if (!response.ok) {
-        const text = await response.text();
-        const requestId = response.headers.get('x-request-id') ?? undefined;
-        const err = httpStatusToError(response.status, text, `Failed to connect session driver: ${text}`);
-        telemetry.captureError(err, {
-            endpoint: `${baseUrl}/sessions/${sessionId}/connect`,
-            method: 'POST',
-            statusCode: response.status,
-            errorCode: err.code,
-            requestId,
-        });
-        throw err;
-    }
-    return parseJsonResponse(response, 'Connect session driver');
-}
-/**
- * Stop a session on the control-plane
- * @param baseUrl - Versioned API base URL of the control-plane
- * @param sessionId - Session ID to stop
- * @param apiKey - Optional API key
- */
-export async function stopSession(baseUrl, sessionId, apiKey) {
-    const headers = {
-        'Content-Type': 'application/json',
-        'x-sdk-version': SDK_VERSION,
-    };
-    if (apiKey) {
-        headers['Authorization'] = `Bearer ${apiKey}`;
-    }
-    const response = await fetchWithTimeout(`${baseUrl}/sessions/${sessionId}/stop`, {
-        method: 'POST',
-        headers,
-        body: JSON.stringify({}),
-    });
-    if (!response.ok) {
-        const text = await response.text();
-        const requestId = response.headers.get('x-request-id') ?? undefined;
-        const err = httpStatusToError(response.status, text, `Failed to stop session: ${text}`);
-        telemetry.captureError(err, {
-            endpoint: `${baseUrl}/sessions/${sessionId}/stop`,
-            method: 'POST',
-            statusCode: response.status,
-            errorCode: err.code,
-            requestId,
-        });
-        throw err;
-    }
-}
-async function sendCommandInternal(baseUrl, sessionId, command, apiKey, timeout) {
-    const executeTimeoutMs = command.type === 'EXECUTE' &&
-        typeof command.options?.timeoutMs === 'number' &&
-        Number.isFinite(command.options.timeoutMs) &&
-        command.options.timeoutMs > 0
-        ? Math.floor(command.options.timeoutMs)
-        : undefined;
-    const rpcOptionsTimeoutMs = command.type === 'RPC'
-        ? getRpcOptionsTimeoutMs(command.args)
-        : undefined;
-    const rpcTimeoutHint = command.type === 'RPC'
-        ? rpcOptionsTimeoutMs !== undefined
-            ? Math.max(DEFAULT_TIMEOUT_MS, rpcOptionsTimeoutMs + 5000)
-            : isLongRunningRpcMethod(command.method)
-                ? LONG_TIMEOUT_MS
-                : undefined
-        : undefined;
-    const aiRpcTimeoutHint = command.type === 'RPC' &&
-        'target' in command &&
-        (command.target === 'stagehand' || command.target === 'browserUse') &&
-        rpcOptionsTimeoutMs !== undefined
-        ? Math.max(isLongRunningAgentRpc(command.target, command.method) ? AGENT_RPC_TIMEOUT_MS : LONG_TIMEOUT_MS, rpcOptionsTimeoutMs + 5000)
-        : undefined;
-    // Use longer timeout for potentially slow AI operations (stagehand, browserUse, execute)
-    const defaultTimeout = command.type === 'EXECUTE' ||
-        ('target' in command && (command.target === 'stagehand' || command.target === 'browserUse'))
-        ? command.type === 'EXECUTE' && executeTimeoutMs !== undefined
-            ? Math.max(LONG_TIMEOUT_MS, executeTimeoutMs + 5000)
-            : (aiRpcTimeoutHint ??
-                ('target' in command && isLongRunningAgentRpc(command.target, command.method)
-                    ? AGENT_RPC_TIMEOUT_MS
-                    : LONG_TIMEOUT_MS))
-        : (rpcTimeoutHint ?? DEFAULT_TIMEOUT_MS);
-    let call;
-    let ref;
-    let args;
-    let options;
-    if (command.type === 'RPC') {
-        call = `${command.target}.${command.method}`;
-        args = trimTrailingUndefined(command.args);
-        if (HANDLE_TARGETS.has(command.target)) {
-            ref = command.handleId;
-        }
-        else if (CONTEXT_REF_TARGETS.has(command.target)) {
-            ref = command.contextId;
-        }
-        else if (PAGE_REF_TARGETS.has(command.target)) {
-            ref = command.pageId;
-        }
-        if (rpcOptionsTimeoutMs !== undefined) {
-            options = { timeoutMs: rpcOptionsTimeoutMs };
-        }
-    }
-    else {
-        call = 'execute';
-        args = [command.code];
-        if (command.args !== undefined) {
-            args.push(command.args);
-        }
-        ref = command.pageId;
-        options = command.options;
-    }
-    const endpoint = `${baseUrl}/sessions/${encodeURIComponent(sessionId)}/automation`;
-    const response = await fetchWithTimeout(endpoint, {
-        method: 'POST',
-        headers: {
-            'Content-Type': 'application/json',
-            'x-sdk-version': SDK_VERSION,
-            ...(apiKey ? { Authorization: `Bearer ${apiKey}` } : {}),
-        },
-        body: JSON.stringify({
-            call,
-            ...(ref ? { ref } : {}),
-            ...(args ? { args } : {}),
-            ...(options ? { options } : {}),
-        }),
-    }, timeout ?? defaultTimeout);
-    const requestId = response.headers.get('x-request-id') ?? undefined;
-    if (!response.ok) {
-        const text = await response.text();
-        const parsed = parseAutomationEnvelope(text);
-        const err = parsed && parsed.ok === false
-            ? buildAutomationError(parsed.error, text || `Automation ${call} failed`)
-            : httpStatusToError(response.status, text);
-        const telemetryErrorCode = parsed?.error?.code ||
-            err.code;
-        telemetry.captureError(err, {
-            endpoint,
-            method: 'POST',
-            statusCode: response.status,
-            errorCode: telemetryErrorCode,
-            commandType: command.type,
-            requestId,
-        });
-        throw err;
-    }
-    const data = await parseJsonResponse(response, `Automation ${call}`);
-    if (data.ok !== true) {
-        const err = buildAutomationError(data.error, 'Unknown error');
-        telemetry.captureError(err, {
-            endpoint,
-            method: 'POST',
-            statusCode: response.status,
-            errorCode: data.error?.code,
-            commandType: command.type,
-            requestId,
-        });
-        throw err;
-    }
-    return data.result;
-}
-export async function sendCommand(baseUrl, sessionId, command, apiKey, timeout) {
-    return sendCommandInternal(baseUrl, sessionId, command, apiKey, timeout);
-}