Concepts¶
These pages explain the model behind OpenAdapt: what a demonstration compiler is, how a compiled workflow resolves and verifies each step, and how safety is enforced. Read them in order for the full picture, or jump to what you need.
-
Why compile a demonstration instead of re-reasoning through it. The record, compile, replay loop.
-
Routing across web, native Windows, and pixel-only Citrix/RDP; the adapters have different maturity today.
-
Hosted browser launch, customer-controlled execution, self-hosting, and the authoring-versus-runtime data boundary.
-
Fail-closed regulated execution
replayis the local $0 dev path;runrefuses to execute unless certified, identity-covered, effect-verified, signed, and config-pinned. -
One semantic step, many implementations: structural (DOM/UIA), API, and visual. First viable rung wins.
-
The screen is not the system of record. The five silent write faults and how OpenAdapt catches them.
-
Never click the wrong record. The identity ladder and why it refuses rather than guesses.
-
Repairs under UI drift, written back as reviewable diffs, with zero model calls on the healthy path.
-
Typed parameters, guards,
wait_until, loops, branches, and subflows. A program, not a trajectory. -
One demo is evidence, not a specification. How more traces recover the intended program.
-
Halt, demonstrate the fix, induce it through a regression gate, and never halt there again. Governed, $0, no free-form agent.
-
Checkpoint verified progress; a halt becomes a durable pause an operator approves and resumes, never re-running a confirmed write.
-
Fail-closed safety:
lintreports gaps,certifyrefuses an unsafe bundle before it deploys. -
Browser (Playwright) is the supported end-to-end path. Windows UIA is experimental; pixel-only RDP and Citrix remain research. The ladder uses one backend protocol without implying equal maturity.
-
Optional local grounding and identity. When deployed on-prem, observations remain inside that declared customer boundary.