# LibTmux::Workspace::X::Load

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

- **Module:** LibTmux::Workspace::X
- **Package:** LibTmux-Workspace
- **Language:** Perl
- **Kind:** exception
- **Source:** https://github.com/libtmux/libtmux-perl/blob/352715a4fa66a96eed7763b90daaa536aa2f121d/packages/workspace/lib/LibTmux/Workspace/X.pm#L39
- **Bases:** [`LibTmux::X`](/en/perl/latest/reference/libtmux-x/)
- **Page:** https://libtmux.org/en/perl/latest/workspace/reference/libtmux-workspace-x-load/

```
package LibTmux::Workspace::X::Load;
```

`cause` retains the original exception. `report` records completed steps, the failed step, dispatch uncertainty, and typed cleanup outcomes. Rollback affects only sessions whose creation was proven by returned core handles. See [`"load" in LibTmux::Workspace`](/en/perl/latest/workspace/reference/libtmux-workspace-load/) and [`LibTmux::X`](/en/perl/latest/reference/libtmux-x/).

## Members

### Common operations

- [`cause`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-cause/) (method): For Load exceptions, return the original core or orchestration failure object.
- [`report`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-report/) (method): For Load exceptions, return the partial-load report. It contains created IDs, completed and failed steps, dispatch uncertainty, and cleanup failures. Each `cleanup_errors` entry contains `target` (the captured [`identity`](/en/perl/latest/reference/libtmux-entity-identity/)), `action` (`kill_session`), and `error` (the original exception). Entries follow rollback attempt order, reversing creation order. An empty array means no cleanup failure was observed. The primary [`"cause"`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-cause/) and secondary exception objects retain their identity. Inspect their [`dispatched`](/en/perl/latest/reference/libtmux-x-dispatched/) and [`result`](/en/perl/latest/reference/libtmux-x-result/) fields without parsing prose. No I/O occurs.
- [`report_data`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-report_data/) (method): For Load exceptions, return a detached, JSON-safe report hashref. The primary cause and each cleanup error become records with `class`, `message`, known `path`, and `dispatched` (null means unknown). Core creation/load causes retain their cause chain; a repeated exception is marked `cycle`. Process results retain exit code, signal, raw wait status, and bounded stdout and stderr as `stdout_base64` and `stderr_base64` using [MIME::Base64](https://metacpan.org/pod/MIME::Base64). This diagnostic encoding does not serialize entity graphs or arbitrary exception internals. Other exceptions retain their class and string message. No I/O occurs; editing the export cannot change [`"report"`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-report/) or [`"cause"`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-cause/).

## Inherited members

- [`count`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-count/) (method), inherited from `LibTmux::X`: Return the observed cardinality lower bound where applicable.
- [`details`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-details/) (method), inherited from `LibTmux::X`: Return a fresh shallow hashref of diagnostic fields. Causes and entity handles retain their identity.
- [`dispatched`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-dispatched/) (method), inherited from `LibTmux::X`: Return whether the request was submitted where known; undef means no dispatch evidence was recorded. This never proves rollback.
- [`entity`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-entity/) (method), inherited from `LibTmux::X`: Return the entity kind, or undef when inapplicable.
- [`expected`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-expected/) (method), inherited from `LibTmux::X`: Return the expected operand description, or undef.
- [`matched_ids`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-matched_ids/) (method), inherited from `LibTmux::X`: Return a fresh arrayref of observed matching IDs, including duplicate occurrences.
- [`message`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-message/) (method), inherited from `LibTmux::X`: Return the human-readable failure description.
- [`new`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-new/) (method), inherited from `LibTmux::X`: `new(%details)` constructs an exception object without throwing or I/O.
- [`path`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-path/) (method), inherited from `LibTmux::X`: Return the criterion or argument path, or undef when inapplicable.
- [`received`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-received/) (method), inherited from `LibTmux::X`: Return the received operand description, or undef.
- [`result`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-result/) (method), inherited from `LibTmux::X`: Return a completed or bounded partial [`LibTmux::CommandResult`](/en/perl/latest/reference/libtmux-commandresult/), or undef before process dispatch.
- [`throw`](/en/perl/latest/workspace/reference/libtmux-workspace-x-load-throw/) (method), inherited from `LibTmux::X`: `throw(%details)` throws one exception object of the receiving class.