webpilot-cli 0.1.0__tar.gz

webpilot_cli-0.1.0/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: webpilot-cli
+Version: 0.1.0
+Summary: pip launcher for the WebPilot browser agent (npm package: @capagents/webpilot)
+Author: CLI-Agents
+License: MIT
+Keywords: webpilot,browser,agent,cli,opentui
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+
+# WebPilot
+
+Self-contained browser agent: OODA loop (observe → orient → decide → act) → Playwright spec.
+
+No FastAPI or database. LLM profiles live in `llms.json`, agent settings in `webpilot.yaml`. The interactive shell is [OpenTUI](https://opentui.com). Headless `run` is for CI.
+
+The loop matches the WebPilot design in test-agent-nexus (`backend/docs/WEBPILOT_FLOW.md`): DOM observe with shadow roots, viewport JPEG, one JSON action per step, then click / type / select / navigate. See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) and [HOW_TO_USE.md](HOW_TO_USE.md).
+
+## Install
+
+OpenTUI needs **Bun 1.3+**. Node cannot load the native renderer.
+
+The CLI is published on **npm** as `@capagents/webpilot` (the unscoped name is too close to an existing package). **PyPI** package `webpilot-cli` is a pip launcher for the same `webpilot` command (`webpilot` is already another project on PyPI).
+
+```bash
+curl -fsSL https://bun.sh/install | bash
+
+# npm
+npm install -g @capagents/webpilot
+npx @capagents/webpilot --help
+
+# pip (launcher; runs the npm package via bun)
+pip install webpilot-cli
+webpilot --help
+```
+
+Live browser profiles also need Chromium: `bunx playwright install chromium`. The `mock` profile does not.
+
+From this repo:
+
+```bash
+cd WebPilot
+bun install
+bun src/index.ts init
+bun src/index.ts start
+```
+
+One-shot release (same version on both registries; assumes `npm` and `twine` are already logged in):
+
+```bash
+./scripts/publish.sh           # current version
+./scripts/publish.sh 0.2.0     # bump + publish
+./scripts/publish.sh --dry-run # pack only
+```
+
+npm is published first. The pip launcher runs `bun x @capagents/webpilot@<version>`.
+
+## Configure
+
+`init` writes:
+
+| File | Purpose |
+|------|---------|
+| `webpilot.yaml` | Browser, prompts, export, active profile |
+| `llms.json` | Named LLM profiles |
+| `.env.example` | API key names |
+
+```bash
+webpilot models
+webpilot run --goal "Read the homepage" --url https://example.com --profile mock --plain
+```
+
+`mock` uses a synthetic page, writes `workflow.yaml` and `webpilot.spec.ts`, and does not call a model. Switch `llm.active` to `azure-gpt4o` or `openai-gpt4o` for a real browser run.
+
+## CLI
+
+```bash
+webpilot start
+webpilot start -u https://example.com -g "Find the documentation link" -p openai-gpt4o
+
+webpilot run --goal "Get a quote" --url https://example.com --profile azure-gpt4o --headed
+webpilot run --goal "..." --url https://example.com --profile mock --plain --out ./out/demo
+```
+
+Inside the shell: `/url`, `/goal`, `/run`, `/stop`, `/headed`, `/steps`, `/profile`, `/export`, `/exit`. A line without a slash sets the goal and starts when a URL is known.

webpilot_cli-0.1.0/README.md

