coleam00/Archon · error

DEFAULT_AI_ASSISTANT='${envAssistant}' is not a registered p

Error message

DEFAULT_AI_ASSISTANT='${envAssistant}' is not a registered provider. Available providers: ${getRegisteredProviderNames().join(', ')}

What it means

Error "DEFAULT_AI_ASSISTANT='${envAssistant}' is not a registered provider. Available providers: ${getRegisteredProviderNames().join(', ')}" thrown in coleam00/Archon.

Source

Thrown at packages/core/src/config/config-loader.ts:441

): MergedConfig {
  // Bot name override
  const envBotName = process.env.BOT_DISPLAY_NAME;
  if (envBotName) {
    config.botName = envBotName;
  }

  // DEFAULT_AI_ASSISTANT is a fallback default: only applies when no config file
  // has explicitly set the assistant. An explicit save via the Web UI (or a repo
  // .archon/config.yaml) takes precedence over the env var.
  const envAssistant = process.env.DEFAULT_AI_ASSISTANT;
  if (envAssistant && envAssistant.length > 0) {
    const hasExplicitConfig =
      Boolean(globalConfig?.defaultAssistant) || Boolean(repoConfig?.assistant);
    if (!hasExplicitConfig) {
      if (isRegisteredProvider(envAssistant)) {
        config.assistant = envAssistant;
      } else {
        throw new Error(
          `DEFAULT_AI_ASSISTANT='${envAssistant}' is not a registered provider. ` +
            `Available providers: ${getRegisteredProviderNames().join(', ')}`
        );
      }
    } else if (!isRegisteredProvider(envAssistant)) {
      // Config file takes precedence, but warn that the env var value is unknown —
      // a typo here would go undetected if we don't surface it.
      getLog().warn(
        { envAssistant, available: getRegisteredProviderNames() },
        'config.env_assistant_unknown_ignored'
      );
    }
  }

  // Streaming overrides
  const streamingModes = ['stream', 'batch'] as const;
  const telegramMode = process.env.TELEGRAM_STREAMING_MODE;
  if (telegramMode && streamingModes.includes(telegramMode as 'stream' | 'batch')) {

View on GitHub (pinned to 0773b97458)

When it happens

Trigger: Thrown at packages/core/src/config/config-loader.ts:441 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of coleam00/Archon@0773b97458 (2026-09-01). Data as JSON: /api/errors/b7cee87d21b911fc. Report an issue: GitHub.