Repository navigation
docs(skills): bring formio-uag to UAG 2.0.2 - #119
Merged
Merged
Conversation
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>
Member
Author
|
UAG 2.0.2 shipped the root |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
An audit of the
formio-uagskill against UAG 2.0.1 — the UAG's source,@formio/uag-extras,@formio/appserver-core2.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
latest(2.x) and are pinned exactly; thercfallback would now install a release candidate.@formio/uag-extras/formio/uag-documentstake the UAG's major (:2;:1is the 1.0.0 built for the release candidates).@formio/appserver2.26.4.ai.form.io/developersand/examples;ai.form.iois now the demo's UAG. They now point at the UAG repository's docs andhttps://formio.github.io/uag/examples.Wrong, and would have produced broken applications
uag-js.mdsaid to renderuagforms by URL; routing actually keys on a definition loaded through the SDK from the form's URL and saved through aFormioinstance for the same URL. Afetchsave silently skips every Run task.answer: "task"re-decides filled and hidden decision fields; theagent_identityerror code.uagapplies inside a container —uagAuthoritativeand the decision settings go on each field — and an authoritative field must not be required or one a person confirms.401sign_in_requiredmessage;UAG.attach()defaults tobluron wizards;/agent/capabilitiescannot be called from a page; a chat confirmed by typing submits itself.Missing
references/ai-document.md: component JSON (settings in a top-leveluagobject,files/resultchildren), processes and settings, target field, events, result, process route, scanned-paper-form pattern.project_setrefuses an Open Source URL, so the skill now says so and writes files instead.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 /pluginsat its root, so a bundled app's plugin manifest was empty) and corrects the UAG's own docs.ai-document.mdtells apps on 2.0.1 to loaduag.use.jsuntil that ships.The skill's
descriptionis 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 formatrcchannel, appserver 2.26.4, noformio/uag-documents:1, noai.form.iodocs links, chained runs after the save, container properties;ai-document.mdregistered as a reference🤖 Generated with Claude Code