@xopcai/xopc 0.0.103 → 0.0.104

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

@@ -1 +1 @@
-{"version":3,"file":"model.js","names":["getModelsJsonPath"],"sources":["../../../../../src/cli/commands/onboard/model.ts"],"sourcesContent":["/**\n * Catalog-driven model configuration for onboarding.\n */\n\nimport { confirm, input, select } from '@inquirer/prompts';\n\nimport { CredentialResolver } from '../../../auth/credentials.js';\nimport {\n  getModelsJsonPath,\n  loadModelsJson,\n  saveModelsJson,\n  type ModelsJsonConfig,\n} from '../../../config/models-json.js';\nimport type { Config } from '../../../config/schema.js';\nimport {\n  getAllProviders,\n  getApiKeyFromEnv,\n  getModelRegistry,\n  getModelsByProvider,\n  getProviderDisplayName,\n  providerSupportsApiKey,\n  providerSupportsOAuth,\n} from '../../../providers/index.js';\nimport {\n  getProviderHint,\n  getRecommendedModelsForProvider,\n  sortModelsForPicker,\n  sortProvidersForPicker,\n} from '../../../providers/presentation.js';\nimport { listProfilesForProvider } from '../../../auth/profiles/index.js';\nimport { getOAuthProvider } from '../../utils/oauth-providers.js';\nimport { runCliOAuthLogin } from '../../utils/oauth-login.js';\nimport type { CLIContext } from '../../registry.js';\nimport { colors } from '../../utils/colors.js';\n\ntype ModelChoice = { value: string; name: string; description?: string };\ntype CustomApiKind = 'openai-completions' | 'openai-responses' | 'anthropic-messages';\n\nfunction ensureAgentDefaults(config: Config, workspacePath: string): NonNullable<Config['agents']>['defaults'] {\n  config.agents = config.agents || {};\n  config.agents.defaults = config.agents.defaults || {\n    workspace: workspacePath,\n    maxTokens: 8192,\n    temperature: 0.7,\n    maxToolIterations: 20,\n    maxRequestsPerTurn: 50,\n    maxToolFailuresPerTurn: 3,\n  };\n  config.agents.defaults.workspace = workspacePath;\n  return config.agents.defaults;\n}\n\nfunction setPrimaryModel(config: Config, workspacePath: string, modelRef: string): Config {\n  const defaults = ensureAgentDefaults(config, workspacePath);\n  defaults.model = { primary: modelRef, fallbacks: [] };\n  return config;\n}\n\nfunction formatRecommended(provider: string): string | undefined {\n  const labels = getRecommendedModelsForProvider(provider, 3).map((m) => m.name || m.id);\n  return labels.length > 0 ? `Recommended: ${labels.join(', ')}` : getProviderHint(provider);\n}\n\nfunction providerChoices(): Array<{ value: string; name: string; description?: string }> {\n  const providers = sortProvidersForPicker(getAllProviders());\n  const choices = providers.map((provider) => ({\n    value: provider,\n    name: getProviderDisplayName(provider),\n    description: formatRecommended(provider),\n  }));\n  choices.push({\n    value: 'custom-api',\n    name: 'Custom API',\n    description: 'OpenAI-compatible, OpenAI Responses, or Anthropic-compatible endpoint',\n  });\n  return choices;\n}\n\nfunction modelChoiceName(choice: ModelChoice): string {\n  return choice.description ? `${choice.name}  ${colors.gray(choice.description)}` : choice.name;\n}\n\nfunction getModelsForProvider(provider: string): ModelChoice[] {\n  return sortModelsForPicker(getModelsByProvider(provider)).map((m) => {\n    const badges = [m.reasoning ? 'reasoning' : '', m.input?.includes('image') ? 'vision' : '']\n      .filter(Boolean)\n      .join(', ');\n    return {\n      value: `${m.provider}/${m.id}`,\n      name: m.name || m.id,\n      description: badges || undefined,\n    };\n  });\n}\n\nasync function doOAuthLogin(provider: string): Promise<boolean> {\n  const config = getOAuthProvider(provider);\n  if (!config) {\n    console.error(`OAuth not supported for provider: ${provider}`);\n    return false;\n  }\n\n  console.log(`\\n🔐 Starting ${config.displayName} OAuth login...`);\n  try {\n    await runCliOAuthLogin({ provider, onProgress: (message) => console.log(' →', message) });\n    return true;\n  } catch (error) {\n    console.error('❌ OAuth login failed:', error);\n    return false;\n  }\n}\n\nfunction joinEndpoint(baseUrl: string, suffix: string): string {\n  return `${baseUrl.replace(/\\/+$/, '')}/${suffix.replace(/^\\/+/, '')}`;\n}\n\nasync function probeCustomProvider(params: {\n  baseUrl: string;\n  apiKey: string;\n  modelId: string;\n  api: CustomApiKind;\n}): Promise<void> {\n  const timeout = AbortSignal.timeout(30_000);\n  const commonHeaders = {\n    'content-type': 'application/json',\n    authorization: `Bearer ${params.apiKey}`,\n  };\n\n  const request =\n    params.api === 'anthropic-messages'\n      ? {\n          url: joinEndpoint(params.baseUrl, '/messages'),\n          headers: { ...commonHeaders, 'anthropic-version': '2023-06-01' },\n          body: { model: params.modelId, max_tokens: 1, messages: [{ role: 'user', content: 'ping' }] },\n        }\n      : params.api === 'openai-responses'\n        ? {\n            url: joinEndpoint(params.baseUrl, '/responses'),\n            headers: commonHeaders,\n            body: { model: params.modelId, input: 'ping', max_output_tokens: 1 },\n          }\n        : {\n            url: joinEndpoint(params.baseUrl, '/chat/completions'),\n            headers: commonHeaders,\n            body: { model: params.modelId, messages: [{ role: 'user', content: 'ping' }], max_tokens: 1 },\n          };\n\n  const res = await fetch(request.url, {\n    method: 'POST',\n    headers: request.headers,\n    body: JSON.stringify(request.body),\n    signal: timeout,\n  });\n  if (!res.ok) {\n    const text = await res.text().catch(() => '');\n    throw new Error(`Probe failed (${res.status}) at ${request.url}${text ? `: ${text.slice(0, 300)}` : ''}`);\n  }\n}\n\nfunction defaultProviderIdFromBaseUrl(baseUrl: string): string {\n  try {\n    const url = new URL(baseUrl);\n    return url.hostname\n      .replace(/^api\\./, '')\n      .split('.')\n      .filter(Boolean)\n      .slice(0, 2)\n      .join('-')\n      .toLowerCase()\n      .replace(/[^a-z0-9-_]+/g, '-')\n      .replace(/^-+|-+$/g, '') || 'custom';\n  } catch {\n    return 'custom';\n  }\n}\n\nfunction validateProviderId(value: string): true | string {\n  return /^[a-z0-9]([a-z0-9-_]*[a-z0-9])?$/.test(value)\n    ? true\n    : 'Use lowercase letters, numbers, hyphens, or underscores; start/end with a letter or number.';\n}\n\nasync function setupCustomApi(config: Config, ctx: CLIContext): Promise<Config> {\n  console.log('\\n🔌 Custom API provider\\n');\n\n  const baseUrl = (await input({\n    message: 'API base URL:',\n    default: 'https://api.example.com/v1',\n    validate: (value) => URL.canParse(value) || 'Enter a valid URL',\n  })).trim();\n\n  const apiKey = (await input({\n    message: 'API key:',\n    validate: (value) => value.trim().length > 0 || 'Required',\n  })).trim();\n\n  const api = await select<CustomApiKind>({\n    message: 'Compatibility:',\n    choices: [\n      { value: 'openai-completions', name: 'OpenAI-compatible Chat Completions' },\n      { value: 'openai-responses', name: 'OpenAI Responses' },\n      { value: 'anthropic-messages', name: 'Anthropic Messages' },\n    ],\n  });\n\n  const modelId = (await input({\n    message: 'Model ID:',\n    validate: (value) => value.trim().length > 0 || 'Required',\n  })).trim();\n\n  console.log('\\n→ Probing endpoint...');\n  await probeCustomProvider({ baseUrl, apiKey, modelId, api });\n  console.log(colors.green('✓ Probe succeeded'));\n\n  const existingProviders = new Set(getAllProviders());\n  const providerId = (await input({\n    message: 'Provider ID:',\n    default: defaultProviderIdFromBaseUrl(baseUrl),\n    validate: (value) => {\n      const valid = validateProviderId(value.trim());\n      if (valid !== true) return valid;\n      if (existingProviders.has(value.trim())) return 'Provider ID already exists; choose a new ID.';\n      return true;\n    },\n  })).trim();\n\n  const path = getModelsJsonPath();\n  const { config: modelsConfig } = loadModelsJson(path);\n  const nextModelsConfig: ModelsJsonConfig = {\n    providers: {\n      ...(modelsConfig.providers ?? {}),\n      [providerId]: {\n        baseUrl,\n        apiKey,\n        api,\n        models: [{ id: modelId, name: modelId, api, contextWindow: 128000, input: ['text'] }],\n      },\n    },\n  };\n  const saved = saveModelsJson(path, nextModelsConfig);\n  if (!saved.success) {\n    throw new Error(saved.error || 'Failed to save models.json');\n  }\n  getModelRegistry().refresh();\n\n  const ref = `${providerId}/${modelId}`;\n  console.log('\\n✅ Custom model configured:', ref);\n  return setPrimaryModel(config, ctx.workspacePath, ref);\n}\n\nasync function ensureProviderCredential(provider: string, providerName: string): Promise<boolean> {\n  const existingProfiles = listProfilesForProvider(provider);\n  if (existingProfiles.length > 0) {\n    console.log(`\\n${colors.green('✓')} Found existing credentials for ${providerName}`);\n    return await confirm({ message: 'Use existing credentials?', default: true });\n  }\n\n  const envKey = getApiKeyFromEnv(provider);\n  if (envKey) {\n    console.log(`\\n${colors.green('✓')} Found API key for ${providerName} in environment`);\n    return true;\n  }\n\n  const supportsOAuth = providerSupportsOAuth(provider);\n  const supportsApiKey = providerSupportsApiKey(provider);\n\n  if (supportsOAuth && !supportsApiKey) {\n    return await doOAuthLogin(provider);\n  }\n\n  let useOAuth = false;\n  if (supportsOAuth && supportsApiKey) {\n    const authMethod = await select<'api_key' | 'oauth'>({\n      message: `How would you like to authenticate with ${providerName}?`,\n      choices: [\n        { value: 'api_key', name: 'API key' },\n        { value: 'oauth', name: 'OAuth login' },\n      ],\n    });\n    useOAuth = authMethod === 'oauth';\n  }\n\n  if (useOAuth) {\n    const ok = await doOAuthLogin(provider);\n    if (ok) return true;\n    console.log('\\n⚠️ OAuth login failed. Enter an API key instead.');\n  }\n\n  if (!supportsApiKey) return false;\n  const apiKey = await input({\n    message: `API key for ${providerName}:`,\n    validate: (value) => value.trim().length > 0 || 'Required',\n  });\n  const resolver = new CredentialResolver();\n  await resolver.saveApiKey(provider, apiKey.trim(), { profileName: 'default' });\n  return true;\n}\n\nexport async function setupModel(existingConfig: Config | null, ctx: CLIContext): Promise<Config> {\n  console.log('\\n🤖 Step: AI Model\\n');\n\n  const config = existingConfig || ({} as Config);\n  const currentModel = config?.agents?.defaults?.model?.primary;\n\n  if (currentModel) {\n    console.log('Current model:', currentModel);\n    const keepCurrent = await confirm({ message: 'Keep using this model?', default: true });\n    if (keepCurrent) {\n      console.log('✅ Keeping:', currentModel);\n      return config;\n    }\n  }\n\n  const provider = await select({\n    message: 'Model/auth provider:',\n    choices: providerChoices(),\n  });\n\n  if (provider === 'custom-api') {\n    return await setupCustomApi(config, ctx);\n  }\n\n  const providerName = getProviderDisplayName(provider);\n  const credentialOk = await ensureProviderCredential(provider, providerName);\n  if (!credentialOk) {\n    console.error(`\\n❌ Could not configure credentials for ${providerName}.`);\n    return config;\n  }\n\n  const modelChoices = getModelsForProvider(provider);\n  if (modelChoices.length === 0) {\n    throw new Error(`No catalog models found for ${providerName}. Add a Custom API provider instead.`);\n  }\n\n  console.log(`\\n📋 Models for ${providerName}:`);\n  const model = await select({\n    message: 'Model:',\n    choices: modelChoices.map((choice) => ({ ...choice, name: modelChoiceName(choice) })),\n  });\n\n  console.log('\\n✅ Model configured:', model);\n  return setPrimaryModel(config, ctx.workspacePath, model);\n}\n"],"mappings":"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"}
+{"version":3,"file":"model.js","names":["getModelsJsonPath"],"sources":["../../../../../src/cli/commands/onboard/model.ts"],"sourcesContent":["/**\n * Catalog-driven model configuration for onboarding.\n */\n\nimport { confirm, input, select } from '@inquirer/prompts';\n\nimport { CredentialResolver } from '../../../auth/credentials.js';\nimport {\n  getModelsJsonPath,\n  loadModelsJson,\n  saveModelsJson,\n  type ModelsJsonConfig,\n} from '../../../config/models-json.js';\nimport type { Config } from '../../../config/schema.js';\nimport {\n  getAllProviders,\n  getApiKeyFromEnv,\n  getModelRegistry,\n  getModelsByProvider,\n  getProviderDisplayName,\n  providerSupportsApiKey,\n  providerSupportsOAuth,\n} from '../../../providers/index.js';\nimport {\n  getProviderHint,\n  getRecommendedModelsForProvider,\n  sortModelsForPicker,\n  sortProvidersForPicker,\n} from '../../../providers/presentation.js';\nimport { listProfilesForProvider } from '../../../auth/profiles/index.js';\nimport { getOAuthProvider } from '../../utils/oauth-providers.js';\nimport { runCliOAuthLogin } from '../../utils/oauth-login.js';\nimport type { CLIContext } from '../../registry.js';\nimport { colors } from '../../utils/colors.js';\n\ntype ModelChoice = { value: string; name: string; description?: string };\ntype CustomApiKind = 'openai-completions' | 'openai-responses' | 'anthropic-messages';\n\nfunction ensureAgentDefaults(config: Config, workspacePath: string): NonNullable<Config['agents']>['defaults'] {\n  config.agents = config.agents || {};\n  config.agents.defaults = config.agents.defaults || {\n    workspace: workspacePath,\n    maxTokens: 8192,\n    temperature: 0.7,\n    maxToolIterations: 20,\n    maxRequestsPerTurn: 50,\n    maxToolFailuresPerTurn: 3,\n  };\n  config.agents.defaults.workspace = workspacePath;\n  return config.agents.defaults;\n}\n\nfunction setPrimaryModel(config: Config, workspacePath: string, modelRef: string): Config {\n  const defaults = ensureAgentDefaults(config, workspacePath);\n  defaults.models = { ...defaults.models, chat: { primary: modelRef, fallbacks: [] } };\n  return config;\n}\n\nfunction formatRecommended(provider: string): string | undefined {\n  const labels = getRecommendedModelsForProvider(provider, 3).map((m) => m.name || m.id);\n  return labels.length > 0 ? `Recommended: ${labels.join(', ')}` : getProviderHint(provider);\n}\n\nfunction providerChoices(): Array<{ value: string; name: string; description?: string }> {\n  const providers = sortProvidersForPicker(getAllProviders());\n  const choices = providers.map((provider) => ({\n    value: provider,\n    name: getProviderDisplayName(provider),\n    description: formatRecommended(provider),\n  }));\n  choices.push({\n    value: 'custom-api',\n    name: 'Custom API',\n    description: 'OpenAI-compatible, OpenAI Responses, or Anthropic-compatible endpoint',\n  });\n  return choices;\n}\n\nfunction modelChoiceName(choice: ModelChoice): string {\n  return choice.description ? `${choice.name}  ${colors.gray(choice.description)}` : choice.name;\n}\n\nfunction getModelsForProvider(provider: string): ModelChoice[] {\n  return sortModelsForPicker(getModelsByProvider(provider)).map((m) => {\n    const badges = [m.reasoning ? 'reasoning' : '', m.input?.includes('image') ? 'vision' : '']\n      .filter(Boolean)\n      .join(', ');\n    return {\n      value: `${m.provider}/${m.id}`,\n      name: m.name || m.id,\n      description: badges || undefined,\n    };\n  });\n}\n\nasync function doOAuthLogin(provider: string): Promise<boolean> {\n  const config = getOAuthProvider(provider);\n  if (!config) {\n    console.error(`OAuth not supported for provider: ${provider}`);\n    return false;\n  }\n\n  console.log(`\\n🔐 Starting ${config.displayName} OAuth login...`);\n  try {\n    await runCliOAuthLogin({ provider, onProgress: (message) => console.log(' →', message) });\n    return true;\n  } catch (error) {\n    console.error('❌ OAuth login failed:', error);\n    return false;\n  }\n}\n\nfunction joinEndpoint(baseUrl: string, suffix: string): string {\n  return `${baseUrl.replace(/\\/+$/, '')}/${suffix.replace(/^\\/+/, '')}`;\n}\n\nasync function probeCustomProvider(params: {\n  baseUrl: string;\n  apiKey: string;\n  modelId: string;\n  api: CustomApiKind;\n}): Promise<void> {\n  const timeout = AbortSignal.timeout(30_000);\n  const commonHeaders = {\n    'content-type': 'application/json',\n    authorization: `Bearer ${params.apiKey}`,\n  };\n\n  const request =\n    params.api === 'anthropic-messages'\n      ? {\n          url: joinEndpoint(params.baseUrl, '/messages'),\n          headers: { ...commonHeaders, 'anthropic-version': '2023-06-01' },\n          body: { model: params.modelId, max_tokens: 1, messages: [{ role: 'user', content: 'ping' }] },\n        }\n      : params.api === 'openai-responses'\n        ? {\n            url: joinEndpoint(params.baseUrl, '/responses'),\n            headers: commonHeaders,\n            body: { model: params.modelId, input: 'ping', max_output_tokens: 1 },\n          }\n        : {\n            url: joinEndpoint(params.baseUrl, '/chat/completions'),\n            headers: commonHeaders,\n            body: { model: params.modelId, messages: [{ role: 'user', content: 'ping' }], max_tokens: 1 },\n          };\n\n  const res = await fetch(request.url, {\n    method: 'POST',\n    headers: request.headers,\n    body: JSON.stringify(request.body),\n    signal: timeout,\n  });\n  if (!res.ok) {\n    const text = await res.text().catch(() => '');\n    throw new Error(`Probe failed (${res.status}) at ${request.url}${text ? `: ${text.slice(0, 300)}` : ''}`);\n  }\n}\n\nfunction defaultProviderIdFromBaseUrl(baseUrl: string): string {\n  try {\n    const url = new URL(baseUrl);\n    return url.hostname\n      .replace(/^api\\./, '')\n      .split('.')\n      .filter(Boolean)\n      .slice(0, 2)\n      .join('-')\n      .toLowerCase()\n      .replace(/[^a-z0-9-_]+/g, '-')\n      .replace(/^-+|-+$/g, '') || 'custom';\n  } catch {\n    return 'custom';\n  }\n}\n\nfunction validateProviderId(value: string): true | string {\n  return /^[a-z0-9]([a-z0-9-_]*[a-z0-9])?$/.test(value)\n    ? true\n    : 'Use lowercase letters, numbers, hyphens, or underscores; start/end with a letter or number.';\n}\n\nasync function setupCustomApi(config: Config, ctx: CLIContext): Promise<Config> {\n  console.log('\\n🔌 Custom API provider\\n');\n\n  const baseUrl = (await input({\n    message: 'API base URL:',\n    default: 'https://api.example.com/v1',\n    validate: (value) => URL.canParse(value) || 'Enter a valid URL',\n  })).trim();\n\n  const apiKey = (await input({\n    message: 'API key:',\n    validate: (value) => value.trim().length > 0 || 'Required',\n  })).trim();\n\n  const api = await select<CustomApiKind>({\n    message: 'Compatibility:',\n    choices: [\n      { value: 'openai-completions', name: 'OpenAI-compatible Chat Completions' },\n      { value: 'openai-responses', name: 'OpenAI Responses' },\n      { value: 'anthropic-messages', name: 'Anthropic Messages' },\n    ],\n  });\n\n  const modelId = (await input({\n    message: 'Model ID:',\n    validate: (value) => value.trim().length > 0 || 'Required',\n  })).trim();\n\n  console.log('\\n→ Probing endpoint...');\n  await probeCustomProvider({ baseUrl, apiKey, modelId, api });\n  console.log(colors.green('✓ Probe succeeded'));\n\n  const existingProviders = new Set(getAllProviders());\n  const providerId = (await input({\n    message: 'Provider ID:',\n    default: defaultProviderIdFromBaseUrl(baseUrl),\n    validate: (value) => {\n      const valid = validateProviderId(value.trim());\n      if (valid !== true) return valid;\n      if (existingProviders.has(value.trim())) return 'Provider ID already exists; choose a new ID.';\n      return true;\n    },\n  })).trim();\n\n  const path = getModelsJsonPath();\n  const { config: modelsConfig } = loadModelsJson(path);\n  const nextModelsConfig: ModelsJsonConfig = {\n    providers: {\n      ...(modelsConfig.providers ?? {}),\n      [providerId]: {\n        baseUrl,\n        apiKey,\n        api,\n        models: [{ id: modelId, name: modelId, api, contextWindow: 128000, input: ['text'] }],\n      },\n    },\n  };\n  const saved = saveModelsJson(path, nextModelsConfig);\n  if (!saved.success) {\n    throw new Error(saved.error || 'Failed to save models.json');\n  }\n  getModelRegistry().refresh();\n\n  const ref = `${providerId}/${modelId}`;\n  console.log('\\n✅ Custom model configured:', ref);\n  return setPrimaryModel(config, ctx.workspacePath, ref);\n}\n\nasync function ensureProviderCredential(provider: string, providerName: string): Promise<boolean> {\n  const existingProfiles = listProfilesForProvider(provider);\n  if (existingProfiles.length > 0) {\n    console.log(`\\n${colors.green('✓')} Found existing credentials for ${providerName}`);\n    return await confirm({ message: 'Use existing credentials?', default: true });\n  }\n\n  const envKey = getApiKeyFromEnv(provider);\n  if (envKey) {\n    console.log(`\\n${colors.green('✓')} Found API key for ${providerName} in environment`);\n    return true;\n  }\n\n  const supportsOAuth = providerSupportsOAuth(provider);\n  const supportsApiKey = providerSupportsApiKey(provider);\n\n  if (supportsOAuth && !supportsApiKey) {\n    return await doOAuthLogin(provider);\n  }\n\n  let useOAuth = false;\n  if (supportsOAuth && supportsApiKey) {\n    const authMethod = await select<'api_key' | 'oauth'>({\n      message: `How would you like to authenticate with ${providerName}?`,\n      choices: [\n        { value: 'api_key', name: 'API key' },\n        { value: 'oauth', name: 'OAuth login' },\n      ],\n    });\n    useOAuth = authMethod === 'oauth';\n  }\n\n  if (useOAuth) {\n    const ok = await doOAuthLogin(provider);\n    if (ok) return true;\n    console.log('\\n⚠️ OAuth login failed. Enter an API key instead.');\n  }\n\n  if (!supportsApiKey) return false;\n  const apiKey = await input({\n    message: `API key for ${providerName}:`,\n    validate: (value) => value.trim().length > 0 || 'Required',\n  });\n  const resolver = new CredentialResolver();\n  await resolver.saveApiKey(provider, apiKey.trim(), { profileName: 'default' });\n  return true;\n}\n\nexport async function setupModel(existingConfig: Config | null, ctx: CLIContext): Promise<Config> {\n  console.log('\\n🤖 Step: AI Model\\n');\n\n  const config = existingConfig || ({} as Config);\n  const currentModel = config?.agents?.defaults?.models?.chat?.primary;\n\n  if (currentModel) {\n    console.log('Current model:', currentModel);\n    const keepCurrent = await confirm({ message: 'Keep using this model?', default: true });\n    if (keepCurrent) {\n      console.log('✅ Keeping:', currentModel);\n      return config;\n    }\n  }\n\n  const provider = await select({\n    message: 'Model/auth provider:',\n    choices: providerChoices(),\n  });\n\n  if (provider === 'custom-api') {\n    return await setupCustomApi(config, ctx);\n  }\n\n  const providerName = getProviderDisplayName(provider);\n  const credentialOk = await ensureProviderCredential(provider, providerName);\n  if (!credentialOk) {\n    console.error(`\\n❌ Could not configure credentials for ${providerName}.`);\n    return config;\n  }\n\n  const modelChoices = getModelsForProvider(provider);\n  if (modelChoices.length === 0) {\n    throw new Error(`No catalog models found for ${providerName}. Add a Custom API provider instead.`);\n  }\n\n  console.log(`\\n📋 Models for ${providerName}:`);\n  const model = await select({\n    message: 'Model:',\n    choices: modelChoices.map((choice) => ({ ...choice, name: modelChoiceName(choice) })),\n  });\n\n  console.log('\\n✅ Model configured:', model);\n  return setPrimaryModel(config, ctx.workspacePath, model);\n}\n"],"mappings":"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"}

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

