@boxline/sdk 1.1.0

package/dist/session.d.ts

@@ -0,0 +1,252 @@
+import type { Boxline } from "./client.js";
+import type { RequestOptions } from "./core.js";
+import type { PagePromise, Page } from "./pagination.js";
+import type { ActionItem, ActionResult, AgentProvider, CaptchaKind, ComputerAction, ComputerOptions, ComputerResult, DragTarget, ExecExit, ExecOptions, ExecResult, ExtractValue, FileList, FileRef, GotoResult, PageContent, PageElements, ProxyOption, Recording, RunScriptOptions, ScreenshotValue, ScriptResult, SessionData, SessionEvent, SessionEventsParams, SessionUrls, StepOptions, StepResult, TabList, UpdateSessionParams, VisitedPage, WaitUntil, ListParams, MouseButton, MoveTimings, Point } from "./types.js";
+export interface ClickOptions {
+    button?: MouseButton;
+    /** 2 = double click, 3 = triple click. */
+    count?: 1 | 2 | 3;
+    /** Keys held during the click, e.g. ["Shift"]. */
+    modifiers?: string[];
+}
+/**
+ * One session: a machine with a browser and/or a shell and a shared /workspace disk. `data` is the session as the
+ * API last returned it; lifecycle calls (pause, update, extend, …) refresh it.
+ */
+export declare class Session {
+    private readonly client;
+    data: SessionData;
+    constructor(client: Boxline, data: SessionData);
+    get id(): string;
+    get status(): import("./types.js").SessionStatus;
+    /** WebSocket URL for Playwright/Puppeteer `connectOverCDP`. Treat it like a password. */
+    get connectUrl(): string | null;
+    get liveUrl(): string | null;
+    get terminalUrl(): string | null;
+    get workspacePath(): string;
+    private set;
+    refresh(options?: RequestOptions): Promise<this>;
+    release(options?: RequestOptions): Promise<this>;
+    /** Saves browser state and files, frees the machine and stops billing. Connecting again resumes it. */
+    pause(options?: RequestOptions): Promise<this>;
+    resume(options?: RequestOptions): Promise<this>;
+    /**
+     * Makes the current connectUrl, liveUrl and terminalUrl stop working (use it if one leaked) and closes
+     * connections made with them; the session gets fresh URLs.
+     */
+    rotateUrls(options?: RequestOptions): Promise<this>;
+    /** Changes keepAlive, userMetadata, the proxy, the captcha option or the browser settings. */
+    update(patch: UpdateSessionParams, options?: RequestOptions): Promise<this>;
+    /** Sets, changes or (null) removes the session's proxy; new connections use it right away. */
+    setProxy(proxy: ProxyOption | null, options?: RequestOptions): Promise<this>;
+    /** A new IP for the session's proxy (sticky sessions keep one IP until this is called). */
+    rotateProxy(options?: RequestOptions): Promise<this>;
+    /** Adds time (60–3600 s), up to the plan's maximum session length. */
+    extend(seconds: number, options?: RequestOptions): Promise<this>;
+    /** Moves the live session to a fresh machine; reconnect to the same connectUrl afterwards. Returns the timings. */
+    move(options?: RequestOptions): Promise<MoveTimings>;
+    /** Fresh signed URLs (also stored on this object). */
+    live(options?: RequestOptions): Promise<SessionUrls>;
+    /**
+     * Waits until no CAPTCHA is waiting for a person (someone solved it in the live view, or the page moved on).
+     * Throws CaptchaTimeoutError after `timeoutMs` (default 5 minutes).
+     */
+    waitForHuman(opts?: {
+        timeoutMs?: number;
+        intervalMs?: number;
+    }): Promise<this>;
+    /**
+     * Calls `handler` when a CAPTCHA starts waiting for a person ("detected") and when it is gone ("cleared").
+     * Polls the session's events every `intervalMs` (default 2 s), starting after event number `after` (default 0:
+     * challenges seen before you subscribed are reported too). It stops by itself when the session ends; the
+     * returned function stops it sooner.
+     */
+    onCaptcha(handler: (e: {
+        state: "detected" | "cleared";
+        kind: CaptchaKind;
+        url: string;
+        event: SessionEvent;
+    }) => void | Promise<void>, opts?: {
+        intervalMs?: number;
+        after?: number;
+    }): () => void;
+    /** Console, network, navigation, error, lifecycle, action, exec and captcha events (oldest first). */
+    events(params?: SessionEventsParams, options?: RequestOptions): PagePromise<SessionEvent, Page<SessionEvent> & {
+        nextAfter: number;
+    }>;
+    /** Events as they happen (the backlog after `after` first). Stop with `break` or the signal. */
+    streamEvents(params?: {
+        after?: number;
+    }, options?: RequestOptions): AsyncGenerator<SessionEvent>;
+    /** Pages visited in this session. */
+    pages(params?: ListParams, options?: RequestOptions): PagePromise<VisitedPage>;
+    /** Replay frames (JPEG) kept while the session ran. */
+    recording(options?: RequestOptions): Promise<Recording>;
+    /** One replay frame as JPEG bytes. */
+    recordingFrame(index: number, options?: RequestOptions): Promise<Uint8Array>;
+    /** Runs actions next to the browser (one HTTP call for the whole list); a bare string is a plain-English step. */
+    actions(actions: ActionItem[] | ActionItem, opts?: {
+        timeoutMs?: number;
+    }, options?: RequestOptions): Promise<ActionResult[]>;
+    private one;
+    /**
+     * Runs one plain-English step ("click Sign in", "type %email% into the email field"). `secrets: ["NAME"]` lets it use
+     * project secrets as %NAME%, each on its own sites (see StepOptions).
+     */
+    step(instruction: string, opts?: StepOptions, options?: RequestOptions): Promise<StepResult>;
+    /** Structured data from the current page. */
+    extract<T = unknown>(instruction: string, opts?: {
+        schema?: Record<string, unknown>;
+        provider?: AgentProvider;
+        model?: string;
+    }, options?: RequestOptions): Promise<ExtractValue<T>>;
+    goto(url: string, opts?: {
+        waitUntil?: WaitUntil;
+    }, options?: RequestOptions): Promise<GotoResult>;
+    /** Clicks an element (CSS selector) or a point ({x, y}); `count: 2` double-clicks, `button: "right"` right-clicks. */
+    click(target: string | Point, opts?: ClickOptions, options?: RequestOptions): Promise<null>;
+    /** Moves the pointer over an element (CSS selector) or to a point. */
+    hover(target: string | Point, options?: RequestOptions): Promise<null>;
+    /** Where the pointer is on this tab (where the API last moved it; 0, 0 before any move). */
+    cursor(options?: RequestOptions): Promise<Point>;
+    fill(selector: string, value: string, options?: RequestOptions): Promise<null>;
+    /** Types text with the keyboard (into `selector` if given). */
+    type(text: string, opts?: {
+        selector?: string;
+        delayMs?: number;
+    }, options?: RequestOptions): Promise<null>;
+    press(key: string, options?: RequestOptions): Promise<null>;
+    /** Turns the wheel by `deltaY` pixels (and `deltaX`), over x/y when given. */
+    scroll(deltaY: number, at?: {
+        x?: number;
+        y?: number;
+        deltaX?: number;
+        modifiers?: string[];
+    }, options?: RequestOptions): Promise<null>;
+    /** Waits for a selector, or a number of milliseconds. */
+    wait(target: string | number, options?: RequestOptions): Promise<null>;
+    /** Picks an option of a select element by its label or value. */
+    select(selector: string, option: string, options?: RequestOptions): Promise<null>;
+    /** The page as a model sees it: title, URL, visible text and numbered interactive elements. */
+    elements(options?: RequestOptions): Promise<PageElements>;
+    evaluate<T = unknown>(expression: string, options?: RequestOptions): Promise<T>;
+    content(format?: "markdown" | "html" | "text", options?: RequestOptions): Promise<PageContent>;
+    /**
+     * A screenshot of the current tab: `{data (base64), mimeType}`. `maxWidth` scales it down and `cursor` draws the
+     * pointer (then also `width`, `height`, `scale`).
+     */
+    screenshot(opts?: {
+        fullPage?: boolean;
+        format?: "png" | "jpeg";
+        quality?: number;
+        maxWidth?: number;
+        cursor?: boolean;
+    }, options?: RequestOptions): Promise<ScreenshotValue>;
+    /** Sets a file input to a file in the workspace (e.g. one written with files.write). */
+    upload(selector: string, path: string, options?: RequestOptions): Promise<null>;
+    tabs(options?: RequestOptions): Promise<TabList>;
+    newTab(url?: string, options?: RequestOptions): Promise<{
+        index: number;
+    }>;
+    switchTab(index: number, options?: RequestOptions): Promise<null>;
+    closeTab(index?: number, options?: RequestOptions): Promise<null>;
+    back(options?: RequestOptions): Promise<{
+        url: string;
+    }>;
+    forward(options?: RequestOptions): Promise<{
+        url: string;
+    }>;
+    reload(options?: RequestOptions): Promise<{
+        url: string;
+    }>;
+    /**
+     * The mouse, in viewport CSS pixels (the session's viewport, 1280×720 by default). Straight lines only: `steps`
+     * spreads a move over that many evenly spaced points. It acts on the page, never on the machine's desktop.
+     */
+    readonly mouse: {
+        move: (x: number, y: number, opts?: {
+            steps?: number;
+        }, options?: RequestOptions) => Promise<Point>;
+        /** Moves by dx/dy from where the pointer is. */
+        moveBy: (dx: number, dy: number, opts?: {
+            steps?: number;
+        }, options?: RequestOptions) => Promise<Point>;
+        click: (x: number, y: number, opts?: ClickOptions, options?: RequestOptions) => Promise<null>;
+        down: (opts?: {
+            button?: MouseButton;
+        }, options?: RequestOptions) => Promise<null>;
+        up: (opts?: {
+            button?: MouseButton;
+        }, options?: RequestOptions) => Promise<null>;
+        /**
+         * Presses at `from`, moves to `to` (in `steps` points, default 10) and releases; each end is a point or a selector.
+         * Or pass a path of 2–200 points to follow.
+         */
+        drag: (fromOrPath: DragTarget | Point[], to?: DragTarget | DragOptions, opts?: DragOptions, options?: RequestOptions) => Promise<{
+            from: Point;
+            to: Point;
+        }>;
+    };
+    /** The keyboard. Key names are Playwright's (Enter, Tab, ArrowLeft, Control, Shift, Meta…); ctrl, cmd, Return work too. */
+    readonly keyboard: {
+        /** A combination held together, "Control+A" or ["Control", "A"]; several separated by spaces run one after the other. */
+        key: (keys: string | string[], opts?: {
+            holdMs?: number;
+        }, options?: RequestOptions) => Promise<null>;
+        type: (text: string, opts?: {
+            delayMs?: number;
+        }, options?: RequestOptions) => Promise<null>;
+        press: (key: string, options?: RequestOptions) => Promise<null>;
+    };
+    /**
+     * Runs ONE computer-use action as the model's tool gave it (Anthropic `computer` input, or one OpenAI
+     * `computer_call` action) and returns the screen after it (see Sessions.computer).
+     */
+    computer(action: ComputerAction, opts?: ComputerOptions, options?: RequestOptions): Promise<ComputerResult>;
+    /** Writes the browser's cookies as a Netscape cookie file inside the workspace, for curl -b / wget. */
+    exportCookies(path?: string, options?: RequestOptions): Promise<{
+        path: string;
+        count: number;
+    }>;
+    /** @deprecated Use session.exportCookies(). */
+    readonly browser: {
+        exportCookies: (path?: string, options?: RequestOptions) => Promise<{
+            path: string;
+            count: number;
+        }>;
+    };
+    /** Runs a shell command (persistent bash by default: cd/export survive between calls). */
+    exec(command: string, opts?: ExecOptions, options?: RequestOptions): Promise<ExecResult>;
+    /** Runs a command and streams its output. Aborting `signal` stops the command. */
+    execStream(command: string, onData: (stream: "stdout" | "stderr", data: string) => void, opts?: ExecOptions & {
+        signal?: AbortSignal;
+    }, options?: RequestOptions): Promise<ExecExit>;
+    /**
+     * Runs Playwright code inside the session (needs a shell). `page`, `context`, `browser`, `env`, and the AI helpers
+     * `step()`, `extract()` and `useModel(model)` / `useModel(provider, model)` are in scope; top-level await works. A
+     * step or extract uses the call's own `{provider, model}`, else the last `useModel()`, else `ai`, else the default.
+     */
+    runScript(code: string, opts?: RunScriptOptions, options?: RequestOptions): Promise<ScriptResult>;
+    /** Restarts the persistent shell (or the named one). */
+    restartShell(name?: string, options?: RequestOptions): Promise<void>;
+    /** @deprecated Use session.restartShell(). */
+    readonly shell: {
+        restart: (name?: string, options?: RequestOptions) => Promise<void>;
+    };
+    readonly files: {
+        list: (path?: string, options?: RequestOptions) => Promise<FileList>;
+        read: (path: string, options?: RequestOptions) => Promise<Uint8Array>;
+        readText: (path: string, options?: RequestOptions) => Promise<string>;
+        write: (path: string, data: string | Uint8Array | Blob, options?: RequestOptions) => Promise<FileRef>;
+        delete: (path: string, options?: RequestOptions) => Promise<void>;
+        /** Waits for a file matching a glob (e.g. `downloads/*.csv`) that has finished writing. */
+        waitFor: (pattern: string, timeoutMs?: number, options?: RequestOptions) => Promise<FileRef>;
+    };
+    toJSON(): SessionData;
+}
+export interface DragOptions {
+    /** Points per move (from/to: default 10; a path: per segment, default 1). */
+    steps?: number;
+    button?: MouseButton;
+    modifiers?: string[];
+}

