@yeaft/webchat-agent 1.0.413 → 1.0.414

package/cli.js

@@ -61,6 +61,14 @@ const SERVICE_COMMANDS = ['install', 'uninstall', 'start', 'stop', 'restart', 's
 
 if (command === 'doctor') {
   await handleDoctorCommand(subArgs);
+} else if (command === 'browser') {
+  try {
+    const { handleBrowserCommand } = await import('./browser-runtime/cli.js');
+    await handleBrowserCommand(subArgs);
+  } catch (error) {
+    console.error(`Browser Runtime command failed: ${error.code || error.message}`);
+    process.exitCode = 1;
+  }
 } else if (command === 'llm') {
   await handleLlmCommand(subArgs);
 } else if (command === 'local') {
@@ -137,6 +145,10 @@ function printHelp() {
     yeaft-agent status [options]       Show service status
     yeaft-agent logs [options]         View service logs (follow mode)
     yeaft-agent doctor                 Diagnose service configuration
+    yeaft-agent browser install        Install the pinned Chrome for Testing build
+    yeaft-agent browser probe          Validate tabCapture → offscreen → WebRTC
+    yeaft-agent browser enable|disable Change the Browser Runtime feature flag
+    yeaft-agent browser status         Show config and managed browser install status
     yeaft-agent llm <command>          Configure local Yeaft LLM providers/models
     yeaft-agent container <command>    Manage a Dockerized yeaft-agent
     yeaft-agent upgrade [--name <id>]  Upgrade and restart the selected service
@@ -153,6 +165,11 @@ function printHelp() {
     --yeaft-dir <dir>   Yeaft data directory for this instance
     --auto-upgrade      Check for updates on startup
 
+  Browser options:
+    --executable <path> Explicit compatible Chrome for Testing executable
+    --headful           Run the Browser Runtime probe with a visible browser
+    --name <id>         Select the named Agent instance
+
   Environment variables (alternative to flags):
     YEAFT_AGENT_INSTANCE Deprecated local service instance id override
     SERVER_URL          WebSocket server URL
@@ -174,7 +191,7 @@ function printHelp() {
 `);
 }
 
-function printLlmHelp() {
+export function printLlmHelp() {
   console.log(`
   Configure local Yeaft LLM providers/models in ~/.yeaft/config.json.
 
@@ -257,7 +274,7 @@ async function handleLlmCommand(args) {
       const preset = args[1];
       if (preset === 'github-copilot') {
         result = await useGitHubCopilot(current, options);
-        writeLocalLlmConfig(result.config, configPath);
+        writeLocalLlmConfig(result.config, configPath, current);
         console.log(`Configured GitHub Copilot provider with ${result.discovery.models.length} ${result.discovery.source} models.`);
         if (result.discovery.warning) console.log(`Warning: ${result.discovery.warning}`);
         console.log(`Primary model: ${result.config.primaryModel}`);
@@ -266,7 +283,7 @@ async function handleLlmCommand(args) {
       }
       if (preset === 'openai-compatible') {
         result = await useOpenAICompatible(current, options, process.env);
-        writeLocalLlmConfig(result.config, configPath);
+        writeLocalLlmConfig(result.config, configPath, current);
         console.log(`Configured ${result.provider.name} with ${result.discovery.models.length} live models.`);
         console.log(`Primary model: ${result.config.primaryModel}`);
         if (result.config.fastModel) console.log(`Fast model: ${result.config.fastModel}`);
@@ -277,7 +294,7 @@ async function handleLlmCommand(args) {
 
     if (subcommand === 'add-provider') {
       result = addOrUpdateProvider(current, options, process.env);
-      writeLocalLlmConfig(result.config, configPath);
+      writeLocalLlmConfig(result.config, configPath, current);
       console.log(`${result.replaced ? 'Updated' : 'Added'} provider: ${result.provider.name}`);
       if (result.config.primaryModel) console.log(`Primary model: ${result.config.primaryModel}`);
       if (result.config.fastModel) console.log(`Fast model: ${result.config.fastModel}`);
@@ -286,7 +303,7 @@ async function handleLlmCommand(args) {
 
     if (subcommand === 'set-model') {
       result = setLocalModels(current, options);
-      writeLocalLlmConfig(result.config, configPath);
+      writeLocalLlmConfig(result.config, configPath, current);
       if (result.config.primaryModel) console.log(`Primary model: ${result.config.primaryModel}`);
       if (result.config.fastModel) console.log(`Fast model: ${result.config.fastModel}`);
       return;
@@ -294,7 +311,7 @@ async function handleLlmCommand(args) {
 
     if (subcommand === 'remove-provider') {
       result = removeProvider(current, options);
-      writeLocalLlmConfig(result.config, configPath);
+      writeLocalLlmConfig(result.config, configPath, current);
       console.log(result.removed ? `Removed provider: ${options.name}` : `Provider not found: ${options.name}`);
       if (result.cleared.length) {
         console.log(`Cleared ${result.cleared.join(', ')} because it referenced ${options.name}`);
@@ -426,7 +443,7 @@ async function runLlmSetup(current, configPath) {
     const fastAnswer = (await rl.question('Fast model number or id (optional): ')).trim();
     const fast = fastAnswer ? (ids[Number(fastAnswer) - 1] || fastAnswer) : null;
     const result = await useGitHubCopilot(current, { model: primary, fast, allowUnknownModel: false });
-    writeLocalLlmConfig(result.config, configPath);
+    writeLocalLlmConfig(result.config, configPath, current);
     console.log(`Configured GitHub Copilot with ${result.discovery.models.length} ${result.discovery.source} models.`);
     if (result.discovery.warning) console.log(`Warning: ${result.discovery.warning}`);
     console.log(`Primary model: ${result.config.primaryModel}`);

package/context.js

@@ -20,6 +20,7 @@ export default {
   CONFIG: null,
   managedCliReady: Promise.resolve([]),
   agentCapabilities: [],
+  browserRuntime: null,
   // Agent 级别的 slash commands 缓存（所有 conversation 共用）
   slashCommands: [],
   // Slash command 描述映射: { commandName: description } — 从 plugin commands/*.md 提取

package/index.js

@@ -23,6 +23,7 @@ import { connect } from './connection.js';
 import { loadMcpServers } from './mcp.js';
 import { SAFE_REMOTE_UPGRADE_CAPABILITY } from './upgrade-command.js';
 import { loadConfig as loadYeaftConfig } from './yeaft/config.js';
+import { bootBrowserRuntime, shutdownBrowserRuntime } from './browser-runtime/index.js';
 import {
   ensureManagedCliTools,
   prepareManagedCliToolEnvironment,
@@ -104,7 +105,7 @@ const { agentName: AGENT_NAME, instanceId: INSTANCE_ID } = resolveRuntimeIdentit
 const YEAFT_DIR = process.env.YEAFT_DIR || fileConfig.yeaftDir || getDefaultYeaftDir(INSTANCE_ID);
 try {
   if (!existsSync(YEAFT_DIR)) {
-    mkdirSync(YEAFT_DIR, { recursive: true });
+    mkdirSync(YEAFT_DIR, { recursive: true, mode: 0o700 });
     console.log(`[Agent] Created yeaft dir: ${YEAFT_DIR}`);
   }
 } catch (err) {
@@ -356,6 +357,7 @@ function cleanup() {
       const { shutdownWorkCenter } = await import('./yeaft/work-center/bridge.js');
       await shutdownWorkCenter();
     } catch {}
+    try { await shutdownBrowserRuntime(); } catch {}
     if (ctx.ws) ctx.ws.close();
   });
 }
@@ -396,6 +398,21 @@ process.on('SIGTERM', async () => {
   } catch (error) {
     console.warn(`[Startup] managed rg environment setup failed; using built-in fallback: ${error?.message || error}`);
   }
+  try {
+    const runtimeConfig = loadYeaftConfig({ dir: YEAFT_DIR }).browserRuntime;
+    ctx.browserRuntime = await bootBrowserRuntime({
+      yeaftDir: YEAFT_DIR,
+      config: runtimeConfig,
+    });
+    const probe = ctx.browserRuntime.snapshot().probe;
+    if (probe?.ok) {
+      console.log(`[BrowserRuntime] ready: capture=${probe.captureMode} build=${probe.actualBuildId || probe.expectedBuildId}`);
+    } else if (runtimeConfig?.enabled) {
+      console.warn(`[BrowserRuntime] unavailable: ${probe?.code || 'probe_failed'}`);
+    }
+  } catch (err) {
+    console.warn(`[BrowserRuntime] startup probe failed: ${err?.message || err}`);
+  }
   ctx.agentCapabilities = await detectCapabilities();
   // Prime the models.dev community catalog so the Yeaft engine's *synchronous*
   // hot path (engine.js / config.js / cli.js all read context-window inline)

package/llm-config-cli.js

@@ -1,7 +1,8 @@
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
-import { dirname, join } from 'path';
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
 import { homedir } from 'os';
 import { normalizePluginConfig } from './yeaft/plugins.js';
+import { mutateAgentConfigPath } from './yeaft/config-store.js';
 import {
   discoverGitHubCopilotModels,
   discoverOpenAICompatibleModels,
@@ -40,31 +41,33 @@ export function readLocalLlmConfig(configPath = getDefaultYeaftConfigPath()) {
   return parsed;
 }
 
-export function writeLocalLlmConfig(config, configPath = getDefaultYeaftConfigPath()) {
-  // The CLI exposes this writer publicly, so do not rely on callers having
-  // already used readLocalLlmConfig(). An existing invalid Plugins policy must
-  // remain on disk and keep runtime fail-closed until the user repairs it.
-  const existing = existsSync(configPath) ? readLocalLlmConfig(configPath) : null;
+export function writeLocalLlmConfig(config, configPath = getDefaultYeaftConfigPath(), baseConfig = null) {
   if (!config || typeof config !== 'object' || Array.isArray(config)
     || Object.getPrototypeOf(config) !== Object.prototype) {
     throw new Error(`Invalid config file: expected JSON object at ${configPath}`);
   }
-  const next = { ...config };
-  if (next.plugins === undefined
-    && Object.prototype.hasOwnProperty.call(existing || {}, 'plugins')) {
-    // LLM commands change provider/model fields. They must not remove a
-    // separately-managed Plugin allowlist merely because their payload omits it.
-    next.plugins = existing.plugins;
-  }
-  if (next.plugins !== undefined) {
+  if (config.plugins !== undefined) {
     try {
-      normalizePluginConfig(next.plugins);
-    } catch (err) {
-      throw new Error(`Invalid config file: ${err?.message || err}`);
+      normalizePluginConfig(config.plugins);
+    } catch (error) {
+      throw new Error(`Invalid config file: ${error?.message || error}`);
     }
   }
-  mkdirSync(dirname(configPath), { recursive: true });
-  writeFileSync(configPath, `${JSON.stringify(next, null, 2)}\n`, 'utf8');
+
+  mutateAgentConfigPath(configPath, current => {
+    const baseline = baseConfig && typeof baseConfig === 'object' && !Array.isArray(baseConfig)
+      ? baseConfig
+      : {};
+    const keys = new Set([...Object.keys(baseline), ...Object.keys(config)]);
+    for (const key of keys) {
+      if (key === 'plugins' && !Object.prototype.hasOwnProperty.call(config, key)) continue;
+      const before = baseline[key];
+      const after = config[key];
+      if (JSON.stringify(before) === JSON.stringify(after)) continue;
+      if (Object.prototype.hasOwnProperty.call(config, key)) current[key] = after;
+      else delete current[key];
+    }
+  });
 }
 
 export function parseModelsCsv(value) {
@@ -313,7 +316,7 @@ export async function tryAutoConfigureGitHubCopilot(configPath = getDefaultYeaft
       ...options,
       model: options.model || DEFAULT_GITHUB_COPILOT_MODEL,
     });
-    writeLocalLlmConfig(result.config, configPath);
+    writeLocalLlmConfig(result.config, configPath, current);
     return { configured: true, reason: 'configured', ...result };
   } catch (error) {
     return {

package/local-runtime/version.json

@@ -1 +1 @@
-{"version":"1.0.413"}
+{"version":"1.0.414"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "1.0.413",
+  "version": "1.0.414",
   "description": "Remote worker agent for Yeaft Web Code Agent — connects the native Yeaft engine, CLI providers, and workbench tools",
   "main": "index.js",
   "type": "module",
@@ -41,6 +41,8 @@
     "docker-entrypoint.sh",
     "yeaft/templates/**/*.md",
     "yeaft/dream/prompts/**/*.md",
+    "browser-runtime/extension/**/*",
+    "browser-runtime/*.ps1",
     "local-runtime/**/*"
   ],
   "license": "MIT",
@@ -62,6 +64,7 @@
   },
   "dependencies": {
     "@homebridge/node-pty-prebuilt-multiarch": "^0.13.1",
+    "@puppeteer/browsers": "2.13.0",
     "bcrypt": "^6.0.0",
     "compression": "^1.8.1",
     "dotenv": "^16.3.1",
@@ -69,6 +72,7 @@
     "jsonwebtoken": "^9.0.2",
     "multer": "^2.2.0",
     "nodemailer": "^9.0.3",
+    "puppeteer-core": "24.41.0",
     "qrcode": "^1.5.4",
     "speakeasy": "^2.0.0",
     "tweetnacl": "^1.0.3",

package/service/config.js

@@ -113,7 +113,7 @@ export function resolveServiceInstanceId(args = [], env = process.env, options =
 }
 
 /** Resolve the CLI/env/default Yeaft data root for one Agent instance. */
-export function resolveYeaftDir(args = [], env = process.env, instanceId = DEFAULT_INSTANCE_ID) {
+function explicitYeaftDirFromArgs(args = []) {
   let explicitYeaftDir = null;
   for (let index = 0; index < args.length; index += 1) {
     if (args[index] !== '--yeaft-dir') continue;
@@ -122,7 +122,28 @@ export function resolveYeaftDir(args = [], env = process.env, instanceId = DEFAU
     explicitYeaftDir = value;
     index += 1;
   }
-  return explicitYeaftDir || env.YEAFT_DIR || getDefaultYeaftDir(instanceId);
+  return explicitYeaftDir;
+}
+
+export function resolveYeaftDir(args = [], env = process.env, instanceId = DEFAULT_INSTANCE_ID) {
+  return explicitYeaftDirFromArgs(args) || env.YEAFT_DIR || getDefaultYeaftDir(instanceId);
+}
+
+/** Resolve the persisted data root for an explicitly selected management target. */
+export function resolveManagedYeaftDir(
+  args = [],
+  env = process.env,
+  instanceId = DEFAULT_INSTANCE_ID,
+  dependencies = {},
+) {
+  const explicitYeaftDir = explicitYeaftDirFromArgs(args);
+  if (explicitYeaftDir) return explicitYeaftDir;
+  const hasExplicitIdentity = args.includes('--name') || args.includes('--instance');
+  if (!hasExplicitIdentity && env.YEAFT_DIR) return env.YEAFT_DIR;
+  const readServiceConfig = dependencies.loadServiceConfig || loadServiceConfig;
+  const defaultYeaftDir = dependencies.getDefaultYeaftDir || getDefaultYeaftDir;
+  const persisted = readServiceConfig(instanceId)?.yeaftDir;
+  return persisted || defaultYeaftDir(instanceId);
 }
 
 /** Legacy alias for resolveServiceInstanceId(). */

package/service/index.js

@@ -29,6 +29,7 @@ export {
   resolveDisplayName,
   resolveRuntimeIdentity,
   resolveServiceInstanceId,
+  resolveManagedYeaftDir,
   shouldLoadLegacyLocalConfig,
   normalizeInstanceId,
   isDefaultInstance,

package/service/linux.js

@@ -12,7 +12,7 @@ export function getSystemdServicePath(instanceId = DEFAULT_INSTANCE_ID) {
   return join(homedir(), '.config', 'systemd', 'user', `${getServiceName(instanceId)}.service`);
 }
 
-function generateSystemdUnit(config) {
+export function generateSystemdUnit(config) {
   const nodePath = getNodePath();
   const cliPath = getCliPath();
   const logDir = getLogDir(config.instanceId);
@@ -38,7 +38,8 @@ ExecStart=${nodePath} ${cliPath}
 WorkingDirectory=${config.workDir || homedir()}
 Restart=on-failure
 RestartSec=10
-KillMode=process
+KillMode=mixed
+TimeoutStopSec=15
 ${envLines.join('\n')}
 Environment=PATH=${nodeBinDir}:${homedir()}/.local/bin:${homedir()}/.npm-global/bin:/usr/local/bin:/usr/bin:/bin