---
title: "Interface: SessionStateManager"
editUrl: true
head: []
template: doc
sidebar:
  hidden: false
  attrs: {}
pagefind: true
draft: false
---

[**Prefactor TypeScript SDK**](../../../index.md)

***

[Prefactor TypeScript SDK](../../../modules.md) / [@prefactor/openclaw-prefactor-plugin](../index.md) / SessionStateManager

# Interface: SessionStateManager

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:63](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L63)

## Methods

### stop()

> **stop**(): `void`

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:102](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L102)

#### Returns

`void`

***

### createSessionSpan()

> **createSessionSpan**(`sessionKey`): `Promise`\<`string` \| `null`\>

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:133](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L133)

#### Parameters

##### sessionKey

`string`

#### Returns

`Promise`\<`string` \| `null`\>

***

### closeSessionSpan()

> **closeSessionSpan**(`sessionKey`): `Promise`\<`void`\>

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:137](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L137)

#### Parameters

##### sessionKey

`string`

#### Returns

`Promise`\<`void`\>

***

### createOrGetInteractionSpan()

> **createOrGetInteractionSpan**(`sessionKey`): `Promise`\<`string` \| `null`\>

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:141](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L141)

#### Parameters

##### sessionKey

`string`

#### Returns

`Promise`\<`string` \| `null`\>

***

### closeInteractionSpan()

> **closeInteractionSpan**(`sessionKey`, `status?`): `Promise`\<`void`\>

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:145](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L145)

#### Parameters

##### sessionKey

`string`

##### status?

`"complete"` | `"failed"` | `"cancelled"`

#### Returns

`Promise`\<`void`\>

***

### createUserMessageSpan()

> **createUserMessageSpan**(`sessionKey`, `payload`): `Promise`\<`string` \| `null`\>

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:152](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L152)

#### Parameters

##### sessionKey

`string`

##### payload

`Record`\<`string`, `unknown`\>

#### Returns

`Promise`\<`string` \| `null`\>

***

### createAgentRunSpan()

> **createAgentRunSpan**(`sessionKey`, `payload`): `Promise`\<`string` \| `null`\>

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:159](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L159)

#### Parameters

##### sessionKey

`string`

##### payload

`Record`\<`string`, `unknown`\>

#### Returns

`Promise`\<`string` \| `null`\>

***

### closeAgentRunSpan()

> **closeAgentRunSpan**(`sessionKey`, `status?`): `Promise`\<`void`\>

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:166](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L166)

#### Parameters

##### sessionKey

`string`

##### status?

`"complete"` | `"failed"` | `"cancelled"`

#### Returns

`Promise`\<`void`\>

***

### createToolCallSpan()

> **createToolCallSpan**(`sessionKey`, `toolName`, `payload`): `Promise`\<`string` \| `null`\>

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:173](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L173)

#### Parameters

##### sessionKey

`string`

##### toolName

`string`

##### payload

`Record`\<`string`, `unknown`\>

#### Returns

`Promise`\<`string` \| `null`\>

***

### closeToolCallSpanWithResult()

> **closeToolCallSpanWithResult**(`sessionKey`, `toolCallId`, `toolName`, `resultText`, `isError`): `Promise`\<`void`\>

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:183](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L183)

#### Parameters

##### sessionKey

`string`

##### toolCallId

`string`

##### toolName

`string`

##### resultText

`string` | `undefined`

##### isError

`boolean`

#### Returns

`Promise`\<`void`\>

***

### createAssistantResponseSpan()

> **createAssistantResponseSpan**(`sessionKey`, `text`, `tokens`, `metadata?`): `Promise`\<`string` \| `null`\>

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:195](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L195)

#### Parameters

##### sessionKey

`string`

##### text

`string`

##### tokens

\{ `input?`: `number`; `output?`: `number`; `cacheRead?`: `number`; `cacheWrite?`: `number`; `total?`: `number`; \} | `undefined`

##### metadata?

###### provider?

`string`

###### model?

`string`

#### Returns

`Promise`\<`string` \| `null`\>

***

### createAgentThinkingSpan()

> **createAgentThinkingSpan**(`sessionKey`, `thinking`, `tokens`, `metadata?`): `Promise`\<`string` \| `null`\>

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:208](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L208)

#### Parameters

##### sessionKey

`string`

##### thinking

`string`

##### tokens

\{ `input?`: `number`; `output?`: `number`; `cacheRead?`: `number`; `cacheWrite?`: `number`; `total?`: `number`; \} | `undefined`

##### metadata?

###### provider?

`string`

###### model?

`string`

###### signature?

`string`

#### Returns

`Promise`\<`string` \| `null`\>

***

### cleanupAllSessions()

> **cleanupAllSessions**(): `Promise`\<`void`\>

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:221](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L221)

#### Returns

`Promise`\<`void`\>

***

### getSessionState()

> **getSessionState**(`sessionKey`): `SessionSpanState` \| `undefined`

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:243](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L243)

#### Parameters

##### sessionKey

`string`

#### Returns

`SessionSpanState` \| `undefined`

***

### getAllSessionKeys()

> **getAllSessionKeys**(): `string`[]

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:247](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L247)

#### Returns

`string`[]

***

### hasActiveInteraction()

> **hasActiveInteraction**(`sessionKey`): `boolean`

Defined in: [packages/openclaw-prefactor-plugin/src/session-state.ts:251](https://github.com/prefactordev/typescript-sdk/blob/231423a775642bec119a2db45acf108c6383d05d/packages/openclaw-prefactor-plugin/src/session-state.ts#L251)

#### Parameters

##### sessionKey

`string`

#### Returns

`boolean`