40 — local portals suite for autonomous browser testing

This example adds several local-only portals for testing autonomous browser work:

Every portal has a login page backed by .env, a form, a records panel, and an /api/records endpoint for verification. Chrome maps the selected *.local host to 127.0.0.1, so no /etc/hosts edit is needed.

One Prompt

./run_prompt.sh 'crm: utwórz lead "Acme z promptu NL"'

Other prompts:

./run_prompt.sh 'support: zgłoszenie "Nie działa lokalny worker"'
./run_prompt.sh 'shop: zamów produkt "URI Test Subscription" qty 3'
./run_prompt.sh 'docs: dokument "Notatka z testu lokalnej autonomii"'

Run all four:

./run_all.sh

Domain Loop Prompt

For loop testing, put the local domain directly in the prompt:

./run_loop.sh 'support.local 3 razy zgłoszenie "Nie działa worker"'

Other domains:

./run_loop.sh 'crm.local 5 razy utwórz lead "Acme Loop"'
./run_loop.sh 'shop.local 2 razy zamów produkt "URI Test Subscription" qty 3'
./run_loop.sh 'docs.local 4 razy dokument "Notatka z pętli autonomicznej"'

The loop is bounded. By default it runs 3 iterations when the prompt does not include a count, and it caps the requested count at 10. Domains must be one of the known local fixtures: crm.local, support.local, shop.local, docs.local.

What It Uses

The wrapper uses built-in urirun pieces:

python3 -m urirun.runtime.v2 compile bindings.json --out .state/local-portals.registry.json

python3 -m urirun.runtime.v2 agent run .state/local-portals.registry.json \
  --planner portal_autonomy:planner \
  --allow 'portal://**' \
  --allow-commands \
  --goal 'support: zgłoszenie "Nie działa lokalny worker"'

portal_autonomy:planner maps NL text to one typed portal://... route and payload. The handler starts the local portal server, logs in with .env, fills the form in a real local Chrome session over CDP, submits, then verifies through /api/records.

Files

• portal_server.py — local multi-portal HTTP server.
• portal_autonomy.py — NL planner + URI handlers.
• domain_loop.py — local-domain prompt parser + bounded autonomous loop over urirun run_plan.
• bindings.json — typed portal://... command routes.
• run_prompt.sh — one-prompt runner.
• run_loop.sh — one-prompt bounded loop runner for *.local domains.
• run_all.sh — smoke test for all local portals.
• .env.example — credentials and default payloads.
• test_portals.py — offline tests.

Boundary

These portals are intentionally local fixtures. They are for testing selectors, closed-loop repair, OCR, and NL-to-URI planning without external side effects.

Files

View on GitHub →