# planning.WorkspaceRetention

**Workspace Manager concept example** A working example of the core library. It can change without notice.

- **Module:** planning
- **Package:** @libtmux/workspace
- **Language:** TypeScript
- **Kind:** typealias
- **Source:** https://github.com/libtmux/libtmux-ts/blob/46cccfef2a546de55ce8b308249b8c76339089a0/packages/workspace/src/planning.ts#L50
- **Page:** https://libtmux.org/en/ts/latest/workspace/reference/planning-workspaceretention/

```ts
type WorkspaceRetention = | {
    readonly count: number;
    readonly kind: "panes";
    readonly reason: "pruning-disabled" | "shared-window";
    readonly window: WorkspaceWindowPlacement;
  }
| {
    readonly kind: "window";
    readonly reason: "grouped-session" | "pruning-disabled";
    readonly window: WorkspaceWindowPlacement;
  }
```

Surplus topology retained because removing it would exceed the policy.
