@qf-agentic-ui/runtime

Runtime renderer for Agentic UI JSON-UI DSL.

Build

pnpm --filter @qf-agentic-ui/runtime build

Form create success mode

form.props.createSuccessMode controls the behavior after a successful Create action.

• Optional values: keep | clear
• Default: keep

Semantics:

• keep: keep current form values after successful create
• clear: reset form to initial values after successful create

Form writable field whitelist

Runtime form Create / Update now only submits fields declared by the form schema (form.props.fields).

Behavior:

• Row-to-form hydration only updates keys defined in form.props.fields
• Submit payload only includes keys defined in form.props.fields
• id and non-form keys are excluded from write payload

Why this matters:

• Prevents backend 400 caused by accidentally submitting read-only fields
• Keeps runtime form write behavior deterministic across different table schemas

Recommendation:

• Ensure all writable fields are explicitly declared in form.props.fields
• If a field should not be writable, do not include it in form.props.fields

DSL example

{
  "id": "customerForm",
  "type": "form",
  "bind": { "dataSource": "customerList" },
  "props": {
    "createSuccessMode": "clear",
    "fields": [
      { "key": "name", "title": "Customer Name", "type": "string" },
      { "key": "industry", "title": "Industry", "type": "string" }
    ]
  }
}