Vyasa Extension Refactor Audit and Execution Plan

Architecture Decision FrameworkURL copied

Deepening OpportunitiesURL copied

10. Agent ModuleURL copied

Files:

• vyasa/agent.py

• any routes or UI that call it

Problem:

• Agent behavior likely depends on true external providers.

• It does not belong in mandatory core unless every Vyasa site needs it.

Solution:

• Move to builtin:agent or keep disabled by default.

• Define a provider port at the extension seam.

• Use an in-memory adapter in tests.

• Use provider adapters only inside the extension.

Benefits:

• Leverage: agent features become optional without core imports.

• Locality: provider-specific behavior stays in one extension.

• Tests: no network dependency in core tests.