checkly 8.2.0 → 8.3.0

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

@@ -1,6 +1,6 @@
 ---
 name: checkly
-description: Set up, create, test and manage monitoring checks using the Checkly CLI. Use when working with Agentic Checks, API Checks, Browser Checks, URL Monitors, ICMP Monitors, Playwright Check Suites, Heartbeat Monitors, Alert Channels, Dashboards, or Status Pages. Access Checkly account plan, entitlements, feature limits, members, and pending invites.
+description: Set up, create, test and manage monitoring checks using the Checkly CLI. Use when working with Agentic Checks, API Checks, Browser Checks, URL Monitors, ICMP Monitors, Playwright Check Suites, Heartbeat Monitors, Alert Channels, Dashboards, or Status Pages. Access Checkly account plan, entitlements, feature limits, members, and pending invites. Includes generic API pass-through (`checkly api`) for endpoints without dedicated commands.
 allowed-tools: Bash(npx:checkly:*) Bash(npm:install:*)
 metadata:
   author: checkly
@@ -36,6 +36,64 @@ Write commands (e.g. `incidents create`, `deploy`, `destroy`) return exit code 2
 
 Run `npx checkly skills communicate` for the full protocol details.
 
+## API Pass-Through (fallback for any endpoint)
+
+When no dedicated CLI command exists for an endpoint, use `npx checkly api` to make authenticated requests directly. The CLI handles auth headers and base URL automatically.
+
+```bash
+npx checkly api /v1/checks
+npx checkly api /v1/dashboards -X GET --jq '.[].name'
+npx checkly api /v1/checks -X POST -F name=MyCheck -F activated:=true
+npx checkly api /v1/checks -X GET -F limit=5
+```
+
+Key flags: `-X` (method), `-F` (field — `key=value` for strings, `key:=value` for JSON), `-H` (header), `--jq` (filter with jq), `--input` (body from file/stdin), `-i` / `--include` (response status + headers on stdout), `--verbose` (request/response headers on stderr).
+
+### Nested payloads
+
+Use `:=` to send structured JSON in a single field:
+
+```bash
+npx checkly api /v1/checks/<id> -X PATCH \
+  -F retryStrategy:='{"type":"LINEAR","maxRetries":2,"baseBackoffSeconds":10}'
+```
+
+For large or deeply nested bodies, pipe a JSON file via `--input`:
+
+```bash
+npx checkly api /v1/checks -X POST --input ./new-check.json
+```
+
+### Pagination
+
+`checkly api` does not auto-walk pages. Drive pagination yourself, the same way every other `checkly` list command exposes it.
+
+When using `-F` on a read endpoint, **always pass `-X GET` explicitly** — any `-F` flag implies POST unless the method is set, so omitting `-X GET` will try to create a resource with your pagination params as the body.
+
+**Detecting which pagination style an endpoint uses.** Make a first request with `-i` (response headers on stdout) and inspect what came back:
+
+- **Page-based** → response has a `content-range` header (e.g. `0-1/23` means items 0–1 of 23 total) and usually a `link` header with `rel="next"` / `rel="last"`. The body is a bare array. Walk by incrementing `-F page=N` until you've covered the total in `content-range`, or until the `rel="next"` link disappears.
+- **Cursor-based** → response body is an envelope like `{ entries: [...], nextId: "...", length: N }`. Pass `-F nextId=<value>` (or `-F cursor=<value>`, depending on the endpoint) on the next call. When `nextId` is missing or null, you've reached the end.
+
+```bash
+# Step 1: make the first call with -i and inspect the response shape
+npx checkly api /v1/checks -X GET -F limit=100 -i
+
+# If you saw a content-range header → page-based, walk with -F page=N
+npx checkly api /v1/checks -X GET -F limit=100 -F page=2 -i
+
+# If the body had a nextId field → cursor-based, walk with -F nextId=<value>
+npx checkly api /v1/status-pages -X GET -F limit=50 -F nextId=<nextIdFromPrevResponse>
+```
+
+### Error responses
+
+On non-2xx, the response body is still written to stdout (read it for the API's error message) and the CLI exits with code 1. A 401 prints an auth hint, a 403 prints a permission hint, and a 404 prints the docs URL — all on stderr.
+
+### Endpoint discovery
+
+See the [Checkly API reference](https://www.checklyhq.com/docs/api) for the human-readable endpoint catalogue, or fetch the [OpenAPI spec](https://api.checklyhq.com/openapi.json) for a machine-readable definition you can grep for paths, parameters, and response shapes.
+
 ### `npx checkly skills initialize`
 Learn how to initialize and set up a new Checkly CLI project from scratch.
 

package/dist/commands/api.d.ts

@@ -0,0 +1,23 @@
+import { AuthCommand } from './authCommand.js';
+export default class Api extends AuthCommand {
+    static hidden: boolean;
+    static readOnly: boolean;
+    static destructive: boolean;
+    static idempotent: boolean;
+    static description: string;
+    static examples: string[];
+    static args: {
+        endpoint: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        method: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        field: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        header: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        jq: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        input: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        include: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private applyJq;
+}

package/dist/commands/api.js

@@ -0,0 +1,205 @@
+import { Args, Flags } from '@oclif/core';
+import { execFile } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { AuthCommand } from './authCommand.js';
+import { api } from '../rest/api.js';
+import { parseFields } from '../helpers/api-fields.js';
+const WRITE_METHODS = new Set(['POST', 'PUT', 'PATCH']);
+export default class Api extends AuthCommand {
+    static hidden = false;
+    static readOnly = false;
+    static destructive = true;
+    static idempotent = false;
+    static description = 'Make an authenticated HTTP request to the Checkly API.\n'
+        + 'Pass-through for any endpoint — handles auth automatically.\n'
+        + 'See https://www.checklyhq.com/docs/api for available endpoints.\n'
+        + 'OpenAPI spec: https://api.checklyhq.com/openapi.json';
+    static examples = [
+        'checkly api /v1/checks',
+        'checkly api /v1/checks -X GET --jq \'.[].name\'',
+        'checkly api /v1/checks -X POST -F name=MyCheck -F activated:=true',
+        'checkly api /v1/checks -X GET -F limit=5',
+        'echo \'{"name":"New"}\' | checkly api /v1/checks -X POST --input -',
+    ];
+    static args = {
+        endpoint: Args.string({
+            description: 'API endpoint path (e.g. /v1/checks).',
+            required: true,
+        }),
+    };
+    /* eslint-disable @stylistic/quote-props */
+    static flags = {
+        'method': Flags.string({
+            char: 'X',
+            description: 'HTTP method.',
+            options: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'],
+        }),
+        'field': Flags.string({
+            char: 'F',
+            description: 'Add a field: key=value (string) or key:=value (parsed as JSON).',
+            multiple: true,
+            default: [],
+        }),
+        'header': Flags.string({
+            char: 'H',
+            description: 'Custom HTTP header: "Key: Value".',
+            multiple: true,
+            default: [],
+        }),
+        'jq': Flags.string({
+            description: 'Filter JSON output with a jq expression (requires jq installed).',
+        }),
+        'input': Flags.string({
+            description: 'Request body from file path, or "-" for stdin.',
+        }),
+        'include': Flags.boolean({
+            char: 'i',
+            description: 'Include HTTP status and response headers in the output.',
+            default: false,
+        }),
+        'verbose': Flags.boolean({
+            description: 'Print request and response headers to stderr.',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Api);
+        const hasFields = flags.field.length > 0;
+        const method = (flags.method ?? (hasFields || flags.input ? 'POST' : 'GET')).toUpperCase();
+        if (args.endpoint.startsWith('//') || /^[a-z][a-z\d+\-.]*:/i.test(args.endpoint)) {
+            this.error('Endpoint must be a relative path (e.g. /v1/checks), not a URL.');
+        }
+        const endpoint = args.endpoint.startsWith('/') ? args.endpoint : `/${args.endpoint}`;
+        const baseUrl = api.defaults.baseURL;
+        if (baseUrl) {
+            const resolved = new URL(endpoint, baseUrl);
+            if (resolved.origin !== new URL(baseUrl).origin) {
+                this.error('Endpoint must be a relative path (e.g. /v1/checks), not a URL.');
+            }
+        }
+        const fields = hasFields ? parseFields(flags.field) : undefined;
+        if (flags.input && hasFields) {
+            this.error('Cannot use --input together with -F/--field.');
+        }
+        let data;
+        if (flags.input) {
+            const raw = flags.input === '-' ? await readStdin() : await readFile(flags.input, 'utf-8');
+            try {
+                data = JSON.parse(raw);
+            }
+            catch {
+                data = raw;
+            }
+        }
+        else if (fields && WRITE_METHODS.has(method)) {
+            data = fields;
+        }
+        const params = fields && !WRITE_METHODS.has(method) ? fields : undefined;
+        const customHeaders = {};
+        for (const h of flags.header) {
+            const colonIndex = h.indexOf(':');
+            if (colonIndex === -1) {
+                this.error(`Invalid header format: "${h}". Expected "Key: Value".`);
+            }
+            customHeaders[h.slice(0, colonIndex).trim()] = h.slice(colonIndex + 1).trim();
+        }
+        const requestConfig = {
+            method,
+            url: endpoint,
+            params,
+            data,
+            headers: customHeaders,
+            validateStatus: () => true,
+        };
+        if (flags.verbose) {
+            this.logToStderr(`> ${method} ${endpoint}`);
+            for (const [k, v] of Object.entries(customHeaders)) {
+                this.logToStderr(`> ${k}: ${v}`);
+            }
+            this.logToStderr('');
+        }
+        const response = await api.request(requestConfig);
+        if (flags.verbose) {
+            this.logToStderr(`< ${response.status} ${response.statusText}`);
+            for (const [k, v] of Object.entries(response.headers)) {
+                if (v !== undefined) {
+                    this.logToStderr(`< ${k}: ${v}`);
+                }
+            }
+            this.logToStderr('');
+        }
+        const responseData = response.data;
+        if (flags.include) {
+            this.log(`HTTP/1.1 ${response.status} ${response.statusText}`);
+            for (const [k, v] of Object.entries(response.headers)) {
+                if (v !== undefined) {
+                    this.log(`${k}: ${v}`);
+                }
+            }
+            this.log();
+        }
+        if (responseData === undefined || responseData === null || responseData === '') {
+            if (response.status >= 400) {
+                this.exit(1);
+            }
+            return;
+        }
+        const json = typeof responseData === 'string' ? responseData : formatJson(responseData);
+        if (flags.jq) {
+            await this.applyJq(json, flags.jq);
+        }
+        else {
+            this.log(json);
+        }
+        if (response.status === 404) {
+            this.logToStderr('Endpoint not found. See available endpoints at https://www.checklyhq.com/docs/api');
+        }
+        else if (response.status === 401) {
+            this.logToStderr('Authentication failed — run "checkly login" or set CHECKLY_API_KEY.');
+        }
+        else if (response.status === 403) {
+            this.logToStderr('Permission denied — verify your account role and API key scope.');
+        }
+        if (response.status >= 400) {
+            this.exit(1);
+        }
+    }
+    applyJq(json, filter) {
+        return new Promise((resolve, reject) => {
+            const child = execFile('jq', [filter], { encoding: 'utf-8' }, (error, stdout, stderr) => {
+                if (error) {
+                    if (error.code === 'ENOENT') {
+                        reject(new Error('--jq requires jq to be installed.\n'
+                            + 'Install it from https://jqlang.github.io/jq/'));
+                        return;
+                    }
+                    reject(new Error(`jq failed: ${stderr || error.message}`));
+                    return;
+                }
+                if (stderr) {
+                    this.logToStderr(stderr);
+                }
+                if (stdout) {
+                    this.log(stdout.trimEnd());
+                }
+                resolve();
+            });
+            child.stdin?.write(json);
+            child.stdin?.end();
+        });
+    }
+}
+function formatJson(data) {
+    if (process.stdout.isTTY) {
+        return JSON.stringify(data, null, 2);
+    }
+    return JSON.stringify(data);
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks).toString('utf-8');
+}
+//# sourceMappingURL=api.js.map

package/dist/commands/api.js.map

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

package/dist/commands/test-sessions/get.d.ts

@@ -0,0 +1,17 @@
+import { AuthCommand } from '../authCommand.js';
+export default class TestSessionsGet extends AuthCommand {
+    static hidden: boolean;
+    static readOnly: boolean;
+    static idempotent: boolean;
+    static description: string;
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'error-group': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'error-groups-limit': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'full-error': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/test-sessions/get.js

@@ -0,0 +1,71 @@
+import { Args, Flags } from '@oclif/core';
+import { AuthCommand } from '../authCommand.js';
+import { outputFlag } from '../../helpers/flags.js';
+import * as api from '../../rest/api.js';
+import { formatTestSessionDetail, formatTestSessionErrorGroupDetail, uniqueErrorGroupIds, } from '../../formatters/test-sessions.js';
+export default class TestSessionsGet extends AuthCommand {
+    static hidden = false;
+    static readOnly = true;
+    static idempotent = true;
+    static description = 'Get details of a recorded test session, including result error groups for RCA.';
+    static args = {
+        id: Args.string({
+            description: 'The ID of the test session to retrieve.',
+            required: true,
+        }),
+    };
+    static flags = {
+        'error-group': Flags.string({
+            description: 'Show details for a test session error group ID from this session.',
+        }),
+        'error-groups-limit': Flags.integer({
+            description: 'Number of error group IDs to show in the session summary.',
+            default: 5,
+        }),
+        'full-error': Flags.boolean({
+            description: 'Print the complete raw error when showing a test session error group.',
+            default: false,
+        }),
+        'output': outputFlag({ default: 'detail' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TestSessionsGet);
+        this.style.outputFormat = flags.output;
+        try {
+            const { data: testSession } = await api.testSessions.get(args.id);
+            if (flags['error-group']) {
+                const errorGroupIds = uniqueErrorGroupIds(testSession);
+                if (!errorGroupIds.includes(flags['error-group'])) {
+                    const listCommand = `checkly test-sessions get ${args.id} `
+                        + `--error-groups-limit ${Math.max(5, errorGroupIds.length)}`;
+                    this.style.longError('Test session error group not found in this session.', `Run \`${listCommand}\` to list the available error group IDs.`);
+                    process.exitCode = 1;
+                    return;
+                }
+                const { data: errorGroup } = await api.testSessionErrorGroups.get(flags['error-group']);
+                if (flags.output === 'json') {
+                    this.log(JSON.stringify(errorGroup, null, 2));
+                    return;
+                }
+                const fmt = flags.output === 'md' ? 'md' : 'terminal';
+                this.log(formatTestSessionErrorGroupDetail(errorGroup, fmt, {
+                    fullError: flags['full-error'],
+                }));
+                return;
+            }
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(testSession, null, 2));
+                return;
+            }
+            const fmt = flags.output === 'md' ? 'md' : 'terminal';
+            this.log(formatTestSessionDetail(testSession, fmt, {
+                errorGroupsLimit: flags['error-groups-limit'],
+            }));
+        }
+        catch (err) {
+            this.style.longError('Failed to get test session details.', err);
+            process.exitCode = 1;
+        }
+    }
+}
+//# sourceMappingURL=get.js.map

package/dist/commands/test-sessions/get.js.map

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

package/dist/constructs/slack-app-alert-channel.d.ts

@@ -1,5 +1,11 @@
 import { AlertChannel, AlertChannelProps } from './alert-channel.js';
 export interface SlackAppAlertChannelProps extends AlertChannelProps {
+    /**
+     * List of Slack #channels or @handles to notify.
+     * Private channels require the Checkly app to be invited first.
+     * @example
+     * ['#alerts', '#ops', '@alice']
+     */
     slackChannels: string[];
 }
 /**

package/dist/constructs/slack-app-alert-channel.js.map

@@ -1 +1 @@
-{"version":3,"file":"slack-app-alert-channel.js","sourceRoot":"","sources":["../../src/constructs/slack-app-alert-channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAqB,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAMtC;;;;;;GAMG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD,aAAa,CAAU;IACvB;;;;;;;OAOG;IACH,YAAa,SAAiB,EAAE,KAAgC;QAC9D,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QACvB,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAA;QACxC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;IAED,QAAQ;QACN,OAAO,wBAAwB,IAAI,CAAC,SAAS,EAAE,CAAA;IACjD,CAAC;IAED,UAAU;QACR,OAAO;YACL,GAAG,KAAK,CAAC,UAAU,EAAE;YACrB,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE;gBACN,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC;SACF,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"slack-app-alert-channel.js","sourceRoot":"","sources":["../../src/constructs/slack-app-alert-channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAqB,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAYtC;;;;;;GAMG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD,aAAa,CAAU;IACvB;;;;;;;OAOG;IACH,YAAa,SAAiB,EAAE,KAAgC;QAC9D,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QACvB,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAA;QACxC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;IAED,QAAQ;QACN,OAAO,wBAAwB,IAAI,CAAC,SAAS,EAAE,CAAA;IACjD,CAAC;IAED,UAAU;QACR,OAAO;YACL,GAAG,KAAK,CAAC,UAAU,EAAE;YACrB,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE;gBACN,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC;SACF,CAAA;IACH,CAAC;CACF"}

package/dist/formatters/test-sessions.d.ts

@@ -0,0 +1,15 @@
+import type { TestSessionErrorGroup } from '../rest/test-session-error-groups.js';
+import type { TestSessionDetail } from '../rest/test-sessions.js';
+import { type OutputFormat } from './render.js';
+export interface TestSessionFormatOptions {
+    errorGroupsLimit?: number;
+}
+export interface TestSessionErrorGroupFormatOptions {
+    fullError?: boolean;
+    errorLines?: number;
+}
+export declare function uniqueErrorGroupIds(session: TestSessionDetail): string[];
+export declare function formatTestSessionErrorGroupIds(session: TestSessionDetail, format: OutputFormat, options?: TestSessionFormatOptions): string;
+export declare function formatTestSessionHints(session: TestSessionDetail, format: OutputFormat): string;
+export declare function formatTestSessionErrorGroupDetail(group: TestSessionErrorGroup, format: OutputFormat, options?: TestSessionErrorGroupFormatOptions): string;
+export declare function formatTestSessionDetail(session: TestSessionDetail, format: OutputFormat, options?: TestSessionFormatOptions): string;

package/dist/formatters/test-sessions.js

@@ -0,0 +1,265 @@
+import chalk from 'chalk';
+import { formatCheckType, formatDate, renderDetailFields, renderTable, truncateToWidth, visWidth, } from './render.js';
+const DEFAULT_ERROR_GROUPS_LIMIT = 5;
+const DEFAULT_ERROR_DETAIL_LINES = 80;
+function formatStatus(status, format) {
+    const normalized = status.toLowerCase();
+    if (format === 'md')
+        return normalized;
+    switch (status) {
+        case 'FAILED':
+            return chalk.red(normalized);
+        case 'CANCELLED':
+            return chalk.dim(normalized);
+        case 'RUNNING':
+            return chalk.yellow(normalized);
+        case 'PASSED':
+            return chalk.green(normalized);
+    }
+}
+function formatList(values, format) {
+    if (!values || values.length === 0)
+        return format === 'terminal' ? chalk.dim('-') : '-';
+    return values.join(', ');
+}
+function formatErrorGroupCount(values, format) {
+    if (format === 'md')
+        return formatList(values, format);
+    const count = values?.length ?? 0;
+    if (count === 0)
+        return chalk.dim('-');
+    return `${count} ${count === 1 ? 'group' : 'groups'}`;
+}
+function formatErrorGroupSummary(session, format) {
+    const count = uniqueErrorGroupIds(session).length;
+    if (count === 0)
+        return format === 'terminal' ? chalk.dim('-') : '-';
+    return `${count} ${count === 1 ? 'group' : 'groups'}`;
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    const totalSeconds = Math.round(ms / 1000);
+    const seconds = totalSeconds % 60;
+    const totalMinutes = Math.floor(totalSeconds / 60);
+    if (totalMinutes === 0)
+        return `${seconds}s`;
+    const minutes = totalMinutes % 60;
+    const hours = Math.floor(totalMinutes / 60);
+    if (hours === 0)
+        return seconds === 0 ? `${minutes}m` : `${minutes}m ${seconds}s`;
+    if (minutes === 0 && seconds === 0)
+        return `${hours}h`;
+    if (minutes === 0)
+        return `${hours}h ${seconds}s`;
+    return seconds === 0 ? `${hours}h ${minutes}m` : `${hours}h ${minutes}m ${seconds}s`;
+}
+function formatMetadata(metadata, format) {
+    if (!metadata)
+        return null;
+    const entries = Object.entries(metadata).filter(([, value]) => value != null && value !== '');
+    if (entries.length === 0)
+        return null;
+    const labels = {
+        environment: 'environment',
+        repoUrl: 'repo',
+        commitId: 'commit',
+        commitOwner: 'author',
+        commitMessage: 'message',
+        branchName: 'branch',
+    };
+    const formatted = entries.map(([key, value]) => `${labels[key] ?? key}: ${value}`);
+    return format === 'md' ? formatted.join(', ') : formatted.join('\n');
+}
+const testSessionDetailFields = [
+    { label: 'Status', value: (session, fmt) => formatStatus(session.status, fmt) },
+    { label: 'Started', value: (session, fmt) => formatDate(session.startedAt, fmt) },
+    { label: 'Stopped', value: (session, fmt) => formatDate(session.stoppedAt, fmt) },
+    { label: 'Time elapsed', value: session => formatDuration(session.timeElapsed) },
+    { label: 'Metadata', value: (session, fmt) => formatMetadata(session.metadata, fmt) },
+    { label: 'Session link', value: (session, fmt) => fmt === 'md' ? session.testSessionLink : null },
+    { label: 'Error groups', value: (session, fmt) => formatErrorGroupSummary(session, fmt) },
+    { label: 'ID', value: session => session.testSessionId },
+];
+function buildResultColumns(results, format) {
+    if (format === 'md') {
+        return [
+            { header: 'Result ID', value: result => result.testSessionResultId },
+            { header: 'Check ID', value: result => result.checkId ?? '-' },
+            { header: 'Name', value: result => result.name || '-' },
+            { header: 'Check Type', value: result => formatCheckType(result.checkType) },
+            { header: 'Status', value: (result, fmt) => formatStatus(result.status, fmt) },
+            { header: 'Result Type', value: result => result.resultType ?? '-' },
+            { header: 'Run Location', value: result => result.runLocation ?? '-' },
+            { header: 'Error Groups', value: (result, fmt) => formatList(result.errorGroupIds, fmt) },
+        ];
+    }
+    const termWidth = process.stdout.columns || 120;
+    const showCheckId = termWidth >= 160 && results.some(result => result.checkId);
+    const typeWidth = 14;
+    const statusWidth = 10;
+    const resultTypeWidth = 10;
+    const locationWidth = 14;
+    const errorGroupWidth = 14;
+    const resultIdWidth = showCheckId ? 38 : 0;
+    const checkIdWidth = showCheckId ? 38 : 0;
+    const fixedWidth = typeWidth + statusWidth + resultTypeWidth + locationWidth
+        + errorGroupWidth + resultIdWidth + checkIdWidth;
+    const longestName = Math.max(4, ...results.map(result => visWidth(result.name || '-')));
+    const nameWidth = Math.max(16, Math.min(longestName + 2, termWidth - fixedWidth, 42));
+    const columns = [
+        { header: 'Name', width: nameWidth, value: result => truncateToWidth(result.name || '-', nameWidth - 2) },
+        { header: 'Type', width: typeWidth, value: result => truncateToWidth(formatCheckType(result.checkType), typeWidth - 2) },
+        { header: 'Status', width: statusWidth, value: (result, fmt) => formatStatus(result.status, fmt) },
+        { header: 'Result', width: resultTypeWidth, value: result => result.resultType ? truncateToWidth(result.resultType, resultTypeWidth - 2) : chalk.dim('-') },
+        { header: 'Location', width: locationWidth, value: result => result.runLocation ? truncateToWidth(result.runLocation, locationWidth - 2) : chalk.dim('-') },
+        { header: 'Error Groups', width: errorGroupWidth, value: (result, fmt) => formatErrorGroupCount(result.errorGroupIds, fmt) },
+    ];
+    if (showCheckId) {
+        columns.push({ header: 'Result ID', width: resultIdWidth, value: result => chalk.dim(result.testSessionResultId) }, { header: 'Check ID', value: result => result.checkId ? chalk.dim(result.checkId) : chalk.dim('-') });
+    }
+    else {
+        columns.push({ header: 'Result ID', value: result => chalk.dim(result.testSessionResultId) });
+    }
+    return columns;
+}
+export function uniqueErrorGroupIds(session) {
+    return [
+        ...(session.errorGroupIds ?? []),
+        ...(session.results ?? []).flatMap(result => result.errorGroupIds ?? []),
+    ].filter((id, index, ids) => ids.indexOf(id) === index);
+}
+function errorGroupReferences(session) {
+    const refs = new Map();
+    const add = (id, source) => {
+        const sources = refs.get(id) ?? new Set();
+        sources.add(source);
+        refs.set(id, sources);
+    };
+    for (const id of session.errorGroupIds ?? []) {
+        add(id, 'session');
+    }
+    for (const result of session.results ?? []) {
+        const source = result.name || result.testSessionResultId;
+        for (const id of result.errorGroupIds ?? []) {
+            add(id, source);
+        }
+    }
+    return [...refs.entries()].map(([id, sources]) => ({ id, sources: [...sources] }));
+}
+function buildErrorGroupReferenceColumns(format) {
+    if (format === 'md') {
+        return [
+            { header: 'Source', value: ref => ref.sources.join(', ') },
+            { header: 'Error Group ID', value: ref => ref.id },
+        ];
+    }
+    const termWidth = process.stdout.columns || 120;
+    const idWidth = 38;
+    const sourceWidth = Math.max(16, Math.min(50, termWidth - idWidth));
+    return [
+        {
+            header: 'Source',
+            width: sourceWidth,
+            value: ref => truncateToWidth(ref.sources.join(', '), sourceWidth - 2),
+        },
+        { header: 'Error Group ID', value: ref => chalk.dim(ref.id) },
+    ];
+}
+export function formatTestSessionErrorGroupIds(session, format, options = {}) {
+    const refs = errorGroupReferences(session);
+    if (refs.length === 0)
+        return '';
+    const limit = Math.max(0, options.errorGroupsLimit ?? DEFAULT_ERROR_GROUPS_LIMIT);
+    if (limit === 0)
+        return '';
+    const visible = refs.slice(0, limit);
+    const hiddenCount = refs.length - visible.length;
+    const lines = [
+        format === 'md' ? '## Error Group IDs' : chalk.bold('ERROR GROUP IDS'),
+        '',
+        renderTable(buildErrorGroupReferenceColumns(format), visible, format),
+    ];
+    if (hiddenCount > 0) {
+        const showMoreCommand = `checkly test-sessions get ${session.testSessionId} --error-groups-limit ${refs.length}`;
+        lines.push('');
+        lines.push(format === 'md'
+            ? `*Showing ${visible.length} of ${refs.length} error group IDs. Show all: \`${showMoreCommand}\`*`
+            : `${chalk.dim(`Showing ${visible.length} of ${refs.length} error group IDs. Show all:`)}  ${showMoreCommand}`);
+    }
+    return lines.join('\n');
+}
+export function formatTestSessionHints(session, format) {
+    const lines = [];
+    const errorGroupIds = uniqueErrorGroupIds(session);
+    if (errorGroupIds.length > 0) {
+        const inspectCommand = `checkly test-sessions get ${session.testSessionId} --error-group <error-group-id>`;
+        const rcaCommand = 'checkly rca run --test-session-error-group <error-group-id> --watch';
+        lines.push(format === 'md'
+            ? `- Inspect group: \`${inspectCommand}\``
+            : `  ${chalk.dim('Inspect group:')}  ${inspectCommand}`);
+        lines.push(format === 'md'
+            ? `- Run RCA: \`${rcaCommand}\``
+            : `  ${chalk.dim('Run RCA:')}       ${rcaCommand}`);
+    }
+    if (session.testSessionLink) {
+        lines.push(format === 'md'
+            ? `- Open session: ${session.testSessionLink}`
+            : `  ${chalk.dim('Open session:')}  ${session.testSessionLink}`);
+    }
+    return lines.join('\n');
+}
+function formatRawErrorMessage(rawErrorMessage, format, options) {
+    if (!rawErrorMessage)
+        return null;
+    if (options.fullError)
+        return rawErrorMessage;
+    const maxLines = Math.max(1, options.errorLines ?? DEFAULT_ERROR_DETAIL_LINES);
+    const lines = rawErrorMessage.split('\n');
+    if (lines.length <= maxLines)
+        return rawErrorMessage;
+    const note = `Showing first ${maxLines} of ${lines.length} lines. Use --full-error to print the complete raw error.`;
+    const formattedNote = format === 'md' ? `_${note}_` : chalk.dim(note);
+    return [...lines.slice(0, maxLines), '', formattedNote].join('\n');
+}
+function testSessionErrorGroupDetailFields(options) {
+    return [
+        { label: 'Error', value: (group, fmt) => formatRawErrorMessage(group.rawErrorMessage, fmt, options) },
+        { label: 'First seen', value: (group, fmt) => formatDate(group.firstSeen, fmt) },
+        { label: 'Last seen', value: (group, fmt) => formatDate(group.lastSeen, fmt) },
+        { label: 'Archived', value: group => group.archivedUntilNextEvent ? 'yes' : 'no' },
+        { label: 'Project ID', value: group => group.projectId },
+        { label: 'Environments', value: (group, fmt) => formatList(group.environments, fmt) },
+        { label: 'Error hash', value: group => group.errorHash },
+        { label: 'ID', value: group => group.id },
+    ];
+}
+export function formatTestSessionErrorGroupDetail(group, format, options = {}) {
+    return renderDetailFields('Test session error group', testSessionErrorGroupDetailFields(options), group, format);
+}
+export function formatTestSessionDetail(session, format, options = {}) {
+    const lines = [
+        renderDetailFields(session.name, testSessionDetailFields, session, format),
+    ];
+    const results = session.results ?? [];
+    if (results.length > 0) {
+        lines.push('');
+        lines.push(format === 'md' ? '## Results' : chalk.bold('RESULTS'));
+        lines.push('');
+        lines.push(renderTable(buildResultColumns(results, format), results, format));
+    }
+    const errorGroupIds = formatTestSessionErrorGroupIds(session, format, options);
+    if (errorGroupIds) {
+        lines.push('');
+        lines.push(errorGroupIds);
+    }
+    const hints = formatTestSessionHints(session, format);
+    if (hints) {
+        lines.push('');
+        lines.push(format === 'md' ? '## Hints' : chalk.bold('HINTS'));
+        lines.push('');
+        lines.push(hints);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=test-sessions.js.map

package/dist/formatters/test-sessions.js.map

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

package/dist/help/examples.js

@@ -11,6 +11,10 @@ const examples = [
         description: 'Deploy your project to your Checkly account.',
         command: 'npx checkly deploy',
     },
+    {
+        description: 'Make an authenticated API request to any endpoint.',
+        command: 'npx checkly api /v1/checks',
+    },
 ];
 export default examples;
 //# sourceMappingURL=examples.js.map

package/dist/help/examples.js.map

@@ -1 +1 @@
-{"version":3,"file":"examples.js","sourceRoot":"","sources":["../../src/help/examples.ts"],"names":[],"mappings":"AAKA,MAAM,QAAQ,GAAmB;IAC/B;QACE,WAAW,EAAE,+DAA+D;QAC5E,OAAO,EAAE,kBAAkB;KAC5B;IACD;QACE,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE,wCAAwC;KAClD;IACD;QACE,WAAW,EAAE,8CAA8C;QAC3D,OAAO,EAAE,oBAAoB;KAC9B;CACF,CAAA;AACD,eAAe,QAAQ,CAAA"}
+{"version":3,"file":"examples.js","sourceRoot":"","sources":["../../src/help/examples.ts"],"names":[],"mappings":"AAKA,MAAM,QAAQ,GAAmB;IAC/B;QACE,WAAW,EAAE,+DAA+D;QAC5E,OAAO,EAAE,kBAAkB;KAC5B;IACD;QACE,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE,wCAAwC;KAClD;IACD;QACE,WAAW,EAAE,8CAA8C;QAC3D,OAAO,EAAE,oBAAoB;KAC9B;IACD;QACE,WAAW,EAAE,oDAAoD;QACjE,OAAO,EAAE,4BAA4B;KACtC;CACF,CAAA;AACD,eAAe,QAAQ,CAAA"}

package/dist/helpers/api-fields.d.ts

@@ -0,0 +1,4 @@
+export interface ParsedFields {
+    [key: string]: unknown;
+}
+export declare function parseFields(fields: string[]): ParsedFields;

package/dist/helpers/api-fields.js

@@ -0,0 +1,24 @@
+export function parseFields(fields) {
+    const result = {};
+    for (const entry of fields) {
+        const jsonIndex = entry.indexOf(':=');
+        if (jsonIndex !== -1) {
+            const key = entry.slice(0, jsonIndex);
+            const raw = entry.slice(jsonIndex + 2);
+            try {
+                result[key] = JSON.parse(raw);
+            }
+            catch {
+                throw new Error(`Invalid JSON in field "${key}": ${raw}`);
+            }
+            continue;
+        }
+        const eqIndex = entry.indexOf('=');
+        if (eqIndex === -1) {
+            throw new Error(`Invalid field format: "${entry}". Expected key=value or key:=json.`);
+        }
+        result[entry.slice(0, eqIndex)] = entry.slice(eqIndex + 1);
+    }
+    return result;
+}
+//# sourceMappingURL=api-fields.js.map

package/dist/helpers/api-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-fields.js","sourceRoot":"","sources":["../../src/helpers/api-fields.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,WAAW,CAAE,MAAgB;IAC3C,MAAM,MAAM,GAAiB,EAAE,CAAA;IAE/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACrC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;YACrC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAA;YACtC,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,MAAM,GAAG,EAAE,CAAC,CAAA;YAC3D,CAAC;YACD,SAAQ;QACV,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,qCAAqC,CAAC,CAAA;QACvF,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAA;IAC5D,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/helpers/content-range.d.ts

@@ -0,0 +1 @@
+export declare function parseTotalFromContentRange(header: string | undefined): number | null;

package/dist/helpers/content-range.js

@@ -0,0 +1,7 @@
+export function parseTotalFromContentRange(header) {
+    if (!header)
+        return null;
+    const match = header.match(/\/(\d+)$/);
+    return match ? parseInt(match[1], 10) : null;
+}
+//# sourceMappingURL=content-range.js.map

package/dist/helpers/content-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-range.js","sourceRoot":"","sources":["../../src/helpers/content-range.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,0BAA0B,CAAE,MAA0B;IACpE,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IACtC,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAC9C,CAAC"}

package/dist/rest/checks.js

@@ -1,10 +1,4 @@
-function parseTotalFromContentRange(header) {
-    if (!header)
-        return null;
-    // Content-Range format: "0-24/300" or "*/0"
-    const match = header.match(/\/(\d+)$/);
-    return match ? parseInt(match[1], 10) : null;
-}
+import { parseTotalFromContentRange } from '../helpers/content-range.js';
 class Checks {
     api;
     constructor(api) {

package/dist/rest/checks.js.map

@@ -1 +1 @@
-{"version":3,"file":"checks.js","sourceRoot":"","sources":["../../src/rest/checks.ts"],"names":[],"mappings":"AAuCA,SAAS,0BAA0B,CAAE,MAA0B;IAC7D,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,4CAA4C;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IACtC,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAC9C,CAAC;AAED,MAAM,MAAM;IACV,GAAG,CAAe;IAClB,YAAa,GAAkB;QAC7B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;IAChB,CAAC;IAED,MAAM,CAAE,SAA2B,EAAE;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAU,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IACxD,CAAC;IAED,KAAK,CAAC,eAAe,CAAE,SAA2B,EAAE;QAClD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAU,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;QACtE,MAAM,KAAK,GAAG,0BAA0B,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAA;QACnG,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,IAAI;YACrB,KAAK;YACL,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;YACtB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;SAC1B,CAAA;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAE,SAAmD,EAAE;QACnE,MAAM,QAAQ,GAAG,GAAG,CAAA;QACpB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;QACjF,MAAM,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;QAEnC,IAAI,KAAK,CAAC,KAAK,IAAI,QAAQ;YAAE,OAAO,SAAS,CAAA;QAE7C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAA;QACpD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC9C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAU,YAAY,EAAE;YAClC,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE;SACpD,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACrB,CACF,CAAA;QACD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;QACzB,CAAC;QAED,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,GAAG,CAAE,EAAU;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAQ,cAAc,EAAE,EAAE,CAAC,CAAA;IAChD,CAAC;CACF;AAED,eAAe,MAAM,CAAA"}
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../../src/rest/checks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAA;AAuCxE,MAAM,MAAM;IACV,GAAG,CAAe;IAClB,YAAa,GAAkB;QAC7B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;IAChB,CAAC;IAED,MAAM,CAAE,SAA2B,EAAE;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAU,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IACxD,CAAC;IAED,KAAK,CAAC,eAAe,CAAE,SAA2B,EAAE;QAClD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAU,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;QACtE,MAAM,KAAK,GAAG,0BAA0B,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAA;QACnG,OAAO;YACL,MAAM,EAAE,QAAQ,CAAC,IAAI;YACrB,KAAK;YACL,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;YACtB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;SAC1B,CAAA;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAE,SAAmD,EAAE;QACnE,MAAM,QAAQ,GAAG,GAAG,CAAA;QACpB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;QACjF,MAAM,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;QAEnC,IAAI,KAAK,CAAC,KAAK,IAAI,QAAQ;YAAE,OAAO,SAAS,CAAA;QAE7C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAA;QACpD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC9C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAU,YAAY,EAAE;YAClC,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE;SACpD,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACrB,CACF,CAAA;QACD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;QACzB,CAAC;QAED,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,GAAG,CAAE,EAAU;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAQ,cAAc,EAAE,EAAE,CAAC,CAAA;IAChD,CAAC;CACF;AAED,eAAe,MAAM,CAAA"}

package/dist/rest/test-sessions.d.ts

@@ -57,6 +57,42 @@ export type TriggerTestSessionResponse = {
     testResultIds: Record<string, string>;
     sequenceIds: Record<string, SequenceId>;
 };
+export type TestSessionMetadata = {
+    environment?: string;
+    repoUrl?: string;
+    commitId?: string;
+    commitOwner?: string;
+    commitMessage?: string;
+    branchName?: string;
+};
+export type TestSessionStatus = 'RUNNING' | 'FAILED' | 'PASSED' | 'CANCELLED';
+export type TestSessionResult = {
+    testSessionResultId: string;
+    testSessionResultLink: string;
+    checkId?: string | null;
+    checkType: string;
+    name?: string;
+    runLocation?: string;
+    resultType?: string;
+    status: TestSessionStatus;
+    hasErrors: boolean;
+    hasFailures: boolean;
+    isDegraded: boolean;
+    aborted: boolean;
+    errorGroupIds?: string[];
+};
+export type TestSessionDetail = {
+    testSessionId: string;
+    testSessionLink: string;
+    name: string;
+    status: TestSessionStatus;
+    startedAt: string;
+    stoppedAt: string | null;
+    timeElapsed: number;
+    metadata?: TestSessionMetadata;
+    errorGroupIds?: string[];
+    results?: TestSessionResult[];
+};
 export declare class NoMatchingChecksError extends Error {
     constructor(options?: ErrorOptions);
 }
@@ -68,6 +104,7 @@ declare class TestSessions {
      * @throws {NoMatchingChecksError} If no checks matched the request.
      */
     trigger(payload: TriggerTestSessionRequest): Promise<import("axios").AxiosResponse<TriggerTestSessionResponse, any, {}>>;
+    get(id: string): Promise<import("axios").AxiosResponse<TestSessionDetail, any, {}>>;
     getShortLink(id: string): Promise<import("axios").AxiosResponse<{
         link: string;
     }, any, {}>>;

package/dist/rest/test-sessions.js

@@ -36,6 +36,9 @@ class TestSessions {
             throw err;
         }
     }
+    get(id) {
+        return this.api.get(`/v1/test-sessions/${id}`);
+    }
     getShortLink(id) {
         return this.api.get(`/next/test-sessions/${id}/link`);
     }

package/dist/rest/test-sessions.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-sessions.js","sourceRoot":"","sources":["../../src/rest/test-sessions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AA0C5C,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAa,OAAsB;QACjC,KAAK,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAA;QAC3C,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;IACrC,CAAC;CACF;AAED,MAAM,YAAY;IAChB,GAAG,CAAe;IAClB,YAAa,GAAkB;QAC7B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,GAAG,CAAE,OAA8B;QACvC,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE,OAAO,EAAE;YAC7D,gBAAgB,EAAE,mBAAmB;SACtC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAE,OAAkC;QAC/C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAA6B,6BAA6B,EAAE,OAAO,CAAC,CAAA;YAEpG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,wFAAwF;gBACxF,wFAAwF;gBACxF,MAAM,IAAI,qBAAqB,EAAE,CAAA;YACnC,CAAC;YAED,OAAO,IAAI,CAAA;QACb,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,cAAc,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,wBAAwB,EAAE,CAAC;gBACrF,MAAM,IAAI,qBAAqB,EAAE,CAAA;YACnC,CAAC;YAED,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;IAED,YAAY,CAAE,EAAU;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAmB,uBAAuB,EAAE,OAAO,CAAC,CAAA;IACzE,CAAC;IAED,mBAAmB,CAAE,aAAqB,EAAE,YAAoB;QAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAwB,uBAAuB,aAAa,YAAY,YAAY,QAAQ,CAAC,CAAA;IAClH,CAAC;CACF;AAED,eAAe,YAAY,CAAA"}
+{"version":3,"file":"test-sessions.js","sourceRoot":"","sources":["../../src/rest/test-sessions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAkF5C,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAa,OAAsB;QACjC,KAAK,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAA;QAC3C,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;IACrC,CAAC;CACF;AAED,MAAM,YAAY;IAChB,GAAG,CAAe;IAClB,YAAa,GAAkB;QAC7B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,GAAG,CAAE,OAA8B;QACvC,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE,OAAO,EAAE;YAC7D,gBAAgB,EAAE,mBAAmB;SACtC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAE,OAAkC;QAC/C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAA6B,6BAA6B,EAAE,OAAO,CAAC,CAAA;YAEpG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,wFAAwF;gBACxF,wFAAwF;gBACxF,MAAM,IAAI,qBAAqB,EAAE,CAAA;YACnC,CAAC;YAED,OAAO,IAAI,CAAA;QACb,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,cAAc,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,wBAAwB,EAAE,CAAC;gBACrF,MAAM,IAAI,qBAAqB,EAAE,CAAA;YACnC,CAAC;YAED,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;IAED,GAAG,CAAE,EAAU;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAoB,qBAAqB,EAAE,EAAE,CAAC,CAAA;IACnE,CAAC;IAED,YAAY,CAAE,EAAU;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAmB,uBAAuB,EAAE,OAAO,CAAC,CAAA;IACzE,CAAC;IAED,mBAAmB,CAAE,aAAqB,EAAE,YAAoB;QAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAwB,uBAAuB,aAAa,YAAY,YAAY,QAAQ,CAAC,CAAA;IAClH,CAAC;CACF;AAED,eAAe,YAAY,CAAA"}

package/oclif.manifest.json

@@ -1,5 +1,104 @@
 {
   "commands": {
+    "api": {
+      "aliases": [],
+      "args": {
+        "endpoint": {
+          "description": "API endpoint path (e.g. /v1/checks).",
+          "name": "endpoint",
+          "required": true
+        }
+      },
+      "description": "Make an authenticated HTTP request to the Checkly API.\nPass-through for any endpoint — handles auth automatically.\nSee https://www.checklyhq.com/docs/api for available endpoints.\nOpenAPI spec: https://api.checklyhq.com/openapi.json",
+      "examples": [
+        "checkly api /v1/checks",
+        "checkly api /v1/checks -X GET --jq '.[].name'",
+        "checkly api /v1/checks -X POST -F name=MyCheck -F activated:=true",
+        "checkly api /v1/checks -X GET -F limit=5",
+        "echo '{\"name\":\"New\"}' | checkly api /v1/checks -X POST --input -"
+      ],
+      "flags": {
+        "method": {
+          "char": "X",
+          "description": "HTTP method.",
+          "name": "method",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "GET",
+            "POST",
+            "PUT",
+            "PATCH",
+            "DELETE"
+          ],
+          "type": "option"
+        },
+        "field": {
+          "char": "F",
+          "description": "Add a field: key=value (string) or key:=value (parsed as JSON).",
+          "name": "field",
+          "default": [],
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "header": {
+          "char": "H",
+          "description": "Custom HTTP header: \"Key: Value\".",
+          "name": "header",
+          "default": [],
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "jq": {
+          "description": "Filter JSON output with a jq expression (requires jq installed).",
+          "name": "jq",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "input": {
+          "description": "Request body from file path, or \"-\" for stdin.",
+          "name": "input",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "include": {
+          "char": "i",
+          "description": "Include HTTP status and response headers in the output.",
+          "name": "include",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "description": "Print request and response headers to stderr.",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": false,
+      "hiddenAliases": [],
+      "id": "api",
+      "pluginAlias": "checkly",
+      "pluginName": "checkly",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "coreCommand": false,
+      "readOnly": false,
+      "destructive": true,
+      "idempotent": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "api.js"
+      ]
+    },
     "authCommand": {
       "aliases": [],
       "args": {},
@@ -2754,7 +2853,75 @@
         "status-pages",
         "list.js"
       ]
+    },
+    "test-sessions:get": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "The ID of the test session to retrieve.",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get details of a recorded test session, including result error groups for RCA.",
+      "flags": {
+        "error-group": {
+          "description": "Show details for a test session error group ID from this session.",
+          "name": "error-group",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "error-groups-limit": {
+          "description": "Number of error group IDs to show in the session summary.",
+          "name": "error-groups-limit",
+          "default": 5,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "full-error": {
+          "description": "Print the complete raw error when showing a test session error group.",
+          "name": "full-error",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "output": {
+          "char": "o",
+          "description": "Output format.",
+          "name": "output",
+          "default": "detail",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "detail",
+            "json",
+            "md"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": false,
+      "hiddenAliases": [],
+      "id": "test-sessions:get",
+      "pluginAlias": "checkly",
+      "pluginName": "checkly",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "coreCommand": false,
+      "readOnly": true,
+      "destructive": false,
+      "idempotent": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "test-sessions",
+        "get.js"
+      ]
     }
   },
-  "version": "8.2.0"
+  "version": "8.3.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "checkly",
-  "version": "8.2.0",
+  "version": "8.3.0",
   "type": "module",
   "description": "Checkly CLI",
   "main": "dist/index.js",
@@ -75,6 +75,9 @@
       },
       "status-pages": {
         "description": "List and manage status pages in your Checkly account."
+      },
+      "test-sessions": {
+        "description": "Inspect recorded test sessions."
       }
     },
     "helpClass": "./dist/help/help-extension.js"