deepline 0.1.122 → 0.1.123

package/dist/bundling-sources/apps/play-runner-workers/src/coordinator-entry.ts

@@ -1655,6 +1655,8 @@ async function registerInlineChildRunWithRuntime(input: {
       action: 'start_inline_child_run',
       playName: input.childPlayName,
       runId: input.childRunId,
+      parentRunId: input.governance.parentRunId,
+      rootRunId: input.governance.rootRunId,
       workflowFamilyKey:
         input.governance.rootRunId ??
         input.governance.parentRunId ??
@@ -1762,6 +1764,7 @@ async function prepareInlineChildRunWithRuntime(input: {
     body: {
       action: 'prepare_inline_child_run',
       parentRunId: input.parentRunId,
+      rootRunId: input.governance.rootRunId,
       parentPlayName: input.parentPlayName,
       childRunId: input.childRunId,
       childPlayName: input.childPlayName,

package/dist/bundling-sources/apps/play-runner-workers/src/entry.ts

@@ -5567,6 +5567,8 @@ async function registerInlineChildRun(req: RunRequest): Promise<void> {
     action: 'start_inline_child_run',
     playName: req.playName,
     runId: req.runId,
+    parentRunId: governance?.parentRunId,
+    rootRunId: governance?.rootRunId,
     workflowFamilyKey:
       governance?.rootRunId ?? governance?.parentRunId ?? req.runId,
     artifactStorageKey:

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

@@ -60,6 +60,7 @@ import type {
   PlayListItem,
   PlayDescription,
   StopPlayRunResult,
+  StopAllPlayRunsResult,
   ClearPlayHistoryRequest,
   ClearPlayHistoryResult,
   PublishPlayVersionRequest,
@@ -186,8 +187,9 @@ export type ToolExecution<TData = unknown, TMeta = Record<string, unknown>> = {
 
 /** Filters for `client.runs.list(...)`. */
 export type RunsListOptions = {
-  play: string;
+  play?: string;
   status?: string;
+  limit?: number;
 };
 
 /** Streaming options for `client.runs.tail(...)`. */
@@ -323,6 +325,8 @@ export type RunsNamespace = {
     runId: string,
     options?: { reason?: string },
   ) => Promise<StopPlayRunResult>;
+  /** Stop active runs across the current workspace. */
+  stopAll: (options?: { reason?: string }) => Promise<StopAllPlayRunsResult>;
 };
 
 /** One credit grant pool reported by the billing subscription status endpoint. */
@@ -822,6 +826,7 @@ export class DeeplineClient {
       logs: (runId, options) => this.getRunLogs(runId, options),
       exportDatasetRows: (input) => this.getPlaySheetRows(input),
       stop: (runId, options) => this.stopRun(runId, options),
+      stopAll: (options) => this.stopAllRuns(options),
     };
     this.billing = {
       plans: () => this.getBillingPlans(),
@@ -2034,15 +2039,21 @@ export class DeeplineClient {
    * ```
    */
   async listRuns(options: RunsListOptions): Promise<PlayRunListItem[]> {
-    const playName = options.play.trim();
-    if (!playName) {
-      throw new Error('runs.list requires options.play.');
+    const playName = options.play?.trim();
+    const params = new URLSearchParams();
+    if (playName) {
+      params.set('play', playName);
     }
-    const params = new URLSearchParams({ play: playName });
     const status = options.status?.trim();
     if (status) {
       params.set('status', status);
     }
+    if (typeof options.limit === 'number' && Number.isFinite(options.limit)) {
+      params.set('limit', String(Math.max(1, Math.floor(options.limit))));
+    }
+    if (!playName && !status) {
+      throw new Error('runs.list requires options.play or options.status.');
+    }
     params.set('compact', 'true');
     const response = await this.http.get<{ runs: PlayRunListItem[] }>(
       `/api/v2/runs?${params.toString()}`,
@@ -2415,6 +2426,27 @@ export class DeeplineClient {
     );
   }
 
+  /**
+   * 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.
+   */
+  async stopAllRuns(options?: {
+    reason?: string;
+  }): Promise<StopAllPlayRunsResult> {
+    return this.http.post<StopAllPlayRunsResult>(
+      '/api/v2/runs/stop-all',
+      options?.reason ? { reason: options.reason } : {},
+    );
+  }
+
   /**
    * List callable plays visible to the workspace.
    *

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

@@ -99,10 +99,10 @@ export const SDK_RELEASE = {
   // skill on the sdk sync surface, and the people-search-to-email prebuilt.
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
-  version: '0.1.122',
+  version: '0.1.123',
   apiContract: '2026-06-dataset-column-cell-stale-hard-cutover',
   supportPolicy: {
-    latest: '0.1.122',
+    latest: '0.1.123',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

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

@@ -557,22 +557,40 @@ export interface StopPlayRunResult {
   error?: string;
 }
 
+export interface StopAllPlayRunsResult {
+  stopped: number;
+  failed: number;
+  skipped: number;
+  partial?: boolean;
+  runs: Array<StopPlayRunResult & { status?: string | null }>;
+}
+
 /**
  * Summary of a single play run, returned by {@link DeeplineClient.listPlayRuns}.
  */
 export interface PlayRunListItem {
   /** Public Deepline play-run id. */
   workflowId: string;
+  /** Saved play name for this run, when available. */
+  playName?: string | null;
   /** Backend run attempt id, when exposed. */
   runId: string;
+  /** Parent play-run id when this run was launched through ctx.runPlay. */
+  parentRunId?: string | null;
+  /** Root play-run id for nested ctx.runPlay descendants. */
+  rootRunId?: string | null;
   /** Workflow type (typically `'Workflow'`). */
   type: string;
   /** Human-readable status (e.g. `'Completed'`, `'Failed'`). */
   status: string;
   /** ISO 8601 timestamp when the run started. */
-  startTime: string | null;
+  startTime?: string | null;
+  /** Unix epoch milliseconds when the run started, returned by normalized V2 run summaries. */
+  startedAt?: number | string | null;
   /** ISO 8601 timestamp when the run finished. */
-  closeTime: string | null;
+  closeTime?: string | null;
+  /** Unix epoch milliseconds when the run finished, returned by normalized V2 run summaries. */
+  finishedAt?: number | string | null;
   /** Duration string (e.g. `'2.5s'`). */
   executionTime: string | null;
   /** Total Deepline credits charged for the run, when available. */

package/dist/bundling-sources/shared_libs/play-runtime/app-runtime-api.ts

@@ -101,6 +101,8 @@ type RuntimeApiRequest =
       action: 'start_inline_child_run';
       playName: string;
       runId: string;
+      parentRunId?: string | null;
+      rootRunId?: string | null;
       workflowFamilyKey?: string | null;
       artifactStorageKey?: string | null;
       artifactHash?: string | null;
@@ -678,6 +680,8 @@ export async function startRunViaAppRuntime(
   input: {
     playName: string;
     runId: string;
+    parentRunId?: string | null;
+    rootRunId?: string | null;
     workflowFamilyKey?: string | null;
     artifactStorageKey?: string | null;
     artifactHash?: string | null;

package/dist/cli/index.js

@@ -403,10 +403,10 @@ var SDK_RELEASE = {
   // skill on the sdk sync surface, and the people-search-to-email prebuilt.
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
-  version: "0.1.122",
+  version: "0.1.123",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.122",
+    latest: "0.1.123",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -2020,7 +2020,8 @@ var DeeplineClient = class {
       tail: (runId, options2) => this.tailRun(runId, options2),
       logs: (runId, options2) => this.getRunLogs(runId, options2),
       exportDatasetRows: (input2) => this.getPlaySheetRows(input2),
-      stop: (runId, options2) => this.stopRun(runId, options2)
+      stop: (runId, options2) => this.stopRun(runId, options2),
+      stopAll: (options2) => this.stopAllRuns(options2)
     };
     this.billing = {
       plans: () => this.getBillingPlans(),
@@ -2884,15 +2885,21 @@ var DeeplineClient = class {
    * ```
    */
   async listRuns(options) {
-    const playName = options.play.trim();
-    if (!playName) {
-      throw new Error("runs.list requires options.play.");
+    const playName = options.play?.trim();
+    const params = new URLSearchParams();
+    if (playName) {
+      params.set("play", playName);
     }
-    const params = new URLSearchParams({ play: playName });
     const status = options.status?.trim();
     if (status) {
       params.set("status", status);
     }
+    if (typeof options.limit === "number" && Number.isFinite(options.limit)) {
+      params.set("limit", String(Math.max(1, Math.floor(options.limit))));
+    }
+    if (!playName && !status) {
+      throw new Error("runs.list requires options.play or options.status.");
+    }
     params.set("compact", "true");
     const response = await this.http.get(
       `/api/v2/runs?${params.toString()}`
@@ -3199,6 +3206,24 @@ var DeeplineClient = class {
       options?.reason ? { reason: options.reason } : {}
     );
   }
+  /**
+   * 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.
+   */
+  async stopAllRuns(options) {
+    return this.http.post(
+      "/api/v2/runs/stop-all",
+      options?.reason ? { reason: options.reason } : {}
+    );
+  }
   /**
    * List callable plays visible to the workspace.
    *
@@ -12675,7 +12700,7 @@ async function handleRunGet(args) {
   return 0;
 }
 async function handleRunsList(args) {
-  const usage = "Usage: deepline runs list --play <play-name> [--status <status>] [--json]";
+  const usage = "Usage: deepline runs list [--play <play-name>] [--status <status>] [--json]";
   let playName = null;
   let statusFilter = null;
   for (let index = 0; index < args.length; index += 1) {
@@ -12692,28 +12717,32 @@ async function handleRunsList(args) {
       continue;
     }
   }
-  if (!playName) {
+  if (!playName && !statusFilter) {
     console.error(usage);
     return 1;
   }
   const client2 = new DeeplineClient();
   const runs = (await client2.runs.list({
-    play: playName,
+    ...playName ? { play: playName } : {},
     ...statusFilter ? { status: statusFilter } : {}
   })).map((run) => ({
     runId: run.workflowId,
     workflowId: run.workflowId,
     temporalRunId: run.runId,
+    parentRunId: run.parentRunId ?? null,
+    rootRunId: run.rootRunId ?? null,
     status: String(run.status ?? "").toLowerCase(),
-    startedAt: run.startTime,
-    finishedAt: run.closeTime,
+    startedAt: run.startTime ?? run.startedAt ?? null,
+    finishedAt: run.closeTime ?? run.finishedAt ?? null,
     executionTime: run.executionTime,
     billingTotalCredits: run.billingTotalCredits,
     billingMaxCreditsPerRun: run.billingMaxCreditsPerRun,
-    playName: run.memo?.playName ?? playName
+    playName: run.playName ?? run.memo?.playName ?? playName ?? null
   }));
-  const lines = runs.length === 0 ? [`No runs found for ${playName}.`] : runs.map(
-    (run) => `${run.runId} ${run.status} ${formatTimestamp(run.startedAt)} ${typeof run.billingTotalCredits === "number" && Number.isFinite(run.billingTotalCredits) ? `${formatCreditAmount(run.billingTotalCredits)} credits` : "\u2014"}`
+  const lines = runs.length === 0 ? [
+    playName ? `No runs found for ${playName}.` : `No runs found for status ${statusFilter}.`
+  ] : runs.map(
+    (run) => `${run.runId} ${run.status} ${formatTimestamp(run.startedAt)} ${typeof run.billingTotalCredits === "number" && Number.isFinite(run.billingTotalCredits) ? `${formatCreditAmount(run.billingTotalCredits)} credits` : "\u2014"}${run.parentRunId ? ` parent=${run.parentRunId}` : ""}`
   );
   printCommandEnvelope(
     {
@@ -12899,6 +12928,31 @@ async function handleRunStop(args) {
   );
   return 0;
 }
+async function handleRunStopAll(args) {
+  let reason;
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--reason" && args[index + 1]) {
+      reason = args[++index];
+    }
+  }
+  const client2 = new DeeplineClient();
+  const result = await client2.runs.stopAll({ reason });
+  const lines = [
+    `Stopped ${result.stopped} active run${result.stopped === 1 ? "" : "s"}`,
+    ...result.partial ? ["partial: active runs may remain; rerun stop-all"] : [],
+    ...result.failed > 0 ? [`failed stops: ${result.failed}`] : [],
+    ...result.skipped > 0 ? [`skipped: ${result.skipped}`] : []
+  ];
+  printCommandEnvelope(
+    {
+      ...result,
+      render: { sections: [{ title: "workspace stop-all", lines }] }
+    },
+    { json: argsWantJson(args) }
+  );
+  return result.failed > 0 || result.partial ? 1 : 0;
+}
 async function handleRunExport(args) {
   const usage = "Usage: deepline runs export <run-id> [--dataset result.rows] --out output.csv [--metadata-out export.json] [--json]";
   let runId;
@@ -13927,7 +13981,9 @@ Examples:
 `
   );
   addPublishHelp(
-    play.command("publish <target>").description("Promote a saved play revision or publish a local play file.")
+    play.command("publish <target>").description(
+      "Promote a saved play revision or publish a local play file."
+    )
   ).option("--latest", "Promote the newest saved revision").option("--revision-id <id>", "Revision to promote").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (target, options) => {
     process.exitCode = await handlePlayPublish([
       target,
@@ -13937,9 +13993,7 @@ Examples:
     ]);
   });
   addPublishHelp(
-    play.command("set-live <target>").description(
-      "Promote a saved revision or publish a local play file."
-    )
+    play.command("set-live <target>").description("Promote a saved revision or publish a local play file.")
   ).option("--latest", "Promote the newest saved revision").option("--revision-id <id>", "Revision to promote").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (target, options) => {
     process.exitCode = await handlePlayPublish([
       target,
@@ -13980,7 +14034,9 @@ Examples:
   deepline runs tail play/my-play/run/20260501t000000-000
   deepline runs logs play/my-play/run/20260501t000000-000 --out run.log --json
   deepline runs list --play my-play --status failed --json
+  deepline runs list --status running --json
   deepline runs stop play/my-play/run/20260501t000000-000 --reason "stale lock" --json
+  deepline runs stop-all --reason "unjam workspace" --json
   deepline runs export play/my-play/run/20260501t000000-000 --out output.csv
 `
   );
@@ -14014,16 +14070,32 @@ Notes:
 Examples:
   deepline runs list --play my-play
   deepline runs list --play my-play --status failed --compact --json
+  deepline runs list --status running --compact --json
 `
-  ).requiredOption("--play <name>", "Play name to filter runs").option("--status <status>", "Filter by run status").option("--compact", "Drop verbose fields from JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (options) => {
+  ).option("--play <name>", "Play name to filter runs").option("--status <status>", "Filter by run status").option("--compact", "Drop verbose fields from JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (options) => {
     process.exitCode = await handleRunsList([
-      "--play",
-      options.play,
+      ...options.play ? ["--play", options.play] : [],
       ...options.status ? ["--status", options.status] : [],
       ...options.compact ? ["--compact"] : [],
       ...options.json ? ["--json"] : []
     ]);
   });
+  runs.command("stop-all").description("Stop active play runs in the current workspace.").addHelpText(
+    "after",
+    `
+Notes:
+  Stops all active runs visible to this workspace, including child runs created by ctx.runPlay.
+
+Examples:
+  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) => {
+    process.exitCode = await handleRunStopAll([
+      ...options.reason ? ["--reason", options.reason] : [],
+      ...options.json ? ["--json"] : []
+    ]);
+  });
   runs.command("tail <runId>").description("Read the canonical live stream for a play run.").addHelpText(
     "after",
     `

package/dist/cli/index.mjs

@@ -380,10 +380,10 @@ var SDK_RELEASE = {
   // skill on the sdk sync surface, and the people-search-to-email prebuilt.
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
-  version: "0.1.122",
+  version: "0.1.123",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.122",
+    latest: "0.1.123",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -1997,7 +1997,8 @@ var DeeplineClient = class {
       tail: (runId, options2) => this.tailRun(runId, options2),
       logs: (runId, options2) => this.getRunLogs(runId, options2),
       exportDatasetRows: (input2) => this.getPlaySheetRows(input2),
-      stop: (runId, options2) => this.stopRun(runId, options2)
+      stop: (runId, options2) => this.stopRun(runId, options2),
+      stopAll: (options2) => this.stopAllRuns(options2)
     };
     this.billing = {
       plans: () => this.getBillingPlans(),
@@ -2861,15 +2862,21 @@ var DeeplineClient = class {
    * ```
    */
   async listRuns(options) {
-    const playName = options.play.trim();
-    if (!playName) {
-      throw new Error("runs.list requires options.play.");
+    const playName = options.play?.trim();
+    const params = new URLSearchParams();
+    if (playName) {
+      params.set("play", playName);
     }
-    const params = new URLSearchParams({ play: playName });
     const status = options.status?.trim();
     if (status) {
       params.set("status", status);
     }
+    if (typeof options.limit === "number" && Number.isFinite(options.limit)) {
+      params.set("limit", String(Math.max(1, Math.floor(options.limit))));
+    }
+    if (!playName && !status) {
+      throw new Error("runs.list requires options.play or options.status.");
+    }
     params.set("compact", "true");
     const response = await this.http.get(
       `/api/v2/runs?${params.toString()}`
@@ -3176,6 +3183,24 @@ var DeeplineClient = class {
       options?.reason ? { reason: options.reason } : {}
     );
   }
+  /**
+   * 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.
+   */
+  async stopAllRuns(options) {
+    return this.http.post(
+      "/api/v2/runs/stop-all",
+      options?.reason ? { reason: options.reason } : {}
+    );
+  }
   /**
    * List callable plays visible to the workspace.
    *
@@ -12678,7 +12703,7 @@ async function handleRunGet(args) {
   return 0;
 }
 async function handleRunsList(args) {
-  const usage = "Usage: deepline runs list --play <play-name> [--status <status>] [--json]";
+  const usage = "Usage: deepline runs list [--play <play-name>] [--status <status>] [--json]";
   let playName = null;
   let statusFilter = null;
   for (let index = 0; index < args.length; index += 1) {
@@ -12695,28 +12720,32 @@ async function handleRunsList(args) {
       continue;
     }
   }
-  if (!playName) {
+  if (!playName && !statusFilter) {
     console.error(usage);
     return 1;
   }
   const client2 = new DeeplineClient();
   const runs = (await client2.runs.list({
-    play: playName,
+    ...playName ? { play: playName } : {},
     ...statusFilter ? { status: statusFilter } : {}
   })).map((run) => ({
     runId: run.workflowId,
     workflowId: run.workflowId,
     temporalRunId: run.runId,
+    parentRunId: run.parentRunId ?? null,
+    rootRunId: run.rootRunId ?? null,
     status: String(run.status ?? "").toLowerCase(),
-    startedAt: run.startTime,
-    finishedAt: run.closeTime,
+    startedAt: run.startTime ?? run.startedAt ?? null,
+    finishedAt: run.closeTime ?? run.finishedAt ?? null,
     executionTime: run.executionTime,
     billingTotalCredits: run.billingTotalCredits,
     billingMaxCreditsPerRun: run.billingMaxCreditsPerRun,
-    playName: run.memo?.playName ?? playName
+    playName: run.playName ?? run.memo?.playName ?? playName ?? null
   }));
-  const lines = runs.length === 0 ? [`No runs found for ${playName}.`] : runs.map(
-    (run) => `${run.runId} ${run.status} ${formatTimestamp(run.startedAt)} ${typeof run.billingTotalCredits === "number" && Number.isFinite(run.billingTotalCredits) ? `${formatCreditAmount(run.billingTotalCredits)} credits` : "\u2014"}`
+  const lines = runs.length === 0 ? [
+    playName ? `No runs found for ${playName}.` : `No runs found for status ${statusFilter}.`
+  ] : runs.map(
+    (run) => `${run.runId} ${run.status} ${formatTimestamp(run.startedAt)} ${typeof run.billingTotalCredits === "number" && Number.isFinite(run.billingTotalCredits) ? `${formatCreditAmount(run.billingTotalCredits)} credits` : "\u2014"}${run.parentRunId ? ` parent=${run.parentRunId}` : ""}`
   );
   printCommandEnvelope(
     {
@@ -12902,6 +12931,31 @@ async function handleRunStop(args) {
   );
   return 0;
 }
+async function handleRunStopAll(args) {
+  let reason;
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--reason" && args[index + 1]) {
+      reason = args[++index];
+    }
+  }
+  const client2 = new DeeplineClient();
+  const result = await client2.runs.stopAll({ reason });
+  const lines = [
+    `Stopped ${result.stopped} active run${result.stopped === 1 ? "" : "s"}`,
+    ...result.partial ? ["partial: active runs may remain; rerun stop-all"] : [],
+    ...result.failed > 0 ? [`failed stops: ${result.failed}`] : [],
+    ...result.skipped > 0 ? [`skipped: ${result.skipped}`] : []
+  ];
+  printCommandEnvelope(
+    {
+      ...result,
+      render: { sections: [{ title: "workspace stop-all", lines }] }
+    },
+    { json: argsWantJson(args) }
+  );
+  return result.failed > 0 || result.partial ? 1 : 0;
+}
 async function handleRunExport(args) {
   const usage = "Usage: deepline runs export <run-id> [--dataset result.rows] --out output.csv [--metadata-out export.json] [--json]";
   let runId;
@@ -13930,7 +13984,9 @@ Examples:
 `
   );
   addPublishHelp(
-    play.command("publish <target>").description("Promote a saved play revision or publish a local play file.")
+    play.command("publish <target>").description(
+      "Promote a saved play revision or publish a local play file."
+    )
   ).option("--latest", "Promote the newest saved revision").option("--revision-id <id>", "Revision to promote").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (target, options) => {
     process.exitCode = await handlePlayPublish([
       target,
@@ -13940,9 +13996,7 @@ Examples:
     ]);
   });
   addPublishHelp(
-    play.command("set-live <target>").description(
-      "Promote a saved revision or publish a local play file."
-    )
+    play.command("set-live <target>").description("Promote a saved revision or publish a local play file.")
   ).option("--latest", "Promote the newest saved revision").option("--revision-id <id>", "Revision to promote").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (target, options) => {
     process.exitCode = await handlePlayPublish([
       target,
@@ -13983,7 +14037,9 @@ Examples:
   deepline runs tail play/my-play/run/20260501t000000-000
   deepline runs logs play/my-play/run/20260501t000000-000 --out run.log --json
   deepline runs list --play my-play --status failed --json
+  deepline runs list --status running --json
   deepline runs stop play/my-play/run/20260501t000000-000 --reason "stale lock" --json
+  deepline runs stop-all --reason "unjam workspace" --json
   deepline runs export play/my-play/run/20260501t000000-000 --out output.csv
 `
   );
@@ -14017,16 +14073,32 @@ Notes:
 Examples:
   deepline runs list --play my-play
   deepline runs list --play my-play --status failed --compact --json
+  deepline runs list --status running --compact --json
 `
-  ).requiredOption("--play <name>", "Play name to filter runs").option("--status <status>", "Filter by run status").option("--compact", "Drop verbose fields from JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (options) => {
+  ).option("--play <name>", "Play name to filter runs").option("--status <status>", "Filter by run status").option("--compact", "Drop verbose fields from JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (options) => {
     process.exitCode = await handleRunsList([
-      "--play",
-      options.play,
+      ...options.play ? ["--play", options.play] : [],
       ...options.status ? ["--status", options.status] : [],
       ...options.compact ? ["--compact"] : [],
       ...options.json ? ["--json"] : []
     ]);
   });
+  runs.command("stop-all").description("Stop active play runs in the current workspace.").addHelpText(
+    "after",
+    `
+Notes:
+  Stops all active runs visible to this workspace, including child runs created by ctx.runPlay.
+
+Examples:
+  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) => {
+    process.exitCode = await handleRunStopAll([
+      ...options.reason ? ["--reason", options.reason] : [],
+      ...options.json ? ["--json"] : []
+    ]);
+  });
   runs.command("tail <runId>").description("Read the canonical live stream for a play run.").addHelpText(
     "after",
     `

package/dist/index.d.mts

@@ -515,22 +515,41 @@ interface StopPlayRunResult {
     /** Server-side error detail when the stop was not confirmed. */
     error?: string;
 }
+interface StopAllPlayRunsResult {
+    stopped: number;
+    failed: number;
+    skipped: number;
+    partial?: boolean;
+    runs: Array<StopPlayRunResult & {
+        status?: string | null;
+    }>;
+}
 /**
  * Summary of a single play run, returned by {@link DeeplineClient.listPlayRuns}.
  */
 interface PlayRunListItem {
     /** Public Deepline play-run id. */
     workflowId: string;
+    /** Saved play name for this run, when available. */
+    playName?: string | null;
     /** Backend run attempt id, when exposed. */
     runId: string;
+    /** Parent play-run id when this run was launched through ctx.runPlay. */
+    parentRunId?: string | null;
+    /** Root play-run id for nested ctx.runPlay descendants. */
+    rootRunId?: string | null;
     /** Workflow type (typically `'Workflow'`). */
     type: string;
     /** Human-readable status (e.g. `'Completed'`, `'Failed'`). */
     status: string;
     /** ISO 8601 timestamp when the run started. */
-    startTime: string | null;
+    startTime?: string | null;
+    /** Unix epoch milliseconds when the run started, returned by normalized V2 run summaries. */
+    startedAt?: number | string | null;
     /** ISO 8601 timestamp when the run finished. */
-    closeTime: string | null;
+    closeTime?: string | null;
+    /** Unix epoch milliseconds when the run finished, returned by normalized V2 run summaries. */
+    finishedAt?: number | string | null;
     /** Duration string (e.g. `'2.5s'`). */
     executionTime: string | null;
     /** Total Deepline credits charged for the run, when available. */
@@ -1041,8 +1060,9 @@ type ToolExecution<TData = unknown, TMeta = Record<string, unknown>> = {
 };
 /** Filters for `client.runs.list(...)`. */
 type RunsListOptions = {
-    play: string;
+    play?: string;
     status?: string;
+    limit?: number;
 };
 /** Streaming options for `client.runs.tail(...)`. */
 type RunsTailOptions = {
@@ -1155,6 +1175,10 @@ type RunsNamespace = {
     stop: (runId: string, options?: {
         reason?: string;
     }) => Promise<StopPlayRunResult>;
+    /** Stop active runs across the current workspace. */
+    stopAll: (options?: {
+        reason?: string;
+    }) => Promise<StopAllPlayRunsResult>;
 };
 /** One credit grant pool reported by the billing subscription status endpoint. */
 type BillingCreditPool = {
@@ -1890,6 +1914,21 @@ 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>;
     /**
      * List callable plays visible to the workspace.
      *

package/dist/index.d.ts

@@ -515,22 +515,41 @@ interface StopPlayRunResult {
     /** Server-side error detail when the stop was not confirmed. */
     error?: string;
 }
+interface StopAllPlayRunsResult {
+    stopped: number;
+    failed: number;
+    skipped: number;
+    partial?: boolean;
+    runs: Array<StopPlayRunResult & {
+        status?: string | null;
+    }>;
+}
 /**
  * Summary of a single play run, returned by {@link DeeplineClient.listPlayRuns}.
  */
 interface PlayRunListItem {
     /** Public Deepline play-run id. */
     workflowId: string;
+    /** Saved play name for this run, when available. */
+    playName?: string | null;
     /** Backend run attempt id, when exposed. */
     runId: string;
+    /** Parent play-run id when this run was launched through ctx.runPlay. */
+    parentRunId?: string | null;
+    /** Root play-run id for nested ctx.runPlay descendants. */
+    rootRunId?: string | null;
     /** Workflow type (typically `'Workflow'`). */
     type: string;
     /** Human-readable status (e.g. `'Completed'`, `'Failed'`). */
     status: string;
     /** ISO 8601 timestamp when the run started. */
-    startTime: string | null;
+    startTime?: string | null;
+    /** Unix epoch milliseconds when the run started, returned by normalized V2 run summaries. */
+    startedAt?: number | string | null;
     /** ISO 8601 timestamp when the run finished. */
-    closeTime: string | null;
+    closeTime?: string | null;
+    /** Unix epoch milliseconds when the run finished, returned by normalized V2 run summaries. */
+    finishedAt?: number | string | null;
     /** Duration string (e.g. `'2.5s'`). */
     executionTime: string | null;
     /** Total Deepline credits charged for the run, when available. */
@@ -1041,8 +1060,9 @@ type ToolExecution<TData = unknown, TMeta = Record<string, unknown>> = {
 };
 /** Filters for `client.runs.list(...)`. */
 type RunsListOptions = {
-    play: string;
+    play?: string;
     status?: string;
+    limit?: number;
 };
 /** Streaming options for `client.runs.tail(...)`. */
 type RunsTailOptions = {
@@ -1155,6 +1175,10 @@ type RunsNamespace = {
     stop: (runId: string, options?: {
         reason?: string;
     }) => Promise<StopPlayRunResult>;
+    /** Stop active runs across the current workspace. */
+    stopAll: (options?: {
+        reason?: string;
+    }) => Promise<StopAllPlayRunsResult>;
 };
 /** One credit grant pool reported by the billing subscription status endpoint. */
 type BillingCreditPool = {
@@ -1890,6 +1914,21 @@ 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>;
     /**
      * List callable plays visible to the workspace.
      *

package/dist/index.js

@@ -274,10 +274,10 @@ var SDK_RELEASE = {
   // skill on the sdk sync surface, and the people-search-to-email prebuilt.
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
-  version: "0.1.122",
+  version: "0.1.123",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.122",
+    latest: "0.1.123",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -1891,7 +1891,8 @@ var DeeplineClient = class {
       tail: (runId, options2) => this.tailRun(runId, options2),
       logs: (runId, options2) => this.getRunLogs(runId, options2),
       exportDatasetRows: (input) => this.getPlaySheetRows(input),
-      stop: (runId, options2) => this.stopRun(runId, options2)
+      stop: (runId, options2) => this.stopRun(runId, options2),
+      stopAll: (options2) => this.stopAllRuns(options2)
     };
     this.billing = {
       plans: () => this.getBillingPlans(),
@@ -2755,15 +2756,21 @@ var DeeplineClient = class {
    * ```
    */
   async listRuns(options) {
-    const playName = options.play.trim();
-    if (!playName) {
-      throw new Error("runs.list requires options.play.");
+    const playName = options.play?.trim();
+    const params = new URLSearchParams();
+    if (playName) {
+      params.set("play", playName);
     }
-    const params = new URLSearchParams({ play: playName });
     const status = options.status?.trim();
     if (status) {
       params.set("status", status);
     }
+    if (typeof options.limit === "number" && Number.isFinite(options.limit)) {
+      params.set("limit", String(Math.max(1, Math.floor(options.limit))));
+    }
+    if (!playName && !status) {
+      throw new Error("runs.list requires options.play or options.status.");
+    }
     params.set("compact", "true");
     const response = await this.http.get(
       `/api/v2/runs?${params.toString()}`
@@ -3070,6 +3077,24 @@ var DeeplineClient = class {
       options?.reason ? { reason: options.reason } : {}
     );
   }
+  /**
+   * 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.
+   */
+  async stopAllRuns(options) {
+    return this.http.post(
+      "/api/v2/runs/stop-all",
+      options?.reason ? { reason: options.reason } : {}
+    );
+  }
   /**
    * List callable plays visible to the workspace.
    *

package/dist/index.mjs

@@ -196,10 +196,10 @@ var SDK_RELEASE = {
   // skill on the sdk sync surface, and the people-search-to-email prebuilt.
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
-  version: "0.1.122",
+  version: "0.1.123",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.122",
+    latest: "0.1.123",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -1813,7 +1813,8 @@ var DeeplineClient = class {
       tail: (runId, options2) => this.tailRun(runId, options2),
       logs: (runId, options2) => this.getRunLogs(runId, options2),
       exportDatasetRows: (input) => this.getPlaySheetRows(input),
-      stop: (runId, options2) => this.stopRun(runId, options2)
+      stop: (runId, options2) => this.stopRun(runId, options2),
+      stopAll: (options2) => this.stopAllRuns(options2)
     };
     this.billing = {
       plans: () => this.getBillingPlans(),
@@ -2677,15 +2678,21 @@ var DeeplineClient = class {
    * ```
    */
   async listRuns(options) {
-    const playName = options.play.trim();
-    if (!playName) {
-      throw new Error("runs.list requires options.play.");
+    const playName = options.play?.trim();
+    const params = new URLSearchParams();
+    if (playName) {
+      params.set("play", playName);
     }
-    const params = new URLSearchParams({ play: playName });
     const status = options.status?.trim();
     if (status) {
       params.set("status", status);
     }
+    if (typeof options.limit === "number" && Number.isFinite(options.limit)) {
+      params.set("limit", String(Math.max(1, Math.floor(options.limit))));
+    }
+    if (!playName && !status) {
+      throw new Error("runs.list requires options.play or options.status.");
+    }
     params.set("compact", "true");
     const response = await this.http.get(
       `/api/v2/runs?${params.toString()}`
@@ -2992,6 +2999,24 @@ var DeeplineClient = class {
       options?.reason ? { reason: options.reason } : {}
     );
   }
+  /**
+   * 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.
+   */
+  async stopAllRuns(options) {
+    return this.http.post(
+      "/api/v2/runs/stop-all",
+      options?.reason ? { reason: options.reason } : {}
+    );
+  }
   /**
    * List callable plays visible to the workspace.
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.122",
+  "version": "0.1.123",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {