deepline 0.3.229 → 0.3.230

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.229",
+  version: "0.3.230",
   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
@@ -3135,12 +3135,84 @@ function normalizeDatasetBornFrom(value) {
 
 // ../play-runtime/run-ledger.ts
 var LOG_TAIL_LIMIT = 100;
+var TERMINAL_STATUSES = /* @__PURE__ */ new Set([
+  "completed",
+  "failed",
+  "cancelled",
+  "terminated",
+  "timed_out"
+]);
 function isRecord5(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function finiteNumber(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
+function nonnegativeSafeInteger(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function isWorkCounterSegmentId(value) {
+  return typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(
+    value
+  );
+}
+function normalizePlayRunLedgerTerminalWorkCounterSegment(value) {
+  if (!isRecord5(value)) return void 0;
+  if (!nonnegativeSafeInteger(value.attempt) || !nonnegativeSafeInteger(value.invocationSeq) || value.invocationSeq === 0 || !isWorkCounterSegmentId(value.segmentId)) {
+    return void 0;
+  }
+  return {
+    attempt: value.attempt,
+    invocationSeq: value.invocationSeq,
+    segmentId: value.segmentId
+  };
+}
+function hasConfirmedPlayRunLedgerWorkCounters(snapshot) {
+  const counters = snapshot.workCounters;
+  const terminal = snapshot.terminalWorkCounterSegment;
+  return Boolean(
+    isTerminalPlayRunLedgerStatus(snapshot.status) && (snapshot.terminalSource === "worker" || snapshot.terminalSource === "system") && counters?.final && counters.completeThroughAttempt && counters.consistent && terminal && counters.attempt === terminal.attempt && counters.invocationSeq === terminal.invocationSeq && counters.segmentId === terminal.segmentId && Number.isSafeInteger(
+      counters.completedLogicalCalls + counters.logicalCalls
+    ) && Number.isSafeInteger(
+      counters.completedProviderRequests + counters.providerRequests
+    ) && Number.isSafeInteger(
+      counters.completedProvider429s + counters.provider429s
+    )
+  );
+}
+function normalizeWorkCounters(value) {
+  if (!isRecord5(value)) return void 0;
+  for (const field of [
+    "attempt",
+    "invocationSeq",
+    "logicalCalls",
+    "providerRequests",
+    "provider429s",
+    "completedLogicalCalls",
+    "completedProviderRequests",
+    "completedProvider429s"
+  ]) {
+    if (!nonnegativeSafeInteger(value[field])) return void 0;
+  }
+  if (value.invocationSeq === 0 || !isWorkCounterSegmentId(value.segmentId) || typeof value.final !== "boolean" || typeof value.completeThroughAttempt !== "boolean" || typeof value.consistent !== "boolean") {
+    return void 0;
+  }
+  return {
+    ...value,
+    attempt: value.attempt,
+    invocationSeq: value.invocationSeq,
+    segmentId: value.segmentId,
+    logicalCalls: value.logicalCalls,
+    providerRequests: value.providerRequests,
+    provider429s: value.provider429s,
+    final: value.final,
+    completedLogicalCalls: value.completedLogicalCalls,
+    completedProviderRequests: value.completedProviderRequests,
+    completedProvider429s: value.completedProvider429s,
+    completeThroughAttempt: value.completeThroughAttempt,
+    consistent: value.consistent
+  };
+}
 function optionalFiniteNumber(value) {
   const normalized = finiteNumber(value);
   return normalized === null ? void 0 : normalized;
@@ -3182,6 +3254,9 @@ function normalizePlayRunLedgerStatus(value) {
       return "unknown";
   }
 }
+function isTerminalPlayRunLedgerStatus(status) {
+  return TERMINAL_STATUSES.has(status);
+}
 function summarizeRunRowOutcomes(snapshot) {
   let completedRows = 0;
   let failedRows = 0;
@@ -3316,6 +3391,10 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
   const error = Object.prototype.hasOwnProperty.call(value, "error") ? optionalNullableString(value.error) ?? null : fallback.error ?? null;
   const rawTail = Array.isArray(value.logTail) ? value.logTail : value.logs;
   const logTail = Array.isArray(rawTail) ? rawTail.filter((line) => typeof line === "string") : [];
+  const workCounters = normalizeWorkCounters(value.workCounters);
+  const terminalWorkCounterSegment = normalizePlayRunLedgerTerminalWorkCounterSegment(
+    value.terminalWorkCounterSegment
+  );
   return {
     runId: optionalString(value.runId) ?? fallback.runId,
     playName: optionalNullableString(value.playName) ?? fallback.playName ?? null,
@@ -3338,6 +3417,8 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
       (activityId) => typeof activityId === "string" && Boolean(activitiesById[activityId])
     ),
     activitiesById,
+    ...workCounters ? { workCounters } : {},
+    ...terminalWorkCounterSegment ? { terminalWorkCounterSegment } : {},
     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.
@@ -3545,6 +3626,13 @@ function buildSnapshotFromLedger(snapshot) {
   const liveStatus = normalizePlayRunLiveStatus(snapshot.status);
   const terminalRowOutcomes = isTerminalPlayRunLiveStatus(liveStatus) ? summarizeRunRowOutcomes(snapshot) : null;
   const rowOutcomes = terminalRowOutcomes && (Object.keys(snapshot.stepsById).length > 0 || terminalRowOutcomes.totalRows > 0 || (terminalRowOutcomes.supersededRows ?? 0) > 0) ? terminalRowOutcomes : null;
+  const workCounters = snapshot.workCounters;
+  const calls = workCounters ? {
+    logicalCalls: workCounters.completedLogicalCalls + workCounters.logicalCalls,
+    providerRequests: workCounters.completedProviderRequests + workCounters.providerRequests,
+    provider429s: workCounters.completedProvider429s + workCounters.provider429s,
+    confirmed: isTerminalPlayRunLiveStatus(liveStatus) && hasConfirmedPlayRunLedgerWorkCounters(snapshot)
+  } : null;
   return {
     runId: snapshot.runId,
     status: liveStatus,
@@ -3569,7 +3657,10 @@ function buildSnapshotFromLedger(snapshot) {
     activeActivity: snapshot.activeActivityId ? snapshot.activitiesById[snapshot.activeActivityId] ?? null : null,
     nodeStates,
     activeNodeId: snapshot.activeStepId ?? null,
-    ...rowOutcomes ? { rowOutcomes } : {}
+    ...rowOutcomes ? { rowOutcomes } : {},
+    ...calls && Object.values(calls).every(
+      (value) => typeof value === "boolean" || Number.isSafeInteger(value)
+    ) ? { calls } : {}
   };
 }
 function buildPlayRunStatusSnapshot(input) {

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.229",
+  version: "0.3.230",
   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
@@ -3039,12 +3039,84 @@ function normalizeDatasetBornFrom(value) {
 
 // ../play-runtime/run-ledger.ts
 var LOG_TAIL_LIMIT = 100;
+var TERMINAL_STATUSES = /* @__PURE__ */ new Set([
+  "completed",
+  "failed",
+  "cancelled",
+  "terminated",
+  "timed_out"
+]);
 function isRecord5(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 function finiteNumber(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
+function nonnegativeSafeInteger(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function isWorkCounterSegmentId(value) {
+  return typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(
+    value
+  );
+}
+function normalizePlayRunLedgerTerminalWorkCounterSegment(value) {
+  if (!isRecord5(value)) return void 0;
+  if (!nonnegativeSafeInteger(value.attempt) || !nonnegativeSafeInteger(value.invocationSeq) || value.invocationSeq === 0 || !isWorkCounterSegmentId(value.segmentId)) {
+    return void 0;
+  }
+  return {
+    attempt: value.attempt,
+    invocationSeq: value.invocationSeq,
+    segmentId: value.segmentId
+  };
+}
+function hasConfirmedPlayRunLedgerWorkCounters(snapshot) {
+  const counters = snapshot.workCounters;
+  const terminal = snapshot.terminalWorkCounterSegment;
+  return Boolean(
+    isTerminalPlayRunLedgerStatus(snapshot.status) && (snapshot.terminalSource === "worker" || snapshot.terminalSource === "system") && counters?.final && counters.completeThroughAttempt && counters.consistent && terminal && counters.attempt === terminal.attempt && counters.invocationSeq === terminal.invocationSeq && counters.segmentId === terminal.segmentId && Number.isSafeInteger(
+      counters.completedLogicalCalls + counters.logicalCalls
+    ) && Number.isSafeInteger(
+      counters.completedProviderRequests + counters.providerRequests
+    ) && Number.isSafeInteger(
+      counters.completedProvider429s + counters.provider429s
+    )
+  );
+}
+function normalizeWorkCounters(value) {
+  if (!isRecord5(value)) return void 0;
+  for (const field of [
+    "attempt",
+    "invocationSeq",
+    "logicalCalls",
+    "providerRequests",
+    "provider429s",
+    "completedLogicalCalls",
+    "completedProviderRequests",
+    "completedProvider429s"
+  ]) {
+    if (!nonnegativeSafeInteger(value[field])) return void 0;
+  }
+  if (value.invocationSeq === 0 || !isWorkCounterSegmentId(value.segmentId) || typeof value.final !== "boolean" || typeof value.completeThroughAttempt !== "boolean" || typeof value.consistent !== "boolean") {
+    return void 0;
+  }
+  return {
+    ...value,
+    attempt: value.attempt,
+    invocationSeq: value.invocationSeq,
+    segmentId: value.segmentId,
+    logicalCalls: value.logicalCalls,
+    providerRequests: value.providerRequests,
+    provider429s: value.provider429s,
+    final: value.final,
+    completedLogicalCalls: value.completedLogicalCalls,
+    completedProviderRequests: value.completedProviderRequests,
+    completedProvider429s: value.completedProvider429s,
+    completeThroughAttempt: value.completeThroughAttempt,
+    consistent: value.consistent
+  };
+}
 function optionalFiniteNumber(value) {
   const normalized = finiteNumber(value);
   return normalized === null ? void 0 : normalized;
@@ -3086,6 +3158,9 @@ function normalizePlayRunLedgerStatus(value) {
       return "unknown";
   }
 }
+function isTerminalPlayRunLedgerStatus(status) {
+  return TERMINAL_STATUSES.has(status);
+}
 function summarizeRunRowOutcomes(snapshot) {
   let completedRows = 0;
   let failedRows = 0;
@@ -3220,6 +3295,10 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
   const error = Object.prototype.hasOwnProperty.call(value, "error") ? optionalNullableString(value.error) ?? null : fallback.error ?? null;
   const rawTail = Array.isArray(value.logTail) ? value.logTail : value.logs;
   const logTail = Array.isArray(rawTail) ? rawTail.filter((line) => typeof line === "string") : [];
+  const workCounters = normalizeWorkCounters(value.workCounters);
+  const terminalWorkCounterSegment = normalizePlayRunLedgerTerminalWorkCounterSegment(
+    value.terminalWorkCounterSegment
+  );
   return {
     runId: optionalString(value.runId) ?? fallback.runId,
     playName: optionalNullableString(value.playName) ?? fallback.playName ?? null,
@@ -3242,6 +3321,8 @@ function normalizePlayRunLedgerSnapshot(value, fallback) {
       (activityId) => typeof activityId === "string" && Boolean(activitiesById[activityId])
     ),
     activitiesById,
+    ...workCounters ? { workCounters } : {},
+    ...terminalWorkCounterSegment ? { terminalWorkCounterSegment } : {},
     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.
@@ -3449,6 +3530,13 @@ function buildSnapshotFromLedger(snapshot) {
   const liveStatus = normalizePlayRunLiveStatus(snapshot.status);
   const terminalRowOutcomes = isTerminalPlayRunLiveStatus(liveStatus) ? summarizeRunRowOutcomes(snapshot) : null;
   const rowOutcomes = terminalRowOutcomes && (Object.keys(snapshot.stepsById).length > 0 || terminalRowOutcomes.totalRows > 0 || (terminalRowOutcomes.supersededRows ?? 0) > 0) ? terminalRowOutcomes : null;
+  const workCounters = snapshot.workCounters;
+  const calls = workCounters ? {
+    logicalCalls: workCounters.completedLogicalCalls + workCounters.logicalCalls,
+    providerRequests: workCounters.completedProviderRequests + workCounters.providerRequests,
+    provider429s: workCounters.completedProvider429s + workCounters.provider429s,
+    confirmed: isTerminalPlayRunLiveStatus(liveStatus) && hasConfirmedPlayRunLedgerWorkCounters(snapshot)
+  } : null;
   return {
     runId: snapshot.runId,
     status: liveStatus,
@@ -3473,7 +3561,10 @@ function buildSnapshotFromLedger(snapshot) {
     activeActivity: snapshot.activeActivityId ? snapshot.activitiesById[snapshot.activeActivityId] ?? null : null,
     nodeStates,
     activeNodeId: snapshot.activeStepId ?? null,
-    ...rowOutcomes ? { rowOutcomes } : {}
+    ...rowOutcomes ? { rowOutcomes } : {},
+    ...calls && Object.values(calls).every(
+      (value) => typeof value === "boolean" || Number.isSafeInteger(value)
+    ) ? { calls } : {}
   };
 }
 function buildPlayRunStatusSnapshot(input) {

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.229";
+    readonly version: "0.3.230";
     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.229";
+    readonly version: "0.3.230";
     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.229",
+  version: "0.3.230",
   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.229",
+  version: "0.3.230",
   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.229",
+  "version": "0.3.230",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",