@xopcai/xopc 0.0.115 → 0.0.117

package/dist/src/browser/providers/browser-ext-install.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-ext-install.js","names":[],"sources":["../../../../src/browser/providers/browser-ext-install.ts"],"sourcesContent":["/**\n * Install bundled Chrome extension artifacts into {resolveBinDir()}/browser-ext/.\n * Fixed path — gateway upgrades overwrite in place so Chrome sideload paths stay stable.\n */\n\nimport {\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  renameSync,\n  rmSync,\n  statSync,\n  writeFileSync,\n} from 'node:fs';\nimport { readFile, readdir, rm } from 'node:fs/promises';\nimport { spawn } from 'node:child_process';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport { PACKAGE_VERSION } from '../../package-version.js';\nimport { resolveBinDir } from '../../config/paths.js';\nimport { resolvePackageRoot } from '../../infra/update-check.js';\nimport { writeTextAtomic } from '../../infra/write-file-atomic.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { assertCacheDir } from '../cache-dir-policy.js';\n\nconst log = createLogger('BrowserExtInstall');\n\nconst META_FILENAME = '.meta.json';\nconst STAGING_MAX_AGE_MS = 60 * 60 * 1000;\nconst INSTALLED_ARTIFACT_NAMES = ['manifest.json', 'popup.html', 'dist', 'icons'] as const;\n\nexport const BROWSER_EXT_REQUIRED_FILES = [\n  'manifest.json',\n  'popup.html',\n  'dist/background.js',\n  'dist/content.js',\n  'dist/popup.js',\n] as const;\n\nexport type BrowserExtBundledFrom = 'npm-dist' | 'git-dev' | 'electron-asar' | 'env-override';\n\nexport interface BrowserExtInstallMeta {\n  xopcVersion: string;\n  manifestVersion: string;\n  source: 'bundled';\n  bundledFrom: BrowserExtBundledFrom;\n  installedAt: string;\n  installPath: string;\n}\n\nexport interface BrowserExtDoctor {\n  bundledAvailable: boolean;\n  installed: boolean;\n  xopcVersion: string;\n  installedVersion?: string;\n  manifestVersion?: string;\n  extensionDir?: string;\n  cacheDir: string;\n  needsRefresh: boolean;\n  needsChromeReload?: boolean;\n  bundledFrom?: BrowserExtBundledFrom;\n  runtimeExtensionVersion?: string;\n}\n\nexport interface EnsureBrowserExtResult {\n  extensionDir: string;\n  xopcVersion: string;\n  copied: boolean;\n}\n\nfunction moduleDir(): string {\n  return dirname(fileURLToPath(import.meta.url));\n}\n\n/** Validate a directory contains a loadable extension tree. */\nexport function validateBrowserExtLayout(dir: string): boolean {\n  return BROWSER_EXT_REQUIRED_FILES.every((rel) => existsSync(join(dir, rel)));\n}\n\nfunction readManifestVersion(dir: string): string | undefined {\n  try {\n    const raw = readFileSync(join(dir, 'manifest.json'), 'utf8');\n    const parsed = JSON.parse(raw) as { version?: unknown };\n    return typeof parsed.version === 'string' ? parsed.version : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nasync function readMeta(metaPath: string): Promise<BrowserExtInstallMeta | null> {\n  try {\n    const raw = await readFile(metaPath, 'utf8');\n    const parsed = JSON.parse(raw) as BrowserExtInstallMeta;\n    if (parsed && typeof parsed === 'object' && typeof parsed.xopcVersion === 'string') {\n      return parsed;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\nfunction browserExtRoot(cacheDir: string): string {\n  return join(cacheDir, 'browser-ext');\n}\n\nfunction resolveMetaPath(cacheDir: string): string {\n  return join(browserExtRoot(cacheDir), META_FILENAME);\n}\n\n/** Resolve the installed extension directory (fixed `browser-ext/` root). */\nexport function resolveInstalledExtensionPath(\n  cacheDir: string,\n  _meta: BrowserExtInstallMeta | null,\n): string | null {\n  const root = browserExtRoot(cacheDir);\n  if (validateBrowserExtLayout(root)) {\n    return root;\n  }\n\n  return null;\n}\n\nfunction walkAncestorsForGitDevBundled(start: string): string | null {\n  let dir = start;\n  for (let i = 0; i < 12; i++) {\n    const candidate = join(dir, 'packages/browser-ext');\n    if (validateBrowserExtLayout(candidate)) {\n      return candidate;\n    }\n    const parent = dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  return null;\n}\n\n/**\n * Resolve the bundled extension source directory (read-only).\n */\nexport async function resolveBundledBrowserExtDir(): Promise<{\n  dir: string;\n  bundledFrom: BrowserExtBundledFrom;\n} | null> {\n  const envOverride = process.env.XOPC_BROWSER_EXT_BUNDLED_ROOT?.trim();\n  if (envOverride && validateBrowserExtLayout(envOverride)) {\n    return { dir: envOverride, bundledFrom: 'env-override' };\n  }\n\n  const fromModule = join(moduleDir(), '../../../browser-ext');\n  if (validateBrowserExtLayout(fromModule)) {\n    const root = await resolvePackageRoot();\n    const bundledFrom: BrowserExtBundledFrom =\n      process.versions.electron && root && root.includes('app.asar') ? 'electron-asar' : 'npm-dist';\n    return { dir: fromModule, bundledFrom };\n  }\n\n  const gitDev = walkAncestorsForGitDevBundled(moduleDir());\n  if (gitDev) {\n    return { dir: gitDev, bundledFrom: 'git-dev' };\n  }\n\n  const root = await resolvePackageRoot();\n  if (root) {\n    const distBundled = join(root, 'dist/browser-ext');\n    if (validateBrowserExtLayout(distBundled)) {\n      const bundledFrom: BrowserExtBundledFrom =\n        process.versions.electron && root.includes('app.asar') ? 'electron-asar' : 'npm-dist';\n      return { dir: distBundled, bundledFrom };\n    }\n  }\n\n  return null;\n}\n\nexport function computeNeedsRefresh(params: {\n  force?: boolean;\n  bundledManifestVersion: string;\n  installedPath: string | null;\n  meta: BrowserExtInstallMeta | null;\n}): boolean {\n  if (params.force) return true;\n  if (!params.installedPath || !validateBrowserExtLayout(params.installedPath)) return true;\n\n  const installedManifest = readManifestVersion(params.installedPath);\n  if (!installedManifest || installedManifest !== params.bundledManifestVersion) return true;\n\n  if (!params.meta || params.meta.xopcVersion !== PACKAGE_VERSION) return true;\n\n  return false;\n}\n\nasync function cleanupStaleStaging(root: string): Promise<void> {\n  if (!existsSync(root)) return;\n  let entries: string[];\n  try {\n    entries = await readdir(root);\n  } catch {\n    return;\n  }\n  const now = Date.now();\n  for (const name of entries) {\n    if (!name.startsWith('.staging-')) continue;\n    const full = join(root, name);\n    try {\n      const st = statSync(full);\n      if (now - st.mtimeMs > STAGING_MAX_AGE_MS) {\n        await rm(full, { recursive: true, force: true });\n      }\n    } catch {\n      /* */\n    }\n  }\n}\n\nfunction removeInstalledArtifacts(root: string): void {\n  for (const name of INSTALLED_ARTIFACT_NAMES) {\n    const full = join(root, name);\n    if (existsSync(full)) {\n      rmSync(full, { recursive: true, force: true });\n    }\n  }\n}\n\nfunction promoteStagingToRoot(stagingDir: string, root: string): void {\n  removeInstalledArtifacts(root);\n  for (const name of readdirSync(stagingDir)) {\n    renameSync(join(stagingDir, name), join(root, name));\n  }\n  rmSync(stagingDir, { recursive: true, force: true });\n  if (!validateBrowserExtLayout(root)) {\n    throw new Error('Bundled browser extension copy failed validation');\n  }\n}\n\n/** Copy one bundled file (read/write works when src is inside Electron app.asar). */\nfunction copyBundledFile(src: string, dest: string): void {\n  mkdirSync(dirname(dest), { recursive: true });\n  writeFileSync(dest, readFileSync(src));\n}\n\nconst BROWSER_EXT_DIST_FILES = ['background.js', 'content.js', 'popup.js'] as const;\nconst BROWSER_EXT_ICON_FILES = ['icon-16.png', 'icon-32.png', 'icon-48.png', 'icon-128.png'] as const;\n\nfunction copyBundledTree(src: string, dest: string): void {\n  mkdirSync(dest, { recursive: true });\n  for (const name of ['manifest.json', 'popup.html']) {\n    copyBundledFile(join(src, name), join(dest, name));\n  }\n  for (const file of BROWSER_EXT_DIST_FILES) {\n    copyBundledFile(join(src, 'dist', file), join(dest, 'dist', file));\n  }\n  for (const icon of BROWSER_EXT_ICON_FILES) {\n    const iconSrc = join(src, 'icons', icon);\n    if (existsSync(iconSrc)) {\n      copyBundledFile(iconSrc, join(dest, 'icons', icon));\n    }\n  }\n  if (!validateBrowserExtLayout(dest)) {\n    throw new Error('Bundled browser extension copy failed validation');\n  }\n}\n\nexport async function browserExtDoctor(opts?: {\n  cacheDir?: string;\n  runtimeExtensionVersion?: string;\n}): Promise<BrowserExtDoctor> {\n  const resolvedCache = opts?.cacheDir?.trim()\n    ? assertCacheDir(opts.cacheDir)\n    : resolveBinDir();\n  const cacheDir = resolvedCache || resolveBinDir();\n\n  const bundled = await resolveBundledBrowserExtDir();\n  const bundledManifestVersion = bundled ? readManifestVersion(bundled.dir) : undefined;\n  const meta = await readMeta(resolveMetaPath(cacheDir));\n  const installedPath = resolveInstalledExtensionPath(cacheDir, meta);\n\n  const needsRefresh = bundled\n    ? computeNeedsRefresh({\n        force: false,\n        bundledManifestVersion: bundledManifestVersion ?? PACKAGE_VERSION,\n        installedPath,\n        meta,\n      })\n    : false;\n\n  const installed = Boolean(installedPath) && !needsRefresh;\n  const manifestVersion = installedPath ? readManifestVersion(installedPath) : undefined;\n\n  let needsChromeReload: boolean | undefined;\n  const runtimeVer = opts?.runtimeExtensionVersion?.trim();\n  if (runtimeVer && manifestVersion && runtimeVer !== manifestVersion) {\n    needsChromeReload = true;\n  }\n\n  return {\n    bundledAvailable: Boolean(bundled),\n    installed,\n    xopcVersion: PACKAGE_VERSION,\n    installedVersion: meta?.xopcVersion,\n    manifestVersion,\n    extensionDir: installedPath ?? undefined,\n    cacheDir,\n    needsRefresh,\n    needsChromeReload,\n    bundledFrom: bundled?.bundledFrom,\n    runtimeExtensionVersion: runtimeVer,\n  };\n}\n\nexport async function ensureBrowserExtensionArtifacts(opts?: {\n  force?: boolean;\n  cacheDir?: string;\n}): Promise<EnsureBrowserExtResult> {\n  const resolvedCache = opts?.cacheDir?.trim()\n    ? assertCacheDir(opts.cacheDir)\n    : resolveBinDir();\n  const cacheDir = resolvedCache || resolveBinDir();\n\n  const bundled = await resolveBundledBrowserExtDir();\n  if (!bundled) {\n    throw new Error(\n      'Bundled browser extension not found. Reinstall xopc or run from a built checkout (pnpm run build).',\n    );\n  }\n\n  const bundledManifestVersion = readManifestVersion(bundled.dir) ?? PACKAGE_VERSION;\n  const root = browserExtRoot(cacheDir);\n  mkdirSync(root, { recursive: true });\n  await cleanupStaleStaging(root);\n\n  const meta = await readMeta(resolveMetaPath(cacheDir));\n  const installedPath = resolveInstalledExtensionPath(cacheDir, meta);\n  const needsRefresh = computeNeedsRefresh({\n    force: opts?.force,\n    bundledManifestVersion,\n    installedPath,\n    meta,\n  });\n\n  const extensionDir = root;\n\n  if (!needsRefresh && installedPath) {\n    return {\n      extensionDir: installedPath,\n      xopcVersion: PACKAGE_VERSION,\n      copied: false,\n    };\n  }\n\n  const stagingDir = join(root, `.staging-${process.pid}`);\n\n  if (existsSync(stagingDir)) {\n    rmSync(stagingDir, { recursive: true, force: true });\n  }\n  copyBundledTree(bundled.dir, stagingDir);\n  promoteStagingToRoot(stagingDir, root);\n\n  const nextMeta: BrowserExtInstallMeta = {\n    xopcVersion: PACKAGE_VERSION,\n    manifestVersion: bundledManifestVersion,\n    source: 'bundled',\n    bundledFrom: bundled.bundledFrom,\n    installedAt: new Date().toISOString(),\n    installPath: extensionDir,\n  };\n  await writeTextAtomic(resolveMetaPath(cacheDir), JSON.stringify(nextMeta, null, 2));\n\n  log.info(\n    { extensionDir, xopcVersion: PACKAGE_VERSION, bundledFrom: bundled.bundledFrom },\n    'Browser extension artifacts installed',\n  );\n\n  return {\n    extensionDir,\n    xopcVersion: PACKAGE_VERSION,\n    copied: true,\n  };\n}\n\n/**\n * Gateway startup hook: ensure artifacts when extension backend is enabled or prior install exists.\n */\nexport async function ensureBrowserExtensionOnStartup(config: {\n  agents?: { defaults?: { browser?: { backend?: string } } };\n}): Promise<void> {\n  const backend = config.agents?.defaults?.browser?.backend;\n  const cacheDir = resolveBinDir();\n  const metaExists = existsSync(resolveMetaPath(cacheDir));\n  if (backend !== 'extension' && !metaExists) {\n    return;\n  }\n  await ensureBrowserExtensionArtifacts();\n}\n\nexport async function readInstalledExtensionDir(cacheDir?: string): Promise<string | null> {\n  const dir = cacheDir?.trim() ? assertCacheDir(cacheDir) : resolveBinDir();\n  const resolved = dir || resolveBinDir();\n  const meta = await readMeta(resolveMetaPath(resolved));\n  return resolveInstalledExtensionPath(resolved, meta);\n}\n\nexport type BrowserExtensionOpenAction = 'chrome' | 'folder' | 'both';\n\nfunction spawnDetached(command: string, args: readonly string[]): void {\n  spawn(command, [...args], { stdio: 'ignore', detached: true }).unref();\n}\n\nfunction openChromeExtensionsPage(): void {\n  const chromeUrl = 'chrome://extensions';\n  if (process.platform === 'darwin') {\n    spawnDetached('open', ['-a', 'Google Chrome', chromeUrl]);\n    return;\n  }\n  if (process.platform === 'win32') {\n    spawnDetached('cmd', ['/c', 'start', 'chrome', chromeUrl]);\n    return;\n  }\n  spawnDetached('xdg-open', [chromeUrl]);\n}\n\nfunction revealFolderInFileManager(dir: string): void {\n  if (process.platform === 'darwin') {\n    spawnDetached('open', [dir]);\n    return;\n  }\n  if (process.platform === 'win32') {\n    spawnDetached('explorer', [dir]);\n    return;\n  }\n  spawnDetached('xdg-open', [dir]);\n}\n\n/**\n * Open chrome://extensions and/or reveal the installed extension folder on the gateway host.\n */\nexport async function openBrowserExtensionInstallUi(opts: {\n  action: BrowserExtensionOpenAction;\n  cacheDir?: string;\n}): Promise<{ extensionDir: string }> {\n  const doctor = await browserExtDoctor({ cacheDir: opts.cacheDir });\n  const dir = doctor.extensionDir;\n  if (!dir) {\n    throw new Error('Extension not installed. Run xopc browser extension install first.');\n  }\n\n  if (opts.action === 'chrome' || opts.action === 'both') {\n    openChromeExtensionsPage();\n  }\n  if (opts.action === 'folder' || opts.action === 'both') {\n    revealFolderInFileManager(dir);\n  }\n\n  return { extensionDir: dir };\n}\n"],"mappings":"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"}
+{"version":3,"file":"browser-ext-install.js","names":[],"sources":["../../../../src/browser/providers/browser-ext-install.ts"],"sourcesContent":["/**\n * Install bundled Chrome extension artifacts into {resolveBinDir()}/browser-ext/.\n * Fixed path — gateway upgrades overwrite in place so Chrome sideload paths stay stable.\n */\n\nimport {\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  renameSync,\n  rmSync,\n  statSync,\n  writeFileSync,\n} from 'node:fs';\nimport { readFile, readdir, rm } from 'node:fs/promises';\nimport { spawn } from 'node:child_process';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport { PACKAGE_VERSION } from '../../package-version.js';\nimport { resolveBinDir } from '../../config/paths.js';\nimport { resolvePackageRoot } from '../../infra/update-check.js';\nimport { writeTextAtomic } from '../../infra/write-file-atomic.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { assertCacheDir } from '../cache-dir-policy.js';\n\nconst log = createLogger('BrowserExtInstall');\n\nconst META_FILENAME = '.meta.json';\nconst STAGING_MAX_AGE_MS = 60 * 60 * 1000;\nconst INSTALLED_ARTIFACT_NAMES = ['manifest.json', 'popup.html', 'dist', 'icons'] as const;\n\nexport const BROWSER_EXT_REQUIRED_FILES = [\n  'manifest.json',\n  'popup.html',\n  'dist/background.js',\n  'dist/content.js',\n  'dist/popup.js',\n] as const;\n\nexport type BrowserExtBundledFrom = 'npm-dist' | 'git-dev' | 'electron-asar' | 'env-override';\n\nexport interface BrowserExtInstallMeta {\n  xopcVersion: string;\n  manifestVersion: string;\n  source: 'bundled';\n  bundledFrom: BrowserExtBundledFrom;\n  installedAt: string;\n  installPath: string;\n}\n\nexport interface BrowserExtDoctor {\n  bundledAvailable: boolean;\n  installed: boolean;\n  xopcVersion: string;\n  installedVersion?: string;\n  manifestVersion?: string;\n  extensionDir?: string;\n  cacheDir: string;\n  needsRefresh: boolean;\n  needsChromeReload?: boolean;\n  bundledFrom?: BrowserExtBundledFrom;\n  runtimeExtensionVersion?: string;\n}\n\nexport interface EnsureBrowserExtResult {\n  extensionDir: string;\n  xopcVersion: string;\n  copied: boolean;\n}\n\nfunction moduleDir(): string {\n  return dirname(fileURLToPath(import.meta.url));\n}\n\n/** Validate a directory contains a loadable extension tree. */\nexport function validateBrowserExtLayout(dir: string): boolean {\n  return BROWSER_EXT_REQUIRED_FILES.every((rel) => existsSync(join(dir, rel)));\n}\n\nfunction readManifestVersion(dir: string): string | undefined {\n  try {\n    const raw = readFileSync(join(dir, 'manifest.json'), 'utf8');\n    const parsed = JSON.parse(raw) as { version?: unknown };\n    return typeof parsed.version === 'string' ? parsed.version : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nasync function readMeta(metaPath: string): Promise<BrowserExtInstallMeta | null> {\n  try {\n    const raw = await readFile(metaPath, 'utf8');\n    const parsed = JSON.parse(raw) as BrowserExtInstallMeta;\n    if (parsed && typeof parsed === 'object' && typeof parsed.xopcVersion === 'string') {\n      return parsed;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\nfunction browserExtRoot(cacheDir: string): string {\n  return join(cacheDir, 'browser-ext');\n}\n\nfunction resolveMetaPath(cacheDir: string): string {\n  return join(browserExtRoot(cacheDir), META_FILENAME);\n}\n\n/** Resolve the installed extension directory (fixed `browser-ext/` root). */\nexport function resolveInstalledExtensionPath(\n  cacheDir: string,\n  _meta: BrowserExtInstallMeta | null,\n): string | null {\n  const root = browserExtRoot(cacheDir);\n  if (validateBrowserExtLayout(root)) {\n    return root;\n  }\n\n  return null;\n}\n\nfunction walkAncestorsForGitDevBundled(start: string): string | null {\n  let dir = start;\n  for (let i = 0; i < 12; i++) {\n    const candidate = join(dir, 'packages/browser-ext');\n    if (validateBrowserExtLayout(candidate)) {\n      return candidate;\n    }\n    const parent = dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  return null;\n}\n\n/**\n * Resolve the bundled extension source directory (read-only).\n */\nexport async function resolveBundledBrowserExtDir(): Promise<{\n  dir: string;\n  bundledFrom: BrowserExtBundledFrom;\n} | null> {\n  const envOverride = process.env.XOPC_BROWSER_EXT_BUNDLED_ROOT?.trim();\n  if (envOverride && validateBrowserExtLayout(envOverride)) {\n    return { dir: envOverride, bundledFrom: 'env-override' };\n  }\n\n  const fromModule = join(moduleDir(), '../../../browser-ext');\n  if (validateBrowserExtLayout(fromModule)) {\n    const root = await resolvePackageRoot();\n    const bundledFrom: BrowserExtBundledFrom =\n      process.versions.electron && root && root.includes('app.asar') ? 'electron-asar' : 'npm-dist';\n    return { dir: fromModule, bundledFrom };\n  }\n\n  const gitDev = walkAncestorsForGitDevBundled(moduleDir());\n  if (gitDev) {\n    return { dir: gitDev, bundledFrom: 'git-dev' };\n  }\n\n  const root = await resolvePackageRoot();\n  if (root) {\n    const distBundled = join(root, 'dist/browser-ext');\n    if (validateBrowserExtLayout(distBundled)) {\n      const bundledFrom: BrowserExtBundledFrom =\n        process.versions.electron && root.includes('app.asar') ? 'electron-asar' : 'npm-dist';\n      return { dir: distBundled, bundledFrom };\n    }\n  }\n\n  return null;\n}\n\nexport function computeNeedsRefresh(params: {\n  force?: boolean;\n  bundledManifestVersion: string;\n  installedPath: string | null;\n  meta: BrowserExtInstallMeta | null;\n}): boolean {\n  if (params.force) return true;\n  if (!params.installedPath || !validateBrowserExtLayout(params.installedPath)) return true;\n\n  const installedManifest = readManifestVersion(params.installedPath);\n  if (!installedManifest || installedManifest !== params.bundledManifestVersion) return true;\n\n  if (!params.meta || params.meta.xopcVersion !== PACKAGE_VERSION) return true;\n\n  return false;\n}\n\nasync function cleanupStaleStaging(root: string): Promise<void> {\n  if (!existsSync(root)) return;\n  let entries: string[];\n  try {\n    entries = await readdir(root);\n  } catch {\n    return;\n  }\n  const now = Date.now();\n  for (const name of entries) {\n    if (!name.startsWith('.staging-')) continue;\n    const full = join(root, name);\n    try {\n      const st = statSync(full);\n      if (now - st.mtimeMs > STAGING_MAX_AGE_MS) {\n        await rm(full, { recursive: true, force: true });\n      }\n    } catch {\n      /* */\n    }\n  }\n}\n\nfunction removeInstalledArtifacts(root: string): void {\n  for (const name of INSTALLED_ARTIFACT_NAMES) {\n    const full = join(root, name);\n    if (existsSync(full)) {\n      rmSync(full, { recursive: true, force: true });\n    }\n  }\n}\n\nfunction promoteStagingToRoot(stagingDir: string, root: string): void {\n  removeInstalledArtifacts(root);\n  for (const name of readdirSync(stagingDir)) {\n    renameSync(join(stagingDir, name), join(root, name));\n  }\n  rmSync(stagingDir, { recursive: true, force: true });\n  if (!validateBrowserExtLayout(root)) {\n    throw new Error('Bundled browser extension copy failed validation');\n  }\n}\n\n/** Copy one bundled file (read/write works when src is inside Electron app.asar). */\nfunction copyBundledFile(src: string, dest: string): void {\n  mkdirSync(dirname(dest), { recursive: true });\n  writeFileSync(dest, readFileSync(src));\n}\n\nconst BROWSER_EXT_DIST_FILES = ['background.js', 'content.js', 'popup.js'] as const;\nconst BROWSER_EXT_ICON_FILES = ['icon-16.png', 'icon-32.png', 'icon-48.png', 'icon-128.png'] as const;\n\nfunction copyBundledTree(src: string, dest: string): void {\n  mkdirSync(dest, { recursive: true });\n  for (const name of ['manifest.json', 'popup.html']) {\n    copyBundledFile(join(src, name), join(dest, name));\n  }\n  for (const file of BROWSER_EXT_DIST_FILES) {\n    copyBundledFile(join(src, 'dist', file), join(dest, 'dist', file));\n  }\n  for (const icon of BROWSER_EXT_ICON_FILES) {\n    const iconSrc = join(src, 'icons', icon);\n    if (existsSync(iconSrc)) {\n      copyBundledFile(iconSrc, join(dest, 'icons', icon));\n    }\n  }\n  if (!validateBrowserExtLayout(dest)) {\n    throw new Error('Bundled browser extension copy failed validation');\n  }\n}\n\nexport async function browserExtDoctor(opts?: {\n  cacheDir?: string;\n  runtimeExtensionVersion?: string;\n}): Promise<BrowserExtDoctor> {\n  const resolvedCache = opts?.cacheDir?.trim()\n    ? assertCacheDir(opts.cacheDir)\n    : resolveBinDir();\n  const cacheDir = resolvedCache || resolveBinDir();\n\n  const bundled = await resolveBundledBrowserExtDir();\n  const bundledManifestVersion = bundled ? readManifestVersion(bundled.dir) : undefined;\n  const meta = await readMeta(resolveMetaPath(cacheDir));\n  const installedPath = resolveInstalledExtensionPath(cacheDir, meta);\n\n  const needsRefresh = bundled\n    ? computeNeedsRefresh({\n        force: false,\n        bundledManifestVersion: bundledManifestVersion ?? PACKAGE_VERSION,\n        installedPath,\n        meta,\n      })\n    : false;\n\n  const installed = Boolean(installedPath) && !needsRefresh;\n  const manifestVersion = installedPath ? readManifestVersion(installedPath) : undefined;\n\n  let needsChromeReload: boolean | undefined;\n  const runtimeVer = opts?.runtimeExtensionVersion?.trim();\n  if (runtimeVer && manifestVersion && runtimeVer !== manifestVersion) {\n    needsChromeReload = true;\n  }\n\n  return {\n    bundledAvailable: Boolean(bundled),\n    installed,\n    xopcVersion: PACKAGE_VERSION,\n    installedVersion: meta?.xopcVersion,\n    manifestVersion,\n    extensionDir: installedPath ?? undefined,\n    cacheDir,\n    needsRefresh,\n    needsChromeReload,\n    bundledFrom: bundled?.bundledFrom,\n    runtimeExtensionVersion: runtimeVer,\n  };\n}\n\nexport async function ensureBrowserExtensionArtifacts(opts?: {\n  force?: boolean;\n  cacheDir?: string;\n}): Promise<EnsureBrowserExtResult> {\n  const resolvedCache = opts?.cacheDir?.trim()\n    ? assertCacheDir(opts.cacheDir)\n    : resolveBinDir();\n  const cacheDir = resolvedCache || resolveBinDir();\n\n  const bundled = await resolveBundledBrowserExtDir();\n  if (!bundled) {\n    throw new Error(\n      'Bundled browser extension not found. Reinstall xopc or run from a built checkout (pnpm run build).',\n    );\n  }\n\n  const bundledManifestVersion = readManifestVersion(bundled.dir) ?? PACKAGE_VERSION;\n  const root = browserExtRoot(cacheDir);\n  mkdirSync(root, { recursive: true });\n  await cleanupStaleStaging(root);\n\n  const meta = await readMeta(resolveMetaPath(cacheDir));\n  const installedPath = resolveInstalledExtensionPath(cacheDir, meta);\n  const needsRefresh = computeNeedsRefresh({\n    force: opts?.force,\n    bundledManifestVersion,\n    installedPath,\n    meta,\n  });\n\n  const extensionDir = root;\n\n  if (!needsRefresh && installedPath) {\n    return {\n      extensionDir: installedPath,\n      xopcVersion: PACKAGE_VERSION,\n      copied: false,\n    };\n  }\n\n  const stagingDir = join(root, `.staging-${process.pid}`);\n\n  if (existsSync(stagingDir)) {\n    rmSync(stagingDir, { recursive: true, force: true });\n  }\n  copyBundledTree(bundled.dir, stagingDir);\n  promoteStagingToRoot(stagingDir, root);\n\n  const nextMeta: BrowserExtInstallMeta = {\n    xopcVersion: PACKAGE_VERSION,\n    manifestVersion: bundledManifestVersion,\n    source: 'bundled',\n    bundledFrom: bundled.bundledFrom,\n    installedAt: new Date().toISOString(),\n    installPath: extensionDir,\n  };\n  await writeTextAtomic(resolveMetaPath(cacheDir), JSON.stringify(nextMeta, null, 2));\n\n  log.info(\n    { extensionDir, xopcVersion: PACKAGE_VERSION, bundledFrom: bundled.bundledFrom },\n    'Browser extension artifacts installed',\n  );\n\n  return {\n    extensionDir,\n    xopcVersion: PACKAGE_VERSION,\n    copied: true,\n  };\n}\n\n/** Gateway startup hook: ensure extension artifacts for the fixed extension backend. */\nexport async function ensureBrowserExtensionOnStartup(_config: unknown): Promise<void> {\n  await ensureBrowserExtensionArtifacts();\n}\n\nexport async function readInstalledExtensionDir(cacheDir?: string): Promise<string | null> {\n  const dir = cacheDir?.trim() ? assertCacheDir(cacheDir) : resolveBinDir();\n  const resolved = dir || resolveBinDir();\n  const meta = await readMeta(resolveMetaPath(resolved));\n  return resolveInstalledExtensionPath(resolved, meta);\n}\n\nexport type BrowserExtensionOpenAction = 'chrome' | 'folder' | 'both';\n\nfunction spawnDetached(command: string, args: readonly string[]): void {\n  spawn(command, [...args], { stdio: 'ignore', detached: true }).unref();\n}\n\nfunction openChromeExtensionsPage(): void {\n  const chromeUrl = 'chrome://extensions';\n  if (process.platform === 'darwin') {\n    spawnDetached('open', ['-a', 'Google Chrome', chromeUrl]);\n    return;\n  }\n  if (process.platform === 'win32') {\n    spawnDetached('cmd', ['/c', 'start', 'chrome', chromeUrl]);\n    return;\n  }\n  spawnDetached('xdg-open', [chromeUrl]);\n}\n\nfunction revealFolderInFileManager(dir: string): void {\n  if (process.platform === 'darwin') {\n    spawnDetached('open', [dir]);\n    return;\n  }\n  if (process.platform === 'win32') {\n    spawnDetached('explorer', [dir]);\n    return;\n  }\n  spawnDetached('xdg-open', [dir]);\n}\n\n/**\n * Open chrome://extensions and/or reveal the installed extension folder on the gateway host.\n */\nexport async function openBrowserExtensionInstallUi(opts: {\n  action: BrowserExtensionOpenAction;\n  cacheDir?: string;\n}): Promise<{ extensionDir: string }> {\n  const doctor = await browserExtDoctor({ cacheDir: opts.cacheDir });\n  const dir = doctor.extensionDir;\n  if (!dir) {\n    throw new Error('Extension not installed. Run xopc browser extension install first.');\n  }\n\n  if (opts.action === 'chrome' || opts.action === 'both') {\n    openChromeExtensionsPage();\n  }\n  if (opts.action === 'folder' || opts.action === 'both') {\n    revealFolderInFileManager(dir);\n  }\n\n  return { extensionDir: dir };\n}\n"],"mappings":"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"}

