test(tools): comprehensive test suite for workflow_tool module (+60 tests)

[manus-use]

Summary

Comprehensive test suite for the manus_agent.tools.workflow_tool module — 60 fully-mocked tests covering the ManusWorkflowManager class and the workflow_tool() entry-point function.

What's tested

ManusWorkflowManager.init (3 tests)

• Agent registry creation with all 4 agent types
• Empty agent instance cache on init
• Config.from_file() invocation

ManusWorkflowManager.get_agent_for_task (9 tests)

• Default agent type routing (→ manus)
• Explicit routing for all 4 agent types (manus, browser, data_analysis, mcp)
• Unknown agent_type fallback to ManusAgent
• Agent instance caching (same type returns cached instance)
• system_prompt forwarding to agent constructor
• No system_prompt omits keyword

ManusWorkflowManager.execute_task (20 tests)

• String result normalization
• None result handling
• Dict result with content list/string/None/other-type
• Dict result with stop_reason='error'
• Object result with .content attribute (list/string/None)
• Unexpected result type fallback (stringification)
• Dependency context injection (completed deps, non-completed excluded, missing result excluded)
• No dependencies key
• Multiple dependencies contributing context
• Missing dependency in task_results (no crash)
• Coroutine results (asyncio.run path)
• Async agent returning dict/None
• Exception during execution

ManusWorkflowManager.create_workflow (7 tests)

• Basic creation success
• Default priority assignment
• UUID generation for empty workflow_id
• Store failure propagation
• Exception handling
• Status initialization ('created')
• task_results pending initialization

workflow_tool() entry point (15 tests)

• All 5 actions: create, start, list, status, delete
• Validation: missing tasks, missing workflow_id
• Unknown action error
• Missing toolUseId UUID generation
• Top-level exception handling
• kwargs forwarding to manager context
• Explicit workflow_id usage

TOOL_SPEC validation (3 tests)

• Correct name
• Non-empty description
• Agent type enum completeness

Edge cases (3 tests)

• Multiple result items in dependency
• Empty description task
• Explicit workflow_id in create

Test methodology

• 100% mocked — no real HTTP calls, no filesystem, no Docker
• All agent classes, Config, and WorkflowManager base are mocked
• Tests verify internal routing, result normalization, and error handling
• Async coroutine paths tested with real asyncio.run()

Test results

1218 passed, 3 deselected, 3 warnings in 24.53s

(Baseline: 1158 + 60 new = 1218 total, 0 failures)

Open PRs checked (no overlap)

Checked all 50+ open PRs. Specifically confirmed no overlap with:

• test(tools): comprehensive test suite for code_execute module (+45 tests) #141 (code_execute tests)
• test(tools): comprehensive test suite for http_request truncation wrapper (+36 tests) #140 (http_request tests)
• test(cli): comprehensive test suite for manus-agent poc-search subcommand (+57 tests) #139 (poc-search CLI tests)
• test(tools): comprehensive test suite for track_vendor_response (+67 tests) #137 (track_vendor_response tests)
• test(tools): comprehensive test suite for verify_exploit tool function (+49 tests) #145 (verify_exploit tests)\n- test(sandbox): comprehensive test suite for exploit_sandbox module (+76 tests) #144 (exploit_sandbox tests)
• test(sandbox): comprehensive test suite for docker_sandbox module (+69 tests) #143 (docker_sandbox tests)
• test(utils): comprehensive test suite for docker_client module (+84 tests) #142 (docker_client tests)
• test(tools): comprehensive test suite for obtain_cves module (+49 tests) #147 (obtain_cves tests)
• test(core-tools): comprehensive test suite for check_cisa_kev, get_nvd_data, get_cwe_details, get_otx_cve_details #89, test(tools): comprehensive test suite for search_exploit_db, search_packetstorm, query_threat_intelligence_feeds, obtain_cves #90 (core tools / exploit search tests)

No existing open or merged PR covers workflow_tool.py testing. The only reference to WorkflowAgent in tests is a single import check in test_packageability.py.