clawpanel/tests/hermes-browser-config.test.js

import test from 'node:test'
import assert from 'node:assert/strict'

import {
  buildHermesBrowserConfigValues,
  mergeHermesBrowserConfig,
} from '../scripts/dev-api.js'

test('Hermes 浏览器配置读取会提供上游默认值', () => {
  const values = buildHermesBrowserConfigValues({})

  assert.deepEqual(values, {
    browserInactivityTimeout: 120,
    browserCommandTimeout: 30,
    browserRecordSessions: false,
    browserEngine: 'auto',
    browserAllowPrivateUrls: false,
    browserAutoLocalForPrivateUrls: true,
    browserCdpUrl: '',
    browserCamofoxManagedPersistence: false,
    browserCamofoxUserId: '',
    browserCamofoxSessionKey: '',
    browserCamofoxAdoptExistingTab: false,
    browserDialogPolicy: 'must_respond',
    browserDialogTimeout: 300,
  })
})

test('Hermes 浏览器配置读取会回显 YAML 字段', () => {
  const values = buildHermesBrowserConfigValues({
    browser: {
      inactivity_timeout: 300,
      command_timeout: 45,
      record_sessions: true,
      engine: 'lightpanda',
      allow_private_urls: true,
      auto_local_for_private_urls: false,
      cdp_url: 'ws://127.0.0.1:9222/devtools/browser/demo',
      camofox: {
        managed_persistence: true,
        user_id: 'shared-camofox-user',
        session_key: 'shared-session-key',
        adopt_existing_tab: true,
      },
      dialog_policy: 'auto_accept',
      dialog_timeout_s: 120,
    },
  })

  assert.equal(values.browserInactivityTimeout, 300)
  assert.equal(values.browserCommandTimeout, 45)
  assert.equal(values.browserRecordSessions, true)
  assert.equal(values.browserEngine, 'lightpanda')
  assert.equal(values.browserAllowPrivateUrls, true)
  assert.equal(values.browserAutoLocalForPrivateUrls, false)
  assert.equal(values.browserCdpUrl, 'ws://127.0.0.1:9222/devtools/browser/demo')
  assert.equal(values.browserCamofoxManagedPersistence, true)
  assert.equal(values.browserCamofoxUserId, 'shared-camofox-user')
  assert.equal(values.browserCamofoxSessionKey, 'shared-session-key')
  assert.equal(values.browserCamofoxAdoptExistingTab, true)
  assert.equal(values.browserDialogPolicy, 'auto_accept')
  assert.equal(values.browserDialogTimeout, 120)
})

test('Hermes 浏览器配置保存会保留未知字段并写入上游结构', () => {
  const next = mergeHermesBrowserConfig({
    model: { provider: 'anthropic' },
    browser: {
      inactivity_timeout: 120,
      command_timeout: 30,
      record_sessions: false,
      engine: 'auto',
      cdp_url: 'ws://127.0.0.1:9222/devtools/browser/demo',
      camofox: {
        managed_persistence: false,
        user_id: 'old-user',
        session_key: 'old-session',
        adopt_existing_tab: false,
        custom_flag: 'keep-camofox',
      },
      custom_flag: 'keep-browser',
    },
    streaming: { enabled: true },
  }, {
    browserInactivityTimeout: '180',
    browserCommandTimeout: '60',
    browserRecordSessions: true,
    browserEngine: 'chrome',
    browserAllowPrivateUrls: true,
    browserAutoLocalForPrivateUrls: false,
    browserCdpUrl: 'http://127.0.0.1:9222',
    browserCamofoxManagedPersistence: true,
    browserCamofoxUserId: 'shared-camofox-user',
    browserCamofoxSessionKey: 'shared-session-key',
    browserCamofoxAdoptExistingTab: true,
    browserDialogPolicy: 'auto_dismiss',
    browserDialogTimeout: '45',
  })

  assert.deepEqual(next.model, { provider: 'anthropic' })
  assert.deepEqual(next.streaming, { enabled: true })
  assert.equal(next.browser.inactivity_timeout, 180)
  assert.equal(next.browser.command_timeout, 60)
  assert.equal(next.browser.record_sessions, true)
  assert.equal(next.browser.engine, 'chrome')
  assert.equal(next.browser.allow_private_urls, true)
  assert.equal(next.browser.auto_local_for_private_urls, false)
  assert.equal(next.browser.cdp_url, 'http://127.0.0.1:9222')
  assert.equal(next.browser.dialog_policy, 'auto_dismiss')
  assert.equal(next.browser.dialog_timeout_s, 45)
  assert.deepEqual(next.browser.camofox, {
    managed_persistence: true,
    user_id: 'shared-camofox-user',
    session_key: 'shared-session-key',
    adopt_existing_tab: true,
    custom_flag: 'keep-camofox',
  })
  assert.equal(next.browser.custom_flag, 'keep-browser')
})

