Skip to content

docs(skills): bring formio-uag to UAG 2.0.2 - #119

Merged
travist merged 2 commits into
mainfrom
docs/formio-uag-2.0.1
Nov 18, 2026
Merged

travist merged 2 commits into
mainfrom
docs/formio-uag-2.0.1

Conversation

@travist

@travist travist commented Nov 18, 2026

Copy link
Copy Markdown
Member

Summary

An audit of the formio-uag skill against UAG 2.0.1 — the UAG's source, @formio/uag-extras, @formio/appserver-core 2.26.4, the UAG's developer docs and its demo applications — so that someone who installs the plugin can build a complete agentic application from the skill. The skill was last synced at 2.0.0-rc.7.

Stale since rc.7

  • Versions resolve from latest (2.x) and are pinned exactly; the rc fallback would now install a release candidate. @formio/uag-extras / formio/uag-documents take the UAG's major (:2; :1 is the 1.0.0 built for the release candidates). @formio/appserver 2.26.4.
  • Docs links pointed at ai.form.io/developers and /examples; ai.form.io is now the demo's UAG. They now point at the UAG repository's docs and https://formio.github.io/uag/examples.

Wrong, and would have produced broken applications

  • uag-js.md said to render uag forms by URL; routing actually keys on a definition loaded through the SDK from the form's URL and saved through a Formio instance for the same URL. A fetch save silently skips every Run task.
  • A chained Run task must run after the save; answer: "task" re-decides filled and hidden decision fields; the agent_identity error code.
  • Only uag applies inside a container — uagAuthoritative and the decision settings go on each field — and an authoritative field must not be required or one a person confirms.
  • Smaller corrections: the Anthropic MCP connector takes a token, not OAuth; session lifetime; the 401 sign_in_required message; UAG.attach() defaults to blur on wizards; /agent/capabilities cannot be called from a page; a chat confirmed by typing submits itself.

Missing

  • New references/ai-document.md: component JSON (settings in a top-level uag object, files / result children), processes and settings, target field, events, result, process route, scanned-paper-form pattern.
  • Open Source: this library's project_set refuses an Open Source URL, so the skill now says so and writes files instead.
  • Caller identity and public forms; React/Angular snippets for attaching Agent Input; generating a draft from a form button; showing an after-save run's result; the hosted-service Run task setup; engine settings and Claude model compatibility; engine server settings; AUTHORIZE_HTML; PORTAL_SECRET; the AI Document deploy kit; rc.11 troubleshooting rows.

Licensing text is unchanged.

Related: formio/uag#67 fixes a uag-js bug found in this audit (an Enterprise or hosted UAG did not answer GET /plugins at its root, so a bundled app's plugin manifest was empty) and corrects the UAG's own docs. ai-document.md tells apps on 2.0.1 to load uag.use.js until that ships.

The skill's description is unchanged, so the routing eval was not rerun. The rc.7 changeset is still unreleased; the new changeset says where it supersedes it.

Test plan

  • pnpm test (skill-tests 1677, mcp 1939)
  • pnpm lint, pnpm format
  • New structure tests: no rc channel, appserver 2.26.4, no formio/uag-documents:1, no ai.form.io docs links, chained runs after the save, container properties; ai-document.md registered as a reference

🤖 Generated with Claude Code

travist and others added 2 commits November 18, 2026 08:33
Audited against the UAG's source (and @formio/uag-extras and
@formio/appserver-core), its developer docs and its demo applications.

- Versions: resolve every package from latest (2.x) and pin it; drop the
  rc fallback. @formio/uag-extras and formio/uag-documents take the UAG's
  major (:2). @formio/appserver 2.26.4. Docs links point at the UAG
  repository and the examples catalog, not ai.form.io.
- New references/ai-document.md: the component JSON, processes and their
  settings, target field, events, result, process route, and filling a
  form from a scanned paper form.
- uag-js: how a save is routed to the UAG (a definition loaded through
  the SDK from its form URL), React and Angular attach snippets, the
  attach() trigger default, values set by the application.
- SKILL.md: the caller's identity and public forms; Open Source cannot be
  written by this library's tools.
- workflows: chained runs after the save, uagAuthoritative per field and
  never on required or person-confirmed fields, the hosted-service setup,
  showing a run's result, agent_identity.
- Corrections across chat-widget, mcp-clients, agent-api, deployment and
  troubleshooting.
- Tests guard the rc channel, the appserver minimum, the uag-documents
  tag, the docs links, chained runs and container properties.
- examples/agents: the demos' new home, and a non-required
  authoritative claim type.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@travist travist changed the title docs(skills): bring formio-uag to UAG 2.0.1 docs(skills): bring formio-uag to UAG 2.0.2 Nov 18, 2026
@travist

travist commented Nov 18, 2026

Copy link
Copy Markdown
Member Author

UAG 2.0.2 shipped the root /plugins fix (formio/uag#67). f328f4a updates the AI Document note to say "upgrade to 2.0.2 or later" and the changeset to name 2.0.2. Nothing else in the skill pins a patch version: it resolves latest (now 2.0.2) and pins whatever it finds.

@travist
travist merged commit 1d4701b into main Nov 18, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant