deepline 0.3.208 → 0.3.209

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

@@ -200,7 +200,7 @@ export const SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: '0.3.208',
+  version: '0.3.209',
   updateSummary:
     'Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.',
   packageCapabilities: {

package/dist/bundling-sources/shared_libs/play-runtime/run-ledger.ts

@@ -126,6 +126,9 @@ export type PlayRunLedgerSnapshot = {
   runId: string;
   playName?: string | null;
   status: PlayRunLedgerStatus;
+  /** Typed scheduler wait, when a durable waiting event supplied it. */
+  waitKind?: string | null;
+  waitUntil?: number | null;
   error?: string | null;
   createdAt?: number | null;
   startedAt?: number | null;
@@ -201,6 +204,8 @@ export type PlayRunLedgerEvent =
     })
   | (PlayRunLedgerBaseEvent & {
       type: 'run.waiting';
+      waitKind?: string | null;
+      waitUntil?: number | null;
     })
   | (PlayRunLedgerBaseEvent & {
       type: 'run.resumed';
@@ -541,6 +546,8 @@ export function createEmptyPlayRunLedgerSnapshot(input: {
     runId: input.runId,
     playName: input.playName ?? null,
     status,
+    waitKind: null,
+    waitUntil: null,
     error: optionalNullableString(input.error) ?? null,
     createdAt: finiteNumber(input.createdAt) ?? null,
     startedAt,
@@ -677,6 +684,8 @@ export function normalizePlayRunLedgerSnapshot(
     playName:
       optionalNullableString(value.playName) ?? fallback.playName ?? null,
     status: normalizePlayRunLedgerStatus(value.status ?? fallback.status),
+    waitKind: optionalNullableString(value.waitKind),
+    waitUntil: finiteNumber(value.waitUntil),
     error,
     createdAt,
     startedAt,
@@ -1312,11 +1321,17 @@ export function reducePlayRunLedgerEvent(
       return withTiming({
         ...base,
         status: 'waiting',
+        waitKind: event.waitKind ?? null,
+        waitUntil: event.waitUntil ?? null,
+        activeActivityId: null,
       });
     case 'run.resumed':
       return withTiming({
         ...base,
         status: 'running',
+        waitKind: null,
+        waitUntil: null,
+        activeActivityId: null,
       });
     case 'run.completed':
       return (
@@ -1330,6 +1345,8 @@ export function reducePlayRunLedgerEvent(
         withTiming({
           ...settleRunningStepsOnTerminal(base, 'completed', occurredAt),
           status: 'completed',
+          waitKind: null,
+          waitUntil: null,
           error: null,
           startedAt: base.startedAt ?? occurredAt,
           finishedAt: terminalFinishedAt(base, event.type, occurredAt),
@@ -1358,6 +1375,8 @@ export function reducePlayRunLedgerEvent(
         withTiming({
           ...settleRunningStepsOnTerminal(base, 'failed', occurredAt),
           status: 'failed',
+          waitKind: null,
+          waitUntil: null,
           error:
             base.status === 'failed'
               ? (base.error ?? event.error ?? null)
@@ -1386,6 +1405,8 @@ export function reducePlayRunLedgerEvent(
         withTiming({
           ...settleRunningStepsOnTerminal(base, 'failed', occurredAt),
           status: 'cancelled',
+          waitKind: null,
+          waitUntil: null,
           error:
             base.status === 'cancelled'
               ? (base.error ?? event.error ?? null)

package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/postgres.ts

@@ -78,6 +78,7 @@ import {
 } from '../work-receipts';
 import type { PlayStaticPipeline } from '../../plays/static-pipeline';
 import {
+  isPlayRunLedgerOpaqueEvent,
   LOG_TAIL_LIMIT,
   type AcceptedPlayRunLedgerEvent,
   type PlayRunLedgerEvent,
@@ -15920,6 +15921,64 @@ async function appendRunLedgerOutboxFact(
 
 export { RunLedgerProjectionLeaseLostError } from '../run-ledger-projection-contract';
 
+/**
+ * A newer app can receive a projection from a worker that predates optional
+ * wait metadata. Treat only those absent fields as their canonical values;
+ * lease identity, event ordering, and every field the worker did send remain
+ * exact.
+ */
+function normalizeLegacyRunWaitingProjectionFields(
+  projectedEvents: readonly AcceptedPlayRunLedgerEvent[],
+  expectedEvents: readonly (
+    | AcceptedPlayRunLedgerEvent
+    | PlayRunLedgerIngressEvent
+  )[],
+): AcceptedPlayRunLedgerEvent[] {
+  return projectedEvents.map((event, index) => {
+    const expected = expectedEvents[index];
+    if (
+      isPlayRunLedgerOpaqueEvent(event) ||
+      event.type !== 'run.waiting' ||
+      expected?.type !== 'run.waiting' ||
+      ('opaque' in expected && expected.opaque === true)
+    ) {
+      return event;
+    }
+    const expectedEvent = expected as Record<string, unknown>;
+    const expectedWaitKind = expectedEvent.waitKind;
+    const expectedWaitUntil = expectedEvent.waitUntil;
+    return {
+      ...event,
+      ...(event.waitKind === undefined &&
+      (typeof expectedWaitKind === 'string' || expectedWaitKind === null)
+        ? { waitKind: expectedWaitKind }
+        : {}),
+      ...(event.waitUntil === undefined &&
+      (typeof expectedWaitUntil === 'number' || expectedWaitUntil === null)
+        ? { waitUntil: expectedWaitUntil }
+        : {}),
+    };
+  });
+}
+
+function runLedgerProjectionMatchesCanonicalPrefix(
+  projectedEvents: readonly AcceptedPlayRunLedgerEvent[],
+  expectedEvents: readonly (
+    | AcceptedPlayRunLedgerEvent
+    | PlayRunLedgerIngressEvent
+  )[],
+): boolean {
+  if (projectedEvents.length !== expectedEvents.length) return false;
+  return (
+    stableStringify(
+      normalizeLegacyRunWaitingProjectionFields(
+        projectedEvents,
+        expectedEvents,
+      ),
+    ) === stableStringify(expectedEvents)
+  );
+}
+
 /** Extend only our still-live lease before another bounded transport piece. */
 export async function renewPostgresRunLedgerDelivery(
   client: PostgresSchedulerQueryClient,
@@ -16074,12 +16133,17 @@ export async function assertPostgresRunLedgerDelivery(
           }),
         );
       }
-      const comparablePrefixEvents = input.normalizeProjectedEvents
+      const comparablePrefixEvents: readonly (
+        | AcceptedPlayRunLedgerEvent
+        | PlayRunLedgerIngressEvent
+      )[] = input.normalizeProjectedEvents
         ? input.normalizeProjectedEvents(prefixEvents)
         : prefixEvents;
       if (
-        stableStringify(input.projectedEvents) ===
-        stableStringify(comparablePrefixEvents)
+        runLedgerProjectionMatchesCanonicalPrefix(
+          input.projectedEvents,
+          comparablePrefixEvents,
+        )
       ) {
         return;
       }
@@ -16965,6 +17029,9 @@ export function buildRunLedgerEventsFromPostgresSchedulerOutbox(
       runId: event.runId,
       occurredAt,
       source: 'system',
+      ...(event.eventType === 'run.waiting' && waitKind !== null
+        ? { waitKind }
+        : {}),
     } as PlayRunLedgerEvent;
     if (
       waitKind !== null &&

package/dist/cli/index.js

@@ -3051,7 +3051,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.208",
+  version: "0.3.209",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -5450,6 +5450,8 @@ function createEmptyPlayRunLedgerSnapshot(input2) {
     runId: input2.runId,
     playName: input2.playName ?? null,
     status,
+    waitKind: null,
+    waitUntil: null,
     error: optionalNullableString(input2.error) ?? null,
     createdAt: finiteNumber(input2.createdAt) ?? null,
     startedAt,
@@ -5546,6 +5548,8 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
     runId: optionalString(value.runId) ?? fallback.runId,
     playName: optionalNullableString(value.playName) ?? fallback.playName ?? null,
     status: normalizePlayRunLedgerStatus(value.status ?? fallback.status),
+    waitKind: optionalNullableString(value.waitKind),
+    waitUntil: finiteNumber(value.waitUntil),
     error,
     createdAt,
     startedAt,

package/dist/cli/index.mjs

@@ -3046,7 +3046,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.208",
+  version: "0.3.209",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -5445,6 +5445,8 @@ function createEmptyPlayRunLedgerSnapshot(input2) {
     runId: input2.runId,
     playName: input2.playName ?? null,
     status,
+    waitKind: null,
+    waitUntil: null,
     error: optionalNullableString(input2.error) ?? null,
     createdAt: finiteNumber(input2.createdAt) ?? null,
     startedAt,
@@ -5541,6 +5543,8 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
     runId: optionalString(value.runId) ?? fallback.runId,
     playName: optionalNullableString(value.playName) ?? fallback.playName ?? null,
     status: normalizePlayRunLedgerStatus(value.status ?? fallback.status),
+    waitKind: optionalNullableString(value.waitKind),
+    waitUntil: finiteNumber(value.waitUntil),
     error,
     createdAt,
     startedAt,

package/dist/index.js

@@ -864,7 +864,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.208",
+  version: "0.3.209",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -3211,6 +3211,8 @@ function createEmptyPlayRunLedgerSnapshot(input) {
     runId: input.runId,
     playName: input.playName ?? null,
     status,
+    waitKind: null,
+    waitUntil: null,
     error: optionalNullableString(input.error) ?? null,
     createdAt: finiteNumber(input.createdAt) ?? null,
     startedAt,
@@ -3307,6 +3309,8 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
     runId: optionalString(value.runId) ?? fallback.runId,
     playName: optionalNullableString(value.playName) ?? fallback.playName ?? null,
     status: normalizePlayRunLedgerStatus(value.status ?? fallback.status),
+    waitKind: optionalNullableString(value.waitKind),
+    waitUntil: finiteNumber(value.waitUntil),
     error,
     createdAt,
     startedAt,

package/dist/index.mjs

@@ -768,7 +768,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.208",
+  version: "0.3.209",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -3115,6 +3115,8 @@ function createEmptyPlayRunLedgerSnapshot(input) {
     runId: input.runId,
     playName: input.playName ?? null,
     status,
+    waitKind: null,
+    waitUntil: null,
     error: optionalNullableString(input.error) ?? null,
     createdAt: finiteNumber(input.createdAt) ?? null,
     startedAt,
@@ -3211,6 +3213,8 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
     runId: optionalString(value.runId) ?? fallback.runId,
     playName: optionalNullableString(value.playName) ?? fallback.playName ?? null,
     status: normalizePlayRunLedgerStatus(value.status ?? fallback.status),
+    waitKind: optionalNullableString(value.waitKind),
+    waitUntil: finiteNumber(value.waitUntil),
     error,
     createdAt,
     startedAt,

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.208";
+    readonly version: "0.3.209";
     readonly updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.d.ts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.208";
+    readonly version: "0.3.209";
     readonly updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.js

@@ -74,7 +74,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.208",
+  version: "0.3.209",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/release.mjs

@@ -48,7 +48,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.208",
+  version: "0.3.209",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.208",
+  "version": "0.3.209",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",