surf-cli 2.0.0

package/dist/service-worker-loader.js

@@ -0,0 +1 @@
+import './service-worker/index.js';

package/native/CHANGELOG.md

@@ -0,0 +1,136 @@
+# Changelog
+
+All notable changes to surf CLI will be documented in this file.
+
+## [2.2.0] - 2026-01-07
+
+### Added
+- Network capture: `network`, `network.stats`, `network.origins`, `network.get`, `network.clear`, `network.export`
+- Filtering by method, status, URL, content-type
+- Export formats: curl, raw JSON, URL list
+- Persistence to `/tmp/surf/` (configurable via `SURF_NETWORK_PATH`)
+
+## [2.1.0] - 2025-12-30
+
+### Added
+
+**ChatGPT Integration**
+- `chatgpt <query>` - Send prompt to ChatGPT using browser cookies (no API key)
+  - `--with-page` - Include current page context
+  - `--model` - Specify model (gpt-4o, o1, etc.)
+  - `--timeout` - Custom timeout (default: 45 minutes)
+  - File attachments coming soon
+
+**Gemini Integration (Coming Soon)**
+- `gemini <query>` - Command structure ready, implementation pending
+
+**Request Queue**
+- AI requests are queued sequentially with 2s minimum delay between requests
+- Prevents rate limiting when making multiple AI queries
+
+### Technical Changes
+- New `chatgpt-client.cjs` module for ChatGPT browser automation
+- Extension: `GET_CHATGPT_COOKIES`, `GET_GOOGLE_COOKIES` handlers
+- Extension: `CHATGPT_NEW_TAB`, `CHATGPT_CLOSE_TAB`, `CHATGPT_CDP_COMMAND`, `CHATGPT_EVALUATE` handlers
+- CDP controller: Added public `sendCommand()` method
+
+## [2.0.0] - 2025-12-27
+
+### Breaking Changes
+- Removed snake_case command aliases (use dot-notation instead)
+  - `read_page` -> `page.read`
+  - `list_tabs` -> `tab.list`
+  - `wait_for_element` -> `wait.element`
+  - `javascript_tool` -> `js`
+  - And others (see REMOVED_COMMANDS in cli.cjs for full list)
+- Removed all single-letter short flags for consistency
+  - Use `--output` instead of `-o`
+  - Use `--ref` instead of `-r`
+  - Use `--annotate` instead of `-a`
+  - Use `--fullpage` instead of `-f`
+- Migration hints shown when using old command names
+
+### Added
+
+**Navigation**
+- `back` - Go back in browser history
+- `forward` - Go forward in browser history
+- `tab.reload` - Reload tab (with `--hard` for cache bypass)
+
+**Tab Groups**
+- `tab.group` - Create or add to tab group
+- `tab.ungroup` - Remove tabs from group
+- `tab.groups` - List all tab groups
+
+**Zoom Control**
+- `zoom` - Get current zoom level
+- `zoom <level>` - Set zoom (e.g., `zoom 1.5` for 150%)
+- `zoom --reset` - Reset to default zoom
+
+**Cookies**
+- `cookie.list` - List cookies for current domain
+- `cookie.get` - Get specific cookie by name
+- `cookie.set` - Set a cookie
+- `cookie.clear` - Clear specific cookie or all (`--all`)
+
+**Search**
+- `search <term>` - Search for text in page (alias: `find`)
+- Returns match refs, context, and element associations
+
+**Batch Execution**
+- `batch --actions '[...]'` - Execute multiple actions
+- `batch --file workflow.json` - Load actions from file
+
+**Bookmarks**
+- `bookmark.add` - Bookmark current page
+- `bookmark.remove` - Remove bookmark for current page
+- `bookmark.list` - List bookmarks
+
+**History**
+- `history.list` - Recent browser history
+- `history.search <query>` - Search history
+
+**Screenshot Enhancements**
+- `--annotate` - Draw element labels on screenshot
+- `--fullpage` - Capture entire scrollable page
+- `--max-height` - Limit fullpage capture height (default: 4000px)
+- Extension UI automatically hidden during capture
+
+**Aliases**
+- `snap` -> `screenshot` (auto-saves to /tmp if no output specified)
+- `read` -> `page.read`
+- `find` -> `search`
+- `go` -> `navigate`
+
+**Discovery Features**
+- `--find <query>` - Fuzzy search for commands
+- `--about <topic>` - Learn about a topic
+
+**Help System**
+- `--help` - Basic help with common commands
+- `--help-full` - Complete command reference
+- `--help-topic <topic>` - Topic-specific guide
+- Command-level help with examples
+
+**Other**
+- `--version` - Show version
+- `click 100 200` - Positional coordinates for click
+- `click --selector ".btn" --index 2` - Click nth element matching selector
+
+### Changed
+- Primary argument support for commands:
+  - `wait.element <selector>` (was `--selector`)
+  - `wait.url <pattern>` (was `--pattern`)
+  - `click <ref>` with e-prefix detection (e.g., `click e5`)
+- Help output includes usage examples for all commands
+- `dialog.dismiss --all` for repeatedly dismissing dialogs
+- Fullpage screenshot delay increased to 300ms for lazy-loaded content
+- Error messages standardized to terse format for AI consumption
+
+### Fixed
+- `--limit 0` now correctly returns empty results (was defaulting to max)
+- Screenshot always hides extension UI (was conditional on `--clean` flag)
+
+## [1.x] - Previous Releases
+
+See git history for changes before v2.0.0.

package/native/README.md

@@ -0,0 +1,141 @@
+# Surf Native Host
+
+Native messaging host that bridges CLI commands to the Chrome extension via Unix socket.
+
+## Architecture
+
+```
+CLI (surf) → Unix Socket (/tmp/surf.sock) → Native Host → Chrome Extension → CDP
+```
+
+## Files
+
+| File | Purpose |
+|------|---------|
+| `host.cjs` | Main native host with socket server and tool handling |
+| `cli.cjs` | CLI tool for browser automation |
+| `chatgpt-client.cjs` | ChatGPT browser automation client |
+| `protocol.cjs` | Chrome native messaging protocol helpers |
+| `host-wrapper.py` | Python wrapper for native host execution |
+| `host.sh` | Shell script to start the host |
+
+## Setup
+
+1. Install the native host manifest:
+```bash
+npm run install:native <extension-id>
+```
+
+Or manually:
+```bash
+mkdir -p ~/Library/Application\ Support/Google/Chrome/NativeMessagingHosts
+cat > ~/Library/Application\ Support/Google/Chrome/NativeMessagingHosts/com.anthropic.pi_chrome.json << EOF
+{
+  "name": "com.anthropic.pi_chrome",
+  "description": "Surf CLI Native Host",
+  "path": "$PWD/host-wrapper.py",
+  "type": "stdio",
+  "allowed_origins": ["chrome-extension://YOUR_EXTENSION_ID/"]
+}
+EOF
+```
+
+2. Start the native host:
+```bash
+node host.cjs
+```
+
+The host creates a Unix socket at `/tmp/surf.sock`.
+
+## CLI Reference
+
+See the main [README](../README.md) for full CLI documentation.
+
+### Quick Reference
+
+```bash
+surf go "https://example.com"       # Navigate
+surf read                           # Get accessibility tree
+surf click e5                       # Click element
+surf type "hello" --submit          # Type and submit
+surf snap                           # Screenshot to /tmp
+surf chatgpt "explain this"         # Query ChatGPT
+```
+
+### Global Options
+
+```bash
+--tab-id <id>     # Target specific tab
+--json            # Output raw JSON
+--soft-fail       # Warn instead of error on restricted pages
+--no-screenshot   # Skip auto-screenshot after actions
+--full            # Full resolution screenshots
+```
+
+## Protocol
+
+### Tool Request
+
+```json
+{
+  "type": "tool_request",
+  "method": "execute_tool",
+  "params": {
+    "tool": "TOOL_NAME",
+    "args": { ... },
+    "tabId": 123
+  },
+  "id": "unique-request-id"
+}
+```
+
+### Tool Response (Success)
+
+```json
+{
+  "type": "tool_response",
+  "id": "unique-request-id",
+  "result": {
+    "content": [
+      { "type": "text", "text": "Result message" }
+    ]
+  }
+}
+```
+
+### Tool Response (With Image)
+
+```json
+{
+  "type": "tool_response",
+  "id": "unique-request-id",
+  "result": {
+    "content": [
+      { "type": "text", "text": "Screenshot captured" },
+      { "type": "image", "data": "base64...", "mimeType": "image/png" }
+    ]
+  }
+}
+```
+
+### Tool Response (Error)
+
+```json
+{
+  "type": "tool_response",
+  "id": "unique-request-id",
+  "error": {
+    "content": [{ "type": "text", "text": "Error message" }]
+  }
+}
+```
+
+## Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| Socket not found | Ensure `node host.cjs` is running |
+| No response | Check extension is loaded in Chrome |
+| "Content script not loaded" | Navigate to a page first |
+| "Cannot control this page" | Page is restricted (chrome://, extensions) - use `--soft-fail` |
+| Slow first operation | Normal - CDP debugger attachment takes ~100-500ms |