deepline 0.3.315 → 0.3.317

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.315',
+  version: '0.3.317',
   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/sdk/src/runs/overview.ts

@@ -209,7 +209,11 @@ function stepExecution(
 
 /** A read-only overview of recorded run facts, never a complete row export. */
 export function buildRunOverview(status: PlayStatus, fullStatus?: PlayStatus) {
-  const pkg = status.package;
+  // Full inspection can observe a later lifecycle transition than the compact
+  // read. Present its package and status together; older full servers without
+  // a package retain the existing compact inspection path.
+  const inspectedStatus = fullStatus?.package ? fullStatus : status;
+  const pkg = inspectedStatus.package;
   if (!pkg) {
     throw new Error(
       'This server did not return a run package; use runs get --full --json.',
@@ -218,7 +222,10 @@ export function buildRunOverview(status: PlayStatus, fullStatus?: PlayStatus) {
   const outputs = Object.entries(pkg.outputs);
   const resultPackage = fullStatus?.package?.resultState
     ? fullStatus.package
-    : pkg;
+    : (status.package ?? pkg);
+  // The CLI requests this log window with its compact read; full inspection
+  // may omit that independent query option.
+  const failedLogs = inspectedStatus.failedLogs ?? status.failedLogs;
   const warnings = [...(pkg.warnings ?? [])];
   const { outcome: _outcome, ...run } = pkg.run;
   const steps = pkg.steps.map((step) => {
@@ -373,13 +380,13 @@ export function buildRunOverview(status: PlayStatus, fullStatus?: PlayStatus) {
   return {
     schemaVersion: pkg.schemaVersion,
     kind: 'run_overview',
-    ...((status.runStatus ?? pkg.runStatus)
-      ? { runStatus: status.runStatus ?? pkg.runStatus }
+    ...((inspectedStatus.runStatus ?? pkg.runStatus)
+      ? { runStatus: inspectedStatus.runStatus ?? pkg.runStatus }
       : {}),
     run: {
       ...run,
-      ...(status.revisionId && !run.revisionId
-        ? { revisionId: status.revisionId }
+      ...(inspectedStatus.revisionId && !run.revisionId
+        ? { revisionId: inspectedStatus.revisionId }
         : {}),
     },
     steps,
@@ -406,23 +413,23 @@ export function buildRunOverview(status: PlayStatus, fullStatus?: PlayStatus) {
     },
     errorDetails: {
       coverage: 'unknown',
-      reported: record(pkg)?.errors ?? record(status)?.errors ?? [],
+      reported: record(pkg)?.errors ?? record(inspectedStatus)?.errors ?? [],
       ...(pkg.run.error ? { run: pkg.run.error } : {}),
       steps: steps
         .filter((step) => step.error)
         .map((step) => ({ stepId: step.id, message: step.error })),
       ...(pkg.next?.logs ? { getMore: 'actions.getLogsCmd' } : {}),
     },
-    rowOutcomes: status.rowOutcomes,
+    rowOutcomes: inspectedStatus.rowOutcomes ?? pkg.rowOutcomes,
     warnings,
-    ...(status.failedLogs ? { failedLogs: status.failedLogs } : {}),
+    ...(failedLogs ? { failedLogs } : {}),
     datasets,
     ...(Object.hasOwn(resultPackage, 'result')
       ? { result: resultPackage.result }
       : {}),
     resultState: resultPackage.resultState ?? 'unavailable',
     actions: {
-      ...lifecycleActions(status, pkg.run.id, pkg.run.status),
+      ...lifecycleActions(inspectedStatus, pkg.run.id, pkg.run.status),
       ...actions(pkg.next, {
         inspect: 'getRunCmd',
         full: 'getFullRunCmd',

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

@@ -793,11 +793,8 @@ export type PlayRunDatasetActions = {
 };
 
 /**
- * Compact canonical package for an inspected play run.
- *
- * This object is designed for SDK/CLI/API consumers that need stable run
- * metadata, output handles, and follow-up actions without reading dashboard
- * internals.
+ * Compact canonical run package for SDK/CLI consumers: stable metadata,
+ * output handles and follow-up actions without dashboard internals.
  */
 export interface PlayRunPackage {
   /** Package schema version. */
@@ -818,6 +815,8 @@ export interface PlayRunPackage {
   overview?: RunLifecycleStatus;
   /** Optional bounded live evidence from the existing run status projection. */
   runStatus?: RunGetStatus;
+  /** Terminal scalar row outcomes shared with full status and watch snapshots. */
+  rowOutcomes?: PlayStatus['rowOutcomes'];
   /** Run identity, status, timing, and dashboard metadata. */
   run: {
     id: string;
@@ -969,6 +968,8 @@ export interface PlayStatus {
     failedRows: number;
     totalRows: number;
     hasRowFailures: boolean;
+    /** Terminal rows omitted from this run's latest view because a newer write won. */
+    supersededRows?: number;
   };
   /** Compact typed run package returned by current run status endpoints. */
   package?: PlayRunPackage;

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

@@ -385,9 +385,24 @@ export type WorkerRuntimeApiContext = {
    * gateway record that produced it.
    */
   onResponseMeta?: (meta: RuntimeApiResponseMeta) => void;
+  /**
+   * Observe each request attempt as it is sent. `onResponseMeta` only fires
+   * for a successful response, so an attempt that is aborted or times out
+   * names nothing there; this carries the per-attempt id that the request
+   * already sends in its transport-attempt header, which a receiver can log.
+   * Diagnostic only: log it, never persist it on a run, status, or receipt
+   * document.
+   */
+  onRequestAttempt?: (attempt: RuntimeApiRequestAttempt) => void;
   signal?: AbortSignal;
 };
 
+export type RuntimeApiRequestAttempt = {
+  action: RuntimeApiRequest['action'];
+  /** The value of this attempt's transport-attempt request header. */
+  transportAttemptId: string;
+};
+
 /**
  * The receipt gateway's own account of a request, from its `Server-Timing`
  * response header. Its `runtime.gateway.action.finished` durationMs starts
@@ -423,6 +438,19 @@ export type RuntimeApiResponseMeta = {
   roundTripMs?: number | null;
   /** Absent when the gateway sent no `Server-Timing` header. */
   serverTiming?: RuntimeGatewayServerTiming | null;
+  /**
+   * The hosting platform's id for the responding request (`x-vercel-id`), so a
+   * slow app-runtime hop can be matched to its platform request log. Null when
+   * the receiver is not fronted by one. Diagnostic only: log it, never persist
+   * it on a run, status, or receipt document.
+   */
+  platformRequestId?: string | null;
+  /**
+   * The raw `Server-Timing` header, truncated. App routes name their own
+   * entries, which `serverTiming` (the gateway's schema) does not parse.
+   * Diagnostic only, under the same rule as `platformRequestId`.
+   */
+  serverTimingHeader?: string | null;
   /**
    * Serialized JSON bytes of the request body, before compression. Set on
    * every request, so `wire / raw` across a run is the compression ratio the
@@ -447,6 +475,27 @@ export type RuntimeApiResponseMeta = {
   requestBodyPackMs?: number | null;
 };
 
+const RUNTIME_API_DIAGNOSTIC_HEADER_MAX_CHARS = 256;
+
+/**
+ * Read one response header for a log line: trimmed, bounded, and total. A
+ * receiver controls this value, so it is capped before it reaches a record.
+ */
+export function readRuntimeApiDiagnosticHeader(
+  headers: Pick<Headers, 'get'> | null | undefined,
+  name: string,
+): string | null {
+  try {
+    const value = headers?.get(name)?.trim();
+    return value
+      ? value.slice(0, RUNTIME_API_DIAGNOSTIC_HEADER_MAX_CHARS)
+      : null;
+  } catch {
+    // Observation must never affect durable delivery.
+    return null;
+  }
+}
+
 const RUNTIME_GATEWAY_AUTH_SESSION_VALUES = new Set([
   'hit',
   'miss',
@@ -1519,6 +1568,13 @@ async function postAppRuntimeApi<TResponse>(
     // would show up as network cost that no round trip explains.
     const attemptStartedAt = Date.now();
     const transportAttemptId = randomUUID();
+    if (context.onRequestAttempt) {
+      try {
+        context.onRequestAttempt({ action: body.action, transportAttemptId });
+      } catch {
+        // Observation must never affect durable delivery.
+      }
+    }
     const requestSignal = context.signal
       ? AbortSignal.any([context.signal, AbortSignal.timeout(requestTimeoutMs)])
       : AbortSignal.timeout(requestTimeoutMs);
@@ -1680,6 +1736,14 @@ async function postAppRuntimeApi<TResponse>(
               serverTiming: parseRuntimeGatewayServerTiming(
                 response.headers.get('server-timing'),
               ),
+              platformRequestId: readRuntimeApiDiagnosticHeader(
+                response.headers,
+                'x-vercel-id',
+              ),
+              serverTimingHeader: readRuntimeApiDiagnosticHeader(
+                response.headers,
+                'server-timing',
+              ),
               requestBodyRawBytes: wireBody.rawBytes,
               requestBodyWireBytes: wireBody.wireBytes,
               requestBodySerializeMs,