@zixt/host 0.0.132 → 0.0.133

package/dist/index.js

@@ -28,7 +28,7 @@ import { homedir as homedir4 } from "node:os";
 // package.json
 var package_default = {
   name: "@zixt/host",
-  version: "0.0.132",
+  version: "0.0.133",
   type: "module",
   exports: {
     ".": "./src/client.ts",
@@ -38113,6 +38113,56 @@ var TOOLS = [
       required: ["name", "instructions", "cadence_kind"]
     }
   },
+  {
+    name: "propose_automations",
+    description: 'Recommend recurring Automations WITHOUT creating them: the set is recorded for an organization Admin, who reviews it under Needs attention and on the Automations page and creates or dismisses each item; nothing runs until a person approves. Use this whenever YOU conclude recurring checks would help: after exploring an inbox, an ad account, or a monitoring stack, or after noticing a pattern in your work. Use schedule_task instead only for recurring work this task explicitly asked you to set up. Give each item an honest one-line why. For a system that pushes alerts (Grafana, Sentry, an uptime monitor), propose trigger "webhook" with its name instead of a schedule; the Admin receives the endpoint and secret to paste into it, never you. An empty automations list honestly records that nothing recurring is needed.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        summary: {
+          type: "string",
+          minLength: 1,
+          maxLength: 600,
+          description: "One line: what you explored or noticed, and why these checks."
+        },
+        automations: {
+          type: "array",
+          maxItems: 10,
+          items: {
+            type: "object",
+            properties: {
+              name: { type: "string", minLength: 1, maxLength: 120 },
+              instructions: {
+                type: "string",
+                minLength: 1,
+                maxLength: 1e4,
+                description: "What each run should do; a run with nothing to do ends quietly."
+              },
+              why: {
+                type: "string",
+                minLength: 1,
+                maxLength: 300,
+                description: "Honest one line: why this check helps this business."
+              },
+              trigger: {
+                type: "string",
+                enum: ["schedule", "webhook"],
+                description: "schedule = a cadence below; webhook = an external system pushes."
+              },
+              ...CADENCE_PROPS,
+              webhook_source: {
+                type: "string",
+                maxLength: 120,
+                description: 'webhook-only: the system expected to call (e.g. "Grafana").'
+              }
+            },
+            required: ["name", "instructions", "why", "trigger"]
+          }
+        }
+      },
+      required: ["summary", "automations"]
+    }
+  },
   {
     name: "list_schedules",
     description: "List your own schedules (id, name, cadence, enabled, next run).",
@@ -38424,6 +38474,49 @@ function opFor(name, args) {
         ...endsAt ? { endsAt } : {}
       };
     }
+    case "propose_automations": {
+      const rawItems = args["automations"];
+      if (!Array.isArray(rawItems)) throw new Error("missing required argument `automations`");
+      return {
+        kind: "automation.propose",
+        summary: str("summary"),
+        items: rawItems.map((raw, index) => {
+          if (typeof raw !== "object" || raw === null) {
+            throw new Error(`automations[${index}] must be an object`);
+          }
+          const item = raw;
+          const field = (key) => {
+            const value = item[key];
+            if (typeof value !== "string" || value.length === 0) {
+              throw new Error(`automations[${index}] is missing \`${key}\``);
+            }
+            return value;
+          };
+          const trigger = field("trigger");
+          if (trigger === "webhook") {
+            const source = item["webhook_source"];
+            return {
+              name: field("name"),
+              instructions: field("instructions"),
+              why: field("why"),
+              trigger: {
+                kind: "webhook",
+                source: typeof source === "string" && source ? source : null
+              }
+            };
+          }
+          if (trigger !== "schedule") {
+            throw new Error(`automations[${index}] trigger must be schedule | webhook`);
+          }
+          return {
+            name: field("name"),
+            instructions: field("instructions"),
+            why: field("why"),
+            trigger: { kind: "schedule", cadence: cadenceFrom(item) }
+          };
+        })
+      };
+    }
     case "list_schedules":
       return { kind: "schedule.list" };
     case "cancel_schedule":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zixt/host",
-  "version": "0.0.132",
+  "version": "0.0.133",
   "type": "module",
   "exports": {
     ".": "./src/client.ts",