opensteer 0.9.3 → 0.9.5

package/README.md

@@ -1,211 +1,204 @@
-# Opensteer
+<!-- This file is generated from the repository README. Run `node scripts/sync-package-readme.mjs`. -->
 
-`opensteer` is a browser-backed toolkit for agents exploring websites.
+<p align="center">
+  <strong>Opensteer</strong><br/>
+  <em>AI Browser Automation Framework</em>
+</p>
 
-It focuses on the parts normal code cannot do reliably on its own:
+<p align="center">
+  <a href="https://www.npmjs.com/package/opensteer"><img src="https://img.shields.io/npm/v/opensteer.svg" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/opensteer"><img src="https://img.shields.io/npm/dm/opensteer.svg" alt="npm downloads" /></a>
+  <a href="https://github.com/steerlabs/opensteer/blob/main/LICENSE"><img src="https://img.shields.io/github/license/steerlabs/opensteer.svg" alt="license" /></a>
+  <a href="https://github.com/steerlabs/opensteer/stargazers"><img src="https://img.shields.io/github/stars/steerlabs/opensteer.svg" alt="stars" /></a>
+</p>
 
-- capture real browser traffic from real browser actions
-- inspect captured requests without dumping huge raw payloads
-- replay requests with browser-grade transports
-- read browser cookies, storage, and page state
-- turn discoveries into plain TypeScript with `session.fetch()`
+<p align="center">
+  <a href="https://opensteer.com">Website</a> &middot;
+  <a href="https://docs.opensteer.com">Docs</a> &middot;
+  <a href="https://github.com/steerlabs/opensteer">GitHub</a> &middot;
+  <a href="https://discord.gg/opensteer">Discord</a>
+</p>
 
-The goal is discovery first, code second. The artifact should usually be working code, not a custom registry abstraction.
+---
+
+Open-source browser automation framework for AI agents. CLI and TypeScript SDK that give coding agents a real Chromium browser with persistent sessions, network capture, and stealth -- so they can browse, inspect, and generate scrapers directly in your codebase.
 
 ## Install
 
 ```bash
-pnpm add opensteer
-pnpm exec playwright install chromium
+npm i -g opensteer
+```
 
-# npm
-npm install opensteer
+Then install Chromium for Playwright:
+
+```bash
 npx playwright install chromium
 ```
 
-The package uses the Playwright-backed local engine by default.
+## Agent Quickstart
 
-## CLI Quickstart
+> **Using Claude Code, Codex, or Cursor?** Point your agent at Opensteer with a single command -- no manual setup needed.
 
 ```bash
-opensteer open https://example.com --workspace demo
-opensteer goto https://example.com/search --workspace demo --capture-network search
-opensteer network query --workspace demo --capture search
-opensteer network detail rec_123 --workspace demo
-opensteer replay rec_123 --workspace demo
-opensteer cookies example.com --workspace demo
-opensteer storage example.com --workspace demo
-opensteer state example.com --workspace demo
-opensteer close --workspace demo
+opensteer skills install
 ```
 
-For DOM exploration:
+This installs first-party skills that teach your AI agent how to use the Opensteer CLI and SDK. The agent can then open browsers, capture network traffic, extract structured data, and generate scrapers autonomously.
+
+Target specific agents:
 
 ```bash
+opensteer skills install --agent codex --agent cursor --agent claude-code
+```
+
+## Quickstart
+
+### CLI
+
+```bash
+# Open a page in a persistent workspace
+opensteer open https://example.com --workspace demo
+
+# Take a snapshot and list interactive elements
 opensteer snapshot action --workspace demo
-opensteer input 5 laptop --workspace demo --persist "search input" --capture-network search
-opensteer click 7 --workspace demo --persist "search button" --capture-network search
-opensteer snapshot extraction --workspace demo
-opensteer extract '{"title":{"element":3}}' --workspace demo --persist "page summary"
+
+# Click an element by its annotated index
+opensteer click 3 --workspace demo --persist "cta"
+
+# Extract structured data from the page
+opensteer extract '{"title":{"element":3}}' --workspace demo
+
+# Close the workspace
+opensteer close --workspace demo
 ```
 
-## SDK Quickstart
+### SDK
 
 ```ts
 import { Opensteer } from "opensteer";
 
-const opensteer = new Opensteer({
-  workspace: "demo",
-  rootDir: process.cwd(),
-});
+const opensteer = new Opensteer({ workspace: "demo", rootDir: process.cwd() });
 
 await opensteer.open("https://example.com");
-await opensteer.goto("https://example.com/search", {
-  captureNetwork: "search",
-});
+await opensteer.click({ persist: "cta" });
+const data = await opensteer.extract({ persist: "page summary" });
+await opensteer.close();
+```
 
