deepline 0.3.205 → 0.3.207

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

@@ -63,6 +63,7 @@ import type {
   ResolvedConfig,
   PlayRevisionSummary,
   PlayRunListItem,
+  PlaysActivityResponse,
   PlayDetail,
   PlayCheckResult,
   PlayRunResult,
@@ -5466,6 +5467,18 @@ export class DeeplineClient {
     return this.requestPlaysPage(options);
   }
 
+  /** Count durable Play runs and Monitor deliveries in local calendar days. */
+  async getPlaysActivity(
+    options: {
+      timeZone?: string;
+      days?: number;
+      endDate?: string;
+      groupBy?: 'kind' | 'trigger_source';
+    } = {},
+  ): Promise<PlaysActivityResponse> {
+    return this.http.post('/api/v2/plays/activity', options);
+  }
+
   private async requestPlaysPage(
     options?: PlaysListOptions & {
       limit?: number;

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

@@ -273,6 +273,7 @@ export type {
   StartPlayRunRequest,
   PlayCostEstimate,
   PlayListItem,
+  PlaysActivityResponse,
   CustomerDbQueryResult,
   DeeplineToolCategory,
   PlayBootstrapFinderKind,

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.205',
+  version: '0.3.207',
   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/types.ts

@@ -1134,6 +1134,42 @@ export function isStopAllPlayRunsDryRunResult(
   return 'dryRun' in result && result.dryRun === true;
 }
 
+/** Bounded daily counts from durable Play runs and Monitor delivery receipts. */
+export interface PlaysActivityResponse {
+  timeZone: string;
+  groupBy: 'kind' | 'trigger_source';
+  endDate: string;
+  /** Current-day query cutoff, when the window ends today. */
+  asOfAt?: number;
+  buckets: Array<{
+    key: string;
+    label: string;
+    startAt: number;
+    endAt: number;
+    groups: Array<{
+      group:
+        | 'play_run'
+        | 'monitor_delivery'
+        | 'manual'
+        | 'api'
+        | 'cron'
+        | 'webhook'
+        | 'sql_listener'
+        | 'async_child';
+      count: number;
+    }>;
+    failedPlayRuns: number;
+    complete: { playRuns: boolean; monitorDeliveries: boolean };
+  }>;
+  coverage: {
+    playRunsEarliestCompleteAt: number | null;
+    monitorDeliveriesEarliestCompleteAt: number | null;
+    monitorDeliveriesCompleteThroughAt: number | null;
+    projectionPending: boolean;
+    earliestPendingAt: number | null;
+  };
+}
+
 /**
  * Summary of a single play run, returned by {@link DeeplineClient.listPlayRuns}.
  */

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

@@ -748,7 +748,8 @@ export type AbsurdRuntimeWorkerDeps = {
   inspectDetachedRunner?: (suspension: DetachedRunnerSuspension) => Promise<{
     exitCode: number | null;
     result: PlayRunnerResult | null;
-    diagnosis: { stage: string; detail: string | null };
+    // Written by the runner, possibly an older build: readers default it.
+    diagnosis?: { stage: string; detail: string | null };
   } | null>;
   readSandboxCrashDiagnostic?: (
     request: PostgresSchedulerSandboxCrashDiagnosticRequest,
@@ -4356,7 +4357,7 @@ async function resolveDetachedRunnerOutcome(input: {
   let inspection: {
     exitCode: number | null;
     result: PlayRunnerResult | null;
-    diagnosis: { stage: string; detail: string | null };
+    diagnosis?: { stage: string; detail: string | null };
   } | null = null;
   let inspectionFailed = false;
   if (input.inspectDetachedRunner) {
@@ -4370,7 +4371,7 @@ async function resolveDetachedRunnerOutcome(input: {
             runnerAttempt: suspension.runnerAttempt,
             sandboxId: suspension.sandboxId,
             exitCode: inspection.exitCode,
-            diagnosis: inspection.diagnosis.stage,
+            diagnosis: inspection.diagnosis?.stage,
             resultStatus: inspection.result.status,
           }),
         );
@@ -4384,7 +4385,7 @@ async function resolveDetachedRunnerOutcome(input: {
             runnerAttempt: suspension.runnerAttempt,
             sandboxId: suspension.sandboxId,
             exitCode: inspection.exitCode,
-            diagnosis: inspection.diagnosis.stage,
+            diagnosis: inspection.diagnosis?.stage,
             resultStatus: inspection.result?.status ?? null,
           }),
         );
@@ -4421,7 +4422,7 @@ async function resolveDetachedRunnerOutcome(input: {
     terminalResultFound: false,
     inspectionAttempted: Boolean(input.inspectDetachedRunner),
     inspectionStage: inspection
-      ? safeDiagnosticLabel(inspection.diagnosis.stage)
+      ? safeDiagnosticLabel(inspection.diagnosis?.stage)
       : inspectionFailed
         ? 'inspection_failed'
         : input.inspectDetachedRunner

package/dist/bundling-sources/shared_libs/play-runtime/tool-cache-policy.ts

@@ -1,6 +1,7 @@
 const ALWAYS_FRESH_INTEGRATION_TOOL_IDS = new Set([
   'google_workspace_request',
   'google_workspace_export_dataset',
+  'google_workspace_update_cells',
   // Unique public operation alias for google_workspace_export_dataset.
   'export_dataset',
 ]);

package/dist/bundling-sources/shared_libs/plays/deploy/run-deployment.ts

@@ -157,6 +157,11 @@ export type PlayDeployOutcome = {
    * the deployment into `succeeded_with_warnings`.
    */
   warning?: string;
+  /**
+   * The new version exists only because a newer Deepline SDK rebuilt the play:
+   * its code and everything it imports match what is live.
+   */
+  sdkUpdated?: true;
   error?: string;
 };
 
@@ -294,6 +299,26 @@ function carriesArtifact(
   );
 }
 
+/**
+ * Same code as what is live, different build output. `sourceHash` covers only
+ * the entry file and `graphHash` covers every local import, package version,
+ * and imported play, so both must match — an edited helper is a real change.
+ */
+export function isSdkUpdated(
+  live: DeploymentPlayState['liveRevision'],
+  artifact: Pick<
+    PlayBundleArtifact,
+    'sourceHash' | 'graphHash' | 'artifactHash'
+  >,
+): boolean {
+  return Boolean(
+    live &&
+    live.sourceHash === artifact.sourceHash &&
+    live.graphHash === artifact.graphHash &&
+    live.artifactHash !== artifact.artifactHash,
+  );
+}
+
 function annotationForFailure(input: {
   file: string;
   message: string;
@@ -978,6 +1003,17 @@ export async function runDeployment(
     }
 
     const playByName = new Map(ordered.map((play) => [play.name, play]));
+    // Against what was live when this build started, so a PR build and the
+    // merge that promotes its revision describe the play the same way.
+    const sdkUpdated = (
+      name: string,
+    ): Pick<PlayDeployOutcome, 'sdkUpdated'> => {
+      const artifact = playByName.get(name)?.result.artifact;
+      const live = stateByName.get(name)?.liveRevision ?? null;
+      return artifact && isSdkUpdated(live, artifact)
+        ? { sdkUpdated: true }
+        : {};
+    };
     const outcomes: PlayDeployOutcome[] = [];
     const toRegister: Array<{
       play: (typeof ordered)[number];
@@ -1068,6 +1104,7 @@ export async function runDeployment(
             file: play.file,
             status: 'registered',
             version: playState?.workingRevision?.version ?? undefined,
+            ...sdkUpdated(play.name),
             ...(warning ? { warning } : {}),
           });
         }
@@ -1115,6 +1152,7 @@ export async function runDeployment(
               typeof artifact.version === 'number'
                 ? artifact.version
                 : undefined,
+            ...sdkUpdated(item.play.name),
             ...(warning ? { warning } : {}),
           });
         }
@@ -1137,7 +1175,7 @@ export async function runDeployment(
         summary: outcomes
           .map(
             (outcome) =>
-              `- \`${outcome.name}\`: ${outcome.status}${outcome.version !== undefined ? ` (v${outcome.version})` : ''}${outcome.warning ? `\n  - :warning: ${outcome.warning}` : ''}`,
+              `- \`${outcome.name}\`: ${outcome.status}${outcome.version !== undefined ? ` (v${outcome.version})` : ''}${outcome.sdkUpdated ? ' — SDK updated' : ''}${outcome.warning ? `\n  - :warning: ${outcome.warning}` : ''}`,
           )
           .join('\n'),
       });
@@ -1180,6 +1218,7 @@ export async function runDeployment(
             previousVersion !== outcome.version
               ? { previousVersion }
               : {}),
+            ...(outcome.status === 'promoted' ? sdkUpdated(outcome.name) : {}),
             ...(outcome.status === 'promoted' && warning ? { warning } : {}),
             ...(outcome.error ? { error: outcome.error } : {}),
           });
@@ -1246,7 +1285,7 @@ export async function runDeployment(
       summary: outcomes
         .map(
           (outcome) =>
-            `- \`${outcome.name}\`: ${outcome.status}${outcome.warning ? `\n  - :warning: ${outcome.warning}` : ''}`,
+            `- \`${outcome.name}\`: ${outcome.status}${outcome.sdkUpdated ? ' — SDK updated' : ''}${outcome.warning ? `\n  - :warning: ${outcome.warning}` : ''}`,
         )
         .join('\n'),
     });

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.205",
+  version: "0.3.207",
   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
@@ -9174,6 +9174,10 @@ var DeeplineClient = class _DeeplineClient {
   async listPlaysPage(options) {
     return this.requestPlaysPage(options);
   }
+  /** Count durable Play runs and Monitor deliveries in local calendar days. */
+  async getPlaysActivity(options = {}) {
+    return this.http.post("/api/v2/plays/activity", options);
+  }
   async requestPlaysPage(options, paginateInventory = true) {
     const params = new URLSearchParams();
     if (paginateInventory && !options?.grep?.trim())
@@ -21532,6 +21536,11 @@ function carriesArtifact(revision, artifact) {
     revision && revision.sourceHash === artifact.sourceHash && revision.artifactHash === artifact.artifactHash && revision.graphHash === artifact.graphHash && revision.artifactKind === artifact.artifactKind
   );
 }
+function isSdkUpdated(live, artifact) {
+  return Boolean(
+    live && live.sourceHash === artifact.sourceHash && live.graphHash === artifact.graphHash && live.artifactHash !== artifact.artifactHash
+  );
+}
 function annotationForFailure(input2) {
   return {
     path: input2.file,
@@ -21966,6 +21975,11 @@ async function runDeployment(params, hooks) {
       });
     }
     const playByName = new Map(ordered.map((play) => [play.name, play]));
+    const sdkUpdated = (name) => {
+      const artifact = playByName.get(name)?.result.artifact;
+      const live = stateByName.get(name)?.liveRevision ?? null;
+      return artifact && isSdkUpdated(live, artifact) ? { sdkUpdated: true } : {};
+    };
     const outcomes = [];
     const toRegister = [];
     const toPromote = [];
@@ -22012,6 +22026,7 @@ async function runDeployment(params, hooks) {
             file: play.file,
             status: "registered",
             version: playState?.workingRevision?.version ?? void 0,
+            ...sdkUpdated(play.name),
             ...warning ? { warning } : {}
           });
         }
@@ -22053,6 +22068,7 @@ async function runDeployment(params, hooks) {
             file: item.play.file,
             status: "registered",
             version: typeof artifact.version === "number" ? artifact.version : void 0,
+            ...sdkUpdated(item.play.name),
             ...warning ? { warning } : {}
           });
         }
