@xopcai/xopc 0.0.102 → 0.0.104

package/dist/src/cli/commands/onboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"onboard.js","names":["runModelSetup","runChannelOnboard"],"sources":["../../../../src/cli/commands/onboard.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { select } from '@inquirer/prompts';\nimport { saveConfig } from '../../config/index.js';\nimport { register, formatExamples } from '../registry.js';\nimport type { CLIContext } from '../registry.js';\nimport type { Config } from '../../config/schema.js';\nimport { setupModel as runModelSetup } from './onboard/model.js';\nimport { colors } from '../utils/colors.js';\nimport { setupChannels as runChannelOnboard, getChannelConfigurators } from './onboard/channels/index.js';\nimport { seedMainAgentProfileMarkdown } from '../../agent/context/workspace-seed.js';\nimport { resolveGatewayLocalClientHost } from '../../config/gateway-bind.js';\nimport { initWorkspace } from '../utils/init-workspace.js';\nimport { ConfigSchema } from '../../config/schema.js';\nimport { isWeixinOnboardConfigured } from '../../../extensions/weixin/src/adapters/onboard-cli.js';\n\nfunction isInteractive(): boolean {\n  return process.stdin.isTTY && process.stdout.isTTY;\n}\n\nasync function setupNonInteractive(_configPath: string, existingConfig: Config): Promise<Config> {\n  console.log('\\n🤖 AI Model Configuration (Non-Interactive Mode)\\n');\n  console.log('Current config:', JSON.stringify(existingConfig.agents?.defaults?.model, null, 2));\n  console.log('\\n💡 To configure in interactive mode, run: xopc onboard');\n  console.log('💡 Or set up manually in:', _configPath);\n  return existingConfig;\n}\n\nfunction createOnboardCommand(ctx: CLIContext): Command {\n  const cmd = new Command('onboard')\n    .description('Interactive setup wizard for xopc (gateway uses schema defaults)')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc onboard              # Full interactive setup',\n        'xopc onboard --model      # Configure LLM model only',\n        'xopc onboard --channels   # Configure channels (incl. Weixin QR)',\n        'xopc onboard --gateway    # Apply default gateway settings (quiet)',\n      ])\n    )\n    .option('--model', 'Configure LLM provider and model')\n    .option('--channels', 'Configure messaging channels')\n    .option('--gateway', 'Configure gateway WebUI')\n    .option('--all', 'Configure everything (default)')\n    .action(async (options) => {\n      try {\n        await runOnboard(options, ctx);\n      } catch (error: unknown) {\n        const err = error as { name?: string; code?: string };\n        if (err?.name === 'ExitPromptError' || err?.code === 'EXIT_PROMPT') {\n          console.log('\\n\\n👋 Setup cancelled.');\n          process.exit(0);\n        }\n        throw error;\n      }\n    });\n\n  return cmd;\n}\n\ntype OnboardOptions = {\n  model?: boolean;\n  channels?: boolean;\n  gateway?: boolean;\n  all?: boolean;\n};\n\nasync function runOnboard(\n  options: OnboardOptions,\n  ctx: CLIContext\n): Promise<void> {\n  console.log(colors.cyan('\\n🚀 Welcome to xopc setup!\\n'));\n  console.log('═'.repeat(50));\n\n  const workspacePath = ctx.workspacePath;\n  const configPath = ctx.configPath;\n\n  const initResult = await initWorkspace({ configPath, workspacePath });\n  let config = initResult.config;\n\n  // Determine what to configure based on options\n  const doModel = options.model || options.all || (!options.channels && !options.gateway);\n  const doChannels = options.channels || options.all || (!options.model && !options.gateway);\n  const doGateway = options.gateway || options.all || (!options.model && !options.channels);\n  const runFullWizard = !options.model && !options.channels && !options.gateway;\n  /** Any setup step besides the unified launch prompt ran in interactive flow. */\n  const didConfigurableSteps = doModel || doChannels || doGateway;\n\n  if (!isInteractive()) {\n    // Non-interactive mode\n    if (doModel) {\n      config = await setupNonInteractive(configPath, config);\n    }\n    if (doChannels) {\n      console.log('\\n💬 Channels Configuration (Non-Interactive Mode)\\n');\n      console.log('💡 To configure channels, edit the config file manually.');\n    }\n    if (doGateway) {\n      console.log('\\n🌐 Gateway Configuration (Non-Interactive Mode)\\n');\n      console.log('💡 To configure gateway, edit the config file manually.');\n    }\n  } else {\n    // Interactive mode\n    if (doModel) {\n      config = await runModelSetup(config, ctx);\n    }\n\n    if (doChannels) {\n      const channelIds = getChannelConfigurators().map(c => c.id);\n      console.log(colors.gray(`\\nChannel onboarding: ${channelIds.join(', ')}\\n`));\n      config = await runChannelOnboard(config);\n    }\n\n    if (doGateway) {\n      config = await setupGateway(config);\n    }\n  }\n\n  // Save config once at the end\n  await saveConfig(config as Config, configPath);\n\n  seedMainAgentProfileMarkdown(config as Config);\n\n  console.log('\\n' + '═'.repeat(50));\n  console.log('\\n🎉 Setup Complete!\\n');\n\n  const gatewayAuth = (config as any)?.gateway?.auth;\n  const gatewayConfigured =\n    gatewayAuth?.mode === 'token' &&\n    typeof gatewayAuth?.token === 'string' &&\n    gatewayAuth.token.length > 0;\n  const port = (config as Config)?.gateway?.port ?? 18790;\n  const displayHost = resolveGatewayLocalClientHost(config as Config);\n  const gwToken = gatewayConfigured ? (gatewayAuth.token as string) : undefined;\n\n  const showGatewaySummary = Boolean(gatewayConfigured && gwToken && (doGateway || runFullWizard));\n\n  if (showGatewaySummary && gwToken) {\n    const webuiUrl = `http://${displayHost}:${port}?token=${gwToken}`;\n    console.log('🌐 Web console (browser) — start here');\n    console.log(`   Open: http://${displayHost}:${port}`);\n    console.log(`   Token: ${gwToken.slice(0, 8)}...${gwToken.slice(-8)}`);\n    console.log('   Bookmark link (token is saved in the browser when you open it):');\n    console.log(`   ${webuiUrl}`);\n    console.log('');\n  }\n\n  if (runFullWizard) {\n    console.log('🚀 Next steps:');\n    if (gatewayConfigured) {\n      console.log('  1. Choose how to launch below (gateway or terminal UI)');\n      console.log('  2. Or chat with: xopc agent -i');\n    } else {\n      console.log('  1. Chat in the terminal: xopc agent -i');\n      console.log('  2. Optional: add the Web console: xopc onboard --gateway');\n    }\n    console.log('');\n  } else if (doGateway && gatewayConfigured) {\n    console.log('🚀 Next step:');\n    console.log('  Start the gateway if it is not running, then open the Web console URL above.');\n    console.log('');\n  }\n\n  console.log('📝 Usage:');\n  console.log('  xopc agent -m \"Hello\"    # Chat with AI');\n  console.log('  xopc agent -i            # Interactive mode');\n  console.log('  xopc models list         # List models');\n  console.log('  xopc config validate     # Validate xopc.json');\n  console.log('  xopc auth list           # View authentication');\n  console.log('  xopc init                # Full state dirs (if upgrading or missing data)');\n\n  console.log('\\n📁 Files:');\n  console.log('  Config:', configPath);\n  console.log('  Workspace:', workspacePath);\n\n  if (isInteractive() && didConfigurableSteps) {\n    await promptLaunchAfterOnboard(config as Config, ctx, { doChannels });\n  }\n\n  process.exit(0);\n}\n\nasync function startGatewayAsService(config: Config, ctx: CLIContext): Promise<void> {\n  const { startGatewayNow } = await import('./onboard/gateway.js');\n  await startGatewayNow(config, ctx);\n}\n\nasync function promptLaunchAfterOnboard(\n  config: Config,\n  ctx: CLIContext,\n  flags: { doChannels: boolean },\n): Promise<void> {\n  console.log('');\n  const choice = await select<'tui' | 'gateway' | 'none'>({\n    message: 'How do you want to launch xopc now?',\n    choices: [\n      {\n        value: 'tui',\n        name: 'Terminal UI (embedded)',\n        description: 'xopc tui --local — no gateway process required',\n      },\n      {\n        value: 'gateway',\n        name: 'Gateway WebUI (OS service)',\n        description: 'Install and start the HTTP gateway for the browser console',\n      },\n      {\n        value: 'none',\n        name: 'Exit — I will start manually',\n        description: 'Finish setup without starting a runtime',\n      },\n    ],\n    default: 'tui',\n  });\n\n  if (choice === 'gateway') {\n    await startGatewayAsService(config, ctx);\n    return;\n  }\n\n  if (choice === 'tui') {\n    if (flags.doChannels && !isWeixinOnboardConfigured(config)) {\n      console.log(\n        colors.gray(\n          '\\n💡 Weixin is not logged in yet. When ready run: xopc channels login --channel weixin\\n',\n        ),\n      );\n    }\n    const { runTui } = await import('../../tui/tui.js');\n    await runTui({ local: true });\n    return;\n  }\n\n  console.log('\\n⏭️  You can start later:');\n  console.log('   xopc gateway service install');\n  console.log('   xopc gateway');\n  console.log('   xopc tui --local');\n}\n\nasync function setupGateway(config: Config): Promise<Config> {\n  console.log(colors.cyan('\\n🌐 Gateway WebUI\\n'));\n  console.log(\n    colors.gray(\n      'Applying defaults from config schema (127.0.0.1:18790, token auth; token generated if missing).\\n',\n    ),\n  );\n\n  const gw = config.gateway ?? {};\n  const { randomBytes } = await import('node:crypto');\n  const authMode = gw.auth?.mode === 'none' ? ('none' as const) : ('token' as const);\n  const token =\n    authMode === 'token'\n      ? typeof gw.auth?.token === 'string' && gw.auth.token.length > 0\n        ? gw.auth.token\n        : randomBytes(24).toString('hex')\n      : undefined;\n\n  const merged: Config = {\n    ...config,\n    gateway: {\n      ...gw,\n      bind: gw.bind ?? 'loopback',\n      port: gw.port ?? 18790,\n      auth:\n        authMode === 'none'\n          ? { mode: 'none' as const }\n          : { mode: 'token' as const, token: token! },\n    },\n  };\n\n  const parsed = ConfigSchema.parse(merged);\n  console.log('✅ Gateway defaults applied.\\n');\n  return parsed;\n}\n\nregister({\n  id: 'onboard',\n  name: 'onboard',\n  description: 'Interactive setup wizard',\n  factory: createOnboardCommand,\n  metadata: {\n    category: 'setup',\n    examples: ['xopc onboard', 'xopc onboard --model', 'xopc onboard --channels'],\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"onboard.js","names":["runModelSetup","runChannelOnboard"],"sources":["../../../../src/cli/commands/onboard.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { select } from '@inquirer/prompts';\nimport { saveConfig } from '../../config/index.js';\nimport { register, formatExamples } from '../registry.js';\nimport type { CLIContext } from '../registry.js';\nimport type { Config } from '../../config/schema.js';\nimport { setupModel as runModelSetup } from './onboard/model.js';\nimport { colors } from '../utils/colors.js';\nimport { setupChannels as runChannelOnboard, getChannelConfigurators } from './onboard/channels/index.js';\nimport { seedMainAgentProfileMarkdown } from '../../agent/context/workspace-seed.js';\nimport { resolveGatewayLocalClientHost } from '../../config/gateway-bind.js';\nimport { initWorkspace } from '../utils/init-workspace.js';\nimport { ConfigSchema } from '../../config/schema.js';\n\nfunction isInteractive(): boolean {\n  return process.stdin.isTTY && process.stdout.isTTY;\n}\n\nasync function setupNonInteractive(_configPath: string, existingConfig: Config): Promise<Config> {\n  console.log('\\n🤖 AI Model Configuration (Non-Interactive Mode)\\n');\n  console.log('Current config:', JSON.stringify(existingConfig.agents?.defaults?.models?.chat, null, 2));\n  console.log('\\n💡 To configure in interactive mode, run: xopc onboard');\n  console.log('💡 Or set up manually in:', _configPath);\n  return existingConfig;\n}\n\nfunction createOnboardCommand(ctx: CLIContext): Command {\n  const cmd = new Command('onboard')\n    .description('Interactive setup wizard for xopc (gateway uses schema defaults)')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc onboard              # Full interactive setup',\n        'xopc onboard --model      # Configure LLM model only',\n        'xopc onboard --channels   # Configure messaging channels',\n        'xopc onboard --gateway    # Apply default gateway settings (quiet)',\n      ])\n    )\n    .option('--model', 'Configure LLM provider and model')\n    .option('--channels', 'Configure messaging channels')\n    .option('--gateway', 'Configure gateway WebUI')\n    .option('--all', 'Configure everything (default)')\n    .action(async (options) => {\n      try {\n        await runOnboard(options, ctx);\n      } catch (error: unknown) {\n        const err = error as { name?: string; code?: string };\n        if (err?.name === 'ExitPromptError' || err?.code === 'EXIT_PROMPT') {\n          console.log('\\n\\n👋 Setup cancelled.');\n          process.exit(0);\n        }\n        throw error;\n      }\n    });\n\n  return cmd;\n}\n\ntype OnboardOptions = {\n  model?: boolean;\n  channels?: boolean;\n  gateway?: boolean;\n  all?: boolean;\n};\n\nasync function runOnboard(\n  options: OnboardOptions,\n  ctx: CLIContext\n): Promise<void> {\n  console.log(colors.cyan('\\n🚀 Welcome to xopc setup!\\n'));\n  console.log('═'.repeat(50));\n\n  const workspacePath = ctx.workspacePath;\n  const configPath = ctx.configPath;\n\n  const initResult = await initWorkspace({ configPath, workspacePath });\n  let config = initResult.config;\n\n  // Determine what to configure based on options\n  const doModel = options.model || options.all || (!options.channels && !options.gateway);\n  const doChannels = options.channels || options.all || (!options.model && !options.gateway);\n  const doGateway = options.gateway || options.all || (!options.model && !options.channels);\n  const runFullWizard = !options.model && !options.channels && !options.gateway;\n  /** Any setup step besides the unified launch prompt ran in interactive flow. */\n  const didConfigurableSteps = doModel || doChannels || doGateway;\n\n  if (!isInteractive()) {\n    // Non-interactive mode\n    if (doModel) {\n      config = await setupNonInteractive(configPath, config);\n    }\n    if (doChannels) {\n      console.log('\\n💬 Channels Configuration (Non-Interactive Mode)\\n');\n      console.log('💡 To configure channels, edit the config file manually.');\n    }\n    if (doGateway) {\n      console.log('\\n🌐 Gateway Configuration (Non-Interactive Mode)\\n');\n      console.log('💡 To configure gateway, edit the config file manually.');\n    }\n  } else {\n    // Interactive mode\n    if (doModel) {\n      config = await runModelSetup(config, ctx);\n    }\n\n    if (doChannels) {\n      const channelIds = (await getChannelConfigurators(config)).map(c => c.id);\n      console.log(colors.gray(`\\nChannel onboarding: ${channelIds.join(', ')}\\n`));\n      config = await runChannelOnboard(config);\n    }\n\n    if (doGateway) {\n      config = await setupGateway(config);\n    }\n  }\n\n  // Save config once at the end\n  await saveConfig(config as Config, configPath);\n\n  seedMainAgentProfileMarkdown(config as Config);\n\n  console.log('\\n' + '═'.repeat(50));\n  console.log('\\n🎉 Setup Complete!\\n');\n\n  const gatewayAuth = (config as any)?.gateway?.auth;\n  const gatewayConfigured =\n    gatewayAuth?.mode === 'token' &&\n    typeof gatewayAuth?.token === 'string' &&\n    gatewayAuth.token.length > 0;\n  const port = (config as Config)?.gateway?.port ?? 18790;\n  const displayHost = resolveGatewayLocalClientHost(config as Config);\n  const gwToken = gatewayConfigured ? (gatewayAuth.token as string) : undefined;\n\n  const showGatewaySummary = Boolean(gatewayConfigured && gwToken && (doGateway || runFullWizard));\n\n  if (showGatewaySummary && gwToken) {\n    const webuiUrl = `http://${displayHost}:${port}?token=${gwToken}`;\n    console.log('🌐 Web console (browser) — start here');\n    console.log(`   Open: http://${displayHost}:${port}`);\n    console.log(`   Token: ${gwToken.slice(0, 8)}...${gwToken.slice(-8)}`);\n    console.log('   Bookmark link (token is saved in the browser when you open it):');\n    console.log(`   ${webuiUrl}`);\n    console.log('');\n  }\n\n  if (runFullWizard) {\n    console.log('🚀 Next steps:');\n    if (gatewayConfigured) {\n      console.log('  1. Choose how to launch below (gateway or terminal UI)');\n      console.log('  2. Or chat with: xopc agent -i');\n    } else {\n      console.log('  1. Chat in the terminal: xopc agent -i');\n      console.log('  2. Optional: add the Web console: xopc onboard --gateway');\n    }\n    console.log('');\n  } else if (doGateway && gatewayConfigured) {\n    console.log('🚀 Next step:');\n    console.log('  Start the gateway if it is not running, then open the Web console URL above.');\n    console.log('');\n  }\n\n  console.log('📝 Usage:');\n  console.log('  xopc agent -m \"Hello\"    # Chat with AI');\n  console.log('  xopc agent -i            # Interactive mode');\n  console.log('  xopc models list         # List models');\n  console.log('  xopc config validate     # Validate xopc.json');\n  console.log('  xopc auth list           # View authentication');\n  console.log('  xopc init                # Full state dirs (if upgrading or missing data)');\n\n  console.log('\\n📁 Files:');\n  console.log('  Config:', configPath);\n  console.log('  Workspace:', workspacePath);\n\n  if (isInteractive() && didConfigurableSteps) {\n    await promptLaunchAfterOnboard(config as Config, ctx, { doChannels });\n  }\n\n  process.exit(0);\n}\n\nasync function startGatewayAsService(config: Config, ctx: CLIContext): Promise<void> {\n  const { startGatewayNow } = await import('./onboard/gateway.js');\n  await startGatewayNow(config, ctx);\n}\n\nasync function promptLaunchAfterOnboard(\n  config: Config,\n  ctx: CLIContext,\n  _flags: { doChannels: boolean },\n): Promise<void> {\n  console.log('');\n  const choice = await select<'tui' | 'gateway' | 'none'>({\n    message: 'How do you want to launch xopc now?',\n    choices: [\n      {\n        value: 'tui',\n        name: 'Terminal UI (embedded)',\n        description: 'xopc tui --local — no gateway process required',\n      },\n      {\n        value: 'gateway',\n        name: 'Gateway WebUI (OS service)',\n        description: 'Install and start the HTTP gateway for the browser console',\n      },\n      {\n        value: 'none',\n        name: 'Exit — I will start manually',\n        description: 'Finish setup without starting a runtime',\n      },\n    ],\n    default: 'tui',\n  });\n\n  if (choice === 'gateway') {\n    await startGatewayAsService(config, ctx);\n    return;\n  }\n\n  if (choice === 'tui') {\n    const { runTui } = await import('../../tui/tui.js');\n    await runTui({ local: true });\n    return;\n  }\n\n  console.log('\\n⏭️  You can start later:');\n  console.log('   xopc gateway service install');\n  console.log('   xopc gateway');\n  console.log('   xopc tui --local');\n}\n\nasync function setupGateway(config: Config): Promise<Config> {\n  console.log(colors.cyan('\\n🌐 Gateway WebUI\\n'));\n  console.log(\n    colors.gray(\n      'Applying defaults from config schema (127.0.0.1:18790, token auth; token generated if missing).\\n',\n    ),\n  );\n\n  const gw = config.gateway ?? {};\n  const { randomBytes } = await import('node:crypto');\n  const authMode = gw.auth?.mode === 'none' ? ('none' as const) : ('token' as const);\n  const token =\n    authMode === 'token'\n      ? typeof gw.auth?.token === 'string' && gw.auth.token.length > 0\n        ? gw.auth.token\n        : randomBytes(24).toString('hex')\n      : undefined;\n\n  const merged: Config = {\n    ...config,\n    gateway: {\n      ...gw,\n      bind: gw.bind ?? 'loopback',\n      port: gw.port ?? 18790,\n      auth:\n        authMode === 'none'\n          ? { mode: 'none' as const }\n          : { mode: 'token' as const, token: token! },\n    },\n  };\n\n  const parsed = ConfigSchema.parse(merged);\n  console.log('✅ Gateway defaults applied.\\n');\n  return parsed;\n}\n\nregister({\n  id: 'onboard',\n  name: 'onboard',\n  description: 'Interactive setup wizard',\n  factory: createOnboardCommand,\n  metadata: {\n    category: 'setup',\n    examples: ['xopc onboard', 'xopc onboard --model', 'xopc onboard --channels'],\n  },\n});\n"],"mappings":"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"}

package/dist/src/cli/commands/setup-shared/runner.d.ts

@@ -6,7 +6,7 @@ export declare class SetupValidationError extends Error {
     constructor(errors: SetupError[] | SetupError | string);
 }
 export interface SetupMutator {
-    /** Logical domain — `providers`, `channels.telegram`, etc. */
+    /** Logical domain — `providers`, `channels.<id>`, etc. */
     domain: string;
     /** Target id within the domain (provider id, account id, …). */
     target?: string;

package/dist/src/cli/commands/setup-shared/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/cli/commands/setup-shared/runner.ts"],"sourcesContent":["import { ZodError } from 'zod';\n\nimport { loadConfig, saveConfig } from '../../../config/index.js';\nimport { ConfigSchema, type Config } from '../../../config/schema.js';\nimport { diffConfigPaths } from '../../../config/diff.js';\n\nimport { emitOutcome } from './output.js';\nimport { isPromptCancelled } from './prompts.js';\nimport {\n  SETUP_EXIT,\n  type SetupAction,\n  type SetupError,\n  type SetupOutcome,\n  type SetupRunOptions,\n} from './types.js';\n\n/** Thrown by a {@link SetupMutator.mutate} to fail the run with a clean message. */\nexport class SetupValidationError extends Error {\n  readonly errors: SetupError[];\n\n  constructor(errors: SetupError[] | SetupError | string) {\n    const list: SetupError[] = Array.isArray(errors)\n      ? errors\n      : typeof errors === 'string'\n        ? [{ message: errors }]\n        : [errors];\n    super(list.map((e) => (e.path ? `[${e.path}] ${e.message}` : e.message)).join('; '));\n    this.name = 'SetupValidationError';\n    this.errors = list;\n  }\n}\n\nexport interface SetupMutator {\n  /** Logical domain — `providers`, `channels.telegram`, etc. */\n  domain: string;\n  /** Target id within the domain (provider id, account id, …). */\n  target?: string;\n  /** What the operation is conceptually doing. */\n  action: SetupAction;\n  /** Mutates `config` in place (or returns a replacement) and returns it. */\n  mutate(config: Config): Config | Promise<Config>;\n  /** Optional masked value to surface in the outcome (for agents / UI). */\n  resultValue?(config: Config): unknown;\n  /** Optional human-readable notes appended to the outcome. */\n  notes?(config: Config): string[];\n}\n\nexport interface RunSetupArgs {\n  configPath: string;\n  mutator: SetupMutator;\n  options: SetupRunOptions;\n}\n\nfunction zodErrorToSetupErrors(err: ZodError): SetupError[] {\n  return err.issues.map((issue) => ({\n    path: issue.path.join('.') || undefined,\n    message: issue.message,\n  }));\n}\n\n/**\n * Headless setup pipeline — load → clone → mutate → validate(zod) → diff →\n * (write | dry-run) → outcome. Returns the {@link SetupOutcome} without any\n * I/O side effects (no stdout, no `process.exitCode`).\n *\n * Used by CLI setup commands via {@link runSetup}. Keep this side-effect-free\n * so it stays safe to call from tests and other programmatic callers.\n *\n * Custom errors thrown by the mutator surface as `errors[]` on the outcome:\n *   - `SetupValidationError` — explicit `{path?, message}[]` entries\n *   - `ExitPromptError` (from `@inquirer/prompts`) — surfaced as \"Cancelled by user\"\n *   - any other `Error` — the message is used verbatim\n */\nexport async function runSetupHeadless(args: RunSetupArgs): Promise<SetupOutcome> {\n  const { configPath, mutator, options } = args;\n\n  let before: Config;\n  try {\n    before = loadConfig(configPath);\n  } catch (error) {\n    return {\n      ok: false,\n      action: mutator.action,\n      domain: mutator.domain,\n      target: mutator.target,\n      changedPaths: [],\n      dryRun: options.dryRun,\n      errors: [{ message: `Failed to load config: ${(error as Error).message}` }],\n    };\n  }\n\n  // `loadConfig` parses through the schema once, but the schema isn't fully\n  // idempotent — re-parsing a result can fill in deeper defaults that the\n  // first pass left undefined. To avoid false-positive diffs against those\n  // defaults, normalize both sides through one extra parse cycle.\n  const baselineParsed = ConfigSchema.safeParse(structuredClone(before));\n  const baseline: Config = baselineParsed.success ? baselineParsed.data : before;\n\n  const cloneBefore = structuredClone(before);\n  let mutated: Config;\n  try {\n    mutated = await mutator.mutate(cloneBefore);\n  } catch (error) {\n    if (isPromptCancelled(error)) {\n      return {\n        ok: false,\n        action: mutator.action,\n        domain: mutator.domain,\n        target: mutator.target,\n        changedPaths: [],\n        dryRun: options.dryRun,\n        errors: [{ message: 'Cancelled by user' }],\n      };\n    }\n    const errors =\n      error instanceof SetupValidationError\n        ? error.errors\n        : [{ message: (error as Error).message }];\n    return {\n      ok: false,\n      action: mutator.action,\n      domain: mutator.domain,\n      target: mutator.target,\n      changedPaths: [],\n      dryRun: options.dryRun,\n      errors,\n    };\n  }\n\n  // Validate the full config (catches invariants beyond the mutator's scope).\n  const parsed = ConfigSchema.safeParse(mutated);\n  if (!parsed.success) {\n    return {\n      ok: false,\n      action: mutator.action,\n      domain: mutator.domain,\n      target: mutator.target,\n      changedPaths: [],\n      dryRun: options.dryRun,\n      errors: zodErrorToSetupErrors(parsed.error),\n    };\n  }\n  const validated = parsed.data;\n\n  const changedPaths = diffConfigPaths(baseline, validated);\n  const action: SetupAction = changedPaths.length === 0 ? 'noop' : mutator.action;\n\n  if (changedPaths.length > 0 && !options.dryRun) {\n    try {\n      await saveConfig(validated, configPath);\n    } catch (error) {\n      return {\n        ok: false,\n        action: mutator.action,\n        domain: mutator.domain,\n        target: mutator.target,\n        changedPaths,\n        dryRun: false,\n        errors: [{ message: `Failed to save config: ${(error as Error).message}` }],\n      };\n    }\n  }\n\n  return {\n    ok: true,\n    action,\n    domain: mutator.domain,\n    target: mutator.target,\n    changedPaths,\n    dryRun: options.dryRun,\n    value: mutator.resultValue?.(validated),\n    notes: mutator.notes?.(validated),\n  };\n}\n\n/**\n * CLI wrapper around {@link runSetupHeadless}: emits the outcome to stdout\n * (text or single-line JSON) and sets `process.exitCode` to the standard\n * setup exit codes (0 ok / 1 error / 2 cancelled).\n *\n * Use this from CLI command actions; use {@link runSetupHeadless} from any\n * non-CLI caller (HTTP routes, library code, tests).\n */\nexport async function runSetup(args: RunSetupArgs): Promise<SetupOutcome> {\n  const outcome = await runSetupHeadless(args);\n  emitOutcome(outcome, args.options.json);\n  if (outcome.ok) {\n    process.exitCode = SETUP_EXIT.OK;\n  } else if (outcome.errors?.some((e) => /cancelled/i.test(e.message))) {\n    process.exitCode = SETUP_EXIT.CANCELLED;\n  } else {\n    process.exitCode = SETUP_EXIT.ERROR;\n  }\n  return outcome;\n}\n"],"mappings":";;;;;;;;aAGsE;;AActE,IAAa,uBAAb,cAA0C,MAAM;CAC9C;CAEA,YAAY,QAA4C;EACtD,MAAM,OAAqB,MAAM,QAAQ,OAAO,GAC5C,SACA,OAAO,WAAW,WAChB,CAAC,EAAE,SAAS,QAAQ,CAAC,GACrB,CAAC,OAAO;AACd,QAAM,KAAK,KAAK,MAAO,EAAE,OAAO,IAAI,EAAE,KAAK,IAAI,EAAE,YAAY,EAAE,QAAS,CAAC,KAAK,KAAK,CAAC;AACpF,OAAK,OAAO;AACZ,OAAK,SAAS;;;AAyBlB,SAAS,sBAAsB,KAA6B;AAC1D,QAAO,IAAI,OAAO,KAAK,WAAW;EAChC,MAAM,MAAM,KAAK,KAAK,IAAI,IAAI,KAAA;EAC9B,SAAS,MAAM;EAChB,EAAE;;;;;;;;;;;;;;;AAgBL,eAAsB,iBAAiB,MAA2C;CAChF,MAAM,EAAE,YAAY,SAAS,YAAY;CAEzC,IAAI;AACJ,KAAI;AACF,WAAS,WAAW,WAAW;UACxB,OAAO;AACd,SAAO;GACL,IAAI;GACJ,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,cAAc,EAAE;GAChB,QAAQ,QAAQ;GAChB,QAAQ,CAAC,EAAE,SAAS,0BAA2B,MAAgB,WAAW,CAAC;GAC5E;;CAOH,MAAM,iBAAiB,aAAa,UAAU,gBAAgB,OAAO,CAAC;CACtE,MAAM,WAAmB,eAAe,UAAU,eAAe,OAAO;CAExE,MAAM,cAAc,gBAAgB,OAAO;CAC3C,IAAI;AACJ,KAAI;AACF,YAAU,MAAM,QAAQ,OAAO,YAAY;UACpC,OAAO;AACd,MAAI,kBAAkB,MAAM,CAC1B,QAAO;GACL,IAAI;GACJ,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,cAAc,EAAE;GAChB,QAAQ,QAAQ;GAChB,QAAQ,CAAC,EAAE,SAAS,qBAAqB,CAAC;GAC3C;EAEH,MAAM,SACJ,iBAAiB,uBACb,MAAM,SACN,CAAC,EAAE,SAAU,MAAgB,SAAS,CAAC;AAC7C,SAAO;GACL,IAAI;GACJ,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,cAAc,EAAE;GAChB,QAAQ,QAAQ;GAChB;GACD;;CAIH,MAAM,SAAS,aAAa,UAAU,QAAQ;AAC9C,KAAI,CAAC,OAAO,QACV,QAAO;EACL,IAAI;EACJ,QAAQ,QAAQ;EAChB,QAAQ,QAAQ;EAChB,QAAQ,QAAQ;EAChB,cAAc,EAAE;EAChB,QAAQ,QAAQ;EAChB,QAAQ,sBAAsB,OAAO,MAAM;EAC5C;CAEH,MAAM,YAAY,OAAO;CAEzB,MAAM,eAAe,gBAAgB,UAAU,UAAU;CACzD,MAAM,SAAsB,aAAa,WAAW,IAAI,SAAS,QAAQ;AAEzE,KAAI,aAAa,SAAS,KAAK,CAAC,QAAQ,OACtC,KAAI;AACF,QAAM,WAAW,WAAW,WAAW;UAChC,OAAO;AACd,SAAO;GACL,IAAI;GACJ,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB,QAAQ,QAAQ;GAChB;GACA,QAAQ;GACR,QAAQ,CAAC,EAAE,SAAS,0BAA2B,MAAgB,WAAW,CAAC;GAC5E;;AAIL,QAAO;EACL,IAAI;EACJ;EACA,QAAQ,QAAQ;EAChB,QAAQ,QAAQ;EAChB;EACA,QAAQ,QAAQ;EAChB,OAAO,QAAQ,cAAc,UAAU;EACvC,OAAO,QAAQ,QAAQ,UAAU;EAClC;;;;;;;;;;AAWH,eAAsB,SAAS,MAA2C;CACxE,MAAM,UAAU,MAAM,iBAAiB,KAAK;AAC5C,aAAY,SAAS,KAAK,QAAQ,KAAK;AACvC,KAAI,QAAQ,GACV,SAAQ,WAAW,WAAW;UACrB,QAAQ,QAAQ,MAAM,MAAM,aAAa,KAAK,EAAE,QAAQ,CAAC,CAClE,SAAQ,WAAW,WAAW;KAE9B,SAAQ,WAAW,WAAW;AAEhC,QAAO"}
+{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/cli/commands/setup-shared/runner.ts"],"sourcesContent":["import { ZodError } from 'zod';\n\nimport { loadConfig, saveConfig } from '../../../config/index.js';\nimport { ConfigSchema, type Config } from '../../../config/schema.js';\nimport { diffConfigPaths } from '../../../config/diff.js';\n\nimport { emitOutcome } from './output.js';\nimport { isPromptCancelled } from './prompts.js';\nimport {\n  SETUP_EXIT,\n  type SetupAction,\n  type SetupError,\n  type SetupOutcome,\n  type SetupRunOptions,\n} from './types.js';\n\n/** Thrown by a {@link SetupMutator.mutate} to fail the run with a clean message. */\nexport class SetupValidationError extends Error {\n  readonly errors: SetupError[];\n\n  constructor(errors: SetupError[] | SetupError | string) {\n    const list: SetupError[] = Array.isArray(errors)\n      ? errors\n      : typeof errors === 'string'\n        ? [{ message: errors }]\n        : [errors];\n    super(list.map((e) => (e.path ? `[${e.path}] ${e.message}` : e.message)).join('; '));\n    this.name = 'SetupValidationError';\n    this.errors = list;\n  }\n}\n\nexport interface SetupMutator {\n  /** Logical domain — `providers`, `channels.<id>`, etc. */\n  domain: string;\n  /** Target id within the domain (provider id, account id, …). */\n  target?: string;\n  /** What the operation is conceptually doing. */\n  action: SetupAction;\n  /** Mutates `config` in place (or returns a replacement) and returns it. */\n  mutate(config: Config): Config | Promise<Config>;\n  /** Optional masked value to surface in the outcome (for agents / UI). */\n  resultValue?(config: Config): unknown;\n  /** Optional human-readable notes appended to the outcome. */\n  notes?(config: Config): string[];\n}\n\nexport interface RunSetupArgs {\n  configPath: string;\n  mutator: SetupMutator;\n  options: SetupRunOptions;\n}\n\nfunction zodErrorToSetupErrors(err: ZodError): SetupError[] {\n  return err.issues.map((issue) => ({\n    path: issue.path.join('.') || undefined,\n    message: issue.message,\n  }));\n}\n\n/**\n * Headless setup pipeline — load → clone → mutate → validate(zod) → diff →\n * (write | dry-run) → outcome. Returns the {@link SetupOutcome} without any\n * I/O side effects (no stdout, no `process.exitCode`).\n *\n * Used by CLI setup commands via {@link runSetup}. Keep this side-effect-free\n * so it stays safe to call from tests and other programmatic callers.\n *\n * Custom errors thrown by the mutator surface as `errors[]` on the outcome:\n *   - `SetupValidationError` — explicit `{path?, message}[]` entries\n *   - `ExitPromptError` (from `@inquirer/prompts`) — surfaced as \"Cancelled by user\"\n *   - any other `Error` — the message is used verbatim\n */\nexport async function runSetupHeadless(args: RunSetupArgs): Promise<SetupOutcome> {\n  const { configPath, mutator, options } = args;\n\n  let before: Config;\n  try {\n    before = loadConfig(configPath);\n  } catch (error) {\n    return {\n      ok: false,\n      action: mutator.action,\n      domain: mutator.domain,\n      target: mutator.target,\n      changedPaths: [],\n      dryRun: options.dryRun,\n      errors: [{ message: `Failed to load config: ${(error as Error).message}` }],\n    };\n  }\n\n  // `loadConfig` parses through the schema once, but the schema isn't fully\n  // idempotent — re-parsing a result can fill in deeper defaults that the\n  // first pass left undefined. To avoid false-positive diffs against those\n  // defaults, normalize both sides through one extra parse cycle.\n  const baselineParsed = ConfigSchema.safeParse(structuredClone(before));\n  const baseline: Config = baselineParsed.success ? baselineParsed.data : before;\n\n  const cloneBefore = structuredClone(before);\n  let mutated: Config;\n  try {\n    mutated = await mutator.mutate(cloneBefore);\n  } catch (error) {\n    if (isPromptCancelled(error)) {\n      return {\n        ok: false,\n        action: mutator.action,\n        domain: mutator.domain,\n        target: mutator.target,\n        changedPaths: [],\n        dryRun: options.dryRun,\n        errors: [{ message: 'Cancelled by user' }],\n      };\n    }\n    const errors =\n      error instanceof SetupValidationError\n        ? error.errors\n        : [{ message: (error as Error).message }];\n    return {\n      ok: false,\n      action: mutator.action,\n      domain: mutator.domain,\n      target: mutator.target,\n      changedPaths: [],\n      dryRun: options.dryRun,\n      errors,\n    };\n  }\n\n  // Validate the full config (catches invariants beyond the mutator's scope).\n  const parsed = ConfigSchema.safeParse(mutated);\n  if (!parsed.success) {\n    return {\n      ok: false,\n      action: mutator.action,\n      domain: mutator.domain,\n      target: mutator.target,\n      changedPaths: [],\n      dryRun: options.dryRun,\n      errors: zodErrorToSetupErrors(parsed.error),\n    };\n  }\n  const validated = parsed.data;\n\n  const changedPaths = diffConfigPaths(baseline, validated);\n  const action: SetupAction = changedPaths.length === 0 ? 'noop' : mutator.action;\n\n  if (changedPaths.length > 0 && !options.dryRun) {\n    try {\n      await saveConfig(validated, configPath);\n    } catch (error) {\n      return {\n        ok: false,\n        action: mutator.action,\n        domain: mutator.domain,\n        target: mutator.target,\n        changedPaths,\n        dryRun: false,\n        errors: [{ message: `Failed to save config: ${(error as Error).message}` }],\n      };\n    }\n  }\n\n  return {\n    ok: true,\n    action,\n    domain: mutator.domain,\n    target: mutator.target,\n    changedPaths,\n    dryRun: options.dryRun,\n    value: mutator.resultValue?.(validated),\n    notes: mutator.notes?.(validated),\n  };\n}\n\n/**\n * CLI wrapper around {@link runSetupHeadless}: emits the outcome to stdout\n * (text or single-line JSON) and sets `process.exitCode` to the standard\n * setup exit codes (0 ok / 1 error / 2 cancelled).\n *\n * Use this from CLI command actions; use {@link runSetupHeadless} from any\n * non-CLI caller (HTTP routes, library code, tests).\n */\nexport async function runSetup(args: RunSetupArgs): Promise<SetupOutcome> {\n  const outcome = await runSetupHeadless(args);\n  emitOutcome(outcome, args.options.json);\n  if (outcome.ok) {\n    process.exitCode = SETUP_EXIT.OK;\n  } else if (outcome.errors?.some((e) => /cancelled/i.test(e.message))) {\n    process.exitCode = SETUP_EXIT.CANCELLED;\n  } else {\n    process.exitCode = SETUP_EXIT.ERROR;\n  }\n  return outcome;\n}\n"],"mappings":"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"}

package/dist/src/cli/commands/setup-shared/types.d.ts

@@ -14,7 +14,7 @@ export interface SetupError {
 export interface SetupOutcome {
     ok: boolean;
     action: SetupAction;
-    /** Logical domain — `providers`, `channels.telegram`, etc. */
+    /** Logical domain — `providers`, `channels.<id>`, etc. */
     domain: string;
     /** Specific target id within the domain (provider id, account id, etc.). */
     target?: string;

package/dist/src/cli/commands/setup-shared/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../../../../src/cli/commands/setup-shared/types.ts"],"sourcesContent":["/**\n * Shared types for `xopc <domain>` setup-style commands (providers / channels / ...).\n *\n * Every setup command runs the same load → mutate → validate → diff → write\n * pipeline, and emits the same structured outcome so agents (M2 skills) and the\n * WebUI (M3) can consume results uniformly.\n */\n\nexport type SetupAction = 'add' | 'set' | 'remove' | 'noop';\n\nexport interface SetupError {\n  /** Dot path of the offending field, when known (e.g. `providers.openai.apiKey`). */\n  path?: string;\n  message: string;\n}\n\nexport interface SetupOutcome {\n  ok: boolean;\n  action: SetupAction;\n  /** Logical domain — `providers`, `channels.telegram`, etc. */\n  domain: string;\n  /** Specific target id within the domain (provider id, account id, etc.). */\n  target?: string;\n  /** Config dot paths that differ between before and after. */\n  changedPaths: string[];\n  /** True when run with `--dry-run`. Nothing was written. */\n  dryRun: boolean;\n  /** Validation / I/O errors. Empty when ok. */\n  errors?: SetupError[];\n  /** Resulting (masked) value of the mutated entry, for agent / UI display. */\n  value?: unknown;\n  /** Human-readable summary lines for text output. */\n  notes?: string[];\n}\n\nexport interface SetupRunOptions {\n  /** When true, validate + diff but do not write. */\n  dryRun: boolean;\n  /** When true, emit a single JSON line on stdout and stay silent otherwise. */\n  json: boolean;\n}\n\n/**\n * Standardized exit codes for setup-style commands. Set on `process.exitCode`\n * (don't call `process.exit` directly so JSON output flushes cleanly).\n */\nexport const SETUP_EXIT = {\n  OK: 0,\n  ERROR: 1,\n  CANCELLED: 2,\n} as const;\n"],"mappings":";;;;;AA8CA,MAAa,aAAa;CACxB,IAAI;CACJ,OAAO;CACP,WAAW;CACZ"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../../../src/cli/commands/setup-shared/types.ts"],"sourcesContent":["/**\n * Shared types for `xopc <domain>` setup-style commands (providers / channels / ...).\n *\n * Every setup command runs the same load → mutate → validate → diff → write\n * pipeline, and emits the same structured outcome so agents (M2 skills) and the\n * WebUI (M3) can consume results uniformly.\n */\n\nexport type SetupAction = 'add' | 'set' | 'remove' | 'noop';\n\nexport interface SetupError {\n  /** Dot path of the offending field, when known (e.g. `providers.openai.apiKey`). */\n  path?: string;\n  message: string;\n}\n\nexport interface SetupOutcome {\n  ok: boolean;\n  action: SetupAction;\n  /** Logical domain — `providers`, `channels.<id>`, etc. */\n  domain: string;\n  /** Specific target id within the domain (provider id, account id, etc.). */\n  target?: string;\n  /** Config dot paths that differ between before and after. */\n  changedPaths: string[];\n  /** True when run with `--dry-run`. Nothing was written. */\n  dryRun: boolean;\n  /** Validation / I/O errors. Empty when ok. */\n  errors?: SetupError[];\n  /** Resulting (masked) value of the mutated entry, for agent / UI display. */\n  value?: unknown;\n  /** Human-readable summary lines for text output. */\n  notes?: string[];\n}\n\nexport interface SetupRunOptions {\n  /** When true, validate + diff but do not write. */\n  dryRun: boolean;\n  /** When true, emit a single JSON line on stdout and stay silent otherwise. */\n  json: boolean;\n}\n\n/**\n * Standardized exit codes for setup-style commands. Set on `process.exitCode`\n * (don't call `process.exit` directly so JSON output flushes cleanly).\n */\nexport const SETUP_EXIT = {\n  OK: 0,\n  ERROR: 1,\n  CANCELLED: 2,\n} as const;\n"],"mappings":";;;;;AA8CA,MAAa,aAAa;CACxB,IAAI;CACJ,OAAO;CACP,WAAW;CACZ"}

package/dist/src/cli/commands/tui.js

@@ -3,19 +3,26 @@ import { Command } from "commander";
 //#region src/cli/commands/tui.ts
 function createTuiCommand(_ctx) {
 	return new Command("tui").description("Interactive terminal UI (pi-tui)").addHelpText("after", formatExamples([
-		"xopc tui                                    # Connect to local gateway (default)",
-		"xopc tui --local                            # Embedded mode, no gateway needed",
+		"xopc tui                                    # Embedded mode (default)",
+		"xopc tui --gateway                          # Force gateway mode",
+		"xopc tui --local                            # Embedded mode (default)",
 		"xopc tui --url http://host:3120 --token xxx # Connect to remote gateway",
-		"xopc tui -s telegram:dm:123456              # Resume a session",
+		"xopc tui -s agent:main:tui-...              # Resume a session",
 		"xopc tui -m \"Summarize my inbox\"            # Send a message on launch"
-	])).option("--url <url>", "Gateway URL (default: http://localhost:3120)").option("--token <token>", "Gateway bearer token").option("-s, --session <key>", "Session key to resume").option("-m, --message <text>", "Send a message on launch").option("--local", "Run in embedded mode (no gateway required)").option("--theme <name>", "Theme: auto, dark, light, or custom name from ~/.xopc/themes/").option("--thinking <level>", "Thinking level override").action(async (options) => {
+	])).option("--url <url>", "Gateway URL (default: http://localhost:3120)").option("--token <token>", "Gateway bearer token").option("-s, --session <key>", "Session key to resume (omitted: start a fresh TUI session)").option("-m, --message <text>", "Send a message on launch").option("--workdir <dir>", "Workspace directory for the new TUI session").option("--no-cwd", "Do not use the launch directory as the new TUI session workspace").option("--local", "Run in embedded mode (no gateway required)").option("--gateway", "Force gateway mode even without explicit --url or --token").option("--theme <name>", "Theme: auto, dark, light, or custom name from ~/.xopc/themes/").option("--thinking <level>", "Thinking level override").action(async (options) => {
 		const { runTui } = await import("../../tui/tui.js");
+		const useLocal = options.local === true;
+		const useGateway = options.gateway === true || typeof options.url === "string" || typeof options.token === "string";
+		if (useLocal && useGateway) console.log("`--local` and gateway flags both set. Using local mode.");
+		const localMode = useLocal || !useGateway;
 		await runTui({
 			url: typeof options.url === "string" ? options.url : void 0,
 			token: typeof options.token === "string" ? options.token : void 0,
 			session: typeof options.session === "string" ? options.session : void 0,
 			message: typeof options.message === "string" ? options.message : void 0,
-			local: options.local === true,
+			workdir: typeof options.workdir === "string" ? options.workdir : void 0,
+			useStartupCwd: options.cwd !== false,
+			local: localMode,
 			thinking: typeof options.thinking === "string" ? options.thinking : void 0,
 			theme: typeof options.theme === "string" ? options.theme : void 0
 		});
@@ -31,6 +38,7 @@ register({
 		examples: [
 			"xopc tui",
 			"xopc tui --local",
+			"xopc tui --gateway",
 			"xopc tui --url http://host:3120"
 		]
 	}

package/dist/src/cli/commands/tui.js.map

@@ -1 +1 @@
-{"version":3,"file":"tui.js","names":[],"sources":["../../../../src/cli/commands/tui.ts"],"sourcesContent":["import { Command } from 'commander';\n\nimport { register, formatExamples, type CLIContext } from '../registry.js';\n\nfunction createTuiCommand(_ctx: CLIContext): Command {\n  const cmd = new Command('tui')\n    .description('Interactive terminal UI (pi-tui)')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc tui                                    # Connect to local gateway (default)',\n        'xopc tui --local                            # Embedded mode, no gateway needed',\n        'xopc tui --url http://host:3120 --token xxx # Connect to remote gateway',\n        'xopc tui -s telegram:dm:123456              # Resume a session',\n        'xopc tui -m \"Summarize my inbox\"            # Send a message on launch',\n      ]),\n    )\n    .option('--url <url>', 'Gateway URL (default: http://localhost:3120)')\n    .option('--token <token>', 'Gateway bearer token')\n    .option('-s, --session <key>', 'Session key to resume')\n    .option('-m, --message <text>', 'Send a message on launch')\n    .option('--local', 'Run in embedded mode (no gateway required)')\n    .option('--theme <name>', 'Theme: auto, dark, light, or custom name from ~/.xopc/themes/')\n    .option('--thinking <level>', 'Thinking level override')\n    .action(async (options: Record<string, string | boolean | undefined>) => {\n      const { runTui } = await import('../../tui/tui.js');\n      await runTui({\n        url: typeof options.url === 'string' ? options.url : undefined,\n        token: typeof options.token === 'string' ? options.token : undefined,\n        session: typeof options.session === 'string' ? options.session : undefined,\n        message: typeof options.message === 'string' ? options.message : undefined,\n        local: options.local === true,\n        thinking: typeof options.thinking === 'string' ? options.thinking : undefined,\n        theme: typeof options.theme === 'string' ? options.theme : undefined,\n      });\n    });\n\n  return cmd;\n}\n\nregister({\n  id: 'tui',\n  name: 'tui',\n  description: 'Interactive terminal UI (pi-tui)',\n  factory: createTuiCommand,\n  metadata: {\n    category: 'runtime',\n    examples: [\n      'xopc tui',\n      'xopc tui --local',\n      'xopc tui --url http://host:3120',\n    ],\n  },\n});\n"],"mappings":";;;AAIA,SAAS,iBAAiB,MAA2B;AAiCnD,QAhCY,IAAI,QAAQ,MAAM,CAC3B,YAAY,mCAAmC,CAC/C,YACC,SACA,eAAe;EACb;EACA;EACA;EACA;EACA;EACD,CAAC,CACH,CACA,OAAO,eAAe,+CAA+C,CACrE,OAAO,mBAAmB,uBAAuB,CACjD,OAAO,uBAAuB,wBAAwB,CACtD,OAAO,wBAAwB,2BAA2B,CAC1D,OAAO,WAAW,6CAA6C,CAC/D,OAAO,kBAAkB,gEAAgE,CACzF,OAAO,sBAAsB,0BAA0B,CACvD,OAAO,OAAO,YAA0D;EACvE,MAAM,EAAE,WAAW,MAAM,OAAO;AAChC,QAAM,OAAO;GACX,KAAK,OAAO,QAAQ,QAAQ,WAAW,QAAQ,MAAM,KAAA;GACrD,OAAO,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ,KAAA;GAC3D,SAAS,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU,KAAA;GACjE,SAAS,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU,KAAA;GACjE,OAAO,QAAQ,UAAU;GACzB,UAAU,OAAO,QAAQ,aAAa,WAAW,QAAQ,WAAW,KAAA;GACpE,OAAO,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ,KAAA;GAC5D,CAAC;GAGI;;AAGZ,SAAS;CACP,IAAI;CACJ,MAAM;CACN,aAAa;CACb,SAAS;CACT,UAAU;EACR,UAAU;EACV,UAAU;GACR;GACA;GACA;GACD;EACF;CACF,CAAC"}
+{"version":3,"file":"tui.js","names":[],"sources":["../../../../src/cli/commands/tui.ts"],"sourcesContent":["import { Command } from 'commander';\n\nimport { register, formatExamples, type CLIContext } from '../registry.js';\n\nfunction createTuiCommand(_ctx: CLIContext): Command {\n  const cmd = new Command('tui')\n    .description('Interactive terminal UI (pi-tui)')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc tui                                    # Embedded mode (default)',\n        'xopc tui --gateway                          # Force gateway mode',\n        'xopc tui --local                            # Embedded mode (default)',\n        'xopc tui --url http://host:3120 --token xxx # Connect to remote gateway',\n        'xopc tui -s agent:main:tui-...              # Resume a session',\n        'xopc tui -m \"Summarize my inbox\"            # Send a message on launch',\n      ]),\n    )\n    .option('--url <url>', 'Gateway URL (default: http://localhost:3120)')\n    .option('--token <token>', 'Gateway bearer token')\n    .option('-s, --session <key>', 'Session key to resume (omitted: start a fresh TUI session)')\n    .option('-m, --message <text>', 'Send a message on launch')\n    .option('--workdir <dir>', 'Workspace directory for the new TUI session')\n    .option('--no-cwd', 'Do not use the launch directory as the new TUI session workspace')\n    .option('--local', 'Run in embedded mode (no gateway required)')\n    .option('--gateway', 'Force gateway mode even without explicit --url or --token')\n    .option('--theme <name>', 'Theme: auto, dark, light, or custom name from ~/.xopc/themes/')\n    .option('--thinking <level>', 'Thinking level override')\n    .action(async (options: Record<string, string | boolean | undefined>) => {\n      const { runTui } = await import('../../tui/tui.js');\n      const useLocal = options.local === true;\n      const useGateway =\n        options.gateway === true ||\n        typeof options.url === 'string' ||\n        typeof options.token === 'string';\n      if (useLocal && useGateway) {\n        console.log('`--local` and gateway flags both set. Using local mode.');\n      }\n      const localMode = useLocal || !useGateway;\n      await runTui({\n        url: typeof options.url === 'string' ? options.url : undefined,\n        token: typeof options.token === 'string' ? options.token : undefined,\n        session: typeof options.session === 'string' ? options.session : undefined,\n        message: typeof options.message === 'string' ? options.message : undefined,\n        workdir: typeof options.workdir === 'string' ? options.workdir : undefined,\n        useStartupCwd: options.cwd !== false,\n        local: localMode,\n        thinking: typeof options.thinking === 'string' ? options.thinking : undefined,\n        theme: typeof options.theme === 'string' ? options.theme : undefined,\n      });\n    });\n\n  return cmd;\n}\n\nregister({\n  id: 'tui',\n  name: 'tui',\n  description: 'Interactive terminal UI (pi-tui)',\n  factory: createTuiCommand,\n  metadata: {\n    category: 'runtime',\n    examples: [\n      'xopc tui',\n      'xopc tui --local',\n      'xopc tui --gateway',\n      'xopc tui --url http://host:3120',\n    ],\n  },\n});\n"],"mappings":";;;AAIA,SAAS,iBAAiB,MAA2B;AAgDnD,QA/CY,IAAI,QAAQ,MAAM,CAC3B,YAAY,mCAAmC,CAC/C,YACC,SACA,eAAe;EACb;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,CACH,CACA,OAAO,eAAe,+CAA+C,CACrE,OAAO,mBAAmB,uBAAuB,CACjD,OAAO,uBAAuB,6DAA6D,CAC3F,OAAO,wBAAwB,2BAA2B,CAC1D,OAAO,mBAAmB,8CAA8C,CACxE,OAAO,YAAY,mEAAmE,CACtF,OAAO,WAAW,6CAA6C,CAC/D,OAAO,aAAa,4DAA4D,CAChF,OAAO,kBAAkB,gEAAgE,CACzF,OAAO,sBAAsB,0BAA0B,CACvD,OAAO,OAAO,YAA0D;EACvE,MAAM,EAAE,WAAW,MAAM,OAAO;EAChC,MAAM,WAAW,QAAQ,UAAU;EACnC,MAAM,aACJ,QAAQ,YAAY,QACpB,OAAO,QAAQ,QAAQ,YACvB,OAAO,QAAQ,UAAU;AAC3B,MAAI,YAAY,WACd,SAAQ,IAAI,0DAA0D;EAExE,MAAM,YAAY,YAAY,CAAC;AAC/B,QAAM,OAAO;GACX,KAAK,OAAO,QAAQ,QAAQ,WAAW,QAAQ,MAAM,KAAA;GACrD,OAAO,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ,KAAA;GAC3D,SAAS,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU,KAAA;GACjE,SAAS,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU,KAAA;GACjE,SAAS,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU,KAAA;GACjE,eAAe,QAAQ,QAAQ;GAC/B,OAAO;GACP,UAAU,OAAO,QAAQ,aAAa,WAAW,QAAQ,WAAW,KAAA;GACpE,OAAO,OAAO,QAAQ,UAAU,WAAW,QAAQ,QAAQ,KAAA;GAC5D,CAAC;GAGI;;AAGZ,SAAS;CACP,IAAI;CACJ,MAAM;CACN,aAAa;CACb,SAAS;CACT,UAAU;EACR,UAAU;EACV,UAAU;GACR;GACA;GACA;GACA;GACD;EACF;CACF,CAAC"}

package/dist/src/cli/extension-cli-register.js

@@ -1,11 +1,11 @@
 import { loadConfig } from "../config/loader.js";
 import { collectConfiguredChannelIds } from "../extensions/activation-context.js";
-import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import { ExtensionLoader } from "../extensions/loader.js";
 import "../extensions/index.js";
 import { MessageBus } from "../infra/bus/queue.js";
 import "../infra/bus/index.js";
 import { createDefaultContext } from "./registry.js";
+import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/index.js";
 import { registerExtensionCliProgram } from "../extensions/sdk/channel-helpers.js";
 import { join } from "path";

package/dist/src/cli/utils/oauth-login.d.ts

@@ -0,0 +1,17 @@
+import type { OAuthCredentials, OAuthLoginCallbacks, OAuthProviderInterface } from '../../auth/index.js';
+import { type OAuthProviderConfig } from './oauth-providers.js';
+export interface RunCliOAuthLoginOptions {
+    provider: string;
+    onProgress?: (message: string) => void;
+}
+export interface RunCliOAuthLoginResult {
+    provider: string;
+    credentials: OAuthCredentials;
+    expires?: number;
+}
+export declare function buildCliOAuthCallbacks(params: {
+    config: OAuthProviderConfig;
+    provider: OAuthProviderInterface;
+    onProgress?: (message: string) => void;
+}): OAuthLoginCallbacks;
+export declare function runCliOAuthLogin(options: RunCliOAuthLoginOptions): Promise<RunCliOAuthLoginResult>;

package/dist/src/cli/utils/oauth-login.js

@@ -0,0 +1,93 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
+import { getOAuthProvider } from "./oauth-providers.js";
+import { input, select } from "@inquirer/prompts";
+//#region src/cli/utils/oauth-login.ts
+init_credentials();
+init_logger();
+const log = createLogger("OAuthLogin");
+async function openBrowser(url) {
+	const { spawn } = await import("node:child_process");
+	const platform = process.platform;
+	const command = platform === "darwin" ? "open" : platform === "win32" ? "cmd" : "xdg-open";
+	const child = spawn(command, platform === "win32" ? [
+		"/c",
+		"start",
+		"",
+		url
+	] : [url], {
+		stdio: "ignore",
+		detached: true
+	});
+	child.on("error", (err) => {
+		log.debug({
+			err,
+			command
+		}, "Browser open command failed");
+	});
+	child.unref();
+}
+function buildCliOAuthCallbacks(params) {
+	let manualPromptPromise;
+	const promptForManualCode = () => manualPromptPromise ??= input({
+		message: "Paste the authorization code (or full redirect URL):",
+		validate: (value) => value.trim().length > 0 || "Required"
+	});
+	return {
+		onAuth: (info) => {
+			console.log("\n" + params.config.urlPrompt);
+			console.log(info.url);
+			if (info.instructions) console.log("\n" + info.instructions);
+			if (params.provider.usesCallbackServer) console.log("\nWaiting for localhost callback. If it does not complete, paste the final redirect URL below.");
+			openBrowser(info.url);
+			console.log("");
+		},
+		onDeviceCode: (info) => {
+			console.log(`\nOpen ${info.verificationUri} and enter code ${info.userCode}\n`);
+			openBrowser(info.verificationUri);
+		},
+		onPrompt: async (prompt) => input({
+			message: prompt.message,
+			validate: prompt.allowEmpty ? void 0 : (value) => value.trim().length > 0 || "Required"
+		}),
+		onManualCodeInput: params.provider.usesCallbackServer && params.provider.id !== "openai-codex" ? promptForManualCode : void 0,
+		onProgress: (message) => {
+			params.onProgress?.(message);
+		},
+		onSelect: async (prompt) => {
+			return select({
+				message: prompt.message,
+				choices: prompt.options.map((option) => ({
+					value: option.id,
+					name: option.label
+				}))
+			});
+		}
+	};
+}
+async function runCliOAuthLogin(options) {
+	const config = getOAuthProvider(options.provider);
+	if (!config) throw new Error(`OAuth not supported for provider: ${options.provider}`);
+	const credentials = await config.provider.login(buildCliOAuthCallbacks({
+		config,
+		provider: config.provider,
+		onProgress: options.onProgress
+	}));
+	await new CredentialResolver().saveOAuthToken(options.provider, {
+		access: config.provider.getApiKey(credentials),
+		refresh: credentials.refresh,
+		expiresAt: credentials.expires,
+		scope: Array.isArray(credentials.scope) ? credentials.scope.filter((value) => typeof value === "string") : void 0,
+		createdAt: (/* @__PURE__ */ new Date()).toISOString()
+	});
+	return {
+		provider: options.provider,
+		credentials,
+		expires: credentials.expires
+	};
+}
+//#endregion
+export { buildCliOAuthCallbacks, runCliOAuthLogin };
+
+//# sourceMappingURL=oauth-login.js.map

package/dist/src/cli/utils/oauth-login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-login.js","names":[],"sources":["../../../../src/cli/utils/oauth-login.ts"],"sourcesContent":["import { input, select } from '@inquirer/prompts';\n\nimport type { OAuthCredentials, OAuthLoginCallbacks, OAuthProviderInterface } from '../../auth/index.js';\nimport { CredentialResolver } from '../../auth/credentials.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport { getOAuthProvider, type OAuthProviderConfig } from './oauth-providers.js';\n\nconst log = createLogger('OAuthLogin');\n\nexport interface RunCliOAuthLoginOptions {\n  provider: string;\n  onProgress?: (message: string) => void;\n}\n\nexport interface RunCliOAuthLoginResult {\n  provider: string;\n  credentials: OAuthCredentials;\n  expires?: number;\n}\n\nasync function openBrowser(url: string): Promise<void> {\n  const { spawn } = await import('node:child_process');\n  const platform = process.platform;\n  const command = platform === 'darwin' ? 'open' : platform === 'win32' ? 'cmd' : 'xdg-open';\n  const args = platform === 'win32' ? ['/c', 'start', '', url] : [url];\n  const child = spawn(command, args, { stdio: 'ignore', detached: true });\n  child.on('error', (err) => {\n    log.debug({ err, command }, 'Browser open command failed');\n  });\n  child.unref();\n}\n\nexport function buildCliOAuthCallbacks(params: {\n  config: OAuthProviderConfig;\n  provider: OAuthProviderInterface;\n  onProgress?: (message: string) => void;\n}): OAuthLoginCallbacks {\n  let manualPromptPromise: Promise<string> | undefined;\n  const promptForManualCode = () =>\n    (manualPromptPromise ??= input({\n      message: 'Paste the authorization code (or full redirect URL):',\n      validate: (value: string) => value.trim().length > 0 || 'Required',\n    }));\n\n  return {\n    onAuth: (info) => {\n      console.log('\\n' + params.config.urlPrompt);\n      console.log(info.url);\n      if (info.instructions) {\n        console.log('\\n' + info.instructions);\n      }\n      if (params.provider.usesCallbackServer) {\n        console.log('\\nWaiting for localhost callback. If it does not complete, paste the final redirect URL below.');\n      }\n      void openBrowser(info.url);\n      console.log('');\n    },\n    onDeviceCode: (info) => {\n      console.log(`\\nOpen ${info.verificationUri} and enter code ${info.userCode}\\n`);\n      void openBrowser(info.verificationUri);\n    },\n    onPrompt: async (prompt) =>\n      input({\n        message: prompt.message,\n        validate: prompt.allowEmpty ? undefined : (value: string) => value.trim().length > 0 || 'Required',\n      }),\n    onManualCodeInput: params.provider.usesCallbackServer && params.provider.id !== 'openai-codex' ? promptForManualCode : undefined,\n    onProgress: (message) => {\n      params.onProgress?.(message);\n    },\n    onSelect: async (prompt) => {\n      return select({\n        message: prompt.message,\n        choices: prompt.options.map((option) => ({ value: option.id, name: option.label })),\n      });\n    },\n  };\n}\n\nexport async function runCliOAuthLogin(options: RunCliOAuthLoginOptions): Promise<RunCliOAuthLoginResult> {\n  const config = getOAuthProvider(options.provider);\n  if (!config) {\n    throw new Error(`OAuth not supported for provider: ${options.provider}`);\n  }\n\n  const credentials = await config.provider.login(\n    buildCliOAuthCallbacks({ config, provider: config.provider, onProgress: options.onProgress }),\n  );\n\n  const resolver = new CredentialResolver();\n  await resolver.saveOAuthToken(options.provider, {\n    access: config.provider.getApiKey(credentials),\n    refresh: credentials.refresh,\n    expiresAt: credentials.expires,\n    scope: Array.isArray(credentials.scope) ? credentials.scope.filter((value): value is string => typeof value === 'string') : undefined,\n    createdAt: new Date().toISOString(),\n  });\n\n  return { provider: options.provider, credentials, expires: credentials.expires };\n}\n"],"mappings":";;;;;;kBAG+D;aACV;AAIrD,MAAM,MAAM,aAAa,aAAa;AAatC,eAAe,YAAY,KAA4B;CACrD,MAAM,EAAE,UAAU,MAAM,OAAO;CAC/B,MAAM,WAAW,QAAQ;CACzB,MAAM,UAAU,aAAa,WAAW,SAAS,aAAa,UAAU,QAAQ;CAEhF,MAAM,QAAQ,MAAM,SADP,aAAa,UAAU;EAAC;EAAM;EAAS;EAAI;EAAI,GAAG,CAAC,IAAI,EACjC;EAAE,OAAO;EAAU,UAAU;EAAM,CAAC;AACvE,OAAM,GAAG,UAAU,QAAQ;AACzB,MAAI,MAAM;GAAE;GAAK;GAAS,EAAE,8BAA8B;GAC1D;AACF,OAAM,OAAO;;AAGf,SAAgB,uBAAuB,QAIf;CACtB,IAAI;CACJ,MAAM,4BACH,wBAAwB,MAAM;EAC7B,SAAS;EACT,WAAW,UAAkB,MAAM,MAAM,CAAC,SAAS,KAAK;EACzD,CAAC;AAEJ,QAAO;EACL,SAAS,SAAS;AAChB,WAAQ,IAAI,OAAO,OAAO,OAAO,UAAU;AAC3C,WAAQ,IAAI,KAAK,IAAI;AACrB,OAAI,KAAK,aACP,SAAQ,IAAI,OAAO,KAAK,aAAa;AAEvC,OAAI,OAAO,SAAS,mBAClB,SAAQ,IAAI,iGAAiG;AAE1G,eAAY,KAAK,IAAI;AAC1B,WAAQ,IAAI,GAAG;;EAEjB,eAAe,SAAS;AACtB,WAAQ,IAAI,UAAU,KAAK,gBAAgB,kBAAkB,KAAK,SAAS,IAAI;AAC1E,eAAY,KAAK,gBAAgB;;EAExC,UAAU,OAAO,WACf,MAAM;GACJ,SAAS,OAAO;GAChB,UAAU,OAAO,aAAa,KAAA,KAAa,UAAkB,MAAM,MAAM,CAAC,SAAS,KAAK;GACzF,CAAC;EACJ,mBAAmB,OAAO,SAAS,sBAAsB,OAAO,SAAS,OAAO,iBAAiB,sBAAsB,KAAA;EACvH,aAAa,YAAY;AACvB,UAAO,aAAa,QAAQ;;EAE9B,UAAU,OAAO,WAAW;AAC1B,UAAO,OAAO;IACZ,SAAS,OAAO;IAChB,SAAS,OAAO,QAAQ,KAAK,YAAY;KAAE,OAAO,OAAO;KAAI,MAAM,OAAO;KAAO,EAAE;IACpF,CAAC;;EAEL;;AAGH,eAAsB,iBAAiB,SAAmE;CACxG,MAAM,SAAS,iBAAiB,QAAQ,SAAS;AACjD,KAAI,CAAC,OACH,OAAM,IAAI,MAAM,qCAAqC,QAAQ,WAAW;CAG1E,MAAM,cAAc,MAAM,OAAO,SAAS,MACxC,uBAAuB;EAAE;EAAQ,UAAU,OAAO;EAAU,YAAY,QAAQ;EAAY,CAAC,CAC9F;AAGD,OAAM,IADe,oBACP,CAAC,eAAe,QAAQ,UAAU;EAC9C,QAAQ,OAAO,SAAS,UAAU,YAAY;EAC9C,SAAS,YAAY;EACrB,WAAW,YAAY;EACvB,OAAO,MAAM,QAAQ,YAAY,MAAM,GAAG,YAAY,MAAM,QAAQ,UAA2B,OAAO,UAAU,SAAS,GAAG,KAAA;EAC5H,4BAAW,IAAI,MAAM,EAAC,aAAa;EACpC,CAAC;AAEF,QAAO;EAAE,UAAU,QAAQ;EAAU;EAAa,SAAS,YAAY;EAAS"}

package/dist/src/cli/utils/oauth-providers.js

@@ -3,8 +3,8 @@ import { minimaxOAuthProvider } from "../../auth/oauth/minimax.js";
 import { minimaxCnOAuthProvider } from "../../auth/oauth/minimax-cn.js";
 import { kimiCodingOAuthProvider } from "../../auth/oauth/kimi-coding.js";
 import { githubCopilotOAuthProvider } from "../../auth/oauth/github-copilot.js";
-import { geminiCliOAuthProvider } from "../../auth/oauth/vendor-pi-google/google-gemini-cli.js";
-import { antigravityOAuthProvider } from "../../auth/oauth/vendor-pi-google/google-antigravity.js";
+import { geminiCliOAuthProvider } from "../../auth/oauth/google-oauth/google-gemini-cli.js";
+import { antigravityOAuthProvider } from "../../auth/oauth/google-oauth/google-antigravity.js";
 import { openaiCodexOAuthProvider } from "../../auth/oauth/openai-codex.js";
 import "../../auth/oauth/index.js";
 //#region src/cli/utils/oauth-providers.ts

package/dist/src/commands/agents.config.d.ts

@@ -2,18 +2,18 @@
  * Mutate `agents.list` / bindings when adding or removing agents.
  */
 import type { Config } from '../config/schema.js';
-import type { LocalizedText } from '../config/localized-text.js';
 import { listAgentEntries } from '../agent/agent-scope.js';
 type AgentEntry = NonNullable<NonNullable<Config['agents']>['list']>[number];
 export { listAgentEntries };
 export declare function findAgentEntryIndex(list: AgentEntry[], agentId: string): number;
 export declare function applyAgentConfig(cfg: Config, params: {
     agentId: string;
-    name?: LocalizedText;
-    description?: LocalizedText;
     workspace?: string;
     agentDir?: string;
     model?: string;
+    models?: AgentEntry['models'];
+    skills?: string[];
+    tools?: AgentEntry['tools'];
 }): Config;
 export declare function pruneAgentConfig(cfg: Config, agentId: string): {
     config: Config;

package/dist/src/commands/agents.config.js

@@ -1,12 +1,10 @@
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentHomeDir, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
-import { init_localized_text, normalizeLocalizedText } from "../config/localized-text.js";
 import { existsSync } from "node:fs";
 import { rm } from "node:fs/promises";
 //#region src/commands/agents.config.ts
 /**
 * Mutate `agents.list` / bindings when adding or removing agents.
 */
-init_localized_text();
 init_agent_scope();
 function findAgentEntryIndex(list, agentId) {
 	const id = normalizeAgentId(agentId);
@@ -14,8 +12,6 @@ function findAgentEntryIndex(list, agentId) {
 }
 function applyAgentConfig(cfg, params) {
 	const agentId = normalizeAgentId(params.agentId);
-	const name = normalizeLocalizedText(params.name);
-	const description = normalizeLocalizedText(params.description);
 	const list = listAgentEntries(cfg);
 	const index = findAgentEntryIndex(list, agentId);
 	const base = index >= 0 ? list[index] : {
@@ -25,11 +21,15 @@ function applyAgentConfig(cfg, params) {
 	const nextEntry = {
 		...base,
 		enabled: base.enabled ?? true,
-		...name ? { name } : {},
-		...description ? { description } : {},
 		...params.workspace ? { workspace: params.workspace } : {},
 		...params.agentDir ? { agentDir: params.agentDir } : {},
-		...params.model ? { model: { primary: params.model } } : {}
+		...params.models ? { models: params.models } : {},
+		...params.model ? { models: {
+			...base.models,
+			chat: { primary: params.model }
+		} } : {},
+		...params.skills ? { skills: params.skills } : {},
+		...params.tools ? { tools: params.tools } : {}
 	};
 	const nextList = [...list];
 	if (index >= 0) nextList[index] = nextEntry;

package/dist/src/commands/agents.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.config.js","names":[],"sources":["../../../src/commands/agents.config.ts"],"sourcesContent":["/**\n * Mutate `agents.list` / bindings when adding or removing agents.\n */\n\nimport { rm } from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\n\nimport type { Config } from '../config/schema.js';\nimport type { LocalizedText } from '../config/localized-text.js';\nimport { normalizeLocalizedText } from '../config/localized-text.js';\nimport {\n  listAgentEntries,\n  normalizeAgentId,\n  resolveAgentHomeDir,\n  resolveAgentWorkspaceDir,\n  resolveDefaultAgentId,\n  DEFAULT_AGENT_ID,\n} from '../agent/agent-scope.js';\n\ntype AgentEntry = NonNullable<NonNullable<Config['agents']>['list']>[number];\n\nexport { listAgentEntries };\n\nexport function findAgentEntryIndex(list: AgentEntry[], agentId: string): number {\n  const id = normalizeAgentId(agentId);\n  return list.findIndex((e) => normalizeAgentId(e.id) === id);\n}\n\nexport function applyAgentConfig(\n  cfg: Config,\n  params: {\n    agentId: string;\n    name?: LocalizedText;\n    description?: LocalizedText;\n    workspace?: string;\n    agentDir?: string;\n    model?: string;\n  },\n): Config {\n  const agentId = normalizeAgentId(params.agentId);\n  const name = normalizeLocalizedText(params.name);\n  const description = normalizeLocalizedText(params.description);\n  const list = listAgentEntries(cfg);\n  const index = findAgentEntryIndex(list, agentId);\n  const base = index >= 0 ? list[index] : { id: agentId, enabled: true as const };\n  const nextEntry: AgentEntry = {\n    ...base,\n    enabled: base.enabled ?? true,\n    ...(name ? { name } : {}),\n    ...(description ? { description } : {}),\n    ...(params.workspace ? { workspace: params.workspace } : {}),\n    ...(params.agentDir ? { agentDir: params.agentDir } : {}),\n    ...(params.model ? { model: { primary: params.model } } : {}),\n  };\n  const nextList = [...list];\n  if (index >= 0) {\n    nextList[index] = nextEntry;\n  } else {\n    if (nextList.length === 0 && agentId !== normalizeAgentId(resolveDefaultAgentId(cfg))) {\n      nextList.push({ id: resolveDefaultAgentId(cfg), enabled: true });\n    }\n    nextList.push(nextEntry);\n  }\n  return {\n    ...cfg,\n    agents: {\n      ...cfg.agents,\n      list: nextList,\n    },\n  };\n}\n\nexport function pruneAgentConfig(\n  cfg: Config,\n  agentId: string,\n): { config: Config; removedBindings: number } {\n  const id = normalizeAgentId(agentId);\n  const agents = listAgentEntries(cfg);\n  const nextAgentsList = agents.filter((e) => normalizeAgentId(e.id) !== id);\n  const nextAgents = nextAgentsList.length > 0 ? nextAgentsList : undefined;\n\n  const bindings = cfg.bindings ?? [];\n  const filteredBindings = bindings.filter((b) => normalizeAgentId(b.agentId) !== id);\n\n  return {\n    config: {\n      ...cfg,\n      agents: nextAgents ? { ...cfg.agents, list: nextAgents } : { ...cfg.agents, list: undefined },\n      bindings: filteredBindings,\n    },\n    removedBindings: bindings.length - filteredBindings.length,\n  };\n}\n\nexport async function removeAgentDirsFromDisk(cfg: Config, id: string): Promise<void> {\n  const aid = normalizeAgentId(id);\n  if (aid === DEFAULT_AGENT_ID) {\n    throw new Error('Refusing to delete the main agent home on disk from this command.');\n  }\n  const home = resolveAgentHomeDir(cfg, aid);\n  const ws = resolveAgentWorkspaceDir(cfg, aid);\n  if (existsSync(home)) {\n    await rm(home, { recursive: true, force: true });\n  }\n  if (existsSync(ws) && ws !== home) {\n    await rm(ws, { recursive: true, force: true });\n  }\n}\n"],"mappings":";;;;;;;;qBASqE;kBAQpC;AAMjC,SAAgB,oBAAoB,MAAoB,SAAyB;CAC/E,MAAM,KAAK,iBAAiB,QAAQ;AACpC,QAAO,KAAK,WAAW,MAAM,iBAAiB,EAAE,GAAG,KAAK,GAAG;;AAG7D,SAAgB,iBACd,KACA,QAQQ;CACR,MAAM,UAAU,iBAAiB,OAAO,QAAQ;CAChD,MAAM,OAAO,uBAAuB,OAAO,KAAK;CAChD,MAAM,cAAc,uBAAuB,OAAO,YAAY;CAC9D,MAAM,OAAO,iBAAiB,IAAI;CAClC,MAAM,QAAQ,oBAAoB,MAAM,QAAQ;CAChD,MAAM,OAAO,SAAS,IAAI,KAAK,SAAS;EAAE,IAAI;EAAS,SAAS;EAAe;CAC/E,MAAM,YAAwB;EAC5B,GAAG;EACH,SAAS,KAAK,WAAW;EACzB,GAAI,OAAO,EAAE,MAAM,GAAG,EAAE;EACxB,GAAI,cAAc,EAAE,aAAa,GAAG,EAAE;EACtC,GAAI,OAAO,YAAY,EAAE,WAAW,OAAO,WAAW,GAAG,EAAE;EAC3D,GAAI,OAAO,WAAW,EAAE,UAAU,OAAO,UAAU,GAAG,EAAE;EACxD,GAAI,OAAO,QAAQ,EAAE,OAAO,EAAE,SAAS,OAAO,OAAO,EAAE,GAAG,EAAE;EAC7D;CACD,MAAM,WAAW,CAAC,GAAG,KAAK;AAC1B,KAAI,SAAS,EACX,UAAS,SAAS;MACb;AACL,MAAI,SAAS,WAAW,KAAK,YAAY,iBAAiB,sBAAsB,IAAI,CAAC,CACnF,UAAS,KAAK;GAAE,IAAI,sBAAsB,IAAI;GAAE,SAAS;GAAM,CAAC;AAElE,WAAS,KAAK,UAAU;;AAE1B,QAAO;EACL,GAAG;EACH,QAAQ;GACN,GAAG,IAAI;GACP,MAAM;GACP;EACF;;AAGH,SAAgB,iBACd,KACA,SAC6C;CAC7C,MAAM,KAAK,iBAAiB,QAAQ;CAEpC,MAAM,iBADS,iBAAiB,IACH,CAAC,QAAQ,MAAM,iBAAiB,EAAE,GAAG,KAAK,GAAG;CAC1E,MAAM,aAAa,eAAe,SAAS,IAAI,iBAAiB,KAAA;CAEhE,MAAM,WAAW,IAAI,YAAY,EAAE;CACnC,MAAM,mBAAmB,SAAS,QAAQ,MAAM,iBAAiB,EAAE,QAAQ,KAAK,GAAG;AAEnF,QAAO;EACL,QAAQ;GACN,GAAG;GACH,QAAQ,aAAa;IAAE,GAAG,IAAI;IAAQ,MAAM;IAAY,GAAG;IAAE,GAAG,IAAI;IAAQ,MAAM,KAAA;IAAW;GAC7F,UAAU;GACX;EACD,iBAAiB,SAAS,SAAS,iBAAiB;EACrD;;AAGH,eAAsB,wBAAwB,KAAa,IAA2B;CACpF,MAAM,MAAM,iBAAiB,GAAG;AAChC,KAAI,QAAA,OACF,OAAM,IAAI,MAAM,oEAAoE;CAEtF,MAAM,OAAO,oBAAoB,KAAK,IAAI;CAC1C,MAAM,KAAK,yBAAyB,KAAK,IAAI;AAC7C,KAAI,WAAW,KAAK,CAClB,OAAM,GAAG,MAAM;EAAE,WAAW;EAAM,OAAO;EAAM,CAAC;AAElD,KAAI,WAAW,GAAG,IAAI,OAAO,KAC3B,OAAM,GAAG,IAAI;EAAE,WAAW;EAAM,OAAO;EAAM,CAAC"}
+{"version":3,"file":"agents.config.js","names":[],"sources":["../../../src/commands/agents.config.ts"],"sourcesContent":["/**\n * Mutate `agents.list` / bindings when adding or removing agents.\n */\n\nimport { rm } from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\n\nimport type { Config } from '../config/schema.js';\nimport {\n  listAgentEntries,\n  normalizeAgentId,\n  resolveAgentHomeDir,\n  resolveAgentWorkspaceDir,\n  resolveDefaultAgentId,\n  DEFAULT_AGENT_ID,\n} from '../agent/agent-scope.js';\n\ntype AgentEntry = NonNullable<NonNullable<Config['agents']>['list']>[number];\n\nexport { listAgentEntries };\n\nexport function findAgentEntryIndex(list: AgentEntry[], agentId: string): number {\n  const id = normalizeAgentId(agentId);\n  return list.findIndex((e) => normalizeAgentId(e.id) === id);\n}\n\nexport function applyAgentConfig(\n  cfg: Config,\n  params: {\n    agentId: string;\n    workspace?: string;\n    agentDir?: string;\n    model?: string;\n    models?: AgentEntry['models'];\n    skills?: string[];\n    tools?: AgentEntry['tools'];\n  },\n): Config {\n  const agentId = normalizeAgentId(params.agentId);\n  const list = listAgentEntries(cfg);\n  const index = findAgentEntryIndex(list, agentId);\n  const base = index >= 0 ? list[index] : { id: agentId, enabled: true as const };\n  const nextEntry: AgentEntry = {\n    ...base,\n    enabled: base.enabled ?? true,\n    ...(params.workspace ? { workspace: params.workspace } : {}),\n    ...(params.agentDir ? { agentDir: params.agentDir } : {}),\n    ...(params.models ? { models: params.models } : {}),\n    ...(params.model ? { models: { ...base.models, chat: { primary: params.model } } } : {}),\n    ...(params.skills ? { skills: params.skills } : {}),\n    ...(params.tools ? { tools: params.tools } : {}),\n  };\n  const nextList = [...list];\n  if (index >= 0) {\n    nextList[index] = nextEntry;\n  } else {\n    if (nextList.length === 0 && agentId !== normalizeAgentId(resolveDefaultAgentId(cfg))) {\n      nextList.push({ id: resolveDefaultAgentId(cfg), enabled: true });\n    }\n    nextList.push(nextEntry);\n  }\n  return {\n    ...cfg,\n    agents: {\n      ...cfg.agents,\n      list: nextList,\n    },\n  };\n}\n\nexport function pruneAgentConfig(\n  cfg: Config,\n  agentId: string,\n): { config: Config; removedBindings: number } {\n  const id = normalizeAgentId(agentId);\n  const agents = listAgentEntries(cfg);\n  const nextAgentsList = agents.filter((e) => normalizeAgentId(e.id) !== id);\n  const nextAgents = nextAgentsList.length > 0 ? nextAgentsList : undefined;\n\n  const bindings = cfg.bindings ?? [];\n  const filteredBindings = bindings.filter((b) => normalizeAgentId(b.agentId) !== id);\n\n  return {\n    config: {\n      ...cfg,\n      agents: nextAgents ? { ...cfg.agents, list: nextAgents } : { ...cfg.agents, list: undefined },\n      bindings: filteredBindings,\n    },\n    removedBindings: bindings.length - filteredBindings.length,\n  };\n}\n\nexport async function removeAgentDirsFromDisk(cfg: Config, id: string): Promise<void> {\n  const aid = normalizeAgentId(id);\n  if (aid === DEFAULT_AGENT_ID) {\n    throw new Error('Refusing to delete the main agent home on disk from this command.');\n  }\n  const home = resolveAgentHomeDir(cfg, aid);\n  const ws = resolveAgentWorkspaceDir(cfg, aid);\n  if (existsSync(home)) {\n    await rm(home, { recursive: true, force: true });\n  }\n  if (existsSync(ws) && ws !== home) {\n    await rm(ws, { recursive: true, force: true });\n  }\n}\n"],"mappings":";;;;;;;kBAeiC;AAMjC,SAAgB,oBAAoB,MAAoB,SAAyB;CAC/E,MAAM,KAAK,iBAAiB,QAAQ;AACpC,QAAO,KAAK,WAAW,MAAM,iBAAiB,EAAE,GAAG,KAAK,GAAG;;AAG7D,SAAgB,iBACd,KACA,QASQ;CACR,MAAM,UAAU,iBAAiB,OAAO,QAAQ;CAChD,MAAM,OAAO,iBAAiB,IAAI;CAClC,MAAM,QAAQ,oBAAoB,MAAM,QAAQ;CAChD,MAAM,OAAO,SAAS,IAAI,KAAK,SAAS;EAAE,IAAI;EAAS,SAAS;EAAe;CAC/E,MAAM,YAAwB;EAC5B,GAAG;EACH,SAAS,KAAK,WAAW;EACzB,GAAI,OAAO,YAAY,EAAE,WAAW,OAAO,WAAW,GAAG,EAAE;EAC3D,GAAI,OAAO,WAAW,EAAE,UAAU,OAAO,UAAU,GAAG,EAAE;EACxD,GAAI,OAAO,SAAS,EAAE,QAAQ,OAAO,QAAQ,GAAG,EAAE;EAClD,GAAI,OAAO,QAAQ,EAAE,QAAQ;GAAE,GAAG,KAAK;GAAQ,MAAM,EAAE,SAAS,OAAO,OAAO;GAAE,EAAE,GAAG,EAAE;EACvF,GAAI,OAAO,SAAS,EAAE,QAAQ,OAAO,QAAQ,GAAG,EAAE;EAClD,GAAI,OAAO,QAAQ,EAAE,OAAO,OAAO,OAAO,GAAG,EAAE;EAChD;CACD,MAAM,WAAW,CAAC,GAAG,KAAK;AAC1B,KAAI,SAAS,EACX,UAAS,SAAS;MACb;AACL,MAAI,SAAS,WAAW,KAAK,YAAY,iBAAiB,sBAAsB,IAAI,CAAC,CACnF,UAAS,KAAK;GAAE,IAAI,sBAAsB,IAAI;GAAE,SAAS;GAAM,CAAC;AAElE,WAAS,KAAK,UAAU;;AAE1B,QAAO;EACL,GAAG;EACH,QAAQ;GACN,GAAG,IAAI;GACP,MAAM;GACP;EACF;;AAGH,SAAgB,iBACd,KACA,SAC6C;CAC7C,MAAM,KAAK,iBAAiB,QAAQ;CAEpC,MAAM,iBADS,iBAAiB,IACH,CAAC,QAAQ,MAAM,iBAAiB,EAAE,GAAG,KAAK,GAAG;CAC1E,MAAM,aAAa,eAAe,SAAS,IAAI,iBAAiB,KAAA;CAEhE,MAAM,WAAW,IAAI,YAAY,EAAE;CACnC,MAAM,mBAAmB,SAAS,QAAQ,MAAM,iBAAiB,EAAE,QAAQ,KAAK,GAAG;AAEnF,QAAO;EACL,QAAQ;GACN,GAAG;GACH,QAAQ,aAAa;IAAE,GAAG,IAAI;IAAQ,MAAM;IAAY,GAAG;IAAE,GAAG,IAAI;IAAQ,MAAM,KAAA;IAAW;GAC7F,UAAU;GACX;EACD,iBAAiB,SAAS,SAAS,iBAAiB;EACrD;;AAGH,eAAsB,wBAAwB,KAAa,IAA2B;CACpF,MAAM,MAAM,iBAAiB,GAAG;AAChC,KAAI,QAAA,OACF,OAAM,IAAI,MAAM,oEAAoE;CAEtF,MAAM,OAAO,oBAAoB,KAAK,IAAI;CAC1C,MAAM,KAAK,yBAAyB,KAAK,IAAI;AAC7C,KAAI,WAAW,KAAK,CAClB,OAAM,GAAG,MAAM;EAAE,WAAW;EAAM,OAAO;EAAM,CAAC;AAElD,KAAI,WAAW,GAAG,IAAI,OAAO,KAC3B,OAAM,GAAG,IAAI;EAAE,WAAW;EAAM,OAAO;EAAM,CAAC"}

package/dist/src/config/agent-profile.d.ts

@@ -22,7 +22,7 @@ export interface EffectiveAgentProfile {
     reasoningDefault?: ReasoningLevel;
     verboseDefault?: VerboseLevel;
     systemPromptOverride?: string;
-    /** When set, only these skill names appear in `<available_skills>`. */
+    /** Skill names visible in `<available_skills>`; undefined means all enabled skills, empty means none. */
     skillsAllowlist?: string[];
     tools: EffectiveAgentTools;
     params: Record<string, unknown>;

package/dist/src/config/agent-profile.js

@@ -35,6 +35,10 @@ function mergeDisableLists(a, b) {
 	}
 	return out;
 }
+function resolveSkillsAllowlist(defaultsSkills, entrySkills) {
+	if (entrySkills !== void 0) return [...entrySkills];
+	if (defaultsSkills !== void 0) return [...defaultsSkills];
+}
 /**
 * Agent id used for config lookup from a session key (subagent keys → default agent).
 */
@@ -54,7 +58,7 @@ function resolveEffectiveAgentProfile(config, agentId) {
 	const list = config.agents?.list;
 	const entry = Array.isArray(list) ? list.find((a) => a && a.enabled !== false && a.id.toLowerCase() === agentId.toLowerCase()) : void 0;
 	const resolvedWorkspacePath = resolveAgentWorkspaceDir(config, agentId);
-	const { primary: primaryFromMerged, fallbacks: fallbacksFromMerged } = primaryAndFallbacksFromModelConfig(mergeModelConfig(defaults?.model, entry?.model));
+	const { primary: primaryFromMerged, fallbacks: fallbacksFromMerged } = primaryAndFallbacksFromModelConfig(mergeModelConfig(defaults?.models?.chat, entry?.models?.chat));
 	const globalDefault = getAgentDefaultModelRef(config);
 	const primaryModelRef = primaryFromMerged?.trim() || globalDefault;
 	const disable = mergeDisableLists(defaults?.tools?.disable, entry?.tools?.disable);
@@ -71,7 +75,7 @@ function resolveEffectiveAgentProfile(config, agentId) {
 		reasoningDefault: entry?.reasoningDefault ?? defaults?.reasoningDefault,
 		verboseDefault: entry?.verboseDefault ?? defaults?.verboseDefault,
 		systemPromptOverride: entry?.systemPromptOverride?.trim() ? entry.systemPromptOverride : defaults?.systemPromptOverride?.trim() ? defaults.systemPromptOverride : void 0,
-		skillsAllowlist: entry?.skills?.length ? [...entry.skills] : defaults?.skills?.length ? [...defaults.skills] : void 0,
+		skillsAllowlist: resolveSkillsAllowlist(defaults?.skills, entry?.skills),
 		tools: { disable },
 		params
 	};

package/dist/src/config/agent-profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-profile.js","names":[],"sources":["../../../src/config/agent-profile.ts"],"sourcesContent":["/**\n * Effective agent profile: merges `agents.defaults` with `agents.list` entry.\n * Subagent session keys fall back to the configured default agent id for profile lookup.\n */\n\nimport type { ThinkLevel, ReasoningLevel, VerboseLevel } from '../agent/transcript/thinking-types.js';\nimport type { Config } from './schema.js';\nimport type { AgentModelConfig } from './schema.js';\nimport { getAgentDefaultModelRef } from './schema.js';\nimport { resolveAgentWorkspaceDir } from '../agent/agent-scope.js';\nimport { getDefaultAgentId, agentExists } from '../routing/resolve-route.js';\nimport { parseSessionKey } from '../routing/session-key.js';\n\nexport { resolveAgentWorkspaceDir } from '../agent/agent-scope.js';\n\nexport type { AgentModelConfig };\n\nexport interface EffectiveAgentTools {\n  /** Tool names to exclude (merged: union of defaults + list entry disables). */\n  disable: Set<string>;\n}\n\nexport interface EffectiveAgentProfile {\n  agentId: string;\n  /** Resolved absolute Markdown workspace path (tool cwd, attachments, daily memory/, …). */\n  resolvedWorkspacePath: string;\n  /** Primary model ref (provider/model); may be empty → runtime default. */\n  primaryModelRef: string | undefined;\n  fallbacks: string[];\n  thinkingDefault?: ThinkLevel;\n  reasoningDefault?: ReasoningLevel;\n  verboseDefault?: VerboseLevel;\n  systemPromptOverride?: string;\n  /** When set, only these skill names appear in `<available_skills>`. */\n  skillsAllowlist?: string[];\n  tools: EffectiveAgentTools;\n  params: Record<string, unknown>;\n}\n\nfunction mergeModelConfig(\n  base: AgentModelConfig | undefined,\n  override: AgentModelConfig | undefined,\n): AgentModelConfig | undefined {\n  if (override === undefined) return base;\n  if (base === undefined) return override;\n  return {\n    primary: override.primary ?? base.primary,\n    fallbacks: override.fallbacks ?? base.fallbacks,\n  };\n}\n\nfunction primaryAndFallbacksFromModelConfig(\n  raw: AgentModelConfig | undefined,\n): { primary?: string; fallbacks: string[] } {\n  const primary = raw?.primary?.trim();\n  const fallbacks = Array.isArray(raw?.fallbacks)\n    ? raw.fallbacks.map((s) => s.trim()).filter(Boolean)\n    : [];\n  return { primary: primary || undefined, fallbacks };\n}\n\nfunction mergeDisableLists(a?: string[], b?: string[]): Set<string> {\n  const out = new Set<string>();\n  for (const x of a ?? []) {\n    const s = String(x).trim();\n    if (s) {\n      out.add(s);\n    }\n  }\n  for (const x of b ?? []) {\n    const s = String(x).trim();\n    if (s) {\n      out.add(s);\n    }\n  }\n  return out;\n}\n\n/**\n * Agent id used for config lookup from a session key (subagent keys → default agent).\n */\nexport function extractProfileAgentId(sessionKey: string | undefined | null, config: Config): string {\n  const parsed = parseSessionKey(sessionKey ?? '');\n  if (!parsed) {\n    return getDefaultAgentId(config);\n  }\n  const aid = parsed.agentId;\n  if (aid === 'subagent' || aid.startsWith('subagent:')) {\n    return getDefaultAgentId(config);\n  }\n  if (!agentExists(aid, config)) {\n    return getDefaultAgentId(config);\n  }\n  return aid.toLowerCase();\n}\n\n/**\n * Merge `agents.defaults` with the matching `agents.list` entry.\n */\nexport function resolveEffectiveAgentProfile(config: Config, agentId: string): EffectiveAgentProfile {\n  const defaults = config.agents?.defaults;\n  const list = config.agents?.list;\n  const entry = Array.isArray(list)\n    ? list.find((a) => a && a.enabled !== false && a.id.toLowerCase() === agentId.toLowerCase())\n    : undefined;\n\n  const resolvedWorkspacePath = resolveAgentWorkspaceDir(config, agentId);\n\n  const mergedModel = mergeModelConfig(defaults?.model, entry?.model);\n  const { primary: primaryFromMerged, fallbacks: fallbacksFromMerged } = primaryAndFallbacksFromModelConfig(mergedModel);\n  const globalDefault = getAgentDefaultModelRef(config);\n  const primaryModelRef = primaryFromMerged?.trim() || globalDefault;\n\n  const disable = mergeDisableLists(\n    defaults?.tools?.disable as string[] | undefined,\n    entry?.tools?.disable as string[] | undefined,\n  );\n\n  const params: Record<string, unknown> = {\n    ...(defaults?.params as Record<string, unknown> | undefined),\n    ...(entry?.params as Record<string, unknown> | undefined),\n  };\n\n  return {\n    agentId: agentId.toLowerCase(),\n    resolvedWorkspacePath,\n    primaryModelRef,\n    fallbacks: fallbacksFromMerged,\n    thinkingDefault: entry?.thinkingDefault ?? defaults?.thinkingDefault,\n    reasoningDefault: entry?.reasoningDefault ?? defaults?.reasoningDefault,\n    verboseDefault: entry?.verboseDefault ?? defaults?.verboseDefault,\n    systemPromptOverride: entry?.systemPromptOverride?.trim()\n      ? entry.systemPromptOverride\n      : defaults?.systemPromptOverride?.trim()\n        ? defaults.systemPromptOverride\n        : undefined,\n    skillsAllowlist: entry?.skills?.length ? [...entry.skills] : defaults?.skills?.length ? [...defaults.skills] : undefined,\n    tools: { disable },\n    params,\n  };\n}\n\nexport function resolveEffectiveAgentProfileForSession(\n  config: Config,\n  sessionKey: string | undefined | null,\n): EffectiveAgentProfile {\n  const id = extractProfileAgentId(sessionKey, config);\n  return resolveEffectiveAgentProfile(config, id);\n}\n"],"mappings":";;;;;aAQsD;kBACa;oBACU;kBACjB;AA4B5D,SAAS,iBACP,MACA,UAC8B;AAC9B,KAAI,aAAa,KAAA,EAAW,QAAO;AACnC,KAAI,SAAS,KAAA,EAAW,QAAO;AAC/B,QAAO;EACL,SAAS,SAAS,WAAW,KAAK;EAClC,WAAW,SAAS,aAAa,KAAK;EACvC;;AAGH,SAAS,mCACP,KAC2C;CAC3C,MAAM,UAAU,KAAK,SAAS,MAAM;CACpC,MAAM,YAAY,MAAM,QAAQ,KAAK,UAAU,GAC3C,IAAI,UAAU,KAAK,MAAM,EAAE,MAAM,CAAC,CAAC,OAAO,QAAQ,GAClD,EAAE;AACN,QAAO;EAAE,SAAS,WAAW,KAAA;EAAW;EAAW;;AAGrD,SAAS,kBAAkB,GAAc,GAA2B;CAClE,MAAM,sBAAM,IAAI,KAAa;AAC7B,MAAK,MAAM,KAAK,KAAK,EAAE,EAAE;EACvB,MAAM,IAAI,OAAO,EAAE,CAAC,MAAM;AAC1B,MAAI,EACF,KAAI,IAAI,EAAE;;AAGd,MAAK,MAAM,KAAK,KAAK,EAAE,EAAE;EACvB,MAAM,IAAI,OAAO,EAAE,CAAC,MAAM;AAC1B,MAAI,EACF,KAAI,IAAI,EAAE;;AAGd,QAAO;;;;;AAMT,SAAgB,sBAAsB,YAAuC,QAAwB;CACnG,MAAM,SAAS,gBAAgB,cAAc,GAAG;AAChD,KAAI,CAAC,OACH,QAAO,kBAAkB,OAAO;CAElC,MAAM,MAAM,OAAO;AACnB,KAAI,QAAQ,cAAc,IAAI,WAAW,YAAY,CACnD,QAAO,kBAAkB,OAAO;AAElC,KAAI,CAAC,YAAY,KAAK,OAAO,CAC3B,QAAO,kBAAkB,OAAO;AAElC,QAAO,IAAI,aAAa;;;;;AAM1B,SAAgB,6BAA6B,QAAgB,SAAwC;CACnG,MAAM,WAAW,OAAO,QAAQ;CAChC,MAAM,OAAO,OAAO,QAAQ;CAC5B,MAAM,QAAQ,MAAM,QAAQ,KAAK,GAC7B,KAAK,MAAM,MAAM,KAAK,EAAE,YAAY,SAAS,EAAE,GAAG,aAAa,KAAK,QAAQ,aAAa,CAAC,GAC1F,KAAA;CAEJ,MAAM,wBAAwB,yBAAyB,QAAQ,QAAQ;CAGvE,MAAM,EAAE,SAAS,mBAAmB,WAAW,wBAAwB,mCADnD,iBAAiB,UAAU,OAAO,OAAO,MACwD,CAAC;CACtH,MAAM,gBAAgB,wBAAwB,OAAO;CACrD,MAAM,kBAAkB,mBAAmB,MAAM,IAAI;CAErD,MAAM,UAAU,kBACd,UAAU,OAAO,SACjB,OAAO,OAAO,QACf;CAED,MAAM,SAAkC;EACtC,GAAI,UAAU;EACd,GAAI,OAAO;EACZ;AAED,QAAO;EACL,SAAS,QAAQ,aAAa;EAC9B;EACA;EACA,WAAW;EACX,iBAAiB,OAAO,mBAAmB,UAAU;EACrD,kBAAkB,OAAO,oBAAoB,UAAU;EACvD,gBAAgB,OAAO,kBAAkB,UAAU;EACnD,sBAAsB,OAAO,sBAAsB,MAAM,GACrD,MAAM,uBACN,UAAU,sBAAsB,MAAM,GACpC,SAAS,uBACT,KAAA;EACN,iBAAiB,OAAO,QAAQ,SAAS,CAAC,GAAG,MAAM,OAAO,GAAG,UAAU,QAAQ,SAAS,CAAC,GAAG,SAAS,OAAO,GAAG,KAAA;EAC/G,OAAO,EAAE,SAAS;EAClB;EACD;;AAGH,SAAgB,uCACd,QACA,YACuB;AAEvB,QAAO,6BAA6B,QADzB,sBAAsB,YAAY,OACC,CAAC"}
+{"version":3,"file":"agent-profile.js","names":[],"sources":["../../../src/config/agent-profile.ts"],"sourcesContent":["/**\n * Effective agent profile: merges `agents.defaults` with `agents.list` entry.\n * Subagent session keys fall back to the configured default agent id for profile lookup.\n */\n\nimport type { ThinkLevel, ReasoningLevel, VerboseLevel } from '../agent/transcript/thinking-types.js';\nimport type { Config } from './schema.js';\nimport type { AgentModelConfig } from './schema.js';\nimport { getAgentDefaultModelRef } from './schema.js';\nimport { resolveAgentWorkspaceDir } from '../agent/agent-scope.js';\nimport { getDefaultAgentId, agentExists } from '../routing/resolve-route.js';\nimport { parseSessionKey } from '../routing/session-key.js';\n\nexport { resolveAgentWorkspaceDir } from '../agent/agent-scope.js';\n\nexport type { AgentModelConfig };\n\nexport interface EffectiveAgentTools {\n  /** Tool names to exclude (merged: union of defaults + list entry disables). */\n  disable: Set<string>;\n}\n\nexport interface EffectiveAgentProfile {\n  agentId: string;\n  /** Resolved absolute Markdown workspace path (tool cwd, attachments, daily memory/, …). */\n  resolvedWorkspacePath: string;\n  /** Primary model ref (provider/model); may be empty → runtime default. */\n  primaryModelRef: string | undefined;\n  fallbacks: string[];\n  thinkingDefault?: ThinkLevel;\n  reasoningDefault?: ReasoningLevel;\n  verboseDefault?: VerboseLevel;\n  systemPromptOverride?: string;\n  /** Skill names visible in `<available_skills>`; undefined means all enabled skills, empty means none. */\n  skillsAllowlist?: string[];\n  tools: EffectiveAgentTools;\n  params: Record<string, unknown>;\n}\n\nfunction mergeModelConfig(\n  base: AgentModelConfig | undefined,\n  override: AgentModelConfig | undefined,\n): AgentModelConfig | undefined {\n  if (override === undefined) return base;\n  if (base === undefined) return override;\n  return {\n    primary: override.primary ?? base.primary,\n    fallbacks: override.fallbacks ?? base.fallbacks,\n  };\n}\n\nfunction primaryAndFallbacksFromModelConfig(\n  raw: AgentModelConfig | undefined,\n): { primary?: string; fallbacks: string[] } {\n  const primary = raw?.primary?.trim();\n  const fallbacks = Array.isArray(raw?.fallbacks)\n    ? raw.fallbacks.map((s) => s.trim()).filter(Boolean)\n    : [];\n  return { primary: primary || undefined, fallbacks };\n}\n\nfunction mergeDisableLists(a?: string[], b?: string[]): Set<string> {\n  const out = new Set<string>();\n  for (const x of a ?? []) {\n    const s = String(x).trim();\n    if (s) {\n      out.add(s);\n    }\n  }\n  for (const x of b ?? []) {\n    const s = String(x).trim();\n    if (s) {\n      out.add(s);\n    }\n  }\n  return out;\n}\n\nfunction resolveSkillsAllowlist(defaultsSkills: string[] | undefined, entrySkills: string[] | undefined): string[] | undefined {\n  if (entrySkills !== undefined) {\n    return [...entrySkills];\n  }\n  if (defaultsSkills !== undefined) {\n    return [...defaultsSkills];\n  }\n  return undefined;\n}\n\n/**\n * Agent id used for config lookup from a session key (subagent keys → default agent).\n */\nexport function extractProfileAgentId(sessionKey: string | undefined | null, config: Config): string {\n  const parsed = parseSessionKey(sessionKey ?? '');\n  if (!parsed) {\n    return getDefaultAgentId(config);\n  }\n  const aid = parsed.agentId;\n  if (aid === 'subagent' || aid.startsWith('subagent:')) {\n    return getDefaultAgentId(config);\n  }\n  if (!agentExists(aid, config)) {\n    return getDefaultAgentId(config);\n  }\n  return aid.toLowerCase();\n}\n\n/**\n * Merge `agents.defaults` with the matching `agents.list` entry.\n */\nexport function resolveEffectiveAgentProfile(config: Config, agentId: string): EffectiveAgentProfile {\n  const defaults = config.agents?.defaults;\n  const list = config.agents?.list;\n  const entry = Array.isArray(list)\n    ? list.find((a) => a && a.enabled !== false && a.id.toLowerCase() === agentId.toLowerCase())\n    : undefined;\n\n  const resolvedWorkspacePath = resolveAgentWorkspaceDir(config, agentId);\n\n  const mergedModel = mergeModelConfig(defaults?.models?.chat, entry?.models?.chat);\n  const { primary: primaryFromMerged, fallbacks: fallbacksFromMerged } = primaryAndFallbacksFromModelConfig(mergedModel);\n  const globalDefault = getAgentDefaultModelRef(config);\n  const primaryModelRef = primaryFromMerged?.trim() || globalDefault;\n\n  const disable = mergeDisableLists(\n    defaults?.tools?.disable as string[] | undefined,\n    entry?.tools?.disable as string[] | undefined,\n  );\n\n  const params: Record<string, unknown> = {\n    ...(defaults?.params as Record<string, unknown> | undefined),\n    ...(entry?.params as Record<string, unknown> | undefined),\n  };\n\n  return {\n    agentId: agentId.toLowerCase(),\n    resolvedWorkspacePath,\n    primaryModelRef,\n    fallbacks: fallbacksFromMerged,\n    thinkingDefault: entry?.thinkingDefault ?? defaults?.thinkingDefault,\n    reasoningDefault: entry?.reasoningDefault ?? defaults?.reasoningDefault,\n    verboseDefault: entry?.verboseDefault ?? defaults?.verboseDefault,\n    systemPromptOverride: entry?.systemPromptOverride?.trim()\n      ? entry.systemPromptOverride\n      : defaults?.systemPromptOverride?.trim()\n        ? defaults.systemPromptOverride\n        : undefined,\n    skillsAllowlist: resolveSkillsAllowlist(defaults?.skills, entry?.skills),\n    tools: { disable },\n    params,\n  };\n}\n\nexport function resolveEffectiveAgentProfileForSession(\n  config: Config,\n  sessionKey: string | undefined | null,\n): EffectiveAgentProfile {\n  const id = extractProfileAgentId(sessionKey, config);\n  return resolveEffectiveAgentProfile(config, id);\n}\n"],"mappings":";;;;;aAQsD;kBACa;oBACU;kBACjB;AA4B5D,SAAS,iBACP,MACA,UAC8B;AAC9B,KAAI,aAAa,KAAA,EAAW,QAAO;AACnC,KAAI,SAAS,KAAA,EAAW,QAAO;AAC/B,QAAO;EACL,SAAS,SAAS,WAAW,KAAK;EAClC,WAAW,SAAS,aAAa,KAAK;EACvC;;AAGH,SAAS,mCACP,KAC2C;CAC3C,MAAM,UAAU,KAAK,SAAS,MAAM;CACpC,MAAM,YAAY,MAAM,QAAQ,KAAK,UAAU,GAC3C,IAAI,UAAU,KAAK,MAAM,EAAE,MAAM,CAAC,CAAC,OAAO,QAAQ,GAClD,EAAE;AACN,QAAO;EAAE,SAAS,WAAW,KAAA;EAAW;EAAW;;AAGrD,SAAS,kBAAkB,GAAc,GAA2B;CAClE,MAAM,sBAAM,IAAI,KAAa;AAC7B,MAAK,MAAM,KAAK,KAAK,EAAE,EAAE;EACvB,MAAM,IAAI,OAAO,EAAE,CAAC,MAAM;AAC1B,MAAI,EACF,KAAI,IAAI,EAAE;;AAGd,MAAK,MAAM,KAAK,KAAK,EAAE,EAAE;EACvB,MAAM,IAAI,OAAO,EAAE,CAAC,MAAM;AAC1B,MAAI,EACF,KAAI,IAAI,EAAE;;AAGd,QAAO;;AAGT,SAAS,uBAAuB,gBAAsC,aAAyD;AAC7H,KAAI,gBAAgB,KAAA,EAClB,QAAO,CAAC,GAAG,YAAY;AAEzB,KAAI,mBAAmB,KAAA,EACrB,QAAO,CAAC,GAAG,eAAe;;;;;AAQ9B,SAAgB,sBAAsB,YAAuC,QAAwB;CACnG,MAAM,SAAS,gBAAgB,cAAc,GAAG;AAChD,KAAI,CAAC,OACH,QAAO,kBAAkB,OAAO;CAElC,MAAM,MAAM,OAAO;AACnB,KAAI,QAAQ,cAAc,IAAI,WAAW,YAAY,CACnD,QAAO,kBAAkB,OAAO;AAElC,KAAI,CAAC,YAAY,KAAK,OAAO,CAC3B,QAAO,kBAAkB,OAAO;AAElC,QAAO,IAAI,aAAa;;;;;AAM1B,SAAgB,6BAA6B,QAAgB,SAAwC;CACnG,MAAM,WAAW,OAAO,QAAQ;CAChC,MAAM,OAAO,OAAO,QAAQ;CAC5B,MAAM,QAAQ,MAAM,QAAQ,KAAK,GAC7B,KAAK,MAAM,MAAM,KAAK,EAAE,YAAY,SAAS,EAAE,GAAG,aAAa,KAAK,QAAQ,aAAa,CAAC,GAC1F,KAAA;CAEJ,MAAM,wBAAwB,yBAAyB,QAAQ,QAAQ;CAGvE,MAAM,EAAE,SAAS,mBAAmB,WAAW,wBAAwB,mCADnD,iBAAiB,UAAU,QAAQ,MAAM,OAAO,QAAQ,KACyC,CAAC;CACtH,MAAM,gBAAgB,wBAAwB,OAAO;CACrD,MAAM,kBAAkB,mBAAmB,MAAM,IAAI;CAErD,MAAM,UAAU,kBACd,UAAU,OAAO,SACjB,OAAO,OAAO,QACf;CAED,MAAM,SAAkC;EACtC,GAAI,UAAU;EACd,GAAI,OAAO;EACZ;AAED,QAAO;EACL,SAAS,QAAQ,aAAa;EAC9B;EACA;EACA,WAAW;EACX,iBAAiB,OAAO,mBAAmB,UAAU;EACrD,kBAAkB,OAAO,oBAAoB,UAAU;EACvD,gBAAgB,OAAO,kBAAkB,UAAU;EACnD,sBAAsB,OAAO,sBAAsB,MAAM,GACrD,MAAM,uBACN,UAAU,sBAAsB,MAAM,GACpC,SAAS,uBACT,KAAA;EACN,iBAAiB,uBAAuB,UAAU,QAAQ,OAAO,OAAO;EACxE,OAAO,EAAE,SAAS;EAClB;EACD;;AAGH,SAAgB,uCACd,QACA,YACuB;AAEvB,QAAO,6BAA6B,QADzB,sBAAsB,YAAY,OACC,CAAC"}

package/dist/src/config/agent-typed-models.d.ts

@@ -1,9 +1,9 @@
 /**
- * Named model roles from `agents.defaults.models`.
+ * Named model roles from `agents.defaults.models.roles` plus per-agent overrides.
  */
 import type { AgentTypedModel, Config } from './schema.js';
 export type { AgentTypedModel };
-export declare function resolveEffectiveTypedModels(config: Config, _agentId: string): Map<string, AgentTypedModel>;
+export declare function resolveEffectiveTypedModels(config: Config, agentId: string): Map<string, AgentTypedModel>;
 /** Resolve a typed model id to `provider/model`, or undefined when not configured. */
 export declare function resolveTypedModelRef(config: Config, agentId: string, typeId: string): string | undefined;
 /**

package/dist/src/config/agent-typed-models.js

@@ -1,9 +1,20 @@
+import { init_agent_scope, listAgentEntries, normalizeAgentId } from "../agent/agent-scope.js";
 import { init_schema, parseModelRef } from "./schema.js";
 //#region src/config/agent-typed-models.ts
 init_schema();
-function resolveEffectiveTypedModels(config, _agentId) {
+init_agent_scope();
+function rolesToEntries(roles) {
+	return Object.entries(roles ?? {}).map(([id, role]) => ({
+		id,
+		...role
+	}));
+}
+function resolveEffectiveTypedModels(config, agentId) {
 	const out = /* @__PURE__ */ new Map();
-	for (const modelRole of config.agents?.defaults?.models ?? []) out.set(modelRole.id, modelRole);
+	for (const modelRole of rolesToEntries(config.agents?.defaults?.models?.roles)) out.set(modelRole.id, modelRole);
+	const id = normalizeAgentId(agentId);
+	const entry = listAgentEntries(config).find((candidate) => candidate.enabled !== false && normalizeAgentId(candidate.id) === id);
+	for (const modelRole of rolesToEntries(entry?.models?.roles)) out.set(modelRole.id, modelRole);
 	return out;
 }
 /** Resolve a typed model id to `provider/model`, or undefined when not configured. */

package/dist/src/config/agent-typed-models.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-typed-models.js","names":[],"sources":["../../../src/config/agent-typed-models.ts"],"sourcesContent":["/**\n * Named model roles from `agents.defaults.models`.\n */\n\nimport type { AgentTypedModel, Config } from './schema.js';\nimport { parseModelRef } from './schema.js';\n\nexport type { AgentTypedModel };\n\nexport function resolveEffectiveTypedModels(config: Config, _agentId: string): Map<string, AgentTypedModel> {\n  const out = new Map<string, AgentTypedModel>();\n  for (const modelRole of config.agents?.defaults?.models ?? []) {\n    out.set(modelRole.id, modelRole);\n  }\n  return out;\n}\n\n/** Resolve a typed model id to `provider/model`, or undefined when not configured. */\nexport function resolveTypedModelRef(\n  config: Config,\n  agentId: string,\n  typeId: string,\n): string | undefined {\n  const entry = resolveEffectiveTypedModels(config, agentId).get(typeId);\n  const ref = entry?.model?.trim();\n  return ref || undefined;\n}\n\nfunction parseModelRefInput(ref: string): { directRef?: string; typeId?: string } {\n  const trimmed = ref.trim();\n  if (!trimmed) {\n    return {};\n  }\n  if (trimmed.includes('/')) {\n    return { directRef: trimmed };\n  }\n  const typeId = trimmed.startsWith('@') ? trimmed.slice(1).trim() : trimmed;\n  return typeId ? { typeId } : {};\n}\n\n/**\n * Resolve a model reference: `provider/model`, typed id (`small`), or `@small`.\n * Throws when the ref is invalid or the typed id is unknown.\n */\nexport function resolveModelRef(config: Config, agentId: string, ref: string): string {\n  const { directRef, typeId } = parseModelRefInput(ref);\n  if (directRef) {\n    if (!parseModelRef(directRef)) {\n      throw new Error(`model ref must be provider/model format (got '${directRef}')`);\n    }\n    return directRef;\n  }\n  if (typeId) {\n    const resolved = resolveTypedModelRef(config, agentId, typeId);\n    if (resolved) {\n      return resolved;\n    }\n    const available = [...resolveEffectiveTypedModels(config, agentId).keys()];\n    const hint =\n      available.length > 0 ? ` (available: ${available.join(', ')})` : ' (none configured)';\n    throw new Error(`Unknown typed model id '${typeId}' for agent '${agentId}'${hint}`);\n  }\n  throw new Error('model ref must not be empty');\n}\n"],"mappings":";;aAK4C;AAI5C,SAAgB,4BAA4B,QAAgB,UAAgD;CAC1G,MAAM,sBAAM,IAAI,KAA8B;AAC9C,MAAK,MAAM,aAAa,OAAO,QAAQ,UAAU,UAAU,EAAE,CAC3D,KAAI,IAAI,UAAU,IAAI,UAAU;AAElC,QAAO;;;AAIT,SAAgB,qBACd,QACA,SACA,QACoB;AAGpB,QAFc,4BAA4B,QAAQ,QAAQ,CAAC,IAAI,OAC9C,EAAE,OAAO,MAAM,IAClB,KAAA;;AAGhB,SAAS,mBAAmB,KAAsD;CAChF,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO,EAAE;AAEX,KAAI,QAAQ,SAAS,IAAI,CACvB,QAAO,EAAE,WAAW,SAAS;CAE/B,MAAM,SAAS,QAAQ,WAAW,IAAI,GAAG,QAAQ,MAAM,EAAE,CAAC,MAAM,GAAG;AACnE,QAAO,SAAS,EAAE,QAAQ,GAAG,EAAE;;;;;;AAOjC,SAAgB,gBAAgB,QAAgB,SAAiB,KAAqB;CACpF,MAAM,EAAE,WAAW,WAAW,mBAAmB,IAAI;AACrD,KAAI,WAAW;AACb,MAAI,CAAC,cAAc,UAAU,CAC3B,OAAM,IAAI,MAAM,iDAAiD,UAAU,IAAI;AAEjF,SAAO;;AAET,KAAI,QAAQ;EACV,MAAM,WAAW,qBAAqB,QAAQ,SAAS,OAAO;AAC9D,MAAI,SACF,QAAO;EAET,MAAM,YAAY,CAAC,GAAG,4BAA4B,QAAQ,QAAQ,CAAC,MAAM,CAAC;EAC1E,MAAM,OACJ,UAAU,SAAS,IAAI,gBAAgB,UAAU,KAAK,KAAK,CAAC,KAAK;AACnE,QAAM,IAAI,MAAM,2BAA2B,OAAO,eAAe,QAAQ,GAAG,OAAO;;AAErF,OAAM,IAAI,MAAM,8BAA8B"}
+{"version":3,"file":"agent-typed-models.js","names":[],"sources":["../../../src/config/agent-typed-models.ts"],"sourcesContent":["/**\n * Named model roles from `agents.defaults.models.roles` plus per-agent overrides.\n */\n\nimport type { AgentTypedModel, Config } from './schema.js';\nimport { parseModelRef } from './schema.js';\nimport { listAgentEntries, normalizeAgentId } from '../agent/agent-scope.js';\n\nexport type { AgentTypedModel };\n\nfunction rolesToEntries(\n  roles: Record<string, { model: string; description?: string }> | undefined,\n): AgentTypedModel[] {\n  return Object.entries(roles ?? {}).map(([id, role]) => ({\n    id,\n    ...role,\n  }));\n}\n\nexport function resolveEffectiveTypedModels(config: Config, agentId: string): Map<string, AgentTypedModel> {\n  const out = new Map<string, AgentTypedModel>();\n  for (const modelRole of rolesToEntries(config.agents?.defaults?.models?.roles)) {\n    out.set(modelRole.id, modelRole);\n  }\n  const id = normalizeAgentId(agentId);\n  const entry = listAgentEntries(config).find(\n    (candidate) => candidate.enabled !== false && normalizeAgentId(candidate.id) === id,\n  );\n  for (const modelRole of rolesToEntries(entry?.models?.roles)) {\n    out.set(modelRole.id, modelRole);\n  }\n  return out;\n}\n\n/** Resolve a typed model id to `provider/model`, or undefined when not configured. */\nexport function resolveTypedModelRef(\n  config: Config,\n  agentId: string,\n  typeId: string,\n): string | undefined {\n  const entry = resolveEffectiveTypedModels(config, agentId).get(typeId);\n  const ref = entry?.model?.trim();\n  return ref || undefined;\n}\n\nfunction parseModelRefInput(ref: string): { directRef?: string; typeId?: string } {\n  const trimmed = ref.trim();\n  if (!trimmed) {\n    return {};\n  }\n  if (trimmed.includes('/')) {\n    return { directRef: trimmed };\n  }\n  const typeId = trimmed.startsWith('@') ? trimmed.slice(1).trim() : trimmed;\n  return typeId ? { typeId } : {};\n}\n\n/**\n * Resolve a model reference: `provider/model`, typed id (`small`), or `@small`.\n * Throws when the ref is invalid or the typed id is unknown.\n */\nexport function resolveModelRef(config: Config, agentId: string, ref: string): string {\n  const { directRef, typeId } = parseModelRefInput(ref);\n  if (directRef) {\n    if (!parseModelRef(directRef)) {\n      throw new Error(`model ref must be provider/model format (got '${directRef}')`);\n    }\n    return directRef;\n  }\n  if (typeId) {\n    const resolved = resolveTypedModelRef(config, agentId, typeId);\n    if (resolved) {\n      return resolved;\n    }\n    const available = [...resolveEffectiveTypedModels(config, agentId).keys()];\n    const hint =\n      available.length > 0 ? ` (available: ${available.join(', ')})` : ' (none configured)';\n    throw new Error(`Unknown typed model id '${typeId}' for agent '${agentId}'${hint}`);\n  }\n  throw new Error('model ref must not be empty');\n}\n"],"mappings":";;;aAK4C;kBACiC;AAI7E,SAAS,eACP,OACmB;AACnB,QAAO,OAAO,QAAQ,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,WAAW;EACtD;EACA,GAAG;EACJ,EAAE;;AAGL,SAAgB,4BAA4B,QAAgB,SAA+C;CACzG,MAAM,sBAAM,IAAI,KAA8B;AAC9C,MAAK,MAAM,aAAa,eAAe,OAAO,QAAQ,UAAU,QAAQ,MAAM,CAC5E,KAAI,IAAI,UAAU,IAAI,UAAU;CAElC,MAAM,KAAK,iBAAiB,QAAQ;CACpC,MAAM,QAAQ,iBAAiB,OAAO,CAAC,MACpC,cAAc,UAAU,YAAY,SAAS,iBAAiB,UAAU,GAAG,KAAK,GAClF;AACD,MAAK,MAAM,aAAa,eAAe,OAAO,QAAQ,MAAM,CAC1D,KAAI,IAAI,UAAU,IAAI,UAAU;AAElC,QAAO;;;AAIT,SAAgB,qBACd,QACA,SACA,QACoB;AAGpB,QAFc,4BAA4B,QAAQ,QAAQ,CAAC,IAAI,OAC9C,EAAE,OAAO,MAAM,IAClB,KAAA;;AAGhB,SAAS,mBAAmB,KAAsD;CAChF,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO,EAAE;AAEX,KAAI,QAAQ,SAAS,IAAI,CACvB,QAAO,EAAE,WAAW,SAAS;CAE/B,MAAM,SAAS,QAAQ,WAAW,IAAI,GAAG,QAAQ,MAAM,EAAE,CAAC,MAAM,GAAG;AACnE,QAAO,SAAS,EAAE,QAAQ,GAAG,EAAE;;;;;;AAOjC,SAAgB,gBAAgB,QAAgB,SAAiB,KAAqB;CACpF,MAAM,EAAE,WAAW,WAAW,mBAAmB,IAAI;AACrD,KAAI,WAAW;AACb,MAAI,CAAC,cAAc,UAAU,CAC3B,OAAM,IAAI,MAAM,iDAAiD,UAAU,IAAI;AAEjF,SAAO;;AAET,KAAI,QAAQ;EACV,MAAM,WAAW,qBAAqB,QAAQ,SAAS,OAAO;AAC9D,MAAI,SACF,QAAO;EAET,MAAM,YAAY,CAAC,GAAG,4BAA4B,QAAQ,QAAQ,CAAC,MAAM,CAAC;EAC1E,MAAM,OACJ,UAAU,SAAS,IAAI,gBAAgB,UAAU,KAAK,KAAK,CAAC,KAAK;AACnE,QAAM,IAAI,MAAM,2BAA2B,OAAO,eAAe,QAAQ,GAAG,OAAO;;AAErF,OAAM,IAAI,MAAM,8BAA8B"}