deepline 0.1.215 → 0.1.216

package/dist/bundling-sources/apps/play-runner-workers/src/child-manifest-resolver.ts

@@ -100,6 +100,7 @@ export function createRunScopedChildManifestResolver(
   if (!state) {
     state = createResolutionState(input.preloaded);
     runResolutionStates.set(input.scopeKey, state);
+    pruneRunResolutionStates(now);
   }
   state.lastAccessedAt = now;
 

package/dist/bundling-sources/sdk/src/release.ts

@@ -106,10 +106,10 @@ export const SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: '0.1.215',
+  version: '0.1.216',
   apiContract: '2026-06-dataset-handle-results-hard-cutover',
   supportPolicy: {
-    latest: '0.1.215',
+    latest: '0.1.216',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

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

@@ -47,10 +47,7 @@ import {
   RUNTIME_SCHEDULER_SCHEMA_OVERRIDE_HEADER,
   SYNTHETIC_RUN_HEADER,
 } from './coordinator-headers';
-import {
-  PLAY_RUNTIME_API_CURRENT_PATH,
-  PLAY_RUNTIME_CHILD_EXECUTOR_TOKEN_CURRENT_PATH,
-} from './runtime-api-paths';
+import { PLAY_RUNTIME_API_CURRENT_PATH } from './runtime-api-paths';
 import {
   createRootRunExecutionScope,
   deriveChildRunExecutionScope,
@@ -262,6 +259,15 @@ const rowContext = new AsyncLocalStorage<{
   rowKey?: string;
   mapScope?: MapExecutionScope;
 }>();
+type InlineCompositionStore = {
+  context: PlayContextImpl;
+  executionScope: RunExecutionScope;
+  governor: PlayExecutionGovernor;
+  playName: string;
+  staticPipeline: ContextOptions['staticPipeline'];
+};
+const inlineCompositionContext =
+  new AsyncLocalStorage<InlineCompositionStore>();
 const toolExecutionOverrides = new AsyncLocalStorage<{ force: boolean }>();
 const PROGRESS_HEARTBEAT_INTERVAL_MS = 1_000;
 const PURE_JS_HEARTBEAT_ROW_INTERVAL = 250;
@@ -1270,12 +1276,6 @@ export class PlayContextImpl {
    */
   private readonly governor: PlayExecutionGovernor;
   private readonly resourceGovernor: RuntimeResourceGovernor;
-  /**
-   * Lineage identity for this context (run/play ids + ancestry). Seeded from the
-   * Governor snapshot; used only for receipt keys, durable-boundary scoping, and
-   * child run-id derivation. All policy lives in {@link governor}.
-   */
-  private readonly governance: GovernanceSnapshot;
   private readonly resolvedPlayExecutorCache = new Map<
     string,
     Promise<ResolvedPlayExecutor>
@@ -1443,7 +1443,6 @@ export class PlayContextImpl {
     this.resourceGovernor = createRuntimeResourceGovernor({
       executionGovernor: this.governor,
     });
-    this.governance = this.governor.snapshot();
   }
 
   private durableBoundaryId(localId: string): string {
@@ -1451,7 +1450,33 @@ export class PlayContextImpl {
     // Nested plays and concurrent child calls therefore need a stable run scope
     // in the key, otherwise two children can both produce e.g. "sleep-0-25"
     // and replay the wrong boundary or never observe completion.
-    return `${this.governance.currentRunId}:${localId}`;
+    return `${this.currentGovernance.currentRunId}:${localId}`;
+  }
+
+  private get activeInlineComposition(): InlineCompositionStore | null {
+    const active = inlineCompositionContext.getStore();
+    return active?.context === this ? active : null;
+  }
+
+  private get currentExecutionScope(): RunExecutionScope {
+    return this.activeInlineComposition?.executionScope ?? this.executionScope;
+  }
+
+  private get currentExecutionGovernor(): PlayExecutionGovernor {
+    return this.activeInlineComposition?.governor ?? this.governor;
+  }
+
+  private get currentGovernance(): GovernanceSnapshot {
+    return this.currentExecutionGovernor.snapshot();
+  }
+
+  private get currentPlayName(): string | undefined {
+    return this.activeInlineComposition?.playName ?? this.#options.playName;
+  }
+
+  private get currentStaticPipeline(): ContextOptions['staticPipeline'] {
+    const active = this.activeInlineComposition;
+    return active ? active.staticPipeline : this.#options.staticPipeline;
   }
 
   private shouldLaunchChildPlaysThroughScheduler(): boolean {
@@ -1617,17 +1642,18 @@ export class PlayContextImpl {
     childInput: Record<string, unknown>;
     description?: string | null;
   }): Promise<void> {
+    const parentGovernance = this.currentGovernance;
     const parentPlayName =
-      this.governance.currentPlayId ||
-      this.#options.playName ||
+      parentGovernance.currentPlayId ||
+      this.currentPlayName ||
       this.#options.playId ||
       'anonymous-play';
     const governance: PlayCallGovernanceSnapshot = {
-      rootRunId: this.governance.rootRunId,
-      parentRunId: this.governance.currentRunId,
+      rootRunId: parentGovernance.rootRunId,
+      parentRunId: parentGovernance.currentRunId,
       parentPlayName,
       key: input.key,
-      ancestryPlayIds: [...this.governance.ancestryPlayIds],
+      ancestryPlayIds: [...parentGovernance.ancestryPlayIds],
       callDepth: input.childGovernance.callDepth,
       playCallCount: input.childGovernance.playCallCount,
       toolCallCount: input.childGovernance.toolCallCount,
@@ -1708,7 +1734,7 @@ export class PlayContextImpl {
         headers: await this.runtimeApiHeaders(),
         body: JSON.stringify({
           action: 'read_child_run_terminal_snapshot',
-          parentRunId: this.governance.currentRunId,
+          parentRunId: this.currentGovernance.currentRunId,
           childRunId: input.childRunId,
           childPlayName: input.childPlayName,
         }),
@@ -2716,7 +2742,7 @@ export class PlayContextImpl {
   }): Promise<string> {
     return await this.durableToolCallCacheKeyForScope({
       ...input,
-      playLocalScope: this.governance.currentPlayId,
+      playLocalScope: this.currentGovernance.currentPlayId,
     });
   }
 
@@ -2871,7 +2897,7 @@ export class PlayContextImpl {
       opts.receiptKey?.trim() ||
       durableCtxKey({
         orgId: this.#options.orgId,
-        playId: this.executionScope.receipt.namespace,
+        playId: this.currentExecutionScope.receipt.namespace,
         operation,
         id,
         semanticKey: opts.semanticKey,
@@ -2905,15 +2931,15 @@ export class PlayContextImpl {
   }
 
   private get currentRunId(): string {
-    return this.executionScope.logical.runId;
+    return this.currentExecutionScope.logical.runId;
   }
 
   private get currentReceiptOwnerRunId(): string {
-    return this.executionScope.receipt.ownerRunId;
+    return this.currentExecutionScope.receipt.ownerRunId;
   }
 
   private get currentRunAttempt(): number {
-    return this.executionScope.receipt.ownerAttempt;
+    return this.currentExecutionScope.receipt.ownerAttempt;
   }
 
   private emitScopedFieldMetaUpdate(input: {
@@ -3193,7 +3219,8 @@ export class PlayContextImpl {
     rowKey?: string;
     callId?: string;
   }): string {
-    const scope = this.governance.currentRunId || this.#options.runId || 'run';
+    const scope =
+      this.currentGovernance.currentRunId || this.#options.runId || 'run';
     if (input.callId?.trim()) {
       return `${scope}:${input.callId.trim()}`;
     }
@@ -3961,16 +3988,16 @@ export class PlayContextImpl {
             const flushStartedAt = Date.now();
             try {
               await this.#options.onMapRowsCompleted!({
-                playName: this.#options.playName,
-                playId: this.#options.playId,
-                runId: this.#options.runId,
+                playName: this.currentPlayName,
+                playId: this.currentExecutionScope.logical.playId,
+                runId: this.currentRunId,
                 executorToken: this.#options.executorToken,
                 tableNamespace: resolvedTableNamespace,
                 rows: chunk,
                 outputFields: datasetColumnNames.filter((field) =>
                   shouldPersistMapCellField(field),
                 ),
-                staticPipeline: this.#options.staticPipeline ?? null,
+                staticPipeline: this.currentStaticPipeline ?? null,
               });
               this.resourceGovernor.observe({
                 sheetFlushBytes: chunkBytes,
@@ -4037,11 +4064,11 @@ export class PlayContextImpl {
           pageStartRows,
           resolvedTableNamespace,
           {
-            playName: this.#options.playName,
-            playId: this.#options.playId,
-            runId: this.#options.runId,
+            playName: this.currentPlayName,
+            playId: this.currentExecutionScope.logical.playId,
+            runId: this.currentRunId,
             executorToken: this.#options.executorToken,
-            staticPipeline: this.#options.staticPipeline,
+            staticPipeline: this.currentStaticPipeline,
             forceRefresh: this.#options.cachePolicy?.forceToolRefresh === true,
             inputOffset: page.offset,
           },
@@ -4472,11 +4499,11 @@ export class PlayContextImpl {
         mapStartRows,
         resolvedTableNamespace,
         {
-          playName: this.#options.playName,
-          playId: this.#options.playId,
-          runId: this.#options.runId,
+          playName: this.currentPlayName,
+          playId: this.currentExecutionScope.logical.playId,
+          runId: this.currentRunId,
           executorToken: this.#options.executorToken,
-          staticPipeline: this.#options.staticPipeline,
+          staticPipeline: this.currentStaticPipeline,
           forceRefresh: this.#options.cachePolicy?.forceToolRefresh === true,
         },
       );
@@ -4620,16 +4647,16 @@ export class PlayContextImpl {
           const flushStartedAt = Date.now();
           try {
             const writeResult = await this.#options.onMapRowsCompleted!({
-              playName: this.#options.playName,
-              playId: this.#options.playId,
-              runId: this.#options.runId,
+              playName: this.currentPlayName,
+              playId: this.currentExecutionScope.logical.playId,
+              runId: this.currentRunId,
               executorToken: this.#options.executorToken,
               tableNamespace: resolvedTableNamespace,
               rows: chunk,
               outputFields: datasetColumnNames.filter((field) =>
                 shouldPersistMapCellField(field),
               ),
-              staticPipeline: this.#options.staticPipeline ?? null,
+              staticPipeline: this.currentStaticPipeline ?? null,
             });
             if (writeResult) {
               for (const key of writeResult.staleDroppedKeys ?? []) {
@@ -6158,6 +6185,7 @@ export class PlayContextImpl {
     input: Record<string, unknown>,
     options?: ToolCallOptions,
   ): Promise<unknown> {
+    const executionScope = this.currentExecutionScope;
     const normalizedKey = this.normalizeContextKey(key, 'tool');
     const toolCachePolicy = this.effectiveToolCallCachePolicy(options);
     const toolRequestIdentity = deriveToolRequestIdentity({
@@ -6303,6 +6331,7 @@ export class PlayContextImpl {
       const rowId = store.rowId;
       const fieldName = store.fieldName;
       const callId = [
+        executionScope.receipt.namespace,
         store.tableNamespace?.trim() || 'map',
         store.rowKey?.trim() || String(rowId),
         normalizedKey,
@@ -6669,10 +6698,10 @@ export class PlayContextImpl {
       });
 
       const executePlayCall = async (): Promise<TOutput> => {
-        // Reserve depth + per-parent + descendant/play-call budget on the parent
-        // and fork the lineage-global snapshot for the child. forkChild owns the
-        // cycle guard, depth cap, per-parent cap, and play/descendant charges, so
-        // a recovered receipt (which skips this body) never consumes budget.
+        // Scheduled children reserve the parent's durable play/descendant
+        // budgets. Inline scalar children are function composition: their
+        // Governor view changes only local lineage for recursion/depth checks
+        // and delegates tool admission, pacing, and tool budgets to the parent.
         //
         // The SCHEDULED substrate still allocates a durable child run id (through
         // the shared canonical builder so in-process and the workers_edge
@@ -6682,9 +6711,10 @@ export class PlayContextImpl {
         // settlement. Their only identity is a replay-stable, call-site scoped
         // composition namespace (`child:<playName>#<ordinal>`) used to scope tool
         // receipts under the PARENT run. See child-composition-namespace below.
+        const parentGovernor = this.currentExecutionGovernor;
         const inlineChildGovernor = launchThroughScheduler
           ? null
-          : await this.governor.forkInlineChild({
+          : await parentGovernor.forkInlineChild({
               childPlayName: resolvedName,
               childRunId: this.inlineChildCompositionNamespace(
                 resolvedName,
@@ -6692,7 +6722,7 @@ export class PlayContextImpl {
               ),
             });
         const childGovernance = launchThroughScheduler
-          ? await this.governor.forkChild({
+          ? await parentGovernor.forkChild({
               childPlayName: resolvedName,
               childRunId: buildChildRunId({
                 childPlayName: resolvedName,
@@ -6706,8 +6736,8 @@ export class PlayContextImpl {
             })
           : inlineChildGovernor!.snapshot();
         const childPlaySlot = launchThroughScheduler
-          ? await this.governor.acquireChildSubmitSlot()
-          : await this.governor.acquireInlineChildSlot();
+          ? await parentGovernor.acquireChildSubmitSlot()
+          : null;
         const rowStore = rowContext.getStore();
         const producer = {
           kind: 'play' as const,
@@ -6840,7 +6870,7 @@ export class PlayContextImpl {
           // per-row inline-invocation sanity cap at creation).
           const compositionNamespace = childGovernance.currentRunId;
           const childExecutionScope = deriveChildRunExecutionScope(
-            this.executionScope,
+            this.currentExecutionScope,
             {
               placement: 'inline',
               runId: compositionNamespace,
@@ -6849,49 +6879,22 @@ export class PlayContextImpl {
             },
           );
           this.inlineChildAggregates.total += 1;
-          const inlineScalarChild =
-            childExecutionDecision.reason === 'scalar_child';
-          const childContext = createPlayContext({
-            ...this.#options,
-            executionScope: childExecutionScope,
-            playId: resolvedName,
-            playName: resolvedName,
-            runId: compositionNamespace,
-            executorToken: inlineScalarChild
-              ? this.#options.executorToken
-              : await this.mintChildExecutorToken({
-                  parentRunId: this.currentRunId,
-                  parentPlayName: this.#options.playName,
-                  childRunId: compositionNamespace,
-                  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,
-                }),
-          });
           try {
-            const childExecution = this.executeResolvedPlay(
-              resolvedPlay,
-              childContext,
-              input,
+            // A scalar child is a normal function call on the parent's context.
+            // Async-local identity changes receipt and recursion scope without
+            // allocating another PlayContext, tool queue, drain loop, resource
+            // governor, or receipt client. Calls from every concurrent child
+            // therefore reach the same proven parent batching path.
+            const result = await inlineCompositionContext.run(
+              {
+                context: this,
+                executionScope: childExecutionScope,
+                governor: inlineChildGovernor!,
+                playName: resolvedName,
+                staticPipeline: resolvedPlay.staticPipeline ?? null,
+              },
+              () => this.executeResolvedPlay(resolvedPlay, this, input),
             );
-            await childContext.drainQueuedWork([childExecution]);
-            const result = await childExecution;
             this.inlineChildAggregates.ok += 1;
             if (rowStore) {
               this.emitScopedFieldMetaUpdate({
@@ -6912,7 +6915,6 @@ export class PlayContextImpl {
               playId: resolvedName,
               execution: options?.execution,
               description: options?.description,
-              nestedSteps: childContext.getSteps(),
             });
             return result as TOutput;
           } catch (childError) {
@@ -6950,57 +6952,6 @@ export class PlayContextImpl {
     }
   }
 
-  private async mintChildExecutorToken(input: {
-    parentRunId: string;
-    parentPlayName?: string | null;
-    childRunId: string;
-    childPlayName: string;
-  }): Promise<string | undefined> {
-    if (!this.#options.executorToken || !this.#options.baseUrl) {
-      return this.#options.executorToken;
-    }
-    const parentPlayName = input.parentPlayName?.trim();
-    if (!parentPlayName) {
-      return this.#options.executorToken;
-    }
-    const response = await fetch(
-      `${this.#options.baseUrl.replace(/\/$/, '')}${PLAY_RUNTIME_CHILD_EXECUTOR_TOKEN_CURRENT_PATH}`,
-      {
-        method: 'POST',
-        headers: {
-          Authorization: `Bearer ${this.#options.executorToken}`,
-          'Content-Type': 'application/json',
-          ...(await this.vercelProtectionHeaders()),
-        },
-        body: JSON.stringify({
-          parentRunId: input.parentRunId,
-          parentPlayName,
-          childRunId: input.childRunId,
-          childPlayName: input.childPlayName,
-        }),
-      },
-    );
-    const body = (await response.json().catch(() => null)) as {
-      executorToken?: unknown;
-      error?: unknown;
-    } | null;
-    if (!response.ok) {
-      const message =
-        typeof body?.error === 'string' && body.error.trim()
-          ? body.error.trim()
-          : response.statusText;
-      throw new Error(
-        `ctx.runPlay failed to mint child executor token for "${input.childPlayName}": ${message} (status ${response.status}).`,
-      );
-    }
-    if (typeof body?.executorToken !== 'string' || !body.executorToken.trim()) {
-      throw new Error(
-        `ctx.runPlay failed to mint child executor token for "${input.childPlayName}": response did not include executorToken.`,
-      );
-    }
-    return body.executorToken.trim();
-  }
-
   /**
    * Replay-stable composition namespace for one inline `ctx.runPlay`
    * invocation. Format `child:<playName>#<callKey>[@<rowScope>]`:
@@ -7358,7 +7309,7 @@ export class PlayContextImpl {
 
     const rowStore = rowContext.getStore();
     const scope = rowStore ? `row-${rowStore.rowId}` : 'workflow';
-    const callIndexKey = `${scope}:${normalizedKey}`;
+    const callIndexKey = `${this.currentExecutionScope.receipt.namespace}:${scope}:${normalizedKey}`;
     const callIndex = this.stepCallIndexByKey.get(callIndexKey) ?? 0;
     this.stepCallIndexByKey.set(callIndexKey, callIndex + 1);
     const boundarySuffix = callIndex === 0 ? '' : `:${callIndex}`;

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

@@ -106,13 +106,6 @@ export interface PlayExecutionGovernor {
   acquireRowSlot(opts?: { signal?: AbortSignal }): Promise<WorkLease>;
   /** Block until a child-play submit slot is free. Released after submit, not terminal. */
   acquireChildSubmitSlot(opts?: { signal?: AbortSignal }): Promise<WorkLease>;
-  /**
-   * Block until an in-process child-composition slot is free. Unlike a
-   * scheduled child's submit slot, this lease is held through child terminal
-   * execution so a large row fan-out cannot materialize thousands of child
-   * contexts and receipt closures at once.
-   */
-  acquireInlineChildSlot(opts?: { signal?: AbortSignal }): Promise<WorkLease>;
   /**
    * Block until a global tool-concurrency slot AND the per-(org,provider) pacer
    * permit are free, then charge the tool-call budget and return a lease. Order:
@@ -404,7 +397,6 @@ export function createPlayExecutionGovernor(
 
     acquireRowSlot: (opts) => rowSlots.acquire(opts?.signal),
     acquireChildSubmitSlot: (opts) => childPlaySlots.acquire(opts?.signal),
-    acquireInlineChildSlot: (opts) => childPlaySlots.acquire(opts?.signal),
 
     async acquireToolSlot(toolId, opts) {
       // 1. global tool-concurrency slot.
@@ -548,7 +540,7 @@ export function createPlayExecutionGovernor(
     async forkInlineChild(childInput) {
       return createInlineChildGovernor(
         governor,
-        await governor.forkChild(childInput),
+        deriveInlineChildSnapshot(state, childInput, policy),
       );
     },
 
@@ -601,6 +593,38 @@ export function createPlayExecutionGovernor(
   return governor;
 }
 
+function deriveInlineChildSnapshot(
+  parent: GovernanceSnapshot,
+  input: { childPlayName: string; childRunId: string },
+  policy: ResolvedExecutionPolicy,
+): GovernanceSnapshot {
+  if (parent.ancestryPlayIds.includes(input.childPlayName)) {
+    throw new Error(
+      `Recursive play graph detected: ${[
+        ...parent.ancestryPlayIds,
+        input.childPlayName,
+      ].join(' -> ')}`,
+    );
+  }
+  const nextDepth = parent.callDepth + 1;
+  if (nextDepth > policy.budgets.maxPlayCallDepth) {
+    throw new GovernorBudgetError(
+      'playDepth',
+      nextDepth,
+      policy.budgets.maxPlayCallDepth,
+    );
+  }
+  return {
+    ...parent,
+    currentRunId: input.childRunId,
+    currentPlayId: input.childPlayName,
+    ancestryPlayIds: [...parent.ancestryPlayIds, input.childPlayName],
+    ancestryRunIds: [...parent.ancestryRunIds, input.childRunId],
+    callDepth: nextDepth,
+    parentChildCalls: {},
+  };
+}
+
 function createInlineChildGovernor(
   root: PlayExecutionGovernor,
   initial: GovernanceSnapshot,
@@ -620,17 +644,6 @@ function createInlineChildGovernor(
     policy: root.policy,
     acquireRowSlot: (opts) => root.acquireRowSlot(opts),
     acquireChildSubmitSlot: (opts) => root.acquireChildSubmitSlot(opts),
-    async acquireInlineChildSlot(opts) {
-      if (opts?.signal?.aborted) {
-        throw opts.signal.reason instanceof Error
-          ? opts.signal.reason
-          : new Error('Slot acquire aborted.');
-      }
-      // This governor already runs inside a root inline-child lease. Descendant
-      // composition shares that admitted subtree slot; reacquiring the root
-      // semaphore here can deadlock when every admitted parent awaits a child.
-      return { release: () => {} };
-    },
     acquireToolSlot: (toolId, opts) => root.acquireToolSlot(toolId, opts),
     suggestedParallelism: (toolId, fallback) =>
       root.suggestedParallelism(toolId, fallback),
@@ -686,7 +699,10 @@ function createInlineChildGovernor(
       };
     },
     async forkInlineChild(input) {
-      return createInlineChildGovernor(child, await child.forkChild(input));
+      return createInlineChildGovernor(
+        child,
+        deriveInlineChildSnapshot(child.snapshot(), input, child.policy),
+      );
     },
     snapshot() {
       const counters = root.snapshot();

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

@@ -587,10 +587,10 @@ async function postRuntimeApi<TResponse>(
         ? parsed.retry_after_ms
         : RUNTIME_API_DEFAULT_RETRY_AFTER_MS;
     const details =
-      typeof parsed?.details === 'string'
-        ? parsed.details
-        : typeof parsed?.detail === 'string'
-          ? parsed.detail
+      typeof parsed?.detail === 'string'
+        ? parsed.detail
+        : typeof parsed?.details === 'string'
+          ? parsed.details
           : typeof parsed?.debug_error === 'string'
             ? parsed.debug_error
             : null;

package/dist/cli/index.js

@@ -623,10 +623,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.215",
+  version: "0.1.216",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.215",
+    latest: "0.1.216",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -13348,7 +13348,9 @@ function normalizeProgressForEnvelope(status, rowsInfo) {
   const pending = getNumericField(progress, "pending") ?? (typeof total === "number" && typeof completed === "number" && typeof failed === "number" ? Math.max(0, total - completed - failed) : null);
   return {
     total,
+    totalRows: total,
     completed,
+    completedRows: completed,
     pending,
     failed,
     executed: getNumericField(progress, "executed"),
@@ -15483,7 +15485,7 @@ async function handleRunsList(args) {
   return 0;
 }
 async function handleRunTail(args) {
-  const usage = "Usage: deepline runs tail <run-id> [--json] [--compact]";
+  const usage = "Usage: deepline runs tail <run-id> [--json | --jsonl] [--compact]";
   let runId;
   try {
     runId = parseRunIdPositional(args, usage);
@@ -15499,13 +15501,18 @@ async function handleRunTail(args) {
       );
       return 1;
     }
-    if (arg.startsWith("--") && arg !== "--json" && arg !== "--compact") {
+    if (arg.startsWith("--") && arg !== "--json" && arg !== "--jsonl" && arg !== "--compact") {
       console.error(`${arg} is not supported by deepline runs tail.`);
       return 1;
     }
   }
+  if (args.includes("--json") && args.includes("--jsonl")) {
+    console.error("--json and --jsonl cannot be used together.");
+    return 1;
+  }
   const client2 = new DeeplineClient();
-  const jsonOutput = argsWantJson(args);
+  const jsonLines = args.includes("--jsonl");
+  const jsonOutput = !jsonLines && argsWantJson(args);
   const compact = args.includes("--compact");
   const compactState = {
     lastLogIndex: 0,
@@ -15515,7 +15522,16 @@ async function handleRunTail(args) {
     lastStatusHeartbeatAt: 0
   };
   const status = await client2.runs.tail(runId, {
-    onEvent: compact && !jsonOutput ? (event) => {
+    onEvent: jsonLines ? (event) => {
+      process.stdout.write(
+        `${JSON.stringify({
+          schemaVersion: 1,
+          kind: "play_run_event",
+          event
+        })}
+`
+      );
+    } : compact && !jsonOutput ? (event) => {
       const transition = getStepTransitionLineFromLiveEvent(
         event,
         compactState
@@ -15545,7 +15561,12 @@ async function handleRunTail(args) {
       );
     }
   });
-  writePlayResult(status, jsonOutput);
+  if (jsonLines) {
+    process.stdout.write(`${JSON.stringify(compactPlayStatus(status))}
+`);
+  } else {
+    writePlayResult(status, jsonOutput);
+  }
   return status.status === "failed" ? 1 : 0;
 }
 async function handleRunLogs(args) {
@@ -16911,19 +16932,26 @@ Examples:
 Notes:
   Streams live run events until the stream ends. Use get for current status and
   logs for persisted log history. In human output, --compact prints deduplicated
-  step transitions and progress instead of the full event stream.
+  step transitions and progress instead of the full event stream. --json emits
+  one terminal package. --jsonl emits canonical live events as JSON Lines and
+  ends with the same compact package shape as runs get --json.
 
 Examples:
   deepline runs tail play/my-play/run/20260501t000000-000
-  deepline runs tail play/my-play/run/20260501t000000-000 --compact --json
+  deepline runs tail play/my-play/run/20260501t000000-000 --compact
+  deepline runs tail play/my-play/run/20260501t000000-000 --jsonl
 `
-  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").option(
+  ).option("--json", "Emit one terminal JSON package after the run completes").option(
+    "--jsonl",
+    "Stream live events as JSON Lines, then the terminal package"
+  ).option(
     "--compact",
-    "Show deduplicated step transitions and progress; compact JSON output"
+    "Show deduplicated human step transitions and progress"
   ).action(async (runId, options) => {
     process.exitCode = await handleRunTail([
       runId,
       ...options.json ? ["--json"] : [],
+      ...options.jsonl ? ["--jsonl"] : [],
       ...options.compact ? ["--compact"] : []
     ]);
   });

package/dist/cli/index.mjs

@@ -608,10 +608,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.215",
+  version: "0.1.216",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.215",
+    latest: "0.1.216",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -13377,7 +13377,9 @@ function normalizeProgressForEnvelope(status, rowsInfo) {
   const pending = getNumericField(progress, "pending") ?? (typeof total === "number" && typeof completed === "number" && typeof failed === "number" ? Math.max(0, total - completed - failed) : null);
   return {
     total,
+    totalRows: total,
     completed,
+    completedRows: completed,
     pending,
     failed,
     executed: getNumericField(progress, "executed"),
@@ -15512,7 +15514,7 @@ async function handleRunsList(args) {
   return 0;
 }
 async function handleRunTail(args) {
-  const usage = "Usage: deepline runs tail <run-id> [--json] [--compact]";
+  const usage = "Usage: deepline runs tail <run-id> [--json | --jsonl] [--compact]";
   let runId;
   try {
     runId = parseRunIdPositional(args, usage);
@@ -15528,13 +15530,18 @@ async function handleRunTail(args) {
       );
       return 1;
     }
-    if (arg.startsWith("--") && arg !== "--json" && arg !== "--compact") {
+    if (arg.startsWith("--") && arg !== "--json" && arg !== "--jsonl" && arg !== "--compact") {
       console.error(`${arg} is not supported by deepline runs tail.`);
       return 1;
     }
   }
+  if (args.includes("--json") && args.includes("--jsonl")) {
+    console.error("--json and --jsonl cannot be used together.");
+    return 1;
+  }
   const client2 = new DeeplineClient();
-  const jsonOutput = argsWantJson(args);
+  const jsonLines = args.includes("--jsonl");
+  const jsonOutput = !jsonLines && argsWantJson(args);
   const compact = args.includes("--compact");
   const compactState = {
     lastLogIndex: 0,
@@ -15544,7 +15551,16 @@ async function handleRunTail(args) {
     lastStatusHeartbeatAt: 0
   };
   const status = await client2.runs.tail(runId, {
-    onEvent: compact && !jsonOutput ? (event) => {
+    onEvent: jsonLines ? (event) => {
+      process.stdout.write(
+        `${JSON.stringify({
+          schemaVersion: 1,
+          kind: "play_run_event",
+          event
+        })}
+`
+      );
+    } : compact && !jsonOutput ? (event) => {
       const transition = getStepTransitionLineFromLiveEvent(
         event,
         compactState
@@ -15574,7 +15590,12 @@ async function handleRunTail(args) {
       );
     }
   });
-  writePlayResult(status, jsonOutput);
+  if (jsonLines) {
+    process.stdout.write(`${JSON.stringify(compactPlayStatus(status))}
+`);
+  } else {
+    writePlayResult(status, jsonOutput);
+  }
   return status.status === "failed" ? 1 : 0;
 }
 async function handleRunLogs(args) {
@@ -16940,19 +16961,26 @@ Examples:
 Notes:
   Streams live run events until the stream ends. Use get for current status and
   logs for persisted log history. In human output, --compact prints deduplicated
-  step transitions and progress instead of the full event stream.
+  step transitions and progress instead of the full event stream. --json emits
+  one terminal package. --jsonl emits canonical live events as JSON Lines and
+  ends with the same compact package shape as runs get --json.
 
 Examples:
   deepline runs tail play/my-play/run/20260501t000000-000
-  deepline runs tail play/my-play/run/20260501t000000-000 --compact --json
+  deepline runs tail play/my-play/run/20260501t000000-000 --compact
+  deepline runs tail play/my-play/run/20260501t000000-000 --jsonl
 `
-  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").option(
+  ).option("--json", "Emit one terminal JSON package after the run completes").option(
+    "--jsonl",
+    "Stream live events as JSON Lines, then the terminal package"
+  ).option(
     "--compact",
-    "Show deduplicated step transitions and progress; compact JSON output"
+    "Show deduplicated human step transitions and progress"
   ).action(async (runId, options) => {
     process.exitCode = await handleRunTail([
       runId,
       ...options.json ? ["--json"] : [],
+      ...options.jsonl ? ["--jsonl"] : [],
       ...options.compact ? ["--compact"] : []
     ]);
   });

package/dist/index.js

@@ -422,10 +422,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.215",
+  version: "0.1.216",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.215",
+    latest: "0.1.216",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/dist/index.mjs

@@ -352,10 +352,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.215",
+  version: "0.1.216",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.215",
+    latest: "0.1.216",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.215",
+  "version": "0.1.216",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {