Skip to content

docs(blog): human-in-the-loop AG-UI agents in Angular#571

Merged
blove merged 9 commits into
mainfrom
claude/ag-ui-interrupts-blog
Jun 4, 2026
Merged

docs(blog): human-in-the-loop AG-UI agents in Angular#571
blove merged 9 commits into
mainfrom
claude/ag-ui-interrupts-blog

Conversation

@blove
Copy link
Copy Markdown
Contributor

@blove blove commented Jun 4, 2026

Summary

New blog post: apps/website/content/blog/2026-06-04-human-in-the-loop-ag-ui-agents-in-angular.mdx — a full standalone tutorial covering the AG-UI adapter's new interrupt support, distinguished from the May 28 LangGraph HITL post by the "same UI, two adapters" parity angle.

  • The Angular component is byte-identical between the two adapter examples except the injectAgent import. The post shows the literal diff and walks why the runtime-neutral Agent contract makes that true.
  • Covers the AG-UI-specific wire details: the CUSTOM on_interrupt event, ag-ui-langgraph's dump_json_safe JSON-string value (the adapter parses it for you), forwardedProps.command.resume, and MemorySaver being mandatory for plain uvicorn (since langgraph dev injects one but uvicorn doesn't).
  • Walks the standalone backend pattern — duplicated graph + uvicorn FastAPI app wrapped with ag-ui-langgraph, with a /ok health route — and the Angular swap (provideAgent({ url }) + proxy → uvicorn).
  • All code blocks are verbatim from cockpit/ag-ui/interrupts source (graph.py extract, server.py, app.config.ts, proxy.conf.mjs, interrupts.component.ts).
  • Three <figure> placeholders at the precedent post's matching beats. PNG captures are a deliberate follow-up step (the post ships with descriptive alt text + figcaptions; editor fills in screenshots before publish).

Design spec: docs/superpowers/specs/2026-06-04-ag-ui-interrupts-blog-post-design.md
Implementation plan: docs/superpowers/plans/2026-06-04-ag-ui-interrupts-blog-post.md

Test Plan

  • All four embedded code blocks (server.py, app.config.ts, proxy.conf.mjs, interrupts.component.ts) byte-identical to cockpit/ag-ui/interrupts source — verified by diff.
  • Every load-bearing technical claim source-verifiable: on_interrupt event, dump_json_safe serialization, MemorySaver mandatory for uvicorn, forwarded_props.command.resume server read, reducer parses string value, submit({ resume }) calls runAgent({ forwardedProps: ... }).
  • Voice gate: no anecdotes fabricated for Brian, no emojis, trimmed technical register matching the precedent post.
  • Frontmatter present and matches the precedent shape (date 2026-06-04, tags, author brian, featured true, no backticks in description).
  • All internal links resolve to existing routes (/blog/2026-05-28-…, /blog/2026-05-21-…, /docs/ag-ui/guides/interrupts, /docs/choosing-an-adapter).
  • Nav auto-discovery confirmed (no manual blog registry exists; .mdx files are picked up automatically).
  • Image PNGs captured from the running cockpit example and committed at apps/website/public/blog/2026-06-04-human-in-the-loop-ag-ui-agents-in-angular/{1,2,3}.png before publish. (Deliberate follow-up.)

🤖 Generated with Claude Code

blove and others added 9 commits June 4, 2026 10:22
Cross-adapter parity angle ("same UI, two adapters"): a full-length
standalone tutorial covering the new ag-ui interrupt support, mirroring
Brian's 2026-05-28 LangGraph HITL post structure but distinguishing on
the byte-identical-component-except-the-import claim. Covers AG-UI
wire specifics (CUSTOM on_interrupt, dump_json_safe JSON-string value,
forwardedProps.command.resume) and the ag-ui-langgraph + uvicorn
MemorySaver infra detail. Voice matches feedback_blog_voice_no_anecdotes.
… hook

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…+ component)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Jun 4, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
threadplane Ready Ready Preview, Comment Jun 4, 2026 9:07pm

Request Review

@blove blove merged commit 626dd7e into main Jun 4, 2026
3 checks 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