From b8399a84266131fdc2a3fe755244fd119cf9dac7 Mon Sep 17 00:00:00 2001
From: Ayush7614 <ayushknj3@gmail.com>
Date: Thu, 30 Jul 2026 19:53:28 +0530
Subject: [PATCH 1/3] fix: add builds abort, runs status filter, and dataset
 command bugs

Add builds abort parity with runs, --status on runs ls, correct dataset info messaging/pricing, richer get-items export options, and rename help text fixes.
---
 docs/reference.md                            |  65 ++++++++---
 scripts/generate-cli-docs.ts                 |   1 +
 src/commands/builds/_index.ts                |   4 +-
 src/commands/builds/abort.ts                 |  85 +++++++++++++++
 src/commands/builds/log.ts                   |  13 ++-
 src/commands/builds/ls.ts                    |   2 +-
 src/commands/datasets/get-items.ts           | 108 +++++++++++--------
 src/commands/datasets/info.ts                |   4 +-
 src/commands/datasets/rename.ts              |   2 +-
 src/commands/key-value-stores/rename.ts      |   2 +-
 src/commands/runs/ls.ts                      |  28 ++++-
 test/e2e/commands/builds/lifecycle.test.ts   |  23 +++-
 test/e2e/commands/datasets/lifecycle.test.ts |  26 +++++
 test/e2e/commands/runs/lifecycle.test.ts     |  14 +++
 test/local/storage-size.test.ts              |  26 +++++
 15 files changed, 335 insertions(+), 68 deletions(-)
 create mode 100644 src/commands/builds/abort.ts
 create mode 100644 test/local/storage-size.test.ts

diff --git a/docs/reference.md b/docs/reference.md
index 09af9be11..358abf5b8 100644
--- a/docs/reference.md
+++ b/docs/reference.md
@@ -885,9 +885,11 @@ Use these commands to manage Actor build processes. They help you create, monito
 
 ```sh
 DESCRIPTION
-  Create, inspect, tag, and delete Actor builds on the Apify platform.
+  Create, inspect, abort, tag, and delete Actor builds on the Apify platform.
 
 SUBCOMMANDS
+  builds abort       Aborts an Actor build that is currently in
+                     progress.
   builds add-tag     Adds a tag to a specific Actor build.
   builds remove-tag  Removes a tag from a specific Actor build.
   builds rm          Permanently removes an Actor build from
@@ -900,6 +902,22 @@ SUBCOMMANDS
                      terminal status (SUCCEEDED, FAILED, ABORTED, TIMED-OUT).
 ```
 
+##### `apify builds abort`
+
+```sh
+DESCRIPTION
+  Aborts an Actor build that is currently in progress.
+
+USAGE
+  $ apify builds abort <buildId> [--json]
+
+ARGUMENTS
+  buildId  The build ID to abort.
+
+FLAGS
+      --json  Format the command output as JSON.
+```
+
 ##### `apify builds add-tag`
 
 ```sh
@@ -981,7 +999,7 @@ USAGE
                     [--limit <value>] [--offset <value>]
 
 ARGUMENTS
-  actorId  Optional Actor ID or Name to list runs for. By default, it
+  actorId  Optional Actor ID or Name to list builds for. By default, it
            will use the Actor from the current directory.
 
 FLAGS
@@ -1136,17 +1154,23 @@ DESCRIPTION
 USAGE
   $ apify runs ls [actorId] [-c] [--desc] [--json]
                   [--limit <value>] [--offset <value>]
+                  [--status
+                  READY|RUNNING|SUCCEEDED|FAILED|TIMING-OUT|TIMED-OUT|ABORTING|ABORTED]
 
 ARGUMENTS
   actorId  Optional Actor ID or Name to list runs for. By default, it
            will use the Actor from the current directory.
 
 FLAGS
-  -c, --compact         Display a compact table.
-      --desc            Sort runs in descending order.
-      --json            Format the command output as JSON.
-      --limit=<value>   Number of runs that will be listed.
-      --offset=<value>  Number of runs that will be skipped.
+  -c, --compact          Display a compact table.
+      --desc             Sort runs in descending order.
+      --json             Format the command output as JSON.
+      --limit=<value>    Number of runs that will be listed.
+      --offset=<value>   Number of runs that will be skipped.
+      --status=<option>  Filter runs by status (e.g. RUNNING,
+                         SUCCEEDED, FAILED).
+                         <options:
+                         READY|RUNNING|SUCCEEDED|FAILED|TIMING-OUT|TIMED-OUT|ABORTING|ABORTED>
 ```
 
 ##### `apify runs resurrect`
