Documentation v1.24
Last updated 2026-08-20 Give feedback

MagicFill

The host built-in browser analyzes the page; MagicFill only materializes and applies exact protected values and one exact final click.

  • No navigation, observation, page analysis, search, or challenge handling.
  • Resolves exact value-free targets before protected materialization.
  • Returns only target identifiers and opaque receipts.
  • Works behind thin Codex, Claude, OpenClaw, Hermes, and future host adapters.
Host browser to MagicFill contract

One Page-Control Owner

The current agent runtime built-in browser owns navigation, observation, form analysis, ordinary values, exact target selection, and result interpretation. MagicFill never starts or controls a browser.

Exact Protected Actuation

The host browser supplies one stable document identity and closed exact target contracts. MagicFill resolves every target first, then materializes and applies approved protected values without exposing them to the host agent.

TypeScript
const { fillResolvedTargets } = await import('./scripts/magicfill-browser.mjs'); const result = await fillResolvedTargets({  actuator: hostActuator,  page,  fields: resolvedProtectedFields,});

Value-Free Receipts

Fill and click results contain target identifiers, status, and opaque authority only. The host browser observes the page again and decides what the result means.

Generic Host Contract

Codex App has the concrete acceptance adapter. Claude, OpenClaw, Hermes, and future hosts implement the same narrow actuator interface and become supported only after passing the real form matrix.

MagicPay public documentation.