deepline 0.3.122 → 0.3.124

package/dist/index.d.ts

@@ -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 };

package/dist/index.js

@@ -87,6 +87,7 @@ __export(src_exports, {
   isPlayBootstrapTemplate: () => isPlayBootstrapTemplate,
   isProviderUnavailable: () => isProviderUnavailable,
   isProviderWaterfallUnavailableError: () => isProviderWaterfallUnavailableError,
+  isStopAllPlayRunsDryRunResult: () => isStopAllPlayRunsDryRunResult,
   lintMonitorBatchInput: () => lintMonitorBatchInput,
   lintMonitorFleetInput: () => lintMonitorFleetInput,
   lintMonitorSpecTemplate: () => lintMonitorSpecTemplate,
@@ -863,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.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
@@ -3894,6 +3895,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;
@@ -4587,7 +4593,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`. */
@@ -4619,10 +4625,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: (input) => this.getPlaySheetRows(input),
       stop: (runId, options2) => this.stopRun(runId, options2),
-      stopAll: (options2) => this.stopAllRuns(options2)
+      stopAll: ((options2) => this.stopAllRuns(options2))
     };
     this.db = {
       query: (input) => this.queryDb(input)
@@ -6138,11 +6144,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() }
     );
   }
   /**
@@ -6287,11 +6310,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
    * ```
    *
@@ -6299,10 +6324,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.
@@ -7481,9 +7518,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 {
@@ -12617,6 +12661,7 @@ function extractSummaryFields(payload) {
   isPlayBootstrapTemplate,
   isProviderUnavailable,
   isProviderWaterfallUnavailableError,
+  isStopAllPlayRunsDryRunResult,
   lintMonitorBatchInput,
   lintMonitorFleetInput,
   lintMonitorSpecTemplate,

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.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
@@ -3799,6 +3799,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;
@@ -4492,7 +4497,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`. */
@@ -4524,10 +4529,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: (input) => this.getPlaySheetRows(input),
       stop: (runId, options2) => this.stopRun(runId, options2),
-      stopAll: (options2) => this.stopAllRuns(options2)
+      stopAll: ((options2) => this.stopAllRuns(options2))
     };
     this.db = {
       query: (input) => this.queryDb(input)
@@ -6043,11 +6048,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() }
     );
   }
   /**
@@ -6192,11 +6214,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
    * ```
    *
@@ -6204,10 +6228,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.
@@ -7386,9 +7422,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 {
@@ -12527,6 +12570,7 @@ export {
   isPlayBootstrapTemplate,
   isProviderUnavailable,
   isProviderWaterfallUnavailableError,
+  isStopAllPlayRunsDryRunResult,
   lintMonitorBatchInput,
   lintMonitorFleetInput,
   lintMonitorSpecTemplate,

package/dist/install-integrity.json

@@ -65,6 +65,7 @@
     "dist/bundling-sources/shared_libs/monitors/provider-monitor-batch-operation.ts",
     "dist/bundling-sources/shared_libs/monitors/provider-monitor-capability.ts",
     "dist/bundling-sources/shared_libs/monitors/provider-monitor-consumer-health.ts",
+    "dist/bundling-sources/shared_libs/monitors/provider-monitor-control-plane-capability.ts",
     "dist/bundling-sources/shared_libs/monitors/provider-monitor-errors.ts",
     "dist/bundling-sources/shared_libs/monitors/provider-monitor-identity-claims.ts",
     "dist/bundling-sources/shared_libs/monitors/provider-monitor-legacy-aliases.ts",

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.122";
+    readonly version: "0.3.124";
     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.122";
+    readonly version: "0.3.124";
     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.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

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.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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.122",
+  "version": "0.3.124",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",