feat: inject_internal_message — public profile-aware injection API (AL17)

[randlee]

AL17 Deployable Hermes Host Contract

fork:   randlee/hermes-agent
branch: feat/al16-clean
SHA:    82b12f91858fefc66bdb33ff16441d86aa9eaba5
tests:  22/22 passed in 0.95s

Evidence

• Candidate venv built from fork, all dependencies installed
• 22 tests covering: adapter resolution, structured errors, isolation (queue + steer + active profile), notice_text, gateway_runner hook, steer mode with fallback
• uv.lock clean — zero diff from upstream main

API

GatewayRunner.inject_internal_message(platform, chat_id, text, notice_text=None, profile="", mode="queue")

Modes

• mode="queue" (default): MessageEvent(internal=True), queues behind active turns
• mode="steer": non-interrupting session.steer, falls back to queue

Errors

InjectInternalMessageError(code, chat_id, detail) for unknown profile, missing adapter, profile map empty

Isolation

Queue and steer scoped to target session — no cross-profile delivery

Hook

gateway:startup context includes gateway_runner for plugin access