@ag-ui/a2ui-toolkit
Framework-agnostic helpers for building A2UI subagent tools.
Each per-framework adapter (LangGraph, ADK, Mastra, …) composes these helpers
with its own framework-specific glue: tool decorator, runtime accessor, model
binding + invoke. Nothing in this package depends on any agent framework.
Surface
- Constants:
A2UI_OPERATIONS_KEY, BASIC_CATALOG_ID, DEFAULT_SURFACE_ID,
GENERATE_A2UI_TOOL_NAME, GENERATE_A2UI_TOOL_DESCRIPTION,
GENERATE_A2UI_ARG_DESCRIPTIONS
- Op builders:
createSurface, updateComponents, updateDataModel
RENDER_A2UI_TOOL_DEF — JSON schema for the inner structured-output tool
- State + history helpers:
buildContextPrompt, findPriorSurface
- Prompt composer:
buildSubagentPrompt
- High-level orchestration:
prepareA2UIRequest, buildA2UIEnvelope
- Output wrappers:
assembleOps, wrapAsOperationsEnvelope, wrapErrorEnvelope
See also
The Python counterpart lives in
ag-ui-a2ui-toolkit and exposes the same
surface in snake_case.