version: "1.0.0" name: verify description: Build and drive the copilot-kit-ag-ui demo to verify changes end-to-end.

Verifying changes to this demo

Build and drive the real server. npm run typecheck is CI's job, not evidence.

Without Anthropic credentials or provisioned agents

The server boots and serves everything except a live agent turn with stub IDs:

npm install && npm run build
ANTHROPIC_API_KEY=sk-ant-test ANTHROPIC_ENVIRONMENT_ID=env_x \
  ANTHROPIC_AGENT_ID=agent_x ANTHROPIC_AGENT_VERSION=1 PORT=8799 npm start

Probes that exercise the wiring:

• GET :8799/ returns the built web/dist/index.html (there is no SPA catch-all, so unknown paths 404).
• GET :8799/api/copilotkit/info lists the registered agents, confirming agent id and class registration without an API call.
• POST :8799/api/copilotkit/agent/financial-assistant/run with an AG-UI body ({"threadId":"t1","runId":"r1","messages":[{"id":"m1","role":"user","content":"hi"}],"state":{},"tools":[],"context":[],"forwardedProps":{}}) reaches the AG-UI adapter and fails with a 401 from Anthropic. That 401 in the SSE RUN_ERROR proves the full route-to-SDK path.
• CORS: send OPTIONS with an Origin header. With ALLOWED_ORIGINS set, allowed origins get Access-Control-Allow-Origin echoed and others get none.
• VITE_COPILOT_RUNTIME_URL=... npm run build then grep web/dist/assets for the URL to confirm build-time baking.

With real credentials

npm run setup once, npm run dev, open http://localhost:5173, send a prompt that triggers a visual tool ("show me a growth projection for $500/month at 7%") and confirm the chart renders inline.

Gotchas

• Boot requires agent identity: either agent-ids.json (from npm run setup) or the three ANTHROPIC_* ID env vars. Missing both is a deliberate boot failure.
• Static serving only activates when web/dist exists, so run npm run build before npm start probes.