checkly 8.7.0 → 8.8.0-prerelease-e12e48f

package/dist/ai-context/context.d.ts

@@ -43,10 +43,10 @@ export declare const REFERENCES: readonly [{
 }];
 export declare const INVESTIGATE_REFERENCES: readonly [{
     readonly id: "investigate-checks";
-    readonly description: "Inspecting checks (`checks list`, `checks get`) and triggering on-demand runs";
+    readonly description: "Inspect checks (`checks list`, `checks get`), retry attempts, result assets, and trigger on-demand runs";
 }, {
     readonly id: "investigate-test-sessions";
-    readonly description: "Run and inspect recorded test sessions, drill into test-session error groups, run RCA, and retrieve result assets";
+    readonly description: "Run and inspect recorded test sessions, drill into test-session error groups, run RCA, and list/download result assets";
 }];
 export declare const COMMUNICATE_REFERENCES: readonly [{
     readonly id: "communicate-incidents";
@@ -114,13 +114,13 @@ export declare const ACTIONS: readonly [{
     }];
 }, {
     readonly id: "investigate";
-    readonly description: "Access check and test-session status, analyze failures, and investigate errors.";
+    readonly description: "Access check and test-session status, analyze failures, inspect attempts/assets, and investigate errors.";
     readonly references: readonly [{
         readonly id: "investigate-checks";
-        readonly description: "Inspecting checks (`checks list`, `checks get`) and triggering on-demand runs";
+        readonly description: "Inspect checks (`checks list`, `checks get`), retry attempts, result assets, and trigger on-demand runs";
     }, {
         readonly id: "investigate-test-sessions";
-        readonly description: "Run and inspect recorded test sessions, drill into test-session error groups, run RCA, and retrieve result assets";
+        readonly description: "Run and inspect recorded test sessions, drill into test-session error groups, run RCA, and list/download result assets";
     }];
 }, {
     readonly id: "communicate";

package/dist/ai-context/context.js

@@ -59,11 +59,11 @@ export const REFERENCES = [
 export const INVESTIGATE_REFERENCES = [
     {
         id: 'investigate-checks',
-        description: 'Inspecting checks (`checks list`, `checks get`) and triggering on-demand runs',
+        description: 'Inspect checks (`checks list`, `checks get`), retry attempts, result assets, and trigger on-demand runs',
     },
     {
         id: 'investigate-test-sessions',
-        description: 'Run and inspect recorded test sessions, drill into test-session error groups, run RCA, and retrieve result assets',
+        description: 'Run and inspect recorded test sessions, drill into test-session error groups, run RCA, and list/download result assets',
     },
 ];
 export const COMMUNICATE_REFERENCES = [
@@ -98,7 +98,7 @@ export const ACTIONS = [
     },
     {
         id: 'investigate',
-        description: 'Access check and test-session status, analyze failures, and investigate errors.',
+        description: 'Access check and test-session status, analyze failures, inspect attempts/assets, and investigate errors.',
         references: INVESTIGATE_REFERENCES,
     },
     {

package/dist/ai-context/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/ai-context/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/ai-context/context.ts"],"names":[],"mappings":"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"}

package/dist/ai-context/public-skills/checkly/SKILL.md

@@ -103,7 +103,7 @@ Learn how to initialize and set up a new Checkly CLI project from scratch.
 Learn how to create and manage monitoring checks using Checkly constructs and the CLI.
 
 ### `npx checkly skills investigate`
-Access check and test-session status, analyze failures, and investigate errors.
+Access check and test-session status, analyze failures, inspect attempts/assets, and investigate errors.
 
 ### `npx checkly skills communicate`
 Open incidents and lead customer communications via status pages.

package/dist/ai-context/skills-command/references/investigate-checks.md

@@ -32,6 +32,7 @@ Shows check configuration, recent results, error groups, and analytics stats.
 
 Flags:
 - `-r, --result <result-id>` — drill into a specific result (see below)
+- `--include-attempts` — with `--result`, also list the individual retry attempts for that result (see below)
 - `-e, --error-group <error-group-id>` — show full details for a specific error group
 - `--results-limit <n>` — number of recent results to show (default 10)
 - `--results-cursor <cursor>` — paginate results using the cursor from previous output
@@ -47,8 +48,76 @@ Flags:
 
 ```bash
 npx checkly checks get <check-id> --result <result-id>
+npx checkly checks get <check-id> --result <result-id> --output json
 ```
 
+### View retry attempts for a result
+
+When a check has retries enabled, a single run produces one `FINAL` result plus
+one `ATTEMPT` result for each earlier failed try (all sharing a `sequenceId`).
+By default only the `FINAL` result is shown. Add `--include-attempts` to list the
+full retry sequence — attempt number, status, location, duration, and a short
+error summary:
+
+```bash
+npx checkly checks get <check-id> --result <result-id> --include-attempts
+npx checkly checks get <check-id> --result <result-id> --include-attempts --output json
+```
+
+With `--include-attempts --output json`, the command returns a stable envelope:
+
+```json
+{
+  "result": {},
+  "attempts": []
+}
+```
+
+Use the `attempts` array to inspect intermediate retry failures. Use the `result`
+object for the requested result row.
+
+### List or download result assets
+
+Result detail output summarizes available screenshots, traces, and videos when
+present. Use the dedicated asset manifest commands to inspect exact asset names
+and download files:
+
+```bash
+npx checkly assets list --check-id <check-id> --result-id <result-id>
+npx checkly assets list --check-id <check-id> --result-id <result-id> --type trace --view tree
+npx checkly assets list --check-id <check-id> --result-id <result-id> --output json
+npx checkly assets download --check-id <check-id> --result-id <result-id> --asset "<Asset>"
+npx checkly assets download --check-id <check-id> --result-id <result-id> --type all --dir ./checkly-assets
+```
+
+Run `assets list` first to discover available files. The default table output
+has an `Asset` column; copy that value into `--asset` for single-file downloads.
+
+Flags:
+- `--type <type>` - filter/select by `log`, `trace`, `video`, `screenshot`, `pcap`, `report`, `file`, or `all`.
+- `--asset <value>` - exact Asset/Name value or glob. Prefer copying the `Asset` value from the default table output before downloading a single file.
+- `--dir <path>` - destination directory for downloads; defaults under `./checkly-assets/`.
+- `--force` / `--skip-existing` - overwrite or preserve existing files.
+
+`assets list --output json` uses a stable list envelope:
+
+```json
+{
+  "data": [],
+  "pagination": {
+    "length": 0
+  }
+}
+```
+
+`assets download` requires `--type` or `--asset` unless the manifest is a single
+archive bundle. Archive entries download as their containing archive; filters
+narrow the manifest list, not the archive bytes.
+
+Do not invent asset names or assume every result has the same artifact set. Some
+results have screenshots only, some have traces or videos, and some have no
+downloadable assets.
+
 ### View an error group
 
 ```bash

package/dist/ai-context/skills-command/references/investigate-test-sessions.md

@@ -78,7 +78,7 @@ Flags:
 
 The detail view shows the session status, metadata, result rows, test-session result IDs, check IDs when available, and test-session error group IDs. Prefer `--watch` before investigating failures so you do not act on partial results.
 
-Use `--output json` when you need exact fields, result links, or asset URLs. For Playwright Check Suite results, inspect result payload fields such as Playwright result details, traces, videos, screenshots, reports, and links when present.
+Use `--output json` when you need exact fields, result links, check IDs, or test-session result IDs. For downloadable logs, traces, videos, screenshots, reports, and files, use `checkly assets list` and `checkly assets download` with the test session ID and result ID.
 
 ## Inspect a test-session error group
 
@@ -116,13 +116,50 @@ If RCA is unavailable because of plan or entitlement limits, run `npx checkly ac
 
 ## Retrieve result assets
 
-There is no dedicated `test-sessions download` command. Use the JSON outputs and links exposed by the session or result payload.
+Use the asset manifest commands for recorded test-session result files. Start
+from `test-sessions get` to identify the `testSessionResultId` (and `checkId`
+when available) for the row you want to inspect.
 
 ```bash
 npx checkly test-sessions get <test-session-id> --output json
-npx checkly checks get <check-id> --result <test-session-result-id> --output json
+npx checkly assets list --test-session-id <test-session-id> --result-id <test-session-result-id>
+npx checkly assets list --test-session-id <test-session-id> --result-id <test-session-result-id> --type trace --view tree
+npx checkly assets list --test-session-id <test-session-id> --result-id <test-session-result-id> --output json
+npx checkly assets download --test-session-id <test-session-id> --result-id <test-session-result-id> --asset "<Asset>"
+npx checkly assets download --test-session-id <test-session-id> --result-id <test-session-result-id> --type all --dir ./checkly-assets
 ```
 
-Use `test-sessions get --output json` first. If a result includes public URLs or asset fields, download those URLs directly. If a result only gives `checkId` plus `testSessionResultId`, use `checks get <check-id> --result <test-session-result-id> --output json` to fetch detailed result data; terminal output summarizes available screenshots, traces, and videos, while JSON output exposes the underlying URLs/fields.
+Run `assets list` first to discover available files. The default table output
+has an `Asset` column; copy that value into `--asset` for single-file downloads.
 
-Do not invent asset names or assume every result has the same artifact set. Some results have screenshots only, some have traces or videos, and some have no downloadable assets.
+Flags:
+- `--type <type>` - filter/select by `log`, `trace`, `video`, `screenshot`, `pcap`, `report`, `file`, or `all`.
+- `--asset <value>` - exact Asset/Name value or glob. Prefer copying the `Asset` value from `assets list --view table` for single-file downloads.
+- `--dir <path>` - destination directory for downloads; defaults under `./checkly-assets/`.
+- `--force` / `--skip-existing` - overwrite or preserve existing files.
+
+`assets list --output json` uses a stable list envelope:
+
+```json
+{
+  "data": [],
+  "pagination": {
+    "length": 0
+  }
+}
+```
+
+`assets download` requires `--type` or `--asset` unless the manifest is a single
+archive bundle. Archive entries download as their containing archive; filters
+narrow the manifest list, not the archive bytes.
+
+If you also need the scheduled check result view for the same row, and the row
+has a `checkId`, use:
+
+```bash
+npx checkly checks get <check-id> --result <test-session-result-id>
+```
+
+Do not invent asset names or assume every result has the same artifact set. Some
+results have screenshots only, some have traces or videos, and some have no
+downloadable assets.

package/dist/ai-context/skills-command/references/investigate.md

@@ -9,7 +9,7 @@ Read-only commands execute immediately without confirmation.
 Parse and read further reference documentation when tasked with investigating any of the following:
 
 ### `npx checkly skills investigate checks`
-Inspecting checks (`checks list`, `checks get`) and triggering on-demand runs
+Inspect checks (`checks list`, `checks get`), retry attempts, result assets, and trigger on-demand runs
 
 ### `npx checkly skills investigate test-sessions`
-Run and inspect recorded test sessions, drill into test-session error groups, run RCA, and retrieve result assets
+Run and inspect recorded test sessions, drill into test-session error groups, run RCA, and list/download result assets

package/dist/commands/assets/download.d.ts

@@ -0,0 +1,19 @@
+import { AuthCommand } from '../authCommand.js';
+export default class AssetsDownload extends AuthCommand {
+    static hidden: boolean;
+    static readOnly: boolean;
+    static idempotent: boolean;
+    static description: string;
+    static flags: {
+        'check-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'test-session-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'result-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        asset: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        dir: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'skip-existing': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/assets/download.js

@@ -0,0 +1,170 @@
+import { Flags } from '@oclif/core';
+import path from 'node:path';
+import { AuthCommand } from '../authCommand.js';
+import { outputFlag } from '../../helpers/flags.js';
+import { assetSelectorValue, formatDownloadedAssets } from '../../formatters/assets.js';
+import { assertManifestSupportsDownload, archiveBundleAssets, assetManifestFiltersFromSelection, assetTypeSelectionFromFlag, assetTypes, defaultDownloadDirectory, destinationPathForAsset, downloadAssetToFile, fetchAssetManifest, hasArchiveEntries, isSingleArchiveBundle, resolveAssetSource, selectAssets, } from '../../helpers/result-assets.js';
+export default class AssetsDownload extends AuthCommand {
+    static hidden = false;
+    static readOnly = true;
+    static idempotent = true;
+    static description = 'Download result assets.';
+    static flags = {
+        'check-id': Flags.string({
+            description: 'Check ID for a scheduled check result.',
+        }),
+        'test-session-id': Flags.string({
+            description: 'Test session ID for a test-session result.',
+        }),
+        'result-id': Flags.string({
+            description: 'Check result ID or test-session result ID.',
+            required: true,
+        }),
+        'type': Flags.string({
+            description: 'Select assets by type.',
+            options: assetTypes,
+        }),
+        'asset': Flags.string({
+            description: 'Select an asset by exact Asset/Name value or glob.',
+        }),
+        'dir': Flags.string({
+            description: 'Directory to write assets into.',
+        }),
+        'force': Flags.boolean({
+            description: 'Overwrite existing files.',
+            default: false,
+        }),
+        'skip-existing': Flags.boolean({
+            description: 'Skip files that already exist.',
+            default: false,
+        }),
+        'output': outputFlag({ default: 'table', options: ['table', 'json'] }),
+    };
+    async run() {
+        const { flags } = await this.parse(AssetsDownload);
+        this.style.outputFormat = flags.output;
+        const source = resolveAssetSource(flags);
+        const type = assetTypeSelectionFromFlag(flags.type);
+        const showProgress = flags.output !== 'json' && this.fancy && process.stdout.isTTY;
+        let progressStarted = false;
+        const startProgress = (message) => {
+            if (!showProgress)
+                return;
+            this.style.actionStart(message);
+            progressStarted = true;
+        };
+        const setProgress = (message) => {
+            if (!showProgress || !progressStarted)
+                return;
+            this.style.actionStatus(message);
+        };
+        const stopProgress = (success) => {
+            if (!showProgress || !progressStarted)
+                return;
+            if (success) {
+                this.style.actionSuccess();
+            }
+            else {
+                this.style.actionFailure();
+            }
+            progressStarted = false;
+        };
+        if (flags.force && flags['skip-existing']) {
+            throw new Error('--force and --skip-existing are mutually exclusive.');
+        }
+        try {
+            startProgress('Fetching asset manifest');
+            const filters = assetManifestFiltersFromSelection({
+                type,
+                asset: flags.asset,
+            });
+            const manifest = await fetchAssetManifest(source, filters);
+            assertManifestSupportsDownload(manifest, filters);
+            const assets = selectAssets(manifest.assets, {
+                type,
+                asset: flags.asset,
+            });
+            const hasSelector = Boolean(flags.type || flags.asset);
+            if (!hasSelector && !isSingleArchiveBundle(assets)) {
+                throw new Error('Pass --type or --asset to select assets. Use --type all to download all assets.');
+            }
+            if (assets.length === 0) {
+                stopProgress(true);
+                if (flags.output === 'json') {
+                    this.log(JSON.stringify({ source, directory: null, files: [], warnings: [] }, null, 2));
+                    return;
+                }
+                this.log('No matching assets found.');
+                return;
+            }
+            const directory = path.resolve(flags.dir ?? defaultDownloadDirectory(source));
+            const rows = [];
+            const directAssets = assets.filter(asset => !asset.archive);
+            const archiveAssets = archiveBundleAssets(assets);
+            const downloadTargets = [
+                ...directAssets.map(asset => ({ asset, displayType: undefined })),
+                ...archiveAssets.map(asset => ({ asset, displayType: 'archive' })),
+            ];
+            const warnings = [];
+            if (hasArchiveEntries(assets)) {
+                warnings.push('Selected assets include archive entries. Downloading the containing archive file; filters narrow the manifest list, not the archive bytes.');
+            }
+            for (const [index, target] of downloadTargets.entries()) {
+                const { asset, displayType } = target;
+                const filePath = destinationPathForAsset(directory, asset);
+                const label = `${index + 1}/${downloadTargets.length} ${displayType ?? asset.type} ${assetSelectorValue(asset)}`;
+                let lastProgressUpdate = 0;
+                setProgress(`Downloading ${label}`);
+                const status = await downloadAssetToFile(asset, filePath, {
+                    force: flags.force,
+                    skipExisting: flags['skip-existing'],
+                    onProgress: showProgress
+                        ? ({ downloadedBytes, totalBytes }) => {
+                            const now = Date.now();
+                            if (now - lastProgressUpdate < 250)
+                                return;
+                            lastProgressUpdate = now;
+                            setProgress(`Downloading ${label} ${formatDownloadBytes(downloadedBytes, totalBytes)}`);
+                        }
+                        : undefined,
+                });
+                setProgress(status === 'skipped' ? `Skipped ${label}` : `Downloaded ${label}`);
+                rows.push({ status, path: filePath, asset, displayType });
+            }
+            stopProgress(true);
+            if (flags.output === 'json') {
+                this.log(JSON.stringify({ source, directory, files: rows, warnings }, null, 2));
+                return;
+            }
+            const output = [
+                ...warnings.map(warning => `Warning: ${warning}`),
+                formatDownloadedAssets(rows),
+            ].filter(Boolean);
+            this.log(output.join('\n\n'));
+        }
+        catch (err) {
+            stopProgress(false);
+            this.style.longError('Failed to download assets.', err);
+            process.exitCode = 1;
+        }
+    }
+}
+function formatDownloadBytes(downloadedBytes, totalBytes) {
+    if (totalBytes === undefined)
+        return formatBytes(downloadedBytes);
+    return `${formatBytes(downloadedBytes)} / ${formatBytes(totalBytes)}`;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const units = ['KB', 'MB', 'GB', 'TB'];
+    let value = bytes / 1024;
+    let unitIndex = 0;
+    while (value >= 1024 && unitIndex < units.length - 1) {
+        value /= 1024;
+        unitIndex += 1;
+    }
+    const rounded = value >= 10 ? value.toFixed(1) : value.toFixed(2);
+    return `${rounded} ${units[unitIndex]}`;
+}
+//# sourceMappingURL=download.js.map

package/dist/commands/assets/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../src/commands/assets/download.ts"],"names":[],"mappings":"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"}

package/dist/commands/assets/list.d.ts

@@ -0,0 +1,17 @@
+import { AuthCommand } from '../authCommand.js';
+export default class AssetsList extends AuthCommand {
+    static hidden: boolean;
+    static readOnly: boolean;
+    static idempotent: boolean;
+    static description: string;
+    static flags: {
+        'check-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'test-session-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'result-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        asset: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        view: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/assets/list.js

@@ -0,0 +1,107 @@
+import { Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { AuthCommand } from '../authCommand.js';
+import { outputFlag } from '../../helpers/flags.js';
+import { formatAssetListHeader, formatAssetListNextSteps, formatAssetManifestEntries, formatAssetManifestTree, } from '../../formatters/assets.js';
+import { assetManifestFiltersFromSelection, assetTypeSelectionFromFlag, assetTypes, fetchAssetManifest, filterAssetsBySelector, filterAssetsByType, resolveAssetSource, } from '../../helpers/result-assets.js';
+export default class AssetsList extends AuthCommand {
+    static hidden = false;
+    static readOnly = true;
+    static idempotent = true;
+    static description = 'List result assets.';
+    static flags = {
+        'check-id': Flags.string({
+            description: 'Check ID for a scheduled check result.',
+        }),
+        'test-session-id': Flags.string({
+            description: 'Test session ID for a test-session result.',
+        }),
+        'result-id': Flags.string({
+            description: 'Check result ID or test-session result ID.',
+            required: true,
+        }),
+        'type': Flags.string({
+            description: 'Filter assets by type.',
+            options: assetTypes,
+            default: 'all',
+        }),
+        'asset': Flags.string({
+            description: 'Filter assets by exact Asset/Name value or glob.',
+        }),
+        'view': Flags.string({
+            description: 'Human output view. Ignored with --output json.',
+            options: ['table', 'tree'],
+            default: 'table',
+        }),
+        'output': outputFlag({ default: 'table' }),
+    };
+    async run() {
+        const { flags } = await this.parse(AssetsList);
+        this.style.outputFormat = flags.output;
+        const source = resolveAssetSource(flags);
+        const type = assetTypeSelectionFromFlag(flags.type);
+        try {
+            const filters = assetManifestFiltersFromSelection({
+                type,
+                asset: flags.asset,
+            });
+            const manifest = await fetchAssetManifest(source, filters);
+            const assets = filterAssetsBySelector(filterAssetsByType(manifest.assets, type), flags.asset);
+            if (flags.output === 'json') {
+                this.log(JSON.stringify({
+                    data: assets,
+                    pagination: {
+                        length: assets.length,
+                    },
+                }, null, 2));
+                return;
+            }
+            const fmt = flags.output === 'md' ? 'md' : 'terminal';
+            const output = [];
+            output.push(formatAssetListHeader({
+                sourceType: source.kind,
+                checkId: source.kind === 'check-result' ? source.checkId : undefined,
+                testSessionId: source.kind === 'test-session-result' ? source.testSessionId : undefined,
+                resultId: source.resultId,
+                type,
+                asset: flags.asset,
+            }, assets, fmt));
+            output.push('');
+            if (assets.length === 0) {
+                output.push('No assets found.');
+            }
+            else if (flags.view === 'tree') {
+                output.push(formatAssetManifestTree(assets, fmt));
+                output.push('');
+                output.push(chalk.dim('Tip: use --view table to copy exact Asset values for download.'));
+            }
+            else {
+                output.push(formatAssetManifestEntries(assets, fmt));
+            }
+            const nextSteps = formatAssetListNextSteps({
+                sourceType: source.kind,
+                checkId: source.kind === 'check-result' ? source.checkId : undefined,
+                testSessionId: source.kind === 'test-session-result' ? source.testSessionId : undefined,
+                resultId: source.resultId,
+                type,
+                asset: flags.asset,
+            }, assets, fmt);
+            if (nextSteps) {
+                output.push('');
+                output.push(nextSteps);
+            }
+            if (manifest.truncated) {
+                const returned = manifest.entriesReturned ?? manifest.assets.length;
+                const total = manifest.entriesTotal == null ? 'unknown' : String(manifest.entriesTotal);
+                output.push('');
+                output.push(chalk.yellow(`Warning: asset manifest is truncated (${returned} of ${total} entries returned).`));
+            }
+            this.log(output.join('\n'));
+        }
+        catch (err) {
+            this.style.longError('Failed to list assets.', err);
+            process.exitCode = 1;
+        }
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/assets/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/assets/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAEnD,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,iCAAiC,EACjC,0BAA0B,EAC1B,UAAU,EACV,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,gCAAgC,CAAA;AAEvC,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,MAAM,CAAC,MAAM,GAAG,KAAK,CAAA;IACrB,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAA;IACtB,MAAM,CAAC,UAAU,GAAG,IAAI,CAAA;IACxB,MAAM,CAAC,WAAW,GAAG,qBAAqB,CAAA;IAE1C,MAAM,CAAC,KAAK,GAAG;QACb,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC;YACvB,WAAW,EAAE,wCAAwC;SACtD,CAAC;QACF,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC;YAC9B,WAAW,EAAE,4CAA4C;SAC1D,CAAC;QACF,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC;YACxB,WAAW,EAAE,4CAA4C;YACzD,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,wBAAwB;YACrC,OAAO,EAAE,UAAU;YACnB,OAAO,EAAE,KAAK;SACf,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,kDAAkD;SAChE,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,gDAAgD;YAC7D,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;YAC1B,OAAO,EAAE,OAAO;SACjB,CAAC;QACF,QAAQ,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;KAC3C,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;QAC9C,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,MAAM,CAAA;QACtC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;QACxC,MAAM,IAAI,GAAG,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAEnD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,iCAAiC,CAAC;gBAChD,IAAI;gBACJ,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC,CAAA;YACF,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;YAC1D,MAAM,MAAM,GAAG,sBAAsB,CACnC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,EACzC,KAAK,CAAC,KAAK,CACZ,CAAA;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC5B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;oBACtB,IAAI,EAAE,MAAM;oBACZ,UAAU,EAAE;wBACV,MAAM,EAAE,MAAM,CAAC,MAAM;qBACtB;iBACF,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;gBACZ,OAAM;YACR,CAAC;YAED,MAAM,GAAG,GAAiB,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAA;YACnE,MAAM,MAAM,GAAa,EAAE,CAAA;YAE3B,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC;gBAChC,UAAU,EAAE,MAAM,CAAC,IAAI;gBACvB,OAAO,EAAE,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBACpE,aAAa,EAAE,MAAM,CAAC,IAAI,KAAK,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;gBACvF,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,IAAI;gBACJ,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;YAChB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAEf,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;YACjC,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;gBACjD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC,CAAA;YAC1F,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;YACtD,CAAC;YAED,MAAM,SAAS,GAAG,wBAAwB,CAAC;gBACzC,UAAU,EAAE,MAAM,CAAC,IAAI;gBACvB,OAAO,EAAE,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBACpE,aAAa,EAAE,MAAM,CAAC,IAAI,KAAK,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;gBACvF,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,IAAI;gBACJ,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;YACf,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBACf,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACxB,CAAC;YAED,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACvB,MAAM,QAAQ,GAAG,QAAQ,CAAC,eAAe,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAA;gBACnE,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;gBACvF,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,yCAAyC,QAAQ,OAAO,KAAK,qBAAqB,CAAC,CAAC,CAAA;YAC/G,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QAC7B,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAA;YACnD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;QACtB,CAAC;IACH,CAAC"}

package/dist/commands/checks/delete.d.ts

@@ -0,0 +1,15 @@
+import { AuthCommand } from '../authCommand.js';
+export default class ChecksDelete extends AuthCommand {
+    static hidden: boolean;
+    static destructive: boolean;
+    static idempotent: boolean;
+    static description: string;
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}