feat: ai-chat reference project + MCP agent-chat tooling (4/4)

[ericallam]

Summary

A complete Next.js reference project that exercises chat.agent end-to-end, plus the CLI MCP tools that let Claude Code, Cursor, and similar IDE agents drive a deployed chat.agent task from the editor. Builds on #3545.

Design

references/ai-chat is a full Next.js app: prisma-backed persistence, multi-chat sidebar, per-chat model picker, debug panel, tool examples (getCurrentTime, searchHackerNews, createGithubIssue, PR review helpers, code sandbox), and smoke tests. It's intended both as a copy-paste starting point and as a place to regression-test SDK changes.

The CLI gains MCP tools (start_agent_chat, send_agent_message, close_agent_chat, list_agents) so an IDE agent can converse with a deployed chat.agent task. The dev runtime adds one-shot OOM kill on the run controller and skills bundling in the build pipeline.

Test plan

• cd references/ai-chat && pnpm install && pnpm trigger:dev
• Open the Next.js app, create a chat, exchange messages, verify persistence across reloads
• Trigger a tool requiring HITL approval, approve from the UI, verify resume
• From an IDE agent, call start_agent_chat against the running dev task, send a message, verify the response streams back

Stack

Part of a 4-PR stack. Merge bottom-up.

1. feat: Sessions dashboard, task_kind, and chat-ready hardening (1/4) #3542 → main — Sessions dashboard + chat-ready hardening
2. feat(sdk): chat.agent — runtime + browser transport (2/4) #3543 → feat: Sessions dashboard, task_kind, and chat-ready hardening (1/4) #3542 — chat.agent runtime + browser transport
3. feat(webapp): agent-view dashboard for chat.agent runs (3/4) #3545 → feat(sdk): chat.agent — runtime + browser transport (2/4) #3543 — agent-view dashboard
4. This PR (feat: ai-chat reference project + MCP agent-chat tooling (4/4) #3546) → feat(webapp): agent-view dashboard for chat.agent runs (3/4) #3545

[changeset-bot]

🦋 Changeset detected

Latest commit: e908afb

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 30 packages

Name	Type
@trigger.dev/sdk	Patch
trigger.dev	Patch
@trigger.dev/python	Patch
@internal/sdk-compat-tests	Patch
references-ai-chat	Patch
d3-chat	Patch
references-d3-openai-agents	Patch
references-nextjs-realtime	Patch
references-realtime-hooks-test	Patch
references-realtime-streams	Patch
references-telemetry	Patch
@trigger.dev/build	Patch
@trigger.dev/core	Patch
@trigger.dev/react-hooks	Patch
@trigger.dev/redis-worker	Patch
@trigger.dev/rsc	Patch
@trigger.dev/schema-to-json	Patch
@trigger.dev/database	Patch
@trigger.dev/otlp-importer	Patch
@internal/cache	Patch
@internal/clickhouse	Patch
@internal/llm-model-catalog	Patch
@internal/redis	Patch
@internal/replication	Patch
@internal/run-engine	Patch
@internal/schedule-engine	Patch
@internal/testcontainers	Patch
@internal/tracing	Patch
@internal/tsql	Patch
@internal/zod-worker	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 194ee2e4-5b7a-4000-b2ae-2bb081f03017

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/ai-chat-reference-and-cli

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[devin-ai-integration]

Devin Review found 2 potential issues.

View 4 additional findings in Devin Review.

[devin-ai-integration]

🔴 Resetting lastEventId to undefined on upgrade causes SSE replay of entire session history

In collectAgentResponse, when a trigger:upgrade-required chunk is received, session.lastEventId is set to undefined (line 390) before recursively calling collectAgentResponse. The recursive call creates a new SSEStreamSubscription using session.lastEventId (now undefined) as the lastEventId option (agentChat.ts:338), which means the new subscription replays the entire session .out stream from the very beginning.

Since session .out is a durable stream containing all historical chunks across runs, the replayed events will include old turns' trigger:turn-complete chunks. The first historical trigger:turn-complete hit (line 366-368) immediately breaks the collection loop, causing the function to return with empty/partial text from a previous turn instead of the new run's response.

Expected fix

Keep session.lastEventId as-is (pointing to the trigger:upgrade-required chunk's SSE id) so the recursive subscription resumes right after the upgrade marker, where the new run's output will appear.

Suggested change

	session.lastEventId = undefined;
	reader.releaseLock();

---

Was this helpful? React with 👍 or 👎 to provide feedback.

[devin-ai-integration]

🚩 managed-index-controller adds prompts but not skills to worker registration payload

Both dev-index-worker.ts:187 and managed-index-worker.ts:183 now emit skills: resourceCatalog.listSkillManifests() in their worker manifests. The managed-index-controller.ts forwards tasks, prompts (newly added at line 107), and queues to the server — but does NOT forward skills. If skills need to be registered server-side (for dashboard display, deploy metadata, etc.), this omission would silently drop them in the managed (production) indexing path. Could be intentional if skills are only used at runtime and don't need server-side registration, but it's asymmetric with the prompts addition in the same PR.

---

Was this helpful? React with 👍 or 👎 to provide feedback.