# SessionState

<!-- https://uncage.vercel.app/docs/api/react/interfaces/sessionstate/ -->

Defined in: react/src/state.ts:49

## Properties

| Property | Type | Description | Defined in |
| ------ | ------ | ------ | ------ |
| <a id="property-approvals"></a> `approvals` | `Record`\<`string`, `ApprovalRequest`\> | - | react/src/state.ts:57 |
| <a id="property-chunks"></a> `chunks` | `Record`\<`string`, [`ChunkCursor`](https://uncage.vercel.app/docs/api/react/interfaces/chunkcursor.md)\> | Internal: `message.delta` reassembly cursors, keyed by messageId. | react/src/state.ts:60 |
| <a id="property-connection"></a> `connection` | [`ConnectionState`](https://uncage.vercel.app/docs/api/react/type-aliases/connectionstate.md) | - | react/src/state.ts:52 |
| <a id="property-lastsequence"></a> `lastSequence` | `number` | - | react/src/state.ts:51 |
| <a id="property-lastwarning"></a> `lastWarning?` | `object` | The most recent `system.warning` (e.g. `setting_reset`: a stored setting the runtime no longer offers was dropped when `runId` started). `runId` is the run it was raised for, else the latest run when it arrived (absent if there was none), so UIs can hide it once a newer run starts. | react/src/state.ts:73 |
| `lastWarning.code` | `string` | - | react/src/state.ts:73 |
| `lastWarning.message` | `string` | - | react/src/state.ts:73 |
| `lastWarning.runId?` | `string` | - | react/src/state.ts:73 |
| <a id="property-messages"></a> `messages` | `Record`\<`string`, [`MessageView`](https://uncage.vercel.app/docs/api/react/interfaces/messageview.md)\> | - | react/src/state.ts:55 |
| <a id="property-pendingsettingsbase"></a> `pendingSettingsBase?` | `object` | Internal: the settings `pendingSettingsRunId` started with; reverting to them clears pending. | react/src/state.ts:67 |
| `pendingSettingsBase.effort?` | `"low"` \| `"medium"` \| `"high"` \| `"xhigh"` \| `"max"` | - | protocol/dist/index.d.ts:142 |
| `pendingSettingsBase.model?` | `string` | - | protocol/dist/index.d.ts:141 |
| `pendingSettingsBase.permissionMode` | `"default"` \| `"acceptEdits"` \| `"plan"` \| `"auto"` \| `"bypassPermissions"` | - | protocol/dist/index.d.ts:149 |
| <a id="property-pendingsettingsrunid"></a> `pendingSettingsRunId?` | `string` | The run that was active when the session's settings last changed (they apply from the next run). Settings are "pending for the next run" while this run is still active. | react/src/state.ts:65 |
| <a id="property-replayincomplete"></a> `replayIncomplete` | `boolean` | - | react/src/state.ts:53 |
| <a id="property-runs"></a> `runs` | `Record`\<`string`, `Run`\> | - | react/src/state.ts:54 |
| <a id="property-session"></a> `session` | `object` | - | react/src/state.ts:50 |
| `session.activeRunId?` | `string` | - | protocol/dist/index.d.ts:373 |
| `session.capabilities` | `object` | - | protocol/dist/index.d.ts:306 |
| `session.capabilities.approval` | `object` | - | protocol/dist/index.d.ts:308 |
| `session.capabilities.approval.once` | `boolean` | - | protocol/dist/index.d.ts:309 |
| `session.capabilities.approval.session` | `boolean` | - | protocol/dist/index.d.ts:310 |
| `session.capabilities.approval.types` | (`"mcp"` \| `"file"` \| `"shell"` \| `"network"` \| `"other"`)[] | - | protocol/dist/index.d.ts:311 |
| `session.capabilities.attachments` | `object` | - | protocol/dist/index.d.ts:349 |
| `session.capabilities.attachments.files` | `boolean` | - | protocol/dist/index.d.ts:351 |
| `session.capabilities.attachments.images` | `boolean` | - | protocol/dist/index.d.ts:350 |
| `session.capabilities.attachments.maxBytes` | `number` | - | protocol/dist/index.d.ts:352 |
| `session.capabilities.attachments.maxImageBytes?` | `number` | - | protocol/dist/index.d.ts:353 |
| `session.capabilities.diffEvents` | `boolean` | - | protocol/dist/index.d.ts:320 |
| `session.capabilities.efforts` | (`"low"` \| `"medium"` \| `"high"` \| `"xhigh"` \| `"max"`)[] | - | protocol/dist/index.d.ts:335 |
| `session.capabilities.mcp` | `boolean` | - | protocol/dist/index.d.ts:321 |
| `session.capabilities.models` | `object`[] | - | protocol/dist/index.d.ts:329 |
| `session.capabilities.modelsAuthoritative?` | `boolean` | - | protocol/dist/index.d.ts:334 |
| `session.capabilities.nativeResume` | `boolean` | - | protocol/dist/index.d.ts:319 |
| `session.capabilities.permissionModes` | (`"default"` \| `"acceptEdits"` \| `"plan"` \| `"auto"` \| `"bypassPermissions"`)[] | - | protocol/dist/index.d.ts:342 |
| `session.capabilities.siteTools` | `boolean` | - | protocol/dist/index.d.ts:328 |
| `session.capabilities.skills` | `"unknown"` \| `"supported"` \| `"partial"` \| `"prompt"` | - | protocol/dist/index.d.ts:322 |
| `session.capabilities.streaming` | `boolean` | - | protocol/dist/index.d.ts:307 |
| `session.createdAt` | `string` | - | protocol/dist/index.d.ts:305 |
| `session.id` | `string` | - | protocol/dist/index.d.ts:294 |
| `session.machineId?` | `string` | - | protocol/dist/index.d.ts:374 |
| `session.readOnly` | `boolean` | - | protocol/dist/index.d.ts:304 |
| `session.runtimeId` | `string` | - | protocol/dist/index.d.ts:295 |
| `session.settings` | `object` | - | protocol/dist/index.d.ts:356 |
| `session.settings.effort?` | `"low"` \| `"medium"` \| `"high"` \| `"xhigh"` \| `"max"` | - | protocol/dist/index.d.ts:358 |
| `session.settings.model?` | `string` | - | protocol/dist/index.d.ts:357 |
| `session.settings.permissionMode` | `"default"` \| `"acceptEdits"` \| `"plan"` \| `"auto"` \| `"bypassPermissions"` | - | protocol/dist/index.d.ts:365 |
| `session.status` | `"ready"` \| `"busy"` \| `"unavailable"` \| `"closed"` | - | protocol/dist/index.d.ts:298 |
| `session.title` | `string` | - | protocol/dist/index.d.ts:297 |
| `session.workspace` | `string` | - | protocol/dist/index.d.ts:296 |
| <a id="property-timeline"></a> `timeline` | [`TimelineItem`](https://uncage.vercel.app/docs/api/react/type-aliases/timelineitem.md)[] | - | react/src/state.ts:58 |
| <a id="property-tools"></a> `tools` | `Record`\<`string`, [`ToolView`](https://uncage.vercel.app/docs/api/react/interfaces/toolview.md)\> | - | react/src/state.ts:56 |
