deepline 0.3.237 → 0.3.238

package/dist/bundling-sources/sdk/src/stream-reconnect.ts

@@ -1,13 +1,9 @@
 import { DeeplineError } from './errors.js';
 
 /**
- * Shared reconnect policy for the canonical run SSE stream.
- *
- * Server stream windows are finite: the platform ends them cleanly at the
- * function ceiling even while the run keeps executing. Consumers that wait for
- * a terminal status (`plays run --watch`, `runs tail`, `client.runs.tail`)
- * therefore reconnect with full-jitter exponential backoff instead of treating
- * a window end as a failure.
+ * Retry policy for the legacy run SSE compatibility method. Ordinary run
+ * watching uses a fixed REST snapshot cadence and shares only the transient
+ * read-error classification below.
  */
 
 /** Base delay for the full-jitter exponential backoff between reconnects. */
@@ -29,7 +25,7 @@ export function streamReconnectDelayMs(attempt: number): number {
   return Math.max(1, Math.floor(Math.random() * (cappedExponentialMs + 1)));
 }
 
-export function isTransientPlayStreamError(error: unknown): boolean {
+export function isTransientPlayRunReadError(error: unknown): boolean {
   if (
     error instanceof DeeplineError &&
     error.code === 'PLAY_STREAM_NETWORK_ABORTED'
@@ -37,10 +33,8 @@ export function isTransientPlayStreamError(error: unknown): boolean {
     return true;
   }
   if (error instanceof DeeplineError && typeof error.statusCode === 'number') {
-    // Server-shaped errors with a definite status code are NOT transient by
-    // pattern — only network-level failures are. 5xx counts as transient
-    // since the server may recover, but 4xx (especially 404 = run gone) is
-    // terminal and should not be hidden behind a silent retry loop.
+    // 5xx responses and network-level failures may recover. Client errors,
+    // especially 404, stay visible instead of disappearing into a retry loop.
     return error.statusCode >= 500 && error.statusCode < 600;
   }
   const text = error instanceof Error ? error.message : String(error);
@@ -48,3 +42,6 @@ export function isTransientPlayStreamError(error: unknown): boolean {
     text,
   );
 }
+
+/** @deprecated Use `isTransientPlayRunReadError`. */
+export const isTransientPlayStreamError = isTransientPlayRunReadError;

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

@@ -30,9 +30,9 @@ import { stripProvenanceTag } from './log-provenance';
  * The canonical client-side projection of a persisted Play Run document into
  * the live snapshot shape, plus the differ that turns successive snapshots
  * into incremental `play.*` live events. This module is shared between the
- * Vercel app (legacy SSE shim, dashboard) and the SDK subscription transport
- * (`packages/sdk/src/runs/observe-transport.ts`), so both watchers render identical
- * event streams from the same Convex Run Snapshot. See ADR-0008.
+ * Vercel app (dashboard and legacy SSE compatibility) and the SDK REST polling
+ * watcher (`packages/sdk/src/runs/watch-polling.ts`), so both use the same
+ * event projection from the persisted Run Snapshot. See ADR-0008.
  */
 
 export type PlayRunLiveStatus = PlayRunLifecycleStatus;
@@ -551,7 +551,7 @@ function diffLogLines(input: {
   const missingCount = tailFirstSeq - 1 - input.lastLogSeq;
   return {
     lines: [
-      `[stream] ${missingCount} log lines not retained in the live window; full logs via runs logs`,
+      `[watch] ${missingCount} log lines not retained in the live window; full logs via runs logs`,
       ...logs,
     ],
     lastLogSeq: totalLogCount,