agentmb 0.1.0

package/INSTALL.md

@@ -0,0 +1,154 @@
+# Installation Guide
+
+## Prerequisites
+
+| Component | Version | Install |
+|---|---|---|
+| Node.js | ≥ 20 LTS | [nodejs.org](https://nodejs.org) or `nvm install 20` |
+| Python | ≥ 3.9 | [python.org](https://python.org) |
+| Chromium | (auto) | `npx playwright install chromium` |
+
+---
+
+## macOS
+
+```bash
+# 1. Clone the repo
+git clone https://github.com/what552/agent-managed-browser.git
+cd agent-managed-browser
+
+# 2. Install Node dependencies and build
+npm ci
+npm run build
+
+# 3. Install Chromium (one-time)
+npx playwright install chromium
+
+# 4. (Optional) Install CLI globally
+npm link
+# → agentmb start / agentmb session / agentmb navigate …
+
+# 5. Install Python SDK
+pip install sdk/python
+# or editable: pip install -e sdk/python
+
+# 6. Verify
+agentmb start &
+sleep 2
+curl http://localhost:19315/health
+agentmb stop
+```
+
+---
+
+## Linux (Ubuntu / Debian)
+
+```bash
+# 1. Install Node 20 LTS
+curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+sudo apt-get install -y nodejs
+
+# 2. Clone and build
+git clone https://github.com/what552/agent-managed-browser.git
+cd agent-managed-browser
+npm ci
+npm run build
+
+# 3. Install Chromium + headless dependencies
+npx playwright install chromium
+npx playwright install-deps chromium    # installs libglib2, libnss3, etc.
+
+# 4. (Optional) CLI global install
+sudo npm link
+
+# 5. Install Python SDK
+pip3 install sdk/python
+# or: pip3 install -e sdk/python
+
+# 6. Verify (headless — no display needed)
+agentmb start &
+sleep 2
+curl http://localhost:19315/health
+agentmb stop
+
+# Headed mode (visual / login handoff) requires Xvfb:
+sudo apt-get install -y xvfb
+bash scripts/xvfb-headed.sh
+```
+
+### Linux: run tests
+
+```bash
+# Full regression gate (starts/stops daemon automatically)
+bash scripts/verify.sh
+```
+
+---
+
+## Windows (PowerShell / WSL2)
+
+### Option A — WSL2 (recommended)
+
+Run the Linux instructions above inside WSL2 (Ubuntu).
+
+### Option B — Native Windows (PowerShell)
+
+```powershell
+# 1. Install Node 20 LTS from https://nodejs.org
+#    Verify: node --version  (must be >= 20)
+
+# 2. Clone and build
+git clone https://github.com/what552/agent-managed-browser.git
+cd agent-managed-browser
+npm ci
+npm run build
+
+# 3. Install Chromium
+npx playwright install chromium
+
+# 4. (Optional) CLI global install
+npm link
+
+# 5. Install Python SDK
+pip install sdk/python
+
+# 6. Verify
+Start-Process node -ArgumentList "dist/daemon/index.js" -NoNewWindow
+Start-Sleep 2
+Invoke-RestMethod http://localhost:19315/health
+```
+
+> **Note**: Windows headed mode works natively (no Xvfb needed).
+> Windows headless mode requires `--no-sandbox` which is already set in `src/browser/manager.ts`.
+
+---
+
+## Environment variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `AGENTMB_PORT` | `19315` | Daemon HTTP port |
+| `AGENTMB_DATA_DIR` | `~/.agentmb` | Profile & log storage |
+| `AGENTMB_API_TOKEN` | (none) | Enable token auth |
+| `AGENTMB_ENCRYPTION_KEY` | (none) | AES-256-GCM sessions.json encryption key (32 bytes as base64 or hex) |
+| `AGENTMB_LOG_LEVEL` | `info` | Pino log level |
+
+---
+
+## Quick sanity check (all platforms)
+
+After install:
+
+```bash
+# Build
+npm run build                           # → 0 errors
+
+# SDK import
+python3 -c "from agentmb import BrowserClient; print('SDK OK')"
+
+# CLI version
+node dist/cli/index.js --help           # shows usage
+
+# Full gate (needs network for example.com)
+bash scripts/verify.sh
+```

package/README.md

@@ -0,0 +1,228 @@
+# agent-managed-browser
+
+Agent-ready local browser runtime for stable, auditable web automation.
+
+## What It Does
+
+`agent-managed-browser` provides a persistent Chromium daemon with session management, CLI/Python SDK access, and human login handoff support. It is designed for coding/ops agents that need reproducible browser workflows instead of fragile one-off scripts.
+
+## Use Cases
+
+- **Agent web tasks**: Let Codex/Claude run navigation, click/fill, extraction, screenshot, and evaluation in a controlled runtime.
+- **Human-in-the-loop login**: Switch to headed mode for manual login, then return to headless automation with the same profile.
+- **E2E and CI verification**: Run isolated smoke/auth/handoff/cdp checks with configurable port and data dir.
+- **Local automation service**: Keep one daemon running and let multiple tools/agents reuse sessions safely.
+
+Local Chromium runtime for AI agents, with:
+
+- daemon API (`agentmb`)
+- CLI (`agentmb`)
+- Python SDK (`agentmb`)
+
+This repo supports macOS, Linux, and Windows.
+
+## Agent Skill
+
+For Codex/Claude/AgentMB operation guidance (initialization, core commands, troubleshooting), see:
+
+- [agentmb-operations-skill/SKILL.md](./agentmb-operations-skill/SKILL.md)
+
+## Quick Start
+
+```bash
+git clone https://github.com/what552/agent-managed-browser.git
+cd agent-managed-browser
+
+# Node 20+ required
+npm ci
+npm run build
+npx playwright install chromium
+
+# optional: install CLI globally
+npm link
+
+# start daemon
+agentmb start
+```
+
+In another terminal:
+
+```bash
+agentmb status
+agentmb session new --profile demo
+agentmb session list
+agentmb navigate <session-id> https://example.com
+agentmb screenshot <session-id> -o ./shot.png
+agentmb stop
+```
+
+## Python SDK
+
+```bash
+pip install -e sdk/python
+python3 -c "from agentmb import BrowserClient; print('SDK OK')"
+```
+
+## Install By Platform
+
+For full installation steps on all environments:
+
+- macOS
+- Linux (Ubuntu / Debian)
+- Windows (PowerShell / WSL2)
+
+See [INSTALL.md](./INSTALL.md).
+
+## Action Reference
+
+| Action | CLI command | Description |
+|---|---|---|
+| navigate | `agentmb navigate <sess> <url>` | Navigate to URL |
+| screenshot | `agentmb screenshot <sess> -o out.png` | Capture screenshot |
+| eval | `agentmb eval <sess> <expr>` | Run JavaScript expression |
+| extract | `agentmb extract <sess> <selector>` | Extract text/attributes |
+| click | `agentmb click <sess> <selector>` | Click element |
+| fill | `agentmb fill <sess> <selector> <value>` | Fill form field |
+| type | `agentmb type <sess> <selector> <text>` | Type char-by-char |
+| press | `agentmb press <sess> <selector> <key>` | Press key / combo (e.g. `Enter`, `Control+a`) |
+| select | `agentmb select <sess> <selector> <val>` | Select `<option>` in a `<select>` |
+| hover | `agentmb hover <sess> <selector>` | Hover over element |
+| wait-selector | `agentmb wait-selector <sess> <selector>` | Wait for element state |
+| wait-url | `agentmb wait-url <sess> <pattern>` | Wait for URL pattern |
+| upload | `agentmb upload <sess> <selector> <file>` | Upload local file to file input |
+| download | `agentmb download <sess> <selector> -o out` | Click link and save download |
+
+## Multi-Page Management
+
+```bash
+agentmb pages list <session-id>           # list all open tabs
+agentmb pages new <session-id>            # open a new tab
+agentmb pages switch <session-id> <page-id>  # make a tab the active target
+agentmb pages close <session-id> <page-id>   # close a tab (last tab protected)
+```
+
+## Network Route Mocks
+
+```bash
+agentmb route list <session-id>                          # list active mocks
+agentmb route add <session-id> "**/api/**" \
+  --status 200 --body '{"ok":true}' \
+  --content-type application/json                        # intercept requests
+agentmb route rm <session-id> "**/api/**"               # remove a mock
+```
+
+## Playwright Trace Recording
+
+```bash
+agentmb trace start <session-id>          # start recording
+# ... do actions ...
+agentmb trace stop <session-id> -o trace.zip   # save ZIP
+npx playwright show-trace trace.zip       # open in Playwright UI
+```
+
+## CDP WebSocket URL
+
+```bash
+agentmb cdp-ws <session-id>              # print browser CDP WebSocket URL
+```
+
+## Linux Headed Mode
+
+Linux visual/headed mode requires Xvfb.
+
+```bash
+sudo apt-get install -y xvfb
+bash scripts/xvfb-headed.sh
+```
+
+## Verify
+
+```bash
+bash scripts/verify.sh
+```
+
+## npm Release Setup
+
+```bash
+# login once
+npm login
+npm whoami
+
+# check package payload before publish
+npm run pack:check
+
+# publish from repo root
+npm publish
+```
+
+If your global npm cache has permission issues, this repo uses project-local cache (`.npm-cache`) via `.npmrc`.
+
+## Environment Variables
+
+Common runtime env vars:
+
+- `AGENTMB_PORT` (default `19315`)
+- `AGENTMB_DATA_DIR` (default `~/.agentmb`)
+- `AGENTMB_API_TOKEN` (optional API auth)
+- `AGENTMB_ENCRYPTION_KEY` (optional AES-256-GCM profile encryption key, 32 bytes as base64 or hex)
+- `AGENTMB_LOG_LEVEL` (default `info`)
+- `AGENTMB_POLICY_PROFILE` (default `safe`) — daemon-wide default safety policy profile
+
+## Safety Execution Policy
+
+agentmb enforces a configurable **safety execution policy** that throttles actions, enforces per-domain rate limits, and blocks sensitive actions (e.g. form submissions, file uploads) unless explicitly permitted.
+
+### Profiles
+
+| Profile | Min interval | Jitter | Max actions/min | Sensitive actions |
+|---|---|---|---|---|
+| `safe` | 1500 ms | 300–800 ms | 8 | blocked by default |
+| `permissive` | 200 ms | 0–100 ms | 60 | allowed |
+| `disabled` | 0 ms | 0 ms | unlimited | allowed |
+
+Set the daemon-wide default via env var:
+```bash
+AGENTMB_POLICY_PROFILE=disabled node dist/daemon/index.js   # CI / trusted automation
+AGENTMB_POLICY_PROFILE=safe    node dist/daemon/index.js   # social-media / sensitive workflows
+```
+
+### Per-session override (CLI)
+
+```bash
+agentmb policy <session-id>                       # get current policy
+agentmb policy <session-id> safe                  # switch to safe profile
+agentmb policy <session-id> permissive            # switch to permissive
+agentmb policy <session-id> safe --allow-sensitive # safe + allow sensitive actions
+```
+
+### Per-session override (Python SDK)
+
+```python
+from agentmb import BrowserClient
+
+with BrowserClient() as client:
+    sess = client.sessions.create()
+    policy = sess.set_policy("safe", allow_sensitive_actions=False)
+    print(policy.max_retries_per_domain)  # 3
+    current = sess.get_policy()
+```
+
+### Audit logs
+
+All policy events (`throttle`, `jitter`, `cooldown`, `deny`, `retry`) are written to the session audit log with `type="policy"`.
+
+```bash
+agentmb logs <session-id>   # shows policy events inline
+```
+
+### Sensitive actions
+
+Mark any action as sensitive by passing `"sensitive": true` in the request body. With `safe` profile and `allow_sensitive_actions=false`, the request returns HTTP 403:
+
+```json
+{ "error": "sensitive action blocked by policy", "policy_event": "deny" }
+```
+
+## License
+
+MIT

package/dist/audit/logger.d.ts

@@ -0,0 +1,25 @@
+export interface AuditEntry {
+    ts?: string;
+    v?: number;
+    session_id?: string;
+    action_id?: string;
+    type: string;
+    action?: string;
+    url?: string;
+    selector?: string;
+    params?: Record<string, unknown>;
+    result?: Record<string, unknown>;
+    agent?: Record<string, unknown>;
+    error?: string | null;
+    purpose?: string;
+    operator?: string;
+}
+export declare class AuditLogger {
+    private logsDir;
+    private currentDate;
+    private stream;
+    constructor(logsDir: string);
+    write(entry: AuditEntry): void;
+    tail(sessionId: string, lines: number): AuditEntry[];
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/audit/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/audit/logger.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,qBAAa,WAAW;IAIV,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,MAAM,CAA8B;gBAExB,OAAO,EAAE,MAAM;IAInC,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAiB9B,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE;CAsBrD"}

package/dist/audit/logger.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLogger = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+class AuditLogger {
+    logsDir;
+    currentDate = '';
+    stream = null;
+    constructor(logsDir) {
+        this.logsDir = logsDir;
+        fs_1.default.mkdirSync(logsDir, { recursive: true });
+    }
+    write(entry) {
+        const now = new Date();
+        const date = now.toISOString().slice(0, 10); // YYYY-MM-DD
+        if (date !== this.currentDate || !this.stream) {
+            this.stream?.end();
+            this.currentDate = date;
+            this.stream = fs_1.default.createWriteStream(path_1.default.join(this.logsDir, `${date}.jsonl`), { flags: 'a' });
+        }
+        const record = {
+            ts: now.toISOString(),
+            v: 1,
+            ...entry,
+        };
+        this.stream.write(JSON.stringify(record) + '\n');
+    }
+    tail(sessionId, lines) {
+        const date = new Date().toISOString().slice(0, 10);
+        const file = path_1.default.join(this.logsDir, `${date}.jsonl`);
+        if (!fs_1.default.existsSync(file))
+            return [];
+        const content = fs_1.default.readFileSync(file, 'utf8');
+        const all = content
+            .trim()
+            .split('\n')
+            .filter(Boolean)
+            .map((line) => {
+            try {
+                return JSON.parse(line);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((e) => e !== null)
+            .filter((e) => !sessionId || e.session_id === sessionId);
+        return all.slice(-lines);
+    }
+}
+exports.AuditLogger = AuditLogger;
+//# sourceMappingURL=logger.js.map

package/dist/audit/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/audit/logger.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAmB;AACnB,gDAAuB;AAmBvB,MAAa,WAAW;IAIF;IAHZ,WAAW,GAAG,EAAE,CAAA;IAChB,MAAM,GAA0B,IAAI,CAAA;IAE5C,YAAoB,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;QACjC,YAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC5C,CAAC;IAED,KAAK,CAAC,KAAiB;QACrB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;QACtB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA,CAAC,aAAa;QACzD,IAAI,IAAI,KAAK,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9C,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAA;YAClB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;YACvB,IAAI,CAAC,MAAM,GAAG,YAAE,CAAC,iBAAiB,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;QAC9F,CAAC;QAED,MAAM,MAAM,GAAe;YACzB,EAAE,EAAE,GAAG,CAAC,WAAW,EAAE;YACrB,CAAC,EAAE,CAAC;YACJ,GAAG,KAAK;SACT,CAAA;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAA;IAClD,CAAC;IAED,IAAI,CAAC,SAAiB,EAAE,KAAa;QACnC,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAClD,MAAM,IAAI,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAA;QACrD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAA;QAEnC,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAC7C,MAAM,GAAG,GAAG,OAAO;aAChB,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,OAAO,CAAC;aACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAe,CAAA;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAA;YACb,CAAC;QACH,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;aAC1C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAA;QAE1D,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAA;IAC1B,CAAC;CACF;AA/CD,kCA+CC"}

package/dist/browser/actions.d.ts

@@ -0,0 +1,111 @@
+import { Page, Frame } from 'playwright-core';
+import { AuditLogger } from '../audit/logger';
+/** Page or frame — both expose the same action surface */
+export type Actionable = Page | Frame;
+type WaitUntil = 'load' | 'networkidle' | 'commit' | 'domcontentloaded';
+export interface ActionDiagnostics {
+    error: string;
+    url: string;
+    title: string;
+    readyState: string;
+    elapsedMs: number;
+    stack?: string;
+}
+export declare class ActionDiagnosticsError extends Error {
+    readonly diagnostics: ActionDiagnostics;
+    constructor(diagnostics: ActionDiagnostics);
+}
+export declare function navigate(page: Page, url: string, waitUntil?: WaitUntil, logger?: AuditLogger, sessionId?: string, purpose?: string, operator?: string): Promise<{
+    status: string;
+    url: string;
+    title: string;
+    duration_ms: number;
+}>;
+export declare function click(page: Actionable, selector: string, timeoutMs?: number, logger?: AuditLogger, sessionId?: string, purpose?: string, operator?: string): Promise<{
+    status: string;
+    selector: string;
+    duration_ms: number;
+}>;
+export declare function fill(page: Actionable, selector: string, value: string, logger?: AuditLogger, sessionId?: string, purpose?: string, operator?: string): Promise<{
+    status: string;
+    selector: string;
+    duration_ms: number;
+}>;
+export declare function evaluate(page: Actionable, expression: string, logger?: AuditLogger, sessionId?: string, purpose?: string, operator?: string): Promise<{
+    status: string;
+    result: unknown;
+    duration_ms: number;
+}>;
+export declare function extract(page: Actionable, selector: string, attribute?: string, logger?: AuditLogger, sessionId?: string, purpose?: string, operator?: string): Promise<{
+    status: string;
+    selector: string;
+    items: Array<Record<string, string | null>>;
+    count: number;
+    duration_ms: number;
+}>;
+export declare function screenshot(page: Page, format?: 'png' | 'jpeg', fullPage?: boolean, logger?: AuditLogger, sessionId?: string, purpose?: string, operator?: string): Promise<{
+    status: string;
+    data: string;
+    format: string;
+    duration_ms: number;
+}>;
+export declare function typeText(page: Actionable, selector: string, text: string, delayMs?: number, logger?: AuditLogger, sessionId?: string, purpose?: string, operator?: string): Promise<{
+    status: string;
+    selector: string;
+    duration_ms: number;
+}>;
+export declare function press(page: Actionable, selector: string, key: string, logger?: AuditLogger, sessionId?: string, purpose?: string, operator?: string): Promise<{
+    status: string;
+    selector: string;
+    key: string;
+    duration_ms: number;
+}>;
+export declare function selectOption(page: Actionable, selector: string, values: string[], logger?: AuditLogger, sessionId?: string, purpose?: string, operator?: string): Promise<{
+    status: string;
+    selector: string;
+    selected: string[];
+    duration_ms: number;
+}>;
+export declare function hover(page: Actionable, selector: string, logger?: AuditLogger, sessionId?: string, purpose?: string, operator?: string): Promise<{
+    status: string;
+    selector: string;
+    duration_ms: number;
+}>;
+export declare function waitForSelector(page: Actionable, selector: string, state?: 'attached' | 'detached' | 'visible' | 'hidden', timeoutMs?: number, logger?: AuditLogger, sessionId?: string, purpose?: string, operator?: string): Promise<{
+    status: string;
+    selector: string;
+    state: string;
+    duration_ms: number;
+}>;
+export declare function waitForUrl(page: Page, urlPattern: string, timeoutMs?: number, logger?: AuditLogger, sessionId?: string, purpose?: string, operator?: string): Promise<{
+    status: string;
+    url: string;
+    duration_ms: number;
+}>;
+export interface WaitForResponseTrigger {
+    type: 'navigate';
+    url: string;
+    waitUntil?: 'load' | 'networkidle' | 'commit' | 'domcontentloaded';
+}
+export declare function waitForResponse(page: Page, urlPattern: string, timeoutMs?: number, trigger?: WaitForResponseTrigger, logger?: AuditLogger, sessionId?: string, purpose?: string, operator?: string): Promise<{
+    status: string;
+    url: string;
+    status_code: number;
+    duration_ms: number;
+}>;
+export declare function uploadFile(page: Page, selector: string, fileContent: string, filename: string, mimeType?: string, logger?: AuditLogger, sessionId?: string, purpose?: string, operator?: string): Promise<{
+    status: string;
+    selector: string;
+    filename: string;
+    size_bytes: number;
+    duration_ms: number;
+}>;
+export declare function downloadFile(page: Page, selector: string, timeoutMs?: number, maxBytes?: number, logger?: AuditLogger, sessionId?: string, purpose?: string, operator?: string): Promise<{
+    status: string;
+    filename: string;
+    data: string;
+    size_bytes: number;
+    duration_ms: number;
+}>;
+export {};
+//# sourceMappingURL=actions.d.ts.map

package/dist/browser/actions.d.ts.map

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