Concepts¶
How OpenAdapt works: what a demonstration compiler is, how a compiled workflow resolves and verifies each step, and how safety is enforced. Read in order, or jump to what you need.
-
Why compile a demonstration instead of re-reasoning through it. The record, compile, replay loop.
-
How one runner contract routes work across browser, native Windows, native macOS, native Linux, RDP, and Citrix/VDI.
-
Hosted browser launch, customer-controlled execution, self-hosting, and the authoring-versus-runtime data boundary.
-
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.
-
How the identity ladder distinguishes records and refuses ambiguous input.
-
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 compiled workflow uses these elements to express the intended work. -
How several demonstrations provide enough evidence to recover a more complete program.
-
Demonstrate a correction, compile it, and pass it through regression and promotion gates before the workflow uses it.
-
Checkpoint verified progress; a halt becomes a durable pause an operator approves and resumes, never re-running a confirmed write.
-
lintreports gaps,certifyrefuses an unsafe bundle before it deploys. -
The program map, live evidence, a composed parent, and a process parent.
-
A parent receipt over independently admitted capabilities. Handoffs copy effect facts. Compose sequences recordings; process points at admissions.
-
Browser (Playwright), native Windows (UIA), native macOS, native Linux (AT-SPI), RDP, and Citrix/VDI use one backend protocol. Each surface uses the same bundle, identity, result, and policy contracts. Each workflow is qualified in its real environment.
-
Optional local grounding and identity. When deployed on-prem, observations remain inside that declared customer boundary.