@sublang/playbook 15.0.0 → 16.0.0

package/src/xstate-runtime.d.ts

@@ -44,7 +44,9 @@ export interface SnapshotNormalizationOptions {
     pendingCall?: PlaybookPendingCall;
 }
 export declare function normalizePlaybookSnapshot(snapshot: unknown, options?: SnapshotNormalizationOptions): PlaybookState;
-export declare function detachPersistedMachineSnapshot(persisted: unknown): JsonValue;
+export declare function detachPersistedMachineSnapshot(persisted: unknown, completion?: {
+    readonly lastError?: NormalizedError;
+}): JsonValue;
 /** Authority for one governed delegated-player output field (DR-040 §1). */
 export type PlaybookSemanticFieldAuthority = 'presentation' | 'semantic' | 'effect' | 'runtime';
 /** One already-validated state-local governed outcome declaration. */

package/src/xstate-runtime.js

@@ -607,8 +607,15 @@ export function normalizePlaybookSnapshot(snapshot, options = {}) {
 // DR-014 §1: deep-detach an XState persisted actor snapshot into strict
 // JSON for a PlaybookRuntimeSnapshot, normalizing any raw Error value
 // (for example FSM context `lastError`) instead of rejecting it.
-export function detachPersistedMachineSnapshot(persisted) {
-    return snapshotJsonValue(withErrorsNormalized(persisted, new Set()), 'persisted machine snapshot');
+// DR-063 §2: a runtime parked in its failure state supplies the `lastError`
+// it publishes live — completed with the cause it decided — and that record
+// replaces the context's own, which a thrown value may have refused to carry.
+export function detachPersistedMachineSnapshot(persisted, completion = {}) {
+    const detached = withErrorsNormalized(persisted, new Set());
+    const lastError = completion.lastError;
+    return snapshotJsonValue(lastError !== undefined && isRecord(detached) && isRecord(detached.context)
+        ? { ...detached, context: { ...detached.context, lastError } }
+        : detached, 'persisted machine snapshot');
 }
 function withErrorsNormalized(value, ancestors) {
     if (value instanceof Error)

package/src/xstate-runtime.ts

@@ -902,9 +902,19 @@ export function normalizePlaybookSnapshot(
 // DR-014 §1: deep-detach an XState persisted actor snapshot into strict
 // JSON for a PlaybookRuntimeSnapshot, normalizing any raw Error value
 // (for example FSM context `lastError`) instead of rejecting it.
-export function detachPersistedMachineSnapshot(persisted: unknown): JsonValue {
+// DR-063 §2: a runtime parked in its failure state supplies the `lastError`
+// it publishes live — completed with the cause it decided — and that record
+// replaces the context's own, which a thrown value may have refused to carry.
+export function detachPersistedMachineSnapshot(
+  persisted: unknown,
+  completion: { readonly lastError?: NormalizedError } = {},
+): JsonValue {
+  const detached = withErrorsNormalized(persisted, new Set());
+  const lastError = completion.lastError;
   return snapshotJsonValue(
-    withErrorsNormalized(persisted, new Set()),
+    lastError !== undefined && isRecord(detached) && isRecord(detached.context)
+      ? { ...detached, context: { ...detached.context, lastError } }
+      : detached,
     'persisted machine snapshot',
   );
 }