am-agents

Unified home for AM AI agents and the Agent Platform.

Component	Location	Port / entry	Status
tool-agent	tool-agent/	HTTP :8141	Active — preferred data/tool executor
db-agent	db-agent/	HTTP :8140	Legacy — compatibility; prefer tool-agent
ui-test-agent	ui-test-agent/	HTTP :8130	Active — Playwright / UI testing
Agent Platform (legacy path)	gateway/ + platform_worker/	Gateway :8090 · Temporal queue agent-platform	Keep until replacement proven
support-agent	support-agent/	Gateway v2 :8091 · queue support-agent-v2	Parallel replacement — delete legacy only after prod gates
UI test (repo-root legacy)	../am-ui-test-agent/	HTTP :8130	Frozen — use ui-test-agent/
Finance	../am-fin-agent/	HTTP :8100	Legacy
Dev CLI	../am-dev-agent/	am-dev CLI	Legacy

Documentation

• Architecture (A2A + parallel replacement) — terminology, A2A protocol, execution flow, production/decommission gates
• support-agent/ module — A2A replacement tree, migration map, adapters, memory, learning, decommission checklist
• Agent platform Temporal design SoT — ports, RunStore, AlertIncident phases (historical + current legacy path)
• Enterprise agent ecosystem — gap analysis, anti-duplication
• Deploy guide — Docker, Helm, Vault, CI/CD
• Monorepo plan — historical copy-in plan (superseded for inventory by this README + architecture docs)
• db-agent design · Universal DB agents plan

Parallel replacement rule

1. Markdown / design first for the new module (current).
2. Build complete support-agent/ alongside existing gateway/worker — do not edit specialist agents.
3. Shadow → canary → soak in production with rollback to legacy.
4. Delete legacy platform code only after production gates + explicit approvals. Never delete Tool / DB / UI Test agents.

Platform ports (legacy SDK)

cd libs/platform-ports
pip install -e ".[dev]"
pytest

Package: am_platform_ports — Protocols + schemas + fakes (no Temporal / no vendors).

Quick starts

tool-agent (preferred)

cd tool-agent
pip install -r requirements.txt
# see tool-agent/README.md for env + npm scripts

db-agent (legacy)

cd am-agents
pip install -r db-agent/requirements.txt
npm run start:preprod

ui-test-agent

cd ui-test-agent
# see ui-test-agent/README.md