Files
hermes-web-ui/server/src/index.ts
T
ekko 0ff04758b6 feat: add gateway auto-start on boot and real health detection
- Auto-detect gateway connectivity on server startup, start gateway if not running
- Fix /health endpoint to actually check gateway reachability instead of just CLI version
- Fix MiniMax CN base_url from /anthropic to /v1
- Frontend connection status now reflects real gateway state

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-13 20:08:32 +08:00

182 lines
6.3 KiB
TypeScript

import Koa from 'koa'
import cors from '@koa/cors'
import bodyParser from '@koa/bodyparser'
import serve from 'koa-static'
import send from 'koa-send'
import { resolve } from 'path'
import { mkdir } from 'fs/promises'
import { config } from './config'
import { proxyRoutes } from './routes/proxy'
import { uploadRoutes } from './routes/upload'
import { sessionRoutes } from './routes/sessions'
import { webhookRoutes } from './routes/webhook'
import { logRoutes } from './routes/logs'
import { fsRoutes } from './routes/filesystem'
import { configRoutes } from './routes/config'
import { weixinRoutes } from './routes/weixin'
import * as hermesCli from './services/hermes-cli'
const { restartGateway, startGateway, getVersion } = hermesCli
export async function bootstrap() {
await mkdir(config.uploadDir, { recursive: true })
await mkdir(config.dataDir, { recursive: true })
await ensureApiServerConfig()
await ensureGatewayRunning()
const app = new Koa()
app.use(cors({ origin: config.corsOrigins }))
app.use(bodyParser())
app.use(webhookRoutes.routes())
app.use(logRoutes.routes())
app.use(uploadRoutes.routes())
app.use(sessionRoutes.routes())
app.use(fsRoutes.routes())
app.use(configRoutes.routes())
app.use(weixinRoutes.routes())
// Health endpoint: check CLI version + gateway connectivity
app.use(async (ctx, next) => {
if (ctx.path === '/health') {
const raw = await getVersion()
const version = raw.split('\n')[0].replace('Hermes Agent ', '') || ''
let gatewayOk = false
try {
const res = await fetch(`${config.upstream.replace(/\/$/, '')}/health`, {
signal: AbortSignal.timeout(5000),
})
gatewayOk = res.ok
} catch { /* not reachable */ }
ctx.body = {
status: gatewayOk ? 'ok' : 'error',
platform: 'hermes-agent',
version,
gateway: gatewayOk ? 'running' : 'stopped',
}
return
}
await next()
})
app.use(proxyRoutes.routes())
// SPA fallback
const distDir = resolve(__dirname, '..')
app.use(serve(distDir))
app.use(async (ctx) => {
if (!ctx.path.startsWith('/api') && !ctx.path.startsWith('/v1') && ctx.path !== '/health' && ctx.path !== '/upload' && ctx.path !== '/webhook') {
await send(ctx, 'index.html', { root: distDir })
}
})
app.listen(config.port, '0.0.0.0', () => {
console.log(` ➜ Hermes BFF Server: http://localhost:${config.port}`)
console.log(` ➜ Upstream: ${config.upstream}`)
})
}
async function ensureApiServerConfig() {
const { homedir } = await import('os')
const { readFileSync, writeFileSync, existsSync } = await import('fs')
const configPath = resolve(homedir(), '.hermes/config.yaml')
try {
if (!existsSync(configPath)) {
console.log(' ✗ config.yaml not found, skipping')
return
}
const content = readFileSync(configPath, 'utf-8')
// Case 1: api_server section exists, check if enabled is true
if (/api_server:/.test(content)) {
// Check specifically under api_server: look for a direct child `enabled: false`
// Match api_server block and find enabled at the correct indent level
const blockMatch = content.match(/api_server:\n((?:[ \t]+.*\n)*?)(?=\S|$)/)
if (blockMatch) {
const block = blockMatch[1]
if (/^([ \t]*)enabled:\s*true/m.test(block)) {
console.log(' ✓ api_server.enabled is true')
return
}
if (/^([ \t]*)enabled:\s*false/m.test(block)) {
// Backup before modifying
const { copyFileSync } = await import('fs')
copyFileSync(configPath, configPath + '.bak')
const updated = content.replace(
/(api_server:\n(?:[ \t]*.*\n)*?[ \t]*)enabled:\s*false/,
'$1enabled: true'
)
writeFileSync(configPath, updated, 'utf-8')
console.log(' ✓ api_server.enabled changed to true (backup saved to config.yaml.bak)')
await restartGateway()
return
}
}
// api_server exists but no enabled key — don't touch, assume default
console.log(' ✓ api_server section exists')
return
}
// Case 2: api_server section exists and enabled is true (or missing but default true)
if (/api_server:/.test(content)) {
console.log(' ✓ api_server section exists')
return
}
// Case 3: platforms section exists but no api_server — append api_server block
if (/platforms:/.test(content)) {
const { copyFileSync } = await import('fs')
copyFileSync(configPath, configPath + '.bak')
const append = `\n api_server:\n enabled: true\n host: "127.0.0.1"\n port: 8642\n key: ""\n cors_origins: "*"\n`
const updated = content.replace(/(platforms:)/, '$1' + append)
writeFileSync(configPath, updated, 'utf-8')
console.log(' ✓ api_server block appended to platforms (backup saved to config.yaml.bak)')
await restartGateway()
return
}
// Case 4: No platforms section at all — append at end of file
const { copyFileSync } = await import('fs')
copyFileSync(configPath, configPath + '.bak')
const append = `\nplatforms:\n api_server:\n enabled: true\n host: "127.0.0.1"\n port: 8642\n key: ""\n cors_origins: "*"\n`
writeFileSync(configPath, content + append, 'utf-8')
console.log(' ✓ platforms.api_server block appended (backup saved to config.yaml.bak)')
await restartGateway()
} catch (err: any) {
console.error(' ✗ Failed to update config:', err.message)
}
}
async function ensureGatewayRunning() {
const upstream = config.upstream.replace(/\/$/, '')
try {
const res = await fetch(`${upstream}/health`, { signal: AbortSignal.timeout(5000) })
if (res.ok) {
console.log(' ✓ Gateway is running')
return
}
} catch {
// Gateway not reachable
}
console.log(' ⚠ Gateway not reachable, starting...')
try {
await startGateway()
await new Promise(r => setTimeout(r, 3000))
const res = await fetch(`${upstream}/health`, { signal: AbortSignal.timeout(5000) })
if (res.ok) {
console.log(' ✓ Gateway started successfully')
return
}
console.log(' ✗ Gateway start attempted but still not reachable')
} catch (err: any) {
console.error(' ✗ Failed to start gateway:', err.message)
}
}
bootstrap()