# InMemoryRunStore

Defined in: [packages/ai/src/activities/chat/middleware/run-store.ts:370](https://github.com/TanStack/ai/blob/main/packages/ai/src/activities/chat/middleware/run-store.ts#L370)

In-memory [RunStore](../interfaces/RunStore.md). Single process only.

## Implements

- [`RunStore`](../interfaces/RunStore.md)

## Constructors

### Constructor

```ts
new InMemoryRunStore(): InMemoryRunStore;
```

#### Returns

`InMemoryRunStore`

## Methods

### createOrResume()

```ts
createOrResume(input): Promise<RunRecord>;
```

Defined in: [packages/ai/src/activities/chat/middleware/run-store.ts:373](https://github.com/TanStack/ai/blob/main/packages/ai/src/activities/chat/middleware/run-store.ts#L373)

Create a run record, or return the existing one unchanged if `runId` is
already present.

INVARIANT (idempotency): an existing record is returned **unchanged** and
the passed `threadId`, `startedAt`, `status`, `parentRunId`,
`subagentRunId`, and `name` are ignored. This is what makes resuming a
run safe. `status` defaults to `'running'` on first creation. The three
link fields are copied only on the first insert.

#### Parameters

##### input

`Pick`\<[`RunRecord`](../interfaces/RunRecord.md), `"threadId"` \| `"runId"` \| `"startedAt"`\> & `object`

#### Returns

`Promise`\<[`RunRecord`](../interfaces/RunRecord.md)\>

#### Implementation of

[`RunStore`](../interfaces/RunStore.md).[`createOrResume`](../interfaces/RunStore.md#createorresume)

***

### findActiveRun()

```ts
findActiveRun(threadId): Promise<RunRecord | null>;
```

Defined in: [packages/ai/src/activities/chat/middleware/run-store.ts:453](https://github.com/TanStack/ai/blob/main/packages/ai/src/activities/chat/middleware/run-store.ts#L453)

The most recent `'running'` run for `threadId`, or `null` if none is active.

REQUIRED. This resolves "does this thread have a live run to attach to?"
from the STABLE thread id, which is the durable basis for reconnecting a
client (a reload, or the same thread opened on another device) — independent
of the ephemeral run id, which a single turn may mint several of. When more
than one run is `'running'`, the one with the greatest `startedAt` wins.

A backend that stubs this to `null` turns reconnect off silently, because
`null` is also the correct answer for an idle thread. A backend with no run
lifecycle at all should omit the whole `runs` store instead — capability
tiers belong at the store level, not the method level.

#### Parameters

##### threadId

`string`

#### Returns

`Promise`\<[`RunRecord`](../interfaces/RunRecord.md) \| `null`\>

#### Implementation of

[`RunStore`](../interfaces/RunStore.md).[`findActiveRun`](../interfaces/RunStore.md#findactiverun)

***

### get()

```ts
get(runId): Promise<RunRecord | null>;
```

Defined in: [packages/ai/src/activities/chat/middleware/run-store.ts:421](https://github.com/TanStack/ai/blob/main/packages/ai/src/activities/chat/middleware/run-store.ts#L421)

Current record, or null when unknown.

#### Parameters

##### runId

`string`

#### Returns

`Promise`\<[`RunRecord`](../interfaces/RunRecord.md) \| `null`\>

#### Implementation of

[`RunStore`](../interfaces/RunStore.md).[`get`](../interfaces/RunStore.md#get)

***

### listByParentRun()

```ts
listByParentRun(parentRunId): Promise<RunRecord[]>;
```

Defined in: [packages/ai/src/activities/chat/middleware/run-store.ts:432](https://github.com/TanStack/ai/blob/main/packages/ai/src/activities/chat/middleware/run-store.ts#L432)

Child runs started by `parentRunId`, ascending by `startedAt`.
OPTIONAL. `reconstructChat` uses this to put subagent cards back
on the parent assistant message. A store that omits it reloads the
text and not the cards.

#### Parameters

##### parentRunId

`string`

#### Returns

`Promise`\<[`RunRecord`](../interfaces/RunRecord.md)[]\>

#### Implementation of

[`RunStore`](../interfaces/RunStore.md).[`listByParentRun`](../interfaces/RunStore.md#listbyparentrun)

***

### listByThread()

```ts
listByThread(threadId): Promise<RunRecord[]>;
```

Defined in: [packages/ai/src/activities/chat/middleware/run-store.ts:425](https://github.com/TanStack/ai/blob/main/packages/ai/src/activities/chat/middleware/run-store.ts#L425)

Every run in a conversation, ascending by `startedAt`. OPTIONAL.
`reconstructChat` calls it to find the parent runs of children that a
tool call started. Without it those cards stay absent on reload.
Consumers feature-detect.

#### Parameters

##### threadId

`string`

#### Returns

`Promise`\<[`RunRecord`](../interfaces/RunRecord.md)[]\>

#### Implementation of

[`RunStore`](../interfaces/RunStore.md).[`listByThread`](../interfaces/RunStore.md#listbythread)

***

### listReclaimable()

```ts
listReclaimable(opts): Promise<RunRecord[]>;
```

Defined in: [packages/ai/src/activities/chat/middleware/run-store.ts:439](https://github.com/TanStack/ai/blob/main/packages/ai/src/activities/chat/middleware/run-store.ts#L439)

Runs that may be reclaimed: ALL THREE of `status === 'running'`,
`detachedSince` is set, and `detachedSince <= now - ttlMs`. The cutoff is
**inclusive** — a run detached at exactly `now - ttlMs` IS reclaimable.

OPTIONAL: only needed by a reaper. Consumers feature-detect.

`detachedSince` is populated by `withSandbox`'s detach path (see
[RunRecord.detachedSince](../interfaces/RunRecord.md#detachedsince)). The sweep over the candidates this
surfaces is `@tanstack/ai-sandbox`'s `reapDetachedRuns`: it finalizes a run
whose agent already finished, expires one past its TTL, and reclaims the
sandbox. That is a function, not a scheduler — the application invokes it
(cron, queue, `alarm()`, `waitUntil`) — and a backend that omits this
method cannot be reaped at all.

#### Parameters

##### opts

###### now

`number`

###### ttlMs

`number`

#### Returns

`Promise`\<[`RunRecord`](../interfaces/RunRecord.md)[]\>

#### Implementation of

[`RunStore`](../interfaces/RunStore.md).[`listReclaimable`](../interfaces/RunStore.md#listreclaimable)

***

### update()

```ts
update(runId, patch): Promise<void>;
```

Defined in: [packages/ai/src/activities/chat/middleware/run-store.ts:400](https://github.com/TanStack/ai/blob/main/packages/ai/src/activities/chat/middleware/run-store.ts#L400)

Patch a record's mutable fields.

INVARIANT: updating an unknown `runId` is a **no-op** — it must not throw
and must not create a record.

#### Parameters

##### runId

`string`

##### patch

`Partial`\<`Pick`\<[`RunRecord`](../interfaces/RunRecord.md), 
  \| `"status"`
  \| `"finishedAt"`
  \| `"error"`
  \| `"usage"`
  \| `"sandboxKey"`
  \| `"detachedSince"`
  \| `"cancelRequested"`
  \| `"driverEpoch"`\>\>

#### Returns

`Promise`\<`void`\>

#### Implementation of

[`RunStore`](../interfaces/RunStore.md).[`update`](../interfaces/RunStore.md#update)