@switchbot/openapi-cli 3.3.2 → 3.4.0

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

@@ -78,6 +78,37 @@
         "rules": {
           "type": ["array", "null"],
           "items": { "$ref": "#/$defs/rule" }
+        },
+        "audit": {
+          "type": ["object", "null"],
+          "additionalProperties": false,
+          "description": "Controls rule-evaluate trace recording.",
+          "properties": {
+            "evaluate_trace": {
+              "enum": ["full", "sampled", "off"],
+              "default": "sampled",
+              "description": "full=every evaluation; sampled=skip high-freq blocked-by-condition; off=disabled."
+            },
+            "evaluate_retention_days": {
+              "type": "integer",
+              "minimum": 1,
+              "default": 7,
+              "description": "Days to retain rule-evaluate records."
+            }
+          }
+        },
+        "llm_budget": {
+          "type": ["object", "null"],
+          "additionalProperties": false,
+          "description": "Global LLM call budget applied across all llm conditions.",
+          "properties": {
+            "max_calls_per_hour": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 60,
+              "description": "Maximum LLM condition calls per hour across all rules."
+            }
+          }
         }
       }
     },
@@ -299,15 +330,54 @@
               "description": "Negates the sub-condition."
             }
           }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["llm"],
+          "properties": {
+            "llm": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["prompt"],
+              "description": "Evaluate the condition using an LLM decision call.",
+              "properties": {
+                "prompt": { "type": "string", "minLength": 1, "description": "Prompt template sent to the LLM." },
+                "provider": { "enum": ["auto", "openai", "anthropic"], "default": "auto" },
+                "timeout_ms": { "type": "integer", "minimum": 500, "maximum": 10000, "default": 5000 },
+                "cache_ttl": { "type": "string", "pattern": "^(none|\\d+[smh])$", "default": "5m" },
+                "budget": {
+                  "type": ["object", "null"],
+                  "additionalProperties": false,
+                  "properties": {
+                    "max_calls_per_hour": { "type": "integer", "minimum": 0, "default": 10 }
+                  }
+                },
+                "on_error": { "enum": ["fail", "pass", "skip"], "default": "fail" },
+                "recent_events": { "type": "integer", "minimum": 0, "maximum": 20, "default": 5 }
+              }
+            }
+          }
         }
       ]
     },
 
     "action": {
+      "oneOf": [
+        { "$ref": "#/$defs/commandAction" },
+        { "$ref": "#/$defs/notifyAction" }
+      ]
+    },
+
+    "commandAction": {
       "type": "object",
       "additionalProperties": false,
       "required": ["command"],
       "properties": {
+        "type": {
+          "enum": ["command"],
+          "description": "Optional discriminator. Omit for backwards compatibility."
+        },
         "command": {
           "type": "string",
           "description": "A CLI invocation fragment, e.g. `devices command <id> turnOn`. The engine prepends `switchbot` and appends `--audit-log`."
@@ -326,6 +396,38 @@
           "description": "If this action fails, should the rule keep executing its remaining `then[]` entries?"
         }
       }
+    },
+
+    "notifyAction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "channel", "to"],
+      "properties": {
+        "type": { "const": "notify" },
+        "channel": {
+          "enum": ["webhook", "openclaw", "file"],
+          "description": "Delivery channel."
+        },
+        "to": {
+          "type": "string",
+          "minLength": 1,
+          "description": "URL for webhook/openclaw; absolute file path for file channel."
+        },
+        "template": {
+          "type": "string",
+          "description": "Template string with {{ rule.name }}, {{ event.* }}, {{ device.id }} substitutions."
+        },
+        "on_failure": {
+          "enum": ["log", "retry", "ignore"],
+          "default": "log",
+          "description": "What to do when delivery fails."
+        },
+        "on_error": {
+          "enum": ["continue", "stop"],
+          "default": "continue",
+          "description": "If this action fails, should the rule keep executing its remaining `then[]` entries?"
+        }
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@switchbot/openapi-cli",
-  "version": "3.3.2",
+  "version": "3.4.0",
   "description": "SwitchBot smart home CLI — control devices, run scenes, stream real-time events, and integrate AI agents via MCP. Full API v1.1 coverage.",
   "keywords": [
     "switchbot",