Class AgentConfigLoader

apps/vscode/src/core/task/tools/subagent/AgentConfigLoader.ts:157–355

export type AgentConfigChangeListener = (configs: ReadonlyMap<string, AgentBaseConfig>, error?: Error) => void

export class AgentConfigLoader {
	private static instance?: AgentConfigLoader

	private readonly homeDir: string
	private readonly directoryPath: string
	private readonly initialLoadPromise: Promise<void>
	private watcher?: FSWatcher
	private cachedConfigs = new Map<string, AgentBaseConfig>()
	private cachedAgentToolNames = new Map<string, string>()
	private cachedToolNameToAgentName = new Map<string, string>()
	private listeners = new Set<AgentConfigChangeListener>()

	private constructor(homeDir = os.homedir()) {
		this.homeDir = homeDir
		this.directoryPath = getAgentsConfigPath(homeDir)
		this.initialLoadPromise = this.load()
			.then(() => undefined)
			.catch((error) => {
				Logger.error("[AgentConfigLoader] Failed to load initial agent configs", error)
			})
			.finally(() =>
				this.watch().catch((error) => Logger.error("[AgentConfigLoader] Failed to start watching agent configs", error)),
			)
	}

	public static getInstance(homeDir = os.homedir()): AgentConfigLoader {
		if (!AgentConfigLoader.instance) {
			AgentConfigLoader.instance = new AgentConfigLoader(homeDir)
		}
		return AgentConfigLoader.instance
	}

	/**
	 * Test-only helper to clear singleton state between unit tests.
	 */
	public static async resetInstanceForTests(): Promise<void> {
		if (!AgentConfigLoader.instance) {
			return
		}

		await AgentConfigLoader.instance.dispose()
		AgentConfigLoader.instance = undefined
	}

	public getConfigPath(): string {
		return this.directoryPath
	}

	public async ready(): Promise<void> {
		await this.initialLoadPromise
	}

	public getCachedConfig(subagentName?: string): AgentBaseConfig | undefined {
		if (!subagentName?.trim()) {
			return undefined
		}
		return this.cachedConfigs.get(normalizeAgentName(subagentName))
	}