@switchbot/openapi-cli 2.7.2 → 3.0.0

package/dist/policy/diff.js

@@ -0,0 +1,91 @@
+export const MAX_POLICY_DIFF_CHANGES = 200;
+function isPlainObject(v) {
+    return !!v && typeof v === 'object' && !Array.isArray(v);
+}
+function collectPolicyDiff(left, right, at, out, limit) {
+    if (out.length >= limit)
+        return;
+    if (Array.isArray(left) && Array.isArray(right)) {
+        const maxLen = Math.max(left.length, right.length);
+        for (let i = 0; i < maxLen; i++) {
+            if (out.length >= limit)
+                return;
+            const path = `${at}[${i}]`;
+            if (i >= left.length) {
+                out.push({ path, kind: 'added', after: right[i] });
+            }
+            else if (i >= right.length) {
+                out.push({ path, kind: 'removed', before: left[i] });
+            }
+            else {
+                collectPolicyDiff(left[i], right[i], path, out, limit);
+            }
+        }
+        return;
+    }
+    if (isPlainObject(left) && isPlainObject(right)) {
+        const keys = new Set([...Object.keys(left), ...Object.keys(right)]);
+        for (const key of [...keys].sort()) {
+            if (out.length >= limit)
+                return;
+            const path = at === '$' ? `$.${key}` : `${at}.${key}`;
+            const leftHas = Object.prototype.hasOwnProperty.call(left, key);
+            const rightHas = Object.prototype.hasOwnProperty.call(right, key);
+            if (!leftHas && rightHas) {
+                out.push({ path, kind: 'added', after: right[key] });
+            }
+            else if (leftHas && !rightHas) {
+                out.push({ path, kind: 'removed', before: left[key] });
+            }
+            else {
+                collectPolicyDiff(left[key], right[key], path, out, limit);
+            }
+        }
+        return;
+    }
+    if (!Object.is(left, right)) {
+        out.push({ path: at, kind: 'changed', before: left, after: right });
+    }
+}
+function buildLineDiff(before, after) {
+    const beforeLines = before.split('\n');
+    const afterLines = after.split('\n');
+    const lines = ['--- before', '+++ after'];
+    let i = 0;
+    let j = 0;
+    while (i < beforeLines.length || j < afterLines.length) {
+        const b = beforeLines[i];
+        const a = afterLines[j];
+        if (i < beforeLines.length && j < afterLines.length && b === a) {
+            lines.push(` ${b}`);
+            i++;
+            j++;
+        }
+        else if (j < afterLines.length && (i >= beforeLines.length || b !== a)) {
+            lines.push(`+${a}`);
+            j++;
+        }
+        else {
+            lines.push(`-${b}`);
+            i++;
+        }
+    }
+    return lines.join('\n');
+}
+export function diffPolicyValues(leftDoc, rightDoc, leftSource, rightSource, maxChanges = MAX_POLICY_DIFF_CHANGES) {
+    const changes = [];
+    collectPolicyDiff(leftDoc, rightDoc, '$', changes, maxChanges);
+    const equal = changes.length === 0;
+    return {
+        equal,
+        changeCount: changes.length,
+        truncated: changes.length >= maxChanges,
+        stats: {
+            added: changes.filter((c) => c.kind === 'added').length,
+            removed: changes.filter((c) => c.kind === 'removed').length,
+            changed: changes.filter((c) => c.kind === 'changed').length,
+        },
+        changes,
+        diff: buildLineDiff(leftSource, rightSource),
+    };
+}

package/dist/policy/examples/policy.example.yaml