test('Hermes 浏览器配置保存空 Camofox 身份字段会删除对应覆盖', () => {
  const next = mergeHermesBrowserConfig({
    browser: {
      camofox: {
        managed_persistence: true,
        user_id: 'old-user',
        session_key: 'old-session',
        adopt_existing_tab: true,
        custom_flag: 'keep-camofox',
      },
      custom_flag: 'keep-browser',
    },
  }, {
    browserCamofoxManagedPersistence: false,
    browserCamofoxUserId: '  ',
    browserCamofoxSessionKey: '',
    browserCamofoxAdoptExistingTab: false,
  })

  assert.equal(next.browser.camofox.managed_persistence, false)
  assert.equal(Object.hasOwn(next.browser.camofox, 'user_id'), false)
  assert.equal(Object.hasOwn(next.browser.camofox, 'session_key'), false)
  assert.equal(next.browser.camofox.adopt_existing_tab, false)
  assert.equal(next.browser.camofox.custom_flag, 'keep-camofox')
  assert.equal(next.browser.custom_flag, 'keep-browser')
})

test('Hermes 浏览器配置保存空 CDP URL 会移除可选字段', () => {
  const next = mergeHermesBrowserConfig({
    browser: {
      cdp_url: 'ws://127.0.0.1:9222/devtools/browser/demo',
      custom_flag: 'keep-browser',
    },
  }, {
    browserCdpUrl: '   ',
  })

  assert.equal(next.browser.custom_flag, 'keep-browser')
  assert.equal(Object.hasOwn(next.browser, 'cdp_url'), false)
})

test('Hermes 浏览器配置保存会拒绝非法引擎和越界值', () => {
  assert.throws(
    () => mergeHermesBrowserConfig({}, { browserEngine: 'firefox' }),
    /browser\.engine/,
  )
  assert.throws(
    () => mergeHermesBrowserConfig({}, { browserInactivityTimeout: '0' }),
    /browser\.inactivity_timeout/,
  )
  assert.throws(
    () => mergeHermesBrowserConfig({}, { browserCommandTimeout: '4' }),
    /browser\.command_timeout/,
  )
  assert.throws(
    () => mergeHermesBrowserConfig({}, { browserDialogPolicy: 'ignore' }),
    /browser\.dialog_policy/,
  )
  assert.throws(
    () => mergeHermesBrowserConfig({}, { browserDialogTimeout: '0' }),
    /browser\.dialog_timeout_s/,
  )
  assert.throws(
    () => mergeHermesBrowserConfig({}, { browserCdpUrl: 123 }),
    /browser\.cdp_url/,
  )
  assert.throws(
    () => mergeHermesBrowserConfig({}, { browserCamofoxUserId: 123 }),
    /browser\.camofox\.user_id/,
  )
  assert.throws(
    () => mergeHermesBrowserConfig({}, { browserCamofoxUserId: 'bad user' }),
    /browser\.camofox\.user_id/,
  )
  assert.throws(
    () => mergeHermesBrowserConfig({}, { browserCamofoxSessionKey: 'bad session' }),
    /browser\.camofox\.session_key/,
  )
})