For AI agents: the complete documentation index is available at https://a3s-lab.github.io/Test/v0.15.0/en/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/Test/v0.15.0/en/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/Test/v0.15.0/en/guide/workflows.md.

v0.15.0 workflows

Historical snapshot

This page freezes v0.15.0 behavior. Its action protocol does not include selection-scoped insert_text, added in v0.16.0.

External-planner agent sessions

The calling coding agent observes current state and selects one action. A3S Test validates schema, capability, provenance, and policy. The driver executes only admitted actions, and state changes invalidate stale refs.

a3s-test agent start <url> --session <name> --goal <goal> --success <condition>
a3s-test agent observe --session <name> --interactive --json
a3s-test agent click <ref> --session <name> --observation <id> --json
a3s-test agent finish --session <name> --status passed --summary <text> --json

Deterministic ACL

suite "smoke" {
    version = 1

    scenario "home" {
        name = "Open home"
        surface = "web"
        timeout_ms = 30000

        navigate "open" { url = "https://example.com" }
        expect "heading" { text = "Example Domain" }
    }
}
a3s-test check smoke.acl --json
a3s-test run smoke.acl --json

Agent sessions and ACL share typed Action, SurfaceDriver, evidence, result, and lifecycle contracts. A deployment-owned embedded LLM provider may advise actions, but cannot decide a verdict, fabricate observation, or authorize repair.