moving
Some checks failed
Installer Smoke / installer-smoke (push) Has been cancelled

This commit is contained in:
Oleg Maslov
2026-09-02 10:10:29 +02:00
commit 0c3e2ead3b
3841 changed files with 970576 additions and 0 deletions

View File

@@ -0,0 +1,106 @@
/**
* Hermes EventAdapter.
*
* Hermes (`NousResearch/hermes-agent`) exposes a SHELL-HOOKS system — a
* top-level `hooks:` block in `~/.hermes/config.yaml` whose entries spawn a
* configured `command` as an OS subprocess, pipe the event JSON to stdin,
* and read optional JSON back from stdout. That contract is structurally
* identical to shim-core's `runHook` (stdin-JSON / exit-0), so the three
* lifecycle handler bodies reuse `runHook` as-is.
*
* Hermes differs from claude-code in three source-verified ways (spec §5.4):
* - SessionStart is SPLIT across two native events — `on_session_start`
* (observer/no-op) AND `pre_llm_call` gated on `is_first_turn` (the
* inject seam). The register side wires BOTH keys (see yaml-merger.ts);
* the inject stdout shape is `{ "context": "..." }` (appended to the
* user message, NOT the system prompt, to preserve prefix cache), so
* `formatInject` returns `{ context: text }`.
* - UserPromptSubmit → `pre_llm_call`; the user text lives at
* `extra.user_message`.
* - Stop → `post_llm_call`; the assistant text lives at
* `extra.assistant_response`. (`on_session_finalize` is gateway-only —
* do NOT use it; `post_llm_call` is the dependable per-turn Stop signal.)
*
* There is NO PreCompact event — Hermes ships no compaction hook
* (`eventName['pre-compact'] = undefined`); the maintenance pass is
* approximated opt-in from Stop (`WAGGLE_HERMES_COMPACT_ON_STOP`, default
* off) — see `compact-on-stop.ts`. (`eventName['pre-compact']` stays
* `undefined`; we are NOT registering a hook.)
*
* Hermes events carry block/inject control purely via stdout JSON (no
* exit-code-2 contract). Our hooks are capture-only, so they emit `{}` or
* the SessionStart context and exit 0 — fully compatible with the shim.
*/
import {
pickStringField,
type EventAdapter,
type Lifecycle,
} from '@waggle/hive-mind-hooks-core';
/**
* Canonical lifecycle → Hermes native event key. SessionStart maps to
* `pre_llm_call` for the inject side; the observer-only `on_session_start`
* key is registered separately by the YAML merger (it cannot be expressed
* in this 1:1 map). `pre-compact` is `undefined` — Hermes has no compaction
* hook.
*/
export const HERMES_EVENT_NAME: Record<Lifecycle, string | undefined> = {
'session-start': 'pre_llm_call',
'user-prompt-submit': 'pre_llm_call',
'stop': 'post_llm_call',
'pre-compact': undefined,
};
/** Hermes observer-only SessionStart key, registered alongside `pre_llm_call`. */
export const HERMES_SESSION_START_OBSERVE_EVENT = 'on_session_start';
/**
* Read a string field nested under the Hermes `extra` envelope, falling
* back to top-level keys for forward-compat. Hermes delivers the turn
* payload under `extra.{user_message,assistant_response,...}`.
*/
function pickFromExtra(payload: unknown, ...keys: string[]): string | undefined {
if (payload && typeof payload === 'object') {
const extra = (payload as Record<string, unknown>)['extra'];
const fromExtra = pickStringField(extra, ...keys);
if (fromExtra) return fromExtra;
}
return pickStringField(payload, ...keys);
}
/** The Hermes EventAdapter consumed by the shared lifecycle handler bodies. */
export const hermesAdapter: EventAdapter = {
source: 'hermes',
eventName: HERMES_EVENT_NAME,
extractCwd(payload): string | undefined {
return pickFromExtra(payload, 'cwd', 'working_directory', 'workingDirectory');
},
extractSessionId(payload): string | undefined {
return pickFromExtra(payload, 'session_id', 'sessionId', 'conversation_id', 'conversationId');
},
extractPrompt(payload): string | undefined {
// pre_llm_call carries the user text at extra.user_message.
return pickFromExtra(payload, 'user_message', 'prompt');
},
extractResponse(payload): string | undefined {
// post_llm_call carries the assistant text at extra.assistant_response.
return pickFromExtra(payload, 'assistant_response', 'final_response', 'response');
},
extractParent(payload): string | undefined {
return pickFromExtra(payload, 'parent_frame_id', 'prompt_frame_id');
},
/**
* Hermes appends `pre_llm_call` stdout `{ "context": "..." }` to the
* user message (NOT the system prompt — preserves the prefix cache).
*/
formatInject(additionalContext: string): unknown {
return { context: additionalContext };
},
};