# WorkflowRequestStoreContract
> 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.workflowrequeststorecontract/
> Summary: WorkflowRequestStoreContract: Behavior tests for the IWorkflowRequestStore contract.
Behavior tests for the [IWorkflowRequestStore](/api/tracon.iworkflowrequeststore/) contract.
```csharp
public abstract class WorkflowRequestStoreContract : TenantIsolationContract, IAsyncLifetime, IAsyncDisposable
```
## Remarks
The store is the authority of two decisions a unit test of the runner cannot prove: which row
is THE open row of a logical request (the same request id in the same session held by several
runs), and which of an answer and an expiry reaches a row first. The first is a listing
question and the second is a race, so both are cases here.
The [Storage.TenantIsolationContract](/api/tracon.testing.contracts.storage/) hooks are wired to
[IWorkflowRequestStore.AddAsync](/api/tracon.iworkflowrequeststore/#Tracon_IWorkflowRequestStore_AddAsync_System_Collections_Generic_IReadOnlyList_Tracon_WorkflowRequestRecord__System_Threading_CancellationToken_) and [IWorkflowRequestStore.ListAsync](/api/tracon.iworkflowrequeststore/#Tracon_IWorkflowRequestStore_ListAsync_Tracon_WorkflowRequestQuery_System_Threading_CancellationToken_);
the store offers no delete, so another tenant's chance to change a row is
[IWorkflowRequestStore.MarkAnsweredAsync](/api/tracon.iworkflowrequeststore/#Tracon_IWorkflowRequestStore_MarkAnsweredAsync_System_String_System_String_System_Guid_System_DateTimeOffset_System_Threading_CancellationToken_), which has a case of its own.
## Constructors
### WorkflowRequestStoreContract\(\)
```csharp
protected WorkflowRequestStoreContract()
```
## Methods
### A\_closed\_row\_leaves\_the\_list\_and\_cannot\_be\_marked\_answered\(\)
```csharp
[Fact]
public Task A_closed_row_leaves_the_list_and_cannot_be_marked_answered()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### A\_logical\_request\_stays\_listed\_while\_an\_older\_run\_of\_it\_closes\(\)
```csharp
[Fact]
public Task A_logical_request_stays_listed_while_an_older_run_of_it_closes()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### A\_page\_outside\_the\_range\_is\_cut\_to\_it\(\)
```csharp
[Fact]
public Task A_page_outside_the_range_is_cut_to_it()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### A\_row\_expires\_at\_its\_time\_and\_not\_before\(\)
```csharp
[Fact]
public Task A_row_expires_at_its_time_and_not_before()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### A\_row\_is\_closed\_once\(\)
```csharp
[Fact]
public Task A_row_is_closed_once()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### A\_row\_without\_a\_time\_limit\_reads\_back\_without\_one\(\)
```csharp
[Fact]
public Task A_row_without_a_time_limit_reads_back_without_one()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### A\_run\_lists\_its\_requests\_in\_event\_order\(\)
```csharp
[Fact]
public Task A_run_lists_its_requests_in_event_order()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### A\_run\_that\_is\_closed\_or\_has\_an\_open\_row\_is\_not\_stranded\(\)
```csharp
[Fact]
public Task A_run_that_is_closed_or_has_an_open_row_is_not_stranded()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### A\_run\_that\_still\_waits\_after\_its\_last\_row\_closed\_is\_listed\_as\_stranded\(\)
```csharp
[Fact]
public Task A_run_that_still_waits_after_its_last_row_closed_is_listed_as_stranded()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### A\_second\_answer\_names\_its\_own\_run\_and\_keeps\_the\_first\_time\(\)
```csharp
[Fact]
public Task A_second_answer_names_its_own_run_and_keeps_the_first_time()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### A\_written\_row\_is\_read\_back\_with\_every\_field\(\)
```csharp
[Fact]
public Task A_written_row_is_read_back_with_every_field()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### Another\_tenant\_cannot\_mark\_a\_row\_answered\(\)
```csharp
[Fact]
public Task Another_tenant_cannot_mark_a_row_answered()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### Concurrent\_expiries\_close\_each\_row\_exactly\_once\(\)
```csharp
[Fact]
public Task Concurrent_expiries_close_each_row_exactly_once()
```
#### 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.
### EraseRunAsync\(Guid, string\)
Erases a run the way a data subject erasure does.
```csharp
protected virtual ValueTask EraseRunAsync(Guid runId, string tenantId)
```
#### Parameters
`runId` [Guid](https://learn.microsoft.com/dotnet/api/system.guid)
The run to erase.
`tenantId` [string](https://learn.microsoft.com/dotnet/api/system.string)
The run's tenant.
#### 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) when the run was erased; [false](https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool) when the store
under test has no run table to erase from, and the case does not apply.
### Erasing\_the\_run\_removes\_its\_rows\(\)
```csharp
[Fact]
public Task Erasing_the_run_removes_its_rows()
```
#### 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.
### Expiry\_closes\_only\_the\_open\_rows\_whose\_time\_has\_come\_and\_returns\_them\(\)
```csharp
[Fact]
public Task Expiry_closes_only_the_open_rows_whose_time_has_come_and_returns_them()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### Expiry\_closes\_the\_oldest\_deadlines\_first\_and\_no\_more\_than\_max\(\)
```csharp
[Fact]
public Task Expiry_closes_the_oldest_deadlines_first_and_no_more_than_max()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### Expiry\_closes\_the\_rows\_of\_every\_tenant\_and\_keeps\_the\_answer\_mark\(\)
```csharp
[Fact]
public Task Expiry_closes_the_rows_of_every_tenant_and_keeps_the_answer_mark()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### Marking\_answered\_marks\_every\_open\_row\_of\_the\_logical\_request\_and\_no\_other\(\)
```csharp
[Fact]
public Task Marking_answered_marks_every_open_row_of_the_logical_request_and_no_other()
```
#### Returns
[Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
### PrepareRunAsync\(Guid, string, string\)
Opens the run row an inbox row points at.
```csharp
protected virtual ValueTask PrepareRunAsync(Guid runId, string tenantId, string sessionId)
```
#### 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.
`sessionId` [string](https://learn.microsoft.com/dotnet/api/system.string)
The run's execution session.
#### Returns
[ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask)
The completion task.
#### Remarks
In the SQL implementations `workflow_requests.run_id` is a foreign key into
`runs`; the in-memory implementation has no such link, and the hook does nothing.
### SeedAsync\(string, string, CancellationToken\)
Writes a sample record for the given tenant.
```csharp
protected override ValueTask