[Bug]: All examples/templates fail with TypeError on first run — entry_points kwarg removed from AgentHost in a5b17a29

[sachin180119]

Summary

Every template in examples/templates/ (12 templates: deep_research_agent, competitive_intel_agent, tech_news_reporter, local_business_extractor, job_hunter, email_inbox_management, email_reply_agent, meeting_scheduler, sdr_agent, twitter_news_agent, vulnerability_assessment, investment_research_agent) crashes on first run with:

TypeError: AgentHost.__init__() got an unexpected keyword argument 'entry_points'

This blocks the documented quickstart path for new contributors, since the templates README and CONTRIBUTING.md point new users to run these.

Reproduction

git clone https://github.com/aden-hive/hive.git
cd hive
uv sync
PYTHONPATH=core:examples/templates uv run python -m deep_research_agent run --topic "AI"

Result: TypeError as above. Same error for every other template.

Root cause

Commit a5b17a29 (refactor: simplify agent loading, Apr 7) replaced the create_agent_runtime(entry_points=...) factory with a direct AgentHost(...) call in each template's agent.py:

-self._agent_runtime = create_agent_runtime(
+self._agent_runtime = AgentHost(
     graph=...,
     ...
     entry_points=entry_point_specs,

But AgentHost.__init__ (core/framework/host/agent_host.py:125) does not accept entry_points. The new API exposes register_entry_point(spec) for that purpose. The factory presumably called it internally; the templates were migrated to call the constructor directly but the entry_points= line was never removed and the follow-up register_entry_point calls were never added.

Secondary issue (same scope)

Every template's README (e.g. examples/templates/deep_research_agent/README.md) documents a --mock flag that no longer exists on the run subcommand. Either the flag should be re-added to the CLI or the README updated. I'd suggest adding --mock back since templates already plumb mock_mode through agent.run().

Proposed fix

In each agent.py _setup():

self._agent_runtime = AgentHost(
    graph=self._graph,
    goal=self.goal,
    storage_path=self._storage_path,
    # ...other kwargs, without entry_points
)
for spec in entry_point_specs:
    self._agent_runtime.register_entry_point(spec)

Plus re-add --mock to each template's __main__.py run command (or update each README).

I'd like to work on this — happy to send a single PR covering all 12 templates and the README/CLI mismatch, with mock-mode runs of each template added to test verification.

Environment

• macOS 25.4.0 (Darwin)
• Python 3.11.15
• uv 0.11.8
• main @ e7d4ce0

[sachin180119]

Correction on the scope: 8 of the existing templates are broken on main, not 12.

• 3 templates (competitive_intel_agent, tech_news_reporter, vulnerability_assessment) pass entry_points to GraphSpec (which legitimately accepts it as dict[str, str]), not to AgentHost, so they don't hit the regression.
• 1 template I named earlier (investment_research_agent) does not exist on main — it was something I had locally. Ignore it for this issue; I'll send it as a separate "new template" PR later.

The 8 broken templates on main that call AgentHost(entry_points=...):

1. deep_research_agent
2. email_inbox_management
3. email_reply_agent
4. job_hunter
5. local_business_extractor
6. meeting_scheduler
7. sdr_agent
8. twitter_news_agent

Confirmed via grep -l "self._agent_runtime = AgentHost" examples/templates/*/agent.py on e7d4ce00.

While preparing the fix locally I also hit 3 secondary regressions that were masked by the TypeError (validate didn't reach them before):

• email_inbox_management/__main__.py imports InboxManagementAgent, but the class is EmailInboxManagementAgent.
• sdr_agent/agent.py imports AsyncEntryPointSpec from framework.orchestrator.edge, but that class no longer exists.
• job_hunter/agent.py's validate() returns {"valid", "errors"} only — every other template returns {"valid", "errors", "warnings"}, and __main__.py accesses validation["warnings"], so validate crashes with KeyError: 'warnings'.

Plus deep_research_agent/__main__.py is missing --mock (the README documents it, and agent.run(mock_mode=...) is plumbed all the way through).

I'll bundle these in the same PR since they all came from the same refactor era and all gate "templates work for new contributors." Happy to split if you'd prefer narrower PRs.