[Feature Request] Add public plan-then-run API and stronger event/state guarantees to Workforce

[fengju0213]

Required prerequisites

• I have searched the Issue Tracker and Discussions that this hasn't already been reported. (+1 or comment there if it has.)
• Consider asking first in a Discussion.

Motivation

Applications that need a "plan → edit → run" workflow must subclass Workforce and override internal methods. Specifically:

• No public planning API — handle_decompose_append_task() decomposes and immediately appends to the pending queue. There is no way to decompose, inspect/edit the plan, and then execute separately.
• Event metadata insufficient — WorkerCreatedEvent, TaskAssignedEvent, TaskStartedEvent, TaskCompletedEvent lack fields like agent_id, task_content, failure_count, pool_config. Applications must read internal state to build UI notifications.
• task.subtasks out of sync — when a subtask completes or fails, parent.subtasks[*].state/result is not updated. Applications must manually sync with _sync_subtask_to_parent() overrides.

Scope

Workforce orchestration only. ChatAgent callbacks and SingleAgentWorker streaming are tracked separately.

Solution

No response

Alternatives

No response

Additional context

No response