@@ -1,7 +1,6 @@
 import { ConfigSchema, init_schema } from "../../config/schema.js";
 import { saveConfig } from "../../config/loader.js";
 import { resolveGatewayLocalClientHost } from "../../config/gateway-bind.js";
-import { isWeixinOnboardConfigured } from "../../../extensions/weixin/src/adapters/onboard-cli.js";
 import { formatExamples, register } from "../registry.js";
 import "../../config/index.js";
 import { seedMainAgentProfileMarkdown } from "../../agent/context/workspace-seed.js";
@@ -19,7 +18,7 @@ function isInteractive() {
 }
 async function setupNonInteractive(_configPath, existingConfig) {
 	console.log("\n🤖 AI Model Configuration (Non-Interactive Mode)\n");
-	console.log("Current config:", JSON.stringify(existingConfig.agents?.defaults?.model, null, 2));
+	console.log("Current config:", JSON.stringify(existingConfig.agents?.defaults?.models?.chat, null, 2));
 	console.log("\n💡 To configure in interactive mode, run: xopc onboard");
 	console.log("💡 Or set up manually in:", _configPath);
 	return existingConfig;
@@ -28,7 +27,7 @@ function createOnboardCommand(ctx) {
 	return new Command("onboard").description("Interactive setup wizard for xopc (gateway uses schema defaults)").addHelpText("after", formatExamples([
 		"xopc onboard              # Full interactive setup",
 		"xopc onboard --model      # Configure LLM model only",
-		"xopc onboard --channels   # Configure channels (incl. Weixin QR)",
+		"xopc onboard --channels   # Configure messaging channels",
 		"xopc onboard --gateway    # Apply default gateway settings (quiet)"
 	])).option("--model", "Configure LLM provider and model").option("--channels", "Configure messaging channels").option("--gateway", "Configure gateway WebUI").option("--all", "Configure everything (default)").action(async (options) => {
 		try {
@@ -71,7 +70,7 @@ async function runOnboard(options, ctx) {
 	} else {
 		if (doModel) config = await setupModel(config, ctx);
 		if (doChannels) {
-			const channelIds = getChannelConfigurators().map((c) => c.id);
+			const channelIds = (await getChannelConfigurators(config)).map((c) => c.id);
 			console.log(colors.gray(`\nChannel onboarding: ${channelIds.join(", ")}\n`));
 			config = await setupChannels(config);
 		}
@@ -127,7 +126,7 @@ async function startGatewayAsService(config, ctx) {
 	const { startGatewayNow } = await import("./onboard/gateway.js");
 	await startGatewayNow(config, ctx);
 }
-async function promptLaunchAfterOnboard(config, ctx, flags) {
+async function promptLaunchAfterOnboard(config, ctx, _flags) {
 	console.log("");
 	const choice = await select({
 		message: "How do you want to launch xopc now?",
@@ -155,7 +154,6 @@ async function promptLaunchAfterOnboard(config, ctx, flags) {
 		return;
 	}
 	if (choice === "tui") {
-		if (flags.doChannels && !isWeixinOnboardConfigured(config)) console.log(colors.gray("\n💡 Weixin is not logged in yet. When ready run: xopc channels login --channel weixin\n"));
 		const { runTui } = await import("../../tui/tui.js");
 		await runTui({ local: true });
 		return;

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":"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"}
+{"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/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. */