Update CLI chat session bridge (#697)

* feat: add CLI chat sessions with Python agent bridge

Introduce a new CLI chat mode that connects Web UI directly to Hermes
Agent's AIAgent via a Python bridge subprocess and Socket.IO, bypassing
the API Server /v1/responses path. Supports streaming, slash commands
(/new, /undo, /retry, /branch, /compress, /save, /title), interrupt,
and steer.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* feat: update CLI chat session bridge

* fix: extend agent bridge startup timeouts

* docs: update bridge chat session design

* feat: align bridge compression and provider registry

* chore: bump version to 0.5.20

---------

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

packages/server/src/controllers/hermes/profiles.ts

@@ -7,6 +7,26 @@ import { SessionDeleter } from '../../services/hermes/session-deleter'
 import { getGatewayManagerInstance } from '../../services/gateway-bootstrap'
 import { logger } from '../../services/logger'
 import { smartCloneCleanup } from '../../services/hermes/profile-credentials'
+import { detectHermesHome } from '../../services/hermes/hermes-path'
+
+function profileExistsForManualSwitch(name: string): boolean {
+  const base = detectHermesHome()
+  if (!name || name === 'default') return true
+  return existsSync(join(base, 'profiles', name, 'config.yaml')) || existsSync(join(base, 'profiles', name))
+}
+
+async function useProfileWithFallback(name: string): Promise<string> {
+  try {
+    return await hermesCli.useProfile(name)
+  } catch (err: any) {
+    if (!profileExistsForManualSwitch(name)) throw err
+
+    const base = detectHermesHome()
+    writeFileSync(join(base, 'active_profile'), `${name}\n`, 'utf-8')
+    logger.warn(err, '[switchProfile] hermes profile use failed; wrote active_profile directly for existing profile "%s"', name)
+    return `Switched to profile ${name}`
+  }
+}
 
 export async function list(ctx: any) {
   try {
@@ -159,7 +179,7 @@ export async function switchProfile(ctx: any) {
     return
   }
   try {
-    const output = await hermesCli.useProfile(name)
+    const output = await useProfileWithFallback(name)
 
     // Verify the active_profile file immediately (Hermes CLI writes synchronously)
     // Quick verification with 2 retries to handle edge cases (filesystem delays, concurrency)
@@ -185,6 +205,16 @@ export async function switchProfile(ctx: any) {
     const mgr = getGatewayManagerInstance()
     if (mgr) { mgr.setActiveProfile(name) }
 
+    // Destroy all bridge sessions so they get recreated with the new profile config
+    try {
+      const { AgentBridgeClient } = await import('../../services/hermes/agent-bridge')
+      const bridge = new AgentBridgeClient()
+      await bridge.destroyAll()
+      logger.info('[switchProfile] destroyed all bridge sessions for profile "%s"', name)
+    } catch (err: any) {
+      logger.warn(err, '[switchProfile] failed to destroy bridge sessions')
+    }
+
     try {
       const detail = await hermesCli.getProfile(name)
       logger.debug('Profile detail.path = %s', detail.path)