-const records = await opensteer.network.query({
-  capture: "search",
-  json: true,
-});
+## Features
 
-const detail = await opensteer.network.detail(records.records[0]!.recordId, {
-  probe: true,
-});
+<table>
+<tr>
+<td width="50%">
 
-console.log(detail.summary.url);
-console.log(detail.transportProbe?.recommended);
-```
+### Persistent Sessions
 
-## `session.fetch()`
+Logins, cookies, and browser state survive across restarts. Each workspace is a full Chrome user-data directory.
 
-After discovery, write ordinary TypeScript using `fetch()` on the session.
+### Profile Cloning
 
-```ts
-import { Opensteer } from "opensteer";
+Clone a real Chrome profile to start a workspace already logged in. Source browser doesn't need to close.
 
-const opensteer = new Opensteer({
-  workspace: "target",
-  rootDir: process.cwd(),
-});
-
-async function ensureTargetSession() {
-  const cookies = await opensteer.cookies(".target.com");
-  if (cookies.has("visitorId")) {
-    return;
-  }
-  await opensteer.goto("https://target.com");
-}
-
-export async function searchTarget(keyword: string, count = 24) {
-  await ensureTargetSession();
-
-  const response = await opensteer.fetch(
-    "https://redsky.target.com/redsky_aggregations/v1/web/plp_search_v2",
-    {
-      query: {
-        keyword,
-        count,
-        offset: 0,
-        channel: "WEB",
-        platform: "desktop",
-      },
-    },
-  );
-
-  return response.json();
-}
-```
+### Network Capture
 
-Transport is selected automatically by default. Force it only when discovery showed a specific requirement:
+Record traffic during any action, inspect requests, and replay APIs with browser-backed `fetch()`.
 
-```ts
-const response = await opensteer.fetch("https://api.example.com/search", {
-  query: { keyword: "laptop" },
-  transport: "matched-tls",
-});
-```
+### Script Analysis
 
-## Browser State
+Capture, beautify, deobfuscate, and sandbox page JavaScript.
 
-Opensteer exposes the browser state agents need for request tracing:
+</td>
+<td width="50%">
 
-```ts
-const cookies = await opensteer.cookies("example.com");
-const localStorage = await opensteer.storage("example.com", "local");
-const sessionStorage = await opensteer.storage("example.com", "session");
-const state = await opensteer.state("example.com");
-```
+### Computer Use
 
-`cookies()` returns a lightweight cookie jar:
+Coordinate-based mouse and keyboard when DOM targeting isn't enough.
 
-```ts
-cookies.has("session");
-cookies.get("session");
-cookies.getAll();
-cookies.serialize();
-```
+### Stealth
 
-## DOM Automation
+Anti-detection defaults: UA spoofing, fingerprint management, automation signal removal.
 
-```ts
-await opensteer.click({ persist: "search button", captureNetwork: "search" });
-await opensteer.input({
-  persist: "search input",
-  text: "laptop",
-  pressEnter: true,
-  captureNetwork: "search",
-});
-
-const data = await opensteer.extract({
-  persist: "page summary",
-  schema: {
-    title: { selector: "title" },
-    url: { source: "current_url" },
-  },
-});
+### Local View
+
+Stream live screenshots from headless sessions to a browser-based viewer.
+
+### Local or Cloud
+
+Run browsers locally or on [Opensteer Cloud](https://opensteer.com). Same CLI, same SDK.
+
+</td>
+</tr>
+</table>
+
+## How It Works
+
+Opensteer follows a **discover-then-codify** workflow:
+
+1. **Capture** -- Open a real page, trigger actions, and record network traffic.
+2. **Inspect** -- Query captured traffic, check cookies/storage/state for auth context.
+3. **Probe** -- Test transport viability for captured requests before writing code.
+4. **Codify** -- Write plain TypeScript with `session.fetch()`. The code is the durable artifact.
+
+See the full [Workflow Guide](https://github.com/steerlabs/opensteer/blob/main/docs/workflows.md) for details.
+
+## Documentation
+
+| Resource                                           | Description                            |
+| -------------------------------------------------- | -------------------------------------- |
+| [Package Guide](https://github.com/steerlabs/opensteer/blob/main/packages/opensteer/README.md)    | Full CLI and SDK reference             |
+| [Workflow Guide](https://github.com/steerlabs/opensteer/blob/main/docs/workflows.md)              | Discover-then-codify methodology       |
+| [Instrumentation Guide](https://github.com/steerlabs/opensteer/blob/main/docs/instrumentation.md) | Tracing and observability              |
+| [Skills Guide](https://github.com/steerlabs/opensteer/blob/main/skills/README.md)                 | Agent skill installation and authoring |
+
+## FAQ
+
+<details>
+<summary><strong>Which AI agents are supported?</strong></summary>
+
+Opensteer ships first-party skills for [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview), [Codex](https://openai.com/index/introducing-codex/), [Cursor](https://www.cursor.com/), and any agent compatible with the [skills.sh](https://skills.sh) standard.
+
+</details>
+
+<details>
+<summary><strong>Do I need to install a browser separately?</strong></summary>
+
+Yes. After installing Opensteer, run `npx playwright install chromium` to download a compatible Chromium build. This is a one-time step.
+
+</details>
+
+<details>
+<summary><strong>Can I use my existing Chrome login sessions?</strong></summary>
+
+Yes. Use profile cloning to copy your real Chrome profile into an Opensteer workspace. Your logins, cookies, and extensions carry over without closing your main browser.
+
+</details>
+
+<details>
+<summary><strong>Does it work in headless mode?</strong></summary>
+
+Yes. Opensteer runs headless by default. Use the Local View feature to stream live screenshots from headless sessions to a browser-based viewer for debugging.
+
+</details>
+
+<details>
+<summary><strong>What Node.js version is required?</strong></summary>
+
+Node.js 22 or later.
+
+</details>
+
+## Development
+
+```bash
+pnpm install
+pnpm run build
+pnpm run typecheck
+pnpm run test
 ```
 
-Use `snapshot("action")` or `snapshot("extraction")` during exploration. The snapshot result is the filtered HTML string, not a huge raw DOM object.
-
-## Public SDK Surface
-
-- `new Opensteer({ workspace?, rootDir?, browser?, provider? })`
-- `open(url | input?)`
-- `info()`
-- `listPages()`
-- `newPage()`
-- `activatePage()`
-- `closePage()`
-- `goto(url, { captureNetwork? })`
-- `evaluate(script | input)`
-- `addInitScript(input)`
-- `snapshot("action" | "extraction")`
-- `click({ element? | selector? | persist?, captureNetwork? })`
-- `hover({ element? | selector? | persist?, captureNetwork? })`
-- `input({ text, element? | selector? | persist?, captureNetwork? })`
-- `scroll({ direction, amount, element? | selector? | persist?, captureNetwork? })`
-- `extract({ schema } | { persist, schema? })`
-- `network.query(input?)`
-- `network.detail(recordId, { probe?: boolean })`
-- `waitForPage(input?)`
-- `cookies(domain?)`
-- `storage(domain?, "local" | "session")`
-- `state(domain?)`
-- `fetch(url, options?)`
-- `computerExecute(input)`
-- `route(input)`
-- `interceptScript(input)`
-- `browser.status()`
-- `browser.clone(input)`
-- `browser.reset()`
-- `browser.delete()`
-- `close()`
-- `disconnect()`
-
-## Design Notes
-
-- `network query` is intentionally summary-oriented. Use `network detail` for deep inspection.
-- `replay` is transport-aware and should usually replace manual probe logic.
-- `browser status` intentionally does not leak the raw browser websocket endpoint.
-- The package also exports advanced cloud and browser-management utilities, but the core agent workflow is the local discovery-first SDK and CLI shown above.
+## Community
+
+- [Contributing](https://github.com/steerlabs/opensteer/blob/main/CONTRIBUTING.md)
+- [Code of Conduct](https://github.com/steerlabs/opensteer/blob/main/CODE_OF_CONDUCT.md)
+- [Security Policy](https://github.com/steerlabs/opensteer/blob/main/SECURITY.md)
+- [License](https://github.com/steerlabs/opensteer/blob/main/LICENSE) (MIT)

package/dist/{chunk-UM2Q4JD2.js → chunk-7D45QUZ3.js}

@@ -1,5 +1,5 @@
-import { resolveOpensteerEnvironment, resolveOpensteerRuntimeConfig, createOpensteerSemanticRuntime } from './chunk-GREXSYNC.js';
-import { OpensteerBrowserManager } from './chunk-2TIVULZY.js';
+import { resolveOpensteerEnvironment, resolveOpensteerRuntimeConfig, createOpensteerSemanticRuntime } from './chunk-7LQL5YUR.js';
+import { OpensteerBrowserManager } from './chunk-GSCQQKZZ.js';
 
 // src/sdk/opensteer.ts
 var SessionCookieJar = class {
@@ -52,6 +52,7 @@ var Opensteer = class {
         ...runtimeOptions.rootPath === void 0 ? {} : { rootPath: runtimeOptions.rootPath },
         ...runtimeOptions.workspace === void 0 ? {} : { workspace: runtimeOptions.workspace },
         ...engineName === void 0 ? {} : { engineName },
+        environment,
         ...runtimeOptions.browser === void 0 ? {} : { browser: runtimeOptions.browser },
         ...runtimeOptions.launch === void 0 ? {} : { launch: runtimeOptions.launch },
         ...runtimeOptions.context === void 0 ? {} : { context: runtimeOptions.context }
@@ -176,9 +177,6 @@ var Opensteer = class {
       await delay(pollIntervalMs);
     }
   }
-  async snapshot(mode = "action") {
-    return (await this.runtime.snapshot({ mode })).html;
-  }
   async cookies(domain) {
     return new SessionCookieJar(
       await this.runtime.getCookies(domain === void 0 ? {} : { domain })
@@ -330,5 +328,5 @@ function delay(ms) {
 }
 
 export { Opensteer };
-//# sourceMappingURL=chunk-UM2Q4JD2.js.map
-//# sourceMappingURL=chunk-UM2Q4JD2.js.map
+//# sourceMappingURL=chunk-7D45QUZ3.js.map
+//# sourceMappingURL=chunk-7D45QUZ3.js.map

package/dist/chunk-7D45QUZ3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sdk/opensteer.ts"],"names":["options"],"mappings":"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","file":"chunk-7D45QUZ3.js","sourcesContent":["import type {\n  CookieRecord,\n  OpensteerCookieQueryOutput,\n  OpensteerActionResult,\n  OpensteerAddInitScriptInput,\n  OpensteerAddInitScriptOutput,\n  OpensteerComputerExecuteInput,\n  OpensteerComputerExecuteOutput,\n  OpensteerComputerKeyModifier,\n  OpensteerComputerMouseButton,\n  OpensteerNetworkDetailOutput,\n  OpensteerNetworkQueryInput,\n  OpensteerNetworkQueryOutput,\n  OpensteerOpenInput,\n  OpensteerOpenOutput,\n  OpensteerPageActivateInput,\n  OpensteerPageActivateOutput,\n  OpensteerPageCloseInput,\n  OpensteerPageCloseOutput,\n  OpensteerPageEvaluateInput,\n  OpensteerPageEvaluateOutput,\n  OpensteerPageGotoInput,\n  OpensteerPageGotoOutput,\n  OpensteerPageListInput,\n  OpensteerPageListOutput,\n  OpensteerPageNewInput,\n  OpensteerPageNewOutput,\n  OpensteerRequestBodyInput,\n  OpensteerRequestResponseResult,\n  OpensteerSessionCloseOutput,\n  OpensteerSessionFetchInput,\n  OpensteerSessionInfo,\n  OpensteerStateQueryOutput,\n  OpensteerStorageArea,\n  OpensteerStorageDomainSnapshot,\n  OpensteerTargetInput,\n} from \"@opensteer/protocol\";\n\nimport {\n  OpensteerBrowserManager,\n  type OpensteerBrowserStatus,\n  type WorkspaceBrowserManifest,\n} from \"../browser-manager.js\";\nimport { resolveOpensteerEnvironment } from \"../env.js\";\nimport type { OpensteerProviderOptions } from \"../provider/config.js\";\nimport type {\n  OpensteerInterceptScriptOptions,\n  OpensteerInstrumentableRuntime,\n  OpensteerRouteOptions,\n  OpensteerRouteRegistration,\n} from \"./instrumentation.js\";\nimport type { OpensteerRuntimeOptions } from \"./runtime.js\";\nimport {\n  createOpensteerSemanticRuntime,\n  resolveOpensteerRuntimeConfig,\n} from \"./runtime-resolution.js\";\nimport type { OpensteerDisconnectableRuntime } from \"./semantic-runtime.js\";\n\nexport interface OpensteerTargetOptions {\n  readonly element?: number;\n  readonly selector?: string;\n  readonly persist?: string;\n  readonly captureNetwork?: string;\n}\n\nexport interface OpensteerClickOptions extends OpensteerTargetOptions {\n  readonly button?: OpensteerComputerMouseButton;\n  readonly clickCount?: number;\n  readonly modifiers?: readonly OpensteerComputerKeyModifier[];\n}\n\nexport interface OpensteerInputOptions extends OpensteerTargetOptions {\n  readonly text: string;\n  readonly pressEnter?: boolean;\n}\n\nexport interface OpensteerScrollOptions extends OpensteerTargetOptions {\n  readonly direction: \"up\" | \"down\" | \"left\" | \"right\";\n  readonly amount: number;\n}\n\nexport interface OpensteerExtractOptions {\n  readonly persist: string;\n}\n\nexport interface OpensteerWaitForPageOptions {\n  readonly openerPageRef?: string;\n  readonly urlIncludes?: string;\n  readonly timeoutMs?: number;\n  readonly pollIntervalMs?: number;\n}\n\nexport type OpensteerAddInitScriptOptions = OpensteerAddInitScriptInput;\nexport type OpensteerGotoOptions = Omit<OpensteerPageGotoInput, \"url\">;\nexport type OpensteerNetworkQueryOptions = OpensteerNetworkQueryInput;\nexport type OpensteerNetworkQueryResult = OpensteerNetworkQueryOutput;\nexport type OpensteerNetworkDetailResult = OpensteerNetworkDetailOutput;\nexport type OpensteerFetchOptions = Omit<OpensteerSessionFetchInput, \"url\" | \"body\"> & {\n  readonly body?: string | OpensteerRequestBodyInput;\n};\nexport type OpensteerComputerExecuteOptions = OpensteerComputerExecuteInput;\nexport type OpensteerStorageMap = Readonly<Record<string, string>>;\nexport type OpensteerBrowserState = OpensteerStateQueryOutput;\n\nexport interface OpensteerCookieJar {\n  readonly domain?: string;\n  has(name: string): boolean;\n  get(name: string): string | undefined;\n  getAll(): readonly CookieRecord[];\n  serialize(): string;\n}\n\nexport interface OpensteerDomController {\n  click(input: OpensteerClickOptions): Promise<OpensteerActionResult>;\n  hover(input: OpensteerTargetOptions): Promise<OpensteerActionResult>;\n  input(input: OpensteerInputOptions): Promise<OpensteerActionResult>;\n  scroll(input: OpensteerScrollOptions): Promise<OpensteerActionResult>;\n}\n\nexport interface OpensteerNetworkController {\n  query(input?: OpensteerNetworkQueryOptions): Promise<OpensteerNetworkQueryResult>;\n  detail(\n    recordId: string,\n    options?: { readonly probe?: boolean },\n  ): Promise<OpensteerNetworkDetailResult>;\n}\n\nexport interface OpensteerOptions extends OpensteerRuntimeOptions {\n  readonly provider?: OpensteerProviderOptions;\n}\n\nexport interface OpensteerBrowserCloneOptions {\n  readonly sourceUserDataDir: string;\n  readonly sourceProfileDirectory?: string;\n}\n\nexport interface OpensteerBrowserController {\n  status(): Promise<OpensteerBrowserStatus>;\n  clone(input: OpensteerBrowserCloneOptions): Promise<WorkspaceBrowserManifest>;\n  reset(): Promise<void>;\n  delete(): Promise<void>;\n}\n\nclass SessionCookieJar implements OpensteerCookieJar {\n  readonly domain?: string;\n  private readonly cookies: readonly CookieRecord[];\n\n  constructor(output: OpensteerCookieQueryOutput) {\n    if (output.domain !== undefined) {\n      this.domain = output.domain;\n    }\n    this.cookies = output.cookies;\n  }\n\n  has(name: string): boolean {\n    return this.cookies.some((cookie) => cookie.name === name);\n  }\n\n  get(name: string): string | undefined {\n    return this.cookies.find((cookie) => cookie.name === name)?.value;\n  }\n\n  getAll(): readonly CookieRecord[] {\n    return this.cookies;\n  }\n\n  serialize(): string {\n    return this.cookies.map((cookie) => `${cookie.name}=${cookie.value}`).join(\"; \");\n  }\n}\n\nexport class Opensteer {\n  private readonly runtime: OpensteerDisconnectableRuntime;\n  private readonly browserManager: OpensteerBrowserManager | undefined;\n  readonly browser: OpensteerBrowserController;\n  readonly dom: OpensteerDomController;\n  readonly network: OpensteerNetworkController;\n\n  constructor(options: OpensteerOptions = {}) {\n    const environment = resolveOpensteerEnvironment(options.rootDir);\n    const { provider, engineName, ...runtimeOptions } = options;\n    const runtimeConfig = resolveOpensteerRuntimeConfig({\n      ...(provider === undefined ? {} : { provider }),\n      environment,\n    });\n\n    if (runtimeConfig.provider.mode === \"cloud\") {\n      this.browserManager = undefined;\n      this.runtime = createOpensteerSemanticRuntime({\n        ...(provider === undefined ? {} : { provider }),\n        ...(engineName === undefined ? {} : { engine: engineName }),\n        environment,\n        runtimeOptions,\n      });\n      this.browser = createUnsupportedBrowserController();\n    } else {\n      this.browserManager = new OpensteerBrowserManager({\n        ...(runtimeOptions.rootDir === undefined ? {} : { rootDir: runtimeOptions.rootDir }),\n        ...(runtimeOptions.rootPath === undefined ? {} : { rootPath: runtimeOptions.rootPath }),\n        ...(runtimeOptions.workspace === undefined ? {} : { workspace: runtimeOptions.workspace }),\n        ...(engineName === undefined ? {} : { engineName }),\n        environment,\n        ...(runtimeOptions.browser === undefined ? {} : { browser: runtimeOptions.browser }),\n        ...(runtimeOptions.launch === undefined ? {} : { launch: runtimeOptions.launch }),\n        ...(runtimeOptions.context === undefined ? {} : { context: runtimeOptions.context }),\n      });\n      this.runtime = createOpensteerSemanticRuntime({\n        ...(provider === undefined ? {} : { provider }),\n        ...(engineName === undefined ? {} : { engine: engineName }),\n        environment,\n        runtimeOptions: {\n          ...runtimeOptions,\n          rootPath: this.browserManager.rootPath,\n          cleanupRootOnClose: this.browserManager.cleanupRootOnDisconnect,\n        },\n      });\n      this.browser = {\n        status: () => this.browserManager!.status(),\n        clone: (input) => this.browserManager!.clonePersistentBrowser(input),\n        reset: () => this.browserManager!.reset(),\n        delete: () => this.browserManager!.delete(),\n      };\n    }\n\n    this.dom = {\n      click: (input) => this.click(input),\n      hover: (input) => this.hover(input),\n      input: (input) => this.input(input),\n      scroll: (input) => this.scroll(input),\n    };\n\n    this.network = {\n      query: (input = {}) => this.runtime.queryNetwork(input),\n      detail: (recordId, options) => this.runtime.getNetworkDetail({ recordId, ...options }),\n    };\n  }\n\n  async open(input: string | OpensteerOpenInput = {}): Promise<OpensteerOpenOutput> {\n    return this.runtime.open(typeof input === \"string\" ? { url: input } : input);\n  }\n\n  async info(): Promise<OpensteerSessionInfo> {\n    return this.runtime.info();\n  }\n\n  async listPages(input: OpensteerPageListInput = {}): Promise<OpensteerPageListOutput> {\n    return this.runtime.listPages(input);\n  }\n\n  async newPage(input: OpensteerPageNewInput = {}): Promise<OpensteerPageNewOutput> {\n    return this.runtime.newPage(input);\n  }\n\n  async activatePage(input: OpensteerPageActivateInput): Promise<OpensteerPageActivateOutput> {\n    return this.runtime.activatePage(input);\n  }\n\n  async closePage(input: OpensteerPageCloseInput = {}): Promise<OpensteerPageCloseOutput> {\n    return this.runtime.closePage(input);\n  }\n\n  async goto(url: string, options: OpensteerGotoOptions = {}): Promise<OpensteerPageGotoOutput> {\n    return this.runtime.goto({\n      url,\n      ...options,\n    });\n  }\n\n  async evaluate(\n    input: string | OpensteerPageEvaluateInput,\n  ): Promise<OpensteerPageEvaluateOutput[\"value\"]> {\n    const normalized =\n      typeof input === \"string\"\n        ? {\n            script: input,\n          }\n        : input;\n    return (await this.runtime.evaluate(normalized)).value;\n  }\n\n  async addInitScript(\n    input: string | OpensteerAddInitScriptInput,\n  ): Promise<OpensteerAddInitScriptOutput> {\n    return this.runtime.addInitScript(\n      typeof input === \"string\"\n        ? {\n            script: input,\n          }\n        : input,\n    );\n  }\n\n  async click(input: OpensteerClickOptions): Promise<OpensteerActionResult> {\n    const { button, clickCount, modifiers, ...target } = input;\n    return this.runtime.click({\n      ...normalizeTargetOptions(target),\n      ...(button === undefined ? {} : { button }),\n      ...(clickCount === undefined ? {} : { clickCount }),\n      ...(modifiers === undefined ? {} : { modifiers }),\n    });\n  }\n\n  async hover(input: OpensteerTargetOptions): Promise<OpensteerActionResult> {\n    return this.runtime.hover(normalizeTargetOptions(input));\n  }\n\n  async input(input: OpensteerInputOptions): Promise<OpensteerActionResult> {\n    return this.runtime.input({\n      ...normalizeTargetOptions(input),\n      text: input.text,\n      ...(input.pressEnter === undefined ? {} : { pressEnter: input.pressEnter }),\n    });\n  }\n\n  async scroll(input: OpensteerScrollOptions): Promise<OpensteerActionResult> {\n    return this.runtime.scroll({\n      ...normalizeTargetOptions(input),\n      direction: input.direction,\n      amount: input.amount,\n    });\n  }\n\n  async extract(input: OpensteerExtractOptions): Promise<unknown> {\n    return (await this.runtime.extract(input)).data;\n  }\n\n  async waitForPage(\n    input: OpensteerWaitForPageOptions = {},\n  ): Promise<OpensteerPageListOutput[\"pages\"][number]> {\n    const baseline = new Set((await this.runtime.listPages()).pages.map((page) => page.pageRef));\n    const timeoutAt = Date.now() + (input.timeoutMs ?? 30_000);\n    const pollIntervalMs = input.pollIntervalMs ?? 100;\n\n    while (true) {\n      const match = (await this.runtime.listPages()).pages.find((page) => {\n        if (baseline.has(page.pageRef)) {\n          return false;\n        }\n        if (input.openerPageRef !== undefined && page.openerPageRef !== input.openerPageRef) {\n          return false;\n        }\n        if (input.urlIncludes !== undefined && !page.url.includes(input.urlIncludes)) {\n          return false;\n        }\n        return true;\n      });\n      if (match !== undefined) {\n        return match;\n      }\n      if (Date.now() >= timeoutAt) {\n        throw new Error(\"waitForPage timed out\");\n      }\n      await delay(pollIntervalMs);\n    }\n  }\n\n  async cookies(domain?: string): Promise<OpensteerCookieJar> {\n    return new SessionCookieJar(\n      await this.runtime.getCookies(domain === undefined ? {} : { domain }),\n    );\n  }\n\n  async storage(\n    domain?: string,\n    type: OpensteerStorageArea = \"local\",\n  ): Promise<OpensteerStorageMap> {\n    const snapshot = await this.runtime.getStorageSnapshot(domain === undefined ? {} : { domain });\n    const domainSnapshot = pickStorageDomainSnapshot(snapshot, domain);\n    if (domainSnapshot === undefined) {\n      return {};\n    }\n    const entries = type === \"local\" ? domainSnapshot.localStorage : domainSnapshot.sessionStorage;\n    return Object.fromEntries(entries.map((entry) => [entry.key, entry.value]));\n  }\n\n  async state(domain?: string): Promise<OpensteerBrowserState> {\n    return this.runtime.getBrowserState(domain === undefined ? {} : { domain });\n  }\n\n  async fetch(url: string, options: OpensteerFetchOptions = {}): Promise<Response> {\n    const input = buildFetchInput(url, options);\n    const result = await this.runtime.fetch(input);\n    if (result.response === undefined) {\n      throw new Error(result.note ?? `session.fetch did not produce a response for ${url}`);\n    }\n    return toResponse(result.response);\n  }\n\n  async computerExecute(\n    input: OpensteerComputerExecuteOptions,\n  ): Promise<OpensteerComputerExecuteOutput> {\n    return this.runtime.computerExecute(input);\n  }\n\n  async route(input: OpensteerRouteOptions): Promise<OpensteerRouteRegistration> {\n    return this.requireOwnedInstrumentationRuntime(\"route\").route(input);\n  }\n\n  async interceptScript(\n    input: OpensteerInterceptScriptOptions,\n  ): Promise<OpensteerRouteRegistration> {\n    return this.requireOwnedInstrumentationRuntime(\"interceptScript\").interceptScript(input);\n  }\n\n  async close(): Promise<OpensteerSessionCloseOutput> {\n    if (this.browserManager === undefined || this.browserManager.mode === \"temporary\") {\n      return this.runtime.close();\n    }\n\n    const output = await this.runtime.close();\n    await this.browserManager.close();\n    return output;\n  }\n\n  async disconnect(): Promise<void> {\n    await this.runtime.disconnect();\n  }\n\n  private requireOwnedInstrumentationRuntime(\n    method: \"route\" | \"interceptScript\",\n  ): OpensteerInstrumentableRuntime {\n    if (\n      typeof (this.runtime as Partial<OpensteerInstrumentableRuntime>).route === \"function\" &&\n      typeof (this.runtime as Partial<OpensteerInstrumentableRuntime>).interceptScript ===\n        \"function\"\n    ) {\n      return this.runtime as OpensteerDisconnectableRuntime & OpensteerInstrumentableRuntime;\n    }\n    throw new Error(`${method}() is not available for this session runtime.`);\n  }\n}\n\nfunction createUnsupportedBrowserController(): OpensteerBrowserController {\n  const fail = async (): Promise<never> => {\n    throw new Error(\"browser.* helpers are only available in local mode.\");\n  };\n\n  return {\n    status: fail,\n    clone: fail,\n    reset: fail,\n    delete: fail,\n  };\n}\n\nfunction normalizeTargetOptions(input: OpensteerTargetOptions): {\n  readonly target: OpensteerTargetInput;\n  readonly persist?: string;\n  readonly captureNetwork?: string;\n} {\n  const hasElement = input.element !== undefined;\n  const hasSelector = input.selector !== undefined;\n  if (hasElement && hasSelector) {\n    throw new Error(\"Specify exactly one of element, selector, or persist.\");\n  }\n\n  if (hasElement) {\n    return {\n      target: {\n        kind: \"element\",\n        element: input.element,\n      },\n      ...(input.persist === undefined ? {} : { persist: input.persist }),\n      ...(input.captureNetwork === undefined ? {} : { captureNetwork: input.captureNetwork }),\n    };\n  }\n\n  if (hasSelector) {\n    return {\n      target: {\n        kind: \"selector\",\n        selector: input.selector,\n      },\n      ...(input.persist === undefined ? {} : { persist: input.persist }),\n      ...(input.captureNetwork === undefined ? {} : { captureNetwork: input.captureNetwork }),\n    };\n  }\n\n  if (input.persist === undefined) {\n    throw new Error(\"Specify exactly one of element, selector, or persist.\");\n  }\n\n  return {\n    target: {\n      kind: \"persist\",\n      persist: input.persist,\n    },\n    ...(input.captureNetwork === undefined ? {} : { captureNetwork: input.captureNetwork }),\n  };\n}\n\nfunction pickStorageDomainSnapshot(\n  snapshot: {\n    readonly domains: readonly OpensteerStorageDomainSnapshot[];\n  },\n  domain: string | undefined,\n): OpensteerStorageDomainSnapshot | undefined {\n  if (snapshot.domains.length === 0) {\n    return undefined;\n  }\n  if (domain === undefined) {\n    return snapshot.domains[0];\n  }\n  return snapshot.domains.find((entry) => entry.domain === domain);\n}\n\nfunction buildFetchInput(url: string, options: OpensteerFetchOptions): OpensteerSessionFetchInput {\n  const { body, ...rest } = options;\n  return {\n    url,\n    ...rest,\n    ...(body === undefined ? {} : { body: normalizeFetchBody(body, rest.headers) }),\n  };\n}\n\nfunction normalizeFetchBody(\n  body: string | OpensteerRequestBodyInput,\n  headers: OpensteerSessionFetchInput[\"headers\"],\n): OpensteerRequestBodyInput {\n  if (typeof body !== \"string\") {\n    return body;\n  }\n\n  const contentType = findHeaderValue(headers, \"content-type\");\n  return contentType === undefined ? { text: body } : { text: body, contentType };\n}\n\nfunction findHeaderValue(\n  headers: OpensteerSessionFetchInput[\"headers\"],\n  headerName: string,\n): string | undefined {\n  if (headers === undefined) {\n    return undefined;\n  }\n\n  const match = Object.entries(headers).find(\n    ([name]) => name.toLowerCase() === headerName.toLowerCase(),\n  );\n  return match === undefined ? undefined : String(match[1]);\n}\n\nfunction toResponse(response: OpensteerRequestResponseResult): Response {\n  return new Response(decodeBody(response), {\n    status: response.status,\n    statusText: response.statusText,\n    headers: Object.fromEntries(response.headers.map((header) => [header.name, header.value])),\n  });\n}\n\nfunction decodeBody(response: OpensteerRequestResponseResult): Uint8Array | undefined {\n  if (response.body === undefined) {\n    return undefined;\n  }\n  return Uint8Array.from(Buffer.from(response.body.data, \"base64\"));\n}\n\nfunction delay(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"]}