@sublang/playbook 1.0.0 → 2.0.0

package/src/xstate-runtime.d.ts

@@ -1,5 +1,6 @@
 import { type AnyActorRef, type PromiseActorLogic, type SnapshotFrom } from 'xstate';
 import type { CaptainResult, JsonValue, NormalizedError, PlaybookCallRequest, PlaybookCallResult, PlaybookCallStart, PlaybookPendingCall, PlaybookRuntimeSnapshot, PlaybookSession, PlaybookState, PlayerResult } from './runtime.js';
+export * from './xstate-playbook-runtime.js';
 /**
  * Compose invocation-lifetime and imperative-boundary cancellation without
  * installing a second forwarding listener in each generated runtime.

package/src/xstate-runtime.js

@@ -1,6 +1,10 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
 import { fromPromise, waitFor, } from 'xstate';
+// DR-019: the generic linked-runtime factory and its strategy helpers live
+// in the sibling module and are re-exported here so linked artifacts import
+// one shared engine surface.
+export * from './xstate-playbook-runtime.js';
 const BUSY_TAG = 'playbook.busy';
 const SUSPENDED_TAG = 'playbook.suspended';
 function deferred() {
@@ -514,6 +518,13 @@ export function assertPlaybookRuntimeSnapshot(value, expectedPlaybookId) {
         }
         sequences[key] = sequence;
     }
+    const captainCall = value.sequences.captainCall;
+    if (captainCall !== undefined) {
+        if (!Number.isSafeInteger(captainCall) || captainCall < 0) {
+            throw new TypeError('runtime snapshot sequences.captainCall must be a non-negative integer');
+        }
+        sequences.captainCall = captainCall;
+    }
     validateState(value.state, 'runtime snapshot state');
     const state = snapshotJsonValue(value.state, 'runtime snapshot state');
     if (!Array.isArray(value.pendingBossQuestions)) {

package/src/xstate-runtime.ts

@@ -25,6 +25,11 @@ import type {
   PlayerResult,
 } from './runtime.js';
 
+// DR-019: the generic linked-runtime factory and its strategy helpers live
+// in the sibling module and are re-exported here so linked artifacts import
+// one shared engine surface.
+export * from './xstate-playbook-runtime.js';
+
 const BUSY_TAG = 'playbook.busy';
 const SUSPENDED_TAG = 'playbook.suspended';
 
@@ -738,6 +743,15 @@ export function assertPlaybookRuntimeSnapshot(
     }
     sequences[key] = sequence as number;
   }
+  const captainCall = value.sequences.captainCall;
+  if (captainCall !== undefined) {
+    if (!Number.isSafeInteger(captainCall) || (captainCall as number) < 0) {
+      throw new TypeError(
+        'runtime snapshot sequences.captainCall must be a non-negative integer',
+      );
+    }
+    sequences.captainCall = captainCall as number;
+  }
   validateState(value.state, 'runtime snapshot state');
   const state = snapshotJsonValue(
     value.state,