[CORRECTION] Workflow docs show pause/resume examples, but both actions are unimplemented stubs in strands-agents-tools

[strandly-the-agent]

TL;DR: The Agent Workflows page shows a runnable pause/resume example for the built-in workflow tool, but both actions have never been implemented — strands-agents-tools (v0.8.6 and current main) returns 🚧 Action 'pause' is not yet implemented. The example should be removed or marked as planned.

Documentation Location

https://strandsagents.com/docs/user-guide/concepts/multi-agent/workflow/ — source file site/src/content/docs/user-guide/concepts/multi-agent/workflow.mdx, section Key Parameters and Features → Advanced Features → 1. Persistent State Management.

Current Content

1. Persistent State Management
   • Pause and resume workflows
   • Recover from failures automatically
   • Inspect intermediate results

# Pause and resume example
agent.tool.workflow(action="pause", workflow_id="data_analysis")
agent.tool.workflow(action="resume", workflow_id="data_analysis")

Correction Needed

pause and resume are not implemented in the workflow tool. Suggested fix: drop the “Pause and resume workflows” bullet and the code example, or explicitly mark them as planned / not yet implemented.

Note the page is already internally inconsistent: its Basic Parameters line correctly lists action as (create, start, status, list, delete) — the Advanced Features section then shows pause/resume as if they work.

Supporting Evidence

• Both actions hit an explicit stub in strands-agents/tools — workflow.py#L1159-L1163 @ current main: returns 🚧 Action '{action}' is not yet implemented. Same behavior in v0.8.6, the latest PyPI release.
• The tool's own docstring marks both as future — workflow.py#L969-L970: "pause": Pause workflow execution (future).

Reproduction (clean venv, strands-agents-tools 0.8.6)

from strands import Agent
from strands_tools import workflow

agent = Agent(tools=[workflow], callback_handler=None)
agent.tool.workflow(action="create", workflow_id="demo_test", tasks=[
    {"task_id": "step1", "description": "Say hello"},
    {"task_id": "step2", "description": "Say goodbye", "dependencies": ["step1"]},
])  # -> status: success
print(agent.tool.workflow(action="pause", workflow_id="demo_test"))
print(agent.tool.workflow(action="resume", workflow_id="demo_test"))
agent.tool.workflow(action="delete", workflow_id="demo_test")

Output:

{'status': 'error', 'content': [{'text': "🚧 Action 'pause' is not yet implemented"}], 'toolUseId': 'tooluse_workflow_844920205'}
{'status': 'error', 'content': [{'text': "🚧 Action 'resume' is not yet implemented"}], 'toolUseId': 'tooluse_workflow_883652695'}

(Direct tool calls — no model invocation needed, so this reproduces in any environment.)

Additional Information

Originally reported by a community user; verified independently before filing. If pause/resume ship in strands-agents-tools later, the example can simply be restored — this issue only asks for the docs to match today's behavior.