Files
copilotkit__copilotkit/showcase/aimock/d6/langgraph-fastapi/a2ui-recovery.json
Ran Shem Tov b985449e50 feat(showcase): add A2UI Error Recovery demo for langgraph + strands
Port the google-adk a2ui-recovery demo to langgraph (python, fastapi,
typescript) and aws-strands (python, typescript). Each ships a dedicated
recovery agent, route, demo page/chat/suggestions, manifest entry, aimock
d6 fixtures, e2e spec, and QA doc.

Backend-owned recovery on langgraph via get_a2ui_tools / getA2UITools
(injectA2UITool=false); auto-inject recovery on the strands adapter path.
Heal stages an invalid-then-valid render via aimock sequenceIndex (the
toolkit validate->retry loop rejects the whole surface, so a single-pass
parse_and_fix heal is ADK-specific and does not apply here). Recovery
prompts are unique per framework and the fixtures carry no context match
field, so they fire for real browser (dojo) traffic, not just the harness.

Also harden the strands declarative-gen-ui composition guide to name the
exact catalog component (Metric, not MetricTile) and update the
generate-catalog + aimock-fixtures test expectations.
2026-06-26 16:17:58 +02:00

115 lines
4.3 KiB
JSON

{
"_meta": {
"description": "D6 fixtures for langgraph-fastapi / a2ui-recovery (A2UI error recovery)",
"_note": "Backend-owned A2UI (get_a2ui_tools, injectA2UITool=false). NO `context` match field: a real browser (the dojo) does not send x-aimock-context, so context-scoped fixtures would 404 in-browser; the recovery pills' prompts are UNIQUE per framework, so userMessage alone disambiguates. HEAL: seq 0 invalid -> retry -> seq 1 valid -> paints. EXHAUST: invalid every attempt -> exhausts. Mirrors langgraph-python/a2ui-recovery.json.",
"created": "2026-06-26"
},
"fixtures": [
{
"_comment": "HEAL pill - inner render_a2ui attempt 1 (sequenceIndex 0): INVALID (dangling child) -> retry.",
"match": {
"userMessage": "Put together a quarterly metrics overview and repair a malformed first attempt.",
"toolName": "render_a2ui",
"sequenceIndex": 0
},
"response": {
"toolCalls": [
{
"id": "call_d6_fa_recover_heal_bad",
"name": "render_a2ui",
"arguments": "{\"surfaceId\": \"recovery-demo\", \"catalogId\": \"declarative-gen-ui-catalog\", \"components\": [{\"id\": \"root\", \"component\": \"Column\", \"gap\": 16, \"children\": [\"missing-metric\"]}]}"
}
]
},
"chunkSize": 9999
},
{
"_comment": "HEAL pill - inner render_a2ui attempt 2 (sequenceIndex 1): VALID surface -> paints (declarative-metric x2).",
"match": {
"userMessage": "Put together a quarterly metrics overview and repair a malformed first attempt.",
"toolName": "render_a2ui",
"sequenceIndex": 1
},
"response": {
"toolCalls": [
{
"id": "call_d6_fa_recover_heal_good",
"name": "render_a2ui",
"arguments": "{\"surfaceId\": \"recovery-demo\", \"catalogId\": \"declarative-gen-ui-catalog\", \"components\": [{\"id\": \"root\", \"component\": \"Column\", \"gap\": 16, \"children\": [\"m1\", \"m2\"]}, {\"id\": \"m1\", \"component\": \"Metric\", \"label\": \"Quarterly Revenue\", \"value\": \"$4.2M\", \"trend\": \"up\", \"trendValue\": \"+12% QoQ\"}, {\"id\": \"m2\", \"component\": \"Metric\", \"label\": \"Win Rate\", \"value\": \"31%\", \"trend\": \"down\", \"trendValue\": \"-2 pts\"}], \"data\": {}}"
}
]
},
"chunkSize": 9999
},
{
"_comment": "HEAL pill - outer narration (matched by the emit's unique toolCallId).",
"match": {
"toolCallId": "call_d6_fa_recover_heal_outer_001"
},
"response": {
"content": "The first render came back malformed - I recovered and painted your metrics overview."
},
"chunkSize": 9999
},
{
"_comment": "HEAL pill - outer agent emits generate_a2ui (matched by the unique prompt).",
"match": {
"userMessage": "Put together a quarterly metrics overview and repair a malformed first attempt."
},
"response": {
"toolCalls": [
{
"id": "call_d6_fa_recover_heal_outer_001",
"name": "generate_a2ui",
"arguments": "{\"intent\": \"create\"}"
}
]
},
"chunkSize": 9999
},
{
"_comment": "EXHAUST pill - inner render_a2ui: INVALID on every attempt -> recovery exhausts.",
"match": {
"userMessage": "Put together an overview whose every render is invalid so I can see the fallback.",
"toolName": "render_a2ui"
},
"response": {
"toolCalls": [
{
"id": "call_d6_fa_recover_exhaust_design",
"name": "render_a2ui",
"arguments": "{\"surfaceId\": \"recovery-demo-fail\", \"catalogId\": \"declarative-gen-ui-catalog\", \"components\": [{\"id\": \"root\", \"component\": \"Column\", \"gap\": 16, \"children\": [\"never-defined\"]}]}"
}
]
},
"chunkSize": 9999
},
{
"_comment": "EXHAUST pill - outer narration (matched by the emit's unique toolCallId).",
"match": {
"toolCallId": "call_d6_fa_recover_exhaust_outer_001"
},
"response": {
"content": "I couldn't produce a valid surface after several attempts - showing a graceful fallback instead."
},
"chunkSize": 9999
},
{
"_comment": "EXHAUST pill - outer agent emits generate_a2ui (matched by the unique prompt).",
"match": {
"userMessage": "Put together an overview whose every render is invalid so I can see the fallback."
},
"response": {
"toolCalls": [
{
"id": "call_d6_fa_recover_exhaust_outer_001",
"name": "generate_a2ui",
"arguments": "{\"intent\": \"create\"}"
}
]
},
"chunkSize": 9999
}
]
}