docs(sdk): describe chat.turn() in the advanced chat agent skill

[ericallam]

Summary

The bundled trigger-chat-agent-advanced skill still told agents to answer from an action by returning a value, an API #4816 removed. Code generated from it fails at runtime with the chat.turn() error.

Before, the skill said:

onAction: async ({ action, streamText }) => {
  if (action.type === "regenerate") {
    chat.history.slice(0, -1);
    return streamText({ model, messages });
  }
},

After:

onAction: async ({ action }) => {
  if (action.type === "undo") chat.history.slice(0, -2); // edit only
  if (action.type === "regenerate") {
    chat.history.slice(0, -1);
    return chat.turn(); // answer the edited history
  }
},

The section now covers edit-only actions, chat.turn() and the action-turn trigger, persistence for both the platform-managed and hydrateMessages models, and sending actions through useChat (body.action or useChatActions) so the answer renders, with transport.sendAction noted as the raw-stream path.

Docs-only change to an SDK-bundled skill; no changeset, since the chat.turn() release note from #4816 already covers the behavior.

Raised by Devin on #4884 after merge.

🤖 Generated with Claude Code

https://claude.ai/code/session_01AxuSksX18bj1yhnLpkcQ6a

[changeset-bot]

⚠️ No Changeset found

Latest commit: f3d614d

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Team

Run ID: e78400af-8163-46e8-b3c1-2bb317f04f20

📥 Commits

Reviewing files that changed from the base of the PR and between 7fb8310 and f3d614d.

📒 Files selected for processing (1)

• packages/trigger-sdk/skills/trigger-chat-agent-advanced/SKILL.md

Included review availability: Your plan provides up to 10 included reviews per hour; 9 remain after this review.

📜 Recent review details

⏰ Context from checks skipped due to timeout. (42)

• GitHub Check: webapp / 🧪 Unit Tests: Webapp (17, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (20, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (8, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (19, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (15, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (16, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (18, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (23, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (11, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (21, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (24, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (10, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (12, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (7, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (14, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (1, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (4, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (9, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (6, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (13, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (22, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (3, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (5, 24)
• GitHub Check: webapp / 🧪 Unit Tests: Webapp (2, 24)
• GitHub Check: sdk-compat / Node.js 26.4 (warp-ubuntu-latest-x64-4x)
• GitHub Check: sdk-compat / Node.js 20.20 (warp-ubuntu-latest-x64-4x)
• GitHub Check: sdk-compat / Node.js 22.23 (warp-ubuntu-latest-x64-4x)
• GitHub Check: sdk-compat / Node.js 24.18 (warp-ubuntu-latest-x64-4x)
• GitHub Check: packages / 🧪 Unit Tests: Packages (1, 3)
• GitHub Check: sdk-compat / Deno Runtime
• GitHub Check: packages / 🧪 Unit Tests: Packages (3, 3)
• GitHub Check: sdk-compat / Bun Runtime
• GitHub Check: internal / 🧪 Unit Tests: Internal
• GitHub Check: sdk-compat / Cloudflare Workers
• GitHub Check: packages / 🧪 Unit Tests: Packages (2, 3)
• GitHub Check: e2e-webapp / 🧪 E2E Tests: Webapp (2, 2)
• GitHub Check: e2e-webapp / 🧪 E2E Tests: Webapp (1, 2)
• GitHub Check: runops-guard / runops-guard
• GitHub Check: fk-cascade-guard / fk-cascade-guard
• GitHub Check: code-quality / code-quality
• GitHub Check: Analyze (javascript-typescript)
• GitHub Check: Build and publish previews

🧰 Additional context used

📓 Path-based instructions (1)

Add crumbs as you write code — not just when debugging.

📄 CodeRabbit inference engine (AGENTS.md)

Files:

• packages/trigger-sdk/skills/trigger-chat-agent-advanced/SKILL.md

🔇 Additional comments (1)

packages/trigger-sdk/skills/trigger-chat-agent-advanced/SKILL.md (1)

188-197: LGTM!

Also applies to: 200-200, 202-202, 210-210, 214-214, 216-219, 226-229

---

Walkthrough

The actions documentation now separates edit-only actions from actions that call chat.turn(). It removes the previous streamText response behavior and documents normal turn processing for returned turns. The example adds message deletion and regeneration. Submission guidance now covers useChat, useChatActions, regenerate, and transport.sendAction.

Merge Risk: ⚪ Minimal · up to f3d61

This updates bundled chat-agent guidance to use chat.turn() for action-triggered responses and documents supported submission paths. The documented behavior is aligned with existing implementation coverage, with no remaining merge-blocking risk.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description clearly explains the change and its purpose, but it does not follow the required template. It omits the issue-closing line, checklist, Testing section, Changelog section, and Screensho…	Add the required template sections. Include the issue reference, complete the checklist, describe testing steps, add a short changelog entry, and state whether screenshots are applicable.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and concisely describes the main documentation change: adding guidance for chat.turn() in the advanced chat agent skill.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Full details: Description check

Explanation

The description clearly explains the change and its purpose, but it does not follow the required template. It omits the issue-closing line, checklist, Testing section, Changelog section, and Screenshots section.

• Fix all pre-merge checks with AI

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/skill-actions-chat-turn

---

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