v1.4.3.1 — Recorder fix, replay UI, security fixes

Phantom Bridge v1.4.3.1

install.sh SHA256 (for verification)

ad80663d2c5463222eac5f74798d441e243456d1c59fd816dcc9a58eee35602d  install.sh

Verify before running:

curl -fsSL https://raw.githubusercontent.com/notabotchef/phantom-bridge/v1.4.3.1/install.sh -o install.sh
echo "ad80663d2c5463222eac5f74798d441e243456d1c59fd816dcc9a58eee35602d  install.sh" | sha256sum --check
bash install.sh

Prefer the Quick Start? It's safer — no script needed:

curl -O https://raw.githubusercontent.com/notabotchef/phantom-bridge/main/docker-compose.override.yml
docker compose up -d

What's Changed

• fix: recorder CDP reconnect, replay UI, system prompt, install UX by @notabotchef in #8
• chore: v1.4.3.1 — recorder fix, replay UI, security fixes by @notabotchef in #9

Full Changelog: v1.4.3...v1.4.3.1

v1.4.3 — Canonical A0 plugin install (fixes broken v1.4.0–v1.4.2)

Phantom Bridge v1.4.3

install.sh SHA256 (for verification)

ad80663d2c5463222eac5f74798d441e243456d1c59fd816dcc9a58eee35602d  install.sh

Verify before running:

curl -fsSL https://raw.githubusercontent.com/notabotchef/phantom-bridge/v1.4.3/install.sh -o install.sh
echo "ad80663d2c5463222eac5f74798d441e243456d1c59fd816dcc9a58eee35602d  install.sh" | sha256sum --check
bash install.sh

Prefer the Quick Start? It's safer — no script needed:

curl -O https://raw.githubusercontent.com/notabotchef/phantom-bridge/main/docker-compose.override.yml
docker compose up -d

What's Changed

• fix(install): revert prebuilt image, use canonical A0 plugin pattern (v1.4.3) by @notabotchef in #7

Full Changelog: v1.4.2...v1.4.3

v1.4.2 — Dockerfile pip hotfix

This release has a broken install path. The prebuilt Docker image was never published successfully. Use v1.4.3 instead.

Phantom Bridge v1.4.2

install.sh SHA256 (for verification)

ad80663d2c5463222eac5f74798d441e243456d1c59fd816dcc9a58eee35602d  install.sh

Verify before running:

curl -fsSL https://raw.githubusercontent.com/notabotchef/phantom-bridge/v1.4.2/install.sh -o install.sh
echo "ad80663d2c5463222eac5f74798d441e243456d1c59fd816dcc9a58eee35602d  install.sh" | sha256sum --check
bash install.sh

Prefer the Quick Start? It's safer — no script needed:

curl -O https://raw.githubusercontent.com/notabotchef/phantom-bridge/main/docker-compose.override.yml
docker compose up -d

What's Changed

• docs: trim README What's New to current versions by @notabotchef in #4
• fix(docker): use python3 -m pip — v1.4.2 hotfix by @notabotchef in #5

Full Changelog: v1.4.1...v1.4.2

v1.4.1 — One-liner Installer (opt-in)

This release has a broken install path. The prebuilt Docker image was never published successfully. Use v1.4.3 instead.

Phantom Bridge v1.4.1

install.sh SHA256 (for verification)

ad80663d2c5463222eac5f74798d441e243456d1c59fd816dcc9a58eee35602d  install.sh

Verify before running:

curl -fsSL https://raw.githubusercontent.com/notabotchef/phantom-bridge/v1.4.1/install.sh -o install.sh
echo "ad80663d2c5463222eac5f74798d441e243456d1c59fd816dcc9a58eee35602d  install.sh" | sha256sum --check
bash install.sh

Prefer the Quick Start? It's safer — no script needed:

curl -O https://raw.githubusercontent.com/notabotchef/phantom-bridge/main/docker-compose.override.yml
docker compose up -d

What's Changed

• feat: v1.4.1 — one-liner installer (opt-in, SHA-pinned) by @notabotchef in #3

Full Changelog: v1.4.0...v1.4.1

v1.4.0 — Prebuilt Smart Docker Image

This release has a broken install path. The prebuilt Docker image was never published successfully. Use v1.4.3 instead.

Highlights

