feat(chat): expose endAndContinue to custom agents

[gtremper]

Summary

Raw chat.customAgent() loops can now call chat.endAndContinue() to move the Session to a fresh run. The managed loop already used the same server operation through chat.requestUpgrade(), but raw loops could not call it directly.

Call the method between turns after detaching the old run input listeners. Await it and return immediately. Unconsumed .in records stay on the Session for the continuation run.

I put this on the chat namespace next to the other raw chat primitives. Happy to move it if maintainers prefer a different API placement.

Testing

• pnpm exec vitest run in packages/trigger-sdk (376 tests)
• pnpm run build in packages/trigger-sdk
• pnpm run format
• pnpm run lint

Checklist

• I followed the contributing guide
• The PR title follows the convention
• I tested the change

Changelog

Allow custom chat agents to rotate to a new task version without dropping unconsumed Session input.

[changeset-bot]

🦋 Changeset detected

Latest commit: fcefcf5

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

This PR includes changesets to release 29 packages

Name	Type
@trigger.dev/sdk	Patch
@trigger.dev/python	Patch
@internal/dashboard-agent	Patch
@internal/sdk-compat-tests	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
@trigger.dev/rbac	Patch
@trigger.dev/sso	Patch
trigger.dev	Patch
@internal/cache	Patch
@internal/clickhouse	Patch
@internal/llm-model-catalog	Patch
@internal/metrics-pipeline	Patch
@internal/redis	Patch
@internal/replication	Patch
@internal/run-engine	Patch
@internal/run-store	Patch
@internal/schedule-engine	Patch
@internal/tracing	Patch
@internal/tsql	Patch
@internal/webhook-engine	Patch
@internal/webhook-sources	Patch
@internal/testcontainers	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]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 6a4faefb-7c13-4a69-9f31-437f8307aa38

📥 Commits

Reviewing files that changed from the base of the PR and between d62dd0d and fcefcf5.

📒 Files selected for processing (6)

• .changeset/chat-custom-agent-end-and-continue.md
• docs/ai-chat/custom-agents.mdx
• docs/ai-chat/patterns/version-upgrades.mdx
• docs/ai-chat/reference.mdx
• packages/trigger-sdk/src/v3/ai.ts
• packages/trigger-sdk/test/chat-end-and-continue.test.ts

---

Walkthrough

Added chat.endAndContinue() for custom agents. The helper validates custom-agent context and hands the active Session to a fresh continuation run. Managed-agent upgrade handling now uses the shared handoff logic. Tests cover pending input preservation, API arguments, continuation delivery, cleanup, and invalid usage. Documentation describes turn completion, state persistence, listener detachment, version selection, and immediate return requirements.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

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.}

[github-actions]

Hi @gtremper, thanks for your interest in contributing!

This project requires that pull request authors are vouched, and you are not in the list of vouched users.

This PR will be closed automatically. See https://github.com/triggerdotdev/trigger.dev/blob/main/CONTRIBUTING.md for more details.

[gtremper]

This was superseded by #4647