package/dist/src/browser/readiness.js

@@ -23,16 +23,15 @@ function hint(backend, reason, detail) {
 		deepLink: buildBrowserSetupDeepLink(backend)
 	};
 }
-async function checkExtension(cfg) {
+async function checkExtension(config) {
 	try {
 		const { browserExtDoctor } = await import("./providers/browser-ext-install.js");
 		if (!(await browserExtDoctor()).installed) return hint("extension", "extension_not_installed", "extension artifacts not on disk");
 	} catch (e) {
 		return hint("extension", "extension_not_installed", e instanceof Error ? e.message : String(e));
 	}
-	const ext = cfg?.agents?.defaults?.browser?.extension;
-	const host = typeof ext?.host === "string" && ext.host.trim() ? ext.host.trim() : "127.0.0.1";
-	const port = typeof ext?.port === "number" && ext.port >= 1024 && ext.port <= 65535 ? Math.floor(ext.port) : 19820;
+	const host = config?.host?.trim() || "127.0.0.1";
+	const port = typeof config?.port === "number" && config.port >= 1024 && config.port <= 65535 ? Math.floor(config.port) : 19820;
 	try {
 		const { getExtensionBrowserServerSnapshot } = await import("./providers/extension-ws-acquire.js");
 		if (getExtensionBrowserServerSnapshot().active) try {
@@ -56,13 +55,12 @@ async function checkLocal() {
 		return hint("local", "local_chromium_missing", e instanceof Error ? e.message : String(e));
 	}
 }
-async function checkCloak(cfg) {
-	const cb = cfg?.agents?.defaults?.browser?.cloakbrowser;
+async function checkCloak(config) {
 	try {
 		const { cloakBrowserDoctor } = await import("./providers/cloakbrowser.js");
 		const doctor = await cloakBrowserDoctor({
-			cacheDir: cb?.cacheDir,
-			binaryPath: cb?.binaryPath
+			...config?.cacheDir ? { cacheDir: config.cacheDir } : {},
+			...config?.binaryPath ? { binaryPath: config.binaryPath } : {}
 		});
 		if (!doctor.installed) return hint("cloakbrowser", "cloakbrowser_not_installed", `CloakBrowser binary not found (cacheDir=${doctor.cacheDir})`);
 		return null;
@@ -89,11 +87,10 @@ async function checkCdp(cdpUrl) {
 		return hint("cdp", "cdp_unreachable", e instanceof Error ? e.message : String(e));
 	}
 }
-function checkCloud(cfg, providerType) {
-	const cloud = cfg?.agents?.defaults?.browser?.cloud;
-	if (typeof cloud?.apiKey === "string" ? cloud.apiKey.trim() : "") return null;
-	if (providerType === "browserbase" ? process.env.BROWSERBASE_API_KEY?.trim() : process.env.BROWSER_USE_API_KEY?.trim()) return null;
-	return hint("cloud", "cloud_api_key_missing", `no API key configured for ${providerType}`);
+function checkCloud(params) {
+	if (params.apiKey?.trim()) return null;
+	if (params.providerType === "browserbase" ? process.env.BROWSERBASE_API_KEY?.trim() : process.env.BROWSER_USE_API_KEY?.trim()) return null;
+	return hint("cloud", "cloud_api_key_missing", `no API key configured for ${params.providerType}`);
 }
 /**
 * Probe the currently-configured browser backend. Returns `null` when ready.
@@ -108,19 +105,22 @@ async function checkBrowserReadiness(cfg) {
 	try {
 		switch (backend.mode) {
 			case "extension":
-				probe = await checkExtension(cfg);
+				probe = await checkExtension(backend.config);
 				break;
 			case "local":
 				probe = await checkLocal();
 				break;
 			case "cloakbrowser":
-				probe = await checkCloak(cfg);
+				probe = await checkCloak(backend.config);
 				break;
 			case "cdp":
 				probe = await checkCdp(backend.config.wsEndpoint);
 				break;
 			case "cloud":
-				probe = checkCloud(cfg, backend.config.type);
+				probe = checkCloud({
+					providerType: backend.config.type,
+					apiKey: backend.config.apiKey
+				});
 				break;
 		}
 	} catch (e) {

package/dist/src/browser/readiness.js.map

@@ -1 +1 @@
-{"version":3,"file":"readiness.js","names":[],"sources":["../../../src/browser/readiness.ts"],"sourcesContent":["/**\n * Backend readiness preflight for the `browser_use` tool.\n *\n * Reuses the same doctor functions that power the Settings → Browser page so\n * the agent never tries to launch a backend that the UI already knows is\n * broken. Produces a structured signal the chat surface can render as a\n * \"Setup browser\" card instead of a bare error string.\n */\n\nimport type { Config } from '../config/schema.js';\n\nimport { resolveBrowserBackendFromConfig } from './backend-from-config.js';\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('browser-readiness');\n\nexport type BrowserBackendKind =\n  | 'extension'\n  | 'local'\n  | 'cloakbrowser'\n  | 'cdp'\n  | 'cloud';\n\nexport type BrowserNotReadyReason =\n  | 'extension_not_installed'\n  | 'extension_bridge_offline'\n  | 'extension_not_connected'\n  | 'local_chromium_missing'\n  | 'cloakbrowser_not_installed'\n  | 'cdp_unreachable'\n  | 'cloud_api_key_missing';\n\nexport interface BrowserSetupHint {\n  backend: BrowserBackendKind;\n  reason: BrowserNotReadyReason;\n  /** Raw probe diagnostic; surfaced behind a disclosure for debugging. */\n  detail?: string;\n  /** Deep link into Settings → Browser focused on the right backend tab. */\n  deepLink: string;\n}\n\nexport class BrowserNotReadyError extends Error {\n  constructor(public readonly hint: BrowserSetupHint) {\n    super(`Browser backend \"${hint.backend}\" not ready: ${hint.reason}`);\n    this.name = 'BrowserNotReadyError';\n  }\n}\n\n/** Map backend → settings tab id (matches `BROWSER_BACKEND_TABS` on the web side). */\nexport function buildBrowserSetupDeepLink(backend: BrowserBackendKind): string {\n  return `/settings/agent-browser?tab=${backend}`;\n}\n\nfunction hint(\n  backend: BrowserBackendKind,\n  reason: BrowserNotReadyReason,\n  detail?: string,\n): BrowserSetupHint {\n  return { backend, reason, detail, deepLink: buildBrowserSetupDeepLink(backend) };\n}\n\nasync function checkExtension(cfg: Config | undefined): Promise<BrowserSetupHint | null> {\n  try {\n    const { browserExtDoctor } = await import('./providers/browser-ext-install.js');\n    const doctor = await browserExtDoctor();\n    if (!doctor.installed) {\n      return hint('extension', 'extension_not_installed', 'extension artifacts not on disk');\n    }\n  } catch (e) {\n    return hint('extension', 'extension_not_installed', e instanceof Error ? e.message : String(e));\n  }\n\n  const ext = cfg?.agents?.defaults?.browser?.extension;\n  const host = (typeof ext?.host === 'string' && ext.host.trim()) ? ext.host.trim() : '127.0.0.1';\n  const port = (typeof ext?.port === 'number' && ext.port >= 1024 && ext.port <= 65535)\n    ? Math.floor(ext.port)\n    : 19820;\n\n  try {\n    const { getExtensionBrowserServerSnapshot } = await import(\n      './providers/extension-ws-acquire.js'\n    );\n    const snapshot = getExtensionBrowserServerSnapshot();\n    if (snapshot.active) {\n      // Probe the HTTP `/` health endpoint to read `.connected`.\n      try {\n        const res = await fetch(`http://${host}:${port}/`, {\n          signal: AbortSignal.timeout(2000),\n        });\n        const data = (await res.json().catch(() => null)) as { connected?: boolean } | null;\n        if (data?.connected) return null;\n        return hint(\n          'extension',\n          'extension_not_connected',\n          'WS bridge is listening but no Chrome Extension client connected yet',\n        );\n      } catch {\n        // Bridge claims active but health probe failed — treat as offline.\n        return hint('extension', 'extension_bridge_offline', `health probe failed on ${host}:${port}`);\n      }\n    }\n    return hint('extension', 'extension_bridge_offline', `bridge not started on ${host}:${port}`);\n  } catch (e) {\n    return hint(\n      'extension',\n      'extension_bridge_offline',\n      e instanceof Error ? e.message : String(e),\n    );\n  }\n}\n\nasync function checkLocal(): Promise<BrowserSetupHint | null> {\n  try {\n    const { playwrightChromiumDoctor } = await import('./providers/playwright-doctor.js');\n    const doctor = await playwrightChromiumDoctor();\n    if (!doctor.installed) {\n      return hint(\n        'local',\n        'local_chromium_missing',\n        doctor.reason ?? 'Chromium binary not found on disk',\n      );\n    }\n    return null;\n  } catch (e) {\n    return hint('local', 'local_chromium_missing', e instanceof Error ? e.message : String(e));\n  }\n}\n\nasync function checkCloak(cfg: Config | undefined): Promise<BrowserSetupHint | null> {\n  const cb = cfg?.agents?.defaults?.browser?.cloakbrowser;\n  try {\n    const { cloakBrowserDoctor } = await import('./providers/cloakbrowser.js');\n    const doctor = await cloakBrowserDoctor({\n      cacheDir: cb?.cacheDir,\n      binaryPath: cb?.binaryPath,\n    });\n    if (!doctor.installed) {\n      return hint(\n        'cloakbrowser',\n        'cloakbrowser_not_installed',\n        `CloakBrowser binary not found (cacheDir=${doctor.cacheDir})`,\n      );\n    }\n    return null;\n  } catch (e) {\n    return hint(\n      'cloakbrowser',\n      'cloakbrowser_not_installed',\n      e instanceof Error ? e.message : String(e),\n    );\n  }\n}\n\nasync function checkCdp(cdpUrl: string): Promise<BrowserSetupHint | null> {\n  let httpBase: URL;\n  try {\n    httpBase = new URL(cdpUrl);\n    httpBase.protocol = httpBase.protocol === 'wss:' ? 'https:' : 'http:';\n    httpBase.pathname = '/json/version';\n    httpBase.search = '';\n    httpBase.hash = '';\n  } catch (e) {\n    return hint('cdp', 'cdp_unreachable', `invalid cdpUrl: ${e instanceof Error ? e.message : String(e)}`);\n  }\n  try {\n    const res = await fetch(httpBase.toString(), { signal: AbortSignal.timeout(2000) });\n    if (!res.ok) {\n      return hint('cdp', 'cdp_unreachable', `HTTP ${res.status} from ${httpBase.toString()}`);\n    }\n    return null;\n  } catch (e) {\n    return hint('cdp', 'cdp_unreachable', e instanceof Error ? e.message : String(e));\n  }\n}\n\nfunction checkCloud(cfg: Config | undefined, providerType: 'browserbase' | 'browser-use'): BrowserSetupHint | null {\n  const cloud = cfg?.agents?.defaults?.browser?.cloud;\n  const cfgKey = typeof cloud?.apiKey === 'string' ? cloud.apiKey.trim() : '';\n  if (cfgKey) return null;\n  const envKey =\n    providerType === 'browserbase'\n      ? process.env.BROWSERBASE_API_KEY?.trim()\n      : process.env.BROWSER_USE_API_KEY?.trim();\n  if (envKey) return null;\n  return hint(\n    'cloud',\n    'cloud_api_key_missing',\n    `no API key configured for ${providerType}`,\n  );\n}\n\n/**\n * Probe the currently-configured browser backend. Returns `null` when ready.\n *\n * Probe budget is small (filesystem stats + loopback fetches with a 2s timeout)\n * so it's safe to call before every `browser_use` invocation — but callers\n * typically cache the result for a few seconds to handle bursts.\n */\nexport async function checkBrowserReadiness(\n  cfg: Config | undefined,\n): Promise<BrowserNotReadyError | null> {\n  const backend = resolveBrowserBackendFromConfig(cfg);\n  let probe: BrowserSetupHint | null = null;\n  try {\n    switch (backend.mode) {\n      case 'extension':\n        probe = await checkExtension(cfg);\n        break;\n      case 'local':\n        probe = await checkLocal();\n        break;\n      case 'cloakbrowser':\n        probe = await checkCloak(cfg);\n        break;\n      case 'cdp':\n        probe = await checkCdp(backend.config.wsEndpoint);\n        break;\n      case 'cloud':\n        probe = checkCloud(cfg, backend.config.type);\n        break;\n    }\n  } catch (e) {\n    log.warn({ err: e, backend: backend.mode }, 'Readiness probe threw unexpectedly');\n    return null;\n  }\n  return probe ? new BrowserNotReadyError(probe) : null;\n}\n"],"mappings":"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"}
+{"version":3,"file":"readiness.js","names":[],"sources":["../../../src/browser/readiness.ts"],"sourcesContent":["/**\n * Backend readiness preflight for the `browser_use` tool.\n *\n * Reuses the same doctor functions that power the Settings → Browser page so\n * the agent never tries to launch a backend that the UI already knows is\n * broken. Produces a structured signal the chat surface can render as a\n * \"Setup browser\" card instead of a bare error string.\n */\n\nimport type { Config } from '../config/schema.js';\n\nimport { resolveBrowserBackendFromConfig } from './backend-from-config.js';\nimport type { CloakBrowserConfig, ExtensionConnectionConfig } from './providers/types.js';\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('browser-readiness');\n\nexport type BrowserBackendKind =\n  | 'extension'\n  | 'local'\n  | 'cloakbrowser'\n  | 'cdp'\n  | 'cloud';\n\nexport type BrowserNotReadyReason =\n  | 'extension_not_installed'\n  | 'extension_bridge_offline'\n  | 'extension_not_connected'\n  | 'local_chromium_missing'\n  | 'cloakbrowser_not_installed'\n  | 'cdp_unreachable'\n  | 'cloud_api_key_missing';\n\nexport interface BrowserSetupHint {\n  backend: BrowserBackendKind;\n  reason: BrowserNotReadyReason;\n  /** Raw probe diagnostic; surfaced behind a disclosure for debugging. */\n  detail?: string;\n  /** Deep link into Settings → Browser focused on the right backend tab. */\n  deepLink: string;\n}\n\nexport class BrowserNotReadyError extends Error {\n  constructor(public readonly hint: BrowserSetupHint) {\n    super(`Browser backend \"${hint.backend}\" not ready: ${hint.reason}`);\n    this.name = 'BrowserNotReadyError';\n  }\n}\n\n/** Map backend → settings tab id (matches `BROWSER_BACKEND_TABS` on the web side). */\nexport function buildBrowserSetupDeepLink(backend: BrowserBackendKind): string {\n  return `/settings/agent-browser?tab=${backend}`;\n}\n\nfunction hint(\n  backend: BrowserBackendKind,\n  reason: BrowserNotReadyReason,\n  detail?: string,\n): BrowserSetupHint {\n  return { backend, reason, detail, deepLink: buildBrowserSetupDeepLink(backend) };\n}\n\nasync function checkExtension(config: ExtensionConnectionConfig | undefined): Promise<BrowserSetupHint | null> {\n  try {\n    const { browserExtDoctor } = await import('./providers/browser-ext-install.js');\n    const doctor = await browserExtDoctor();\n    if (!doctor.installed) {\n      return hint('extension', 'extension_not_installed', 'extension artifacts not on disk');\n    }\n  } catch (e) {\n    return hint('extension', 'extension_not_installed', e instanceof Error ? e.message : String(e));\n  }\n\n  const host = config?.host?.trim() || '127.0.0.1';\n  const port =\n    typeof config?.port === 'number' && config.port >= 1024 && config.port <= 65535\n      ? Math.floor(config.port)\n      : 19820;\n\n  try {\n    const { getExtensionBrowserServerSnapshot } = await import(\n      './providers/extension-ws-acquire.js'\n    );\n    const snapshot = getExtensionBrowserServerSnapshot();\n    if (snapshot.active) {\n      // Probe the HTTP `/` health endpoint to read `.connected`.\n      try {\n        const res = await fetch(`http://${host}:${port}/`, {\n          signal: AbortSignal.timeout(2000),\n        });\n        const data = (await res.json().catch(() => null)) as { connected?: boolean } | null;\n        if (data?.connected) return null;\n        return hint(\n          'extension',\n          'extension_not_connected',\n          'WS bridge is listening but no Chrome Extension client connected yet',\n        );\n      } catch {\n        // Bridge claims active but health probe failed — treat as offline.\n        return hint('extension', 'extension_bridge_offline', `health probe failed on ${host}:${port}`);\n      }\n    }\n    return hint('extension', 'extension_bridge_offline', `bridge not started on ${host}:${port}`);\n  } catch (e) {\n    return hint(\n      'extension',\n      'extension_bridge_offline',\n      e instanceof Error ? e.message : String(e),\n    );\n  }\n}\n\nasync function checkLocal(): Promise<BrowserSetupHint | null> {\n  try {\n    const { playwrightChromiumDoctor } = await import('./providers/playwright-doctor.js');\n    const doctor = await playwrightChromiumDoctor();\n    if (!doctor.installed) {\n      return hint(\n        'local',\n        'local_chromium_missing',\n        doctor.reason ?? 'Chromium binary not found on disk',\n      );\n    }\n    return null;\n  } catch (e) {\n    return hint('local', 'local_chromium_missing', e instanceof Error ? e.message : String(e));\n  }\n}\n\nasync function checkCloak(config: CloakBrowserConfig | undefined): Promise<BrowserSetupHint | null> {\n  try {\n    const { cloakBrowserDoctor } = await import('./providers/cloakbrowser.js');\n    const doctor = await cloakBrowserDoctor({\n      ...(config?.cacheDir ? { cacheDir: config.cacheDir } : {}),\n      ...(config?.binaryPath ? { binaryPath: config.binaryPath } : {}),\n    });\n    if (!doctor.installed) {\n      return hint(\n        'cloakbrowser',\n        'cloakbrowser_not_installed',\n        `CloakBrowser binary not found (cacheDir=${doctor.cacheDir})`,\n      );\n    }\n    return null;\n  } catch (e) {\n    return hint(\n      'cloakbrowser',\n      'cloakbrowser_not_installed',\n      e instanceof Error ? e.message : String(e),\n    );\n  }\n}\n\nasync function checkCdp(cdpUrl: string): Promise<BrowserSetupHint | null> {\n  let httpBase: URL;\n  try {\n    httpBase = new URL(cdpUrl);\n    httpBase.protocol = httpBase.protocol === 'wss:' ? 'https:' : 'http:';\n    httpBase.pathname = '/json/version';\n    httpBase.search = '';\n    httpBase.hash = '';\n  } catch (e) {\n    return hint('cdp', 'cdp_unreachable', `invalid cdpUrl: ${e instanceof Error ? e.message : String(e)}`);\n  }\n  try {\n    const res = await fetch(httpBase.toString(), { signal: AbortSignal.timeout(2000) });\n    if (!res.ok) {\n      return hint('cdp', 'cdp_unreachable', `HTTP ${res.status} from ${httpBase.toString()}`);\n    }\n    return null;\n  } catch (e) {\n    return hint('cdp', 'cdp_unreachable', e instanceof Error ? e.message : String(e));\n  }\n}\n\nfunction checkCloud(params: {\n  apiKey?: string;\n  providerType: 'browserbase' | 'browser-use';\n}): BrowserSetupHint | null {\n  if (params.apiKey?.trim()) return null;\n  const envKey =\n    params.providerType === 'browserbase'\n      ? process.env.BROWSERBASE_API_KEY?.trim()\n      : process.env.BROWSER_USE_API_KEY?.trim();\n  if (envKey) return null;\n  return hint(\n    'cloud',\n    'cloud_api_key_missing',\n    `no API key configured for ${params.providerType}`,\n  );\n}\n\n/**\n * Probe the currently-configured browser backend. Returns `null` when ready.\n *\n * Probe budget is small (filesystem stats + loopback fetches with a 2s timeout)\n * so it's safe to call before every `browser_use` invocation — but callers\n * typically cache the result for a few seconds to handle bursts.\n */\nexport async function checkBrowserReadiness(\n  cfg: Config | undefined,\n): Promise<BrowserNotReadyError | null> {\n  const backend = resolveBrowserBackendFromConfig(cfg);\n  let probe: BrowserSetupHint | null = null;\n  try {\n    switch (backend.mode) {\n      case 'extension':\n        probe = await checkExtension(backend.config);\n        break;\n      case 'local':\n        probe = await checkLocal();\n        break;\n      case 'cloakbrowser':\n        probe = await checkCloak(backend.config);\n        break;\n      case 'cdp':\n        probe = await checkCdp(backend.config.wsEndpoint);\n        break;\n      case 'cloud':\n        probe = checkCloud({ providerType: backend.config.type, apiKey: backend.config.apiKey });\n        break;\n    }\n  } catch (e) {\n    log.warn({ err: e, backend: backend.mode }, 'Readiness probe threw unexpectedly');\n    return null;\n  }\n  return probe ? new BrowserNotReadyError(probe) : null;\n}\n"],"mappings":"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"}

package/dist/src/browser/schemas.js

@@ -53,7 +53,7 @@ const BrowserGetImagesSchema = Type.Object({
 });
 const BrowserCloseSchema = Type.Object({});
 const BrowserVisionSchema = Type.Object({
-	prompt: Type.Optional(Type.String({ description: "What to analyze in the screenshot (default: describe the visible UI state). Requires `agents.defaults.imageModel` to be configured." })),
+	prompt: Type.Optional(Type.String({ description: "What to analyze in the screenshot (default: describe the visible UI state). Requires an available image model." })),
 	selector: Type.Optional(Type.String({ description: "CSS selector to screenshot a specific element. Omit for full page." }))
 });
 const BrowserDialogSchema = Type.Object({

package/dist/src/browser/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","names":[],"sources":["../../../src/browser/schemas.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\n\nexport const BrowserNavigateSchema = Type.Object({\n  url: Type.String({ description: 'URL to navigate to' }),\n  waitFor: Type.Optional(\n    Type.Union(\n      [Type.Literal('load'), Type.Literal('domcontentloaded'), Type.Literal('networkidle')],\n      {\n        description: 'Wait condition (default: domcontentloaded)',\n      },\n    ),\n  ),\n});\n\nexport const BrowserSnapshotSchema = Type.Object({\n  selector: Type.Optional(\n    Type.String({ description: 'CSS selector to snapshot a specific element. Omit for full page.' }),\n  ),\n  maxLength: Type.Optional(\n    Type.Number({ description: 'Max characters in snapshot (default: 30000)', default: 30000 }),\n  ),\n});\n\nexport const BrowserClickSchema = Type.Object({\n  selector: Type.Optional(Type.String({ description: 'CSS selector of the element to click' })),\n  text: Type.Optional(\n    Type.String({ description: 'Visible text of the element to click (uses getByText)' }),\n  ),\n  role: Type.Optional(\n    Type.String({\n      description: 'ARIA role and accessible name, e.g. \"button:Submit\" (uses getByRole)',\n    }),\n  ),\n});\n\nexport const BrowserTypeSchema = Type.Object({\n  selector: Type.Optional(Type.String({ description: 'CSS selector of the input field' })),\n  label: Type.Optional(Type.String({ description: 'Label text of the input field (uses getByLabel)' })),\n  text: Type.String({ description: 'Text to type into the field' }),\n  pressEnter: Type.Optional(\n    Type.Boolean({ description: 'Press Enter after typing (default: false)' }),\n  ),\n});\n\nexport const BrowserScrollSchema = Type.Object({\n  direction: Type.Union([Type.Literal('down'), Type.Literal('up')], {\n    description: 'Scroll direction',\n  }),\n  amount: Type.Optional(\n    Type.Number({ description: 'Pixels to scroll (default: 500)', default: 500 }),\n  ),\n});\n\nexport const BrowserScreenshotSchema = Type.Object({\n  selector: Type.Optional(\n    Type.String({ description: 'CSS selector to screenshot a specific element. Omit for full page.' }),\n  ),\n  description: Type.Optional(\n    Type.String({ description: 'What to look for in the screenshot (passed to the vision model)' }),\n  ),\n});\n\nexport const BrowserBackSchema = Type.Object({\n  waitFor: Type.Optional(\n    Type.Union(\n      [Type.Literal('load'), Type.Literal('domcontentloaded'), Type.Literal('networkidle')],\n      { description: 'Wait condition after going back (default: domcontentloaded)' },\n    ),\n  ),\n});\n\nexport const BrowserPressSchema = Type.Object({\n  key: Type.String({\n    description:\n      'Key or key combination to press, e.g. \"Enter\", \"Tab\", \"Escape\", \"ArrowDown\", \"Control+A\", \"Shift+Enter\"',\n  }),\n});\n\nexport const BrowserConsoleSchema = Type.Object({\n  javascript: Type.Optional(\n    Type.String({\n      description:\n        'JavaScript expression to evaluate in the page context. The return value is serialized to JSON.',\n    }),\n  ),\n});\n\nexport const BrowserGetImagesSchema = Type.Object({\n  selector: Type.Optional(\n    Type.String({ description: 'CSS selector to limit image extraction scope. Omit for full page.' }),\n  ),\n  maxImages: Type.Optional(\n    Type.Number({ description: 'Max images to return (default: 20)', default: 20 }),\n  ),\n});\n\nexport const BrowserCloseSchema = Type.Object({});\n\nexport const BrowserVisionSchema = Type.Object({\n  prompt: Type.Optional(\n    Type.String({\n      description:\n        'What to analyze in the screenshot (default: describe the visible UI state). Requires `agents.defaults.imageModel` to be configured.',\n    }),\n  ),\n  selector: Type.Optional(\n    Type.String({ description: 'CSS selector to screenshot a specific element. Omit for full page.' }),\n  ),\n});\n\nexport const BrowserDialogSchema = Type.Object({\n  action: Type.Union([Type.Literal('accept'), Type.Literal('dismiss')], {\n    description: 'Whether to accept or dismiss the dialog',\n  }),\n  promptText: Type.Optional(\n    Type.String({ description: 'Text to enter into a prompt() dialog before accepting' }),\n  ),\n});\n\nexport const BrowserCdpSchema = Type.Object({\n  method: Type.String({\n    description: 'CDP method name, e.g. \"Runtime.evaluate\", \"Page.captureScreenshot\"',\n  }),\n  params: Type.Optional(\n    Type.Record(Type.String(), Type.Unknown(), {\n      description: 'CDP method parameters as a JSON object',\n    }),\n  ),\n});\n"],"mappings":";;AAEA,MAAa,wBAAwB,KAAK,OAAO;CAC/C,KAAK,KAAK,OAAO,EAAE,aAAa,sBAAsB,CAAC;CACvD,SAAS,KAAK,SACZ,KAAK,MACH;EAAC,KAAK,QAAQ,OAAO;EAAE,KAAK,QAAQ,mBAAmB;EAAE,KAAK,QAAQ,cAAc;EAAC,EACrF,EACE,aAAa,8CACd,CACF,CACF;CACF,CAAC;AAEF,MAAa,wBAAwB,KAAK,OAAO;CAC/C,UAAU,KAAK,SACb,KAAK,OAAO,EAAE,aAAa,oEAAoE,CAAC,CACjG;CACD,WAAW,KAAK,SACd,KAAK,OAAO;EAAE,aAAa;EAA+C,SAAS;EAAO,CAAC,CAC5F;CACF,CAAC;AAEF,MAAa,qBAAqB,KAAK,OAAO;CAC5C,UAAU,KAAK,SAAS,KAAK,OAAO,EAAE,aAAa,wCAAwC,CAAC,CAAC;CAC7F,MAAM,KAAK,SACT,KAAK,OAAO,EAAE,aAAa,yDAAyD,CAAC,CACtF;CACD,MAAM,KAAK,SACT,KAAK,OAAO,EACV,aAAa,0EACd,CAAC,CACH;CACF,CAAC;AAEF,MAAa,oBAAoB,KAAK,OAAO;CAC3C,UAAU,KAAK,SAAS,KAAK,OAAO,EAAE,aAAa,mCAAmC,CAAC,CAAC;CACxF,OAAO,KAAK,SAAS,KAAK,OAAO,EAAE,aAAa,mDAAmD,CAAC,CAAC;CACrG,MAAM,KAAK,OAAO,EAAE,aAAa,+BAA+B,CAAC;CACjE,YAAY,KAAK,SACf,KAAK,QAAQ,EAAE,aAAa,6CAA6C,CAAC,CAC3E;CACF,CAAC;AAEF,MAAa,sBAAsB,KAAK,OAAO;CAC7C,WAAW,KAAK,MAAM,CAAC,KAAK,QAAQ,OAAO,EAAE,KAAK,QAAQ,KAAK,CAAC,EAAE,EAChE,aAAa,oBACd,CAAC;CACF,QAAQ,KAAK,SACX,KAAK,OAAO;EAAE,aAAa;EAAmC,SAAS;EAAK,CAAC,CAC9E;CACF,CAAC;AAEF,MAAa,0BAA0B,KAAK,OAAO;CACjD,UAAU,KAAK,SACb,KAAK,OAAO,EAAE,aAAa,sEAAsE,CAAC,CACnG;CACD,aAAa,KAAK,SAChB,KAAK,OAAO,EAAE,aAAa,mEAAmE,CAAC,CAChG;CACF,CAAC;AAEF,MAAa,oBAAoB,KAAK,OAAO,EAC3C,SAAS,KAAK,SACZ,KAAK,MACH;CAAC,KAAK,QAAQ,OAAO;CAAE,KAAK,QAAQ,mBAAmB;CAAE,KAAK,QAAQ,cAAc;CAAC,EACrF,EAAE,aAAa,+DAA+D,CAC/E,CACF,EACF,CAAC;AAEF,MAAa,qBAAqB,KAAK,OAAO,EAC5C,KAAK,KAAK,OAAO,EACf,aACE,uHACH,CAAC,EACH,CAAC;AAEF,MAAa,uBAAuB,KAAK,OAAO,EAC9C,YAAY,KAAK,SACf,KAAK,OAAO,EACV,aACE,kGACH,CAAC,CACH,EACF,CAAC;AAEF,MAAa,yBAAyB,KAAK,OAAO;CAChD,UAAU,KAAK,SACb,KAAK,OAAO,EAAE,aAAa,qEAAqE,CAAC,CAClG;CACD,WAAW,KAAK,SACd,KAAK,OAAO;EAAE,aAAa;EAAsC,SAAS;EAAI,CAAC,CAChF;CACF,CAAC;AAEF,MAAa,qBAAqB,KAAK,OAAO,EAAE,CAAC;AAEjD,MAAa,sBAAsB,KAAK,OAAO;CAC7C,QAAQ,KAAK,SACX,KAAK,OAAO,EACV,aACE,uIACH,CAAC,CACH;CACD,UAAU,KAAK,SACb,KAAK,OAAO,EAAE,aAAa,sEAAsE,CAAC,CACnG;CACF,CAAC;AAEF,MAAa,sBAAsB,KAAK,OAAO;CAC7C,QAAQ,KAAK,MAAM,CAAC,KAAK,QAAQ,SAAS,EAAE,KAAK,QAAQ,UAAU,CAAC,EAAE,EACpE,aAAa,2CACd,CAAC;CACF,YAAY,KAAK,SACf,KAAK,OAAO,EAAE,aAAa,yDAAyD,CAAC,CACtF;CACF,CAAC;AAEF,MAAa,mBAAmB,KAAK,OAAO;CAC1C,QAAQ,KAAK,OAAO,EAClB,aAAa,0EACd,CAAC;CACF,QAAQ,KAAK,SACX,KAAK,OAAO,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,EACzC,aAAa,0CACd,CAAC,CACH;CACF,CAAC"}
+{"version":3,"file":"schemas.js","names":[],"sources":["../../../src/browser/schemas.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\n\nexport const BrowserNavigateSchema = Type.Object({\n  url: Type.String({ description: 'URL to navigate to' }),\n  waitFor: Type.Optional(\n    Type.Union(\n      [Type.Literal('load'), Type.Literal('domcontentloaded'), Type.Literal('networkidle')],\n      {\n        description: 'Wait condition (default: domcontentloaded)',\n      },\n    ),\n  ),\n});\n\nexport const BrowserSnapshotSchema = Type.Object({\n  selector: Type.Optional(\n    Type.String({ description: 'CSS selector to snapshot a specific element. Omit for full page.' }),\n  ),\n  maxLength: Type.Optional(\n    Type.Number({ description: 'Max characters in snapshot (default: 30000)', default: 30000 }),\n  ),\n});\n\nexport const BrowserClickSchema = Type.Object({\n  selector: Type.Optional(Type.String({ description: 'CSS selector of the element to click' })),\n  text: Type.Optional(\n    Type.String({ description: 'Visible text of the element to click (uses getByText)' }),\n  ),\n  role: Type.Optional(\n    Type.String({\n      description: 'ARIA role and accessible name, e.g. \"button:Submit\" (uses getByRole)',\n    }),\n  ),\n});\n\nexport const BrowserTypeSchema = Type.Object({\n  selector: Type.Optional(Type.String({ description: 'CSS selector of the input field' })),\n  label: Type.Optional(Type.String({ description: 'Label text of the input field (uses getByLabel)' })),\n  text: Type.String({ description: 'Text to type into the field' }),\n  pressEnter: Type.Optional(\n    Type.Boolean({ description: 'Press Enter after typing (default: false)' }),\n  ),\n});\n\nexport const BrowserScrollSchema = Type.Object({\n  direction: Type.Union([Type.Literal('down'), Type.Literal('up')], {\n    description: 'Scroll direction',\n  }),\n  amount: Type.Optional(\n    Type.Number({ description: 'Pixels to scroll (default: 500)', default: 500 }),\n  ),\n});\n\nexport const BrowserScreenshotSchema = Type.Object({\n  selector: Type.Optional(\n    Type.String({ description: 'CSS selector to screenshot a specific element. Omit for full page.' }),\n  ),\n  description: Type.Optional(\n    Type.String({ description: 'What to look for in the screenshot (passed to the vision model)' }),\n  ),\n});\n\nexport const BrowserBackSchema = Type.Object({\n  waitFor: Type.Optional(\n    Type.Union(\n      [Type.Literal('load'), Type.Literal('domcontentloaded'), Type.Literal('networkidle')],\n      { description: 'Wait condition after going back (default: domcontentloaded)' },\n    ),\n  ),\n});\n\nexport const BrowserPressSchema = Type.Object({\n  key: Type.String({\n    description:\n      'Key or key combination to press, e.g. \"Enter\", \"Tab\", \"Escape\", \"ArrowDown\", \"Control+A\", \"Shift+Enter\"',\n  }),\n});\n\nexport const BrowserConsoleSchema = Type.Object({\n  javascript: Type.Optional(\n    Type.String({\n      description:\n        'JavaScript expression to evaluate in the page context. The return value is serialized to JSON.',\n    }),\n  ),\n});\n\nexport const BrowserGetImagesSchema = Type.Object({\n  selector: Type.Optional(\n    Type.String({ description: 'CSS selector to limit image extraction scope. Omit for full page.' }),\n  ),\n  maxImages: Type.Optional(\n    Type.Number({ description: 'Max images to return (default: 20)', default: 20 }),\n  ),\n});\n\nexport const BrowserCloseSchema = Type.Object({});\n\nexport const BrowserVisionSchema = Type.Object({\n  prompt: Type.Optional(\n    Type.String({\n      description:\n        'What to analyze in the screenshot (default: describe the visible UI state). Requires an available image model.',\n    }),\n  ),\n  selector: Type.Optional(\n    Type.String({ description: 'CSS selector to screenshot a specific element. Omit for full page.' }),\n  ),\n});\n\nexport const BrowserDialogSchema = Type.Object({\n  action: Type.Union([Type.Literal('accept'), Type.Literal('dismiss')], {\n    description: 'Whether to accept or dismiss the dialog',\n  }),\n  promptText: Type.Optional(\n    Type.String({ description: 'Text to enter into a prompt() dialog before accepting' }),\n  ),\n});\n\nexport const BrowserCdpSchema = Type.Object({\n  method: Type.String({\n    description: 'CDP method name, e.g. \"Runtime.evaluate\", \"Page.captureScreenshot\"',\n  }),\n  params: Type.Optional(\n    Type.Record(Type.String(), Type.Unknown(), {\n      description: 'CDP method parameters as a JSON object',\n    }),\n  ),\n});\n"],"mappings":"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"}

package/dist/src/chat-commands/builtins/config.js

@@ -74,9 +74,9 @@ const configCommand = {
 	acceptsArgs: true,
 	examples: [
 		"/config show",
-		"/config show agents.defaults.models.chat",
-		"/config set agents.defaults.models.chat.primary=anthropic/claude-opus-4-5",
-		"/config set agents.defaults.temperature=0.5",
+		"/config show agents.list",
+		"/config set agents.default=main",
+		"/config show agents.capabilityPresets",
 		"/config unset tts"
 	],
 	handler: async (ctx, args) => {
@@ -176,7 +176,7 @@ const configCommand = {
 			log.info({ path: rest }, "Config key removed via /config unset");
 			return { content: `⚙️ Config updated: \`${rest}\` removed.` };
 		}
-		return { content: "⚙️ *Config Command*\n\n`/config show [path]` — view config (or a specific path)\n`/config set path=value` — update a config value\n`/config unset path` — remove a config key\n\nExamples:\n`/config show agents.defaults.models.chat`\n`/config set agents.defaults.temperature=0.5`\n`/config set agents.defaults.thinkingDefault=medium`\n`/config unset tts`" };
+		return { content: "⚙️ *Config Command*\n\n`/config show [path]` — view config (or a specific path)\n`/config set path=value` — update a config value\n`/config unset path` — remove a config key\n\nExamples:\n`/config show agents.list`\n`/config set agents.default=main`\n`/config show agents.capabilityPresets`\n`/config unset tts`" };
 	}
 };
 function registerConfigCommand() {

package/dist/src/chat-commands/builtins/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":[],"sources":["../../../../src/chat-commands/builtins/config.ts"],"sourcesContent":["/**\n * /config — read and write persistent config (~/.xopc/xopc.json) from chat.\n */\n\nimport type { CommandDefinition, CommandContext } from '../types.js';\nimport { commandRegistry } from '../registry.js';\nimport { parseConfigValue } from '../config-value.js';\nimport {\n  parseConfigPath,\n  getConfigValueAtPath,\n  setConfigValueAtPath,\n  unsetConfigValueAtPath,\n} from '../config-paths.js';\nimport { ConfigSchema, type TelegramConfig, type WeixinConfig } from '../../config/schema.js';\nimport { loadConfig, saveConfig } from '../../config/loader.js';\nimport { resolveConfigPath } from '../../config/paths.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { resolveAllowlistMatchSimple } from '../../channels/security.js';\n\nconst log = createLogger('ConfigCommand');\n\nconst BLOCKED_WRITE_PATHS = new Set(['gateway.auth.token', 'providers']);\n\nfunction isBlockedPath(path: string[]): boolean {\n  const joined = path.join('.');\n  for (const blocked of BLOCKED_WRITE_PATHS) {\n    if (joined === blocked || joined.startsWith(`${blocked}.`)) return true;\n  }\n  return false;\n}\n\nfunction redactConfigForDisplay(plain: Record<string, unknown>): void {\n  if (plain.gateway && typeof plain.gateway === 'object') {\n    const gw = plain.gateway as Record<string, unknown>;\n    if (gw.auth && typeof gw.auth === 'object') {\n      (gw.auth as Record<string, unknown>).token = '[redacted]';\n    }\n  }\n  if (plain.providers !== undefined) plain.providers = '[redacted]';\n}\n\nfunction senderMayWritePersistentConfig(ctx: CommandContext): boolean {\n  const { source, senderId, isGroup } = ctx;\n  if (source !== 'telegram' && source !== 'weixin') {\n    return true;\n  }\n\n  const cfg = ctx.getConfig?.() ?? ctx.config;\n\n  if (source === 'weixin') {\n    const wx = cfg.channels?.weixin as WeixinConfig | undefined;\n    if (!wx?.enabled) return false;\n    const accountId = ctx.accountId ?? 'default';\n    let allowFrom: Array<string | number> = [];\n    if (wx.accounts && Object.keys(wx.accounts).length > 0) {\n      const acc = wx.accounts[accountId] ?? wx.accounts['default'];\n      if (!acc || acc.enabled === false) return false;\n      allowFrom = [...(acc.allowFrom ?? [])];\n    } else {\n      allowFrom = [...(wx.allowFrom ?? [])];\n    }\n    if (allowFrom.length === 0) return false;\n    return resolveAllowlistMatchSimple({ allowFrom, senderId }).allowed;\n  }\n\n  const tg = cfg.channels?.telegram as TelegramConfig | undefined;\n  if (!tg?.enabled) return false;\n  const accountId = ctx.accountId ?? 'default';\n  const acc = tg.accounts?.[accountId] ?? tg.accounts?.['default'];\n  if (!acc || acc.enabled === false) return false;\n  const allowFrom = [...(acc.allowFrom ?? [])];\n  const groupAllowFrom = [...(acc.groupAllowFrom ?? [])];\n  const list = isGroup && groupAllowFrom.length > 0 ? groupAllowFrom : allowFrom;\n  if (list.length === 0) return false;\n  return resolveAllowlistMatchSimple({ allowFrom: list, senderId }).allowed;\n}\n\nconst configCommand: CommandDefinition = {\n  id: 'system.config',\n  name: 'config',\n  aliases: ['cfg'],\n  description:\n    'Show or update configuration. Usage: /config show [path] | /config set path=value | /config unset path',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: [\n    '/config show',\n    '/config show agents.defaults.models.chat',\n    '/config set agents.defaults.models.chat.primary=anthropic/claude-opus-4-5',\n    '/config set agents.defaults.temperature=0.5',\n    '/config unset tts',\n  ],\n  handler: async (ctx: CommandContext, args: string) => {\n    const parts = args.trim().split(/\\s+/);\n    const action = parts[0]?.toLowerCase();\n    const rest = parts.slice(1).join(' ').trim();\n\n    if (!action || action === 'show' || action === 'get') {\n      const config = ctx.getConfig?.() ?? loadConfig(resolveConfigPath());\n      const plain = JSON.parse(JSON.stringify(config)) as Record<string, unknown>;\n      redactConfigForDisplay(plain);\n\n      if (rest) {\n        const parsed = parseConfigPath(rest);\n        if (!parsed.ok || !parsed.path) {\n          return { content: `⚠️ ${parsed.error ?? 'Invalid path.'}`, success: false };\n        }\n        const value = getConfigValueAtPath(plain, parsed.path);\n        const rendered = JSON.stringify(value ?? null, null, 2);\n        return { content: `⚙️ \\`${rest}\\`:\\n\\`\\`\\`json\\n${rendered}\\n\\`\\`\\`` };\n      }\n\n      const json = JSON.stringify(plain, null, 2);\n      return { content: `⚙️ Current config:\\n\\`\\`\\`json\\n${json}\\n\\`\\`\\`` };\n    }\n\n    if (action === 'set') {\n      if (!senderMayWritePersistentConfig(ctx)) {\n        return {\n          content: '⚠️ You are not allowed to change config from this chat surface.',\n          success: false,\n        };\n      }\n      const eqIndex = rest.indexOf('=');\n      if (eqIndex <= 0) {\n        return { content: '⚠️ Usage: /config set path=value', success: false };\n      }\n      const pathRaw = rest.slice(0, eqIndex).trim();\n      const valueRaw = rest.slice(eqIndex + 1);\n\n      const parsedPath = parseConfigPath(pathRaw);\n      if (!parsedPath.ok || !parsedPath.path) {\n        return { content: `⚠️ ${parsedPath.error}`, success: false };\n      }\n      if (isBlockedPath(parsedPath.path)) {\n        return {\n          content: `⚠️ Path \\`${pathRaw}\\` cannot be modified via chat for security reasons.`,\n          success: false,\n        };\n      }\n\n      const parsedValue = parseConfigValue(valueRaw);\n      if (parsedValue.ok === false) {\n        return { content: `⚠️ ${parsedValue.error}`, success: false };\n      }\n\n      const configPath = resolveConfigPath();\n      const currentConfig = loadConfig(configPath) as Record<string, unknown>;\n      setConfigValueAtPath(currentConfig, parsedPath.path, parsedValue.value);\n\n      const validated = ConfigSchema.safeParse(currentConfig);\n      if (!validated.success) {\n        const firstIssue = validated.error.issues[0];\n        const fieldPath = firstIssue.path.join('.');\n        return {\n          content: `⚠️ Config invalid after set (${fieldPath}: ${firstIssue.message}). Change not saved.`,\n          success: false,\n        };\n      }\n\n      await saveConfig(validated.data);\n      log.info({ path: pathRaw, value: parsedValue.value }, 'Config updated via /config set');\n\n      const valueLabel =\n        typeof parsedValue.value === 'string'\n          ? `\"${parsedValue.value}\"`\n          : JSON.stringify(parsedValue.value);\n      return { content: `⚙️ Config updated: \\`${pathRaw}\\` = ${valueLabel}` };\n    }\n\n    if (action === 'unset') {\n      if (!senderMayWritePersistentConfig(ctx)) {\n        return {\n          content: '⚠️ You are not allowed to change config from this chat surface.',\n          success: false,\n        };\n      }\n      if (!rest) {\n        return { content: '⚠️ Usage: /config unset path', success: false };\n      }\n      const parsedPath = parseConfigPath(rest);\n      if (!parsedPath.ok || !parsedPath.path) {\n        return { content: `⚠️ ${parsedPath.error}`, success: false };\n      }\n      if (isBlockedPath(parsedPath.path)) {\n        return {\n          content: `⚠️ Path \\`${rest}\\` cannot be modified via chat for security reasons.`,\n          success: false,\n        };\n      }\n\n      const configPath = resolveConfigPath();\n      const currentConfig = loadConfig(configPath) as Record<string, unknown>;\n      const removed = unsetConfigValueAtPath(currentConfig, parsedPath.path);\n      if (!removed) {\n        return { content: `⚙️ No config value found at \\`${rest}\\`.`, success: false };\n      }\n\n      const validated = ConfigSchema.safeParse(currentConfig);\n      if (!validated.success) {\n        const firstIssue = validated.error.issues[0];\n        const fieldPath = firstIssue.path.join('.');\n        return {\n          content: `⚠️ Config invalid after unset (${fieldPath}: ${firstIssue.message}). Change not saved.`,\n          success: false,\n        };\n      }\n\n      await saveConfig(validated.data);\n      log.info({ path: rest }, 'Config key removed via /config unset');\n      return { content: `⚙️ Config updated: \\`${rest}\\` removed.` };\n    }\n\n    return {\n      content:\n        '⚙️ *Config Command*\\n\\n' +\n        '`/config show [path]` — view config (or a specific path)\\n' +\n        '`/config set path=value` — update a config value\\n' +\n        '`/config unset path` — remove a config key\\n\\n' +\n        'Examples:\\n' +\n        '`/config show agents.defaults.models.chat`\\n' +\n        '`/config set agents.defaults.temperature=0.5`\\n' +\n        '`/config set agents.defaults.thinkingDefault=medium`\\n' +\n        '`/config unset tts`',\n    };\n  },\n};\n\nexport function registerConfigCommand(): void {\n  commandRegistry.register(configCommand);\n}\n"],"mappings":"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"}
+{"version":3,"file":"config.js","names":[],"sources":["../../../../src/chat-commands/builtins/config.ts"],"sourcesContent":["/**\n * /config — read and write persistent config (~/.xopc/xopc.json) from chat.\n */\n\nimport type { CommandDefinition, CommandContext } from '../types.js';\nimport { commandRegistry } from '../registry.js';\nimport { parseConfigValue } from '../config-value.js';\nimport {\n  parseConfigPath,\n  getConfigValueAtPath,\n  setConfigValueAtPath,\n  unsetConfigValueAtPath,\n} from '../config-paths.js';\nimport { ConfigSchema, type TelegramConfig, type WeixinConfig } from '../../config/schema.js';\nimport { loadConfig, saveConfig } from '../../config/loader.js';\nimport { resolveConfigPath } from '../../config/paths.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { resolveAllowlistMatchSimple } from '../../channels/security.js';\n\nconst log = createLogger('ConfigCommand');\n\nconst BLOCKED_WRITE_PATHS = new Set(['gateway.auth.token', 'providers']);\n\nfunction isBlockedPath(path: string[]): boolean {\n  const joined = path.join('.');\n  for (const blocked of BLOCKED_WRITE_PATHS) {\n    if (joined === blocked || joined.startsWith(`${blocked}.`)) return true;\n  }\n  return false;\n}\n\nfunction redactConfigForDisplay(plain: Record<string, unknown>): void {\n  if (plain.gateway && typeof plain.gateway === 'object') {\n    const gw = plain.gateway as Record<string, unknown>;\n    if (gw.auth && typeof gw.auth === 'object') {\n      (gw.auth as Record<string, unknown>).token = '[redacted]';\n    }\n  }\n  if (plain.providers !== undefined) plain.providers = '[redacted]';\n}\n\nfunction senderMayWritePersistentConfig(ctx: CommandContext): boolean {\n  const { source, senderId, isGroup } = ctx;\n  if (source !== 'telegram' && source !== 'weixin') {\n    return true;\n  }\n\n  const cfg = ctx.getConfig?.() ?? ctx.config;\n\n  if (source === 'weixin') {\n    const wx = cfg.channels?.weixin as WeixinConfig | undefined;\n    if (!wx?.enabled) return false;\n    const accountId = ctx.accountId ?? 'default';\n    let allowFrom: Array<string | number> = [];\n    if (wx.accounts && Object.keys(wx.accounts).length > 0) {\n      const acc = wx.accounts[accountId] ?? wx.accounts['default'];\n      if (!acc || acc.enabled === false) return false;\n      allowFrom = [...(acc.allowFrom ?? [])];\n    } else {\n      allowFrom = [...(wx.allowFrom ?? [])];\n    }\n    if (allowFrom.length === 0) return false;\n    return resolveAllowlistMatchSimple({ allowFrom, senderId }).allowed;\n  }\n\n  const tg = cfg.channels?.telegram as TelegramConfig | undefined;\n  if (!tg?.enabled) return false;\n  const accountId = ctx.accountId ?? 'default';\n  const acc = tg.accounts?.[accountId] ?? tg.accounts?.['default'];\n  if (!acc || acc.enabled === false) return false;\n  const allowFrom = [...(acc.allowFrom ?? [])];\n  const groupAllowFrom = [...(acc.groupAllowFrom ?? [])];\n  const list = isGroup && groupAllowFrom.length > 0 ? groupAllowFrom : allowFrom;\n  if (list.length === 0) return false;\n  return resolveAllowlistMatchSimple({ allowFrom: list, senderId }).allowed;\n}\n\nconst configCommand: CommandDefinition = {\n  id: 'system.config',\n  name: 'config',\n  aliases: ['cfg'],\n  description:\n    'Show or update configuration. Usage: /config show [path] | /config set path=value | /config unset path',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: [\n    '/config show',\n    '/config show agents.list',\n    '/config set agents.default=main',\n    '/config show agents.capabilityPresets',\n    '/config unset tts',\n  ],\n  handler: async (ctx: CommandContext, args: string) => {\n    const parts = args.trim().split(/\\s+/);\n    const action = parts[0]?.toLowerCase();\n    const rest = parts.slice(1).join(' ').trim();\n\n    if (!action || action === 'show' || action === 'get') {\n      const config = ctx.getConfig?.() ?? loadConfig(resolveConfigPath());\n      const plain = JSON.parse(JSON.stringify(config)) as Record<string, unknown>;\n      redactConfigForDisplay(plain);\n\n      if (rest) {\n        const parsed = parseConfigPath(rest);\n        if (!parsed.ok || !parsed.path) {\n          return { content: `⚠️ ${parsed.error ?? 'Invalid path.'}`, success: false };\n        }\n        const value = getConfigValueAtPath(plain, parsed.path);\n        const rendered = JSON.stringify(value ?? null, null, 2);\n        return { content: `⚙️ \\`${rest}\\`:\\n\\`\\`\\`json\\n${rendered}\\n\\`\\`\\`` };\n      }\n\n      const json = JSON.stringify(plain, null, 2);\n      return { content: `⚙️ Current config:\\n\\`\\`\\`json\\n${json}\\n\\`\\`\\`` };\n    }\n\n    if (action === 'set') {\n      if (!senderMayWritePersistentConfig(ctx)) {\n        return {\n          content: '⚠️ You are not allowed to change config from this chat surface.',\n          success: false,\n        };\n      }\n      const eqIndex = rest.indexOf('=');\n      if (eqIndex <= 0) {\n        return { content: '⚠️ Usage: /config set path=value', success: false };\n      }\n      const pathRaw = rest.slice(0, eqIndex).trim();\n      const valueRaw = rest.slice(eqIndex + 1);\n\n      const parsedPath = parseConfigPath(pathRaw);\n      if (!parsedPath.ok || !parsedPath.path) {\n        return { content: `⚠️ ${parsedPath.error}`, success: false };\n      }\n      if (isBlockedPath(parsedPath.path)) {\n        return {\n          content: `⚠️ Path \\`${pathRaw}\\` cannot be modified via chat for security reasons.`,\n          success: false,\n        };\n      }\n\n      const parsedValue = parseConfigValue(valueRaw);\n      if (parsedValue.ok === false) {\n        return { content: `⚠️ ${parsedValue.error}`, success: false };\n      }\n\n      const configPath = resolveConfigPath();\n      const currentConfig = loadConfig(configPath) as Record<string, unknown>;\n      setConfigValueAtPath(currentConfig, parsedPath.path, parsedValue.value);\n\n      const validated = ConfigSchema.safeParse(currentConfig);\n      if (!validated.success) {\n        const firstIssue = validated.error.issues[0];\n        const fieldPath = firstIssue.path.join('.');\n        return {\n          content: `⚠️ Config invalid after set (${fieldPath}: ${firstIssue.message}). Change not saved.`,\n          success: false,\n        };\n      }\n\n      await saveConfig(validated.data);\n      log.info({ path: pathRaw, value: parsedValue.value }, 'Config updated via /config set');\n\n      const valueLabel =\n        typeof parsedValue.value === 'string'\n          ? `\"${parsedValue.value}\"`\n          : JSON.stringify(parsedValue.value);\n      return { content: `⚙️ Config updated: \\`${pathRaw}\\` = ${valueLabel}` };\n    }\n\n    if (action === 'unset') {\n      if (!senderMayWritePersistentConfig(ctx)) {\n        return {\n          content: '⚠️ You are not allowed to change config from this chat surface.',\n          success: false,\n        };\n      }\n      if (!rest) {\n        return { content: '⚠️ Usage: /config unset path', success: false };\n      }\n      const parsedPath = parseConfigPath(rest);\n      if (!parsedPath.ok || !parsedPath.path) {\n        return { content: `⚠️ ${parsedPath.error}`, success: false };\n      }\n      if (isBlockedPath(parsedPath.path)) {\n        return {\n          content: `⚠️ Path \\`${rest}\\` cannot be modified via chat for security reasons.`,\n          success: false,\n        };\n      }\n\n      const configPath = resolveConfigPath();\n      const currentConfig = loadConfig(configPath) as Record<string, unknown>;\n      const removed = unsetConfigValueAtPath(currentConfig, parsedPath.path);\n      if (!removed) {\n        return { content: `⚙️ No config value found at \\`${rest}\\`.`, success: false };\n      }\n\n      const validated = ConfigSchema.safeParse(currentConfig);\n      if (!validated.success) {\n        const firstIssue = validated.error.issues[0];\n        const fieldPath = firstIssue.path.join('.');\n        return {\n          content: `⚠️ Config invalid after unset (${fieldPath}: ${firstIssue.message}). Change not saved.`,\n          success: false,\n        };\n      }\n\n      await saveConfig(validated.data);\n      log.info({ path: rest }, 'Config key removed via /config unset');\n      return { content: `⚙️ Config updated: \\`${rest}\\` removed.` };\n    }\n\n    return {\n      content:\n        '⚙️ *Config Command*\\n\\n' +\n        '`/config show [path]` — view config (or a specific path)\\n' +\n        '`/config set path=value` — update a config value\\n' +\n        '`/config unset path` — remove a config key\\n\\n' +\n        'Examples:\\n' +\n        '`/config show agents.list`\\n' +\n        '`/config set agents.default=main`\\n' +\n        '`/config show agents.capabilityPresets`\\n' +\n        '`/config unset tts`',\n    };\n  },\n};\n\nexport function registerConfigCommand(): void {\n  commandRegistry.register(configCommand);\n}\n"],"mappings":"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"}

package/dist/src/chat-commands/builtins/thinking.js

@@ -1,18 +1,13 @@
-import { applyConfigOverrides, setConfigOverride } from "../../config/runtime-overrides.js";
 import { formatThinkingLevels, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel } from "../../agent/transcript/thinking-types.js";
 import { commandRegistry } from "../registry.js";
 //#region src/chat-commands/builtins/thinking.ts
-function effectiveAgentDefaults(ctx) {
-	return applyConfigOverrides(ctx.getConfig?.() ?? ctx.config).agents?.defaults;
-}
-async function stripSessionAgentFields(store, sessionKey, fields) {
+async function setSessionAgentField(store, sessionKey, field, value) {
 	if (!store) return;
-	const existing = await store.get(sessionKey);
-	if (!existing) return;
-	const next = { ...existing };
-	for (const f of fields) delete next[f];
-	if (Object.keys(next).filter((k) => k !== "updatedAt").length === 0) await store.delete(sessionKey);
-	else await store.set(sessionKey, next);
+	const existing = await store.get(sessionKey) ?? {};
+	await store.set(sessionKey, {
+		...existing,
+		[field]: value
+	});
 }
 const thinkCommand = {
 	id: "agent.think",
@@ -34,7 +29,7 @@ const thinkCommand = {
 	handler: async (ctx, args) => {
 		await ctx.setTyping(true);
 		if (!args.trim()) return {
-			content: `🧠 *Thinking Level*\n\nCurrent: *${(await ctx.getThinkingLevel?.() ?? effectiveAgentDefaults(ctx)?.thinkingDefault) || "default"}*\n\nAvailable levels:\n• off - No thinking\n• minimal - Minimal thinking\n• low - Low thinking\n• medium - Medium thinking (default)\n• high - High thinking\n• xhigh - Extra high (certain models)\n• adaptive - Auto-adjust based on task\n\nUsage: /think <level>\nExample: /think high`,
+			content: `🧠 *Thinking Level*\n\nCurrent: *${await ctx.getThinkingLevel?.() || "default"}*\n\nAvailable levels:\n• off - No thinking\n• minimal - Minimal thinking\n• low - Low thinking\n• medium - Medium thinking (default)\n• high - High thinking\n• xhigh - Extra high (certain models)\n• adaptive - Auto-adjust based on task\n\nUsage: /think <level>\nExample: /think high`,
 			success: true
 		};
 		const level = normalizeThinkLevel(args.trim());
@@ -42,12 +37,7 @@ const thinkCommand = {
 			content: `❌ Invalid thinking level: ${args}\n\nAvailable levels: ${formatThinkingLevels()}\n\nUsage: /think <level>\nExample: /think high`,
 			success: false
 		};
-		setConfigOverride([
-			"agents",
-			"defaults",
-			"thinkingDefault"
-		], level);
-		await stripSessionAgentFields(ctx.getSessionConfigStore?.(), ctx.sessionKey, ["thinkingLevel"]);
+		await setSessionAgentField(ctx.getSessionConfigStore?.(), ctx.sessionKey, "thinkingLevel", level);
 		ctx.syncAgentThinkingLevel?.(level);
 		return {
 			content: `🧠 *Thinking Level Set*\n\nLevel: *${level}*\n${{
@@ -83,7 +73,7 @@ const reasoningCommand = {
 	handler: async (ctx, args) => {
 		await ctx.setTyping(true);
 		if (!args.trim()) return {
-			content: `💭 *Reasoning Visibility*\n\nCurrent: *${(await ctx.getReasoningLevel?.() ?? effectiveAgentDefaults(ctx)?.reasoningDefault) || "default"}*\n\nAvailable modes:\n• off - Hide reasoning\n• on - Show reasoning after completion\n• stream - Stream reasoning in real-time\n\nUsage: /reasoning <mode>\nExample: /reasoning stream`,
+			content: `💭 *Reasoning Visibility*\n\nCurrent: *${await ctx.getReasoningLevel?.() || "default"}*\n\nAvailable modes:\n• off - Hide reasoning\n• on - Show reasoning after completion\n• stream - Stream reasoning in real-time\n\nUsage: /reasoning <mode>\nExample: /reasoning stream`,
 			success: true
 		};
 		const level = normalizeReasoningLevel(args.trim());
@@ -91,12 +81,7 @@ const reasoningCommand = {
 			content: `❌ Invalid reasoning mode: ${args}\n\nAvailable modes: off, on, stream\n\nUsage: /reasoning <mode>\nExample: /reasoning stream`,
 			success: false
 		};
-		setConfigOverride([
-			"agents",
-			"defaults",
-			"reasoningDefault"
-		], level);
-		await stripSessionAgentFields(ctx.getSessionConfigStore?.(), ctx.sessionKey, ["reasoningLevel"]);
+		await setSessionAgentField(ctx.getSessionConfigStore?.(), ctx.sessionKey, "reasoningLevel", level);
 		return {
 			content: `💭 *Reasoning Visibility Set*\n\nMode: *${level}*\n${{
 				off: "Hide reasoning from user",
@@ -127,13 +112,8 @@ const verboseCommand = {
 	handler: async (ctx, args) => {
 		await ctx.setTyping(true);
 		if (!args.trim()) {
-			const newLevel = (await ctx.getVerboseLevel?.() ?? effectiveAgentDefaults(ctx)?.verboseDefault) === "on" ? "off" : "on";
-			setConfigOverride([
-				"agents",
-				"defaults",
-				"verboseDefault"
-			], newLevel);
-			await stripSessionAgentFields(ctx.getSessionConfigStore?.(), ctx.sessionKey, ["verboseLevel"]);
+			const newLevel = await ctx.getVerboseLevel?.() === "on" ? "off" : "on";
+			await setSessionAgentField(ctx.getSessionConfigStore?.(), ctx.sessionKey, "verboseLevel", newLevel);
 			return {
 				content: `📝 *Verbose Mode*\n\nMode: *${newLevel}*\n\n${newLevel === "on" ? "Verbose output enabled (process lifetime)." : "Verbose output disabled (process lifetime)."}`,
 				success: true
@@ -144,12 +124,7 @@ const verboseCommand = {
 			content: `❌ Invalid verbose mode: ${args}\n\nAvailable modes: off, on, full\n\nUsage: /verbose [mode]\nExample: /verbose on`,
 			success: false
 		};
-		setConfigOverride([
-			"agents",
-			"defaults",
-			"verboseDefault"
-		], level);
-		await stripSessionAgentFields(ctx.getSessionConfigStore?.(), ctx.sessionKey, ["verboseLevel"]);
+		await setSessionAgentField(ctx.getSessionConfigStore?.(), ctx.sessionKey, "verboseLevel", level);
 		return {
 			content: `📝 *Verbose Mode Set*\n\nMode: *${level}*\n${{
 				off: "Minimal output",
@@ -172,11 +147,10 @@ const enhancedStatusCommand = {
 	],
 	handler: async (ctx) => {
 		await ctx.setTyping(true);
-		const defaults = effectiveAgentDefaults(ctx);
 		const currentModel = ctx.getCurrentModel();
-		const thinkingLevel = await ctx.getThinkingLevel?.() ?? defaults?.thinkingDefault;
-		const reasoningLevel = await ctx.getReasoningLevel?.() ?? defaults?.reasoningDefault;
-		const verboseLevel = await ctx.getVerboseLevel?.() ?? defaults?.verboseDefault;
+		const thinkingLevel = await ctx.getThinkingLevel?.();
+		const reasoningLevel = await ctx.getReasoningLevel?.();
+		const verboseLevel = await ctx.getVerboseLevel?.();
 		const usage = await ctx.getUsage();
 		return {
 			content: [

package/dist/src/chat-commands/builtins/thinking.js.map

@@ -1 +1 @@
-{"version":3,"file":"thinking.js","names":[],"sources":["../../../../src/chat-commands/builtins/thinking.ts"],"sourcesContent":["/**\n * Thinking Commands\n * \n * Built-in commands for thinking ability management:\n * - /think - Set thinking level\n * - /reasoning - Set reasoning visibility\n * - /verbose - Set verbose mode\n * - /status - Show current status (including thinking/reasoning/verbose)\n */\n\nimport type { CommandDefinition, CommandContext } from '../types.js';\nimport { commandRegistry } from '../registry.js';\nimport {\n  normalizeThinkLevel,\n  normalizeReasoningLevel,\n  normalizeVerboseLevel,\n  formatThinkingLevels,\n  type ThinkLevel,\n  type ReasoningLevel,\n  type VerboseLevel,\n} from '../../agent/transcript/thinking-types.js';\nimport { applyConfigOverrides, setConfigOverride } from '../../config/runtime-overrides.js';\nimport type { Config } from '../../config/schema.js';\nimport type { SessionConfigStore } from '../../session/index.js';\n\nfunction effectiveAgentDefaults(ctx: CommandContext) {\n  const base = (ctx.getConfig?.() ?? ctx.config) as Config;\n  return applyConfigOverrides(base).agents?.defaults;\n}\n\nasync function stripSessionAgentFields(\n  store: SessionConfigStore | undefined,\n  sessionKey: string,\n  fields: Array<'thinkingLevel' | 'reasoningLevel' | 'verboseLevel'>,\n): Promise<void> {\n  if (!store) return;\n  const existing = await store.get(sessionKey);\n  if (!existing) return;\n  const next = { ...existing };\n  for (const f of fields) {\n    delete next[f];\n  }\n  const restKeys = Object.keys(next).filter((k) => k !== 'updatedAt');\n  if (restKeys.length === 0) {\n    await store.delete(sessionKey);\n  } else {\n    await store.set(sessionKey, next);\n  }\n}\n\n// Think command\nconst thinkCommand: CommandDefinition = {\n  id: 'agent.think',\n  name: 'think',\n  description: 'Set thinking level (usage: /think <level>)',\n  category: 'model',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/think', '/think high', '/think off', '/think adaptive'],\n  handler: async (ctx: CommandContext, args: string) => {\n    await ctx.setTyping(true);\n\n    if (!args.trim()) {\n      // Show current thinking level\n      const currentLevel =\n        (await ctx.getThinkingLevel?.()) ?? effectiveAgentDefaults(ctx)?.thinkingDefault;\n      \n      return {\n        content: `🧠 *Thinking Level*\\n\\n` +\n          `Current: *${currentLevel || 'default'}*\\n\\n` +\n          `Available levels:\\n` +\n          `• off - No thinking\\n` +\n          `• minimal - Minimal thinking\\n` +\n          `• low - Low thinking\\n` +\n          `• medium - Medium thinking (default)\\n` +\n          `• high - High thinking\\n` +\n          `• xhigh - Extra high (certain models)\\n` +\n          `• adaptive - Auto-adjust based on task\\n\\n` +\n          `Usage: /think <level>\\n` +\n          `Example: /think high`,\n        success: true,\n      };\n    }\n    \n    // Parse and validate the level\n    const level = normalizeThinkLevel(args.trim());\n    if (!level) {\n      const levels = formatThinkingLevels();\n      return {\n        content: `❌ Invalid thinking level: ${args}\\n\\n` +\n          `Available levels: ${levels}\\n\\n` +\n          `Usage: /think <level>\\n` +\n          `Example: /think high`,\n        success: false,\n      };\n    }\n    \n    setConfigOverride(['agents', 'defaults', 'thinkingDefault'], level);\n    await stripSessionAgentFields(ctx.getSessionConfigStore?.(), ctx.sessionKey, ['thinkingLevel']);\n    ctx.syncAgentThinkingLevel?.(level);\n\n    const levelDescriptions: Record<ThinkLevel, string> = {\n      off: 'No thinking',\n      minimal: 'Minimal thinking effort',\n      low: 'Low thinking effort',\n      medium: 'Medium thinking effort',\n      high: 'High thinking effort',\n      xhigh: 'Extra high thinking effort',\n      adaptive: 'Auto-adjust based on task complexity',\n    };\n    \n    return {\n      content: `🧠 *Thinking Level Set*\\n\\n` +\n        `Level: *${level}*\\n` +\n        `${levelDescriptions[level]}\\n\\n` +\n        `Applies for this gateway process (until restart). Persists only if you use /config set.`,\n      success: true,\n    };\n  },\n};\n\n// Reasoning command\nconst reasoningCommand: CommandDefinition = {\n  id: 'agent.reasoning',\n  name: 'reasoning',\n  description: 'Set reasoning visibility (usage: /reasoning <mode>)',\n  category: 'model',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/reasoning', '/reasoning on', '/reasoning stream', '/reasoning off'],\n  handler: async (ctx: CommandContext, args: string) => {\n    await ctx.setTyping(true);\n\n    if (!args.trim()) {\n      // Show current reasoning level\n      const currentLevel =\n        (await ctx.getReasoningLevel?.()) ?? effectiveAgentDefaults(ctx)?.reasoningDefault;\n      \n      return {\n        content: `💭 *Reasoning Visibility*\\n\\n` +\n          `Current: *${currentLevel || 'default'}*\\n\\n` +\n          `Available modes:\\n` +\n          `• off - Hide reasoning\\n` +\n          `• on - Show reasoning after completion\\n` +\n          `• stream - Stream reasoning in real-time\\n\\n` +\n          `Usage: /reasoning <mode>\\n` +\n          `Example: /reasoning stream`,\n        success: true,\n      };\n    }\n    \n    // Parse and validate the level\n    const level = normalizeReasoningLevel(args.trim());\n    if (!level) {\n      return {\n        content: `❌ Invalid reasoning mode: ${args}\\n\\n` +\n          `Available modes: off, on, stream\\n\\n` +\n          `Usage: /reasoning <mode>\\n` +\n          `Example: /reasoning stream`,\n        success: false,\n      };\n    }\n    \n    setConfigOverride(['agents', 'defaults', 'reasoningDefault'], level);\n    await stripSessionAgentFields(ctx.getSessionConfigStore?.(), ctx.sessionKey, ['reasoningLevel']);\n\n    const modeDescriptions: Record<ReasoningLevel, string> = {\n      off: 'Hide reasoning from user',\n      on: 'Show reasoning after completion',\n      stream: 'Stream reasoning in real-time',\n    };\n    \n    return {\n      content: `💭 *Reasoning Visibility Set*\\n\\n` +\n        `Mode: *${level}*\\n` +\n        `${modeDescriptions[level]}\\n\\n` +\n        `Applies for this gateway process (until restart). Persists only if you use /config set.`,\n      success: true,\n    };\n  },\n};\n\n// Verbose command\nconst verboseCommand: CommandDefinition = {\n  id: 'agent.verbose',\n  name: 'verbose',\n  description: 'Toggle verbose mode (usage: /verbose [on|off|full])',\n  category: 'model',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/verbose', '/verbose on', '/verbose off', '/verbose full'],\n  handler: async (ctx: CommandContext, args: string) => {\n    await ctx.setTyping(true);\n\n    if (!args.trim()) {\n      // Toggle verbose mode\n      const currentLevel =\n        (await ctx.getVerboseLevel?.()) ?? effectiveAgentDefaults(ctx)?.verboseDefault;\n      const newLevel: VerboseLevel = currentLevel === 'on' ? 'off' : 'on';\n\n      setConfigOverride(['agents', 'defaults', 'verboseDefault'], newLevel);\n      await stripSessionAgentFields(ctx.getSessionConfigStore?.(), ctx.sessionKey, ['verboseLevel']);\n\n      return {\n        content: `📝 *Verbose Mode*\\n\\n` +\n          `Mode: *${newLevel}*\\n\\n` +\n          `${newLevel === 'on' ? 'Verbose output enabled (process lifetime).' : 'Verbose output disabled (process lifetime).'}`,\n        success: true,\n      };\n    }\n    \n    // Parse and validate the level\n    const level = normalizeVerboseLevel(args.trim());\n    if (!level) {\n      return {\n        content: `❌ Invalid verbose mode: ${args}\\n\\n` +\n          `Available modes: off, on, full\\n\\n` +\n          `Usage: /verbose [mode]\\n` +\n          `Example: /verbose on`,\n        success: false,\n      };\n    }\n    \n    setConfigOverride(['agents', 'defaults', 'verboseDefault'], level);\n    await stripSessionAgentFields(ctx.getSessionConfigStore?.(), ctx.sessionKey, ['verboseLevel']);\n\n    const modeDescriptions: Record<VerboseLevel, string> = {\n      off: 'Minimal output',\n      on: 'Normal verbose output',\n      full: 'Full verbose output with all details',\n    };\n\n    return {\n      content: `📝 *Verbose Mode Set*\\n\\n` +\n        `Mode: *${level}*\\n` +\n        `${modeDescriptions[level]}\\n\\n` +\n        `Applies for this gateway process (until restart). Persists only if you use /config set.`,\n      success: true,\n    };\n  },\n};\n\n// Status command - enhanced to show thinking/reasoning/verbose\nconst enhancedStatusCommand: CommandDefinition = {\n  id: 'agent.status',\n  name: 'status',\n  description: 'Show current agent status including thinking settings',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    await ctx.setTyping(true);\n\n    const defaults = effectiveAgentDefaults(ctx);\n    const currentModel = ctx.getCurrentModel();\n    const thinkingLevel = (await ctx.getThinkingLevel?.()) ?? defaults?.thinkingDefault;\n    const reasoningLevel = (await ctx.getReasoningLevel?.()) ?? defaults?.reasoningDefault;\n    const verboseLevel = (await ctx.getVerboseLevel?.()) ?? defaults?.verboseDefault;\n    const usage = await ctx.getUsage();\n    \n    // Build status message\n    const lines = [\n      '📊 *Agent Status*',\n      '',\n      `🤖 *Model:* \\`${currentModel}\\``,\n      `🧠 *Thinking:* \\`${thinkingLevel || 'default'}\\``,\n      `💭 *Reasoning:* \\`${reasoningLevel || 'default'}\\``,\n      `📝 *Verbose:* \\`${verboseLevel || 'default'}\\``,\n      '',\n      '---',\n      '',\n      '📈 *Session Usage*',\n      `💬 Messages: ${usage.messageCount}`,\n      `📥 Prompt: ${usage.promptTokens.toLocaleString()} tokens`,\n      `📤 Completion: ${usage.completionTokens.toLocaleString()} tokens`,\n      `📊 Total: ${usage.totalTokens.toLocaleString()} tokens`,\n    ];\n    \n    return {\n      content: lines.join('\\n'),\n      success: true,\n    };\n  },\n};\n\n// Register all thinking commands\nexport function registerThinkingCommands(): void {\n  commandRegistry.register(thinkCommand);\n  commandRegistry.register(reasoningCommand);\n  commandRegistry.register(verboseCommand);\n  commandRegistry.register(enhancedStatusCommand);\n}\n"],"mappings":"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"}
+{"version":3,"file":"thinking.js","names":[],"sources":["../../../../src/chat-commands/builtins/thinking.ts"],"sourcesContent":["/**\n * Thinking Commands\n * \n * Built-in commands for thinking ability management:\n * - /think - Set thinking level\n * - /reasoning - Set reasoning visibility\n * - /verbose - Set verbose mode\n * - /status - Show current status (including thinking/reasoning/verbose)\n */\n\nimport type { CommandDefinition, CommandContext } from '../types.js';\nimport { commandRegistry } from '../registry.js';\nimport {\n  normalizeThinkLevel,\n  normalizeReasoningLevel,\n  normalizeVerboseLevel,\n  formatThinkingLevels,\n  type ThinkLevel,\n  type ReasoningLevel,\n  type VerboseLevel,\n} from '../../agent/transcript/thinking-types.js';\nimport type { SessionConfigStore } from '../../session/index.js';\n\nasync function _stripSessionAgentFields(\n  store: SessionConfigStore | undefined,\n  sessionKey: string,\n  fields: Array<'thinkingLevel' | 'reasoningLevel' | 'verboseLevel'>,\n): Promise<void> {\n  if (!store) return;\n  const existing = await store.get(sessionKey);\n  if (!existing) return;\n  const next = { ...existing };\n  for (const f of fields) {\n    delete next[f];\n  }\n  const restKeys = Object.keys(next).filter((k) => k !== 'updatedAt');\n  if (restKeys.length === 0) {\n    await store.delete(sessionKey);\n  } else {\n    await store.set(sessionKey, next);\n  }\n}\n\nasync function setSessionAgentField<K extends 'thinkingLevel' | 'reasoningLevel' | 'verboseLevel'>(\n  store: SessionConfigStore | undefined,\n  sessionKey: string,\n  field: K,\n  value: K extends 'thinkingLevel' ? ThinkLevel : K extends 'reasoningLevel' ? ReasoningLevel : VerboseLevel,\n): Promise<void> {\n  if (!store) return;\n  const existing = (await store.get(sessionKey)) ?? {};\n  await store.set(sessionKey, { ...existing, [field]: value });\n}\n\n// Think command\nconst thinkCommand: CommandDefinition = {\n  id: 'agent.think',\n  name: 'think',\n  description: 'Set thinking level (usage: /think <level>)',\n  category: 'model',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/think', '/think high', '/think off', '/think adaptive'],\n  handler: async (ctx: CommandContext, args: string) => {\n    await ctx.setTyping(true);\n\n    if (!args.trim()) {\n      // Show current thinking level\n      const currentLevel = await ctx.getThinkingLevel?.();\n      \n      return {\n        content: `🧠 *Thinking Level*\\n\\n` +\n          `Current: *${currentLevel || 'default'}*\\n\\n` +\n          `Available levels:\\n` +\n          `• off - No thinking\\n` +\n          `• minimal - Minimal thinking\\n` +\n          `• low - Low thinking\\n` +\n          `• medium - Medium thinking (default)\\n` +\n          `• high - High thinking\\n` +\n          `• xhigh - Extra high (certain models)\\n` +\n          `• adaptive - Auto-adjust based on task\\n\\n` +\n          `Usage: /think <level>\\n` +\n          `Example: /think high`,\n        success: true,\n      };\n    }\n    \n    // Parse and validate the level\n    const level = normalizeThinkLevel(args.trim());\n    if (!level) {\n      const levels = formatThinkingLevels();\n      return {\n        content: `❌ Invalid thinking level: ${args}\\n\\n` +\n          `Available levels: ${levels}\\n\\n` +\n          `Usage: /think <level>\\n` +\n          `Example: /think high`,\n        success: false,\n      };\n    }\n    \n    await setSessionAgentField(ctx.getSessionConfigStore?.(), ctx.sessionKey, 'thinkingLevel', level);\n    ctx.syncAgentThinkingLevel?.(level);\n\n    const levelDescriptions: Record<ThinkLevel, string> = {\n      off: 'No thinking',\n      minimal: 'Minimal thinking effort',\n      low: 'Low thinking effort',\n      medium: 'Medium thinking effort',\n      high: 'High thinking effort',\n      xhigh: 'Extra high thinking effort',\n      adaptive: 'Auto-adjust based on task complexity',\n    };\n    \n    return {\n      content: `🧠 *Thinking Level Set*\\n\\n` +\n        `Level: *${level}*\\n` +\n        `${levelDescriptions[level]}\\n\\n` +\n        `Applies for this gateway process (until restart). Persists only if you use /config set.`,\n      success: true,\n    };\n  },\n};\n\n// Reasoning command\nconst reasoningCommand: CommandDefinition = {\n  id: 'agent.reasoning',\n  name: 'reasoning',\n  description: 'Set reasoning visibility (usage: /reasoning <mode>)',\n  category: 'model',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/reasoning', '/reasoning on', '/reasoning stream', '/reasoning off'],\n  handler: async (ctx: CommandContext, args: string) => {\n    await ctx.setTyping(true);\n\n    if (!args.trim()) {\n      // Show current reasoning level\n      const currentLevel = await ctx.getReasoningLevel?.();\n      \n      return {\n        content: `💭 *Reasoning Visibility*\\n\\n` +\n          `Current: *${currentLevel || 'default'}*\\n\\n` +\n          `Available modes:\\n` +\n          `• off - Hide reasoning\\n` +\n          `• on - Show reasoning after completion\\n` +\n          `• stream - Stream reasoning in real-time\\n\\n` +\n          `Usage: /reasoning <mode>\\n` +\n          `Example: /reasoning stream`,\n        success: true,\n      };\n    }\n    \n    // Parse and validate the level\n    const level = normalizeReasoningLevel(args.trim());\n    if (!level) {\n      return {\n        content: `❌ Invalid reasoning mode: ${args}\\n\\n` +\n          `Available modes: off, on, stream\\n\\n` +\n          `Usage: /reasoning <mode>\\n` +\n          `Example: /reasoning stream`,\n        success: false,\n      };\n    }\n    \n    await setSessionAgentField(ctx.getSessionConfigStore?.(), ctx.sessionKey, 'reasoningLevel', level);\n\n    const modeDescriptions: Record<ReasoningLevel, string> = {\n      off: 'Hide reasoning from user',\n      on: 'Show reasoning after completion',\n      stream: 'Stream reasoning in real-time',\n    };\n    \n    return {\n      content: `💭 *Reasoning Visibility Set*\\n\\n` +\n        `Mode: *${level}*\\n` +\n        `${modeDescriptions[level]}\\n\\n` +\n        `Applies for this gateway process (until restart). Persists only if you use /config set.`,\n      success: true,\n    };\n  },\n};\n\n// Verbose command\nconst verboseCommand: CommandDefinition = {\n  id: 'agent.verbose',\n  name: 'verbose',\n  description: 'Toggle verbose mode (usage: /verbose [on|off|full])',\n  category: 'model',\n  scope: ['global', 'private', 'group'],\n  acceptsArgs: true,\n  examples: ['/verbose', '/verbose on', '/verbose off', '/verbose full'],\n  handler: async (ctx: CommandContext, args: string) => {\n    await ctx.setTyping(true);\n\n    if (!args.trim()) {\n      // Toggle verbose mode\n      const currentLevel = await ctx.getVerboseLevel?.();\n      const newLevel: VerboseLevel = currentLevel === 'on' ? 'off' : 'on';\n\n      await setSessionAgentField(ctx.getSessionConfigStore?.(), ctx.sessionKey, 'verboseLevel', newLevel);\n\n      return {\n        content: `📝 *Verbose Mode*\\n\\n` +\n          `Mode: *${newLevel}*\\n\\n` +\n          `${newLevel === 'on' ? 'Verbose output enabled (process lifetime).' : 'Verbose output disabled (process lifetime).'}`,\n        success: true,\n      };\n    }\n    \n    // Parse and validate the level\n    const level = normalizeVerboseLevel(args.trim());\n    if (!level) {\n      return {\n        content: `❌ Invalid verbose mode: ${args}\\n\\n` +\n          `Available modes: off, on, full\\n\\n` +\n          `Usage: /verbose [mode]\\n` +\n          `Example: /verbose on`,\n        success: false,\n      };\n    }\n    \n    await setSessionAgentField(ctx.getSessionConfigStore?.(), ctx.sessionKey, 'verboseLevel', level);\n\n    const modeDescriptions: Record<VerboseLevel, string> = {\n      off: 'Minimal output',\n      on: 'Normal verbose output',\n      full: 'Full verbose output with all details',\n    };\n\n    return {\n      content: `📝 *Verbose Mode Set*\\n\\n` +\n        `Mode: *${level}*\\n` +\n        `${modeDescriptions[level]}\\n\\n` +\n        `Applies for this gateway process (until restart). Persists only if you use /config set.`,\n      success: true,\n    };\n  },\n};\n\n// Status command - enhanced to show thinking/reasoning/verbose\nconst enhancedStatusCommand: CommandDefinition = {\n  id: 'agent.status',\n  name: 'status',\n  description: 'Show current agent status including thinking settings',\n  category: 'system',\n  scope: ['global', 'private', 'group'],\n  handler: async (ctx: CommandContext) => {\n    await ctx.setTyping(true);\n\n    const currentModel = ctx.getCurrentModel();\n    const thinkingLevel = await ctx.getThinkingLevel?.();\n    const reasoningLevel = await ctx.getReasoningLevel?.();\n    const verboseLevel = await ctx.getVerboseLevel?.();\n    const usage = await ctx.getUsage();\n    \n    // Build status message\n    const lines = [\n      '📊 *Agent Status*',\n      '',\n      `🤖 *Model:* \\`${currentModel}\\``,\n      `🧠 *Thinking:* \\`${thinkingLevel || 'default'}\\``,\n      `💭 *Reasoning:* \\`${reasoningLevel || 'default'}\\``,\n      `📝 *Verbose:* \\`${verboseLevel || 'default'}\\``,\n      '',\n      '---',\n      '',\n      '📈 *Session Usage*',\n      `💬 Messages: ${usage.messageCount}`,\n      `📥 Prompt: ${usage.promptTokens.toLocaleString()} tokens`,\n      `📤 Completion: ${usage.completionTokens.toLocaleString()} tokens`,\n      `📊 Total: ${usage.totalTokens.toLocaleString()} tokens`,\n    ];\n    \n    return {\n      content: lines.join('\\n'),\n      success: true,\n    };\n  },\n};\n\n// Register all thinking commands\nexport function registerThinkingCommands(): void {\n  commandRegistry.register(thinkCommand);\n  commandRegistry.register(reasoningCommand);\n  commandRegistry.register(verboseCommand);\n  commandRegistry.register(enhancedStatusCommand);\n}\n"],"mappings":"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"}

package/dist/src/chat-commands/config-paths.js

@@ -3,7 +3,7 @@ function parseConfigPath(raw) {
 	const parts = raw.trim().split(".").map((p) => p.trim());
 	if (parts.some((p) => !p)) return {
 		ok: false,
-		error: "Invalid path. Use dot notation (e.g. agents.defaults.models.chat.primary)."
+		error: "Invalid path. Use dot notation (e.g. agents.list.0.models.defaultRole)."
 	};
 	return {
 		ok: true,

package/dist/src/chat-commands/config-paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-paths.js","names":[],"sources":["../../../src/chat-commands/config-paths.ts"],"sourcesContent":["type PathNode = Record<string, unknown>;\n\nexport function parseConfigPath(raw: string): { ok: boolean; path?: string[]; error?: string } {\n  const parts = raw.trim().split('.').map((p) => p.trim());\n  if (parts.some((p) => !p)) {\n    return { ok: false, error: 'Invalid path. Use dot notation (e.g. agents.defaults.models.chat.primary).' };\n  }\n  return { ok: true, path: parts };\n}\n\nexport function getConfigValueAtPath(root: PathNode, path: string[]): unknown {\n  let cursor: unknown = root;\n  for (const key of path) {\n    if (typeof cursor !== 'object' || cursor === null) return undefined;\n    cursor = (cursor as PathNode)[key];\n  }\n  return cursor;\n}\n\nexport function setConfigValueAtPath(root: PathNode, path: string[], value: unknown): void {\n  let cursor: PathNode = root;\n  for (let i = 0; i < path.length - 1; i++) {\n    const key = path[i];\n    if (typeof cursor[key] !== 'object' || cursor[key] === null) cursor[key] = {};\n    cursor = cursor[key] as PathNode;\n  }\n  cursor[path[path.length - 1]] = value;\n}\n\nexport function unsetConfigValueAtPath(root: PathNode, path: string[]): boolean {\n  let cursor: PathNode = root;\n  for (let i = 0; i < path.length - 1; i++) {\n    const next = cursor[path[i]];\n    if (typeof next !== 'object' || next === null) return false;\n    cursor = next as PathNode;\n  }\n  const leaf = path[path.length - 1];\n  if (!(leaf in cursor)) return false;\n  delete cursor[leaf];\n  return true;\n}\n"],"mappings":";AAEA,SAAgB,gBAAgB,KAA+D;CAC7F,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,KAAK,MAAM,EAAE,MAAM,CAAC;AACxD,KAAI,MAAM,MAAM,MAAM,CAAC,EAAE,CACvB,QAAO;EAAE,IAAI;EAAO,OAAO;EAA8E;AAE3G,QAAO;EAAE,IAAI;EAAM,MAAM;EAAO;;AAGlC,SAAgB,qBAAqB,MAAgB,MAAyB;CAC5E,IAAI,SAAkB;AACtB,MAAK,MAAM,OAAO,MAAM;AACtB,MAAI,OAAO,WAAW,YAAY,WAAW,KAAM,QAAO,KAAA;AAC1D,WAAU,OAAoB;;AAEhC,QAAO;;AAGT,SAAgB,qBAAqB,MAAgB,MAAgB,OAAsB;CACzF,IAAI,SAAmB;AACvB,MAAK,IAAI,IAAI,GAAG,IAAI,KAAK,SAAS,GAAG,KAAK;EACxC,MAAM,MAAM,KAAK;AACjB,MAAI,OAAO,OAAO,SAAS,YAAY,OAAO,SAAS,KAAM,QAAO,OAAO,EAAE;AAC7E,WAAS,OAAO;;AAElB,QAAO,KAAK,KAAK,SAAS,MAAM;;AAGlC,SAAgB,uBAAuB,MAAgB,MAAyB;CAC9E,IAAI,SAAmB;AACvB,MAAK,IAAI,IAAI,GAAG,IAAI,KAAK,SAAS,GAAG,KAAK;EACxC,MAAM,OAAO,OAAO,KAAK;AACzB,MAAI,OAAO,SAAS,YAAY,SAAS,KAAM,QAAO;AACtD,WAAS;;CAEX,MAAM,OAAO,KAAK,KAAK,SAAS;AAChC,KAAI,EAAE,QAAQ,QAAS,QAAO;AAC9B,QAAO,OAAO;AACd,QAAO"}
+{"version":3,"file":"config-paths.js","names":[],"sources":["../../../src/chat-commands/config-paths.ts"],"sourcesContent":["type PathNode = Record<string, unknown>;\n\nexport function parseConfigPath(raw: string): { ok: boolean; path?: string[]; error?: string } {\n  const parts = raw.trim().split('.').map((p) => p.trim());\n  if (parts.some((p) => !p)) {\n    return { ok: false, error: 'Invalid path. Use dot notation (e.g. agents.list.0.models.defaultRole).' };\n  }\n  return { ok: true, path: parts };\n}\n\nexport function getConfigValueAtPath(root: PathNode, path: string[]): unknown {\n  let cursor: unknown = root;\n  for (const key of path) {\n    if (typeof cursor !== 'object' || cursor === null) return undefined;\n    cursor = (cursor as PathNode)[key];\n  }\n  return cursor;\n}\n\nexport function setConfigValueAtPath(root: PathNode, path: string[], value: unknown): void {\n  let cursor: PathNode = root;\n  for (let i = 0; i < path.length - 1; i++) {\n    const key = path[i];\n    if (typeof cursor[key] !== 'object' || cursor[key] === null) cursor[key] = {};\n    cursor = cursor[key] as PathNode;\n  }\n  cursor[path[path.length - 1]] = value;\n}\n\nexport function unsetConfigValueAtPath(root: PathNode, path: string[]): boolean {\n  let cursor: PathNode = root;\n  for (let i = 0; i < path.length - 1; i++) {\n    const next = cursor[path[i]];\n    if (typeof next !== 'object' || next === null) return false;\n    cursor = next as PathNode;\n  }\n  const leaf = path[path.length - 1];\n  if (!(leaf in cursor)) return false;\n  delete cursor[leaf];\n  return true;\n}\n"],"mappings":";AAEA,SAAgB,gBAAgB,KAA+D;CAC7F,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,KAAK,MAAM,EAAE,MAAM,CAAC;AACxD,KAAI,MAAM,MAAM,MAAM,CAAC,EAAE,CACvB,QAAO;EAAE,IAAI;EAAO,OAAO;EAA2E;AAExG,QAAO;EAAE,IAAI;EAAM,MAAM;EAAO;;AAGlC,SAAgB,qBAAqB,MAAgB,MAAyB;CAC5E,IAAI,SAAkB;AACtB,MAAK,MAAM,OAAO,MAAM;AACtB,MAAI,OAAO,WAAW,YAAY,WAAW,KAAM,QAAO,KAAA;AAC1D,WAAU,OAAoB;;AAEhC,QAAO;;AAGT,SAAgB,qBAAqB,MAAgB,MAAgB,OAAsB;CACzF,IAAI,SAAmB;AACvB,MAAK,IAAI,IAAI,GAAG,IAAI,KAAK,SAAS,GAAG,KAAK;EACxC,MAAM,MAAM,KAAK;AACjB,MAAI,OAAO,OAAO,SAAS,YAAY,OAAO,SAAS,KAAM,QAAO,OAAO,EAAE;AAC7E,WAAS,OAAO;;AAElB,QAAO,KAAK,KAAK,SAAS,MAAM;;AAGlC,SAAgB,uBAAuB,MAAgB,MAAyB;CAC9E,IAAI,SAAmB;AACvB,MAAK,IAAI,IAAI,GAAG,IAAI,KAAK,SAAS,GAAG,KAAK;EACxC,MAAM,OAAO,OAAO,KAAK;AACzB,MAAI,OAAO,SAAS,YAAY,SAAS,KAAM,QAAO;AACtD,WAAS;;CAEX,MAAM,OAAO,KAAK,KAAK,SAAS;AAChC,KAAI,EAAE,QAAQ,QAAS,QAAO;AAC9B,QAAO,OAAO;AACd,QAAO"}