package/dist/session.js

@@ -0,0 +1,345 @@
+import { CaptchaTimeoutError, makeError } from "./errors.js";
+/** HTTP status an action result's code stands for, when one action of a list fails (the call itself answered 200). */
+const ACTION_STATUS = { captcha_timeout: 409, model_refused: 422 };
+/**
+ * One session: a machine with a browser and/or a shell and a shared /workspace disk. `data` is the session as the
+ * API last returned it; lifecycle calls (pause, update, extend, …) refresh it.
+ */
+export class Session {
+    data;
+    constructor(client, data) {
+        // Not enumerable: logging a session shows its data, never the client (and its API key).
+        Object.defineProperty(this, "client", { value: client, enumerable: false });
+        this.data = data;
+    }
+    get id() {
+        return this.data.id;
+    }
+    get status() {
+        return this.data.status;
+    }
+    /** WebSocket URL for Playwright/Puppeteer `connectOverCDP`. Treat it like a password. */
+    get connectUrl() {
+        return this.data.connectUrl;
+    }
+    get liveUrl() {
+        return this.data.liveUrl;
+    }
+    get terminalUrl() {
+        return this.data.terminalUrl;
+    }
+    get workspacePath() {
+        return this.data.workspacePath;
+    }
+    set(s) {
+        this.data = s.data;
+        return this;
+    }
+    // ----- lifecycle
+    async refresh(options) {
+        return this.set(await this.client.sessions.get(this.id, options));
+    }
+    async release(options) {
+        return this.set(await this.client.sessions.release(this.id, options));
+    }
+    /** Saves browser state and files, frees the machine and stops billing. Connecting again resumes it. */
+    async pause(options) {
+        return this.set(await this.client.sessions.pause(this.id, options));
+    }
+    async resume(options) {
+        return this.set(await this.client.sessions.resume(this.id, options));
+    }
+    /**
+     * Makes the current connectUrl, liveUrl and terminalUrl stop working (use it if one leaked) and closes
+     * connections made with them; the session gets fresh URLs.
+     */
+    async rotateUrls(options) {
+        return this.set(await this.client.sessions.rotateUrls(this.id, options));
+    }
+    /** Changes keepAlive, userMetadata, the proxy, the captcha option or the browser settings. */
+    async update(patch, options) {
+        return this.set(await this.client.sessions.update(this.id, patch, options));
+    }
+    /** Sets, changes or (null) removes the session's proxy; new connections use it right away. */
+    async setProxy(proxy, options) {
+        return this.update({ proxy }, options);
+    }
+    /** A new IP for the session's proxy (sticky sessions keep one IP until this is called). */
+    async rotateProxy(options) {
+        return this.set(await this.client.sessions.rotateProxy(this.id, options));
+    }
+    /** Adds time (60–3600 s), up to the plan's maximum session length. */
+    async extend(seconds, options) {
+        return this.set(await this.client.sessions.extend(this.id, seconds, options));
+    }
+    /** Moves the live session to a fresh machine; reconnect to the same connectUrl afterwards. Returns the timings. */
+    async move(options) {
+        const r = await this.client.sessions.move(this.id, options);
+        this.data = r.session.data;
+        return r.timings;
+    }
+    /** Fresh signed URLs (also stored on this object). */
+    async live(options) {
+        const urls = await this.client.sessions.live(this.id, options);
+        this.data = { ...this.data, ...urls };
+        return urls;
+    }
+    /**
+     * Waits until no CAPTCHA is waiting for a person (someone solved it in the live view, or the page moved on).
+     * Throws CaptchaTimeoutError after `timeoutMs` (default 5 minutes).
+     */
+    async waitForHuman(opts = {}) {
+        const deadline = Date.now() + (opts.timeoutMs ?? 300_000);
+        for (;;) {
+            await this.refresh();
+            const a = this.data.attention;
+            if (!a || this.data.status !== "RUNNING")
+                return this;
+            if (Date.now() > deadline)
+                throw new CaptchaTimeoutError(408, "captcha_timeout", `nobody solved the CAPTCHA on ${a.url} in time`);
+            await new Promise((r) => setTimeout(r, opts.intervalMs ?? 1000));
+        }
+    }
+    /**
+     * Calls `handler` when a CAPTCHA starts waiting for a person ("detected") and when it is gone ("cleared").
+     * Polls the session's events every `intervalMs` (default 2 s), starting after event number `after` (default 0:
+     * challenges seen before you subscribed are reported too). It stops by itself when the session ends; the
+     * returned function stops it sooner.
+     */
+    onCaptcha(handler, opts = {}) {
+        let stopped = false;
+        void (async () => {
+            let after = opts.after ?? 0;
+            for (let round = 1; !stopped; round++) {
+                try {
+                    const page = await this.events({ types: ["captcha"], after });
+                    for (const event of page.data) {
+                        if (stopped)
+                            return;
+                        const d = (event.data ?? {});
+                        if ((d.state === "detected" || d.state === "cleared") && d.kind)
+                            await handler({ state: d.state, kind: d.kind, url: event.url ?? "", event });
+                    }
+                    after = page.nextAfter;
+                    if (round % 5 === 0)
+                        await this.refresh(); // stop by itself once the session has ended
+                    if (this.data.status === "COMPLETED" || this.data.status === "ERROR")
+                        return;
+                }
+                catch {
+                    /* keep polling; the session may be moving */
+                }
+                await new Promise((r) => setTimeout(r, opts.intervalMs ?? 2000));
+            }
+        })();
+        return () => {
+            stopped = true;
+        };
+    }
+    // ----- logs and recording
+    /** Console, network, navigation, error, lifecycle, action, exec and captcha events (oldest first). */
+    events(params = {}, options) {
+        return this.client.sessions.events(this.id, params, options);
+    }
+    /** Events as they happen (the backlog after `after` first). Stop with `break` or the signal. */
+    streamEvents(params = {}, options) {
+        return this.client.sessions.streamEvents(this.id, params, options);
+    }
+    /** Pages visited in this session. */
+    pages(params = {}, options) {
+        return this.client.sessions.pages(this.id, params, options);
+    }
+    /** Replay frames (JPEG) kept while the session ran. */
+    recording(options) {
+        return this.client.sessions.recording(this.id, options);
+    }
+    /** One replay frame as JPEG bytes. */
+    recordingFrame(index, options) {
+        return this.client.sessions.recordingFrame(this.id, index, options);
+    }
+    // ----- browser
+    /** Runs actions next to the browser (one HTTP call for the whole list); a bare string is a plain-English step. */
+    actions(actions, opts = {}, options) {
+        return this.client.sessions.actions(this.id, actions, opts, options);
+    }
+    async one(action, options) {
+        const [r] = await this.actions(action, {}, options);
+        if (!r?.ok) {
+            const code = r?.code ?? "action_failed";
+            throw makeError(ACTION_STATUS[code] ?? 400, code, r?.error ?? "action failed");
+        }
+        return r.value;
+    }
+    /**
+     * Runs one plain-English step ("click Sign in", "type %email% into the email field"). `secrets: ["NAME"]` lets it use
+     * project secrets as %NAME%, each on its own sites (see StepOptions).
+     */
+    step(instruction, opts = {}, options) {
+        return this.one({ action: "step", instruction, ...opts }, options);
+    }
+    /** Structured data from the current page. */
+    extract(instruction, opts = {}, options) {
+        return this.one({ action: "extract", instruction, ...opts }, options);
+    }
+    goto(url, opts = {}, options) {
+        return this.one({ action: "goto", url, ...opts }, options);
+    }
+    /** Clicks an element (CSS selector) or a point ({x, y}); `count: 2` double-clicks, `button: "right"` right-clicks. */
+    click(target, opts = {}, options) {
+        return this.one(typeof target === "string" ? { action: "click", selector: target, ...opts } : { action: "click", x: target.x, y: target.y, ...opts }, options);
+    }
+    /** Moves the pointer over an element (CSS selector) or to a point. */
+    hover(target, options) {
+        return this.one(typeof target === "string" ? { action: "hover", selector: target } : { action: "hover", x: target.x, y: target.y }, options);
+    }
+    /** Where the pointer is on this tab (where the API last moved it; 0, 0 before any move). */
+    cursor(options) {
+        return this.one({ action: "cursor" }, options);
+    }
+    fill(selector, value, options) {
+        return this.one({ action: "fill", selector, value }, options);
+    }
+    /** Types text with the keyboard (into `selector` if given). */
+    type(text, opts = {}, options) {
+        return this.one({ action: "type", text, ...opts }, options);
+    }
+    press(key, options) {
+        return this.one({ action: "press", key }, options);
+    }
+    /** Turns the wheel by `deltaY` pixels (and `deltaX`), over x/y when given. */
+    scroll(deltaY, at = {}, options) {
+        return this.one({ action: "scroll", deltaY, ...at }, options);
+    }
+    /** Waits for a selector, or a number of milliseconds. */
+    wait(target, options) {
+        return this.one(typeof target === "number" ? { action: "wait", ms: target } : { action: "wait", selector: target }, options);
+    }
+    /** Picks an option of a select element by its label or value. */
+    select(selector, option, options) {
+        return this.one({ action: "select", selector, option }, options);
+    }
+    /** The page as a model sees it: title, URL, visible text and numbered interactive elements. */
+    elements(options) {
+        return this.one({ action: "elements" }, options);
+    }
+    evaluate(expression, options) {
+        return this.one({ action: "evaluate", expression }, options);
+    }
+    content(format = "markdown", options) {
+        return this.one({ action: "content", format }, options);
+    }
+    /**
+     * A screenshot of the current tab: `{data (base64), mimeType}`. `maxWidth` scales it down and `cursor` draws the
+     * pointer (then also `width`, `height`, `scale`).
+     */
+    screenshot(opts = {}, options) {
+        return this.one({ action: "screenshot", ...opts }, options);
+    }
+    /** Sets a file input to a file in the workspace (e.g. one written with files.write). */
+    upload(selector, path, options) {
+        return this.one({ action: "upload", selector, path }, options);
+    }
+    tabs(options) {
+        return this.one({ action: "tabs" }, options);
+    }
+    newTab(url, options) {
+        return this.one({ action: "newTab", url }, options);
+    }
+    switchTab(index, options) {
+        return this.one({ action: "switchTab", index }, options);
+    }
+    closeTab(index, options) {
+        return this.one({ action: "closeTab", index }, options);
+    }
+    back(options) {
+        return this.one({ action: "back" }, options);
+    }
+    forward(options) {
+        return this.one({ action: "forward" }, options);
+    }
+    reload(options) {
+        return this.one({ action: "reload" }, options);
+    }
+    /**
+     * The mouse, in viewport CSS pixels (the session's viewport, 1280×720 by default). Straight lines only: `steps`
+     * spreads a move over that many evenly spaced points. It acts on the page, never on the machine's desktop.
+     */
+    mouse = {
+        move: (x, y, opts = {}, options) => this.one({ action: "move", x, y, ...opts }, options),
+        /** Moves by dx/dy from where the pointer is. */
+        moveBy: (dx, dy, opts = {}, options) => this.one({ action: "move", dx, dy, ...opts }, options),
+        click: (x, y, opts = {}, options) => this.one({ action: "click", x, y, ...opts }, options),
+        down: (opts = {}, options) => this.one({ action: "mouse_down", ...opts }, options),
+        up: (opts = {}, options) => this.one({ action: "mouse_up", ...opts }, options),
+        /**
+         * Presses at `from`, moves to `to` (in `steps` points, default 10) and releases; each end is a point or a selector.
+         * Or pass a path of 2–200 points to follow.
+         */
+        drag: (fromOrPath, to, opts = {}, options) => {
+            if (Array.isArray(fromOrPath))
+                return this.one({ action: "drag", path: fromOrPath, ...(to ?? {}) }, options);
+            return this.one({ action: "drag", from: fromOrPath, to: to, ...opts }, options);
+        },
+    };
+    /** The keyboard. Key names are Playwright's (Enter, Tab, ArrowLeft, Control, Shift, Meta…); ctrl, cmd, Return work too. */
+    keyboard = {
+        /** A combination held together, "Control+A" or ["Control", "A"]; several separated by spaces run one after the other. */
+        key: (keys, opts = {}, options) => this.one({ action: "key", keys, ...opts }, options),
+        type: (text, opts = {}, options) => this.one({ action: "type", text, ...opts }, options),
+        press: (key, options) => this.one({ action: "press", key }, options),
+    };
+    /**
+     * Runs ONE computer-use action as the model's tool gave it (Anthropic `computer` input, or one OpenAI
+     * `computer_call` action) and returns the screen after it (see Sessions.computer).
+     */
+    computer(action, opts = {}, options) {
+        return this.client.sessions.computer(this.id, action, opts, options);
+    }
+    /** Writes the browser's cookies as a Netscape cookie file inside the workspace, for curl -b / wget. */
+    exportCookies(path, options) {
+        return this.client.sessions.exportCookies(this.id, path, options);
+    }
+    /** @deprecated Use session.exportCookies(). */
+    browser = {
+        exportCookies: (path, options) => this.exportCookies(path, options),
+    };
+    // ----- shell
+    /** Runs a shell command (persistent bash by default: cd/export survive between calls). */
+    exec(command, opts = {}, options) {
+        return this.client.sessions.exec(this.id, command, opts, options);
+    }
+    /** Runs a command and streams its output. Aborting `signal` stops the command. */
+    execStream(command, onData, opts = {}, options) {
+        return this.client.sessions.execStream(this.id, command, onData, opts, options);
+    }
+    /**
+     * Runs Playwright code inside the session (needs a shell). `page`, `context`, `browser`, `env`, and the AI helpers
+     * `step()`, `extract()` and `useModel(model)` / `useModel(provider, model)` are in scope; top-level await works. A
+     * step or extract uses the call's own `{provider, model}`, else the last `useModel()`, else `ai`, else the default.
+     */
+    runScript(code, opts = {}, options) {
+        return this.client.sessions.runScript(this.id, code, opts, options);
+    }
+    /** Restarts the persistent shell (or the named one). */
+    restartShell(name, options) {
+        return this.client.sessions.restartShell(this.id, name, options);
+    }
+    /** @deprecated Use session.restartShell(). */
+    shell = {
+        restart: (name, options) => this.restartShell(name, options),
+    };
+    // ----- files in /workspace
+    files = {
+        list: (path = ".", options) => this.client.sessions.files.list(this.id, path, options),
+        read: (path, options) => this.client.sessions.files.read(this.id, path, options),
+        readText: (path, options) => this.client.sessions.files.readText(this.id, path, options),
+        write: (path, data, options) => this.client.sessions.files.write(this.id, path, data, options),
+        delete: (path, options) => this.client.sessions.files.delete(this.id, path, options),
+        /** Waits for a file matching a glob (e.g. `downloads/*.csv`) that has finished writing. */
+        waitFor: (pattern, timeoutMs = 30_000, options) => this.client.sessions.files.waitFor(this.id, pattern, timeoutMs, options),
+    };
+    toJSON() {
+        return this.data;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}

package/dist/streaming.d.ts

@@ -0,0 +1,7 @@
+/** Readers for the API's streamed replies: NDJSON (exec, scripts) and server-sent events (event streams). */
+/** Lines of a response body; leaving early (break, return) closes the connection. */
+export declare function lines(body: ReadableStream<Uint8Array>): AsyncGenerator<string>;
+/** One JSON value per non-empty line (lines that are not JSON are skipped). */
+export declare function ndjson<T = Record<string, unknown>>(body: ReadableStream<Uint8Array>): AsyncGenerator<T>;
+/** The `data:` of each server-sent event, parsed as JSON (comments such as keep-alive pings are skipped). */
+export declare function sse<T = Record<string, unknown>>(body: ReadableStream<Uint8Array>): AsyncGenerator<T>;