# RunInputStoreContract > 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.runinputstorecontract/ > Summary: RunInputStoreContract: Behavior tests for the IRunInputStore contract.

Namespace Tracon.Testing.Contracts.Storage · Assembly Tracon.Testing.Contracts.Xunit.dll

Behavior tests for the [IRunInputStore](/api/tracon.iruninputstore/) contract. ```csharp public abstract class RunInputStoreContract : StoreCancellationContract, IAsyncLifetime, IAsyncDisposable ```

Inheritance: object ← StoreCancellationContract<IRunInputStore> ← RunInputStoreContract
Implements: IAsyncLifetime, IAsyncDisposable
Inherited Members: StoreCancellationContract<IRunInputStore>.CreateStoreAsync(), StoreCancellationContract<IRunInputStore>.InitializeAsync(), StoreCancellationContract<IRunInputStore>.DisposeAsync(), StoreCancellationContract<IRunInputStore>.OnDisposeAsync(), StoreCancellationContract<IRunInputStore>.CancellableReadAsync(CancellationToken), StoreCancellationContract<IRunInputStore>.CancellableWriteAsync(CancellationToken), StoreCancellationContract<IRunInputStore>.WroteAnythingAsync(), StoreCancellationContract<IRunInputStore>.Canceled_token_throws_on_read(), StoreCancellationContract<IRunInputStore>.The_write_this_contract_checks_can_be_read_back(), StoreCancellationContract<IRunInputStore>.Canceled_token_throws_on_write_and_leaves_no_trace(), StoreCancellationContract<IRunInputStore>.Store, object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

## Remarks Every implementation must pass the same scenarios. The most valuable test is [RunInputStoreContract.Polymorphic_content_round_trips_with_KEY_ORDER_preserved](/api/tracon.testing.contracts.storage.runinputstorecontract/#Tracon_Testing_Contracts_Storage_RunInputStoreContract_Polymorphic_content_round_trips_with_KEY_ORDER_preserved): a store that reorders object keys on write (for example, one backed by a JSON-typed column) can silently move the `$type` discriminator away from the first property, and the read then fails with a `JsonException`. Neither the build nor the other tests catch this. ## Constructors ### RunInputStoreContract ```csharp protected RunInputStoreContract() ``` ## Methods ### A\_run\_with\_values\_and\_no\_messages\_still\_records\_the\_values ```csharp [Fact] public Task A_run_with_values_and_no_messages_still_records_the_values() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Another\_tenants\_input\_cannot\_be\_read ```csharp [Fact] public Task Another_tenants_input_cannot_be_read() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### CancellableReadAsync$CancellationToken$ Calls one **read** method of the store with the given token. ```csharp protected override ValueTask CancellableReadAsync(CancellationToken cancellationToken) ``` #### Parameters `cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken) The token the store must observe. #### Returns [ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask) The completion task; any result is discarded. ### CancellableWriteAsync$CancellationToken$ Calls one **write** method of the store with the given token. ```csharp protected override ValueTask CancellableWriteAsync(CancellationToken cancellationToken) ``` #### Parameters `cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken) The token the store must observe. #### Returns [ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask) The completion task. #### Remarks The write must be one [StoreCancellationContract.WroteAnythingAsync](/api/tracon.testing.contracts.storage/) can see. A write this contract cannot read back proves nothing about side effects, which is why [StoreCancellationContract.The_write_this_contract_checks_can_be_read_back](/api/tracon.testing.contracts.storage/) runs the same pair with a live token and requires the read to find it. ### Missing\_parameters\_and\_empty\_parameters\_stay\_distinct ```csharp [Fact] public Task Missing_parameters_and_empty_parameters_stay_distinct() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Parameter\_values\_round\_trip\_exactly ```csharp [Fact] public Task Parameter_values_round_trip_exactly() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Polymorphic\_content\_round\_trips\_with\_KEY\_ORDER\_preserved ```csharp [Fact] public Task Polymorphic_content_round_trips_with_KEY_ORDER_preserved() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### PrepareRunAsync$Guid, string$ Opens a run row at the given id before an input is written. ```csharp protected virtual ValueTask PrepareRunAsync(Guid runId, string tenantId) ``` #### Parameters `runId` [Guid](https://learn.microsoft.com/dotnet/api/system.guid) The run id. `tenantId` [string](https://learn.microsoft.com/dotnet/api/system.string) The tenant id. #### Returns [ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask) The completion task. #### Remarks In the SQL implementations, `run_inputs.run_id` is a foreign key into the `runs` table; the in-memory implementation has no such link, and the hook does nothing. ### Run\_without\_a\_record\_returns\_null ```csharp [Fact] public Task Run_without_a_record_returns_null() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Second\_write\_is\_IGNORED ```csharp [Fact] public Task Second_write_is_IGNORED() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Second\_write\_never\_changes\_the\_recorded\_parameters ```csharp [Fact] public Task Second_write_never_changes_the_recorded_parameters() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### Written\_input\_round\_trips\_exactly ```csharp [Fact] public Task Written_input_round_trips_exactly() ``` #### Returns [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task) ### WroteAnythingAsync Reports whether [StoreCancellationContract.CancellableWriteAsync](/api/tracon.testing.contracts.storage/) left anything behind. ```csharp protected override ValueTask WroteAnythingAsync() ``` #### 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 store holds any record the write would have created.