universal_automation_interface 0.2.0

Pure-Dart contracts for the universal automation family: endpoints, session handles, drivers, actions, snapshots, fail-closed specs, and structured events. No Flutter, no protocol clients.

Changelog

0.2.0

• Surface action catalog (the InvokeAction tier): the dynamic-registry shape for drivers — framework- and app-specific verbs no longer require growing the universal verb set.
  • New sealed InvokeAction(name, args): invoke a named action the surface under test registered for automation.
  • New SurfaceActionDescriptor (name, description, JSON-Schema-subset inputSchema carried as plain data — the family depends on no schema library) and the opt-in AutomationActionCatalog interface (actions()); implementing it is non-breaking.
  • CdpDriver implements the catalog over the page's window.__mcpActions registry, so any web surface (Jaspr, plain JS, Flutter web) composes named, async handlers; new CdpPage.evaluateAsync awaits Promise results and surfaces JS rejections instead of silent undefined.
  • WebDriver, AT-SPI, UIA, and AX drivers refuse InvokeAction loudly — those tiers have no surface action registry.
  • Breaking: exhaustive switches over AutomationAction must handle InvokeAction (all family drivers do; behavioral synthesis refuses it — catalog actions carry their own dispatch).
• Behavior dynamics contract (ADR 0044): declarative, composable input profiles for humans and agents.
  • New behavior module: BehaviorStep timed input-step vocabulary, BehaviorPlan, BehaviorProfile (facets: ActionRhythm, ReactionDelay, SessionPacing, PointerMotion, KeystrokeCadence), priors (agentImmediate degenerate profile, humanPrior(seed) hyper-prior), synthesizeBehavior/projectBehavior deterministic synthesis, auditBehavior self-consistency reporting, BehaviorReceipts encoders, canonical JSON + SHA-256 hashing, and the pinned xoshiro128**/splitmix32 PRNG.
  • New BehavioralDriver opt-in capability surface (performWith with typed BehaviorOutcome), ProfiledDriver wrapper, and DriverCapabilities.behaviorDynamics (default false; full sets it).
  • Breaking: DriverCapabilities.full now sets behaviorDynamics: true; drivers claiming full without implementing BehavioralDriver should declare an explicit capability set instead.