Skip to content

docs: align chat public context#203

Merged
blove merged 1 commit into
mainfrom
codex/chat-public-context-sweep
May 7, 2026
Merged

docs: align chat public context#203
blove merged 1 commit into
mainfrom
codex/chat-public-context-sweep

Conversation

@blove
Copy link
Copy Markdown
Contributor

@blove blove commented May 7, 2026

Summary

Align public chat/docs context with the current runtime-neutral Agent API and remove stale public MCP guidance.

  • Replace old [ref] chat examples with [agent] across chat/render docs and /llms.txt.
  • Remove public npx @ngaf/langgraph-mcp setup guidance from generated AGENTS.md / CLAUDE.md context.
  • Replace the stale chat mockLangGraphAgent() doc page with the current mockAgent() utility from @ngaf/chat.
  • Stop serving stale apps/website/public/api-docs.json; /llms-full.txt and narrative docs now aggregate the current per-library generated API docs.
  • Keep the private MCP package working by bundling the current agent API docs and accepting the current generated docs shape.

Root Cause

The repo now generates API docs into apps/website/content/docs/*/api/api-docs.json, but older public context and helper routes still pointed at removed or stale surfaces: [ref], @ngaf/agent, public MCP install guidance, and apps/website/public/api-docs.json.

Verification

  • npm run generate-agent-context && npm run generate-api-docs && git diff --exit-code -- apps/website/content/docs/*/api/api-docs.json
  • npx nx lint website --skip-nx-cache (passes with pre-existing instrumentation-client.ts non-null assertion warning)
  • npx nx test mcp --skip-nx-cache
  • npx nx build website --skip-nx-cache
  • git diff --check
  • Direct route smoke via tsx for /llms.txt and /llms-full.txt; confirmed /llms-full.txt no longer includes AgentRef or messagesKey.

Follow-up

Whitepaper static HTML still contains stale AgentRef/mock transport language and should be handled in the next dedicated PR.

@vercel
Copy link
Copy Markdown

vercel Bot commented May 7, 2026

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

Project Deployment Actions Updated (UTC)
cacheplane Ready Ready Preview, Comment May 7, 2026 5:13pm

Request Review

@blove blove merged commit ff073e5 into main May 7, 2026
14 checks passed
@blove blove deleted the codex/chat-public-context-sweep branch May 7, 2026 17:16
blove added a commit that referenced this pull request May 7, 2026
…arden gate (#207)

- libs/langgraph: declare `regenerate(index)` on the public LangGraphAgent
  surface (it was implemented + tested but missing from agent.types.ts, so
  the chat-message-actions JSDoc pointer to `agent.regenerate(index)` was
  technically referencing an undeclared method).
- CHANGELOG: backfill 0.0.28 entry documenting the silent removal of
  AgentOptions.messagesKey from PR #202 (was labeled `docs:`).
- docs/superpowers/plans: add post-PR #203 path-note banners to three
  plans that still reference the deleted apps/website/public/api-docs.json
  (now generated per-library under content/docs/{lib}/api/).
- ci: drop the hand-maintained libs allow-list in the examples-deploy gate
  in favor of `^libs/`. The previous list silently broke whenever a new
  publishable lib was added; cost of a spurious example rebuild is far
  cheaper than a missed deploy.

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
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