@@ -22067,7 +22083,7 @@ async function runDeployment(params, hooks) {
         title: `${ordered.length} play${ordered.length === 1 ? "" : "s"} validated and registered (not deployed)`,
         ...annotations.length > 0 ? { annotations } : {},
         summary: outcomes.map(
-          (outcome) => `- \`${outcome.name}\`: ${outcome.status}${outcome.version !== void 0 ? ` (v${outcome.version})` : ""}${outcome.warning ? `
+          (outcome) => `- \`${outcome.name}\`: ${outcome.status}${outcome.version !== void 0 ? ` (v${outcome.version})` : ""}${outcome.sdkUpdated ? " \u2014 SDK updated" : ""}${outcome.warning ? `
   - :warning: ${outcome.warning}` : ""}`
         ).join("\n")
       });
@@ -22096,6 +22112,7 @@ async function runDeployment(params, hooks) {
             status: outcome.status === "promoted" ? "promoted" : "failed",
             version: outcome.version,
             ...outcome.status === "promoted" && typeof previousVersion === "number" && previousVersion !== outcome.version ? { previousVersion } : {},
+            ...outcome.status === "promoted" ? sdkUpdated(outcome.name) : {},
             ...outcome.status === "promoted" && warning ? { warning } : {},
             ...outcome.error ? { error: outcome.error } : {}
           });
