NAME

LibTmux::Workspace::X - Workspace configuration and partial-load failures

EXCEPTIONS

Config

Invalid versioned configuration. path identifies the rejected input.

Conflict

An existing session conflicts with the selected repeat-application policy. No session is created until all names pass the conflict check.

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 and LibTmux::X.

METHODS

report

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), 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" and secondary exception objects retain their identity. Inspect their dispatched and result fields without parsing prose. No I/O occurs.

report_data

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. 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" or "cause".

use JSON::PP ();
my $data = $error->report_data;
say JSON::PP->new->canonical->encode($data);

The packaged libtmux-workspace CLI uses this export. Use "report" when recovery needs the original typed exceptions rather than diagnostic data.

cause

For Load exceptions, return the original core or orchestration failure object.