deepline 0.1.206 → 0.1.207

package/dist/bundling-sources/shared_libs/play-runtime/context.ts

@@ -51,7 +51,17 @@ import {
   PLAY_RUNTIME_API_COMPAT_PATH,
   PLAY_RUNTIME_CHILD_EXECUTOR_TOKEN_COMPAT_PATH,
 } from './runtime-api-paths';
-import { startRunViaAppRuntime } from './app-runtime-api';
+import {
+  settleInlineChildRunViaAppRuntime,
+  startRunViaAppRuntime,
+} from './app-runtime-api';
+import { executeChildRunLifecycle } from './child-run-lifecycle';
+import {
+  createRootRunExecutionScope,
+  deriveChildRunExecutionScope,
+  type RunExecutionScope,
+} from './run-execution-scope';
+import { DEFAULT_RUNTIME_EXECUTION_CAPABILITIES } from './execution-capabilities';
 import { vercelProtectionBypassHeader } from './vercel-protection';
 export {
   RuntimeSheetRowsBlockedError,
@@ -126,7 +136,7 @@ import {
   isQueryResultDatasetReadRequest,
   isQueryResultDatasetTool,
 } from './query-result-dataset';
-import { isRowIsolationExemptError } from './row-isolation';
+import { isAbortLikeError, isRowIsolationExemptError } from './row-isolation';
 import {
   createRuntimePersistenceLatch,
   RuntimePersistenceCircuitOpenError,
@@ -231,6 +241,12 @@ import {
   type StepProgramDatasetOptions,
 } from './step-program-dataset-builder';
 import { readRuntimeSheetDatasetRows } from './runtime-api';
+import { resolveChildExecutionStrategy } from './child-execution-strategy';
+
+type ResolvedPlayExecutor = (
+  ctx: PlayContextImpl,
+  input: Record<string, unknown>,
+) => Promise<unknown>;
 
 /**
  * SECURITY: AsyncLocalStorage is per async execution, not a cross-run cache.
@@ -1035,6 +1051,7 @@ export class PlayContextImpl {
     { resolve: (value: unknown) => void; reject: (reason: unknown) => void }
   >();
   #options: ContextOptions;
+  private readonly executionScope: RunExecutionScope;
   private logBuffer: string[] = [];
   private checkpoint: PlayCheckpoint;
   private steps: PlayStep[] = [];
@@ -1094,6 +1111,10 @@ export class PlayContextImpl {
    * child run-id derivation. All policy lives in {@link governor}.
    */
   private readonly governance: GovernanceSnapshot;
+  private readonly resolvedPlayExecutorCache = new Map<
+    string,
+    Promise<ResolvedPlayExecutor>
+  >();
   readonly tools = {
     execute: <TOutput = unknown>(request: {
       id: string;
@@ -1200,33 +1221,53 @@ export class PlayContextImpl {
       options.workflowId ||
       'anonymous-play';
     const rootRunId = options.runId ?? options.workflowId ?? 'anonymous-run';
+    this.executionScope =
+      options.executionScope ??
+      createRootRunExecutionScope({
+        runId: rootRunId,
+        playId: rootPlayId,
+        attempt:
+          typeof options.runAttempt === 'number' &&
+          Number.isFinite(options.runAttempt)
+            ? Math.max(0, Math.floor(options.runAttempt))
+            : 0,
+        receiptNamespace: options.runtimeReceiptScope ?? rootPlayId,
+        authority: {
+          orgId: options.orgId ?? 'org',
+          workflowId: options.workflowId ?? rootRunId,
+          integrationMode: options.integrationMode ?? null,
+          capabilities: DEFAULT_RUNTIME_EXECUTION_CAPABILITIES,
+        },
+      });
     if (options.requireSharedRateState && !options.rateState) {
       throw new Error(
         'Shared rate-state backend is required for this Node runtime substrate.',
       );
     }
-    this.governor = createPlayExecutionGovernor({
-      adapter: 'cjs_node20',
-      scope: {
-        orgId: options.orgId ?? 'org',
-        rootRunId: options.runId ?? options.workflowId ?? 'run',
-      },
-      rateState: options.rateState ?? new InMemoryRateStateBackend(),
-      budgetState: options.budgetState,
-      resolvePacing: createPacingResolver(options.getToolQueueHints),
-      // A root run keeps depth 0 (its first child play is depth 1) but still
-      // seeds its own play id into the ancestry/currentPlayId so the cycle guard
-      // catches a child re-invoking the root. createDefaultGovernanceSnapshot
-      // couples depth to rootPlayId, so the root snapshot is built explicitly.
-      resume: options.governance ?? {
-        ...createDefaultGovernanceSnapshot({
+    this.governor =
+      options.executionGovernor ??
+      createPlayExecutionGovernor({
+        adapter: 'cjs_node20',
+        scope: {
           orgId: options.orgId ?? 'org',
-          rootRunId,
-        }),
-        currentPlayId: rootPlayId,
-        ancestryPlayIds: [rootPlayId],
-      },
-    });
+          rootRunId: options.runId ?? options.workflowId ?? 'run',
+        },
+        rateState: options.rateState ?? new InMemoryRateStateBackend(),
+        budgetState: options.budgetState,
+        resolvePacing: createPacingResolver(options.getToolQueueHints),
+        // A root run keeps depth 0 (its first child play is depth 1) but still
+        // seeds its own play id into the ancestry/currentPlayId so the cycle guard
+        // catches a child re-invoking the root. createDefaultGovernanceSnapshot
+        // couples depth to rootPlayId, so the root snapshot is built explicitly.
+        resume: options.governance ?? {
+          ...createDefaultGovernanceSnapshot({
+            orgId: options.orgId ?? 'org',
+            rootRunId,
+          }),
+          currentPlayId: rootPlayId,
+          ancestryPlayIds: [rootPlayId],
+        },
+      });
     this.resourceGovernor = createRuntimeResourceGovernor({
       executionGovernor: this.governor,
     });
@@ -1716,7 +1757,7 @@ export class PlayContextImpl {
     }
     const claimed = await this.#options.claimRuntimeStepReceipt({
       key,
-      runId,
+      runId: this.currentReceiptOwnerRunId,
       runAttempt: this.currentRunAttempt,
       leaseAware: true,
       ...(reclaimRunning ? { reclaimRunning: true } : {}),
@@ -1735,7 +1776,7 @@ export class PlayContextImpl {
 
   private async completeRuntimeStepReceipt(
     key: string,
-    runId: string,
+    _runId: string,
     output: unknown | null,
     leaseId?: string | null,
   ): Promise<RuntimeStepReceipt | null> {
@@ -1749,7 +1790,7 @@ export class PlayContextImpl {
     }
     const completed = await this.#options.completeRuntimeStepReceipt({
       key,
-      runId,
+      runId: this.currentReceiptOwnerRunId,
       runAttempt: this.currentRunAttempt,
       ...(leaseId ? { leaseId } : {}),
       output,
@@ -1770,7 +1811,7 @@ export class PlayContextImpl {
 
   private async releaseRuntimeStepReceipt(
     key: string,
-    runId: string,
+    _runId: string,
     leaseId?: string | null,
   ): Promise<RuntimeStepReceipt | null> {
     if (!this.#options.releaseRuntimeStepReceipt) {
@@ -1778,7 +1819,7 @@ export class PlayContextImpl {
     }
     const released = await this.#options.releaseRuntimeStepReceipt({
       key,
-      runId,
+      runId: this.currentReceiptOwnerRunId,
       runAttempt: this.currentRunAttempt,
       ...(leaseId ? { leaseId } : {}),
     });
@@ -1818,14 +1859,14 @@ export class PlayContextImpl {
 
   private async heartbeatRuntimeStepReceipt(
     key: string,
-    runId: string,
+    _runId: string,
     leaseId: string,
   ): Promise<RuntimeStepReceipt | null> {
     if (!this.#options.heartbeatRuntimeStepReceipts) {
       return null;
     }
     const [receipt] = await this.#options.heartbeatRuntimeStepReceipts({
-      runId,
+      runId: this.currentReceiptOwnerRunId,
       runAttempt: this.currentRunAttempt,
       leaseId,
       keys: [key],
@@ -1866,7 +1907,7 @@ export class PlayContextImpl {
       const receipts = await this.markRuntimeStepReceiptsRunning(
         targets.map((target) => ({
           key: target.receiptKey,
-          runId: this.currentRunId,
+          runId: this.currentReceiptOwnerRunId,
           leaseId: target.leaseId,
         })),
       );
@@ -1875,7 +1916,7 @@ export class PlayContextImpl {
         if (!this.runtimeToolReceiptStillOwned(receipt, target.leaseId)) {
           throw new RuntimeReceiptLeaseLostError({
             receiptKey: target.receiptKey,
-            runId: this.currentRunId,
+            runId: this.currentReceiptOwnerRunId,
             leaseId: target.leaseId,
           });
         }
@@ -1886,7 +1927,7 @@ export class PlayContextImpl {
     if (this.#options.heartbeatRuntimeStepReceipts) {
       for (const [leaseId, keys] of byLeaseId) {
         const receipts = await this.#options.heartbeatRuntimeStepReceipts({
-          runId: this.currentRunId,
+          runId: this.currentReceiptOwnerRunId,
           runAttempt: this.currentRunAttempt,
           leaseId,
           keys,
@@ -1902,7 +1943,7 @@ export class PlayContextImpl {
     ) {
       throw new RuntimeReceiptLeaseLostError({
         receiptKey: targets[0]?.receiptKey ?? 'unknown',
-        runId: this.currentRunId,
+        runId: this.currentReceiptOwnerRunId,
         leaseId: targets[0]?.leaseId ?? 'unknown',
       });
     }
@@ -1915,7 +1956,7 @@ export class PlayContextImpl {
       if (!this.runtimeToolReceiptStillOwned(receipt, target.leaseId)) {
         throw new RuntimeReceiptLeaseLostError({
           receiptKey: target.receiptKey,
-          runId: this.currentRunId,
+          runId: this.currentReceiptOwnerRunId,
           leaseId: target.leaseId,
         });
       }
@@ -1935,7 +1976,7 @@ export class PlayContextImpl {
       if (!this.runtimeToolReceiptStillOwned(receipt, leaseId)) {
         throw new RuntimeReceiptLeaseLostError({
           receiptKey: keys[index] ?? 'unknown',
-          runId: this.currentRunId,
+          runId: this.currentReceiptOwnerRunId,
           leaseId,
         });
       }
@@ -1953,7 +1994,7 @@ export class PlayContextImpl {
     if (receipt.status !== 'running') return false;
     if (receipt.leaseId !== leaseId) return false;
     const ownerRunId = receipt.leaseOwnerRunId ?? receipt.runId ?? null;
-    return !ownerRunId || ownerRunId === this.currentRunId;
+    return !ownerRunId || ownerRunId === this.currentReceiptOwnerRunId;
   }
 
   private runtimeToolReceiptStillOwnedByCurrentAttempt(
@@ -1967,7 +2008,7 @@ export class PlayContextImpl {
       return false;
     }
     const ownerRunId = receipt.leaseOwnerRunId ?? receipt.runId ?? null;
-    if (ownerRunId !== this.currentRunId) return false;
+    if (ownerRunId !== this.currentReceiptOwnerRunId) return false;
     const ownerAttempt =
       typeof receipt.leaseOwnerAttempt === 'number'
         ? receipt.leaseOwnerAttempt
@@ -1989,7 +2030,7 @@ export class PlayContextImpl {
 
   private async failRuntimeStepReceipt(
     key: string,
-    runId: string,
+    _runId: string,
     error: string,
     leaseId?: string | null,
     failureKind?: WorkReceiptFailureKind | null,
@@ -1999,7 +2040,7 @@ export class PlayContextImpl {
     }
     const failed = await this.#options.failRuntimeStepReceipt({
       key,
-      runId,
+      runId: this.currentReceiptOwnerRunId,
       runAttempt: this.currentRunAttempt,
       ...(leaseId ? { leaseId } : {}),
       ...(failureKind ? { failureKind } : {}),
@@ -2094,7 +2135,7 @@ export class PlayContextImpl {
 
   private async claimRuntimeStepReceipts(
     keys: string[],
-    runId: string,
+    _runId: string,
     reclaimRunning = false,
     forceRefresh = false,
     forceFailedRefresh = false,
@@ -2108,7 +2149,7 @@ export class PlayContextImpl {
       ? await this.dispatchChunkedRuntimeReceiptRequest(uniqueKeys, (chunk) =>
           claimReceipts({
             keys: chunk,
-            runId,
+            runId: this.currentReceiptOwnerRunId,
             runAttempt: this.currentRunAttempt,
             leaseAware: true,
             ...(reclaimRunning ? { reclaimRunning: true } : {}),
@@ -2120,7 +2161,7 @@ export class PlayContextImpl {
           uniqueKeys.map((key) =>
             this.claimRuntimeStepReceipt(
               key,
-              runId,
+              this.currentReceiptOwnerRunId,
               reclaimRunning,
               forceRefresh,
               forceFailedRefresh,
@@ -2155,7 +2196,7 @@ export class PlayContextImpl {
     }
     const receipt = await this.#options.markRuntimeStepReceiptRunning({
       key: input.key,
-      runId: input.runId,
+      runId: this.currentReceiptOwnerRunId,
       runAttempt: this.currentRunAttempt,
       ...(input.leaseId ? { leaseId: input.leaseId } : {}),
     });
@@ -2177,6 +2218,7 @@ export class PlayContextImpl {
       marked = await this.dispatchChunkedRuntimeReceiptRequest(
         normalizedInputs.map((receipt) => ({
           ...receipt,
+          runId: this.currentReceiptOwnerRunId,
           runAttempt: this.currentRunAttempt,
         })),
         (chunk) => markReceipts({ receipts: chunk }),
@@ -2214,6 +2256,7 @@ export class PlayContextImpl {
     const queued = await this.dispatchChunkedRuntimeReceiptRequest(
       normalizedInputs.map((receipt) => ({
         ...receipt,
+        runId: this.currentReceiptOwnerRunId,
         runAttempt: this.currentRunAttempt,
       })),
       (chunk) =>
@@ -2237,7 +2280,9 @@ export class PlayContextImpl {
       const receiptKey = request.receiptKey?.trim() || null;
       const leaseId = request.receiptLeaseId?.trim() || null;
       if (!receiptKey || !leaseId) return [];
-      return [{ key: receiptKey, runId: this.currentRunId, leaseId }];
+      return [
+        { key: receiptKey, runId: this.currentReceiptOwnerRunId, leaseId },
+      ];
     });
     if (targets.length === 0) return;
     await this.markRuntimeStepReceiptsQueued(targets);
@@ -2268,6 +2313,7 @@ export class PlayContextImpl {
         ? await this.dispatchChunkedRuntimeReceiptRequest(
             normalizedInputs.map((receipt) => ({
               ...receipt,
+              runId: this.currentReceiptOwnerRunId,
               runAttempt: receipt.runAttempt ?? this.currentRunAttempt,
             })),
             (chunk) => completeReceipts({ receipts: chunk }),
@@ -2412,6 +2458,7 @@ export class PlayContextImpl {
       ? await this.dispatchChunkedRuntimeReceiptRequest(
           normalizedInputs.map((receipt) => ({
             ...receipt,
+            runId: this.currentReceiptOwnerRunId,
             runAttempt: receipt.runAttempt ?? this.currentRunAttempt,
           })),
           (chunk) => failReceipts({ receipts: chunk }),
@@ -2445,7 +2492,7 @@ export class PlayContextImpl {
     if (receiptKeys.length === 0) return;
     await this.claimRuntimeStepReceipts(
       receiptKeys,
-      this.currentRunId,
+      this.currentReceiptOwnerRunId,
       true,
       true,
     );
@@ -2595,7 +2642,7 @@ export class PlayContextImpl {
   private async executeWithRuntimeReceipt<T>(
     operation: DurableCtxOperation,
     id: string,
-    runId: string,
+    _runId: string,
     opts: {
       force?: boolean;
       receiptKey?: string | null;
@@ -2622,7 +2669,7 @@ export class PlayContextImpl {
       opts.receiptKey?.trim() ||
       durableCtxKey({
         orgId: this.#options.orgId,
-        playId: this.governance.currentPlayId,
+        playId: this.executionScope.receipt.namespace,
         operation,
         id,
         semanticKey: opts.semanticKey,
@@ -2631,7 +2678,7 @@ export class PlayContextImpl {
     return await executeWithDurableRuntimeReceipt<T>({
       operation,
       id,
-      runId,
+      runId: this.currentReceiptOwnerRunId,
       receiptKey,
       store: this.durableReceiptExecutionStore(),
       force: opts.force,
@@ -2653,14 +2700,15 @@ export class PlayContextImpl {
   }
 
   private get currentRunId(): string {
-    return this.#options.runId ?? this.governance.currentRunId ?? 'unknown';
+    return this.executionScope.logical.runId;
+  }
+
+  private get currentReceiptOwnerRunId(): string {
+    return this.executionScope.receipt.ownerRunId;
   }
 
   private get currentRunAttempt(): number {
-    const attempt = this.#options.runAttempt;
-    return typeof attempt === 'number' && Number.isFinite(attempt)
-      ? Math.max(0, Math.floor(attempt))
-      : 0;
+    return this.executionScope.receipt.ownerAttempt;
   }
 
   private emitScopedFieldMetaUpdate(input: {
@@ -3148,7 +3196,7 @@ export class PlayContextImpl {
           await this.completeRuntimeStepReceipts([
             {
               key: receiptKey,
-              runId: this.currentRunId,
+              runId: this.currentReceiptOwnerRunId,
               leaseId: request.receiptLeaseId ?? null,
               output: serializeToolExecuteResult(wrapped),
             },
@@ -3204,7 +3252,7 @@ export class PlayContextImpl {
         ? [
             {
               key: receiptKey,
-              runId: this.currentRunId,
+              runId: this.currentReceiptOwnerRunId,
               leaseId: entry.request.receiptLeaseId ?? null,
               output: serializeToolExecuteResult(entry.wrapped),
             },
@@ -3277,7 +3325,7 @@ export class PlayContextImpl {
             result: this.runtimeReceiptOutput(completed),
             requestInput: request.input,
             execution: toolExecutionMetadataForOutcome(
-              completed.runId === this.currentRunId
+              completed.runId === this.currentReceiptOwnerRunId
                 ? {
                     kind: 'live',
                     cacheKey,
@@ -3332,7 +3380,7 @@ export class PlayContextImpl {
         await this.failRuntimeStepReceipts([
           {
             key: receiptKey,
-            runId: this.currentRunId,
+            runId: this.currentReceiptOwnerRunId,
             leaseId: request.receiptLeaseId ?? null,
             error: message,
             failureKind: runtimeReceiptFailureKindForError(error),
@@ -5879,7 +5927,7 @@ export class PlayContextImpl {
                         await this.markRuntimeStepReceiptsQueued([
                           {
                             key: directCacheKey,
-                            runId: this.currentRunId,
+                            runId: this.currentReceiptOwnerRunId,
                             leaseId: directReceiptLeaseId,
                           },
                         ]);
@@ -6241,9 +6289,7 @@ export class PlayContextImpl {
     if (!resolvedName.trim()) {
       throw new Error('ctx.runPlay(...) requires a resolvable play name.');
     }
-    const scheduledChildPlayCall = this.shouldLaunchChildPlaysThroughScheduler()
-      ? this.beginScheduledChildPlayCall()
-      : null;
+    let scheduledChildPlayCall: { release(): void } | null = null;
 
     try {
       if (!this.#options.resolvePlay) {
@@ -6260,6 +6306,18 @@ export class PlayContextImpl {
       }
       const childRevisionFingerprint =
         resolvedPlayRevisionFingerprint(resolvedPlay);
+      const childExecutionDecision = resolveChildExecutionStrategy({
+        pipeline: resolvedPlay.staticPipeline,
+      });
+      const launchThroughScheduler =
+        this.shouldLaunchChildPlaysThroughScheduler() &&
+        childExecutionDecision.strategy === 'scheduled';
+      scheduledChildPlayCall = launchThroughScheduler
+        ? this.beginScheduledChildPlayCall()
+        : null;
+      this.log(
+        `ctx.runPlay(${normalizedKey}): ${childExecutionDecision.strategy} (${childExecutionDecision.reason})`,
+      );
       const runPlayRowScope = rowContext.getStore();
       const runPlaySemanticKey = buildDurableRunPlaySemanticKey({
         childPlayName: resolvedName,
@@ -6298,11 +6356,21 @@ export class PlayContextImpl {
           input,
           graphHash: null,
         });
-        const childGovernance = await this.governor.forkChild({
-          childPlayName: resolvedName,
-          childRunId,
-        });
-        const childPlaySlot = await this.governor.acquireChildSubmitSlot();
+        const inlineChildGovernor = launchThroughScheduler
+          ? null
+          : await this.governor.forkInlineChild({
+              childPlayName: resolvedName,
+              childRunId,
+            });
+        const childGovernance = launchThroughScheduler
+          ? await this.governor.forkChild({
+              childPlayName: resolvedName,
+              childRunId,
+            })
+          : inlineChildGovernor!.snapshot();
+        const childPlaySlot = launchThroughScheduler
+          ? await this.governor.acquireChildSubmitSlot()
+          : null;
         const rowStore = rowContext.getStore();
         const producer = {
           kind: 'play' as const,
@@ -6311,7 +6379,6 @@ export class PlayContextImpl {
           displayName: displayNameFromProducerId(resolvedName),
           runId: childRunId,
         };
-
         try {
           if (rowStore) {
             this.emitScopedFieldMetaUpdate({
@@ -6328,7 +6395,7 @@ export class PlayContextImpl {
               dataPatch: {},
             });
           }
-          if (this.shouldLaunchChildPlaysThroughScheduler()) {
+          if (launchThroughScheduler) {
             const boundaryId = this.childPlayBoundaryId(
               childGovernance.currentRunId,
             );
@@ -6368,7 +6435,7 @@ export class PlayContextImpl {
               childInput: input,
               description: options?.description ?? null,
             });
-            childPlaySlot.release();
+            childPlaySlot?.release();
             const terminal = await this.readScheduledChildTerminal<TOutput>({
               childRunId: childGovernance.currentRunId,
               childPlayName: resolvedName,
@@ -6423,71 +6490,112 @@ export class PlayContextImpl {
               this.consumePendingChildPlaySuspension() ?? suspension,
             );
           }
-          await this.registerInlineChildRun({
-            parentRunId: this.currentRunId,
-            childRunId: childGovernance.currentRunId,
-            childPlayName: resolvedName,
-            staticPipeline: resolvedPlay.staticPipeline ?? null,
-          });
-          const childContext = createPlayContext({
-            ...this.#options,
-            playId: resolvedName,
-            playName: resolvedName,
-            runId: childGovernance.currentRunId,
-            executorToken: await this.mintChildExecutorToken({
-              parentRunId: this.currentRunId,
-              parentPlayName: this.#options.playName,
-              childRunId: childGovernance.currentRunId,
+          const childExecutionScope = deriveChildRunExecutionScope(
+            this.executionScope,
+            {
+              placement: 'inline',
+              runId: childGovernance.currentRunId,
+              playId: resolvedName,
+              receiptNamespace: `${resolvedName}:${childGovernance.currentRunId}`,
+            },
+          );
+          return await executeChildRunLifecycle({
+            scope: childExecutionScope,
+            metadata: {
+              placement: 'inline',
               childPlayName: resolvedName,
-            }),
-            staticPipeline: resolvedPlay.staticPipeline ?? null,
-            checkpoint: this.checkpoint,
-            governance: childGovernance,
-            getRuntimeStepReceipt: undefined,
-            getRuntimeStepReceipts: undefined,
-            claimRuntimeStepReceipt: undefined,
-            claimRuntimeStepReceipts: undefined,
-            completeRuntimeStepReceipt: undefined,
-            completeRuntimeStepReceipts: undefined,
-            failRuntimeStepReceipt: undefined,
-            failRuntimeStepReceipts: undefined,
-            heartbeatRuntimeStepReceipts: undefined,
-            skipRuntimeStepReceipt: undefined,
+              staticPipeline: resolvedPlay.staticPipeline ?? null,
+            },
+            adapter: {
+              open: async () => {
+                await this.registerInlineChildRun({
+                  scope: childExecutionScope,
+                  staticPipeline: resolvedPlay.staticPipeline ?? null,
+                });
+              },
+              // start_inline_child_run records run.started with the durable row.
+              started: () => undefined,
+              complete: async (_scope, _metadata, result) => {
+                await this.settleInlineChildRun({
+                  scope: childExecutionScope,
+                  status: 'completed',
+                  result,
+                });
+              },
+              fail: async (_scope, _metadata, error) => {
+                await this.settleInlineChildRun({
+                  scope: childExecutionScope,
+                  status: isAbortLikeError(error) ? 'cancelled' : 'failed',
+                  error: this.formatRuntimeError(error),
+                });
+              },
+            },
+            execute: async () => {
+              const inlineScalarChild =
+                childExecutionDecision.reason === 'scalar_child';
+              const childContext = createPlayContext({
+                ...this.#options,
+                executionScope: childExecutionScope,
+                playId: resolvedName,
+                playName: resolvedName,
+                runId: childGovernance.currentRunId,
+                executorToken: inlineScalarChild
+                  ? this.#options.executorToken
+                  : await this.mintChildExecutorToken({
+                      parentRunId: this.currentRunId,
+                      parentPlayName: this.#options.playName,
+                      childRunId: childGovernance.currentRunId,
+                      childPlayName: resolvedName,
+                    }),
+                staticPipeline: resolvedPlay.staticPipeline ?? null,
+                checkpoint: this.checkpoint,
+                governance: undefined,
+                executionGovernor: inlineChildGovernor!,
+                ...(inlineScalarChild
+                  ? {}
+                  : {
+                      getRuntimeStepReceipt: undefined,
+                      getRuntimeStepReceipts: undefined,
+                      claimRuntimeStepReceipt: undefined,
+                      claimRuntimeStepReceipts: undefined,
+                      completeRuntimeStepReceipt: undefined,
+                      completeRuntimeStepReceipts: undefined,
+                      failRuntimeStepReceipt: undefined,
+                      failRuntimeStepReceipts: undefined,
+                      heartbeatRuntimeStepReceipts: undefined,
+                      skipRuntimeStepReceipt: undefined,
+                    }),
+              });
+              const childExecution = this.executeResolvedPlay(
+                resolvedPlay,
+                childContext,
+                input,
+              );
+              await childContext.drainQueuedWork([childExecution]);
+              const result = await childExecution;
+              if (rowStore) {
+                this.emitScopedFieldMetaUpdate({
+                  rowId: rowStore.rowId,
+                  key: rowStore.rowKey ?? null,
+                  tableNamespace: rowStore.tableNamespace ?? null,
+                  fieldName: rowStore.fieldName,
+                  status: 'completed',
+                  rowStatus: 'running',
+                  stage: resolvedName,
+                  provider: 'deepline_native',
+                  error: null,
+                  producer,
+                  dataPatch: {},
+                });
+              }
+              this.recordPlayCallStep({
+                playId: resolvedName,
+                description: options?.description,
+                nestedSteps: childContext.getSteps(),
+              });
+              return result as TOutput;
+            },
           });
-          const childExecution = this.executeResolvedPlay(
-            resolvedPlay,
-            childContext,
-            input,
-          );
-          await childContext.drainQueuedWork([childExecution]);
-          const result = await childExecution;
-          if (rowStore) {
-            this.emitScopedFieldMetaUpdate({
-              rowId: rowStore.rowId,
-              key: rowStore.rowKey ?? null,
-              tableNamespace: rowStore.tableNamespace ?? null,
-              fieldName: rowStore.fieldName,
-              status: 'completed',
-              rowStatus: 'running',
-              stage: resolvedName,
-              provider: 'deepline_native',
-              error: null,
-              producer,
-              dataPatch: {},
-            });
-          }
-          const step = {
-            type: 'play_call' as const,
-            playId: resolvedName,
-            nestedSteps: childContext.getSteps(),
-            description: normalizeStepDescription(options?.description),
-          };
-          if (this.activeDatasetStep) {
-            this.activeDatasetStep.substeps.push(step);
-          } else {
-            this.steps.push(step);
-          }
-          return result as TOutput;
         } catch (error) {
           if (isPlayExecutionSuspendedError(error)) {
             throw error;
@@ -6509,7 +6617,7 @@ export class PlayContextImpl {
           }
           throw error;
         } finally {
-          childPlaySlot.release();
+          childPlaySlot?.release();
         }
       };
 
@@ -6588,9 +6696,7 @@ export class PlayContextImpl {
   }
 
   private async registerInlineChildRun(input: {
-    parentRunId: string;
-    childRunId: string;
-    childPlayName: string;
+    scope: RunExecutionScope;
     staticPipeline: unknown;
   }): Promise<void> {
     const baseUrl = this.#options.baseUrl?.trim();
@@ -6606,11 +6712,11 @@ export class PlayContextImpl {
           this.#options.vercelProtectionBypassToken ?? null,
       },
       {
-        playName: input.childPlayName,
-        runId: input.childRunId,
-        parentRunId: input.parentRunId,
-        rootRunId: this.governance.rootRunId,
-        workflowFamilyKey: this.governance.rootRunId,
+        playName: input.scope.logical.playId,
+        runId: input.scope.logical.runId,
+        parentRunId: input.scope.logical.parentRunId,
+        rootRunId: input.scope.logical.rootRunId,
+        workflowFamilyKey: input.scope.logical.rootRunId,
         artifactHash: this.#options.artifactHash ?? null,
         graphHash: this.#options.graphHash ?? null,
         schedulerSchema: this.#options.runtimeSchedulerSchema ?? null,
@@ -6621,6 +6727,35 @@ export class PlayContextImpl {
     );
   }
 
+  private async settleInlineChildRun(input: {
+    scope: RunExecutionScope;
+    status: 'completed' | 'failed' | 'cancelled';
+    result?: unknown;
+    error?: string | null;
+  }): Promise<void> {
+    const baseUrl = this.#options.baseUrl?.trim();
+    const executorToken = this.#options.executorToken?.trim();
+    if (!baseUrl || !executorToken) return;
+
+    await settleInlineChildRunViaAppRuntime(
+      {
+        baseUrl,
+        executorToken,
+        integrationMode: this.#options.integrationMode ?? null,
+        vercelProtectionBypassToken:
+          this.#options.vercelProtectionBypassToken ?? null,
+      },
+      {
+        parentRunId: input.scope.logical.parentRunId ?? this.currentRunId,
+        childRunId: input.scope.logical.runId,
+        childPlayName: input.scope.logical.playId,
+        status: input.status,
+        ...(input.result !== undefined ? { result: input.result } : {}),
+        ...(input.error !== undefined ? { error: input.error } : {}),
+      },
+    );
+  }
+
   /**
    * Extract a list from a tool result.
    * e.g. ctx.extractList(result, 'people', ['first_name', 'last_name', 'email'])
@@ -7229,14 +7364,14 @@ export class PlayContextImpl {
             normalReceiptKeys.length > 0
               ? await this.claimRuntimeStepReceipts(
                   normalReceiptKeys,
-                  this.currentRunId,
+                  this.currentReceiptOwnerRunId,
                 )
               : new Map<string, RuntimeStepReceipt>();
           const forcedClaims =
             claimableForcedReceiptKeys.length > 0
               ? await this.claimRuntimeStepReceipts(
                   claimableForcedReceiptKeys,
-                  this.currentRunId,
+                  this.currentReceiptOwnerRunId,
                   false,
                   true,
                 )
@@ -7245,7 +7380,7 @@ export class PlayContextImpl {
             failedRefreshReceiptKeys.length > 0
               ? await this.claimRuntimeStepReceipts(
                   failedRefreshReceiptKeys,
-                  this.currentRunId,
+                  this.currentReceiptOwnerRunId,
                   false,
                   false,
                   true,
@@ -7393,7 +7528,7 @@ export class PlayContextImpl {
             const reclaimed = (
               await this.claimRuntimeStepReceipts(
                 [receiptKey],
-                this.currentRunId,
+                this.currentReceiptOwnerRunId,
                 true,
                 forceAfterWait,
               )
@@ -7426,7 +7561,7 @@ export class PlayContextImpl {
               if (!reclaimed.leaseId) {
                 throw new RuntimeReceiptLeaseLostError({
                   receiptKey,
-                  runId: this.currentRunId,
+                  runId: this.currentReceiptOwnerRunId,
                   leaseId: 'missing',
                 });
               }
@@ -7564,7 +7699,7 @@ export class PlayContextImpl {
               if (!claim.leaseId) {
                 throw new RuntimeReceiptLeaseLostError({
                   receiptKey,
-                  runId: this.currentRunId,
+                  runId: this.currentReceiptOwnerRunId,
                   leaseId: 'missing',
                 });
               }
@@ -7895,34 +8030,45 @@ export class PlayContextImpl {
           `Play "${resolvedPlay.playId}" is missing a bundled artifact.`,
         );
       }
-      const runtimeModule =
-        (await import('node:module')) as unknown as typeof import('node:module') & {
-          Module: typeof import('node:module').Module & {
-            _nodeModulePaths: (from: string) => string[];
-          };
-        };
-      const compiled = new runtimeModule.Module(artifact.virtualFilename);
-      compiled.filename = artifact.virtualFilename;
-      compiled.paths = runtimeModule.Module._nodeModulePaths(process.cwd());
-      (
-        compiled as import('node:module').Module & {
-          _compile: (code: string, filename: string) => void;
-        }
-      )._compile(artifact.bundledCode, artifact.virtualFilename);
-      const candidate =
-        typeof compiled.exports === 'function'
-          ? compiled.exports
-          : (compiled.exports as { default?: unknown }).default;
-      if (typeof candidate !== 'function') {
-        throw new Error(
-          `Play "${resolvedPlay.playId}" does not export a callable default.`,
-        );
+      const cacheKey = resolvedPlayRevisionFingerprint(resolvedPlay);
+      let executor = this.resolvedPlayExecutorCache.get(cacheKey);
+      if (!executor) {
+        executor = (async (): Promise<ResolvedPlayExecutor> => {
+          const runtimeModule =
+            (await import('node:module')) as unknown as typeof import('node:module') & {
+              Module: typeof import('node:module').Module & {
+                _nodeModulePaths: (from: string) => string[];
+              };
+            };
+          const compiled = new runtimeModule.Module(artifact.virtualFilename);
+          compiled.filename = artifact.virtualFilename;
+          compiled.paths = runtimeModule.Module._nodeModulePaths(process.cwd());
+          (
+            compiled as import('node:module').Module & {
+              _compile: (code: string, filename: string) => void;
+            }
+          )._compile(artifact.bundledCode, artifact.virtualFilename);
+          const candidate =
+            typeof compiled.exports === 'function'
+              ? compiled.exports
+              : (compiled.exports as { default?: unknown }).default;
+          if (typeof candidate !== 'function') {
+            throw new Error(
+              `Play "${resolvedPlay.playId}" does not export a callable default.`,
+            );
+          }
+          return async (childCtx, runtimeInput) =>
+            await (
+              candidate as (
+                runtimeCtx: unknown,
+                value: Record<string, unknown>,
+              ) => Promise<unknown>
+            )(childCtx, runtimeInput);
+        })();
+        this.resolvedPlayExecutorCache.set(cacheKey, executor);
       }
       return await (
-        candidate as (
-          ctx: unknown,
-          runtimeInput: Record<string, unknown>,
-        ) => Promise<unknown>
+        await executor
       )(ctx, input);
     }
 
@@ -7966,7 +8112,7 @@ export class PlayContextImpl {
   }): string {
     const fallbackAttemptId =
       input.force === true && !input.leaseId
-        ? `${this.currentRunId}:${crypto.randomUUID()}`
+        ? `${this.currentReceiptOwnerRunId}:${crypto.randomUUID()}`
         : null;
     return buildDurableToolProviderIdempotencyKey({
       receiptKey: input.cacheKey,