@@ -1230,7 +1254,7 @@ DESCRIPTION
 SUBCOMMANDS
   datasets create      Creates a new dataset for storing
                        structured data on your account.
-  datasets get-items   Retrieves dataset items in specified
+  datasets get-items   Retrieves dataset items in a specified
                        format (JSON, CSV, etc).
   datasets ls          Prints all datasets on your account.
   datasets info        Prints information about a specific
@@ -1262,17 +1286,27 @@ FLAGS
 
 ```sh
 DESCRIPTION
-  Retrieves dataset items in specified format (JSON, CSV, etc).
+  Retrieves dataset items in a specified format (JSON, CSV, etc).
+  Supports field selection, cleaning empty/hidden values, and writing directly 
+  to a file.
 
 USAGE
-  $ apify datasets get-items <datasetId>
+  $ apify datasets get-items <datasetId> [--clean]
+                             [--desc] [--fields <value>]
                              [--format json|jsonl|csv|html|rss|xml|xlsx]
                              [--limit <value>] [--offset <value>]
+                             [--omit <value>] [-o <value>] [--unwind <value>]
 
 ARGUMENTS
   datasetId  The ID of the Dataset to export the items for.
 
 FLAGS
+      --clean            Return only non-empty items and skip
+                         hidden fields (fields starting with #).
+      --desc             Return items in descending order (newest
+                         first).
+      --fields=<value>   Comma-separated list of fields to
+                         include in each item (all other fields are omitted).
       --format=<option>  The format of the returned output. By
                          default, it is set to 'json'.
                          <options: json|jsonl|csv|html|rss|xml|xlsx>
@@ -1280,6 +1314,13 @@ FLAGS
                          dataset. By default, it will return all available items.
       --offset=<value>   The offset in the dataset where to start
                          getting items.
+      --omit=<value>     Comma-separated list of fields to
+                         exclude from each item.
+  -o, --output=<value>   Write items to this file path
+                         instead of stdout. Content-Type still goes to stderr.
+      --unwind=<value>   Comma-separated list of fields to
+                         unwind. Each array value creates a separate item (same as
+                         the Dataset API).
 ```
 
 ##### `apify datasets info`
@@ -1341,7 +1382,7 @@ USAGE
   $ apify datasets rename <nameOrId> [newName] [--unname]
 
 ARGUMENTS
-  nameOrId  The dataset ID or name to delete.
+  nameOrId  The dataset ID or name to rename.
   newName   The new name for the dataset.
 
 FLAGS
@@ -1536,7 +1577,7 @@ USAGE
 
 ARGUMENTS
   keyValueStoreNameOrId  The key-value store ID or name to
-                         delete.
+                         rename.
   newName                The new name for the key-value
                          store.
 
diff --git a/scripts/generate-cli-docs.ts b/scripts/generate-cli-docs.ts
index a45eb8555..71f071702 100644
--- a/scripts/generate-cli-docs.ts
+++ b/scripts/generate-cli-docs.ts
@@ -53,6 +53,7 @@ const categories: Record<string, CommandsInCategory[]> = {
 	'actor-build': [
 		//
 		{ command: Commands.builds },
+		{ command: Commands.buildsAbort },
 		{ command: Commands.buildsAddTag },
 		{ command: Commands.buildsCreate, aliases: [Commands.actorsBuild] },
 		{ command: Commands.buildsInfo },
diff --git a/src/commands/builds/_index.ts b/src/commands/builds/_index.ts
index 080290fe7..b3c7ed3f8 100644
--- a/src/commands/builds/_index.ts
+++ b/src/commands/builds/_index.ts
@@ -1,4 +1,5 @@
 import { ApifyCommand } from '../../lib/command-framework/apify-command.js';
+import { BuildsAbortCommand } from './abort.js';
 import { BuildsAddTagCommand } from './add-tag.js';
 import { BuildsCreateCommand } from './create.js';
 import { BuildsInfoCommand } from './info.js';
@@ -11,7 +12,7 @@ import { BuildsWaitCommand } from './wait.js';
 export class BuildsIndexCommand extends ApifyCommand<typeof BuildsIndexCommand> {
 	static override name = 'builds' as const;
 
-	static override description = 'Create, inspect, tag, and delete Actor builds on the Apify platform.';
+	static override description = 'Create, inspect, abort, tag, and delete Actor builds on the Apify platform.';
 
 	static override group = 'Apify Console';
 
@@ -19,6 +20,7 @@ export class BuildsIndexCommand extends ApifyCommand<typeof BuildsIndexCommand>
 
 	static override subcommands = [
 		//
+		BuildsAbortCommand,
 		BuildsAddTagCommand,
 		BuildsRemoveTagCommand,
 		BuildsRmCommand,
diff --git a/src/commands/builds/abort.ts b/src/commands/builds/abort.ts
new file mode 100644
index 000000000..1b895ffce
--- /dev/null
+++ b/src/commands/builds/abort.ts
@@ -0,0 +1,85 @@
+import type { ApifyApiError } from 'apify-client';
+
+import { ACTOR_JOB_STATUSES } from '@apify/consts';
+
+import { ApifyCommand } from '../../lib/command-framework/apify-command.js';
+import { Args } from '../../lib/command-framework/args.js';
+import { error, success } from '../../lib/outputs.js';
+import { getLoggedClientOrThrow, printJsonToStdout } from '../../lib/utils.js';
+
+const runningStatuses = [ACTOR_JOB_STATUSES.READY, ACTOR_JOB_STATUSES.RUNNING];
+
+const abortingStatuses = [ACTOR_JOB_STATUSES.ABORTING, ACTOR_JOB_STATUSES.TIMING_OUT];
+
+export class BuildsAbortCommand extends ApifyCommand<typeof BuildsAbortCommand> {
+	static override name = 'abort' as const;
+
+	static override description = 'Aborts an Actor build that is currently in progress.';
+
+	static override examples = [
+		{
+			description: 'Abort a running Actor build.',
+			command: 'apify builds abort <buildId>',
+		},
+	];
+
+	static override docsUrl = 'https://docs.apify.com/cli/docs/reference#apify-builds-abort';
+
+	static override args = {
+		buildId: Args.string({
+			required: true,
+			description: 'The build ID to abort.',
+		}),
+	};
+
+	static override enableJsonFlag = true;
+
+	async run() {
+		const { buildId } = this.args;
+
+		const apifyClient = await getLoggedClientOrThrow();
+
+		const build = await apifyClient.build(buildId).get();
+
+		if (!build) {
+			error({ message: `Build with ID "${buildId}" was not found on your account.`, stdout: true });
+			return;
+		}
+
+		if (!runningStatuses.includes(build.status as never)) {
+			if (abortingStatuses.includes(build.status as never)) {
+				error({ message: `Build with ID "${buildId}" is already aborting.`, stdout: true });
+			} else if (build.status === ACTOR_JOB_STATUSES.ABORTED || build.status === ACTOR_JOB_STATUSES.TIMED_OUT) {
+				error({ message: `Build with ID "${buildId}" is already aborted.`, stdout: true });
+			} else {
+				error({
+					message: `Build with ID "${buildId}" cannot be aborted (status: ${build.status}).`,
+					stdout: true,
+				});
+			}
+
+			return;
+		}
+
+		try {
+			const result = await apifyClient.build(buildId).abort();
+
+			if (this.flags.json) {
+				printJsonToStdout(result);
+				return;
+			}
+
+			success({
+				message: `Triggered the abort of build "${buildId}".`,
+				stdout: true,
+			});
+		} catch (err) {
+			const casted = err as ApifyApiError;
+
+			error({
+				message: `Failed to abort build "${buildId}".\n  ${casted.message || casted}`,
+				stdout: true,
+			});
+		}
+	}
+}
diff --git a/src/commands/builds/log.ts b/src/commands/builds/log.ts
index 5375234e7..082b086c2 100644
--- a/src/commands/builds/log.ts
+++ b/src/commands/builds/log.ts
@@ -1,6 +1,6 @@
 import { ApifyCommand } from '../../lib/command-framework/apify-command.js';
 import { Args } from '../../lib/command-framework/args.js';
-import { info } from '../../lib/outputs.js';
+import { error, info } from '../../lib/outputs.js';
 import { getLoggedClientOrThrow, outputJobLog } from '../../lib/utils.js';
 
 export class BuildsLogCommand extends ApifyCommand<typeof BuildsLogCommand> {
@@ -32,11 +32,16 @@ export class BuildsLogCommand extends ApifyCommand<typeof BuildsLogCommand> {
 		const build = await apifyClient.build(buildId).get();
 
 		if (!build) {
-			throw new Error(`Build with ID "${buildId}" was not found on your account.`);
+			error({ message: `Build with ID "${buildId}" was not found on your account.`, stdout: true });
+			return;
 		}
 
-		info({ message: `Log for build with ID "${buildId}":\n` });
+		info({ message: `Log for build with ID "${buildId}":\n`, stdout: true });
 
-		await outputJobLog({ job: build, apifyClient });
+		try {
+			await outputJobLog({ job: build, apifyClient });
+		} catch (err) {
+			error({ message: `Failed to get log for build with ID "${buildId}": ${(err as Error).message}` });
+		}
 	}
 }
diff --git a/src/commands/builds/ls.ts b/src/commands/builds/ls.ts
index db7f9c1cc..a68f713ba 100644
--- a/src/commands/builds/ls.ts
+++ b/src/commands/builds/ls.ts
@@ -60,7 +60,7 @@ export class BuildsLsCommand extends ApifyCommand<typeof BuildsLsCommand> {
 	static override args = {
 		actorId: Args.string({
 			description:
-				'Optional Actor ID or Name to list runs for. By default, it will use the Actor from the current directory.',
+				'Optional Actor ID or Name to list builds for. By default, it will use the Actor from the current directory.',
 		}),
 	};
 
diff --git a/src/commands/datasets/get-items.ts b/src/commands/datasets/get-items.ts
index 93bf6847f..769918ae3 100644
--- a/src/commands/datasets/get-items.ts
+++ b/src/commands/datasets/get-items.ts
@@ -1,10 +1,14 @@
-import { type ApifyClient, type Dataset, type DatasetClient, DownloadItemsFormat } from 'apify-client';
+import { writeFileSync } from 'node:fs';
+import process from 'node:process';
+
+import { DownloadItemsFormat } from 'apify-client';
 
 import { ApifyCommand } from '../../lib/command-framework/apify-command.js';
 import { Args } from '../../lib/command-framework/args.js';
 import { Flags } from '../../lib/command-framework/flags.js';
+import { tryToGetDataset } from '../../lib/commands/storages.js';
 import { error, simpleLog } from '../../lib/outputs.js';
-import { getLocalUserInfo, getLoggedClientOrThrow } from '../../lib/utils.js';
+import { getLoggedClientOrThrow } from '../../lib/utils.js';
 
 const downloadFormatToContentType: Record<DownloadItemsFormat, string> = {
 	[DownloadItemsFormat.JSON]: 'application/json',
@@ -16,10 +20,25 @@ const downloadFormatToContentType: Record<DownloadItemsFormat, string> = {
 	[DownloadItemsFormat.XLSX]: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
 };
 
+function parseCsvList(value: string | undefined): string[] | undefined {
+	if (!value) {
+		return undefined;
+	}
+
+	const parts = value
+		.split(',')
+		.map((part) => part.trim())
+		.filter(Boolean);
+
+	return parts.length > 0 ? parts : undefined;
+}
+
 export class DatasetsGetItems extends ApifyCommand<typeof DatasetsGetItems> {
 	static override name = 'get-items' as const;
 
-	static override description = 'Retrieves dataset items in specified format (JSON, CSV, etc).';
+	static override description =
+		'Retrieves dataset items in a specified format (JSON, CSV, etc).\n' +
+		'Supports field selection, cleaning empty/hidden values, and writing directly to a file.';
 
 	static override examples = [
 		{
@@ -28,7 +47,11 @@ export class DatasetsGetItems extends ApifyCommand<typeof DatasetsGetItems> {
 		},
 		{
 			description: 'Export the first 100 items as CSV to a file.',
-			command: 'apify datasets get-items <datasetId> --format csv --limit 100 > items.csv',
+			command: 'apify datasets get-items <datasetId> --format csv --limit 100 --output items.csv',
+		},
+		{
+			description: 'Export only selected fields, skipping empty items.',
+			command: 'apify datasets get-items <datasetId> --fields url,title --clean',
 		},
 		{
 			description: 'Paginate: skip the first 500 items, return the next 500.',
@@ -50,6 +73,28 @@ export class DatasetsGetItems extends ApifyCommand<typeof DatasetsGetItems> {
 			choices: Object.keys(downloadFormatToContentType) as DownloadItemsFormat[],
 			default: DownloadItemsFormat.JSON,
 		}),
+		fields: Flags.string({
+			description: 'Comma-separated list of fields to include in each item (all other fields are omitted).',
+		}),
+		omit: Flags.string({
+			description: 'Comma-separated list of fields to exclude from each item.',
+		}),
+		unwind: Flags.string({
+			description:
+				'Comma-separated list of fields to unwind. Each array value creates a separate item (same as the Dataset API).',
+		}),
+		clean: Flags.boolean({
+			description: 'Return only non-empty items and skip hidden fields (fields starting with #).',
+			default: false,
+		}),
+		desc: Flags.boolean({
+			description: 'Return items in descending order (newest first).',
+			default: false,
+		}),
+		output: Flags.string({
+			description: 'Write items to this file path instead of stdout. Content-Type still goes to stderr.',
+			char: 'o',
+		}),
 	};
 
 	static override args = {
@@ -60,66 +105,45 @@ export class DatasetsGetItems extends ApifyCommand<typeof DatasetsGetItems> {
 	};
 
 	async run() {
-		const { limit, offset, format } = this.flags;
+		const { limit, offset, format, fields, omit, unwind, clean, desc, output } = this.flags;
 		const { datasetId } = this.args;
 
 		const apifyClient = await getLoggedClientOrThrow();
-		const maybeDataset = await this.tryToGetDataset(apifyClient, datasetId);
+		const maybeDataset = await tryToGetDataset(apifyClient, datasetId);
 
 		if (!maybeDataset) {
-			error({ message: `Dataset with ID "${datasetId}" not found.` });
+			error({ message: `Dataset with ID or name "${datasetId}" not found.` });
 
 			return;
 		}
 
 		const { datasetClient } = maybeDataset;
 
-		// Write something already to stdout
-		process.stdout.write('');
+		// Write something already to stdout when streaming to the terminal
+		if (!output) {
+			process.stdout.write('');
+		}
 
 		const result = await datasetClient.downloadItems(format, {
 			limit,
 			offset,
+			clean,
+			desc,
+			fields: parseCsvList(fields),
+			omit: parseCsvList(omit),
+			unwind: parseCsvList(unwind),
 		});
 
 		const contentType = downloadFormatToContentType[format] ?? 'application/octet-stream';
 
 		simpleLog({ message: contentType });
 
-		process.stdout.write(result);
-		process.stdout.write('\n');
-	}
-
-	private async tryToGetDataset(
-		client: ApifyClient,
-		datasetId: string,
-	): Promise<{ dataset: Dataset | undefined; datasetClient: DatasetClient } | null> {
-		const byIdOrName = await client
-			.dataset(datasetId)
-			.get()
-			.catch(() => undefined);
-
-		if (byIdOrName) {
-			return {
-				dataset: byIdOrName,
-				datasetClient: client.dataset(byIdOrName.id),
-			};
-		}
-
-		const info = await getLocalUserInfo();
-
-		const byName = await client
-			.dataset(`${info.username!}/${datasetId}`)
-			.get()
-			.catch(() => undefined);
-
-		if (byName) {
-			return {
-				dataset: byName,
-				datasetClient: client.dataset(byName.id),
-			};
+		if (output) {
+			writeFileSync(output, result);
+			return;
 		}
 
-		return null;
+		process.stdout.write(result);
+		process.stdout.write('\n');
 	}
 }
diff --git a/src/commands/datasets/info.ts b/src/commands/datasets/info.ts
index 431a2aa2d..8692bde67 100644
--- a/src/commands/datasets/info.ts
+++ b/src/commands/datasets/info.ts
@@ -46,7 +46,7 @@ export class DatasetsInfoCommand extends ApifyCommand<typeof DatasetsInfoCommand
 
 		if (!maybeStore) {
 			error({
-				message: `Key-value store with ID or name "${storeId}" not found.`,
+				message: `Dataset with ID or name "${storeId}" not found.`,
 			});
 
 			return;
@@ -100,7 +100,7 @@ export class DatasetsInfoCommand extends ApifyCommand<typeof DatasetsInfoCommand
 			const pricing = getUserPlanPricing(user.plan);
 
 			if (pricing) {
-				const storeCostPerHour = pricing.KEY_VALUE_STORE_TIMED_STORAGE_GBYTE_HOURS * (fullSizeInBytes / 1000 ** 3);
+				const storeCostPerHour = pricing.DATASET_TIMED_STORAGE_GBYTE_HOURS * (fullSizeInBytes / 1000 ** 3);
 				const storeCostPerMonth = storeCostPerHour * 24 * 30;
 
 				const usdAmountString =
diff --git a/src/commands/datasets/rename.ts b/src/commands/datasets/rename.ts
index 274468923..28e66eec7 100644
--- a/src/commands/datasets/rename.ts
+++ b/src/commands/datasets/rename.ts
@@ -34,7 +34,7 @@ export class DatasetsRenameCommand extends ApifyCommand<typeof DatasetsRenameCom
 
 	static override args = {
 		nameOrId: Args.string({
-			description: 'The dataset ID or name to delete.',
+			description: 'The dataset ID or name to rename.',
 			required: true,
 		}),
 		newName: Args.string({
diff --git a/src/commands/key-value-stores/rename.ts b/src/commands/key-value-stores/rename.ts
index 197e41d2f..df0647907 100644
--- a/src/commands/key-value-stores/rename.ts
+++ b/src/commands/key-value-stores/rename.ts
@@ -34,7 +34,7 @@ export class KeyValueStoresRenameCommand extends ApifyCommand<typeof KeyValueSto
 
 	static override args = {
 		keyValueStoreNameOrId: Args.string({
-			description: 'The key-value store ID or name to delete.',
+			description: 'The key-value store ID or name to rename.',
 			required: true,
 		}),
 		newName: Args.string({
diff --git a/src/commands/runs/ls.ts b/src/commands/runs/ls.ts
index e4808979d..5b7139f90 100644
--- a/src/commands/runs/ls.ts
+++ b/src/commands/runs/ls.ts
@@ -1,5 +1,7 @@
 import chalk from 'chalk';
 
+import { ACTOR_JOB_STATUSES } from '@apify/consts';
+
 import { ApifyCommand } from '../../lib/command-framework/apify-command.js';
 import { Args } from '../../lib/command-framework/args.js';
 import { Flags } from '../../lib/command-framework/flags.js';
@@ -14,6 +16,8 @@ import {
 	ShortDurationFormatter,
 } from '../../lib/utils.js';
 
+const jobStatusChoices = Object.values(ACTOR_JOB_STATUSES);
+
 const table = new ResponsiveTable({
 	allColumns: ['ID', 'Status', 'Results', 'Usage', 'Started At', 'Took', 'Build No.', 'Origin'],
 	mandatoryColumns: ['ID', 'Status', 'Results', 'Usage', 'Started At', 'Took'],
@@ -39,6 +43,10 @@ export class RunsLsCommand extends ApifyCommand<typeof RunsLsCommand> {
 			description: 'List runs of a specific Actor.',
 			command: 'apify runs ls apify/hello-world',
 		},
+		{
+			description: 'List only running runs for an Actor.',
+			command: 'apify runs ls apify/hello-world --status RUNNING',
+		},
 		{
 			description: 'List the 50 most recent runs in descending order.',
 			command: 'apify runs ls --limit 50 --desc',
@@ -65,6 +73,10 @@ export class RunsLsCommand extends ApifyCommand<typeof RunsLsCommand> {
 			default: false,
 			char: 'c',
 		}),
+		status: Flags.string({
+			description: 'Filter runs by status (e.g. RUNNING, SUCCEEDED, FAILED).',
+			choices: jobStatusChoices,
+		}),
 	};
 
 	static override args = {
@@ -77,7 +89,7 @@ export class RunsLsCommand extends ApifyCommand<typeof RunsLsCommand> {
 	static override enableJsonFlag = true;
 
 	async run() {
-		const { desc, limit, offset, compact, json } = this.flags;
+		const { desc, limit, offset, compact, json, status } = this.flags;
 		const { actorId } = this.args;
 
 		const client = await getLoggedClientOrThrow();
@@ -93,7 +105,15 @@ export class RunsLsCommand extends ApifyCommand<typeof RunsLsCommand> {
 			return;
 		}
 
-		const allRuns = await client.actor(ctx.id).runs().list({ desc, limit, offset });
+		const allRuns = await client
+			.actor(ctx.id)
+			.runs()
+			.list({
+				desc,
+				limit,
+				offset,
+				...(status ? { status } : {}),
+			});
 
 		if (json) {
 			printJsonToStdout(allRuns);
@@ -102,7 +122,9 @@ export class RunsLsCommand extends ApifyCommand<typeof RunsLsCommand> {
 
 		if (!allRuns.items.length) {
 			simpleLog({
-				message: 'There are no recent runs found for this Actor.',
+				message: status
+					? `There are no recent runs with status ${status} found for this Actor.`
+					: 'There are no recent runs found for this Actor.',
 			});
 
 			return;
diff --git a/test/e2e/commands/builds/lifecycle.test.ts b/test/e2e/commands/builds/lifecycle.test.ts
index 29e9c5644..a27d91a2b 100644
--- a/test/e2e/commands/builds/lifecycle.test.ts
+++ b/test/e2e/commands/builds/lifecycle.test.ts
@@ -112,6 +112,26 @@ describe('[e2e][api] builds namespace', () => {
 		});
 	});
 
+	describe('builds abort', () => {
+		it('fails with invalid build ID', async () => {
+			const result = await runCli('apify', ['builds', 'abort', 'invalid-id'], {
+				cwd: actor.dir,
+				env: authEnv,
+			});
+
+			expect(result.stdout).toContain('Build with ID "invalid-id" was not found');
+		});
+
+		it('fails for an already finished build', async () => {
+			const result = await runCli('apify', ['builds', 'abort', buildId], {
+				cwd: actor.dir,
+				env: authEnv,
+			});
+
+			expect(result.stdout).toMatch(/cannot be aborted|already aborted/i);
+		});
+	});
+
 	describe('builds info', () => {
 		it('fails with invalid build ID', async () => {
 			const result = await runCli('apify', ['builds', 'info', 'invalid-id'], {
@@ -160,7 +180,7 @@ describe('[e2e][api] builds namespace', () => {
 			});
 
 			expect(result.exitCode, `stderr: ${result.stderr}`).toBe(0);
-			expect(result.stderr).toContain('Log for build with ID');
+			expect(result.stdout).toContain('Log for build with ID');
 		});
 
 		it('fails with invalid build ID', async () => {
@@ -170,6 +190,7 @@ describe('[e2e][api] builds namespace', () => {
 			});
 
 			expect(result.exitCode).not.toBe(0);
+			expect(result.stdout).toContain('Build with ID "invalid-id" was not found');
 		});
 	});
 
diff --git a/test/e2e/commands/datasets/lifecycle.test.ts b/test/e2e/commands/datasets/lifecycle.test.ts
index b0b2deecf..cfc3f415f 100644
--- a/test/e2e/commands/datasets/lifecycle.test.ts
+++ b/test/e2e/commands/datasets/lifecycle.test.ts
@@ -99,6 +99,32 @@ describe('[e2e][api] datasets namespace', () => {
 		expect(result.stdout).toContain(',');
 	});
 
+	it('gets items with --fields and --clean', async () => {
+		const result = await runCli(
+			'apify',
+			['datasets', 'get-items', datasetId, '--fields', 'foo', '--clean', '--limit', '10'],
+			{ env: authEnv },
+		);
+		expect(result.exitCode).toBe(0);
+		const items = JSON.parse(result.stdout);
+		expect(Array.isArray(items)).toBe(true);
+		for (const item of items) {
+			expect(Object.keys(item)).toEqual(['foo']);
+		}
+	});
+
+	it('writes items to --output file', async () => {
+		const outPath = `/tmp/e2e-ds-out-${randomBytes(4).toString('hex')}.json`;
+		const result = await runCli('apify', ['datasets', 'get-items', datasetId, '--output', outPath], {
+			env: authEnv,
+		});
+		expect(result.exitCode).toBe(0);
+		const { readFileSync } = await import('node:fs');
+		const items = JSON.parse(readFileSync(outPath, 'utf8'));
+		expect(Array.isArray(items)).toBe(true);
+		expect(items.length).toBeGreaterThanOrEqual(3);
+	});
+
 	it('shows dataset info (--json)', async () => {
 		const result = await runCli('apify', ['datasets', 'info', datasetId, '--json'], { env: authEnv });
 		expect(result.exitCode).toBe(0);
diff --git a/test/e2e/commands/runs/lifecycle.test.ts b/test/e2e/commands/runs/lifecycle.test.ts
index aa99a05ad..4eb85204c 100644
--- a/test/e2e/commands/runs/lifecycle.test.ts
+++ b/test/e2e/commands/runs/lifecycle.test.ts
@@ -81,6 +81,20 @@ describe('[e2e][api] runs lifecycle', () => {
 		expect(found).toBe(true);
 	});
 
+	it('runs ls --status — filters runs by status', async () => {
+		const result = await runCli('apify', ['runs', 'ls', actorFullName, '--status', 'READY', '--json'], {
+			cwd: actor.dir,
+			env: authEnv,
+		});
+
+		expect(result.exitCode, `stderr: ${result.stderr}`).toBe(0);
+		const data = JSON.parse(result.stdout);
+		expect(data).toHaveProperty('items');
+		for (const item of data.items) {
+			expect(item.status).toBe('READY');
+		}
+	});
+
 	it('runs info — shows run details', async () => {
 		await client.run(runId).waitForFinish();
 
diff --git a/test/local/storage-size.test.ts b/test/local/storage-size.test.ts
new file mode 100644
index 000000000..d7fdb4f9f
--- /dev/null
+++ b/test/local/storage-size.test.ts
@@ -0,0 +1,26 @@
+import { describe, expect, it } from 'vitest';
+
+import { getUserPlanPricing } from '../../../src/lib/commands/storage-size.js';
+
+describe('getUserPlanPricing', () => {
+	it('exposes distinct dataset and key-value store storage rates', () => {
+		const pricing = getUserPlanPricing({
+			id: 'FREE',
+			planPricing: {
+				chargeableServiceUnitPricesUsd: {
+					DATASET_TIMED_STORAGE_GBYTE_HOURS: 0.0002,
+					KEY_VALUE_STORE_TIMED_STORAGE_GBYTE_HOURS: 0.0004,
+				},
+			},
+		} as never);
+
+		expect(pricing).not.toBeNull();
+		expect(pricing!.DATASET_TIMED_STORAGE_GBYTE_HOURS).toBe(0.0002);
+		expect(pricing!.KEY_VALUE_STORE_TIMED_STORAGE_GBYTE_HOURS).toBe(0.0004);
+		expect(pricing!.DATASET_TIMED_STORAGE_GBYTE_HOURS).not.toBe(pricing!.KEY_VALUE_STORE_TIMED_STORAGE_GBYTE_HOURS);
+	});
+
+	it('returns null when plan pricing is missing', () => {
+		expect(getUserPlanPricing({ id: 'FREE' } as never)).toBeNull();
+	});
+});

From 1a5051015f2235e5f0c46c93e2248a4b2451cbce Mon Sep 17 00:00:00 2001
From: Ayush7614 <ayushknj3@gmail.com>
Date: Thu, 30 Jul 2026 19:54:29 +0530
Subject: [PATCH 2/3] test: fix storage-size unit test import path

---
 test/local/storage-size.test.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/test/local/storage-size.test.ts b/test/local/storage-size.test.ts
index d7fdb4f9f..3bcfa413b 100644
--- a/test/local/storage-size.test.ts
+++ b/test/local/storage-size.test.ts
@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest';
 
-import { getUserPlanPricing } from '../../../src/lib/commands/storage-size.js';
+import { getUserPlanPricing } from '../../src/lib/commands/storage-size.js';
 
 describe('getUserPlanPricing', () => {
 	it('exposes distinct dataset and key-value store storage rates', () => {

From c84554c28a584f8bea5a38085d378547e785061a Mon Sep 17 00:00:00 2001
From: Ayush7614 <ayushknj3@gmail.com>
Date: Fri, 31 Jul 2026 01:03:57 +0530
Subject: [PATCH 3/3] fix(builds): set non-zero exit code on log failures

---
 src/commands/builds/log.ts | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/src/commands/builds/log.ts b/src/commands/builds/log.ts
index 082b086c2..f60ca3bd5 100644
--- a/src/commands/builds/log.ts
+++ b/src/commands/builds/log.ts
@@ -1,3 +1,5 @@
+import process from 'node:process';
+
 import { ApifyCommand } from '../../lib/command-framework/apify-command.js';
 import { Args } from '../../lib/command-framework/args.js';
 import { error, info } from '../../lib/outputs.js';
@@ -33,6 +35,7 @@ export class BuildsLogCommand extends ApifyCommand<typeof BuildsLogCommand> {
 
 		if (!build) {
 			error({ message: `Build with ID "${buildId}" was not found on your account.`, stdout: true });
+			process.exitCode = 1;
 			return;
 		}
 
@@ -41,7 +44,11 @@ export class BuildsLogCommand extends ApifyCommand<typeof BuildsLogCommand> {
 		try {
 			await outputJobLog({ job: build, apifyClient });
 		} catch (err) {
-			error({ message: `Failed to get log for build with ID "${buildId}": ${(err as Error).message}` });
+			error({
+				message: `Failed to get log for build with ID "${buildId}": ${(err as Error).message}`,
+				stdout: true,
+			});
+			process.exitCode = 1;
 		}
 	}
 }