feat: allow PlanAgent task tool to forward subagent stream events via…

[omeraplak]

… supervisorConfig

PR Checklist

Please check if your PR fulfills the following requirements:

• The commit message follows our guidelines: https://voltagent.dev/docs/community/contributing/#commit-convention

Bugs / Features

• Related issue(s) linked
• Tests for the changes have been added
• Docs have been added / updated
• Changesets have been added https://voltagent.dev/docs/community/contributing/#creating-a-changeset

What is the current behavior?

What is the new behavior?

fixes (issue)

Notes for reviewers

---

Summary by cubic

Enable forwarding of subagent stream events in PlanAgent via task.supervisorConfig. Calling planAgent.streamText can now emit subagent tool-call, tool-result, and text-delta events.

• New Features
  • Added task.supervisorConfig with fullStreamEventForwarding.types to pass through subagent events (e.g., ["tool-call", "tool-result", "text-delta"]).
  • Connected supervisorConfig to SubAgentManager and updated docs with usage example.

^{Written for commit 4f34264. Summary will update on new commits.}

Summary by CodeRabbit

• New Features

  • PlanAgent task tool now supports forwarding subagent stream events through supervisor configuration, with configurable event types (tool-call, tool-result, text-delta).

• Documentation

  • Added comprehensive guidance and examples showing how to enable stream event forwarding in PlanAgent initialization.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 4f34264

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

This PR includes changesets to release 1 package

Name	Type
@voltagent/core	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]

📝 Walkthrough

Walkthrough

Introduces stream event forwarding capability to PlanAgent's task tool by adding a supervisorConfig option that carries configuration through to SubAgentManager. Includes type definitions, implementation wiring, documentation, and a changeset entry.

Changes

Cohort / File(s)	Summary
Configuration & Type Updates packages/core/src/planagent/plan-agent.ts	Adds supervisorConfig?: SupervisorConfig to TaskToolOptions type definition and threads this config into SubAgentManager instantiation as the third argument
Documentation & Release Notes .changeset/planagent-task-stream-forwarding.md, website/docs/agents/plan-agent.md	Provides patch release note and usage guidance for forwarding subagent stream events via task.supervisorConfig.fullStreamEventForwarding configuration with supported event types (tool-call, tool-result, text-delta) and code examples

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Poem

🐰 A configuration whisper flows,
Through supervisorConfig it goes,
Stream events forward with delight,
SubAgents coordinated right!
Forwarding magic, clean and bright. ✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and specifically describes the main feature: enabling PlanAgent task tool to forward subagent stream events via supervisorConfig.
Description check	✅ Passed	The description follows the template with most sections completed: commit guidelines checked, docs updated, changesets added. However, related issues are not linked and no tests are mentioned as added.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

---

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

[cubic-dev-ai]

No issues found across 3 files

[cloudflare-workers-and-pages]

Deploying voltagent with    Cloudflare Pages

Latest commit:	4f34264
Status:	✅  Deploy successful!
Preview URL:	https://f8b94371.voltagent.pages.dev
Branch Preview URL:	https://feat-plan-agent-supervisor-c.voltagent.pages.dev

View logs