Skip to content

docs(ag-ui): six guides teach through their running examples - #1031

Merged
blove merged 17 commits into
mainfrom
blove/docs-example-first-ag-ui
Sep 6, 2026
Merged

docs(ag-ui): six guides teach through their running examples#1031
blove merged 17 commits into
mainfrom
blove/docs-example-first-ag-ui

Conversation

@blove

@blove blove commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

PR 3 of the example-first docs program (plan: docs/superpowers/plans/2026-09-06-docs-example-first-products.md, PR 3 table; spec: docs/superpowers/specs/2026-09-05-docs-example-first-content-design.md).

Pages rewritten (four were 10-line stubs): ag-ui/guides/{client-tools,interrupts,json-render,subagents,tool-views} and ag-ui/reference/event-mapping (the event table corrected row by row against the reducer, with the streaming example as the worked case).

Walkthroughs deleted: the six cockpit/ag-ui/*/python/docs/guide.md files and their generated copies; PENDING_PAGES drops the six ag-ui entries (27 remain).

Example sources: comment-only #region markers in five graphs/components; deployments/ag-ui-dev/deps/** regenerated (drift gate clean).

Facts settled (each verified in libs/ag-ui, libs/chat, libs/render, the middleware, or ag-ui-langgraph 0.0.37): a served graph needs a checkpointer because the bridge calls graph.aget_state; the tool result travels in the browser's message list, which is why flush() is a no-op; submit({ resume }) is a separate path from a message-less submit; TOOL_CALL_END marks a call complete before its result arrives; setBranch-style claims from the old walkthroughs are gone.

Resolver: region slices now drop inner marker lines (example-code.ts), so nested regions render clean.

Test: the docs-search e2e deep-link assertion now accepts any docs page with a section anchor; the new ag-ui pages outrank the LangGraph persistence guide for "checkpointer".

Verification: nx run-many -t test,lint green (website, cockpit-registry, cockpit-shell, scripts); generators no drift; prod build renders every page with data-example-file counts equal to tag counts; nx e2e website 120 passed + the amended test green on rerun.

🤖 Generated with Claude Code

blove and others added 17 commits September 5, 2026 20:31
…g list

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…ample

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…emas file, precise wording

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…ence after each block

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…UN_ERROR; subagent toolCallId fallback

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…file, checkpointer reason, diff direction

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…nd the right import direction

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…'s section

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 6, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated
threadplane Ready Ready Preview Sep 6, 2026 4:17am UTC

Request Review

@blove
blove enabled auto-merge (squash) September 6, 2026 04:15

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated approval: this PR received an intelligent (AI) code review. See the review comments on this PR.

@github-actions

github-actions Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Claude finished @blove's task in 0s —— View job


I'll analyze this and get back to you.

@blove
blove merged commit 98b202a into main Sep 6, 2026
38 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