@@ -0,0 +1,99 @@
+# ============================================================================
+#  SwitchBot policy — example
+# ============================================================================
+#  Copy this file to your user config directory and edit it:
+#
+#    mkdir -p ~/.switchbot
+#    cp policy.example.yaml ~/.switchbot/policy.yaml
+#
+#  Every section is OPTIONAL. If a field isn't set, the CLI/agent layer falls back to
+#  a safe default (documented next to each field).
+#
+#  Agents read this file before every session. They never write to it
+#  without showing you the diff and asking first.
+# ============================================================================
+
+# Schema version. Do not remove this line — the skill uses it to detect
+# breaking changes and migrate your file when a newer schema ships.
+version: "0.2"
+
+# ----------------------------------------------------------------------------
+# aliases  —  friendly names the agent can resolve to real devices
+# ----------------------------------------------------------------------------
+# The #1 reason to have a policy file. Without aliases, the agent has to
+# guess which device you mean when you say "the bedroom light", and it can
+# guess wrong if two devices have similar names.
+#
+# Get each deviceId from:
+#   switchbot devices list --format=tsv
+#
+# The format is:  "what the user says": "<deviceId>"
+# Quote the key if it contains spaces or non-ASCII characters.
+aliases:
+  # "living room light": "01-202407090924-26354212"
+  # "bedroom AC":        "02-202502111234-85411230"
+  # "front door lock":   "03-202501201700-99887766"
+  # "kitchen plug":      "04-202503081500-55443322"
+
+# ----------------------------------------------------------------------------
+# confirmations  —  which actions require explicit user approval
+# ----------------------------------------------------------------------------
+# The skill already refuses destructive actions (locks, deletions) by
+# default. Use this section to adjust the defaults for your account.
+#
+# always_confirm: extra actions that need confirmation even though they
+#                 wouldn't by default (e.g. you never want the agent to
+#                 turn on the AC without asking).
+# never_confirm:  actions that normally confirm but you trust (NEVER add
+#                 destructive actions here — the skill will reject that).
+confirmations:
+  always_confirm:
+    # - "setTargetTemperature"
+    # - "setThermostatMode"
+
+  never_confirm:
+    # - "turnOn"
+    # - "turnOff"
+
+# ----------------------------------------------------------------------------
+# quiet_hours  —  during these hours, every mutation requires confirmation
+# ----------------------------------------------------------------------------
+# Times are 24-hour, local system time. If omitted, no quiet hours apply.
+quiet_hours:
+  # start: "22:00"
+  # end:   "08:00"
+
+# ----------------------------------------------------------------------------
+# audit  —  where to log every action the agent takes
+# ----------------------------------------------------------------------------
+# The skill ALWAYS logs mutations and destructive actions. This section
+# controls where the log goes and how long it's kept.
+audit:
+  # Path for the audit log. "~" is expanded. JSON Lines format.
+  log_path: "~/.switchbot/audit.log"
+
+  # How long to keep log lines. "never" disables rotation. Accepts units:
+  # d (days), w (weeks), m (months). Default: "90d".
+  retention: "90d"
+
+# ----------------------------------------------------------------------------
+# automation  —  Phase 4 (rule engine). Leave `enabled: false` for now.
+# ----------------------------------------------------------------------------
+# The rule engine ships in Phase 4. This section is reserved so the schema
+# validates today; if you set `enabled: true` before Phase 4 lands, the
+# skill will warn you and ignore it.
+automation:
+  enabled: false
+  # rules: []
+
+# ----------------------------------------------------------------------------
+# cli  —  optional CLI-level overrides
+# ----------------------------------------------------------------------------
+cli:
+  # Which profile to use if you have multiple SwitchBot accounts. The CLI
+  # supports `switchbot --profile <name>`. Default: "default".
+  profile: "default"
+
+  # Device cache TTL. The skill refreshes the cache when it's older than
+  # this. Defaults to the CLI's own default (typically 5 minutes).
+  # cache_ttl: "5m"

package/dist/policy/format.js

