# mergeSnapshot

<!-- https://uncage.vercel.app/docs/api/react/functions/mergesnapshot/ -->

```ts
function mergeSnapshot(s, snap): SessionState;
```

Defined in: react/src/apply-event.ts:62

Overlays a (newer) snapshot onto existing state: the snapshot is authoritative for session and
run states; approvals are replaced only by a newer version; missing user prompts and
approvals are appended to the timeline. Existing messages and tools are kept.

## Parameters

| Parameter | Type |
| ------ | ------ |
| `s` | [`SessionState`](https://uncage.vercel.app/docs/api/react/interfaces/sessionstate.md) |
| `snap` | \{ `lastSequence`: `number`; `pendingApprovals`: `object`[]; `runs`: `object`[]; `session`: \{ `activeRunId?`: `string`; `capabilities`: \{ `approval`: \{ `once`: `boolean`; `session`: `boolean`; `types`: (`"mcp"` \| `"file"` \| `"shell"` \| `"network"` \| `"other"`)[]; \}; `attachments`: \{ `files`: `boolean`; `images`: `boolean`; `maxBytes`: `number`; `maxImageBytes?`: `number`; \}; `diffEvents`: `boolean`; `efforts`: (`"low"` \| `"medium"` \| `"high"` \| `"xhigh"` \| `"max"`)[]; `mcp`: `boolean`; `models`: `object`[]; `modelsAuthoritative?`: `boolean`; `nativeResume`: `boolean`; `permissionModes`: (`"default"` \| `"acceptEdits"` \| `"plan"` \| `"auto"` \| `"bypassPermissions"`)[]; `siteTools`: `boolean`; `skills`: `"unknown"` \| `"supported"` \| `"partial"` \| `"prompt"`; `streaming`: `boolean`; \}; `createdAt`: `string`; `id`: `string`; `machineId?`: `string`; `readOnly`: `boolean`; `runtimeId`: `string`; `settings`: \{ `effort?`: `"low"` \| `"medium"` \| `"high"` \| `"xhigh"` \| `"max"`; `model?`: `string`; `permissionMode`: `"default"` \| `"acceptEdits"` \| `"plan"` \| `"auto"` \| `"bypassPermissions"`; \}; `status`: `"ready"` \| `"busy"` \| `"unavailable"` \| `"closed"`; `title`: `string`; `workspace`: `string`; \}; \} |
| `snap.lastSequence` | `number` |
| `snap.pendingApprovals` | `object`[] |
| `snap.runs` | `object`[] |
| `snap.session` | \{ `activeRunId?`: `string`; `capabilities`: \{ `approval`: \{ `once`: `boolean`; `session`: `boolean`; `types`: (`"mcp"` \| `"file"` \| `"shell"` \| `"network"` \| `"other"`)[]; \}; `attachments`: \{ `files`: `boolean`; `images`: `boolean`; `maxBytes`: `number`; `maxImageBytes?`: `number`; \}; `diffEvents`: `boolean`; `efforts`: (`"low"` \| `"medium"` \| `"high"` \| `"xhigh"` \| `"max"`)[]; `mcp`: `boolean`; `models`: `object`[]; `modelsAuthoritative?`: `boolean`; `nativeResume`: `boolean`; `permissionModes`: (`"default"` \| `"acceptEdits"` \| `"plan"` \| `"auto"` \| `"bypassPermissions"`)[]; `siteTools`: `boolean`; `skills`: `"unknown"` \| `"supported"` \| `"partial"` \| `"prompt"`; `streaming`: `boolean`; \}; `createdAt`: `string`; `id`: `string`; `machineId?`: `string`; `readOnly`: `boolean`; `runtimeId`: `string`; `settings`: \{ `effort?`: `"low"` \| `"medium"` \| `"high"` \| `"xhigh"` \| `"max"`; `model?`: `string`; `permissionMode`: `"default"` \| `"acceptEdits"` \| `"plan"` \| `"auto"` \| `"bypassPermissions"`; \}; `status`: `"ready"` \| `"busy"` \| `"unavailable"` \| `"closed"`; `title`: `string`; `workspace`: `string`; \} |
| `snap.session.activeRunId?` | `string` |
| `snap.session.capabilities` | \{ `approval`: \{ `once`: `boolean`; `session`: `boolean`; `types`: (`"mcp"` \| `"file"` \| `"shell"` \| `"network"` \| `"other"`)[]; \}; `attachments`: \{ `files`: `boolean`; `images`: `boolean`; `maxBytes`: `number`; `maxImageBytes?`: `number`; \}; `diffEvents`: `boolean`; `efforts`: (`"low"` \| `"medium"` \| `"high"` \| `"xhigh"` \| `"max"`)[]; `mcp`: `boolean`; `models`: `object`[]; `modelsAuthoritative?`: `boolean`; `nativeResume`: `boolean`; `permissionModes`: (`"default"` \| `"acceptEdits"` \| `"plan"` \| `"auto"` \| `"bypassPermissions"`)[]; `siteTools`: `boolean`; `skills`: `"unknown"` \| `"supported"` \| `"partial"` \| `"prompt"`; `streaming`: `boolean`; \} |
| `snap.session.capabilities.approval` | \{ `once`: `boolean`; `session`: `boolean`; `types`: (`"mcp"` \| `"file"` \| `"shell"` \| `"network"` \| `"other"`)[]; \} |
| `snap.session.capabilities.approval.once` | `boolean` |
| `snap.session.capabilities.approval.session` | `boolean` |
| `snap.session.capabilities.approval.types` | (`"mcp"` \| `"file"` \| `"shell"` \| `"network"` \| `"other"`)[] |
| `snap.session.capabilities.attachments` | \{ `files`: `boolean`; `images`: `boolean`; `maxBytes`: `number`; `maxImageBytes?`: `number`; \} |
| `snap.session.capabilities.attachments.files` | `boolean` |
| `snap.session.capabilities.attachments.images` | `boolean` |
| `snap.session.capabilities.attachments.maxBytes` | `number` |
| `snap.session.capabilities.attachments.maxImageBytes?` | `number` |
| `snap.session.capabilities.diffEvents` | `boolean` |
| `snap.session.capabilities.efforts` | (`"low"` \| `"medium"` \| `"high"` \| `"xhigh"` \| `"max"`)[] |
| `snap.session.capabilities.mcp` | `boolean` |
| `snap.session.capabilities.models` | `object`[] |
| `snap.session.capabilities.modelsAuthoritative?` | `boolean` |
| `snap.session.capabilities.nativeResume` | `boolean` |
| `snap.session.capabilities.permissionModes` | (`"default"` \| `"acceptEdits"` \| `"plan"` \| `"auto"` \| `"bypassPermissions"`)[] |
| `snap.session.capabilities.siteTools` | `boolean` |
| `snap.session.capabilities.skills` | `"unknown"` \| `"supported"` \| `"partial"` \| `"prompt"` |
| `snap.session.capabilities.streaming` | `boolean` |
| `snap.session.createdAt` | `string` |
| `snap.session.id` | `string` |
| `snap.session.machineId?` | `string` |
| `snap.session.readOnly` | `boolean` |
| `snap.session.runtimeId` | `string` |
| `snap.session.settings` | \{ `effort?`: `"low"` \| `"medium"` \| `"high"` \| `"xhigh"` \| `"max"`; `model?`: `string`; `permissionMode`: `"default"` \| `"acceptEdits"` \| `"plan"` \| `"auto"` \| `"bypassPermissions"`; \} |
| `snap.session.settings.effort?` | `"low"` \| `"medium"` \| `"high"` \| `"xhigh"` \| `"max"` |
| `snap.session.settings.model?` | `string` |
| `snap.session.settings.permissionMode` | `"default"` \| `"acceptEdits"` \| `"plan"` \| `"auto"` \| `"bypassPermissions"` |
| `snap.session.status` | `"ready"` \| `"busy"` \| `"unavailable"` \| `"closed"` |
| `snap.session.title` | `string` |
| `snap.session.workspace` | `string` |

## Returns

[`SessionState`](https://uncage.vercel.app/docs/api/react/interfaces/sessionstate.md)
