Files
copilotkit__copilotkit/showcase/integrations/langgraph-python/qa/declarative-hashbrown.md
Tyler Slaton 70e2fb13c8 refactor(showcase): rename byoc-* slugs to declarative-* + sort index by manifest features
User-facing renames so the showcase reads the way a cold visitor would
expect:

- `byoc-hashbrown` → `declarative-hashbrown` (and `byoc-json-render` →
  `declarative-json-render`). The display titles already said
  "Declarative UI: …"; only the URL slugs and folder paths still
  leaked the internal BYOC ("Bring Your Own Components") jargon.
  Renamed:
    /demos/byoc-hashbrown          → /demos/declarative-hashbrown
    /demos/byoc-json-render        → /demos/declarative-json-render
    /api/copilotkit-byoc-*         → /api/copilotkit-declarative-*
    src/app/demos/byoc-*           → src/app/demos/declarative-*
    qa/byoc-*.md                   → qa/declarative-*.md
    tests/e2e/byoc-*.spec.ts       → tests/e2e/declarative-*.spec.ts
  Internal Python module names + langgraph graph IDs stay legacy
  (`byoc_hashbrown_agent.py`, `byoc_hashbrown`) — those are not
  user-facing and renaming them is a separate cross-codebase pass.
- `a2ui-fixed-schema` slug intentionally unchanged.
- Tool Rendering trio parenthetical rename (Default → Catch-all →
  Custom progression reads clearly as "how much do I customize?"):
    Tool Rendering (Default)        — unchanged
    Tool Rendering (Custom default) → Tool Rendering (Catch-all)
    Tool Rendering (Specific)       → Tool Rendering (Custom)
- `tool-rendering-reasoning-chain` cell renamed from
  "Generative UI: Rendering multiple tools" to
  "Generative UI: Tool calls + reasoning" (the demo is about combining
  reasoning + tool rendering, not about quantity of tools).
- `Open Generative UI: Default` / `Open Generative UI: Custom`
  descriptions expanded so a visitor understands how Open Generative UI
  differs from Tool Rendering (agent composes UI from a registered
  library vs. attaching a renderer to a *named* backend tool).
- Showcase index now sorts demos within each tag by `manifest.features`
  order. Previously demos appeared in manifest declaration order, which
  ignored the team's curated "polished flagship → simplest start →
  variants" arc.

Cross-cutting registry / harness / dashboard updates that fall out of
the rename:

- `shared/feature-registry.json` adds the two new IDs alongside the
  legacy `byoc-*` (so the catalog stays valid; the other 17
  integrations still declare `byoc-*` in their manifests).
- `shared/constraints.yaml` adds the new IDs to the
  generative-ui-approach allow-list.
- `scripts/__tests__/generate-catalog.test.ts` updates the cell-count
  expectations (45 features × 18 integrations = 810; 792 after docs-
  only exclusion; 45 LGP cells = 38 wired + 1 stub + 6 unshipped).
- Harness probe `d5-byoc.ts` + `d5-byoc.test.ts` now route both slug
  families through `preNavigateRoute` and exercise the new branches.
- `d5-feature-mapping.ts` and `shell-dashboard/live-status.ts` mirror
  the dual-ID mapping so both legacy and renamed slugs roll up under
  the same `byoc` D5 featureType.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-10 15:16:02 -07:00

2.5 KiB

QA: Declarative UI — Hashbrown — LangGraph (Python)

Prerequisites

  • Demo deployed at /demos/declarative-hashbrown
  • Railway service showcase-langgraph-python-production healthy
  • OPENAI_API_KEY set in the Railway environment
  • @hashbrownai/core + @hashbrownai/react installed in the package
  • byoc_hashbrown graph registered in langgraph.json

Test Steps

1. Page load

  • Navigate to /demos/declarative-hashbrown
  • Header "Declarative UI: Hashbrown" visible
  • Short description mentioning @hashbrownai/react visible
  • Chat composer visible at the bottom of the chat area
  • 3 suggestion pills visible inside the composer with labels: "Sales dashboard", "Revenue by category", "Expense trend"
  • No red console errors (amber hydration warnings tolerated)

2. Sales dashboard suggestion

  • Click the "Sales dashboard" pill
  • The prompt is dispatched automatically (useConfigureSuggestions sends the message on pill click)
  • Within 45 seconds, at least one MetricCard (data-testid="metric-card") renders in the transcript
  • Within 45 seconds, at least one chart (data-testid="bar-chart" or data-testid="pie-chart") renders
  • Rendered content streams progressively — partial UI appears before the full response completes (optional visual check)

3. Revenue by category

  • Click "Revenue by category"
  • Within 45s, a pie chart (data-testid="pie-chart") renders
  • Legend shows at least 4 segments with readable labels and values

4. Expense trend

  • Click "Expense trend"
  • Within 45s, a bar chart (data-testid="bar-chart") renders
  • Chart has at least 3 bars with month-like labels

5. Free-form prompt

  • Type "Show me revenue trends for the last six months" and press Enter
  • Verify at least one catalog component renders (metric, chart, or deal)

6. Multi-turn

  • After a first render completes, send a follow-up prompt (e.g. "Now break it down by region")
  • A new render appears alongside prior renders in the transcript

7. Error handling

  • Empty send is a no-op (button stays disabled)
  • Console remains clean during successful flows

Expected Results

  • Suggestion pills produce a hashbrown render within 45 seconds
  • Streaming renders assemble progressively as JSON chunks arrive
  • No uncaught errors; no useHashBrownKit must be used within HashBrownDashboard errors
  • Multi-turn works without clearing prior renders