@@ -22142,7 +22159,7 @@ async function runDeployment(params, hooks) {
       title: `Deployed ${outcomes.filter((o) => o.status === "promoted").length} play(s) (${outcomes.filter((o) => o.status === "unchanged").length} unchanged)`,
       ...annotations.length > 0 ? { annotations } : {},
       summary: outcomes.map(
-        (outcome) => `- \`${outcome.name}\`: ${outcome.status}${outcome.warning ? `
+        (outcome) => `- \`${outcome.name}\`: ${outcome.status}${outcome.sdkUpdated ? " \u2014 SDK updated" : ""}${outcome.warning ? `
   - :warning: ${outcome.warning}` : ""}`
       ).join("\n")
     });
@@ -22230,8 +22247,9 @@ function topoSortByPlayDependencies(plays) {
 var MAX_DEPLOY_ATTEMPTS = 3;
 function renderOutcome(outcome) {
   const version = outcome.version === void 0 ? "" : outcome.previousVersion === void 0 ? ` v${outcome.version}` : ` v${outcome.previousVersion} -> v${outcome.version}`;
+  const sdkUpdated = outcome.sdkUpdated ? " (SDK updated)" : "";
   const note = outcome.error ?? outcome.warning;
-  return `${outcome.name} (${outcome.file}): ${outcome.status}${version}${note ? ` - ${note}` : ""}`;
+  return `${outcome.name} (${outcome.file}): ${outcome.status}${version}${sdkUpdated}${note ? ` - ${note}` : ""}`;
 }
 function printResult(input2) {
   const failed = input2.status === "failed" || input2.status === "cancelled";
@@ -22663,8 +22681,9 @@ function renderDeploymentPlayLines(results) {
   return plays.flatMap((play) => {
     const version = play.version === void 0 ? "" : play.previousVersion === void 0 ? ` v${play.version}` : ` v${play.previousVersion} -> v${play.version}`;
     const file = play.file ? ` (${play.file})` : "";
+    const sdkUpdated = play.sdkUpdated ? " (SDK updated)" : "";
     return [
-      `${play.name ?? "?"}${file} - ${play.status ?? "?"}${version}`,
+      `${play.name ?? "?"}${file} - ${play.status ?? "?"}${version}${sdkUpdated}`,
       ...play.error ? [`  error: ${play.error}`] : [],
       ...play.warning ? [`  warning: ${play.warning}`] : []
     ];
@@ -30935,6 +30954,37 @@ Examples:
       ...options.json ? ["--json"] : []
     ]);
   });
+  play.command("activity").description("Count Play runs and delivered Monitor findings by day.").option("--time-zone <iana>", "Calendar timezone (default: UTC)", "UTC").option("--days <count>", "Trailing calendar days, 1\u201345", "30").option("--end-date <yyyy-mm-dd>", "Last local calendar day").option("--group-by <kind>", "kind or trigger_source", "kind").option("--json", "Emit exact counts and coverage as JSON").action(async (options) => {
+    const days = Number(options.days);
+    if (!Number.isSafeInteger(days) || days < 1 || days > 45) {
+      throw new Error("--days must be an integer from 1 to 45.");
+    }
+    if (options.groupBy !== "kind" && options.groupBy !== "trigger_source") {
+      throw new Error("--group-by must be kind or trigger_source.");
+    }
+    const result = await new DeeplineClient().getPlaysActivity({
+      timeZone: options.timeZone,
+      days,
+      ...options.endDate ? { endDate: options.endDate } : {},
+      groupBy: options.groupBy
+    });
+    const lines = [`Plays activity \xB7 ${result.timeZone}`];
+    for (const bucket of result.buckets) {
+      const groups = bucket.groups.map((group) => `${group.group}=${group.count}`).join(" ");
+      const coverage = bucket.complete.playRuns && bucket.complete.monitorDeliveries ? "complete" : "incomplete history";
+      lines.push(
+        `${bucket.key}  ${groups} failed_play_runs=${bucket.failedPlayRuns}  ${coverage}`
+      );
+    }
+    printCommandEnvelope(
+      { ...result },
+      {
+        json: options.json || !process.stdout.isTTY,
+        text: `${lines.join("\n")}
+`
+      }
+    );
+  });
   play.command("pin <target>").description("Pin an org-owned play to the top of play listings.").option("--dry-run", "Print the planned change without saving it").option("--json", "Emit JSON output").action(async (target, options) => {
     process.exitCode = await handlePlayPin(
       [

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.205",
+  version: "0.3.207",
   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
@@ -9169,6 +9169,10 @@ var DeeplineClient = class _DeeplineClient {
   async listPlaysPage(options) {
     return this.requestPlaysPage(options);
   }
+  /** Count durable Play runs and Monitor deliveries in local calendar days. */
+  async getPlaysActivity(options = {}) {
+    return this.http.post("/api/v2/plays/activity", options);
+  }
   async requestPlaysPage(options, paginateInventory = true) {
     const params = new URLSearchParams();
     if (paginateInventory && !options?.grep?.trim())
@@ -21605,6 +21609,11 @@ function carriesArtifact(revision, artifact) {
     revision && revision.sourceHash === artifact.sourceHash && revision.artifactHash === artifact.artifactHash && revision.graphHash === artifact.graphHash && revision.artifactKind === artifact.artifactKind
   );
 }
+function isSdkUpdated(live, artifact) {
+  return Boolean(
+    live && live.sourceHash === artifact.sourceHash && live.graphHash === artifact.graphHash && live.artifactHash !== artifact.artifactHash
+  );
+}
 function annotationForFailure(input2) {
   return {
     path: input2.file,
@@ -22039,6 +22048,11 @@ async function runDeployment(params, hooks) {
       });
     }
     const playByName = new Map(ordered.map((play) => [play.name, play]));
+    const sdkUpdated = (name) => {
+      const artifact = playByName.get(name)?.result.artifact;
+      const live = stateByName.get(name)?.liveRevision ?? null;
+      return artifact && isSdkUpdated(live, artifact) ? { sdkUpdated: true } : {};
+    };
     const outcomes = [];
     const toRegister = [];
     const toPromote = [];
@@ -22085,6 +22099,7 @@ async function runDeployment(params, hooks) {
             file: play.file,
             status: "registered",
             version: playState?.workingRevision?.version ?? void 0,
+            ...sdkUpdated(play.name),
             ...warning ? { warning } : {}
           });
         }
@@ -22126,6 +22141,7 @@ async function runDeployment(params, hooks) {
             file: item.play.file,
             status: "registered",
             version: typeof artifact.version === "number" ? artifact.version : void 0,
+            ...sdkUpdated(item.play.name),
             ...warning ? { warning } : {}
           });
         }
@@ -22140,7 +22156,7 @@ async function runDeployment(params, hooks) {
         title: `${ordered.length} play${ordered.length === 1 ? "" : "s"} validated and registered (not deployed)`,
         ...annotations.length > 0 ? { annotations } : {},
         summary: outcomes.map(
-          (outcome) => `- \`${outcome.name}\`: ${outcome.status}${outcome.version !== void 0 ? ` (v${outcome.version})` : ""}${outcome.warning ? `
+          (outcome) => `- \`${outcome.name}\`: ${outcome.status}${outcome.version !== void 0 ? ` (v${outcome.version})` : ""}${outcome.sdkUpdated ? " \u2014 SDK updated" : ""}${outcome.warning ? `
   - :warning: ${outcome.warning}` : ""}`
         ).join("\n")
       });
@@ -22169,6 +22185,7 @@ async function runDeployment(params, hooks) {
             status: outcome.status === "promoted" ? "promoted" : "failed",
             version: outcome.version,
             ...outcome.status === "promoted" && typeof previousVersion === "number" && previousVersion !== outcome.version ? { previousVersion } : {},
+            ...outcome.status === "promoted" ? sdkUpdated(outcome.name) : {},
             ...outcome.status === "promoted" && warning ? { warning } : {},
             ...outcome.error ? { error: outcome.error } : {}
           });
