lhumina_code/home

Fork 0

[nu-demo] service_agent.nu is missing — hero_agent not installable via service_install_all #135

New issue

Closed

opened 2026-04-23 23:15:54 +00:00 by mik-tf · 1 comment

mik-tf commented

2026-04-23 23:15:54 +00:00

Owner

Symptom

Fresh install has no AI chat backend. The AI Assistant island shows:

HTTP 404: Socket ui.sock not found for hero_agent

because hero_agent is never installed or started.

Root cause

hero_agent has an --start/--stop CLI that self-registers with hero_proc, but hero_skills has no service_agent.nu module. It is therefore not included in packages.nu::service_install_all, and there is no standard way to bring it up via the nu orchestrator.

Demo workaround (applied 2026-04-23)

git clone https://forge.ourworld.tf/lhumina_code/hero_agent ~/hero/code0/hero_agent
cd ~/hero/code0/hero_agent
cargo build --release
hero_agent --start

Proper fix

Add service_agent.nu to hero_skills/tools/modules/services/, matching the pattern of service_aibroker.nu. Include it in packages.nu::service_install_all.

IMPORTANT: the action env must include BOTH OPENROUTER_API_KEY AND OPENROUTER_API_KEYS (plural is what hero_agent's config.rs reads — see companion issue). Without that, chat fails with 401.

Filed 2026-04-23 nu-shell demo bring-up. Signed-off-by: mik-tf

## Symptom Fresh install has no AI chat backend. The AI Assistant island shows: ``` HTTP 404: Socket ui.sock not found for hero_agent ``` because hero_agent is never installed or started. ## Root cause hero_agent has an `--start`/`--stop` CLI that self-registers with hero_proc, but hero_skills has no `service_agent.nu` module. It is therefore not included in `packages.nu::service_install_all`, and there is no standard way to bring it up via the nu orchestrator. ## Demo workaround (applied 2026-04-23) ``` git clone https://forge.ourworld.tf/lhumina_code/hero_agent ~/hero/code0/hero_agent cd ~/hero/code0/hero_agent cargo build --release hero_agent --start ``` ## Proper fix Add `service_agent.nu` to `hero_skills/tools/modules/services/`, matching the pattern of `service_aibroker.nu`. Include it in `packages.nu::service_install_all`. IMPORTANT: the action env must include BOTH `OPENROUTER_API_KEY` AND `OPENROUTER_API_KEYS` (plural is what hero_agent's `config.rs` reads — see companion issue). Without that, chat fails with 401. Filed 2026-04-23 nu-shell demo bring-up. Signed-off-by: mik-tf

mik-tf referenced this issue

2026-04-24 01:12:24 +00:00

[nu-demo] Documentation index: heronu deployment flow, AI grounding chain, per-service gaps #148

mik-tf referenced this issue

2026-04-24 01:20:01 +00:00

[nu-demo] hero_agent prompt.rs: tool-use directive for hero_* questions needs strengthening (and reliable rebuild) #149

mik-tf referenced this issue

2026-04-24 02:48:10 +00:00

[nu-demo] CANONICAL — Intelligence pipeline documented end-to-end: hero_agent ↔ aibroker ↔ embedder ↔ hero_books ↔ docs_hero #159

mik-tf referenced this issue

2026-04-24 03:33:33 +00:00

[ops] Single make demo target — provision + install + seed + verify a fresh Hero OS demo VM in one command #163

mik-tf referenced this issue

2026-04-24 14:48:15 +00:00

[nu-demo] service_install_all ends with no running services — registers action defs but doesn't call service.set, so hero_proc service start returns 'service not found' #167

mik-tf commented

2026-04-27 01:51:08 +00:00

Author

Owner

Fixed in hero_skills commit 60375f4 (feat(skills): wire action env vars + new service_agent module).

Verification:

hero_skills/tools/modules/services/service_agent.nu exists (full install/start/stop lifecycle).
Registered in packages.nu:
- use service_agent.nu (line 32)
- install entry (line 89)
- start entry (line 219)
Action env maps singular OPENROUTER_API_KEY → plural OPENROUTER_API_KEYS for hero_agent (service_agent.nu:59,76), and also forwards GROQ_API_KEY.
Default AIBROKER_API_ENDPOINT routes through HERO_ROUTER_ADDRESS:HERO_ROUTER_UI_PORT (TCP HTTP — reqwest cannot speak Unix sockets).

Note: the issue body called for forwarding both OPENROUTER_API_KEY and OPENROUTER_API_KEYS. The current implementation reads the canonical singular env var and forwards under the plural name hero_agent expects. Proper singular fallback inside hero_agent itself remains tracked separately under home#136.

Signed-off-by: mik-tf

Fixed in hero_skills commit 60375f4 (`feat(skills): wire action env vars + new service_agent module`). Verification: - `hero_skills/tools/modules/services/service_agent.nu` exists (full install/start/stop lifecycle). - Registered in `packages.nu`: - `use service_agent.nu` (line 32) - install entry (line 89) - start entry (line 219) - Action env maps singular `OPENROUTER_API_KEY` → plural `OPENROUTER_API_KEYS` for hero_agent (`service_agent.nu:59,76`), and also forwards `GROQ_API_KEY`. - Default `AIBROKER_API_ENDPOINT` routes through `HERO_ROUTER_ADDRESS:HERO_ROUTER_UI_PORT` (TCP HTTP — reqwest cannot speak Unix sockets). Note: the issue body called for forwarding both `OPENROUTER_API_KEY` and `OPENROUTER_API_KEYS`. The current implementation reads the canonical singular env var and forwards under the plural name hero_agent expects. Proper singular fallback inside hero_agent itself remains tracked separately under home#136. Signed-off-by: mik-tf

mik-tf closed this issue

2026-04-27 01:51:09 +00:00

mik-tf referenced this issue from lhumina_code/hero_demo

2026-04-28 12:20:36 +00:00

[nu-demo] Documentation index: heronu deployment flow, AI grounding chain, per-service gaps #23

mik-tf referenced this issue from lhumina_code/hero_demo

2026-04-28 12:20:51 +00:00

[nu-demo] CANONICAL — Intelligence pipeline documented end-to-end: hero_agent ↔ aibroker ↔ embedder ↔ hero_books ↔ docs_hero #27

mik-tf referenced this issue from lhumina_code/hero_demo

2026-04-28 12:21:09 +00:00

[ops] Single make demo target — provision + install + seed + verify a fresh Hero OS demo VM in one command #31