DeepAgent Example — Porting Plan

Status: Complete Epic: 11 — DeepAgent Example Port Date: 2026-03-11

1. Motivation

The examples/advanced/deepagent/ directory is a multi-agent ReAct system originally built on the openjiuwen framework. This plan inventories every openjiuwen dependency, maps each to its Exo equivalent, and defines the porting order for subsequent stories.

2. File-by-File Inventory

2.1 Files WITH openjiuwen Imports (Must Port)

2.2 Files WITHOUT openjiuwen Imports (No Changes Needed)

3. Dependency Graph

agent/utils.py                 ← openjiuwen.logging (leaf — no internal deps)
agent/context_manager.py       ← openjiuwen.logging (leaf)
agent/qa_handler.py            ← openjiuwen.logging (leaf)
agent/prompt_templates.py      ← (no openjiuwen — standalone)

agent/super_config.py          ← openjiuwen.agent.config, openjiuwen.agent.schema, openjiuwen.model_config
                                  (depends on: nothing internal)

agent/tool_call_handler.py     ← openjiuwen.runtime, openjiuwen.logging, openjiuwen.tool
                                  (depends on: agent/utils.py for logging)

agent/super_factory.py         ← openjiuwen.tool, openjiuwen.workflow, openjiuwen.model_config, openjiuwen.schema
                                  (depends on: super_config.py, tool_call_handler.py)

agent/super_react_agent.py     ← openjiuwen.agent, openjiuwen.runtime, openjiuwen.tool, openjiuwen.logging,
                                  openjiuwen.messages, openjiuwen.runner
                                  (depends on: super_config.py, super_factory.py, tool_call_handler.py,
                                   context_manager.py, qa_handler.py, utils.py)

llm/__init__.py                ← openjiuwen.model_config (leaf)

test/super_react_agent_test_run.py ← depends on everything above

4. Porting Order (Leaves First)

5. Files That Need No Changes

The following directories contain zero openjiuwen imports and work independently:

• tool/browser/ — Browser automation using browser_use + playwright
• tool/browser/utils/ — Image/token/function utilities
• tool/browser/utils/utils/ — Duplicate of above (candidate for cleanup)
• tool/mcp_servers/ — All MCP servers use fastmcp, langchain, etc.
• tool/mcp_servers/utils/ — Search engine wrappers
• agent/prompt_templates.py — Pure string templates
• tool/logger.py — Standalone logging utility
• llm/openrouter_llm.py — Uses OpenAI SDK directly
• llm/openrouter_function_call_example.py — Standalone example

6. Action Per File: Delete vs. Rewrite vs. Light Edit

7. Risk Assessment

8. Reference: DeepSearch Example Structure

The completed examples/advanced/deepsearch/ port demonstrates the target patterns:

• Config: Pydantic BaseModel with from_env() classmethod
• Agent assembly: build_deep_agent(config) → Swarm function
• Tools: Subclass Tool ABC with name, description, parameters, async execute()
• Prompts: Pure functions returning formatted strings
• Entry: __main__.py with argparse CLI → async main
• Memory: Custom classes with JSON persistence

9. Summary

• 64 total Python files in deepagent
• 9 files require porting (have openjiuwen imports)
• ~45 files need no changes (browser tools, MCP servers, utilities)
• ~10 files are candidates for cleanup (duplicate utils directory)
• Highest risk: super_react_agent.py (9 imports, core agent logic)
• Lowest risk: Logging swaps in utils.py, context_manager.py, qa_handler.py
• Porting order: leaves (logging) → config → handlers → factory → core agent → test

10. Completion Summary

Date completed: 2026-03-11

All 9 files with openjiuwen imports have been successfully ported to use Exo equivalents:

1. agent/utils.py — Replaced openjiuwen logging with stdlib logging
2. agent/context_manager.py — Swapped logger import to stdlib
3. agent/qa_handler.py — Swapped logger import to stdlib
4. agent/super_config.py — Rewritten as standalone Pydantic BaseModel classes
5. agent/tool_call_handler.py — Replaced openjiuwen Runtime/Tool with Exo equivalents
6. agent/super_factory.py — Rewired to use exo.agent.Agent and exo.swarm.Swarm
7. agent/super_react_agent.py — Core agent rewritten using Exo Agent + MCP client + Swarm
8. llm/init.py — Replaced ModelConfig import
9. test/super_react_agent_test_run.py — Updated all imports and config to Exo

Validation:

• grep -r 'openjiuwen' examples/advanced/deepagent/ returns zero matches
• pyproject.toml depends only on exo-core, exo-models, exo-mcp
• Stale uv.lock removed (will be regenerated when exo packages are published)
• README updated to reference Exo instead of openjiuwen