fix: project agents not discoverable in get_available_agents_dict

[wgnrai]

Bug

get_available_agents_dict(project_name) receives the project name but drops it before calling get_agents_dict(), so the project agent scan block (if project_name: at line 79) never executes. All project-level agent profiles under .a0proj/agents/ are invisible to call_subordinate at runtime.

The same bug exists in _normalize_subagents() in helpers/projects.py — project_name is not forwarded to get_agents_dict(), and the function signature does not accept it.

Impact

• call_subordinate profile validation cannot find project-scoped agents at runtime
• The system prompt available profiles list omits all project agents
• The WebUI project settings page cannot see project-level agents
• Project-level agent overrides in agents.json have no effect because _normalize_subagents cannot resolve project agent names

Root cause

Both functions already accept project_name as a parameter (or have it available in their calling scope). get_agents_dict() already has the project scan logic. The argument is simply never forwarded.

# helpers/subagents.py:322
def get_available_agents_dict(project_name: str | None) -> dict[...]:
    all_agents = get_agents_dict()  # ← project_name not forwarded

# helpers/projects.py:664-669
def _normalize_subagents(subagents_data) -> dict[...]:
    # project_name not in signature, not forwarded
    agents_dict = subagents.get_agents_dict()

Fix

Two changes, 6 insertions / 5 deletions:

helpers/subagents.py — forward project_name:

-    all_agents = get_agents_dict()
+    all_agents = get_agents_dict(project_name)

helpers/projects.py — thread project_name through _normalize_subagents:

 def _normalize_subagents(
-    subagents_data: dict[str, SubAgentSettings]
+    subagents_data: dict[str, SubAgentSettings],
+    project_name: str,
 ) -> dict[str, SubAgentSettings]:
     from helpers import subagents
-    agents_dict = subagents.get_agents_dict()
+    agents_dict = subagents.get_agents_dict(project_name)

Both callers (load_project_subagents(name) and save_project_subagents(name, ...)) updated to pass name:

-    return _normalize_subagents(data)
+    return _normalize_subagents(data, name)
-    normalized = _normalize_subagents(subagents_data)
+    normalized = _normalize_subagents(subagents_data, name)

Safety

• No new logic — the project scan block already exists and is tested
• When project_name=None (no project context), behavior is identical to current (project scan skipped, same as now)
• Default, plugin, and user agents follow the same discovery path, unaffected

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f1881540d1

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Update helper DOX for project-scoped discovery

This behavior change makes get_available_agents_dict(project_name) include project-local agents, and the same commit also changes project subagent normalization to resolve through the project name, but the matching helpers/subagents.py.dox.md / helpers/projects.py.dox.md files were not updated. In this repo, helper behavior changes are supposed to keep the same-directory file-level DOX synchronized so future callers can rely on the documented cross-module contract.

AGENTS.md reference: helpers/AGENTS.md:L21-L23

Useful? React with 👍 / 👎.