• Prebuilt image — ghcr.io/notabotchef/phantom-bridge:latest. Multi-arch (amd64 + arm64). All deps baked in.
• Smart entrypoint — preserves your git pull workflow if you have a clone mounted; bakes from /opt/phantom_bridge_baked/ otherwise.
• Drop-in override — docker-compose.override.yml next to your existing compose, auto-merged. Never touches your original.
• GitHub Actions multi-arch publish — on v* tag and main push.

Quick Start (now 3 commands)

curl -O https://raw.githubusercontent.com/notabotchef/phantom-bridge/main/docker-compose.override.yml
docker compose up -d
open http://localhost:5050

That's it. No apt-get, no pip install, no execute.py.

Different noVNC port? Set PHANTOM_NOVNC_PORT=6081 in your .env before docker compose up -d.

Upgrade from v1.3.0

If you previously installed via git clone + execute.py, you can either:

1. Stay on the manual flow — your install keeps working; the smart entrypoint detects your mount and skips the baked copy
2. Switch to the override flow — drop the docker-compose.override.yml next to your compose file and docker compose up -d

Files

8 files changed, 311 insertions(+), 8 deletions(-). New: Dockerfile, docker-entrypoint-phantom.sh, docker-compose.override.yml, .dockerignore, .github/workflows/docker-publish.yml. Modified: README.md, plugin.yaml.

Tests

python -m pytest tests/test_probe_novnc.py — 7/7 pass (no regression). Image build verification pending — first tag push triggers docker-publish.yml.

Phase 2 of 3. Depends on v1.3.0. v1.4.1 (one-liner installer) is next.

v1.3.0 — Diagnostics & Pre-flight

Highlights

• bridge_doctor tool — 5-check diagnostic with copy-paste fix commands per failure. --quiet mode for healthchecks.
• Pre-flight in bridge_open — probe_novnc() checks the noVNC endpoint and surfaces actionable hints; never blocks startup.
• State-aware WebUI — sidebar banner shows fix hint when health_state != healthy.
• Verified execute.py — re-checks that x11vnc and websockify landed on PATH after apt-get install.
• HealthState enum + probe_novnc() helper in bridge.py. Stdlib only. 2-second budget. Distinguishes PORT_UNMAPPED from NOVNC_UNREACHABLE.

Why

Discussion #146: silent blank-viewer failures with no actionable error.

Upgrade

cd /path/to/a0/usr/plugins/phantom_bridge
git pull
docker exec -it a0 python /a0/usr/plugins/phantom_bridge/execute.py

Or wait for v1.4.0 (prebuilt Docker image) — much cleaner upgrade path.

Files

10 files changed, 673 insertions(+), 7 deletions(-). New: tools/bridge_doctor.py, tests/test_probe_novnc.py. Modified: bridge.py, tools/bridge_open.py, execute.py, api/bridge.py, webui/main.html, webui/phantom-bridge-store.js, plugin.yaml, README.md.

Tests

python -m pytest tests/test_probe_novnc.py — 7/7 pass.

Phase 1 of 3 — see PRs #1 (this), v1.4.0, v1.4.1.

v1.2.1

• Centralized data path resolution — All persistent data paths (cookies, playbooks, sitemaps, auth registry, profile) now resolve through a single data_paths.py module. Supports PHANTOM_BRIDGE_DATA_DIR environment variable to relocate the entire data tree (e.g., to a mounted volume).

v1.2.0

• Robust playbook replay — Recorded playbooks capture multiple locator strategies per step (CSS, visible text, ARIA role, aria-label, placeholder, label text, input type). Replay engine falls back through alternatives when exact selectors break.
• Agent-guided instructions — New Playbook.to_agent_instructions() generates natural-language workflow descriptions with prioritized locator hints.
• Recording UI — Start and stop playbook recordings directly from the sidebar panel with real-time notifications and an A0 progress bar.

v1.1.1

• WebSocket push events — Bridge status and auth events pushed to the UI in real time. No more 5-second polling.
• Self-correction error messages — Tool error paths include canonical JSON call examples so A0 v1.5 agents can fix malformed calls automatically.
• Small-model prompt — Compact ~200-token system prompt variant for models with ≤ 8192 context.
• Unicode sanitization — Page titles and DOM events sanitized before storage.
• Cache-Control: no-store — Bridge API responses opt out of A0 v1.5 API caching.
• Task lifecycle safety — ObserverManager.start() idempotent; stop() cancels and awaits all background tasks.
• Review fixes — Cookie files flushed when new login detected; failed CDP connect no longer permanently blocks retries.

v1.1.0

• Cookies encrypted at rest (Fernet)
• Per-domain cookie files
• New bridge_decrypt_cookies tool