checkly 7.4.0 → 7.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "checkly",
-  "version": "7.4.0",
+  "version": "7.5.0",
   "description": "Checkly CLI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -70,9 +70,15 @@
       "env": {
         "description": "Manage Checkly environment variables."
       },
+      "incidents": {
+        "description": "Create and manage status page incidents."
+      },
       "import": {
         "description": "Import existing resources from your Checkly account to your project."
       },
+      "skills": {
+        "description": "Explore Checkly AI agent skills, actions and reference documentation."
+      },
       "status-pages": {
         "description": "List and manage status pages in your Checkly account."
       }

package/dist/ai-context/skills/monitoring/README.md

@@ -1,55 +0,0 @@
-# Checkly CLI Monitoring Agent Skill
-
-This directory contains the agent skill for creating and managing end-to-end testing, monitoring, & observability with an AI-native workflow using Checkly.
-
-## Structure
-
-```
-skills/
-└── monitoring/
-    ├── README.md             # Documentation about the skill
-    ├── SKILL.md              # Main skill instructions
-    └── references/           # Detailed construct documentation
-        ├── api-checks.md
-        ├── browser-checks.md
-        ├── playwright-checks.md
-        ├── multistep-checks.md
-        ├── monitors.md
-        ├── check-groups.md
-        ├── alert-channels.md
-        └── supporting-constructs.md
-```
-
-## What is an Agent Skill?
-
-Agent Skills are a standardized format for giving AI agents specialized knowledge and workflows. This skill teaches agents how to:
-
-- Create and manage API checks, Browser Checks, URL monitors, and other monitors
-- Set up Playwright-based Browser and Multistep checks and Playwright Check Suites
-- Configure Heartbeat Monitors for cron jobs and scheduled tasks
-- Define alert channels (email, Slack, phone, webhooks, etc.)
-- Build dashboards and status pages
-- Follow monitoring-as-code best practices with the Checkly CLI
-
-## Using This Skill
-
-AI agents can load this skill to gain expertise in Checkly monitoring. The skill follows the [Agent Skills specification](https://agentskills.io) with:
-
-- **SKILL.md**: Core instructions loaded when the skill is activated
-- **references/**: Detailed documentation loaded on demand
-
-## Progressive Disclosure
-
-The skill is structured for efficient context usage:
-
-1. **Metadata** (~80 tokens): Name and description in frontmatter
-2. **Core Instructions** (~1K tokens): Main SKILL.md content with links to references
-3. **References** (loaded on demand): Detailed construct documentation with examples
-
-Agents load what they need for each task.
-
-## Learn More
-
-- [Checkly CLI Documentation](https://www.checklyhq.com/docs/cli/overview/)
-- [Checkly Constructs Reference](https://www.checklyhq.com/docs/constructs/overview/)
-- [Agent Skills Specification](https://agentskills.io/specification.md)

package/dist/ai-context/skills/monitoring/references/uptime-monitors.md

@@ -1,206 +0,0 @@
-# Monitors
-
-## TCP Monitor
-
-- Import the `TcpMonitor` construct from `checkly/constructs`.
-- When adding `assertions`, always use `TcpAssertionBuilder` class for TCP monitors.
-
-**Reference:** https://www.checklyhq.com/docs/constructs/tcp-monitor/
-
-```typescript
-import { AlertEscalationBuilder, Frequency, RetryStrategyBuilder, TcpAssertionBuilder, TcpMonitor } from 'checkly/constructs'
-
-new TcpMonitor('example-tcp-monitor', {
-  name: 'Example TCP Monitor',
-  degradedResponseTime: 5000,
-  maxResponseTime: 5000,
-  activated: true,
-  locations: [
-    'eu-central-1',
-    'eu-west-2',
-  ],
-  frequency: Frequency.EVERY_1H,
-  alertEscalationPolicy: AlertEscalationBuilder.runBasedEscalation(1, {
-    amount: 0,
-    interval: 5,
-  }, {
-    enabled: false,
-    percentage: 10,
-  }),
-  retryStrategy: RetryStrategyBuilder.linearStrategy({
-    baseBackoffSeconds: 60,
-    maxRetries: 2,
-    maxDurationSeconds: 600,
-    sameRegion: true,
-  }),
-  runParallel: true,
-  request: {
-    hostname: 'tcp.example.com',
-    port: 4242,
-    ipFamily: 'IPv4',
-    assertions: [
-      TcpAssertionBuilder.responseTime().lessThan(200),
-      TcpAssertionBuilder.responseData().isEmpty(),
-    ],
-  },
-})
-```
-
-## URL Monitor
-
-- Import the `UrlMonitor` construct from `checkly/constructs`.
-- When adding `assertions`, always use `UrlAssertionBuilder`.
-
-**Reference:** https://www.checklyhq.com/docs/constructs/url-monitor/
-
-```typescript
-import { AlertEscalationBuilder, Frequency, RetryStrategyBuilder, UrlAssertionBuilder, UrlMonitor } from 'checkly/constructs'
-
-new UrlMonitor('example-url-monitor', {
-  name: 'Example URL Monitor',
-  activated: true,
-  locations: [
-    'eu-central-1',
-    'eu-west-2',
-  ],
-  frequency: Frequency.EVERY_5M,
-  alertEscalationPolicy: AlertEscalationBuilder.runBasedEscalation(1, {
-    amount: 0,
-    interval: 5,
-  }, {
-    enabled: false,
-    percentage: 10,
-  }),
-  retryStrategy: RetryStrategyBuilder.linearStrategy({
-    baseBackoffSeconds: 60,
-    maxRetries: 2,
-    maxDurationSeconds: 600,
-    sameRegion: true,
-  }),
-  runParallel: true,
-  degradedResponseTime: 5000,
-  maxResponseTime: 20000,
-  request: {
-    url: 'https://example.com',
-    ipFamily: 'IPv4',
-    assertions: [
-      UrlAssertionBuilder.statusCode().equals(200),
-    ],
-  },
-})
-```
-
-## DNS Monitor
-
-- Import the `DnsMonitor` construct from `checkly/constructs`.
-- Reference [the docs for DNS monitors](https://www.checklyhq.com/docs/constructs/dns-monitor/) before generating any code.
-- When adding `assertions`, always use `DnsAssertionBuilder` class.
-
-**Reference:** https://www.checklyhq.com/docs/constructs/dns-monitor/
-
-```typescript
-import { AlertEscalationBuilder, DnsAssertionBuilder, DnsMonitor, Frequency, RetryStrategyBuilder } from 'checkly/constructs'
-
-new DnsMonitor('example-dns-monitor', {
-  name: 'Example DNS Monitor',
-  degradedResponseTime: 500,
-  maxResponseTime: 1000,
-  activated: true,
-  locations: [
-    'eu-central-1',
-    'eu-north-1',
-  ],
-  frequency: Frequency.EVERY_10M,
-  alertEscalationPolicy: AlertEscalationBuilder.runBasedEscalation(1, {
-    amount: 0,
-    interval: 5,
-  }, {
-    enabled: false,
-    percentage: 10,
-  }),
-  retryStrategy: RetryStrategyBuilder.noRetries(),
-  request: {
-    recordType: 'AAAA',
-    query: 'welcome.checklyhq.com',
-    assertions: [
-      DnsAssertionBuilder.responseCode().equals('NOERROR'),
-    ],
-  },
-})
-```
-
-### ICMP Monitor
-
-- Import the `IcmpMonitor` construct from `checkly/constructs`.
-- Reference [the docs for ICMP monitors](https://www.checklyhq.com/docs/constructs/icmp-monitor/) before generating any code.
-- When adding `assertions`, always use `IcmpAssertionBuilder` class.
-- Latency assertions require a property parameter: `'avg'`, `'min'`, `'max'`, or `'stdDev'`.
-- Use `degradedPacketLossThreshold` and `maxPacketLossThreshold` for packet loss thresholds (percentages).
-
-**Reference:** https://www.checklyhq.com/docs/constructs/icmp-monitor/
-
-```typescript
-import { AlertEscalationBuilder, Frequency, IcmpAssertionBuilder, IcmpMonitor, RetryStrategyBuilder } from 'checkly/constructs'
-
-new IcmpMonitor('example-icmp-monitor', {
-  name: 'Example ICMP Monitor',
-  request: {
-    hostname: '1.1.1.1',
-    pingCount: 10,
-    assertions: [
-      IcmpAssertionBuilder.latency('avg').lessThan(100),
-      IcmpAssertionBuilder.latency('max').lessThan(200),
-    ],
-  },
-  degradedPacketLossThreshold: 10,
-  maxPacketLossThreshold: 20,
-  activated: true,
-  locations: [
-    'eu-central-1',
-    'eu-north-1',
-  ],
-  frequency: Frequency.EVERY_10M,
-  alertEscalationPolicy: AlertEscalationBuilder.runBasedEscalation(1, {
-    amount: 0,
-    interval: 5,
-  }, {
-    enabled: false,
-    percentage: 10,
-  }),
-  retryStrategy: RetryStrategyBuilder.noRetries(),
-})
-```
-
-## Heartbeat Monitor
-
-- Import the `HeartbeatMonitor` construct from `checkly/constructs`.
-
-**Reference:** https://www.checklyhq.com/docs/constructs/heartbeat-monitor/
-
-```typescript
-import { AlertEscalationBuilder, Frequency, HeartbeatMonitor, RetryStrategyBuilder } from 'checkly/constructs'
-
-new HeartbeatMonitor('example-heartbeat-monitor', {
-  name: 'Example Heartbeat Monitor',
-  period: 1,
-  periodUnit: 'hours',
-  grace: 30,
-  graceUnit: 'minutes',
-  activated: true,
-  frequency: Frequency.EVERY_10S,
-  alertEscalationPolicy: AlertEscalationBuilder.runBasedEscalation(1, {
-    amount: 0,
-    interval: 5,
-  }, {
-    enabled: false,
-    percentage: 10,
-  }),
-  retryStrategy: RetryStrategyBuilder.linearStrategy({
-    baseBackoffSeconds: 60,
-    maxRetries: 2,
-    maxDurationSeconds: 600,
-    sameRegion: true,
-  }),
-  runParallel: true,
-})
-```