deepline 0.3.461 → 0.3.462

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

@@ -89,7 +89,8 @@ function splitRunEventForAppRuntime(
           0,
         );
       const metadataBytes = lineIds
-        ? appRuntimeTextEncoder.encode(JSON.stringify(lineIds[index])).length + 1
+        ? appRuntimeTextEncoder.encode(JSON.stringify(lineIds[index])).length +
+          1
         : 0;
       if (
         index > start &&
@@ -218,25 +219,120 @@ export function selectRunEventsForAppRuntimeProjectionChunk(
  * events before grouping them into HTTP batches. A split can still fit in one
  * HTTP batch, so that request has no projection chunk marker.
  */
+/** Strip ONLY optional diagnostics before reconstructing an older projector's byte boundary. */
+export function withoutTerminalRuntimePerformance(
+  events: readonly PlayRunLedgerIngressEvent[],
+): PlayRunLedgerIngressEvent[] {
+  return events.map((event) => {
+    if (
+      event.type !== RUN_EVENT_KIND.runCompleted &&
+      event.type !== RUN_EVENT_KIND.runFailed
+    )
+      return event;
+    const {
+      terminalRuntimePerformance: _performance,
+      terminalRuntimePerformanceUnavailableReason: _reason,
+      ...legacy
+    } = event;
+    return legacy;
+  });
+}
+
+/** Preserve the old performance core while matching readers predating body telemetry. */
+function withoutToolResponseBodyAdmission(
+  events: readonly PlayRunLedgerIngressEvent[],
+): PlayRunLedgerIngressEvent[] {
+  return events.map((event) => {
+    if (
+      event.type !== RUN_EVENT_KIND.runCompleted &&
+      event.type !== RUN_EVENT_KIND.runFailed
+    )
+      return event;
+    const performance = event.terminalRuntimePerformance;
+    if (!isRecord(performance)) return event;
+    const admission = performance.memoryAdmission;
+    if (!isRecord(admission) || !Object.hasOwn(admission, 'toolResponseBody'))
+      return event;
+    const { toolResponseBody: _body, ...remainingAdmission } = admission;
+    const { memoryAdmission: _admission, ...legacyPerformance } = performance;
+    return {
+      ...event,
+      terminalRuntimePerformance: {
+        ...legacyPerformance,
+        ...(Object.keys(remainingAdmission).length > 0
+          ? { memoryAdmission: remainingAdmission }
+          : {}),
+      },
+    };
+  });
+}
+
 export function runEventsForAppRuntimeProjectionCandidates(
   events: readonly PlayRunLedgerIngressEvent[],
   chunk?: RunLedgerProjectionChunk,
+  allowTerminalPerformanceOmission = false,
+  projectedEvents?: readonly PlayRunLedgerIngressEvent[],
 ): Array<PlayRunLedgerIngressEvent[] | null> {
-  if (chunk) {
-    return [selectRunEventsForAppRuntimeProjectionChunk(events, chunk) ?? null];
+  const prefixes = [events];
+  if (
+    allowTerminalPerformanceOmission &&
+    events.some(
+      (event) =>
+        (event.type === RUN_EVENT_KIND.runCompleted ||
+          event.type === RUN_EVENT_KIND.runFailed) &&
+        (Object.hasOwn(event, 'terminalRuntimePerformance') ||
+          Object.hasOwn(event, 'terminalRuntimePerformanceUnavailableReason')),
+    )
+  ) {
+    prefixes.push(withoutTerminalRuntimePerformance(events));
   }
-
-  const candidates: PlayRunLedgerIngressEvent[][] = [[...events]];
-  const batches = partitionRunEventsForAppRuntime(events);
-  if (batches.length === 1) {
-    const transportBatch = batches[0];
-    if (
-      transportBatch &&
-      (transportBatch.length !== events.length ||
-        transportBatch.some((event, index) => event !== events[index]))
-    ) {
-      candidates.push(transportBatch);
-    }
+  // Older projectors can preserve the known performance core while dropping
+  // this optional nested field. Eligibility comes from the actual submitted,
+  // sanitized events; a present body is never downgraded to omission.
+  if (
+    projectedEvents !== undefined &&
+    projectedEvents.every((event) => {
+      const performance = event.terminalRuntimePerformance;
+      const admission = isRecord(performance)
+        ? performance.memoryAdmission
+        : undefined;
+      return (
+        !isRecord(admission) || !Object.hasOwn(admission, 'toolResponseBody')
+      );
+    }) &&
+    events.some((event) => {
+      if (
+        event.type !== RUN_EVENT_KIND.runCompleted &&
+        event.type !== RUN_EVENT_KIND.runFailed
+      )
+        return false;
+      const performance = event.terminalRuntimePerformance;
+      return (
+        isRecord(performance) &&
+        isRecord(performance.memoryAdmission) &&
+        Object.hasOwn(performance.memoryAdmission, 'toolResponseBody')
+      );
+    })
+  ) {
+    // Select legacy chunks from the legacy prefix, never strip after partition.
+    prefixes.push(withoutToolResponseBodyAdmission(events));
   }
-  return candidates;
+  return prefixes.flatMap((prefix) => {
+    if (chunk)
+      return [
+        selectRunEventsForAppRuntimeProjectionChunk(prefix, chunk) ?? null,
+      ];
+    const candidates: PlayRunLedgerIngressEvent[][] = [[...prefix]];
+    const batches = partitionRunEventsForAppRuntime(prefix);
+    if (batches.length === 1) {
+      const batch = batches[0];
+      if (
+        batch &&
+        (batch.length !== prefix.length ||
+          batch.some((event, index) => event !== prefix[index]))
+      )
+        candidates.push(batch);
+    }
+    return candidates;
+  });
 }

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

@@ -1,3 +1,9 @@
+import {
+  normalizeTerminalRuntimePerformance,
+  normalizeTerminalRuntimePerformanceUnavailableReason,
+  type TerminalRuntimePerformance,
+  type TerminalRuntimePerformanceUnavailableReason,
+} from './terminal-runtime-performance';
 import {
   normalizePlayRunFailure,
   PLATFORM_DEPLOY_INTERRUPTED_MESSAGE,
@@ -193,6 +199,8 @@ export type PlayRunLedgerSnapshot = {
   workCounters?: PlayRunLedgerWorkCounters;
   /** Absent on terminals produced before runner invocation evidence existed. */
   terminalWorkCounterSegment?: PlayRunLedgerTerminalWorkCounterSegment;
+  terminalRuntimePerformance?: TerminalRuntimePerformance;
+  terminalRuntimePerformanceUnavailableReason?: TerminalRuntimePerformanceUnavailableReason;
   /**
    * Bounded tail of the run's log lines (last {@link LOG_TAIL_LIMIT}).
    * Full retention lives in the Run Log Stream (Convex `playRunLogChunks`);
@@ -267,6 +275,8 @@ export type PlayRunLedgerEvent =
       result?: unknown;
       resultSummary?: unknown;
       terminalWorkCounterSegment?: PlayRunLedgerTerminalWorkCounterSegment;
+      terminalRuntimePerformance?: TerminalRuntimePerformance;
+      terminalRuntimePerformanceUnavailableReason?: TerminalRuntimePerformanceUnavailableReason;
     })
   | (PlayRunLedgerBaseEvent & {
       type: typeof RUN_EVENT_KIND.runFailed;
@@ -274,6 +284,8 @@ export type PlayRunLedgerEvent =
       result?: unknown;
       resultSummary?: unknown;
       terminalWorkCounterSegment?: PlayRunLedgerTerminalWorkCounterSegment;
+      terminalRuntimePerformance?: TerminalRuntimePerformance;
+      terminalRuntimePerformanceUnavailableReason?: TerminalRuntimePerformanceUnavailableReason;
     })
   | (PlayRunLedgerBaseEvent & {
       type: typeof RUN_EVENT_KIND.runCancelled;
@@ -980,6 +992,26 @@ export function normalizePlayRunLedgerSnapshot(
     normalizePlayRunLedgerTerminalWorkCounterSegment(
       value.terminalWorkCounterSegment,
     );
+  const performanceAllowed =
+    (value.status === 'completed' || value.status === 'failed') &&
+    (value.terminalSource === 'worker' || value.terminalSource === 'system');
+  const terminalRuntimePerformance =
+    performanceAllowed &&
+    (value.terminalWorkCounterSegment == null || terminalWorkCounterSegment)
+      ? normalizeTerminalRuntimePerformance(
+          value.terminalRuntimePerformance,
+          terminalWorkCounterSegment,
+        )
+      : undefined;
+  const terminalRuntimePerformanceUnavailableReason =
+    performanceAllowed && !terminalRuntimePerformance
+      ? (normalizeTerminalRuntimePerformanceUnavailableReason(
+          value.terminalRuntimePerformanceUnavailableReason,
+        ) ??
+        (value.terminalRuntimePerformance != null
+          ? ('invalid_terminal_performance' as const)
+          : undefined))
+      : undefined;
   return {
     runId: optionalString(value.runId) ?? fallback.runId,
     playName:
@@ -1016,6 +1048,10 @@ export function normalizePlayRunLedgerSnapshot(
     activitiesById,
     ...(workCounters ? { workCounters } : {}),
     ...(terminalWorkCounterSegment ? { terminalWorkCounterSegment } : {}),
+    ...(terminalRuntimePerformance ? { terminalRuntimePerformance } : {}),
+    ...(terminalRuntimePerformanceUnavailableReason
+      ? { terminalRuntimePerformanceUnavailableReason }
+      : {}),
     logTail: logTail.slice(-LOG_TAIL_LIMIT),
     // Snapshots persisted before totalLogCount existed only know the retained
     // tail, so the best lower bound for the cumulative count is the tail size.
@@ -1894,6 +1930,27 @@ export function reducePlayRunLedgerEvent(
               event.terminalWorkCounterSegment,
             )
           : undefined;
+      const acceptsPerformance =
+        (event.source === 'worker' || event.source === 'system') &&
+        (!isTerminalPlayRunLedgerStatus(base.status) ||
+          base.terminalSource === 'coordinator');
+      const terminalRuntimePerformance =
+        acceptsPerformance &&
+        (event.terminalWorkCounterSegment == null || terminalWorkCounterSegment)
+          ? normalizeTerminalRuntimePerformance(
+              event.terminalRuntimePerformance,
+              terminalWorkCounterSegment,
+            )
+          : undefined;
+      const terminalRuntimePerformanceUnavailableReason =
+        acceptsPerformance && !terminalRuntimePerformance
+          ? (normalizeTerminalRuntimePerformanceUnavailableReason(
+              event.terminalRuntimePerformanceUnavailableReason,
+            ) ??
+            (event.terminalRuntimePerformance != null
+              ? ('invalid_terminal_performance' as const)
+              : undefined))
+          : undefined;
       return (
         conflictingTerminalSnapshot(base, event.type, occurredAt, null, {
           allowStaleSameStatusPayloadMerge:
@@ -1902,7 +1959,9 @@ export function reducePlayRunLedgerEvent(
             (base.resultSummary === undefined &&
               event.resultSummary !== undefined) ||
             (base.terminalWorkCounterSegment === undefined &&
-              terminalWorkCounterSegment !== undefined),
+              terminalWorkCounterSegment !== undefined) ||
+            terminalRuntimePerformance !== undefined ||
+            terminalRuntimePerformanceUnavailableReason !== undefined,
         }) ??
         withTiming({
           ...settleRunningStepsOnTerminal(
@@ -1926,6 +1985,16 @@ export function reducePlayRunLedgerEvent(
           resultSummary: event.resultSummary ?? base.resultSummary,
           terminalWorkCounterSegment:
             base.terminalWorkCounterSegment ?? terminalWorkCounterSegment,
+          ...(base.terminalRuntimePerformance
+            ? {}
+            : terminalRuntimePerformance
+              ? { terminalRuntimePerformance }
+              : {}),
+          ...(base.terminalRuntimePerformanceUnavailableReason
+            ? {}
+            : terminalRuntimePerformanceUnavailableReason
+              ? { terminalRuntimePerformanceUnavailableReason }
+              : {}),
           terminalSource: nextTerminalSource(base, event.source),
         })
       );
@@ -1939,6 +2008,27 @@ export function reducePlayRunLedgerEvent(
               event.terminalWorkCounterSegment,
             )
           : undefined;
+      const acceptsPerformance =
+        (event.source === 'worker' || event.source === 'system') &&
+        (!isTerminalPlayRunLedgerStatus(base.status) ||
+          base.terminalSource === 'coordinator');
+      const terminalRuntimePerformance =
+        acceptsPerformance &&
+        (event.terminalWorkCounterSegment == null || terminalWorkCounterSegment)
+          ? normalizeTerminalRuntimePerformance(
+              event.terminalRuntimePerformance,
+              terminalWorkCounterSegment,
+            )
+          : undefined;
+      const terminalRuntimePerformanceUnavailableReason =
+        acceptsPerformance && !terminalRuntimePerformance
+          ? (normalizeTerminalRuntimePerformanceUnavailableReason(
+              event.terminalRuntimePerformanceUnavailableReason,
+            ) ??
+            (event.terminalRuntimePerformance != null
+              ? ('invalid_terminal_performance' as const)
+              : undefined))
+          : undefined;
       return (
         retryablePlatformDeployFailureSnapshot(base, event.error) ??
         conflictingTerminalSnapshot(base, event.type, occurredAt, event.error, {
@@ -1949,7 +2039,9 @@ export function reducePlayRunLedgerEvent(
               event.resultSummary !== undefined) ||
             canPromoteTerminalResultReference(base.result, event.result) ||
             (base.terminalWorkCounterSegment === undefined &&
-              terminalWorkCounterSegment !== undefined),
+              terminalWorkCounterSegment !== undefined) ||
+            terminalRuntimePerformance !== undefined ||
+            terminalRuntimePerformanceUnavailableReason !== undefined,
         }) ??
         withTiming({
           ...settleRunningStepsOnTerminal(
@@ -1976,6 +2068,16 @@ export function reducePlayRunLedgerEvent(
           resultSummary: event.resultSummary ?? base.resultSummary,
           terminalWorkCounterSegment:
             base.terminalWorkCounterSegment ?? terminalWorkCounterSegment,
+          ...(base.terminalRuntimePerformance
+            ? {}
+            : terminalRuntimePerformance
+              ? { terminalRuntimePerformance }
+              : {}),
+          ...(base.terminalRuntimePerformanceUnavailableReason
+            ? {}
+            : terminalRuntimePerformanceUnavailableReason
+              ? { terminalRuntimePerformanceUnavailableReason }
+              : {}),
           terminalSource: nextTerminalSource(base, event.source),
         })
       );