@@ -22215,7 +22232,7 @@ async function runDeployment(params, hooks) {
       title: `Deployed ${outcomes.filter((o) => o.status === "promoted").length} play(s) (${outcomes.filter((o) => o.status === "unchanged").length} unchanged)`,
       ...annotations.length > 0 ? { annotations } : {},
       summary: outcomes.map(
-        (outcome) => `- \`${outcome.name}\`: ${outcome.status}${outcome.warning ? `
+        (outcome) => `- \`${outcome.name}\`: ${outcome.status}${outcome.sdkUpdated ? " \u2014 SDK updated" : ""}${outcome.warning ? `
   - :warning: ${outcome.warning}` : ""}`
       ).join("\n")
     });
@@ -22303,8 +22320,9 @@ function topoSortByPlayDependencies(plays) {
 var MAX_DEPLOY_ATTEMPTS = 3;
 function renderOutcome(outcome) {
   const version = outcome.version === void 0 ? "" : outcome.previousVersion === void 0 ? ` v${outcome.version}` : ` v${outcome.previousVersion} -> v${outcome.version}`;
+  const sdkUpdated = outcome.sdkUpdated ? " (SDK updated)" : "";
   const note = outcome.error ?? outcome.warning;
-  return `${outcome.name} (${outcome.file}): ${outcome.status}${version}${note ? ` - ${note}` : ""}`;
+  return `${outcome.name} (${outcome.file}): ${outcome.status}${version}${sdkUpdated}${note ? ` - ${note}` : ""}`;
 }
 function printResult(input2) {
   const failed = input2.status === "failed" || input2.status === "cancelled";
@@ -22736,8 +22754,9 @@ function renderDeploymentPlayLines(results) {
   return plays.flatMap((play) => {
     const version = play.version === void 0 ? "" : play.previousVersion === void 0 ? ` v${play.version}` : ` v${play.previousVersion} -> v${play.version}`;
     const file = play.file ? ` (${play.file})` : "";
+    const sdkUpdated = play.sdkUpdated ? " (SDK updated)" : "";
     return [
-      `${play.name ?? "?"}${file} - ${play.status ?? "?"}${version}`,
+      `${play.name ?? "?"}${file} - ${play.status ?? "?"}${version}${sdkUpdated}`,
       ...play.error ? [`  error: ${play.error}`] : [],
       ...play.warning ? [`  warning: ${play.warning}`] : []
     ];
@@ -31008,6 +31027,37 @@ Examples:
       ...options.json ? ["--json"] : []
     ]);
   });
+  play.command("activity").description("Count Play runs and delivered Monitor findings by day.").option("--time-zone <iana>", "Calendar timezone (default: UTC)", "UTC").option("--days <count>", "Trailing calendar days, 1\u201345", "30").option("--end-date <yyyy-mm-dd>", "Last local calendar day").option("--group-by <kind>", "kind or trigger_source", "kind").option("--json", "Emit exact counts and coverage as JSON").action(async (options) => {
+    const days = Number(options.days);
+    if (!Number.isSafeInteger(days) || days < 1 || days > 45) {
+      throw new Error("--days must be an integer from 1 to 45.");
+    }
+    if (options.groupBy !== "kind" && options.groupBy !== "trigger_source") {
+      throw new Error("--group-by must be kind or trigger_source.");
+    }
+    const result = await new DeeplineClient().getPlaysActivity({
+      timeZone: options.timeZone,
+      days,
+      ...options.endDate ? { endDate: options.endDate } : {},
+      groupBy: options.groupBy
+    });
+    const lines = [`Plays activity \xB7 ${result.timeZone}`];
+    for (const bucket of result.buckets) {
+      const groups = bucket.groups.map((group) => `${group.group}=${group.count}`).join(" ");
+      const coverage = bucket.complete.playRuns && bucket.complete.monitorDeliveries ? "complete" : "incomplete history";
+      lines.push(
+        `${bucket.key}  ${groups} failed_play_runs=${bucket.failedPlayRuns}  ${coverage}`
+      );
+    }
+    printCommandEnvelope(
+      { ...result },
+      {
+        json: options.json || !process.stdout.isTTY,
+        text: `${lines.join("\n")}
+`
+      }
+    );
+  });
   play.command("pin <target>").description("Pin an org-owned play to the top of play listings.").option("--dry-run", "Print the planned change without saving it").option("--json", "Emit JSON output").action(async (target, options) => {
     process.exitCode = await handlePlayPin(
       [

package/dist/index.d.mts

@@ -2044,6 +2044,36 @@ interface StopAllPlayRunsDryRunResult {
  */
 type StopAllPlayRunsResult = StopAllPlayRunsStopResult | StopAllPlayRunsDryRunResult;
 declare function isStopAllPlayRunsDryRunResult(result: StopAllPlayRunsResult): result is StopAllPlayRunsDryRunResult;
+/** Bounded daily counts from durable Play runs and Monitor delivery receipts. */
+interface PlaysActivityResponse {
+    timeZone: string;
+    groupBy: 'kind' | 'trigger_source';
+    endDate: string;
+    /** Current-day query cutoff, when the window ends today. */
+    asOfAt?: number;
+    buckets: Array<{
+        key: string;
+        label: string;
+        startAt: number;
+        endAt: number;
+        groups: Array<{
+            group: 'play_run' | 'monitor_delivery' | 'manual' | 'api' | 'cron' | 'webhook' | 'sql_listener' | 'async_child';
+            count: number;
+        }>;
+        failedPlayRuns: number;
+        complete: {
+            playRuns: boolean;
+            monitorDeliveries: boolean;
+        };
+    }>;
+    coverage: {
+        playRunsEarliestCompleteAt: number | null;
+        monitorDeliveriesEarliestCompleteAt: number | null;
+        monitorDeliveriesCompleteThroughAt: number | null;
+        projectionPending: boolean;
+        earliestPendingAt: number | null;
+    };
+}
 /**
  * Summary of a single play run, returned by {@link DeeplineClient.listPlayRuns}.
  */
@@ -5383,6 +5413,13 @@ declare class DeeplineClient {
         limit?: number;
         cursor?: string | null;
     }): Promise<PlaysListPage>;
+    /** Count durable Play runs and Monitor deliveries in local calendar days. */
+    getPlaysActivity(options?: {
+        timeZone?: string;
+        days?: number;
+        endDate?: string;
+        groupBy?: 'kind' | 'trigger_source';
+    }): Promise<PlaysActivityResponse>;
     private requestPlaysPage;
     /** Set whether an org-owned Play sorts before unpinned Plays. */
     setPlayPinned(playName: string, pinned: boolean): Promise<{
@@ -6928,4 +6965,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpReceipt, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CreateNotificationGroupInput, type CreateNotificationGroupResult, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LegacyMonitorStatusFilter, type LiveEventEnvelope, MONITOR_JOB_PHASES, MONITOR_JOB_RECONCILIATION_STATES, MONITOR_JOB_STATES, type MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobPhase, type MonitorJobReconciliationState, type MonitorJobResult, type MonitorJobState, type MonitorJobWaitOptions, type MonitorJobsNamespace, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorState, type MonitorStateFilter, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayAsyncCallOptions, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayCostEstimate, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, type RunLifecycleStatus, RunObserveTransportUnavailableError, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, ToolResultBilling, type ToolSearchOptions, type ToolSearchResult, type WorkspaceCreateResult, type WorkspacesNamespace, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpReceipt, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CreateNotificationGroupInput, type CreateNotificationGroupResult, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LegacyMonitorStatusFilter, type LiveEventEnvelope, MONITOR_JOB_PHASES, MONITOR_JOB_RECONCILIATION_STATES, MONITOR_JOB_STATES, type MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobPhase, type MonitorJobReconciliationState, type MonitorJobResult, type MonitorJobState, type MonitorJobWaitOptions, type MonitorJobsNamespace, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorState, type MonitorStateFilter, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayAsyncCallOptions, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayCostEstimate, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysActivityResponse, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, type RunLifecycleStatus, RunObserveTransportUnavailableError, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, ToolResultBilling, type ToolSearchOptions, type ToolSearchResult, type WorkspaceCreateResult, type WorkspacesNamespace, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };

package/dist/index.d.ts

@@ -2044,6 +2044,36 @@ interface StopAllPlayRunsDryRunResult {
  */
 type StopAllPlayRunsResult = StopAllPlayRunsStopResult | StopAllPlayRunsDryRunResult;
 declare function isStopAllPlayRunsDryRunResult(result: StopAllPlayRunsResult): result is StopAllPlayRunsDryRunResult;
+/** Bounded daily counts from durable Play runs and Monitor delivery receipts. */
+interface PlaysActivityResponse {
+    timeZone: string;
+    groupBy: 'kind' | 'trigger_source';
+    endDate: string;
+    /** Current-day query cutoff, when the window ends today. */
+    asOfAt?: number;
+    buckets: Array<{
+        key: string;
+        label: string;
+        startAt: number;
+        endAt: number;
+        groups: Array<{
+            group: 'play_run' | 'monitor_delivery' | 'manual' | 'api' | 'cron' | 'webhook' | 'sql_listener' | 'async_child';
+            count: number;
+        }>;
+        failedPlayRuns: number;
+        complete: {
+            playRuns: boolean;
+            monitorDeliveries: boolean;
+        };
+    }>;
+    coverage: {
+        playRunsEarliestCompleteAt: number | null;
+        monitorDeliveriesEarliestCompleteAt: number | null;
+        monitorDeliveriesCompleteThroughAt: number | null;
+        projectionPending: boolean;
+        earliestPendingAt: number | null;
+    };
+}
 /**
  * Summary of a single play run, returned by {@link DeeplineClient.listPlayRuns}.
  */
@@ -5383,6 +5413,13 @@ declare class DeeplineClient {
         limit?: number;
         cursor?: string | null;
     }): Promise<PlaysListPage>;
+    /** Count durable Play runs and Monitor deliveries in local calendar days. */
+    getPlaysActivity(options?: {
+        timeZone?: string;
+        days?: number;
+        endDate?: string;
+        groupBy?: 'kind' | 'trigger_source';
+    }): Promise<PlaysActivityResponse>;
     private requestPlaysPage;
     /** Set whether an org-owned Play sorts before unpinned Plays. */
     setPlayPinned(playName: string, pinned: boolean): Promise<{
@@ -6928,4 +6965,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpReceipt, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CreateNotificationGroupInput, type CreateNotificationGroupResult, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LegacyMonitorStatusFilter, type LiveEventEnvelope, MONITOR_JOB_PHASES, MONITOR_JOB_RECONCILIATION_STATES, MONITOR_JOB_STATES, type MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobPhase, type MonitorJobReconciliationState, type MonitorJobResult, type MonitorJobState, type MonitorJobWaitOptions, type MonitorJobsNamespace, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorState, type MonitorStateFilter, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayAsyncCallOptions, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayCostEstimate, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, type RunLifecycleStatus, RunObserveTransportUnavailableError, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, ToolResultBilling, type ToolSearchOptions, type ToolSearchResult, type WorkspaceCreateResult, type WorkspacesNamespace, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpReceipt, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CreateNotificationGroupInput, type CreateNotificationGroupResult, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LegacyMonitorStatusFilter, type LiveEventEnvelope, MONITOR_JOB_PHASES, MONITOR_JOB_RECONCILIATION_STATES, MONITOR_JOB_STATES, type MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobPhase, type MonitorJobReconciliationState, type MonitorJobResult, type MonitorJobState, type MonitorJobWaitOptions, type MonitorJobsNamespace, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorState, type MonitorStateFilter, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayAsyncCallOptions, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayCostEstimate, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysActivityResponse, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, type RunLifecycleStatus, RunObserveTransportUnavailableError, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, ToolResultBilling, type ToolSearchOptions, type ToolSearchResult, type WorkspaceCreateResult, type WorkspacesNamespace, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };

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.205",
+  version: "0.3.207",
   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
@@ -6856,6 +6856,10 @@ var DeeplineClient = class _DeeplineClient {
   async listPlaysPage(options) {
     return this.requestPlaysPage(options);
   }
+  /** Count durable Play runs and Monitor deliveries in local calendar days. */
+  async getPlaysActivity(options = {}) {
+    return this.http.post("/api/v2/plays/activity", options);
+  }
   async requestPlaysPage(options, paginateInventory = true) {
     const params = new URLSearchParams();
     if (paginateInventory && !options?.grep?.trim())

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.205",
+  version: "0.3.207",
   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
@@ -6760,6 +6760,10 @@ var DeeplineClient = class _DeeplineClient {
   async listPlaysPage(options) {
     return this.requestPlaysPage(options);
   }
+  /** Count durable Play runs and Monitor deliveries in local calendar days. */
+  async getPlaysActivity(options = {}) {
+    return this.http.post("/api/v2/plays/activity", options);
+  }
   async requestPlaysPage(options, paginateInventory = true) {
     const params = new URLSearchParams();
     if (paginateInventory && !options?.grep?.trim())

package/dist/release.d.mts

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