@@ -0,0 +1,57 @@
+import chalk, { Chalk } from 'chalk';
+const noColorChalk = new Chalk({ level: 0 });
+function colorize(enabled) {
+    return enabled ? chalk : noColorChalk;
+}
+function snippet(source, line, col, length, c) {
+    const lines = source.split(/\r?\n/);
+    if (line < 1 || line > lines.length)
+        return '';
+    const lineText = lines[line - 1];
+    const gutter = `  ${line} | `;
+    const pad = ' '.repeat(gutter.length);
+    const caretStart = Math.max(0, col - 1);
+    const caretLen = Math.max(1, length);
+    const caret = `${' '.repeat(caretStart)}${c.red('^'.repeat(caretLen))}`;
+    return `${c.dim(gutter)}${lineText}\n${c.dim(pad)}${caret}`;
+}
+function estimateTokenLength(source, line, col) {
+    const lines = source.split(/\r?\n/);
+    if (line < 1 || line > lines.length)
+        return 1;
+    const lineText = lines[line - 1];
+    const start = Math.max(0, col - 1);
+    if (start >= lineText.length)
+        return 1;
+    const rest = lineText.slice(start);
+    const quoted = rest.match(/^(['"]).*?\1/);
+    if (quoted)
+        return quoted[0].length;
+    const token = rest.match(/^[^\s,\[\]{}]+/);
+    return token ? token[0].length : 1;
+}
+function formatError(err, policyPath, source, opts) {
+    const c = colorize(opts.color ?? true);
+    const loc = err.line !== undefined && err.col !== undefined ? `${err.line}:${err.col}` : '(unknown)';
+    const header = `${c.cyan(policyPath)}:${c.yellow(loc)}`;
+    const body = [`${c.red.bold('error')}: ${err.message}`];
+    if (err.line !== undefined && err.col !== undefined && !opts.noSnippet) {
+        const len = estimateTokenLength(source, err.line, err.col);
+        const snip = snippet(source, err.line, err.col, len, c);
+        if (snip)
+            body.unshift(snip);
+    }
+    if (err.hint)
+        body.push(`${c.green.bold('hint')}:  ${err.hint}`);
+    return [header, ...body].join('\n');
+}
+export function formatValidationResult(result, source, opts = {}) {
+    const c = colorize(opts.color ?? true);
+    if (result.valid) {
+        return `${c.green.bold('✓')} ${result.policyPath} is valid (schema v${result.schemaVersion})`;
+    }
+    const blocks = result.errors.map((e) => formatError(e, result.policyPath, source, opts));
+    const count = result.errors.length;
+    const footer = `${c.red.bold(`✗ ${count} ${count === 1 ? 'error' : 'errors'}`)} in ${result.policyPath} (schema v${result.schemaVersion})`;
+    return [...blocks, '', footer].join('\n\n').replace(/\n{3,}/g, '\n\n');
+}

package/dist/policy/load.js

@@ -0,0 +1,61 @@
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { parseDocument, LineCounter } from 'yaml';
+export const DEFAULT_POLICY_PATH = join(homedir(), '.config', 'openclaw', 'switchbot', 'policy.yaml');
+export function resolvePolicyPath(options = {}) {
+    const { flag, env = process.env } = options;
+    if (flag && flag.trim().length > 0)
+        return resolve(flag);
+    const fromEnv = env.SWITCHBOT_POLICY_PATH;
+    if (fromEnv && fromEnv.trim().length > 0)
+        return resolve(fromEnv);
+    return DEFAULT_POLICY_PATH;
+}
+export class PolicyFileNotFoundError extends Error {
+    policyPath;
+    constructor(policyPath) {
+        super(`policy file not found: ${policyPath}`);
+        this.policyPath = policyPath;
+        this.name = 'PolicyFileNotFoundError';
+    }
+}
+export class PolicyYamlParseError extends Error {
+    policyPath;
+    yamlErrors;
+    constructor(message, policyPath, yamlErrors) {
+        super(message);
+        this.policyPath = policyPath;
+        this.yamlErrors = yamlErrors;
+        this.name = 'PolicyYamlParseError';
+    }
+}
+export function loadPolicyFile(policyPath) {
+    let source;
+    try {
+        source = readFileSync(policyPath, 'utf-8');
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === 'ENOENT')
+            throw new PolicyFileNotFoundError(policyPath);
+        throw err;
+    }
+    const lineCounter = new LineCounter();
+    const doc = parseDocument(source, { lineCounter, keepSourceTokens: true });
+    if (doc.errors.length > 0) {
+        const yamlErrors = doc.errors.map((e) => {
+            const pos = e.pos?.[0];
+            const loc = pos !== undefined ? lineCounter.linePos(pos) : undefined;
+            return { line: loc?.line, col: loc?.col, message: e.message };
+        });
+        throw new PolicyYamlParseError(doc.errors[0].message, policyPath, yamlErrors);
+    }
+    return {
+        path: policyPath,
+        source,
+        doc,
+        lineCounter,
+        data: doc.toJS({ maxAliasCount: 100 }),
+    };
+}

package/dist/policy/migrate.js

@@ -0,0 +1,67 @@
+import { isMap, isScalar, parseDocument, LineCounter } from 'yaml';
+import { validateLoadedPolicy } from './validate.js';
+export class PolicyMigrationError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'PolicyMigrationError';
+    }
+}
+const MIGRATION_CHAIN = [];
+function bumpVersionScalar(doc, target) {
+    if (!isMap(doc.contents)) {
+        throw new PolicyMigrationError('policy root must be a YAML mapping (got null or an array)', 'invalid-shape');
+    }
+    const pair = doc.contents.items.find((p) => isScalar(p.key) && p.key.value === 'version');
+    if (!pair || !isScalar(pair.value)) {
+        throw new PolicyMigrationError('policy has no `version` scalar to migrate; add `version: "0.2"` (or `"0.1"`) and retry', 'no-version-field');
+    }
+    pair.value.value = target;
+}
+function findPlan(from, to) {
+    const chain = [];
+    let cur = from;
+    while (cur !== to) {
+        const step = MIGRATION_CHAIN.find((p) => p.fromVersion === cur);
+        if (!step) {
+            throw new PolicyMigrationError(`no migration path from v${from} to v${to} (missing step at v${cur})`, 'no-path');
+        }
+        chain.push(step);
+        cur = step.toVersion;
+    }
+    return chain;
+}
+export function planMigration(loaded, from, to) {
+    if (from === to) {
+        const precheck = validateLoadedPolicy(loaded);
+        return { changed: false, fromVersion: from, toVersion: to, nextSource: loaded.source, precheck };
+    }
+    const plan = findPlan(from, to);
+    // Round-trip through source instead of Document.clone(): keeps comments +
+    // anchors intact, works across yaml library versions, and leaves the
+    // caller's `loaded.doc` untouched.
+    const nextLineCounter = new LineCounter();
+    const clone = parseDocument(loaded.source, {
+        lineCounter: nextLineCounter,
+        keepSourceTokens: true,
+    });
+    for (const step of plan)
+        step.migrate(clone);
+    const nextSource = String(clone);
+    // Re-parse after serialization so `doc` and `source` stay in sync for the
+    // validator's line/col mapping.
+    const reLineCounter = new LineCounter();
+    const reDoc = parseDocument(nextSource, {
+        lineCounter: reLineCounter,
+        keepSourceTokens: true,
+    });
+    const precheck = validateLoadedPolicy({
+        path: loaded.path,
+        source: nextSource,
+        doc: reDoc,
+        lineCounter: reLineCounter,
+        data: reDoc.toJS({ maxAliasCount: 100 }),
+    });
+    return { changed: true, fromVersion: from, toVersion: to, nextSource, precheck };
+}