@@ -0,0 +1,75 @@
+# WebPilot
+
+Self-contained browser agent: OODA loop (observe → orient → decide → act) → Playwright spec.
+
+No FastAPI or database. LLM profiles live in `llms.json`, agent settings in `webpilot.yaml`. The interactive shell is [OpenTUI](https://opentui.com). Headless `run` is for CI.
+
+The loop matches the WebPilot design in test-agent-nexus (`backend/docs/WEBPILOT_FLOW.md`): DOM observe with shadow roots, viewport JPEG, one JSON action per step, then click / type / select / navigate. See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) and [HOW_TO_USE.md](HOW_TO_USE.md).
+
+## Install
+
+OpenTUI needs **Bun 1.3+**. Node cannot load the native renderer.
+
+The CLI is published on **npm** as `@capagents/webpilot` (the unscoped name is too close to an existing package). **PyPI** package `webpilot-cli` is a pip launcher for the same `webpilot` command (`webpilot` is already another project on PyPI).
+
+```bash
+curl -fsSL https://bun.sh/install | bash
+
+# npm
+npm install -g @capagents/webpilot
+npx @capagents/webpilot --help
+
+# pip (launcher; runs the npm package via bun)
+pip install webpilot-cli
+webpilot --help
+```
+
+Live browser profiles also need Chromium: `bunx playwright install chromium`. The `mock` profile does not.
+
+From this repo:
+
+```bash
+cd WebPilot
+bun install
+bun src/index.ts init
+bun src/index.ts start
+```
+
+One-shot release (same version on both registries; assumes `npm` and `twine` are already logged in):
+
+```bash
+./scripts/publish.sh           # current version
+./scripts/publish.sh 0.2.0     # bump + publish
+./scripts/publish.sh --dry-run # pack only
+```
+
+npm is published first. The pip launcher runs `bun x @capagents/webpilot@<version>`.
+
+## Configure
+
+`init` writes:
+
+| File | Purpose |
+|------|---------|
+| `webpilot.yaml` | Browser, prompts, export, active profile |
+| `llms.json` | Named LLM profiles |
+| `.env.example` | API key names |
+
+```bash
+webpilot models
+webpilot run --goal "Read the homepage" --url https://example.com --profile mock --plain
+```
+
+`mock` uses a synthetic page, writes `workflow.yaml` and `webpilot.spec.ts`, and does not call a model. Switch `llm.active` to `azure-gpt4o` or `openai-gpt4o` for a real browser run.
+
+## CLI
+
+```bash
+webpilot start
+webpilot start -u https://example.com -g "Find the documentation link" -p openai-gpt4o
+
+webpilot run --goal "Get a quote" --url https://example.com --profile azure-gpt4o --headed
+webpilot run --goal "..." --url https://example.com --profile mock --plain --out ./out/demo
+```
+
+Inside the shell: `/url`, `/goal`, `/run`, `/stop`, `/headed`, `/steps`, `/profile`, `/export`, `/exit`. A line without a slash sets the goal and starts when a URL is known.

webpilot_cli-0.1.0/py/webpilot_cli/__init__.py

@@ -0,0 +1,7 @@
+"""pip launcher for the WebPilot CLI.
+
+The agent itself is the npm package ``@capagents/webpilot`` (OpenTUI + Bun).
+This distribution only puts a ``webpilot`` command on PATH.
+"""
+
+__version__ = "0.1.0"

webpilot_cli-0.1.0/py/webpilot_cli/__main__.py

@@ -0,0 +1,3 @@
+from webpilot_cli.launcher import main
+
+main()

webpilot_cli-0.1.0/py/webpilot_cli/launcher.py

@@ -0,0 +1,67 @@
+from __future__ import annotations
+
+import os
+import shutil
+import sys
+from pathlib import Path
+
+from webpilot_cli import __version__
+
+NPM_PACKAGE = "@capagents/webpilot"
+
+
+class LaunchError(Exception):
+    pass
+
+
+def find_bun() -> str | None:
+    if os.environ.get("WEBPILOT_BUN"):
+        explicit = os.environ["WEBPILOT_BUN"]
+        if Path(explicit).is_file() or shutil.which(explicit):
+            return explicit
+    found = shutil.which("bun")
+    if found:
+        return found
+    home = os.environ.get("HOME") or os.environ.get("USERPROFILE") or ""
+    if home:
+        candidate = Path(home) / ".bun" / "bin" / "bun"
+        if candidate.is_file():
+            return str(candidate)
+    return None
+
+
+def find_checkout_entry() -> Path | None:
+    """Repo layout is <root>/py/webpilot_cli/launcher.py. Wheels do not match."""
+    root = Path(__file__).resolve().parents[2]
+    entry = root / "src" / "index.ts"
+    package_json = root / "package.json"
+    if entry.is_file() and package_json.is_file():
+        return entry
+    return None
+
+
+def resolve_launch(args: list[str]) -> list[str]:
+    bun = find_bun()
+    if not bun:
+        raise LaunchError(
+            "webpilot needs Bun 1.3 or newer.\n"
+            "  curl -fsSL https://bun.sh/install | bash"
+        )
+    if os.environ.get("WEBPILOT_FROM_REGISTRY") == "1":
+        entry = None
+    else:
+        entry = find_checkout_entry()
+    if entry is not None:
+        return [bun, str(entry), *args]
+    return [bun, "x", f"{NPM_PACKAGE}@{__version__}", *args]
+
+
+def main() -> None:
+    try:
+        cmd = resolve_launch(sys.argv[1:])
+    except LaunchError as exc:
+        print(str(exc), file=sys.stderr)
+        raise SystemExit(1) from exc
+    bindir = str(Path(cmd[0]).parent)
+    os.environ["PATH"] = bindir + os.pathsep + os.environ.get("PATH", "")
+    os.execv(cmd[0], cmd)

