# ExperimentStoreContract > Tracon documentation. Tracon is a .NET package family that adds a control > plane on Microsoft Agent Framework, published as NuGet packages that run > inside your own ASP.NET Core application. > > Page: https://tracon.dev/api/tracon.testing.contracts.storage.experimentstorecontract/ > Summary: ExperimentStoreContract: Behavior tests for the IExperimentStore contract.
Namespace Tracon.Testing.Contracts.Storage ยท Assembly Tracon.Testing.Contracts.Xunit.dll
Behavior tests for the [IExperimentStore](/api/tracon.iexperimentstore/) contract. ```csharp public abstract class ExperimentStoreContract : TenantIsolationContract, IAsyncLifetime, IAsyncDisposable ```
Inheritance
object โ† StoreCancellationContract<IExperimentStore> โ† TenantIsolationContract<IExperimentStore> โ† ExperimentStoreContract
Implements
IAsyncLifetime, IAsyncDisposable
Inherited Members
TenantIsolationContract<IExperimentStore>.TenantA, TenantIsolationContract<IExperimentStore>.TenantB, TenantIsolationContract<IExperimentStore>.UseAmbientTenant(MutableTenantContext), TenantIsolationContract<IExperimentStore>.SeedAsync(string, string, CancellationToken), TenantIsolationContract<IExperimentStore>.ExistsAsync(string, object), TenantIsolationContract<IExperimentStore>.CountAsync(string, CancellationToken), TenantIsolationContract<IExperimentStore>.TryDeleteAsync(string, object), TenantIsolationContract<IExperimentStore>.TryOverwriteAsync(string, string), TenantIsolationContract<IExperimentStore>.CancellableReadAsync(CancellationToken), TenantIsolationContract<IExperimentStore>.CancellableWriteAsync(CancellationToken), TenantIsolationContract<IExperimentStore>.WroteAnythingAsync(), TenantIsolationContract<IExperimentStore>.Tenant_cannot_read_another_tenants_record(), TenantIsolationContract<IExperimentStore>.Tenant_reads_its_own_record(), TenantIsolationContract<IExperimentStore>.Tenant_does_not_see_another_tenants_record_in_the_list(), TenantIsolationContract<IExperimentStore>.Tenant_cannot_delete_another_tenants_record(), TenantIsolationContract<IExperimentStore>.Same_name_lives_independently_across_two_tenants(), TenantIsolationContract<IExperimentStore>.AmbientTenant, StoreCancellationContract<IExperimentStore>.CreateStoreAsync(), StoreCancellationContract<IExperimentStore>.InitializeAsync(), StoreCancellationContract<IExperimentStore>.DisposeAsync(), StoreCancellationContract<IExperimentStore>.OnDisposeAsync(), StoreCancellationContract<IExperimentStore>.CancellableReadAsync(CancellationToken), StoreCancellationContract<IExperimentStore>.CancellableWriteAsync(CancellationToken), StoreCancellationContract<IExperimentStore>.WroteAnythingAsync(), StoreCancellationContract<IExperimentStore>.Canceled_token_throws_on_read(), StoreCancellationContract<IExperimentStore>.The_write_this_contract_checks_can_be_read_back(), StoreCancellationContract<IExperimentStore>.Canceled_token_throws_on_write_and_leaves_no_trace(), StoreCancellationContract<IExperimentStore>.Store, object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
## Remarks These tests run for **every implementation**. A behavior difference between the in-memory store and the PostgreSQL store is a bug; this class catches that difference. ## Constructors ### ExperimentStoreContract\(\) ```csharp protected ExperimentStoreContract() ``` ## Methods ### Canary\_policy\_can\_be\_set\_on\_a\_draft\_experiment\_too\(\) ```csharp [Fact] public Task Canary_policy_can_be_set_on_a_draft_experiment_too() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Canary\_policy\_is\_cleared\_with\_null\(\) ```csharp [Fact] public Task Canary_policy_is_cleared_with_null() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Canary\_policy\_is\_set\_and\_read\_back\(\) ```csharp [Fact] public Task Canary_policy_is_set_and_read_back() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Canary\_ramp\_is\_rejected\_on\_a\_non\_running\_experiment\(\) ```csharp [Fact] public Task Canary_ramp_is_rejected_on_a_non_running_experiment() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Canary\_ramp\_updates\_weights\_on\_a\_running\_experiment\_and\_stays\_Running\(\) ```csharp [Fact] public Task Canary_ramp_updates_weights_on_a_running_experiment_and_stays_Running() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### CountAsync\(string, CancellationToken\) Reports how many records the given tenant sees through the listing endpoint. ```csharp protected override ValueTask CountAsync(string tenantId, CancellationToken cancellationToken) ``` #### Parameters `tenantId` [string](https://learn.microsoft.com/dotnet/api/system.string) The reading tenant. `cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken) The token every store call inside the hook must be handed; see [TenantIsolationContract.SeedAsync](/api/tracon.testing.contracts.storage/). #### Returns [ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask\-1)<[int](https://learn.microsoft.com/dotnet/api/system.int32)\> The number of records seen. ### Deleting\_nonexistent\_experiment\_returns\_false\(\) ```csharp [Fact] public Task Deleting_nonexistent_experiment_returns_false() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Draft\_experiment\_can\_be\_deleted\(\) ```csharp [Fact] public Task Draft_experiment_can_be_deleted() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Draft\_experiment\_can\_be\_updated\(\) ```csharp [Fact] public Task Draft_experiment_can_be_updated() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### ExistsAsync\(string, object\) Reports whether the record is visible from the given tenant's viewpoint. ```csharp protected override ValueTask ExistsAsync(string tenantId, object key) ``` #### Parameters `tenantId` [string](https://learn.microsoft.com/dotnet/api/system.string) The reading tenant. `key` [object](https://learn.microsoft.com/dotnet/api/system.object) The key returned by [TenantIsolationContract.SeedAsync](/api/tracon.testing.contracts.storage/). #### Returns [ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask\-1)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\> [true](https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool) if the record is visible. ### Experiment\_lifecycle\_does\_not\_leak\_across\_tenants\(\) ```csharp [Fact] public Task Experiment_lifecycle_does_not_leak_across_tenants() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### ListRunningWithCanaryAsync\_returns\_only\_running\_experiments\_with\_canary\_defined\(\) ```csharp [Fact] public Task ListRunningWithCanaryAsync_returns_only_running_experiments_with_canary_defined() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Listing\_returns\_only\_that\_tenant\(\) ```csharp [Fact] public Task Listing_returns_only_that_tenant() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Non\_running\_experiment\_cannot\_be\_stopped\(\) ```csharp [Fact] public Task Non_running_experiment_cannot_be_stopped() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Nonexistent\_experiment\_cannot\_be\_started\(\) ```csharp [Fact] public Task Nonexistent_experiment_cannot_be_started() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Returns\_null\_when\_no\_experiment\_is\_running\(\) ```csharp [Fact] public Task Returns_null_when_no_experiment_is_running() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Rollback\_stops\_the\_experiment\_restores\_weights\_and\_records\_the\_reason\(\) ```csharp [Fact] public Task Rollback_stops_the_experiment_restores_weights_and_records_the_reason() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Running\_experiment\_cannot\_be\_deleted\(\) ```csharp [Fact] public Task Running_experiment_cannot_be_deleted() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Running\_experiment\_cannot\_be\_updated\(\) ```csharp [Fact] public Task Running_experiment_cannot_be_updated() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Save\_and\_get\_round\_trips\(\) ```csharp [Fact] public Task Save_and_get_round_trips() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Saving\_a\_draft\_again\_keeps\_its\_canary\_policy\(\) ```csharp [Fact] public Task Saving_a_draft_again_keeps_its_canary_policy() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Saving\_never\_writes\_the\_canary\_policy\(\) ```csharp [Fact] public Task Saving_never_writes_the_canary_policy() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Second\_start\_for\_same\_agent\_is\_rejected\(\) ```csharp [Fact] public Task Second_start_for_same_agent_is_rejected() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### SeedAsync\(string, string, CancellationToken\) Writes a sample record for the given tenant. ```csharp protected override ValueTask SeedAsync(string tenantId, string name, CancellationToken cancellationToken) ``` #### Parameters `tenantId` [string](https://learn.microsoft.com/dotnet/api/system.string) The tenant that owns the record. `name` [string](https://learn.microsoft.com/dotnet/api/system.string) The name distinguishing the record. The same name may be used by two tenants. `cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken) The token every store call inside the hook must be handed. The cancellation contract calls this hook with a token that is already cancelled, so a hook that drops the token reports a store as sound when it is not. #### Returns [ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask\-1)<[object](https://learn.microsoft.com/dotnet/api/system.object)\> The key to use for reading the record back. ### Setting\_canary\_policy\_is\_EXEMPT\_from\_the\_draft\_only\_edit\_restriction\(\) ```csharp [Fact] public Task Setting_canary_policy_is_EXEMPT_from_the_draft_only_edit_restriction() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Starting\_returns\_the\_running\_experiment\(\) ```csharp [Fact] public Task Starting_returns_the_running_experiment() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Stopping\_stops\_the\_experiment\_and\_frees\_the\_running\_slot\(\) ```csharp [Fact] public Task Stopping_stops_the_experiment_and_frees_the_running_slot() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### TryDeleteAsync\(string, object\) Attempts to delete the record on behalf of the given tenant. ```csharp protected override ValueTask TryDeleteAsync(string tenantId, object key) ``` #### Parameters `tenantId` [string](https://learn.microsoft.com/dotnet/api/system.string) The tenant attempting the delete. `key` [object](https://learn.microsoft.com/dotnet/api/system.object) The key returned by [TenantIsolationContract.SeedAsync](/api/tracon.testing.contracts.storage/). #### Returns [ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask\-1)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)?\> [true](https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool) if the delete succeeded, [false](https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool) if the record was not found; [null](https://learn.microsoft.com/dotnet/csharp/language-reference/keywords/null) if the store does not offer deletion.