Service for validating agents within the swarm system, managing agent schemas and dependencies. Provides methods to register agents, validate their configurations, and query associated resources (storages, states, dependencies). Integrates with AgentSchemaService (agent schema validation), SwarmSchemaService (swarm-level agent management), ToolValidationService (tool validation), CompletionValidationService (completion validation), StorageValidationService (storage validation), and LoggerService (logging). Uses dependency injection for service dependencies and memoization for efficient validation checks.
constructor();
loggerService: any
Logger service instance for logging validation operations and errors. Injected via DI, used for info-level logging controlled by GLOBAL_CONFIG.CC_LOGGER_ENABLE_INFO.
toolValidationService: any
Tool validation service instance for validating tools associated with agents. Injected via DI, used in validate method to check agent tools.
wikiValidationService: any
Wiki validation service instance for validating wikies associated with agents. Injected via DI, used in validate method to check agent wiki list.
completionValidationService: any
Completion validation service instance for validating completion configurations of agents. Injected via DI, used in validate method to check agent completion.
storageValidationService: any
Storage validation service instance for validating storages associated with agents. Injected via DI, used in validate method to check agent storages.
_agentMap: any
Map of agent names to their schemas, used for validation and resource queries. Populated by addAgent, queried by validate, getStorageList, getStateList, etc.
_agentDepsMap: any
Map of agent names to their dependency lists, tracking inter-agent dependencies. Populated by addAgent when dependsOn is present, queried by hasDependency.
getAgentList: () => string[]
Retrieves the list of registered agent names. Logs the operation if info-level logging is enabled, supporting SwarmSchemaService’s agent enumeration.
getStorageList: (agentName: string) => string[]
Retrieves the list of storage names associated with a given agent. Logs the operation and validates agent existence, supporting ClientStorage integration.
getWikiList: (agentName: string) => string[]
Retrieves the list of wiki names associated with a given agent.
getStateList: (agentName: string) => string[]
Retrieves the list of state names associated with a given agent. Logs the operation and validates agent existence, supporting ClientState integration.
addAgent: (agentName: string, agentSchema: IAgentSchema) => void
Registers a new agent with its schema in the validation service. Logs the operation and updates _agentMap and _agentDepsMap, supporting AgentSchemaService’s agent registration.
hasStorage: ((agentName: string, storageName: string) => boolean) & IClearableMemoize<string> & IControlMemoize<string, boolean>
Checks if an agent has a registered storage, memoized for performance. Logs the operation and validates agent existence, supporting ClientStorage validation.
hasWiki: ((agentName: string, wikiName: string) => boolean) & IClearableMemoize<string> & IControlMemoize<string, boolean>
Checks if an agent has declared wiki
hasDependency: ((targetAgentName: string, depAgentName: string) => boolean) & IClearableMemoize<string> & IControlMemoize<string, boolean>
Checks if an agent has a registered dependency on another agent, memoized for performance. Logs the operation, supporting inter-agent dependency validation within SwarmSchemaService.
hasState: ((agentName: string, stateName: string) => boolean) & IClearableMemoize<string> & IControlMemoize<string, boolean>
Checks if an agent has a registered state, memoized for performance. Logs the operation and validates agent existence, supporting ClientState validation.
validate: (agentName: string, source: string) => void
Validates an agent’s configuration by its name and source, memoized by agentName for performance. Checks the agent’s existence, completion, tools, and storages, delegating to respective validation services. Logs the operation, supporting AgentSchemaService’s validation workflow within SwarmSchemaService.