package/dist/policy/schema/v0.2.json

@@ -0,0 +1,302 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.openclaw.ai/switchbot/v0.2/policy.json",
+  "title": "OpenClaw SwitchBot policy v0.2",
+  "description": "Tightens the `automation.rules[]` shape that v0.1 left as a loose `array of object`. Validator reads this when the policy file's top-level `version` field is \"0.2\". See docs/design/phase4-rules-schema.md for the field-level rationale.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "const": "0.2",
+      "description": "Policy schema version. Will migrate 0.1 -> 0.2 in place via `switchbot policy migrate`."
+    },
+
+    "aliases": {
+      "type": ["object", "null"],
+      "description": "Unchanged from v0.1.",
+      "additionalProperties": {
+        "type": "string",
+        "pattern": "^[A-Z0-9]{2,}-[A-Z0-9-]+$"
+      }
+    },
+
+    "confirmations": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "description": "Unchanged from v0.1.",
+      "properties": {
+        "always_confirm": {
+          "type": ["array", "null"],
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "never_confirm": {
+          "type": ["array", "null"],
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "not": {
+              "enum": ["lock", "unlock", "deleteWebhook", "deleteScene", "factoryReset"]
+            }
+          }
+        }
+      }
+    },
+
+    "quiet_hours": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "description": "Unchanged from v0.1.",
+      "properties": {
+        "start": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" },
+        "end":   { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }
+      },
+      "dependentRequired": { "start": ["end"], "end": ["start"] }
+    },
+
+    "audit": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "properties": {
+        "log_path":  { "type": "string", "minLength": 1 },
+        "retention": { "type": "string", "pattern": "^(never|\\d+[dwm])$" }
+      }
+    },
+
+    "automation": {
+      "type": ["object", "null"],
+      "description": "In v0.2, `rules[]` gets a real shape. `enabled: false` still fully disables the engine regardless of rules defined.",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": false
+        },
+        "rules": {
+          "type": ["array", "null"],
+          "items": { "$ref": "#/$defs/rule" }
+        }
+      }
+    },
+
+    "cli": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "description": "Unchanged from v0.1.",
+      "properties": {
+        "profile":   { "type": "string", "minLength": 1, "default": "default" },
+        "cache_ttl": { "type": "string", "pattern": "^\\d+[smh]$" }
+      }
+    }
+  },
+
+  "$defs": {
+    "rule": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "when", "then"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Human label used in audit log and dry-run output. Unique per policy file."
+        },
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Lets you disable a single rule without deleting it."
+        },
+        "when": { "$ref": "#/$defs/trigger" },
+        "conditions": {
+          "type": ["array", "null"],
+          "description": "Optional AND-joined gates evaluated after the trigger matches. All must pass for the rule to fire.",
+          "items": { "$ref": "#/$defs/condition" }
+        },
+        "then": {
+          "type": "array",
+          "minItems": 1,
+          "description": "One or more actions executed in order. If any action fails, the remainder still runs (policy log records each result).",
+          "items": { "$ref": "#/$defs/action" }
+        },
+        "throttle": {
+          "type": ["object", "null"],
+          "additionalProperties": false,
+          "description": "Optional rate limit. Applied per-rule, keyed by the trigger's deviceId when present.",
+          "properties": {
+            "max_per": {
+              "type": "string",
+              "pattern": "^\\d+[smh]$",
+              "description": "Minimum spacing between fires, e.g. \"10m\". Later triggers inside the window are suppressed and audited."
+            }
+          },
+          "required": ["max_per"]
+        },
+        "dry_run": {
+          "type": "boolean",
+          "default": true,
+          "description": "When true, actions write to the audit log (kind=dry-run) but do NOT hit the SwitchBot API."
+        }
+      }
+    },
+
+    "trigger": {
+      "type": "object",
+      "oneOf": [
+        { "$ref": "#/$defs/triggerMqtt" },
+        { "$ref": "#/$defs/triggerCron" },
+        { "$ref": "#/$defs/triggerWebhook" }
+      ]
+    },
+
+    "triggerMqtt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source", "event"],
+      "properties": {
+        "source": { "const": "mqtt" },
+        "event": {
+          "type": "string",
+          "description": "Event type from `switchbot events mqtt-tail --json`, e.g. `motion.detected`, `contact.opened`, `button.pressed`, `device.shadow`."
+        },
+        "device": {
+          "type": "string",
+          "description": "Optional filter by deviceId or alias. Matches the trigger's `deviceId` payload field."
+        }
+      }
+    },
+
+    "triggerCron": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source", "schedule"],
+      "properties": {
+        "source": { "const": "cron" },
+        "schedule": {
+          "type": "string",
+          "description": "Standard 5-field cron (minute hour dom month dow). Interpreted in local system timezone."
+        },
+        "days": {
+          "type": "array",
+          "description": "Optional weekday filter applied after the cron expression fires. Values are full-name or 3-letter day abbreviations (case-insensitive): mon/monday … sun/sunday. When omitted, all days pass.",
+          "uniqueItems": true,
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "enum": ["mon", "tue", "wed", "thu", "fri", "sat", "sun",
+                     "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"]
+          }
+        }
+      }
+    },
+
+    "triggerWebhook": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source", "path"],
+      "properties": {
+        "source": { "const": "webhook" },
+        "path": {
+          "type": "string",
+          "pattern": "^/[a-z0-9/_-]+$",
+          "description": "Local HTTP path the rule engine listens on. Auth + transport are configured elsewhere (Phase 3)."
+        }
+      }
+    },
+
+    "condition": {
+      "description": "Predicate evaluated after the trigger matches. Leaf shapes: time_between, device_state. Composites: all (AND), any (OR), not (negation). `additionalProperties: false` lives on each `oneOf` branch so keys are validated per-shape.",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["time_between"],
+          "properties": {
+            "time_between": {
+              "type": "array",
+              "items": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" },
+              "minItems": 2,
+              "maxItems": 2,
+              "description": "Two HH:MM strings: [start, end]. End-before-start means overnight window."
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["device", "field", "op", "value"],
+          "properties": {
+            "device": { "type": "string", "description": "deviceId or alias" },
+            "field":  { "type": "string", "description": "status field name, e.g. `online`, `power`, `brightness`" },
+            "op":     { "enum": ["==", "!=", "<", ">", "<=", ">="] },
+            "value":  { "description": "Literal to compare against. Booleans, strings, numbers." }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["all"],
+          "properties": {
+            "all": {
+              "type": "array",
+              "minItems": 1,
+              "items": { "$ref": "#/$defs/condition" },
+              "description": "All sub-conditions must be true (logical AND)."
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["any"],
+          "properties": {
+            "any": {
+              "type": "array",
+              "minItems": 1,
+              "items": { "$ref": "#/$defs/condition" },
+              "description": "At least one sub-condition must be true (logical OR)."
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["not"],
+          "properties": {
+            "not": {
+              "$ref": "#/$defs/condition",
+              "description": "Negates the sub-condition."
+            }
+          }
+        }
+      ]
+    },
+
+    "action": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["command"],
+      "properties": {
+        "command": {
+          "type": "string",
+          "description": "A CLI invocation fragment, e.g. `devices command <id> turnOn`. The engine prepends `switchbot` and appends `--audit-log`."
+        },
+        "device": {
+          "type": "string",
+          "description": "deviceId or alias resolved before building the command. Substituted into the `<id>` slot."
+        },
+        "args": {
+          "type": ["object", "null"],
+          "description": "Extra key/value pairs rendered as `--key value` flags."
+        },
+        "on_error": {
+          "enum": ["continue", "stop"],
+          "default": "continue",
+          "description": "If this action fails, should the rule keep executing its remaining `then[]` entries?"
+        }
+      }
+    }
+  }
+}