checkly 7.10.0 → 7.11.0-prerelease-bb99ed9

package/dist/ai-context/checkly.rules.md

@@ -79,6 +79,9 @@ Parse and read further reference documentation when tasked with creating or mana
 
 If the Checkly CLI is installed (`npx checkly version`), use `npx checkly skills configure [CONSTRUCT]` to access up-to-date information:
 
+### `npx checkly skills configure agentic-checks`
+Agentic Check construct (`AgenticCheck`) for AI-powered prompt-driven monitoring with skill and env var allowlists
+
 ### `npx checkly skills configure api-checks`
 Api Check construct (`ApiCheck`), assertions, and authentication setup scripts
 
@@ -139,6 +142,80 @@ Run `npx checkly skills manage plan` for the full reference.
 
 - Test checks using the `npx checkly test` command. Pass environment variables with the `-e` flag, use `--record` to persist results, and use `--verbose` to see all errors.
 
+### Agentic Checks
+
+- Import the `AgenticCheck` construct from `checkly/constructs`.
+- Agentic checks are AI-powered: instead of writing code, you describe what the check should do in natural language with the `prompt` property. The agent decides how to satisfy the prompt at runtime.
+- Write prompts as concrete imperative steps, not vague goals. Tell the agent which URL to navigate to and what specific signals confirm success — for example, "Navigate to https://example.com/pricing and verify that at least three plan tiers are displayed", not "Check that pricing works".
+- Keep prompts under 10000 characters. The construct will fail validation otherwise.
+- **Frequency is restricted.** Only `30`, `60`, `120`, `180`, `360`, `720`, or `1440` minutes are accepted (matching `Frequency.EVERY_30M`, `EVERY_1H`, `EVERY_2H`, `EVERY_3H`, `EVERY_6H`, `EVERY_12H`, `EVERY_24H`). Anything else fails validation.
+- **Locations are not configurable.** Agentic checks currently run from a single fixed location. The construct hardcodes it — do not pass `locations` or `privateLocations`.
+- **Several common check fields are intentionally omitted** from `AgenticCheckProps`: `runParallel`, `retryStrategy`, `shouldFail`, `doubleCheck`, `triggerIncident`, and `groupId`. The platform does not yet honor these for agentic checks. Setting them in the construct is a TypeScript error.
+- **Important:** The target URL must be publicly accessible. Checks run on Checkly's cloud infrastructure, not locally. If the user is developing against localhost, suggest a tunneling tool (ngrok, cloudflare tunnel) or a preview/staging deployment.
+- **Plan-gated:** Agentic checks require the `AGENTIC_CHECKS` entitlement on the account. Run `npx checkly skills manage` to check entitlements before using.
+
+#### `agentRuntime` — security boundary for skills and env vars
+
+`agentRuntime` is the explicit allowlist of resources the agent may use at execution time. Anything not declared in `agentRuntime` is **unavailable** to the agent. Treat it as a security boundary: the smaller the runtime surface, the smaller the blast radius of any prompt injection.
+
+```typescript
+agentRuntime: {
+  // Additional skills to load on top of the runner's defaults (the
+  // `playwright-cli` skill is preloaded automatically — you don't need
+  // to declare it). Each entry is passed verbatim to `npx skills add`
+  // on the runner, so any third-party skill published to https://skills.sh
+  // works — not just Checkly's own. Supported identifier forms:
+  //   - full URL form:   'https://skills.sh/microsoft/playwright-cli/playwright-cli'
+  //   - owner/repo form: 'addyosmani/web-quality-skills'
+  //   - plain name:      'cost-optimization'
+  skills: ['addyosmani/web-quality-skills'],
+
+  // Environment variables the agent is allowed to read at runtime.
+  // Anything not listed here is hidden from the agent process — even
+  // if it's defined at the project or check level.
+  exposeEnvironmentVariables: [
+    // Bare string form: variable name only.
+    'ENVIRONMENT_URL',
+    // Object form: pair the variable with a description so the agent
+    // can decide when to read it. Descriptions are passed to the model
+    // and are truncated to 200 characters.
+    { name: 'TEST_USER_EMAIL', description: 'Login email for the test account' },
+  ],
+},
+```
+
+- Only declare env vars the agent **needs**. Adding a variable to `exposeEnvironmentVariables` exposes it to the model and to anything the model invokes via skills.
+- Descriptions are not just documentation — they steer the model's decisions. Use them to disambiguate variables that have non-obvious names.
+- The runner installs each skill via `npx skills add` at the start of every check run. The CLI does not validate the skill identifier at deploy time, so a typo will not surface until the first run.
+- The `playwright-cli` skill is preloaded for every agentic check. Only declare additional skills here.
+
+#### Assertion rules
+
+The agent generates its own assertion rules on the first successful run, and the platform persists them server-side. **The CLI construct does not expose assertion rules** — do not try to set them. They survive across deploys: importing an existing agentic check via `checkly import` will not surface them in the generated TypeScript, and a subsequent deploy of that file will not erase them on the backend.
+
+**Reference:** https://www.checklyhq.com/docs/constructs/agentic-check/
+
+```typescript
+import { AgenticCheck, AlertEscalationBuilder, Frequency } from 'checkly/constructs'
+
+new AgenticCheck('example-agentic-check', {
+  name: 'Example Agentic Check',
+  prompt: 'Navigate to https://www.checklyhq.com/pricing and verify that at least three plan tiers are displayed on the page.',
+  activated: true,
+  tags: [
+    'app:webshop',
+  ],
+  frequency: Frequency.EVERY_1H,
+  alertEscalationPolicy: AlertEscalationBuilder.runBasedEscalation(1, {
+    amount: 0,
+    interval: 5,
+  }, {
+    enabled: false,
+    percentage: 10,
+  }),
+})
+```
+
 ### API Checks
 
 - Import the `ApiCheck` construct from `checkly/constructs`.

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

