Assistant: add a Hermes agent backend

A "Hermes agent" assistant model talks to a Hermes Agent gateway's
OpenAI-compatible API server (streamed /v1/chat/completions), with Hermes URL
and key settings under Assistant. Hermes keeps the conversation: each
assistant session maps to one X-Hermes-Session-Id and only the latest user
message is sent. Faceclaw's own tools are not offered to it, and its reasoning
stream is not shown on the glasses. See notes/hermes-assistant.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
FilipAlexanderandClaude Opus 5.5 committed 2026-10-17 16:44:23 +02:00
1 parent 2bb7b3ea1a
commit d9924eedcd
9 files changed
+297 -4

No files matched your search

+11 -1
View File
@@ -32,6 +32,11 @@ export type AssistantBackendConfig =
/** Trim history from the head once it grows past this many messages. */
const MAX_HISTORY_MESSAGES = 40;
/** Hermes brings its own persona and tools; it only needs to know where the reply is shown. */
const HERMES_SYSTEM_PROMPT =
"The user is talking to you through smart glasses with a small text display. Reply briefly in plain text, without Markdown.";
export class AssistantSession {
private readonly directBackend = new DirectAssistantBackend();
private readonly messages: LlmMessage[] = [];
@@ -43,6 +48,8 @@ export class AssistantSession {
// API-safe tool name -> canonical registry name. Provider APIs restrict tool
// names, so dotted registry names are sanitized and mapped back on calls.
private readonly toolNameMap = new Map<string, string>();
// The Hermes server-side session for this conversation (Hermes keeps the history).
private readonly hermesSessionId = `faceclaw-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
constructor(
private config: AssistantBackendConfig,
@@ -173,7 +180,10 @@ export class AssistantSession {
apiKey: llm.apiKey,
model: llm.model,
effort: llm.effort,
system: isLocal ? ASSISTANT_SYSTEM_PROMPT_BASE : buildAssistantSystemPrompt(ctx),
baseUrl: llm.baseUrl,
sessionId: this.hermesSessionId,
system: llm.provider === "hermes" ? HERMES_SYSTEM_PROMPT
: isLocal ? ASSISTANT_SYSTEM_PROMPT_BASE : buildAssistantSystemPrompt(ctx),
messages: turnMessages,
buildTools: () => this.buildToolDefinitions(),
registry: this.registry,