minimal-host

Overview ¶

Minimal-host is a small program showing how to embed evva's agent runtime in a downstream Go app:

• Load runtime config from a custom AppHome (~/.minimal-host/ here).
• Register a custom LLM provider against pkg/llm.DefaultRegistry.
• Register a custom tool against the agent via WithCustomTool.
• Register a programmatic skill via pkg/skill.NewRegistry + Add.
• Stash a downstream-private secret in cfg.CustomConfig.
• Wire a stdout event sink that prints each agent event.
• Build the agent via pkg/agent.NewWithProfile and run one prompt.

Run:

cd examples/minimal-host && go run .

No internal/* imports — this file proves the Phase 13 / 19 public surface is sufficient on its own. Build it from outside the evva module and the compiler enforces that.