webpilot_cli-0.1.0/py/webpilot_cli.egg-info/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: webpilot-cli
+Version: 0.1.0
+Summary: pip launcher for the WebPilot browser agent (npm package: @capagents/webpilot)
+Author: CLI-Agents
+License: MIT
+Keywords: webpilot,browser,agent,cli,opentui
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+
+# WebPilot
+
+Self-contained browser agent: OODA loop (observe → orient → decide → act) → Playwright spec.
+
+No FastAPI or database. LLM profiles live in `llms.json`, agent settings in `webpilot.yaml`. The interactive shell is [OpenTUI](https://opentui.com). Headless `run` is for CI.
+
+The loop matches the WebPilot design in test-agent-nexus (`backend/docs/WEBPILOT_FLOW.md`): DOM observe with shadow roots, viewport JPEG, one JSON action per step, then click / type / select / navigate. See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) and [HOW_TO_USE.md](HOW_TO_USE.md).
+
+## Install
+
+OpenTUI needs **Bun 1.3+**. Node cannot load the native renderer.
+
+The CLI is published on **npm** as `@capagents/webpilot` (the unscoped name is too close to an existing package). **PyPI** package `webpilot-cli` is a pip launcher for the same `webpilot` command (`webpilot` is already another project on PyPI).
+
+```bash
+curl -fsSL https://bun.sh/install | bash
+
+# npm
+npm install -g @capagents/webpilot
+npx @capagents/webpilot --help
+
+# pip (launcher; runs the npm package via bun)
+pip install webpilot-cli
+webpilot --help
+```
+
+Live browser profiles also need Chromium: `bunx playwright install chromium`. The `mock` profile does not.
+
+From this repo:
+
+```bash
+cd WebPilot
+bun install
+bun src/index.ts init
+bun src/index.ts start
+```
+
+One-shot release (same version on both registries; assumes `npm` and `twine` are already logged in):
+
+```bash
+./scripts/publish.sh           # current version
+./scripts/publish.sh 0.2.0     # bump + publish
+./scripts/publish.sh --dry-run # pack only
+```
+
+npm is published first. The pip launcher runs `bun x @capagents/webpilot@<version>`.
+
+## Configure
+
+`init` writes:
+
+| File | Purpose |
+|------|---------|
+| `webpilot.yaml` | Browser, prompts, export, active profile |
+| `llms.json` | Named LLM profiles |
+| `.env.example` | API key names |
+
+```bash
+webpilot models
+webpilot run --goal "Read the homepage" --url https://example.com --profile mock --plain
+```
+
+`mock` uses a synthetic page, writes `workflow.yaml` and `webpilot.spec.ts`, and does not call a model. Switch `llm.active` to `azure-gpt4o` or `openai-gpt4o` for a real browser run.
+
+## CLI
+
+```bash
+webpilot start
+webpilot start -u https://example.com -g "Find the documentation link" -p openai-gpt4o
+
+webpilot run --goal "Get a quote" --url https://example.com --profile azure-gpt4o --headed
+webpilot run --goal "..." --url https://example.com --profile mock --plain --out ./out/demo
+```
+
+Inside the shell: `/url`, `/goal`, `/run`, `/stop`, `/headed`, `/steps`, `/profile`, `/export`, `/exit`. A line without a slash sets the goal and starts when a URL is known.

webpilot_cli-0.1.0/py/webpilot_cli.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+py/webpilot_cli/__init__.py
+py/webpilot_cli/__main__.py
+py/webpilot_cli/launcher.py
+py/webpilot_cli.egg-info/PKG-INFO
+py/webpilot_cli.egg-info/SOURCES.txt
+py/webpilot_cli.egg-info/dependency_links.txt
+py/webpilot_cli.egg-info/entry_points.txt
+py/webpilot_cli.egg-info/requires.txt
+py/webpilot_cli.egg-info/top_level.txt

webpilot_cli-0.1.0/py/webpilot_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

webpilot_cli-0.1.0/py/webpilot_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+webpilot = webpilot_cli.launcher:main

webpilot_cli-0.1.0/py/webpilot_cli.egg-info/requires.txt

@@ -0,0 +1,3 @@
+
+[dev]
+pytest>=8.0

webpilot_cli-0.1.0/py/webpilot_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+webpilot_cli

webpilot_cli-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "webpilot-cli"
+version = "0.1.0"
+description = "pip launcher for the WebPilot browser agent (npm package: @capagents/webpilot)"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "CLI-Agents" }]
+keywords = ["webpilot", "browser", "agent", "cli", "opentui"]
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0"]
+
+[project.scripts]
+webpilot = "webpilot_cli.launcher:main"
+
+[tool.setuptools.packages.find]
+where = ["py"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests/python"]
+pythonpath = ["py"]

webpilot_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+