@@ -1,4 +1,7 @@
 export declare const REFERENCES: readonly [{
+    readonly id: "configure-agentic-checks";
+    readonly description: "Agentic Check construct (`AgenticCheck`) for AI-powered prompt-driven monitoring with skill and env var allowlists";
+}, {
     readonly id: "configure-api-checks";
     readonly description: "Api Check construct (`ApiCheck`), assertions, and authentication setup scripts";
 }, {
@@ -58,6 +61,9 @@ export declare const ACTIONS: readonly [{
     readonly id: "configure";
     readonly description: "Learn how to create and manage monitoring checks using Checkly constructs and the CLI.";
     readonly references: readonly [{
+        readonly id: "configure-agentic-checks";
+        readonly description: "Agentic Check construct (`AgenticCheck`) for AI-powered prompt-driven monitoring with skill and env var allowlists";
+    }, {
         readonly id: "configure-api-checks";
         readonly description: "Api Check construct (`ApiCheck`), assertions, and authentication setup scripts";
     }, {

package/dist/ai-context/context.js

@@ -2,6 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EXAMPLE_CONFIGS = exports.ACTIONS = exports.SKILL = exports.MANAGE_REFERENCES = exports.COMMUNICATE_REFERENCES = exports.INVESTIGATE_REFERENCES = exports.REFERENCES = void 0;
 exports.REFERENCES = [
+    {
+        id: 'configure-agentic-checks',
+        description: 'Agentic Check construct (`AgenticCheck`) for AI-powered prompt-driven monitoring with skill and env var allowlists',
+    },
     {
         id: 'configure-api-checks',
         description: 'Api Check construct (`ApiCheck`), assertions, and authentication setup scripts',
@@ -137,6 +141,11 @@ export default defineConfig({
 `,
         reference: 'https://www.checklyhq.com/docs/constructs/project/',
     },
+    AGENTIC_CHECK: {
+        templateString: '<!-- EXAMPLE: AGENTIC_CHECK -->',
+        exampleConfigPath: 'resources/agentic-checks/example-agentic-check.check.ts',
+        reference: 'https://www.checklyhq.com/docs/constructs/agentic-check/',
+    },
     BROWSER_CHECK: {
         templateString: '<!-- EXAMPLE: BROWSER_CHECK -->',
         exampleConfigPath: 'resources/browser-checks/example-browser-check/example-browser-check.check.ts',

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

@@ -1,6 +1,6 @@
 ---
 name: checkly
-description: Set up, create, test and manage monitoring checks using the Checkly CLI. Use when working with API Checks, Browser Checks, URL Monitors, ICMP Monitors, Playwright Check Suites, Heartbeat Monitors, Alert Channels, Dashboards, or Status Pages.
+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.
 allowed-tools: Bash(npx:checkly:*) Bash(npm:install:*)
 metadata:
   author: checkly
@@ -42,6 +42,9 @@ Learn how to initialize and set up a new Checkly CLI project from scratch.
 ### `npx checkly skills configure`
 Learn how to create and manage monitoring checks using Checkly constructs and the CLI.
 
+#### `npx checkly skills configure agentic-checks`
+Agentic Check construct (`AgenticCheck`) for AI-powered prompt-driven monitoring with skill and env var allowlists
+
 #### `npx checkly skills configure api-checks`
 Api Check construct (`ApiCheck`), assertions, and authentication setup scripts
 

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

@@ -0,0 +1,73 @@
+# Agentic Checks
+
+- Import the `AgenticCheck` construct from `checkly/constructs`.
+- Agentic checks are AI-powered: instead of writing code, you describe what the check should do in natural language with the `prompt` property. The agent decides how to satisfy the prompt at runtime.
+- Write prompts as concrete imperative steps, not vague goals. Tell the agent which URL to navigate to and what specific signals confirm success — for example, "Navigate to https://example.com/pricing and verify that at least three plan tiers are displayed", not "Check that pricing works".
+- Keep prompts under 10000 characters. The construct will fail validation otherwise.
+- **Frequency is restricted.** Only `30`, `60`, `120`, `180`, `360`, `720`, or `1440` minutes are accepted (matching `Frequency.EVERY_30M`, `EVERY_1H`, `EVERY_2H`, `EVERY_3H`, `EVERY_6H`, `EVERY_12H`, `EVERY_24H`). Anything else fails validation.
+- **Locations are not configurable.** Agentic checks currently run from a single fixed location. The construct hardcodes it — do not pass `locations` or `privateLocations`.
+- **Several common check fields are intentionally omitted** from `AgenticCheckProps`: `runParallel`, `retryStrategy`, `shouldFail`, `doubleCheck`, `triggerIncident`, and `groupId`. The platform does not yet honor these for agentic checks. Setting them in the construct is a TypeScript error.
+- **Important:** The target URL must be publicly accessible. Checks run on Checkly's cloud infrastructure, not locally. If the user is developing against localhost, suggest a tunneling tool (ngrok, cloudflare tunnel) or a preview/staging deployment.
+- **Plan-gated:** Agentic checks require the `AGENTIC_CHECKS` entitlement on the account. Run `npx checkly skills manage` to check entitlements before using.
+
+## `agentRuntime` — security boundary for skills and env vars
+
+`agentRuntime` is the explicit allowlist of resources the agent may use at execution time. Anything not declared in `agentRuntime` is **unavailable** to the agent. Treat it as a security boundary: the smaller the runtime surface, the smaller the blast radius of any prompt injection.
+
+```typescript
+agentRuntime: {
+  // Additional skills to load on top of the runner's defaults (the
+  // `playwright-cli` skill is preloaded automatically — you don't need
+  // to declare it). Each entry is passed verbatim to `npx skills add`
+  // on the runner, so any third-party skill published to https://skills.sh
+  // works — not just Checkly's own. Supported identifier forms:
+  //   - full URL form:   'https://skills.sh/microsoft/playwright-cli/playwright-cli'
+  //   - owner/repo form: 'addyosmani/web-quality-skills'
+  //   - plain name:      'cost-optimization'
+  skills: ['addyosmani/web-quality-skills'],
+
+  // Environment variables the agent is allowed to read at runtime.
+  // Anything not listed here is hidden from the agent process — even
+  // if it's defined at the project or check level.
+  exposeEnvironmentVariables: [
+    // Bare string form: variable name only.
+    'ENVIRONMENT_URL',
+    // Object form: pair the variable with a description so the agent
+    // can decide when to read it. Descriptions are passed to the model
+    // and are truncated to 200 characters.
+    { name: 'TEST_USER_EMAIL', description: 'Login email for the test account' },
+  ],
+},
+```
+
+- Only declare env vars the agent **needs**. Adding a variable to `exposeEnvironmentVariables` exposes it to the model and to anything the model invokes via skills.
+- Descriptions are not just documentation — they steer the model's decisions. Use them to disambiguate variables that have non-obvious names.
+- The runner installs each skill via `npx skills add` at the start of every check run. The CLI does not validate the skill identifier at deploy time, so a typo will not surface until the first run.
+- The `playwright-cli` skill is preloaded for every agentic check. Only declare additional skills here.
+
+## Assertion rules
+
+The agent generates its own assertion rules on the first successful run, and the platform persists them server-side. **The CLI construct does not expose assertion rules** — do not try to set them. They survive across deploys: importing an existing agentic check via `checkly import` will not surface them in the generated TypeScript, and a subsequent deploy of that file will not erase them on the backend.
+
+**Reference:** https://www.checklyhq.com/docs/constructs/agentic-check/
+
+```typescript
+import { AgenticCheck, AlertEscalationBuilder, Frequency } from 'checkly/constructs'
+
+new AgenticCheck('example-agentic-check', {
+  name: 'Example Agentic Check',
+  prompt: 'Navigate to https://www.checklyhq.com/pricing and verify that at least three plan tiers are displayed on the page.',
+  activated: true,
+  tags: [
+    'app:webshop',
+  ],
+  frequency: Frequency.EVERY_1H,
+  alertEscalationPolicy: AlertEscalationBuilder.runBasedEscalation(1, {
+    amount: 0,
+    interval: 5,
+  }, {
+    enabled: false,
+    percentage: 10,
+  }),
+})
+```

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

@@ -79,6 +79,9 @@ Parse and read further reference documentation when tasked with creating or mana
 
 If the Checkly CLI is installed (`npx checkly version`), use `npx checkly skills configure [CONSTRUCT]` to access up-to-date information:
 
+### `npx checkly skills configure agentic-checks`
+Agentic Check construct (`AgenticCheck`) for AI-powered prompt-driven monitoring with skill and env var allowlists
+
 ### `npx checkly skills configure api-checks`
 Api Check construct (`ApiCheck`), assertions, and authentication setup scripts
 

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

@@ -7,13 +7,17 @@ List and inspect deployed checks in your Checkly account.
 ```bash
 npx checkly checks list
 npx checkly checks list --tag production --type PLAYWRIGHT
+npx checkly checks list --status failing
 npx checkly checks list --search "Homepage" --output json
 ```
 
 Flags:
-- `--tag <tag>` — filter by tag
-- `--type <type>` — filter by check type (`API`, `BROWSER`, `PLAYWRIGHT`, `MULTI_STEP`)
-- `--search <name>` — filter by name
+- `-t, --tag <tag>` — filter by tag (repeat for multiple)
+- `--type <type>` — filter by check type (`API`, `BROWSER`, `HEARTBEAT`, `MULTI_STEP`, `PLAYWRIGHT`, `TCP`, `ICMP`, `DNS`, `URL`, `AGENTIC`)
+- `-s, --search <name>` — filter by name (case-insensitive partial match)
+- `--status <status>` — filter by current status: `passing`, `failing`, or `degraded`
+- `-l, --limit <n>` — max checks to return (1-100, default 25)
+- `-p, --page <n>` — page number
 - `-o, --output <format>` — `table` (default), `json`, or `md`
 
 ## Get check details
@@ -21,9 +25,21 @@ Flags:
 ```bash
 npx checkly checks get <check-id>
 npx checkly checks get <check-id> --output json
+npx checkly checks get <check-id> --stats-range last7Days --group-by location
 ```
 
-Shows check configuration, recent results, and error groups.
+Shows check configuration, recent results, error groups, and analytics stats.
+
+Flags:
+- `-r, --result <result-id>` — drill into a specific 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
+- `--stats-range <range>` — analytics range: `last24Hours` (default), `last7Days`, `last30Days`, `thisWeek`, `thisMonth`, `lastWeek`, `lastMonth`
+- `--group-by <dimension>` — group stats by `location` or `statusCode`
+- `--metrics <list>` — comma-separated list of metrics to show (overrides defaults)
+- `--filter-status <status>` — only include runs with this status in stats: `success` or `failure`
+- `-o, --output <format>` — `detail` (default), `json`, or `md`
 
 ### View a specific check result
 

package/dist/constants.d.ts

@@ -8,7 +8,8 @@ export declare const CheckTypes: {
     readonly ICMP: "ICMP";
     readonly DNS: "DNS";
     readonly URL: "URL";
+    readonly AGENTIC: "AGENTIC";
 };
 export type CheckType = typeof CheckTypes[keyof typeof CheckTypes];
-export declare const allCheckTypes: ("API" | "BROWSER" | "HEARTBEAT" | "MULTI_STEP" | "PLAYWRIGHT" | "TCP" | "ICMP" | "DNS" | "URL")[];
+export declare const allCheckTypes: ("API" | "BROWSER" | "HEARTBEAT" | "MULTI_STEP" | "PLAYWRIGHT" | "TCP" | "ICMP" | "DNS" | "URL" | "AGENTIC")[];
 export declare const LOGICAL_ID_PATTERN: RegExp;

package/dist/constants.js

@@ -11,6 +11,7 @@ exports.CheckTypes = {
     ICMP: 'ICMP',
     DNS: 'DNS',
     URL: 'URL',
+    AGENTIC: 'AGENTIC',
 };
 exports.allCheckTypes = Object.values(exports.CheckTypes);
 exports.LOGICAL_ID_PATTERN = /^[A-Za-z0-9_\-/#.]+$/;

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IACxB,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;CACF,CAAA;AAIG,QAAA,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAU,CAAC,CAAA;AAEzC,QAAA,kBAAkB,GAAG,sBAAsB,CAAA"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IACxB,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,SAAS;CACV,CAAA;AAIG,QAAA,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAU,CAAC,CAAA;AAEzC,QAAA,kBAAkB,GAAG,sBAAsB,CAAA"}

package/dist/constructs/agentic-check-codegen.d.ts

@@ -0,0 +1,34 @@
+import { Codegen, Context } from './internal/codegen';
+import { CheckResource } from './check-codegen';
+/**
+ * Shape of a `selectedEnvironmentVariables` entry as stored on the backend
+ * inside `agenticCheckData`. The runner accepts two forms — a bare variable
+ * name, or an object with `key` and an optional `description`. The CLI
+ * construct uses `name` (not `key`), so the codegen translates object-form
+ * entries during emission.
+ */
+type StoredAgenticEnvironmentVariable = string | {
+    key: string;
+    description?: string;
+};
+/**
+ * Shape of `agenticCheckData` as stored on the backend and returned to the
+ * CLI during `checkly import`. Only fields the construct exposes are read.
+ * `assertionRules` is deliberately ignored — the agent generates those on
+ * the first run and the backend's deploy logic preserves them, so the CLI
+ * construct never needs to emit them.
+ */
+interface StoredAgenticCheckData {
+    skills?: string[] | null;
+    selectedEnvironmentVariables?: StoredAgenticEnvironmentVariable[] | null;
+}
+export interface AgenticCheckResource extends CheckResource {
+    checkType: 'AGENTIC';
+    prompt: string;
+    agenticCheckData?: StoredAgenticCheckData | null;
+}
+export declare class AgenticCheckCodegen extends Codegen<AgenticCheckResource> {
+    describe(resource: AgenticCheckResource): string;
+    gencode(logicalId: string, resource: AgenticCheckResource, context: Context): void;
+}
+export {};

package/dist/constructs/agentic-check-codegen.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgenticCheckCodegen = void 0;
+const codegen_1 = require("./internal/codegen");
+const sourcegen_1 = require("../sourcegen");
+const check_codegen_1 = require("./check-codegen");
+const construct = 'AgenticCheck';
+class AgenticCheckCodegen extends codegen_1.Codegen {
+    describe(resource) {
+        return `Agentic Check: ${resource.name}`;
+    }
+    gencode(logicalId, resource, context) {
+        const filePath = context.filePath('resources/agentic-checks', resource.name, {
+            tags: resource.tags,
+            unique: true,
+        });
+        const file = this.program.generatedConstructFile(filePath.fullPath);
+        file.namedImport(construct, 'checkly/constructs');
+        // `AgenticCheckProps` omits several fields that the platform does not
+        // yet honor (see `agentic-check.ts` for the full list and rationale).
+        // To keep the generated file type-checking against the construct, clear
+        // `locations` (which the construct hardcodes to a single value) and
+        // skip `retryStrategy` emission. The other omitted fields are already
+        // conditional in `buildCheckProps` and never populated for agentic
+        // checks today.
+        const sanitizedResource = {
+            ...resource,
+            locations: undefined,
+        };
+        file.section((0, sourcegen_1.expr)((0, sourcegen_1.ident)(construct), builder => {
+            builder.new(builder => {
+                builder.string(logicalId);
+                builder.object(builder => {
+                    builder.string('prompt', resource.prompt);
+                    // Emit agentRuntime only when there's something meaningful to
+                    // carry. An imported check with no skills and no selected env
+                    // vars would otherwise produce an empty `agentRuntime: {}` block,
+                    // which is noise in the generated code.
+                    const agentRuntimeValue = buildAgentRuntimeObject(resource.agenticCheckData);
+                    if (agentRuntimeValue !== undefined) {
+                        builder.object('agentRuntime', agentRuntimeValue);
+                    }
+                    (0, check_codegen_1.buildCheckProps)(this.program, file, builder, sanitizedResource, context, {
+                        skipRetryStrategy: true,
+                    });
+                });
+            });
+        }));
+    }
+}
+exports.AgenticCheckCodegen = AgenticCheckCodegen;
+/**
+ * Build an `agentRuntime: { ... }` object literal for the codegen output,
+ * reverse-translating the backend's storage shape (`selectedEnvironmentVariables`
+ * with `key`) into the CLI construct's shape (`exposeEnvironmentVariables` with
+ * `name`). Returns `undefined` when the input contains nothing worth
+ * emitting, so the caller can skip the property entirely.
+ */
+function buildAgentRuntimeObject(data) {
+    if (!data)
+        return undefined;
+    const skills = (data.skills ?? []).filter(s => s.length > 0);
+    const storedEnvVars = data.selectedEnvironmentVariables ?? [];
+    if (skills.length === 0 && storedEnvVars.length === 0) {
+        return undefined;
+    }
+    return builder => {
+        if (skills.length > 0) {
+            builder.array('skills', arrayBuilder => {
+                for (const skill of skills) {
+                    arrayBuilder.string(skill);
+                }
+            });
+        }
+        if (storedEnvVars.length > 0) {
+            builder.array('exposeEnvironmentVariables', arrayBuilder => {
+                for (const entry of storedEnvVars) {
+                    if (typeof entry === 'string') {
+                        arrayBuilder.string(entry);
+                    }
+                    else {
+                        arrayBuilder.object(objectBuilder => {
+                            objectBuilder.string('name', entry.key);
+                            if (entry.description) {
+                                objectBuilder.string('description', entry.description);
+                            }
+                        });
+                    }
+                }
+            });
+        }
+    };
+}
+//# sourceMappingURL=agentic-check-codegen.js.map

package/dist/constructs/agentic-check-codegen.js.map

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

package/dist/constructs/agentic-check.d.ts

@@ -0,0 +1,186 @@
+import { Check, CheckProps } from './check';
+import { Frequency } from './frequency';
+import { Diagnostics } from './diagnostics';
+/**
+ * Frequencies (in minutes) currently supported for agentic checks: 30, 60, 120,
+ * 180, 360, 720 or 1440. The matching `Frequency` constants
+ * (`EVERY_30M`, `EVERY_1H`, `EVERY_2H`, `EVERY_3H`, `EVERY_6H`, `EVERY_12H`,
+ * `EVERY_24H`) are also accepted.
+ */
+export type AgenticCheckFrequency = 30 | 60 | 120 | 180 | 360 | 720 | 1440 | Frequency;
+/**
+ * An environment variable the agent is permitted to read at runtime.
+ *
+ * Use the bare string form when the variable name is self-explanatory, or
+ * the object form to provide a `description` that helps the agent understand
+ * what the variable is for. Descriptions are passed to the model so it can
+ * make better decisions about when to read the variable.
+ *
+ * @example
+ * ```typescript
+ * 'API_KEY'
+ * { name: 'TOKEN_42', description: 'Feature flag service auth token' }
+ * ```
+ */
+export type AgentRuntimeEnvironmentVariable = string | {
+    /** The environment variable name. */
+    name: string;
+    /**
+     * Optional human-readable explanation of what the variable is for.
+     * Passed to the agent so it can decide when to read the variable.
+     * Truncated to {@link MAX_ENV_VAR_DESCRIPTION_LENGTH} characters.
+     */
+    description?: string;
+};
+/**
+ * Configures the runtime context the agent has access to during a check.
+ *
+ * `agentRuntime` is the explicit allowlist of resources the agent may use
+ * at execution time. Anything not declared here is unavailable to the agent.
+ * Treat it as a security boundary: the smaller the runtime surface, the
+ * smaller the blast radius of any prompt injection.
+ */
+export interface AgentRuntime {
+    /**
+     * Additional skills to load into the agent's runtime, on top of the
+     * defaults the runner provides automatically (currently the
+     * `playwright-cli` skill is preloaded for browser automation).
+     *
+     * Each entry is passed verbatim to `npx skills add` on the runner, so
+     * any third-party skill published to [skills.sh](https://skills.sh)
+     * works — not just Checkly's own. Supported identifier forms:
+     *
+     * - A full skills.sh URL — e.g. `'https://skills.sh/microsoft/playwright-cli/playwright-cli'`
+     * - A `<owner>/<repo>` shorthand — e.g. `'addyosmani/web-quality-skills'`
+     * - A plain skill name registered on skills.sh — e.g. `'cost-optimization'`
+     *
+     * @example ['addyosmani/web-quality-skills']
+     */
+    skills?: string[];
+    /**
+     * Environment variables the agent is permitted to read at runtime.
+     *
+     * **Variables not listed here are not exposed to the agent**, even if
+     * they exist in the Checkly account. This is the primary defense against
+     * prompt injection: an attacker who controls content the agent reads
+     * cannot exfiltrate secrets the agent never had access to.
+     *
+     * Each entry is either a bare variable name, or an object with a
+     * `name` and an optional `description`. Descriptions help the agent
+     * understand what each variable is for.
+     *
+     * @example
+     * ```typescript
+     * exposeEnvironmentVariables: [
+     *   'API_KEY',
+     *   { name: 'TEST_USER_PASSWORD', description: 'Login password for the test account' },
+     * ]
+     * ```
+     */
+    exposeEnvironmentVariables?: AgentRuntimeEnvironmentVariable[];
+}
+/**
+ * Configuration properties for {@link AgenticCheck}.
+ *
+ * Agentic checks intentionally expose only the subset of options that the
+ * Checkly platform currently supports for them. Properties such as
+ * `locations`, `privateLocations`, `runParallel`, `retryStrategy`,
+ * `shouldFail`, `doubleCheck`, `triggerIncident` and `groupId` are omitted
+ * because the platform does not yet honor them for agentic checks. They will
+ * be added back as additive, non-breaking changes once support lands.
+ */
+export interface AgenticCheckProps extends Omit<CheckProps, 'locations' | 'privateLocations' | 'runParallel' | 'retryStrategy' | 'shouldFail' | 'doubleCheck' | 'triggerIncident' | 'groupId' | 'frequency'> {
+    /**
+     * The prompt that defines what the agentic check should verify.
+     * Maximum 10,000 characters.
+     */
+    prompt: string;
+    /**
+     * How often the check should run. Agentic checks currently support a
+     * restricted set of frequencies. Defaults to {@link Frequency.EVERY_30M}.
+     *
+     * @example
+     * ```typescript
+     * frequency: Frequency.EVERY_1H
+     * // or equivalently
+     * frequency: 60
+     * ```
+     */
+    frequency?: AgenticCheckFrequency;
+    /**
+     * Configures the runtime context the agent has access to during execution:
+     * which skills it can use, which environment variables it can read, and
+     * (in the future) other access surfaces such as network policies or tool
+     * allowlists.
+     *
+     * Treat `agentRuntime` as a security boundary. Anything not declared here
+     * is unavailable to the agent at runtime, which keeps the blast radius of
+     * any prompt injection as small as possible.
+     */
+    agentRuntime?: AgentRuntime;
+}
+/**
+ * Creates an Agentic Check that uses AI to monitor websites and applications.
+ *
+ * Agentic checks use a prompt to define what should be verified, without
+ * requiring traditional scripts. The AI agent interprets the prompt and
+ * performs the checks.
+ *
+ * @example
+ * ```typescript
+ * new AgenticCheck('homepage-health', {
+ *   name: 'Homepage Health Check',
+ *   prompt: `
+ *     Navigate to https://example.com and verify:
+ *     1. The page loads with a 200 status
+ *     2. The main heading is visible
+ *     3. No console errors are present
+ *   `,
+ * })
+ * ```
+ */
+export declare class AgenticCheck extends Check {
+    readonly prompt: string;
+    readonly agentRuntime?: AgentRuntime;
+    /**
+     * Constructs the Agentic Check instance.
+     *
+     * @param logicalId unique project-scoped resource name identification
+     * @param props check configuration properties
+     */
+    constructor(logicalId: string, props: AgenticCheckProps);
+    describe(): string;
+    validate(diagnostics: Diagnostics): Promise<void>;
+    protected validateAgentRuntime(diagnostics: Diagnostics): Promise<void>;
+    synthesize(): {
+        checkType: "AGENTIC";
+        prompt: string;
+        agentRuntime: {
+            skills: string[];
+            exposeEnvironmentVariables: AgentRuntimeEnvironmentVariable[];
+        };
+        activated: boolean | undefined;
+        muted: boolean | undefined;
+        shouldFail: boolean | undefined;
+        locations: (keyof import("..").Region)[] | undefined;
+        privateLocations: undefined;
+        tags: string[] | undefined;
+        frequency: number | undefined;
+        frequencyOffset: number | undefined;
+        groupId: import("./ref").Ref | null;
+        retryStrategy: import("./retry-strategy").LinearRetryStrategy | import("./retry-strategy").ExponentialRetryStrategy | import("./retry-strategy").FixedRetryStrategy | import("./retry-strategy").SingleRetryRetryStrategy | null | undefined;
+        doubleCheck: boolean | undefined;
+        alertSettings: import("./alert-escalation-policy").AlertEscalation | undefined;
+        useGlobalAlertSettings: boolean | undefined;
+        runParallel: boolean | undefined;
+        triggerIncident: {
+            serviceId: import("./ref").Ref;
+            severity: "MINOR" | "MEDIUM" | "MAJOR" | "CRITICAL";
+            name: string;
+            description: string;
+            notifySubscribers: boolean;
+        } | undefined;
+        description?: string | undefined;
+        name: string;
+    };
+}