chore(showcase/langgraph-python): manifest, runtime, e2e, cleanup

Cross-cutting changes that don't belong with any one demo: manifest +
landing-page tags, runtime route adjustments, e2e + QA notes that
follow the demo renames, and a few small cleanups.

Manifest (manifest.yaml + src/app/page.tsx tag labels):
- Naming convention: every demo uses `Thing: Subthing` (Generative UI:
  Tool Rendering - Default / Custom Default / Specific; Open Generative
  UI: Default / Advanced; Shared State: Streaming / Read + Write;
  Reasoning: Default / Custom; Frontend Tools: In-App Actions / Async;
  Human in the Loop: In-chat / In-App / Interrupt based; Chat
  Customization: CSS / Slots; Headless UI: Simple / Complete).
- Retags: Auth → `platform`; HITL Step Selection + Interrupt-based →
  `interactivity`; Reasoning Default + Custom → `chat-ui`; Generative
  UI: Tools → `generative-ui`.
- Renames: Readonly State (Agent Context) → Frontend Context Sharing.
- HITL slot points at /demos/hitl-in-chat (working
  useHumanInTheLoop+interrupt path) instead of the previous
  /demos/hitl that had no backend `interrupt()` calls.
- Highlight paths corrected for the rebuilt headless demos (root-level
  paths replaced with hooks/, chat/, tools/, attachments/ subdirs).
- Descriptions rewritten where they had drifted from the implementation
  (gen-ui-agent: dropped useCoAgentStateRender claim;
  headless-simple: shadcn primitives, not raw Tailwind;
  headless-complete: enumerates the actual hooks wired).

Runtime / route:
- src/app/api/copilotkit/route.ts — 30 agents registered (incl. the
  reasoning-custom rename from agentic-chat-reasoning).
- copilotkit-mcp-apps/route.ts replaced with [[...slug]]/route.ts so v2
  subpath POSTs (/v2/agent/run) resolve.
- src/app/api/copilotkit-voice/[[...slug]]/route.ts — env var standardized
  (was `AGENT_URL || LANGGRAPH_DEPLOYMENT_URL`, now matches the rest
  of the showcase with just LANGGRAPH_DEPLOYMENT_URL); trailing `/`
  removed from deploymentUrl.

Tests / QA:
- e2e specs renamed and paths updated for the demo renames.
- qa notes for a2ui-fixed-schema (booked-state checklist removed) and
  byoc-json-render (Wave 4a residue removed).
- docs-links.json key renamed for reasoning-custom.

Cleanup:
- Removed remaining stub agent.py files in demo dirs (real graphs in
  src/agents/); removed dead beautiful-chat/components/headless-chat.tsx
  (zero importers); removed [A2UI-DEBUG] / [A2UI-RESPONSE] print
  statements from beautiful_chat.py; gpt-5.4-mini → gpt-5-mini typo
  fix in beautiful_chat.py:249 (would have 4xx'd every model call);
  stripped iframe-restriction LLM-prompt copy bleed from
  open-gen-ui-advanced suggestion titles.

The convention pass that ran across ~28 demos earlier in this branch is
already reflected in their per-demo commits — every page.tsx reads as
imports + provider + suggestions hook + JSX, with `useConfigureSuggestions`
extracted to a sibling suggestions.ts.

Author: tylerslaton

showcase/integrations/langgraph-python/docs-links.json

@@ -37,7 +37,7 @@
       "og_docs_url": "https://docs.copilotkit.ai/langgraph/custom-look-and-feel/headless-ui",
       "shell_docs_path": "/custom-look-and-feel/headless-ui"
     },
