…nce Platform
<!--
Thank you for sending the PR! We appreciate you spending the time to
work on these changes.
Help us understand your motivation by explaining why you decided to make
this change.
**Please PLEASE reach out to us first before starting any significant
work on new or existing features.**
By the time you've gotten here, you're looking at creating a pull
request so hopefully we're not too late.
We love community contributions! That said, we want to make sure we're
all on the same page before you start.
Investing a lot of time and effort just to find out it doesn't align
with the upstream project feels awful, and we don't want that to happen.
It also helps to make sure the work you're planning isn't already in
progress.
As described in our contributing guide, please file an issue first:
https://github.com/ag-ui-protocol/ag-ui/issues
Or, reach out to us on Discord: https://discord.com/invite/6dffbvGU3D
You can learn more about contributing to copilotkit here:
https://github.com/copilotkit/copilotkit/blob/master/CONTRIBUTING.md
Happy contributing!
-->
## What does this PR do?
(Describe the changes introduced in this PR)
## Related PRs and Issues
- (Direct link to related PR or issue, if relevant)
## Checklist
- [ ] I have read the [Contribution
Guide](https://github.com/copilotkit/copilotkit/blob/master/CONTRIBUTING.md)
- [ ] If the PR changes or adds functionality, I have updated the
relevant documentation
- [ ] "Allow edits by maintainers" is checked (lets us help iterate on
your PR directly — faster turnaround for everyone)
QA3's `byoc-hashbrown/page.tsx` (which got renamed into the
declarative-hashbrown dir during the orchestrator pass) imported a
`useHashBrownMessageRenderer` hook that doesn't exist in any
`hashbrown-renderer.tsx` — neither LP's nor the one we already had —
which broke the Next.js prerender step with `(0 , d.useHashBrownMessageRenderer) is not a function`.
The QA agent had drafted a custom page.tsx that diverged from LP's
canonical version. Per north-star rule, replaced both page.tsx +
suggestions.ts with LP-verbatim for both demos.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Result of 10 parallel QA agents auditing all 30 active demos against
langgraph-python (north-star). Each agent ported drift back to LP-verbatim
across three axes:
1. Agent layer
- tool_rendering_common.py: rebuilt to LP's surface — get_weather,
search_flights(origin, destination), get_stock_price, roll_d20,
roll_dice. Removed the ADK-only query_data.
- tool_rendering_*_agent.py (4 variants): ported LP's travel/concierge
prompt; reasoning-chain variant got LP's chain-two-tools prompt.
- beautiful_chat_agent.py: ported LP's per-tool system prompt; added
manage_sales_todos / get_sales_todos / generate_a2ui; dropped the
redundant schedule_meeting (frontend HITL handles it).
- open_gen_ui_agents.py: ported LP's full SYSTEM_PROMPT for both
variants, including the Websandbox.connection.remote.* contract
for the advanced sandbox demo (was `window.sandbox.*`, which the
LP frontend's Websandbox bridge silently no-ops).
- byoc_agents.py: fused LP's hashbrown + json-render prompts so the
single ADK byoc_agent emits both wire shapes. Aliases exported for
a future per-route split.
- declarative_gen_ui_agent.py: ported LP's a2ui_dynamic SYSTEM_PROMPT.
- a2ui_fixed_agent.py: picked up LP's #4734 regression guard
("exactly ONCE", "do NOT call again").
- agent_config_agent.py: rewrote to read useAgentContext (was
state["config"]); reconciled schema to LP's 3-field camelCase
{tone, expertise, responseLength} with LP's value enums.
- subagents_agent.py: dropped the "running" placeholder; returns
plain str so the LP-verbatim frontend's `result?.trim()` works.
- hitl_in_app_agent.py / hitl_in_chat_book_call_agent.py: prompts +
tool-result shape ({approved, reason}) aligned to LP.
- AGUIToolset() added wherever it was missing on the bespoke agents
(multimodal, mcp_apps, a2ui_fixed) so frontend-registered tools
reach the model.
2. Dedicated runtime routes
- copilotkit-multimodal/route.ts (new) — mirrors LP shape with
ADK's HttpAgent + AGENT_URL pattern.
- copilotkit-agent-config/route.ts (new) — same pattern.
- copilotkit-mcp-apps/route.ts — refreshed.
3. Frontend ports (ADK frontend brought to LP-verbatim where it had
drifted from the parity blitz state)
- tool-rendering family (4 demos): full re-port — WeatherCard,
FlightListCard, StockCard, D20Card, ReasoningBlock, CatchallRenderer,
suggestions, and the page wiring with all useRenderTool /
useDefaultRenderTool / reasoningMessage registrations.
- a2ui-fixed-schema, mcp-apps, multimodal: full frontend re-ports
with their _components/ Tailwind primitives.
- frontend-tools, frontend-tools-async, agent-config: ported LP's
component structure (separate Background, NotesCard with query_notes,
config-context-relay).
- shared-state-read, shared-state-read-write, readonly-state-agent-context:
ported LP's demo-layout + _components + suggestions. recipe-card.tsx
pulled directly from LP (one QA agent had adapted to Unicode glyphs
thinking ADK lacked lucide-react — it doesn't, after the parity blitz).
- shared-state-streaming, subagents, hitl-in-app: ported LP's
DocumentView / supervisor-activity / TicketsPanel structure.
hitl-in-app/page.tsx pulled directly from LP to keep the hyphenated
agent slug aligned with the renamed registry key.
- auth, hitl-in-chat: ported LP's SignInCard-first auth UX and the
time-picker Tailwind port.
- prebuilt-popup: pulled LP's main-content + suggestions split.
4. Test fixtures
- 30 tests/e2e/<slug>.spec.ts ported from LP, several overwriting
stale stubs (shared-state-streaming, subagents, auth, hitl-in-chat,
shared-state-read, agent-config).
- 30 qa/<slug>.md ported from LP with ADK env-var and registry
references substituted (GOOGLE_API_KEY, AGENT_URL, registry.py).
- QA3's byoc-hashbrown / byoc-json-render specs renamed to
declarative-hashbrown / declarative-json-render with internal
URL references substituted (the orchestrator pass had already
renamed the demo dirs + manifest entries).
Frontend changes from QA agents were filtered: kept where they ported
LP-verbatim into ADK, replaced with direct LP pulls where the agent
had made ADK-specific adaptations (one Unicode-glyph case, one
stale-registry-slug case).
Not touched per blitz rules: shared_chat.py, registry.py, manifest.yaml,
src/app/api/copilotkit/route.ts.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The next.config redirects() block runs at Next.js routing time (before
middleware), so it preempts the seo-redirects.ts catalog rules. The
existing catch-all dropped users at the framework-agnostic root tree
(/agentic-chat-ui, /frontend-tools, etc.) instead of the BIA-scoped
equivalent (/built-in-agent/...), diffusing SEO equity from legacy
/unselected/ URLs.
Changes:
- /unselected (root): destination /built-in-agent (was /)
- /unselected/:path* catch-all: destination /built-in-agent/:path* (was /:path*)
- Add 14 explicit slug-rename entries above the catch-all, mirroring
SUBPATH_RENAMES in seo-redirects.ts (S1-S15 minus S13).
Verified against Phase 4 redirect probe — closes 13 of 22 unselected/
failures.
- open_gen_ui_agents.py: port LP's minimal + advanced system prompts
verbatim. Advanced prompt now tells Gemini to call
`Websandbox.connection.remote.<fn>` (matching the LP frontend's
websandbox bridge — the prior `window.sandbox.*` prompt produced UIs
that silently no-op'd) and includes the full sandbox-iframe restriction
set (no `<form>`, no `type="submit"`, addEventListener / keydown only),
CDN script guidance, and the return-shape contract.
- beautiful_chat_agent.py: add `manage_sales_todos`, `get_sales_todos`,
and `generate_a2ui` (mirrors `agents/main.py.generate_a2ui` — forced
Gemini tool call, full `_A2uiError` shape) so the Task Manager and
Sales Dashboard pills exercise their backend tools end-to-end. Drop
`schedule_meeting` — the frontend handles meeting scheduling via the
`scheduleTime` `useFrontendTool` HITL renderer.
- Copy LP's `tests/e2e/{open-gen-ui,open-gen-ui-advanced,beautiful-chat}.spec.ts`
and `qa/{open-gen-ui,open-gen-ui-advanced,beautiful-chat}.md` fixtures
into the ADK integration, retitled for Google ADK and adjusted for
ADK env-var names (`GOOGLE_API_KEY`, `AGENT_URL`).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The package was added to the repo but never wired into
release.config.json,
so the release / create-pr and release / publish workflows skipped it.
Adding
it here lets the next monorepo release bump and publish it like its
siblings
(e.g. @copilotkit/sqlite-runner). sharedVersion=true means the existing
1.56.2 in package.json will be overwritten with the monorepo's next
version.
The schema-strip patch was an incorrect diagnosis. Subsequent end-to-end
testing through the real ADKAgent → Gemini path (curl test below)
confirms nested `required` works fine without any schema stripping:
$ curl -X POST /gen-ui-tool-based \
-d '{"tools":[{... "data": {"items": {"required":["label","value"]}}}]}'
data: {"type":"TOOL_CALL_START","toolCallName":"render_bar_chart"}
data: {"type":"TOOL_CALL_ARGS","delta":"{\"title\":\"Quarterly Sales\",...}"}
data: {"type":"TOOL_CALL_END",...}
The original silent-failure observation was a bisection artifact: when
the silent failure first cleared, I credited the monkeypatch — but the
same rebuild had also refreshed `/app/agents/gen_ui_tool_based_agent.py`
with the `AGUIToolset()` addition (Dockerfile COPYs src/agents/ into /app/agents/,
which PYTHONPATH=/app loads ahead of the volume-mounted /app/src/agents/).
The AGUIToolset propagation was the only real fix; the schema-strip was
masking nothing.
Stripping `required` would have dropped semantic information Gemini does
use to constrain tool arg generation, so removing the patch also avoids a
subtle behavior degradation.
The 17-file AGUIToolset propagation from 112e53d9a stays in place — that
is the actual fix for the "demo appears frozen" symptom.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
## Summary
The `langgraph-python-threads` example requires both `uv` (for the
Python agent's `postinstall: uv sync`) and Docker (for Postgres / Redis
/ Intelligence), but nothing surfaced that until `npm install` errored
with a bare `sh: uv: command not found`.
This PR makes the requirements explicit:
- **README** — adds `uv` and a Docker install link to the prerequisites
list.
- **Preflight script** (`scripts/check-prereqs.mjs`) — checks for `uv`
on `npm install` (`preinstall`), and for `uv` + a running Docker daemon
on `npm run dev` (`predev`). Prints a formatted error pointing at the
install docs and exits non-zero before the failing command runs.
## Test plan
- [ ] `npm install` with `uv` removed from PATH — fails with the
friendly preflight error, not the postinstall stack trace.
- [ ] `npm run dev` with Docker installed but not running — fails with
the "Docker is installed but does not appear to be running" message.
- [ ] `npm install` / `npm run dev` with both prereqs present — runs
normally.
The template required uv (for the agent's `postinstall: uv sync`) and Docker
(for the threads infrastructure) but surfaced nothing until npm install errored
with `sh: uv: command not found`. Add a preflight script wired to preinstall
and predev that prints a clear message pointing at the install docs, plus
README updates calling out both prerequisites.
## Summary
Client-side telemetry on `docs.showcase.copilotkit.ai` was silent. The
shell-docs Dockerfile and `showcase_build.yml` workflow never plumbed
the `NEXT_PUBLIC_*` analytics keys through to `next build`, so the
client JS chunks shipped with empty strings (verified by grepping the
live bundle: `let l = i(95704).env.NEXT_PUBLIC_POSTHOG_KEY` — a runtime
lookup with no inlined value).
Railway runtime env doesn't reach the Docker build phase, so server-side
reads (middleware `POSTHOG_KEY`, server-component canonical URLs) worked
but client-side reads (posthog-js init, RB2B, Scarf, Reo, GA) silently
no-op'd in the browser.
## Changes
- **`showcase/shell-docs/Dockerfile`** — declare `ARG` + `ENV` for
`NEXT_PUBLIC_POSTHOG_KEY`, `NEXT_PUBLIC_RB2B_ID`,
`NEXT_PUBLIC_SCARF_PIXEL_ID`, `NEXT_PUBLIC_REO_KEY`,
`NEXT_PUBLIC_GOOGLE_ANALYTICS_TRACKING_ID` in the builder stage so they
reach `next build`.
- **`.github/workflows/showcase_build.yml`** — add
`build_args_analytics: "yes"` flag to the shell-docs matrix entry;
extend the `Prepare build args` step to emit the five `NEXT_PUBLIC_*`
`--build-arg`s when the flag is set, sourcing values from repo secrets.
Mirrors the existing shell-dashboard pattern (`build_args_pb_url` /
`build_args_shell_url` / `build_args_ops_url`).
## Secrets
Existing repo secret reused: `POSTHOG_PROJECT_KEY`.
New repo secrets required (configured separately in repo settings before
this lands):
- `RB2B_ID`
- `SCARF_PIXEL_ID`
- `REO_PROJECT_KEY`
- `GOOGLE_ANALYTICS_TRACKING_ID`
## Out of scope (intentionally)
- `NEXT_PUBLIC_BASE_URL` is already correctly working via Railway
runtime env (canonical links render with `https://docs.copilotkit.ai`) —
left alone.
- Server-side `POSTHOG_KEY` (no `NEXT_PUBLIC_` prefix) stays on Railway
runtime env; middleware reads it at Edge Runtime.
## Test plan
- [ ] Next build of shell-docs succeeds with new ARGs in scope
- [ ] After deploy, search the live bundle on
`docs.showcase.copilotkit.ai` for the literal `phc_` prefix — must be
present (not `process.env.NEXT_PUBLIC_POSTHOG_KEY` runtime lookup)
- [ ] PostHog Live Events shows `$pageview` (client) and `$autocapture`
arriving from staging
- [ ] RB2B / Scarf / Reo / GA dashboards show events from staging
- [ ] Server-side `seo_redirect` + `docs_pageview` continue firing (no
regression)
## Summary
- **Fix shell-docs build**: Add missing `@types/react-dom` to
devDependencies — Docker build was failing because react-dom types
resolve transitively in the monorepo but not in the isolated Docker
context (broke after PR #4691 merged)
- **Slack + PR comment on failure**: New `notify` job in
`showcase_build.yml` posts to #oss-alerts and comments on the
originating PR when a showcase Docker build fails post-merge
- **Pre-merge Docker build check**: New `showcase_build_check.yml`
workflow runs the same Depot Docker build on PRs with `push: false`,
catching Dockerfile-specific failures before they land on main
## Why
PR #4691 merged but never went live — the shell-docs Docker build was
silently failing for 27 hours with no notification. The merge author had
no way to discover this without manually checking the Actions tab.
## Test plan
- [ ] Verify shell-docs GHCR build succeeds after merge (the
`@types/react-dom` fix unblocks it)
- [ ] Verify Slack notification fires on next build failure (can test
with `workflow_dispatch` + intentional break)
- [ ] Verify PR comment appears on the originating PR when a build fails
- [ ] Open a test PR touching `showcase/` to confirm the pre-merge
Docker build check triggers
Two compounding root causes were silently breaking every generative-UI demo
that depended on frontend-registered tools (useFrontendTool, useComponent,
useHumanInTheLoop):
1) Missing AGUIToolset() in bespoke agents
The ag_ui_adk middleware injects the frontend's tool registrations by
*replacing* AGUIToolset instances in the agent's `tools` list with a
ClientProxyToolset that wraps `input.tools`. If no AGUIToolset is
present, the frontend tools are dropped silently and the model never
sees render_bar_chart / render_pie_chart / etc. Bespoke agents (the ones
built directly with LlmAgent(...) instead of via build_simple_chat_agent
in shared_chat.py) all had `tools=[]` or `tools=[backend_only]`.
Appended AGUIToolset() to every bespoke agent.
2) Nested `required` in tool parameter schemas
Gemini's function-calling API silently rejects function declarations
whose parameter schema contains a `required` field below the top-level
object — e.g. on the items.properties of an array, or on a nested
property's own properties. The Zod-generated schema for render_bar_chart
has exactly that shape (items.properties with required: [label, value]).
The model emits no TOOL_CALL_* events, no TEXT_MESSAGE_*, just RUN_STARTED
→ STATE_SNAPSHOT → RUN_FINISHED. ag_ui_adk's _clean_schema_for_genai
doesn't strip nested required.
agent_server.py now monkey-patches _clean_schema_for_genai at startup so
nested `required` is stripped before tool definitions reach the model.
Top-level required is preserved (Gemini accepts it there). The patch is
defensive and per-process — no upstream dependency change needed.
Verification: curl test against /gen-ui-tool-based with the LP-shaped tool
schema now emits TOOL_CALL_START + TOOL_CALL_ARGS containing the chart
payload. Browser test renders the bar chart in the chat with Q1/Q2/Q3/Q4
data. Sanity-checked gen-ui-agent (set_steps state-streaming) — fully
working, live "All 3 steps complete" card rendered.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The previous commit used `NEXT_PUBLIC_RB2B_ID` based on a stale entry
in the cutover plan doc, but `app/layout.tsx:86` reads
`NEXT_PUBLIC_REB2B_KEY`. Without this fix the build-arg would be
piped under the wrong name and the REB2B Script tag would still not
render.
Client-side telemetry on docs.showcase.copilotkit.ai was silent: the
shell-docs Dockerfile and Showcase Build & Push workflow never plumbed
NEXT_PUBLIC_POSTHOG_KEY / RB2B_ID / SCARF_PIXEL_ID / REO_KEY /
GOOGLE_ANALYTICS_TRACKING_ID through to `next build`. Railway runtime
env doesn't reach the Docker build phase, so the client JS chunks
shipped with empty strings — posthog-js.init etc. silently no-op'd in
the browser.
Mirrors the shell-dashboard pattern: matrix flag triggers the args
block; values come from repo secrets (POSTHOG_PROJECT_KEY already
existed; RB2B_ID, SCARF_PIXEL_ID, REO_PROJECT_KEY,
GOOGLE_ANALYTICS_TRACKING_ID added separately in repo settings).
Server-side telemetry (middleware seo_redirect, docs_pageview) was
unaffected — it reads POSTHOG_KEY at Edge Runtime, which Railway
runtime env satisfies.
Two requested changes in one pass:
1. Pin CopilotKit package versions
- All @copilotkit/* in package.json: "next" → "1.57.1"
(a2ui-renderer, react-core, runtime, shared, voice)
- ag-ui-adk in requirements.txt: unpinned → "==0.6.1"
Verified in the running container: pip shows ag_ui_adk 0.6.1,
package.json shows the five CPK packages at 1.57.1.
2. Retire interrupt demos (Strategy B was the only available adaptation
and the user asked for them to show as X in the dashboard):
- Delete src/app/demos/gen-ui-interrupt/ and interrupt-headless/
- Delete src/agents/interrupt_agent.py (no other consumers)
- Drop the registry.py + route.ts entries
- Move both feature ids from features: into not_supported_features:
so the dashboard renders them as an explicit grey X (intentional
opt-out) rather than red ? (unshipped). Drop the corresponding
demos: entries.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
ADK's globals.css had `html, body { width: 100%; overflow: hidden }` as a
combined rule, which gave <body> a fixed full-viewport width. The CopilotKit
v2 <CopilotSidebar /> docks itself by setting `margin-inline-end` on <body>,
which only shrinks the layout when body's width is free to recompute — a
fixed `width: 100%` defeats the mechanism, so the sidebar ends up overlapping
the page content instead of pushing it.
LP's globals.css splits the rule and intentionally omits `width: 100%` on
<body> (the comment in their CSS explains the exact reason). Port the same
split. Also adds the LP `body[data-scroll-locked]` neutralizer to prevent
Radix overlays from injecting a phantom `padding-right` that would shrink
the page on every dropdown open.
Verified in browser: /demos/prebuilt-sidebar now pushes the "Sidebar demo"
content into the left ~70% of the viewport while the chat takes the right
~30%, matching showcase.copilotkit.ai/integrations/langgraph-python/prebuilt-sidebar.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The shared-state-read demo (and others) port from LP imports these
shadcn primitives, but the orchestrator pass missed copying them from
LP's src/components/ui/. Webpack build failed with "Can't resolve
@/components/ui/{input,select,spinner}". Copied verbatim from LP. deps
(lucide-react, radix-ui) already in package.json.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
## Summary
PR #4691 introduced `import { createPortal } from "react-dom"` in
`src/components/search-trigger.tsx` but did not add `@types/react-dom`
to `showcase/shell-docs/package.json`'s devDependencies. The Railway
production build fails:
```
./src/components/search-trigger.tsx:4:30
Type error: Could not find a declaration file for module 'react-dom'.
'/app/shell-docs/node_modules/react-dom/index.js' implicitly has an 'any' type.
```
Local dev was unaffected because the type was being satisfied via
hoisting from a root `node_modules`. The Docker builder installs each
package's deps in isolation, so the type resolution failed.
## Fix
Add `@types/react-dom: ^19.0.0` to shell-docs devDependencies (matches
the existing `@types/react: ^19.0.0` constraint and resolves to the same
major version as the runtime `react-dom: ^19.0.0`).
## Test plan
- [ ] Railway production build succeeds
- [ ] `npx tsc --noEmit` from `showcase/shell-docs/` returns no
`react-dom` errors
- [ ] No regression in local dev
Orchestrator pass after 37 parallel slot ports of google-adk demos to
match langgraph-python (north-star). Slot commits ported each demo's
frontend verbatim; this commit reconciles the cross-cutting wiring that
slot agents were forbidden from touching:
- registry.py: rename agent keys to match LP frontend agent= props
(10+ underscore→hyphen renames for demos using the main copilotkit
route; demos with dedicated routes keep their underscored backend
keys since the dedicated route handles frontend→backend translation).
- route.ts: agentNames array updated to match registry.
- manifest.yaml: features list now matches the demos that actually
exist; renamed agentic-chat-reasoning→reasoning-custom,
reasoning-default-render→reasoning-default,
byoc-hashbrown→declarative-hashbrown,
byoc-json-render→declarative-json-render; added shared-state-read
(was a working demo dir but not declared); moved shared-state-streaming
out of not_supported_features (it works on Gemini Studio via chunk-
level fallback); retired the standalone hitl demo and the duplicate
hitl-in-chat-booking entry.
- src/app/demos/hitl/ and src/app/demos/shared-state-write/: deleted
(orphaned dirs not in LP's surface).
- src/app/page.tsx: integration dev landing — drop deleted demos.
- src/app/demos/prebuilt-sidebar/page.tsx: revert slot 01's
hyphen→underscore swap; LP's verbatim hyphenated agent= is the
source of truth (registry was renamed to match).
- shared-state-read agent: registry entry swapped from
shared_state_read_agent (had a set_recipe tool, turning it into
read+write) to _simple_chat (matches LP's neutral default agent —
read-only contract).
Known follow-ups (deferred — tracked separately):
- Tool-rendering family backend: ADK currently exposes
get_weather + search_flights(flights list) + query_data; LP
exposes get_weather + search_flights(origin, destination) +
get_stock_price + roll_d20. The 4 tool-rendering demos render
correctly for weather but the LP suggestion pills referencing
stocks and d20 rolls will not produce backend tool calls.
- Subagents agent: emits running/completed/failed; LP frontend
expects completed-only. Mid-flight rows render as raw badge text.
- Agent-config agent: reads state["config"] but LP frontend now
publishes via useAgentContext; agent will receive nothing.
- Beautiful-chat agent: missing manage_todos + generate_a2ui tools
that the LP frontend exercises.
- Open-gen-ui-advanced agent prompt: tells Gemini to call
window.sandbox.* but the LP frontend wires Websandbox.connection.
remote.* — generated UIs will reference a nonexistent API.
- gen-ui-interrupt and interrupt-headless: confirmed BLOCKED.
Gemini/ADK has no interrupt() primitive; the existing ADK Strategy
B (useFrontendTool with async Promise) is the only available
adaptation and cannot match LP's useInterrupt 1:1.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
PR #4691 introduced createPortal from react-dom in search-trigger.tsx
but the shell-docs package was missing @types/react-dom, breaking the
Railway production build with:
Type error: Could not find a declaration file for module 'react-dom'
Hoisting masks this in local dev, but the Docker builder installs
each package's deps in isolation.
Renames the ADK byoc-hashbrown demo to declarative-hashbrown to match the
LP naming, and ports the LP declarative-hashbrown frontend (page + chat +
hashbrown renderer + charts + suggestions + types + metric card) verbatim.
Also renames the dedicated API route from copilotkit-byoc-hashbrown to
copilotkit-declarative-hashbrown, keeping the existing HttpAgent + AGENT_URL
pattern (URL now points at /declarative-hashbrown on the Python backend).
The runtime-side agent ID remains "declarative-hashbrown-demo" (matching
LP); the backend registry / agentNames rename (byoc_hashbrown -> declarative-
hashbrown), the manifest slug rename, and main route.ts agentNames update
are out of scope per the task and are reported separately.
Copies the hitl-in-app demo verbatim from langgraph-python (north-star):
page.tsx, approval-dialog.tsx, suggestions.ts, tickets-panel.tsx. Updates
the ADK agent instruction to match the LP support-operations prompt and
the {approved, reason} tool-return shape.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy page.tsx and time-picker-card.tsx verbatim from the langgraph-python
north-star demo. Delete README.md (not present upstream). Frontend now uses
agent="hitl-in-chat" / agentId="hitl-in-chat" exactly as LP — registry and
route.ts currently key on "hitl_in_chat", which will need a follow-up
rename to wire end-to-end.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Replace the inline-styled brand-palette version with a 1:1 verbatim copy of
the langgraph-python north-star demo: ShadCN-flavoured Card/Badge/Button
primitives under _components/, neutral zinc chart palette, and the
chat.tsx + suggestions.ts split out of page.tsx.
The ADK agent already emits the same a2ui_operations container shape
(via build_a2ui_operations_from_tool_call in agents/main.py) so no
backend changes are needed; the frontend swap is sufficient.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy LP gen-ui-agent demo verbatim: page.tsx now uses InlineAgentStateCard
in messageView.children (subscribing to live state via useAgent v2 +
UseAgentUpdate.OnStateChanged), plus the supporting
InlineAgentStateCard.tsx, message-list-with-state.tsx, suggestions.ts, and
README.md.
Update the ADK gen_ui_agent to emit the same Step shape the LP frontend
reads — {id, title, status} with the three-state lifecycle pending ->
in_progress -> completed, driven by a six-call sequence so the card
animates through every step. Without this, the card would render empty
titles and never show the in_progress marker.
Delete the orphan agent.py stub from the demo dir — the real backend
agent lives in src/agents/gen_ui_agent.py and is wired through the
shared registry.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Verbatim copy of the langgraph-python tool-rendering demo frontend to
google-adk: page.tsx + weather-card + flight-list-card + stock-card +
d20-card + custom-catchall-renderer + suggestions + README. Also adds
the _shared/parse-json-result helper required by page.tsx. Removes the
stale agent.py stub and render-flight-tool.snippet.tsx that don't exist
in the LP north-star.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Mirror the north-star (langgraph-python) mcp-apps demo verbatim: split the
single-file page.tsx into page.tsx + chat.tsx + suggestions.ts, and switch
the agent identifier from "mcp_apps" to "mcp-apps" to match LP exactly.
Update copilotkit-mcp-apps/route.ts to register the HttpAgent under the
"mcp-apps" key so the LP-verbatim frontend resolves. Delete the demo-local
README.md (no LP equivalent).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy LP's tool-rendering-reasoning-chain frontend verbatim: page.tsx with
useRenderTool registrations for get_weather + search_flights and a
useDefaultRenderTool catchall, plus ReasoningBlock, WeatherCard,
FlightListCard, and CustomCatchallRenderer components. Keeps the LP
agent/agentId values ("tool-rendering-reasoning-chain") as required by
the parity north-star.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Bring shared-state-streaming demo frontend to 1:1 parity with the
langgraph-python north-star: split page.tsx into demo-layout.tsx +
suggestions.ts modules, swap CopilotChat-in-aside for
CopilotSidebar+DemoLayout, and adopt LP's DocumentView styling +
testids (document-view, document-live-badge, document-char-count,
document-content).
The ADK agent (shared_state_streaming_agent.py) is already wired with
streaming_function_call_arguments=True on the ADKAgent middleware and
PredictStateMapping(stream_tool_call=True), so per-token (or chunk-level
fallback on Gemini Studio) state-delta streaming into state["document"]
works end-to-end. The 2026-05-07 not_supported_features bucket was
conservative — the wiring is complete and the LIVE badge / growing
document UX functions even on the chunk-level fallback path.
README adjusted from LangGraph's StateStreamingMiddleware to ADK's
PredictStateMapping + streaming_function_call_arguments wording.
Manifest change needed (not in this commit): remove
shared-state-streaming from not_supported_features and add to features.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy the readonly-state-agent-context demo frontend verbatim from
langgraph-python (the north-star) into google-adk. The ADK demo
previously had a different layout (sidebar + CopilotChat with 3 simple
fields); replace it with the LP layout (identity card + activity card +
published-context JSON viewer + CopilotPopup, all on a neutral-50
background with the indigo accent system).
Adds local _components/ shadcn primitives (Badge, Card, Checkbox, Input,
Label, Select), demo-layout.tsx, and suggestions.ts. The page.tsx is
identical to LP — agent="readonly-state-agent-context" and
agentId="readonly-state-agent-context" (dash form) are kept verbatim per
the parity rules; the orchestrator will rename the registry key so the
backend matches.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Verbatim port of langgraph-python's agent-config demo frontend:
page.tsx, config-card.tsx, config-context-relay.tsx, config-types.ts,
demo-layout.tsx, use-agent-config.ts. Keeps agent="agent-config-demo"
and runtimeUrl="/api/copilotkit-agent-config" as in LP.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy the auth demo verbatim from langgraph-python (the parity north-star).
The demo now uses an unauthenticated-first UX with a dedicated SignInCard
landing page; <CopilotKit> mounts only after the user signs in at least
once, sidestepping the transport 401 that would crash <CopilotChat /> on
its initial /info handshake. Once mounted, it persists across the
sign-out -> sign-in cycle so the post-sign-out state actually demonstrates
the runtime rejecting unauthenticated requests in the chat surface.
Workspace plumbing required to make the verbatim port runnable:
- Add shadcn primitives (button, card) and `cn` util at
src/components/ui/* + src/lib/utils.ts.
- Add class-variance-authority, clsx, radix-ui, tailwind-merge to
package.json.
- Extend globals.css with Tailwind v4 @theme tokens that map onto the
shadcn CSS variables (background/foreground/card/muted/border/etc.) so
utilities like `bg-muted` and `text-muted-foreground` actually generate
styles.
The ADK auth API route already had the onRequest bearer-token gate
mirroring LP's pattern; it points at the `_simple_chat`-backed `/auth`
agent path, which is correct per the auth-at-route-level model. No
backend (registry / agent) changes required.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Verbatim copy of the LP beautiful-chat frontend — page.tsx, home-page.tsx,
showcase.json, declarative-generative-ui/, components/ (example-layout,
example-canvas, generative-ui, ui, tool-rendering), hooks/, lib/. The demo
now uses ThemeProvider + CopilotKit with a2ui catalog + openGenerativeUI,
ExampleLayout/Canvas with todos, generative UI chart components, and the
full suggestion-pill set.
Add the dedicated ADK runtime route at /api/copilotkit-beautiful-chat
modelled after the LP route shape but adapted for ADK (HttpAgent +
AGENT_URL pattern, mirroring declarative-gen-ui and mcp-apps routes).
Combined runtime: openGenerativeUI + a2ui.injectA2UITool:false + mcpApps
to support all three flagship surfaces simultaneously, matching LP.
Add missing npm deps to package.json: @radix-ui/react-checkbox,
@radix-ui/react-separator, class-variance-authority, clsx, lucide-react,
tailwind-merge — required by the verbatim-copied shadcn primitives.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Nathan 🔶 Tarbert