From 36b2e02359043163af5f28f67c0c37cc1cd48043 Mon Sep 17 00:00:00 2001 From: jwbron <8340608+jwbron@users.noreply.github.com> Date: Thu, 4 Jun 2026 16:28:02 +0000 Subject: [PATCH 1/2] docs: add egg_agent_tools to sandbox STRUCTURE.md [doc-updater] The egg_agent_tools/ package was missing from the sandbox section of docs/development/STRUCTURE.md. It hosts the in-process SDK MCP server (45 tools, 7 namespaces) that agents use instead of shelling out to egg-contract/egg-orch. The confluence.py and jira.py modules added in #2994 make this the right moment to document the package layout. Triggered by: d1c2fbd4a (feat(sandbox): expose Confluence/Jira gateway routes as MCP servers #2994 #2996) Authored-by: egg --- docs/development/STRUCTURE.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/development/STRUCTURE.md b/docs/development/STRUCTURE.md index bd3bc377f0..6c19f23125 100644 --- a/docs/development/STRUCTURE.md +++ b/docs/development/STRUCTURE.md @@ -218,6 +218,19 @@ sandbox/ │ ├── egg-pipeline-watch # Real-time pipeline progress viewer via SSE │ ├── egg-orch # Symlink to orch_cli.py │ └── git-credential-github-token +├── egg_agent_tools/ # In-process SDK MCP server: 45 tools across 7 namespaces (sdlc, brc, phase, progress, task, confluence, jira) +│ ├── server.py # build_sandbox_mcp_server(): one SDK server per namespace; SYSTEM_PROMPT_NUDGE generated at import +│ ├── schemas.py # Tool JSON schemas + derive_schema_from_argparse (argparse → JSON Schema) +│ ├── push.py # Gateway push helper (mcp__brc__propose pre-step) +│ ├── handlers/ # Handler functions called by @tool wrappers and CLIs (MCP↔CLI drift gate) +│ │ ├── _gateway.py # gateway_request + gateway_data_request helpers +│ │ ├── confluence.py # Confluence gateway-route handlers (page/space/search/execute; #2994) +│ │ ├── jira.py # Jira gateway-route handlers (ticket CRUD/search/links/execute; #2994) +│ │ └── ... # brc.py, sdlc.py, task.py, phase.py, progress.py, message.py, restrictions.py, brc_memory.py, errors.py +│ └── tools/ # @tool wrappers — one module per namespace, each exports REGISTRATIONS +│ ├── confluence.py # mcp__confluence__* wrappers: 8 read-only gateway mirrors (#2994) +│ ├── jira.py # mcp__jira__* wrappers: 9 gateway mirrors (reads + 4 writes) (#2994) +│ └── ... # brc.py, sdlc.py, task.py, phase.py, progress.py, message.py, _common.py, _registry.py, _tool_compat.py ├── egg_lib/ # Container utility libraries │ ├── cli.py # CLI command handling │ ├── config.py # Configuration management From aed4825e67e863a0ac13c75ade4d263fec9f2a81 Mon Sep 17 00:00:00 2001 From: "egg-reviewer[bot]" <261018737+egg-reviewer[bot]@users.noreply.github.com> Date: Thu, 4 Jun 2026 16:46:05 +0000 Subject: [PATCH 2/2] docs: clarify jira mirror split as 5 reads + 4 writes --- docs/development/STRUCTURE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/development/STRUCTURE.md b/docs/development/STRUCTURE.md index 6c19f23125..41238c83b0 100644 --- a/docs/development/STRUCTURE.md +++ b/docs/development/STRUCTURE.md @@ -229,7 +229,7 @@ sandbox/ │ │ └── ... # brc.py, sdlc.py, task.py, phase.py, progress.py, message.py, restrictions.py, brc_memory.py, errors.py │ └── tools/ # @tool wrappers — one module per namespace, each exports REGISTRATIONS │ ├── confluence.py # mcp__confluence__* wrappers: 8 read-only gateway mirrors (#2994) -│ ├── jira.py # mcp__jira__* wrappers: 9 gateway mirrors (reads + 4 writes) (#2994) +│ ├── jira.py # mcp__jira__* wrappers: 9 gateway mirrors (5 reads + 4 writes) (#2994) │ └── ... # brc.py, sdlc.py, task.py, phase.py, progress.py, message.py, _common.py, _registry.py, _tool_compat.py ├── egg_lib/ # Container utility libraries │ ├── cli.py # CLI command handling