Skip to content

agent: delete unused Python stubs (main.py, executor.py, memory.py, tools/{browser,search,writer}.py) — nothing imports them #176

@jravinder

Description

@jravinder

Problem

Six Python files in agent/ are skeleton stubs that no other file imports. They predate the TypeScript pivot and now mislead readers, fail ruff check exemptions, and waste reviewer time when grep'ing the agent surface.

Verified unreferenced (no import sites in agent/, mcp/, or tests/):

File Lines Status
agent/main.py 201 All TODO comments — class TXLookup body is print(...)
agent/executor.py 157 Stub
agent/memory.py 48 Stub with TODO: swap to Supabase
agent/tools/browser.py 52 4x # TODO: Codex — implement
agent/tools/search.py 26 2x # TODO: Codex — implement
agent/tools/writer.py 23 1x # TODO: Codex — implement
mcp/tools.py (small) # TODO: Codex — implement shared utilities

The live runtime uses app/lib/agent.ts for orchestration, app/lib/specialists.ts for delegation, and app/api/agent/route.ts for SSE. The Python mcp/server.py only depends on agent/planner.py, agent/tools/data.py, agent/tools/miro.py.

Fix

  1. git rm the six unreferenced files above
  2. Update AGENTS.md directory-structure block (paired with the docs-drift issue) to drop them
  3. Confirm ruff check agent/ mcp/ still passes
  4. Confirm pytest tests/ still passes (none of the deleted files have associated tests)

If any of these are wanted as future placeholders, leave a single agent/README.md that says "browser/search/writer tools are unimplemented — see app/lib/agent.ts for the live runtime."

Code pointers

  • agent/main.py, agent/executor.py, agent/memory.py
  • agent/tools/browser.py, agent/tools/search.py, agent/tools/writer.py
  • mcp/tools.py
  • Verification: grep -rn 'from agent.main\|from agent.executor\|from agent.memory\|from agent.tools.browser\|from agent.tools.search\|from agent.tools.writer' . returns nothing

Acceptance

  • Six files removed
  • CI still green (lint-python, lint-typescript, catalog-parity)
  • mcp/server.py boots
  • tests/test_mcp_boot.py still passes

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:agentOrchestrator, planner, executor, doom-loopauto-research:2026-05-16Filed by auto-research skill on 2026-05-16enhancementNew feature or requestfleet:readyInternal fleet queue — for pickup-next

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions