@bitseek/hermes-webui 0.1.2 → 0.1.3

package/README.md

@@ -81,6 +81,9 @@ hermes-webui doctor
 - 创建运行时状态目录。
 - 创建并管理 Python venv。
 - 安装 WebUI 所需的 Python 依赖。
+- 检查当前 Python 是否能导入 Hermes Agent；如果不能，会把
+  `HERMES_WEBUI_AGENT_DIR` 指向的 Hermes Agent 以 editable 模式安装到 WebUI
+  venv。
 - 默认启用 BitSeek 外观和扩展入口，包括 “AI 同事” 页面。
 - 启动 BitSeek Claw WebUI 服务。
 - 等待 `/health` 健康检查通过。
@@ -170,6 +173,9 @@ hermes-webui doctor
   `HERMES_WEBUI_PYTHON`。
 - `Hermes Agent dir: not found`：设置 `HERMES_WEBUI_AGENT_DIR` 指向包含
   `run_agent.py` 的 Hermes Agent 目录。
+- `AIAgent importable: fail`：当前 WebUI Python 不能导入 Hermes Agent。运行
+  `hermes-webui start` 会自动尝试修复；如果仍失败，请查看 `server.log` 和
+  `pip install -e` 的错误输出。
 - `WebUI runtime is missing`：发布包缺少必要文件，需要维护者重新打包并发布。
 
 ## 维护者说明

package/bin/hermes-webui.mjs

@@ -218,6 +218,54 @@ function pythonImportsOk(python) {
   return result.status === 0
 }
 
+function aiAgentImportCheck(python, agentDir) {
+  if (!python || !agentDir) {
+    return { ok: false, error: 'python or Hermes Agent dir not found' }
+  }
+  const env = {
+    ...process.env,
+    HERMES_WEBUI_AGENT_DIR: agentDir,
+    PYTHONPATH: process.env.PYTHONPATH
+      ? `${agentDir}${delimiter}${process.env.PYTHONPATH}`
+      : agentDir,
+  }
+  const result = spawnSync(python, ['-c', 'from run_agent import AIAgent; print("ok")'], {
+    stdio: ['ignore', 'pipe', 'pipe'],
+    env,
+    encoding: 'utf8',
+  })
+  return {
+    ok: result.status === 0,
+    error: (result.stderr || result.stdout || '').trim(),
+  }
+}
+
+function ensureAiAgentImportable(python, agentDir) {
+  if (!agentDir) return
+
+  let check = aiAgentImportCheck(python, agentDir)
+  if (check.ok) return
+
+  const pyprojectPath = join(agentDir, 'pyproject.toml')
+  if (!existsSync(pyprojectPath)) {
+    throw new Error(`Hermes Agent cannot be imported and pyproject.toml was not found: ${pyprojectPath}`)
+  }
+
+  console.log(`Installing Hermes Agent into WebUI Python env: ${agentDir}`)
+  const install = spawnSync(python, ['-m', 'pip', 'install', '-e', agentDir], {
+    stdio: 'inherit',
+    env: process.env,
+  })
+  if (install.status !== 0) {
+    throw new Error(`Failed to install Hermes Agent into WebUI Python env (exit ${install.status})`)
+  }
+
+  check = aiAgentImportCheck(python, agentDir)
+  if (!check.ok) {
+    throw new Error(`Hermes Agent still cannot be imported after install:\n${check.error}`)
+  }
+}
+
 function preparePython() {
   if (process.env.HERMES_WEBUI_PYTHON) {
     return resolve(expandHome(process.env.HERMES_WEBUI_PYTHON))
@@ -311,7 +359,7 @@ async function waitForHealth(host, port, child, timeoutMs = 30000) {
 
 async function start(options) {
   if (!existsSync(bootstrapPath) || !existsSync(serverPath)) {
-    throw new Error('Vendored agent-frontend-shell runtime is missing. Run npm run sync:vendor.')
+    throw new Error('WebUI runtime is missing. Run npm run sync:vendor.')
   }
 
   const existing = readPid()
@@ -329,6 +377,7 @@ async function start(options) {
   mkdirSync(paths.dir, { recursive: true })
   const python = preparePython()
   const env = buildEnv(python, options)
+  ensureAiAgentImportable(python, env.HERMES_WEBUI_AGENT_DIR)
   const args = [serverPath]
 
   if (options.foreground) {
@@ -383,7 +432,7 @@ async function start(options) {
     started_at: new Date().toISOString(),
   })
 
-  console.log(`Starting Bitseek Hermes WebUI (PID ${child.pid}, port ${options.port})...`)
+  console.log(`Starting BitSeek Claw WebUI (PID ${child.pid}, port ${options.port})...`)
   const health = await waitForHealth(options.host, options.port, child)
   if (!health.ok) {
     console.log(`Health check failed: ${health.error || health.status || 'unknown error'}`)
@@ -391,7 +440,7 @@ async function start(options) {
     process.exit(1)
   }
 
-  console.log('Bitseek Hermes WebUI started')
+  console.log('BitSeek Claw WebUI started')
   console.log(`URL: http://${options.host === '127.0.0.1' ? 'localhost' : options.host}:${options.port}`)
   console.log(`Log: ${paths.log}`)
   if (options.open) openBrowser(options.host, options.port)
@@ -408,13 +457,13 @@ async function stop() {
         process.exit(1)
       }
     }
-    console.log('Bitseek Hermes WebUI is not running')
+    console.log('BitSeek Claw WebUI is not running')
     return
   }
 
   if (!isRunning(pid)) {
     removePid()
-    console.log(`Bitseek Hermes WebUI was not running; cleaned stale PID ${pid}`)
+    console.log(`BitSeek Claw WebUI was not running; cleaned stale PID ${pid}`)
     return
   }
 
@@ -427,7 +476,7 @@ async function stop() {
     process.kill(pid, 'SIGKILL')
   }
   removePid()
-  console.log(`Bitseek Hermes WebUI stopped (PID ${pid})`)
+  console.log(`BitSeek Claw WebUI stopped (PID ${pid})`)
 }
 
 async function restart(options) {
@@ -510,11 +559,17 @@ async function doctor(options) {
   const agentDir = resolveAgentDir()
   add('Hermes Agent dir', Boolean(agentDir), agentDir || 'not found')
   add('run_agent.py', Boolean(agentDir && existsSync(join(agentDir, 'run_agent.py'))), agentDir ? join(agentDir, 'run_agent.py') : 'not found')
+  if (python && agentDir) {
+    const importCheck = aiAgentImportCheck(python, agentDir)
+    add('AIAgent importable', importCheck.ok, importCheck.ok ? python : importCheck.error || python)
+  } else {
+    add('AIAgent importable', false, 'python or Hermes Agent dir not found')
+  }
   add('port available', !(await portOccupied(options.host, options.port)), `${options.host}:${options.port}`)
-  add('no vendored .env', !existsSync(join(vendorRoot, '.env')), join(vendorRoot, '.env'))
-  add('no vendored .git', !existsSync(join(vendorRoot, '.git')), join(vendorRoot, '.git'))
-  add('no vendored .venv', !existsSync(join(vendorRoot, '.venv')), join(vendorRoot, '.venv'))
-  add('no vendored node_modules', !existsSync(join(vendorRoot, 'node_modules')), join(vendorRoot, 'node_modules'))
+  add('no bundled .env', !existsSync(join(vendorRoot, '.env')), join(vendorRoot, '.env'))
+  add('no bundled .git', !existsSync(join(vendorRoot, '.git')), join(vendorRoot, '.git'))
+  add('no bundled .venv', !existsSync(join(vendorRoot, '.venv')), join(vendorRoot, '.venv'))
+  add('no bundled node_modules', !existsSync(join(vendorRoot, 'node_modules')), join(vendorRoot, 'node_modules'))
 
   for (const check of checks) {
     console.log(`${check.ok ? 'ok' : 'fail'} - ${check.name}${check.detail ? `: ${check.detail}` : ''}`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitseek/hermes-webui",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "description": "BitSeek Claw WebUI launcher.",
   "bin": {