deepline 0.3.122 → 0.3.124

package/dist/cli/index.mjs

@@ -3063,7 +3063,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.122",
+  version: "0.3.124",
   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
@@ -6237,6 +6237,11 @@ async function* observeRunEvents(options) {
   }
 }
 
+// src/types.ts
+function isStopAllPlayRunsDryRunResult(result) {
+  return "dryRun" in result && result.dryRun === true;
+}
+
 // ../integration-contracts/theirstack/execution-policy.ts
 var THEIRSTACK_SLOW_JOB_SEARCH_PROVIDER_TIMEOUT_MS = 135e3;
 var THEIRSTACK_SLOW_JOB_SEARCH_CLIENT_TIMEOUT_MS = 6e4 + THEIRSTACK_SLOW_JOB_SEARCH_PROVIDER_TIMEOUT_MS + 15e3;
@@ -6909,7 +6914,7 @@ function playRunStatusFromState(state) {
     ..."result" in state ? { result: state.result } : {}
   };
 }
-var DeeplineClient = class {
+var DeeplineClient = class _DeeplineClient {
   http;
   config;
   /** Canonical run lifecycle namespace backed by `/api/v2/runs`. */
@@ -6941,10 +6946,10 @@ var DeeplineClient = class {
       tail: (runId, options2) => this.tailRun(runId, options2),
       logs: (runId, options2) => this.getRunLogs(runId, options2),
       input: (runId) => this.getRunInput(runId),
-      rerun: (runId) => this.rerun(runId),
+      rerun: (runId, options2) => this.rerun(runId, options2),
       exportDatasetRows: (input2) => this.getPlaySheetRows(input2),
       stop: (runId, options2) => this.stopRun(runId, options2),
-      stopAll: (options2) => this.stopAllRuns(options2)
+      stopAll: ((options2) => this.stopAllRuns(options2))
     };
     this.db = {
       query: (input2) => this.queryDb(input2)
@@ -8460,11 +8465,28 @@ var DeeplineClient = class {
   async getRunInput(runId) {
     return this.http.get(`/api/v2/runs/${encodeURIComponent(runId)}/input`);
   }
-  /** Start a fresh run from a prior run's retained input and pinned revision. */
-  async rerun(runId) {
+  /**
+   * Start a fresh run from a prior run's retained input and pinned revision.
+   *
+   * Every invocation sends an `Idempotency-Key`. When the caller does not
+   * supply one, a fresh key is generated once per call so the transport's own
+   * network retries converge on a single rerun. Pass the same explicit key
+   * across separate invocations to repeat an ambiguous result safely; a
+   * different key intentionally starts another rerun.
+   */
+  async rerun(runId, options) {
+    const idempotencyKey = options?.idempotencyKey?.trim();
+    if (options?.idempotencyKey !== void 0 && !idempotencyKey) {
+      throw new DeeplineError(
+        "runs.rerun idempotencyKey must not be empty.",
+        void 0,
+        "INVALID_IDEMPOTENCY_KEY"
+      );
+    }
     return this.http.post(
       `/api/v2/runs/${encodeURIComponent(runId)}/rerun`,
-      {}
+      {},
+      { "Idempotency-Key": idempotencyKey || globalThis.crypto.randomUUID() }
     );
   }
   /**
@@ -8609,11 +8631,13 @@ var DeeplineClient = class {
     );
   }
   /**
-   * Stop every active run visible to the current workspace.
+   * Stop every active run visible to the current workspace, or with
+   * `dryRun: true` enumerate the exact candidates without cancelling anything.
    *
    * This is the SDK equivalent of:
    *
    * ```bash
+   * deepline runs stop-all --dry-run --json
    * deepline runs stop-all --reason "stale lock" --json
    * ```
    *
@@ -8621,10 +8645,22 @@ var DeeplineClient = class {
    * need to clear the workspace run-slot state without knowing each run id.
    */
   async stopAllRuns(options) {
-    return this.http.post(
+    const dryRun = options?.dryRun === true;
+    const result = await this.http.post(
       "/api/v2/runs/stop-all",
-      options?.reason ? { reason: options.reason } : {}
+      {
+        ...options?.reason ? { reason: options.reason } : {},
+        ...dryRun ? { dryRun: true } : {}
+      }
     );
+    if (dryRun && !isStopAllPlayRunsDryRunResult(result)) {
+      throw new DeeplineError(
+        "This Deepline server does not support runs stop-all --dry-run and performed a real stop-all. Update the server before using --dry-run.",
+        void 0,
+        "STOP_ALL_DRY_RUN_UNSUPPORTED"
+      );
+    }
+    return result;
   }
   /**
    * List one page of callable plays; grep retains exhaustive matching results.
@@ -9803,9 +9839,16 @@ var DeeplineClient = class {
   // ——————————————————————————————————————————————————————————
   // Monitor Jobs, Batches, and Fleets
   // ——————————————————————————————————————————————————————————
+  static MONITOR_JOB_IDEMPOTENCY_KEY_MAX_LENGTH = 96;
   monitorJobIdempotencyKey(operation) {
-    const uuid = globalThis.crypto?.randomUUID?.();
-    return `monitor-job-${operation}-${uuid ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`}`;
+    const uuid = globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    const prefix = "monitor-job-";
+    const safeOperation = operation.replace(/[^A-Za-z0-9._-]/g, "-");
+    const maxOperationLength = Math.max(
+      0,
+      _DeeplineClient.MONITOR_JOB_IDEMPOTENCY_KEY_MAX_LENGTH - prefix.length - uuid.length - 1
+    );
+    return `${prefix}${safeOperation.slice(0, maxOperationLength)}-${uuid}`;
   }
   monitorJobHeaders(operation, idempotencyKey) {
     return {
@@ -24513,6 +24556,77 @@ function authoredPackageStackFrames(packaged) {
     (line) => !line.includes("/virtual/deepline-plays/") && !line.includes("/apps/play-runner/") && !line.includes("/shared_libs/play-runtime/") && !line.includes("node:internal")
   ).slice(0, 5);
 }
+function activityTargetLabel(target) {
+  const kind = typeof target.kind === "string" ? target.kind : "target";
+  const label = typeof target.label === "string" ? target.label.trim() : "";
+  if (label) return `${kind} ${label}`;
+  switch (kind) {
+    case "provider":
+      return `provider ${String(target.provider ?? "?")} ${String(target.operation ?? "?")}`;
+    case "dataset":
+      return `dataset ${String(target.tableNamespace ?? "?")} (${String(target.operation ?? "?")})`;
+    case "lease":
+      return `${String(target.resourceKind ?? "resource")} lease ${String(target.resourceLabel ?? "?")}`;
+    case "runner":
+      return `runner ${String(target.backend ?? "?")}`;
+    case "step":
+      return `step ${String(target.stepId ?? "?")}`;
+    case "capacity":
+      return `${String(target.pool ?? "?")} capacity`;
+    default:
+      return kind;
+  }
+}
+function activityIsoTimestamp(value) {
+  return typeof value === "number" || typeof value === "string" ? isoTimestamp(value) : null;
+}
+function buildRunActivityTextLines(run) {
+  const activity = readRecord(run.activity);
+  const observation = readRecord(activity?.observation);
+  const state = readRecord(observation?.state);
+  const target = readRecord(observation?.target);
+  if (!activity || !observation || !state) return [];
+  const kind = typeof state.kind === "string" ? state.kind : "unknown";
+  if (kind === "completed") return [];
+  const summary = typeof activity.summary === "string" && activity.summary.trim() ? activity.summary.trim() : null;
+  const unclassified = activity.classified === false;
+  const lines = [];
+  lines.push(
+    `  activity: ${kind}${summary ? ` \u2014 ${summary}` : ""}${unclassified ? " (unclassified evidence; may be stale)" : ""}`
+  );
+  if (target) lines.push(`  target: ${activityTargetLabel(target)}`);
+  if (typeof observation.stepId === "string" && observation.stepId.trim()) {
+    lines.push(`  step: ${observation.stepId.trim()}`);
+  }
+  const reason = readRecord(state.reason);
+  if (kind === "retrying") {
+    const attempt = typeof state.attempt === "number" ? ` (attempt ${state.attempt})` : "";
+    const why = typeof state.reason === "string" ? ` after ${state.reason}` : "";
+    lines.push(
+      `  next retry: ${activityIsoTimestamp(state.retryAt) ?? "unknown"}${why}${attempt}`
+    );
+  } else if (kind === "scheduled") {
+    lines.push(
+      `  resumes: ${activityIsoTimestamp(state.resumeAt) ?? "unknown"}`
+    );
+  } else if (kind === "waiting" && reason) {
+    if (reason.kind === "external_event") {
+      const deadline = activityIsoTimestamp(reason.deadlineAt);
+      if (deadline) lines.push(`  deadline: ${deadline}`);
+      if (typeof reason.eventKey === "string" && reason.eventKey.trim()) {
+        lines.push(`  event key: ${reason.eventKey.trim()}`);
+      }
+    } else if (reason.kind === "lease") {
+      const expires = activityIsoTimestamp(reason.expiresAt);
+      if (expires) lines.push(`  lease expires: ${expires}`);
+    } else if (reason.kind === "unknown") {
+      lines.push("  wait reason: unknown (legacy producer)");
+    }
+  }
+  const observedAt = activityIsoTimestamp(observation.observedAt);
+  if (observedAt) lines.push(`  observed: ${observedAt}`);
+  return lines;
+}
 function buildRunPackageTextLines(packaged) {
   const run = readRunPackageRun(packaged);
   const runId = typeof run.id === "string" ? run.id : "unknown";
@@ -24563,6 +24677,7 @@ function buildRunPackageTextLines(packaged) {
   if (playName) {
     lines.push(`  play: ${playName}`);
   }
+  lines.push(...buildRunActivityTextLines(run));
   lines.push(...formatPackageValueOutputLines(packaged));
   lines.push(...formatPackageDatasetActionLines(packaged));
   const next = packaged.next && typeof packaged.next === "object" && !Array.isArray(packaged.next) ? packaged.next : {};
@@ -24706,6 +24821,11 @@ function writePlayResult(status, jsonOutput, options) {
     const displayError = formatPlayErrorForDisplay(status, progressError) ?? progressError;
     lines.push(`  error: ${truncateErrorForDisplay(displayError, runId)}`);
   }
+  lines.push(
+    ...buildRunActivityTextLines(
+      readRecord(status.run) ?? {}
+    )
+  );
   if (status.status === "failed") {
     const failedLogEntries = status.failedLogs?.entries ?? [];
     if (failedLogEntries.length > 0) {
@@ -26876,7 +26996,7 @@ function parseRunIdPositional(args, usage) {
       continue;
     }
     if (arg.startsWith("--log-level=")) continue;
-    if ((arg === "--out" || arg === "--reason" || arg === "--dataset") && args[index + 1]) {
+    if ((arg === "--out" || arg === "--reason" || arg === "--dataset" || arg === "--idempotency-key") && args[index + 1]) {
       index += 1;
       continue;
     }
@@ -26911,7 +27031,7 @@ async function handleRunGet(args) {
   return 0;
 }
 async function handleRunsRerun(args) {
-  const usage = "Usage: deepline runs rerun <run-id> [--json]";
+  const usage = "Usage: deepline runs rerun <run-id> [--idempotency-key <key>] [--json]";
   let runId;
   try {
     runId = parseRunIdPositional(args, usage);
@@ -26919,16 +27039,33 @@ async function handleRunsRerun(args) {
     console.error(error instanceof Error ? error.message : usage);
     return 1;
   }
-  const result = await new DeeplineClient().runs.rerun(runId);
+  let idempotencyKey;
+  for (let index = 0; index < args.length; index += 1) {
+    if (args[index] === "--idempotency-key") {
+      const value = args[index + 1];
+      if (!value || value.startsWith("--") || !value.trim()) {
+        console.error("--idempotency-key requires a non-empty value.");
+        return 1;
+      }
+      idempotencyKey = value.trim();
+      index += 1;
+    }
+  }
+  const result = await new DeeplineClient().runs.rerun(runId, {
+    ...idempotencyKey ? { idempotencyKey } : {}
+  });
   if (argsWantJson(args)) {
     printCommandEnvelope(result, { json: true });
   } else {
-    console.log(`
-Rerun started from ${runId}.`);
+    console.log(
+      result.deduplicated === true ? `
+Rerun already exists for ${runId} (matched by idempotency key): ${result.runId}` : `
+Rerun started from ${runId}.`
+    );
     console.log(`  inspect: deepline runs get ${result.runId} --json`);
     console.log(`  original input: deepline runs get ${result.runId} --input`);
     console.log(
-      "  This is a fresh run using the original input and pinned revision. Normal tool receipt reuse still applies."
+      result.deduplicated === true ? "  No new run was started. Use a different --idempotency-key to start another rerun." : "  This is a fresh run using the original input and pinned revision. Normal tool receipt reuse still applies."
     );
   }
   return 0;
@@ -27406,8 +27543,46 @@ async function handleRunStop(args) {
   );
   return 0;
 }
+function padColumn(value, width) {
+  return value.length >= width ? value : value + " ".repeat(width - value.length);
+}
+function buildStopAllDryRunTextLines(result) {
+  const count = result.candidateCount;
+  const lines = [
+    `Dry run: ${count} active run${count === 1 ? "" : "s"} would be stopped`,
+    `Scope: ${result.scope}`,
+    `Includes child runs: ${result.includesChildren ? "yes" : "no"}`
+  ];
+  if (result.runs.length > 0) {
+    const rows = result.runs.map((run) => [
+      run.runId,
+      run.playName ?? "\u2014",
+      run.status ?? "\u2014"
+    ]);
+    const header = ["RUN_ID", "PLAY", "STATUS"];
+    const widths = header.map(
+      (label, column) => Math.max(label.length, ...rows.map((row) => row[column].length))
+    );
+    lines.push("");
+    for (const row of [header, ...rows]) {
+      lines.push(
+        row.map(
+          (cell, column) => column === row.length - 1 ? cell : padColumn(cell, widths[column])
+        ).join("  ")
+      );
+    }
+  }
+  if (result.truncated) {
+    lines.push("");
+    lines.push(
+      `Showing the first ${result.runs.length} matching runs. Results are truncated; no runs were stopped.`
+    );
+  }
+  return lines;
+}
 async function handleRunStopAll(args) {
   let reason;
+  const dryRun = args.includes("--dry-run");
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
     if (arg === "--reason" && args[index + 1]) {
@@ -27415,6 +27590,21 @@ async function handleRunStopAll(args) {
     }
   }
   const client2 = new DeeplineClient();
+  if (dryRun) {
+    const result2 = await client2.runs.stopAll({ dryRun: true, reason });
+    const lines2 = buildStopAllDryRunTextLines(result2);
+    printCommandEnvelope(
+      {
+        ...result2,
+        render: {
+          sections: [{ title: "workspace stop-all (dry run)", lines: lines2 }]
+        }
+      },
+      { json: argsWantJson(args), text: `${lines2.join("\n")}
+` }
+    );
+    return 0;
+  }
   const result = await client2.runs.stopAll({ reason });
   const lines = [
     `Stopped ${result.stopped} active run${result.stopped === 1 ? "" : "s"}`,
@@ -29183,13 +29373,23 @@ Notes:
   The rerun uses the original input and exact saved revision. Normal completed
   tool receipts may be reused; inspect the new run before forcing any external
   side effect.
+  Every call sends an Idempotency-Key. Pass --idempotency-key to reuse the
+  same key across separate invocations (for example after an ambiguous or
+  lost response): the same source run and key always resolve to the same
+  rerun, and the JSON result reports deduplicated: true when nothing new was
+  started. A different key intentionally starts another rerun.
 
 Examples:
   deepline runs rerun play/my-play/webhook/abc --json
+  deepline runs rerun play/my-play/webhook/abc --idempotency-key incident-42 --json
 `
+  ).option(
+    "--idempotency-key <key>",
+    "Reuse this key so repeated calls resolve to one rerun"
   ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (runId, options) => {
     process.exitCode = await handleRunsRerun([
       runId,
+      ...options.idempotencyKey ? ["--idempotency-key", options.idempotencyKey] : [],
       ...options.json ? ["--json"] : []
     ]);
   });
@@ -29220,14 +29420,24 @@ Examples:
     `
 Notes:
   Stops all active runs visible to this workspace, including child runs created by ctx.runPlay.
+  --dry-run lists the exact candidates (same scope, statuses, and order) and
+  never cancels or mutates anything. A real stop-all exits nonzero when any
+  cancellation failed or the candidate list was truncated; failed runs stay
+  active and are reported truthfully.
 
 Examples:
+  deepline runs stop-all --dry-run
+  deepline runs stop-all --dry-run --json
   deepline runs stop-all --reason "unjam workspace"
   deepline runs stop-all --json
 `
-  ).option("--reason <text>", "Reason to include with each stop request").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (options) => {
+  ).option("--reason <text>", "Reason to include with each stop request").option(
+    "--dry-run",
+    "List the runs that would be stopped without cancelling anything"
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (options) => {
     process.exitCode = await handleRunStopAll([
       ...options.reason ? ["--reason", options.reason] : [],
+      ...options.dryRun ? ["--dry-run"] : [],
       ...options.json ? ["--json"] : []
     ]);
   });

package/dist/index.d.mts

@@ -1899,15 +1899,80 @@ interface StopPlayRunResult {
     /** Server-side error detail when the stop was not confirmed. */
     error?: string;
 }
-interface StopAllPlayRunsResult {
+/**
+ * Result of an actual workspace stop-all. `stopped` counts only runs whose
+ * scheduler cancellation was confirmed; a run whose cancel failed stays active
+ * and is counted in `failed`.
+ */
+interface StopAllPlayRunsStopResult {
     stopped: number;
     failed: number;
     skipped: number;
+    /** True when the bounded candidate query may have left active runs behind. */
     partial?: boolean;
     runs: Array<StopPlayRunResult & {
         status?: string | null;
     }>;
 }
+/** Options for {@link DeeplineClient.rerun} / `runs.rerun`. */
+interface RerunOptions {
+    /**
+     * Caller-chosen key sent as `Idempotency-Key`. The same source run and key
+     * always resolve to the same rerun; omit it to let the SDK generate one key
+     * per invocation.
+     */
+    idempotencyKey?: string;
+}
+/** Result of {@link DeeplineClient.rerun} / `runs.rerun`. */
+interface RerunPlayRunResult {
+    /** The rerun's public play-run id. */
+    runId: string;
+    /** The source run whose retained input and revision were replayed. */
+    replayedFromRunId: string;
+    revisionId: string | null;
+    status: string;
+    /**
+     * True when the server returned an already-admitted rerun for this source
+     * run and idempotency key instead of starting another. Absent on older
+     * servers.
+     */
+    deduplicated?: boolean;
+    next: {
+        inspect: string;
+        input: string;
+    };
+}
+/** One active run that a workspace stop-all would target. */
+interface StopAllCandidate {
+    /** Public play-run id. */
+    runId: string;
+    /** Saved play name for the run, when known. */
+    playName: string | null;
+    /** Current durable status (`running`, `queued`, or `waiting`). */
+    status: string | null;
+    /** Parent play-run id when this is a child run; null for root runs. */
+    parentRunId: string | null;
+}
+/**
+ * Result of `runs.stopAll({ dryRun: true })`. Nothing was cancelled or
+ * mutated; the list is the exact candidate set the real stop-all would target,
+ * in the same parent-before-child order.
+ */
+interface StopAllPlayRunsDryRunResult {
+    dryRun: true;
+    scope: 'workspace';
+    includesChildren: true;
+    candidateCount: number;
+    /** True when the bounded query hit its limit and more active runs may exist. */
+    truncated: boolean;
+    runs: StopAllCandidate[];
+}
+/**
+ * Discriminated result of {@link DeeplineClient.stopAllRuns}: narrow on
+ * `'dryRun' in result` to distinguish an enumeration from an actual stop.
+ */
+type StopAllPlayRunsResult = StopAllPlayRunsStopResult | StopAllPlayRunsDryRunResult;
+declare function isStopAllPlayRunsDryRunResult(result: StopAllPlayRunsResult): result is StopAllPlayRunsDryRunResult;
 /**
  * Summary of a single play run, returned by {@link DeeplineClient.listPlayRuns}.
  */
@@ -3191,16 +3256,7 @@ type RunsNamespace = {
         replayedFromRunId: string | null;
     }>;
     /** Start a fresh run from a prior run's retained input and pinned revision. */
-    rerun: (runId: string) => Promise<{
-        runId: string;
-        replayedFromRunId: string;
-        revisionId: string | null;
-        status: string;
-        next: {
-            inspect: string;
-            input: string;
-        };
-    }>;
+    rerun: (runId: string, options?: RerunOptions) => Promise<RerunPlayRunResult>;
     /** List runs for one play, optionally filtered by status. */
     list: (options: RunsListOptions) => Promise<PlayRunListItem[]>;
     /** Read one run page with total, offset, limit and completeness metadata. */
@@ -3222,10 +3278,26 @@ type RunsNamespace = {
     stop: (runId: string, options?: {
         reason?: string;
     }) => Promise<StopPlayRunResult>;
-    /** Stop active runs across the current workspace. */
-    stopAll: (options?: {
-        reason?: string;
-    }) => Promise<StopAllPlayRunsResult>;
+    /**
+     * Stop active runs across the current workspace, or with `dryRun: true`
+     * enumerate the exact candidates without cancelling anything.
+     */
+    stopAll: {
+        (options: StopAllRunsOptions & {
+            dryRun: true;
+        }): Promise<StopAllPlayRunsDryRunResult>;
+        (options?: StopAllRunsOptions & {
+            dryRun?: false;
+        }): Promise<StopAllPlayRunsStopResult>;
+        (options?: StopAllRunsOptions): Promise<StopAllPlayRunsResult>;
+    };
+};
+/** Options for {@link RunsNamespace.stopAll} / {@link DeeplineClient.stopAllRuns}. */
+type StopAllRunsOptions = {
+    /** Enumerate the candidate runs without cancelling or mutating anything. */
+    dryRun?: boolean;
+    /** Reason recorded with each stop request. Ignored by a dry run. */
+    reason?: string;
 };
 /** Current mutable customer database namespace exposed as `client.db`. */
 type DbNamespace = {
@@ -4875,17 +4947,16 @@ declare class DeeplineClient {
         sha256: string | null;
         replayedFromRunId: string | null;
     }>;
-    /** Start a fresh run from a prior run's retained input and pinned revision. */
-    rerun(runId: string): Promise<{
-        runId: string;
-        replayedFromRunId: string;
-        revisionId: string | null;
-        status: string;
-        next: {
-            inspect: string;
-            input: string;
-        };
-    }>;
+    /**
+     * Start a fresh run from a prior run's retained input and pinned revision.
+     *
+     * Every invocation sends an `Idempotency-Key`. When the caller does not
+     * supply one, a fresh key is generated once per call so the transport's own
+     * network retries converge on a single rerun. Pass the same explicit key
+     * across separate invocations to repeat an ambiguous result safely; a
+     * different key intentionally starts another rerun.
+     */
+    rerun(runId: string, options?: RerunOptions): Promise<RerunPlayRunResult>;
     /**
      * Fetch persisted logs for a run using the public runs resource model.
      *
@@ -4922,21 +4993,16 @@ declare class DeeplineClient {
     stopRun(runId: string, options?: {
         reason?: string;
     }): Promise<StopPlayRunResult>;
-    /**
-     * Stop every active run visible to the current workspace.
-     *
-     * This is the SDK equivalent of:
-     *
-     * ```bash
-     * deepline runs stop-all --reason "stale lock" --json
-     * ```
-     *
-     * Use this when a failed parent run left child or waiting runs active and you
-     * need to clear the workspace run-slot state without knowing each run id.
-     */
-    stopAllRuns(options?: {
-        reason?: string;
-    }): Promise<StopAllPlayRunsResult>;
+    /** Enumerate the runs a stop-all would target without cancelling any. */
+    stopAllRuns(options: StopAllRunsOptions & {
+        dryRun: true;
+    }): Promise<StopAllPlayRunsDryRunResult>;
+    /** Stop every active run visible to the current workspace. */
+    stopAllRuns(options?: StopAllRunsOptions & {
+        dryRun?: false;
+    }): Promise<StopAllPlayRunsStopResult>;
+    /** Stop, or with `dryRun: true` only enumerate, active workspace runs. */
+    stopAllRuns(options?: StopAllRunsOptions): Promise<StopAllPlayRunsResult>;
     /**
      * List one page of callable plays; grep retains exhaustive matching results.
      * Use listPlaysPage to retain pagination metadata.
@@ -5398,6 +5464,7 @@ declare class DeeplineClient {
     reactivateMonitor(key: string, options?: {
         dryRun?: boolean;
     }): Promise<MonitorReactivateResult>;
+    private static readonly MONITOR_JOB_IDEMPOTENCY_KEY_MAX_LENGTH;
     private monitorJobIdempotencyKey;
     private monitorJobHeaders;
     deployMonitorBatch(definitions: MonitorDefinition[], options?: MonitorJobDeployOptions): Promise<MonitorJobResult>;
@@ -6447,4 +6514,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 BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, 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 DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, 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 ResolvedConfig, 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 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, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, 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 DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, 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, 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 };