-    "agentic-chat-reasoning": {
+    "reasoning-custom": {
       "og_docs_url": "https://docs.copilotkit.ai/custom-look-and-feel/reasoning-messages",
       "shell_docs_path": "/custom-look-and-feel/reasoning-messages"
     },

showcase/integrations/langgraph-python/manifest.yaml

@@ -4,7 +4,7 @@
 
 - Demo is deployed and accessible at `/demos/a2ui-fixed-schema` on the dashboard host
 - Agent backend is healthy; `OPENAI_API_KEY` is set on Railway; `LANGGRAPH_DEPLOYMENT_URL` points at a LangGraph deployment exposing the `a2ui_fixed` graph (registered as agent name `a2ui-fixed-schema` — see `src/app/api/copilotkit-a2ui-fixed-schema/route.ts`)
-- Note: the demo source contains no `data-testid` attributes. Checks below rely on verbatim visible text, DOM structure, and the two JSON schemas under `src/agents/a2ui_schemas/`
+- Note: the demo source contains no `data-testid` attributes. Checks below rely on verbatim visible text, DOM structure, and the JSON schema at `src/agents/a2ui_schemas/flight_schema.json`
 
 ## Test Steps
 
@@ -32,18 +32,9 @@
   - `Button` renders full-width with label "Book flight" (black `#010507` background, white text, 12px radius)
 - [ ] Verify all four data-model fields resolved correctly (origin=`SFO`, destination=`JFK`, airline=`United`, price=`$289`) — each is a `{ path: "/..." }` binding in the schema and must reach the DOM as a plain string via the `GenericBinder` (no literal `{path}` leak and no React error #31)
 
-#### Book-Flight Interaction (stateful `Button` override)
+#### Book-Flight Button (inert — pure presentation)
 
-- [ ] Click the "Book flight" button inside the rendered card; verify it transitions to the confirmed state WITHOUT re-rendering the surface:
-  - button background becomes the mint tint `rgba(133, 236, 206, 0.15)` with border `#85ECCE4D`
-  - label text changes to "Booked" (color `#189370`)
-  - a green check SVG (`polyline 20 6 9 17 4 12`, stroke `#189370`) appears to the left of the label
-  - button is disabled; further clicks are no-ops
-- [ ] Note: the agent-side action handler for `book_flight` is intentionally not wired (see comment in `src/agents/a2ui_fixed.py` — SDK doesn't yet accept `action_handlers=`). So the `booked_schema.json` swap is NOT expected to occur. Verify only the local optimistic button state change.
-
-#### Booked Schema Readiness (`booked_schema.json` — wired-but-inert)
-
-- [ ] Verify `src/agents/a2ui_schemas/booked_schema.json` exists and declares a 3-node tree (`root` Column with children `title` + `detail`, both `Text` with path bindings `/title` and `/detail`). No runtime check — the schema is kept so the handoff is ready once the SDK supports `action_handlers`. Log a test note if this file is ever removed.
+- [ ] Verify the "Book flight" button is rendered with the schema-declared label and is clickable, but the click is a no-op: the agent is not invoked, no schema swap occurs, and the button does not transition to a "Booked" state. Schema-swap-on-action will be wired up once the Python SDK exposes `action_handlers=` on `a2ui.render` (see comment in `src/agents/a2ui_fixed.py`).
 
 #### Follow-up Prompt (data-model refresh)
 
@@ -59,6 +50,6 @@
 
 - Chat loads within 3s; plain-text response within 10s; flight card renders within 20s of the search prompt
 - `display_flight` is called exactly once per search prompt; result contains an `a2ui_operations` container with `catalogId: "copilotkit://flight-fixed-catalog"` and the full 12-node flight schema
-- All five custom renderers in `a2ui/renderers.tsx` (`Title`, `Airport`, `Arrow`, `AirlineBadge`, `PriceTag`, plus the stateful `Button` override) render at least once per search-flights run
-- Clicking "Book flight" produces a local optimistic confirmation (mint background + check icon + disabled state)
+- All custom renderers in `a2ui/renderers.tsx` (`Card`, `Title`, `Airport`, `Arrow`, `AirlineBadge`, `PriceTag`, `Button`) render at least once per search-flights run
+- Clicking "Book flight" is a no-op (inert presentation button — see comment in `src/agents/a2ui_fixed.py`)
 - No UI layout breaks, no `{path}` leak into the DOM, no uncaught console errors

showcase/integrations/langgraph-python/qa/a2ui-fixed-schema.md

@@ -51,6 +51,6 @@
 
 ## Expected Results
 
-- Suggestion renders land within 60 seconds. Budget is slightly higher than Wave 4a because a JSON `{ root, elements }` spec is more verbose than hashbrown's token stream.
+- Suggestion renders land within 60 seconds. Budget is slightly higher than the hashbrown demo because a JSON `{ root, elements }` spec is more verbose than hashbrown's token stream.
 - No uncaught errors in the console.
 - Streaming falls back to plain text until the JSON parses, then swaps to rendered components.

showcase/integrations/langgraph-python/qa/byoc-json-render.md

@@ -34,12 +34,10 @@ import { TranscriptionServiceOpenAI } from "@copilotkit/voice";
 import OpenAI from "openai";
 
 const LANGGRAPH_URL =
-  process.env.AGENT_URL ||
-  process.env.LANGGRAPH_DEPLOYMENT_URL ||
-  "http://localhost:8123";
+  process.env.LANGGRAPH_DEPLOYMENT_URL || "http://localhost:8123";
 
 const voiceDemoAgent = new LangGraphAgent({
-  deploymentUrl: `${LANGGRAPH_URL}/`,
+  deploymentUrl: LANGGRAPH_URL,
   graphId: "sample_agent",
 });
 

showcase/integrations/langgraph-python/src/app/api/copilotkit-mcp-apps/route.ts

@@ -82,9 +82,12 @@ agents["frontend-tools-async"] = createAgent("frontend_tools_async");
 agents["gen-ui-agent"] = createAgent("gen_ui_agent");
 // Tool-Based Generative UI — chart-viz system prompt lives in its own graph.
 agents["gen-ui-tool-based"] = createAgent("gen_ui_tool_based");
-// Reasoning variants.
-agents["agentic-chat-reasoning"] = createAgent("reasoning_agent");
-agents["reasoning-default-render"] = createAgent("reasoning_agent");
+// Reasoning variants. The Custom demo (`reasoning-custom`) and the
+// Default demo (`reasoning-default`) both share the same backend graph;
+// the only difference is whether the frontend overrides the
+// `messageView.reasoningMessage` slot.
+agents["reasoning-custom"] = createAgent("reasoning_agent");
+agents["reasoning-default"] = createAgent("reasoning_agent");
 // Interrupt variants.
 agents["gen-ui-interrupt"] = createAgent("interrupt_agent");
 agents["interrupt-headless"] = createAgent("interrupt_agent");

showcase/integrations/langgraph-python/src/app/api/copilotkit-voice/[[...slug]]/route.ts

@@ -12,12 +12,9 @@ import { test, expect } from "@playwright/test";
 // PriceTag, Button) bind path strings like "/airline" / "/price" to the
 // incoming data model.
 //
-// The "Book flight" Button has a stateful override (ActionButton in
-// a2ui/renderers.tsx) that transitions to a "Booked" state with a green
-// check SVG on click — purely local, because the SDK doesn't yet support
-// `action_handlers=` on the Python side (see the comment in
-// a2ui_fixed.py). The `booked_schema.json` swap path is therefore NOT
-// expected to fire and is intentionally not tested.
+// This is a pure-presentation demo: the "Book flight" Button is inert —
+// schema-swap-on-action will be wired up once the Python SDK exposes
+// `action_handlers=` on `a2ui.render` (see comment in a2ui_fixed.py).
 //
 // No data-testid anywhere in the demo. Assertions ride on:
 //   - verbatim label text hardcoded in flight_schema.json ("Flight
@@ -89,26 +86,4 @@ test.describe("A2UI Fixed Schema (flight card)", () => {
     );
   });
 
-  test("Book flight button transitions to Booked on click", async ({
-    page,
-  }) => {
-    const suggestions = page.locator('[data-testid="copilot-suggestion"]');
-    await suggestions.filter({ hasText: "Find SFO → JFK" }).first().click();
-
-    // Render budget is 90s here: the first click after cold-start can
-    // burn most of a minute before `display_flight` emits the
-    // a2ui_operations container, and we then need the full 12-node tree
-    // to resolve before the Book flight button exists.
-    const bookBtn = page.getByRole("button", { name: "Book flight" });
-    await expect(bookBtn).toBeVisible({ timeout: 90_000 });
-    await bookBtn.click();
-
-    // After click: label switches to "Booked" and the button becomes
-    // disabled. This is the purely-local ActionButton state transition;
-    // no agent round-trip is involved.
-    await expect(page.getByRole("button", { name: "Booked" })).toBeVisible({
-      timeout: 10_000,
-    });
-    await expect(page.getByRole("button", { name: "Booked" })).toBeDisabled();
-  });
 });

showcase/integrations/langgraph-python/src/app/api/copilotkit/route.ts

@@ -1,5 +1,5 @@
 /**
- * E2E spec for the byoc-hashbrown demo (Wave 4a).
+ * E2E spec for the byoc-hashbrown demo.
  *
  * Authored but not executed pre-deploy — Railway stabilization runs happen
  * post-deploy per the plan's scope modification. Selectors match the ported

showcase/integrations/langgraph-python/tests/e2e/a2ui-fixed-schema.spec.ts

@@ -7,7 +7,7 @@ import { test, expect } from "@playwright/test";
  * Task 12 scope note).
  *
  * Structurally mirrors `gen-ui-tool-based.spec.ts` so the agent
- * dashboard's Wave 4a/4b rows exercise the same surfaces.
+ * dashboard's BYOC rows exercise the same surfaces.
  */
 test.describe("BYOC json-render", () => {
   test.beforeEach(async ({ page }) => {