Interface IVersionedAgentDefinitionRegistry

Namespace

JD.AI.Core.Agents

Assembly

JD.AI.Core.dll

Versioned registry for AgentDefinition instances supporting environment-scoped storage, semantic-version resolution, and environment promotion.

public interface IVersionedAgentDefinitionRegistry : IAgentDefinitionRegistry

Inherited Members

IAgentDefinitionRegistry.GetAll()

IAgentDefinitionRegistry.GetByName(string)

IAgentDefinitionRegistry.Register(AgentDefinition)

IAgentDefinitionRegistry.GetByTag(string)

Methods

ListAsync(string, CancellationToken)

Lists all definitions in the given environment, optionally filtered by name.

Task<IReadOnlyList<AgentDefinition>> ListAsync(string environment = "dev", CancellationToken cancellationToken = default)

Parameters

environment string

cancellationToken CancellationToken

Returns

Task<IReadOnlyList<AgentDefinition>>

PromoteAsync(string, string, string, string, CancellationToken)

Copies a definition from fromEnvironment to toEnvironment. The definition must be registered in the source environment.

Task PromoteAsync(string name, string version, string fromEnvironment, string toEnvironment, CancellationToken cancellationToken = default)

Parameters

name string

version string

fromEnvironment string

toEnvironment string

cancellationToken CancellationToken

Returns

Task

RegisterAsync(AgentDefinition, string, CancellationToken)

Persists the definition in the given environment scope. If a definition with the same name+version already exists it is overwritten.

Task RegisterAsync(AgentDefinition definition, string environment = "dev", CancellationToken cancellationToken = default)

Parameters

definition AgentDefinition

environment string

cancellationToken CancellationToken

Returns

Task

ResolveAsync(string, string?, string, CancellationToken)

Resolves a definition by name and optional version within the given environment. If version is null or "latest", the highest semver definition is returned. Returns null if not found.

Task<AgentDefinition?> ResolveAsync(string name, string? version = null, string environment = "dev", CancellationToken cancellationToken = default)

Parameters

name string

version string

environment string

cancellationToken CancellationToken

Returns

Task<AgentDefinition>

UnregisterAsync(string, string, string, CancellationToken)

Removes the named version from the given environment.

Task UnregisterAsync(string name, string version, string environment = "dev", CancellationToken cancellationToken = default)

Parameters

name string

version string

environment string

cancellationToken CancellationToken

Returns

Task