binding

Binding

Binding is the durable connection between an Automation and a Widget:

Automation artifact -> Widget.slots.main
Widget.events.submit -> Automation input

Binding.create validates and attaches the connection. It does not run the Automation or display the Widget.

Create

Before creating:

1. Automation uses result.kind: "artifact" with an object schema.
2. Widget declares slots.main.kind: "json" with an object schema compatible with the Automation artifact.
3. If Widget declares events.submit, its schema is compatible with the Automation input contract.
4. Widget index.html exists and validates.

{
  "action": "create",
  "kind": "automation_widget",
  "automationId": "automation_generated",
  "widgetId": "widget_generated"
}

A Widget has one active main Binding at Widget.bindings.main. Creating another Binding for the same Widget makes the new Binding active. The previous Binding becomes invalid with a superseded validation issue, and its deliveries cannot overwrite Widget.latestData.main.

Status

• pending_run: schemas and render checks pass, but no current artifact has been delivered through this Binding.
• valid: contracts pass and current artifact/render evidence is valid.
• invalid: one or more validation issues require repair.

Binding artifact validation uses Automation.latestArtifactRunId.

Automatic Revalidation

Automation.update and Widget.update revalidate related Bindings. Inspect revalidatedBindings in the update response before running or enabling automatic work.

Writing index.html or another Widget workspace resource does not call Widget.update, so it does not automatically revalidate the active Binding. After page or resource changes, call Widget.validate, then call Binding.validate for Widget.bindings.main before running the Automation.

Common changes that require attention:

• Automation input schema changes affect events.submit compatibility.
• Automation result schema changes affect slots.main compatibility.
• Widget slot or event schema changes affect both directions.
• Widget page changes can affect render validation.