@zixt/host 0.0.131 → 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.131",
+  version: "0.0.133",
   type: "module",
   exports: {
     ".": "./src/client.ts",
@@ -16864,6 +16864,14 @@ var ScheduleCadence = external_exports.discriminatedUnion("kind", [
     dayOfWeek: external_exports.number().int().min(0).max(6),
     hourUtc: external_exports.number().int().min(0).max(23),
     minuteUtc: external_exports.number().int().min(0).max(59).default(0)
+  }),
+  external_exports.object({
+    kind: external_exports.literal("monthly"),
+    /** 1–28 (UTC) so the occurrence exists in every month; 29–31 is refused
+     * rather than sliding to a guessed last day (SCH-1). */
+    dayOfMonth: external_exports.number().int().min(1).max(28),
+    hourUtc: external_exports.number().int().min(0).max(23),
+    minuteUtc: external_exports.number().int().min(0).max(59).default(0)
   })
 ]);
 var ScheduleSkipReason = external_exports.enum([
@@ -19701,7 +19709,7 @@ var UpdateManagerRequest = external_exports.object({
   /** Optimistic concurrency: refuse when another admin saved first. */
   expectedRevision: external_exports.number().int().min(0).optional()
 }).strict().superRefine((value, ctx) => {
-  if (value.displayName === void 0 && value.instructions === void 0 && value.model === void 0 && value.reasoningEffort === void 0 && value.slack === void 0) {
+  if (value.displayName === void 0 && value.instructions === void 0 && value.model === void 0 && value.reasoningEffort === void 0 && value.slack === void 0 && value.portrait === void 0) {
     ctx.addIssue({ code: "custom", message: "nothing to update" });
   }
 });
@@ -22291,6 +22299,13 @@ var PlannedCadence = external_exports.discriminatedUnion("kind", [
     hour: external_exports.number().int().min(0).max(23),
     minute: external_exports.number().int().min(0).max(59)
   }),
+  external_exports.object({
+    kind: external_exports.literal("monthly"),
+    /** 1–28, the window every month has (SCH-1); month-start work lives here. */
+    dayOfMonth: external_exports.number().int().min(1).max(28),
+    hour: external_exports.number().int().min(0).max(23),
+    minute: external_exports.number().int().min(0).max(59)
+  }),
   external_exports.object({ kind: external_exports.literal("every"), minutes: external_exports.number().int().min(5).max(1440) })
 ]);
 var PlannedAutomationTrigger = external_exports.enum(["schedule", "webhook"]);
@@ -37918,8 +37933,8 @@ import { createServer as createServer2 } from "node:http";
 var CADENCE_PROPS = {
   cadence_kind: {
     type: "string",
-    enum: ["every", "daily", "weekly"],
-    description: "every = every N minutes; daily/weekly run at a UTC time."
+    enum: ["every", "daily", "weekly", "monthly"],
+    description: "every = every N minutes; daily/weekly/monthly run at a UTC time."
   },
   minutes: {
     type: "integer",
@@ -37927,9 +37942,16 @@ var CADENCE_PROPS = {
     maximum: 10080,
     description: "every-only: interval in minutes (1 to 10080)."
   },
-  hour_utc: { type: "number", description: "daily/weekly: hour 0-23 (UTC)." },
-  minute_utc: { type: "number", description: "daily/weekly: minute 0-59 (UTC), default 0." },
-  day_of_week: { type: "number", description: "weekly-only: 0 = Sunday \u2026 6 = Saturday." }
+  hour_utc: { type: "number", description: "daily/weekly/monthly: hour 0-23 (UTC)." },
+  minute_utc: {
+    type: "number",
+    description: "daily/weekly/monthly: minute 0-59 (UTC), default 0."
+  },
+  day_of_week: { type: "number", description: "weekly-only: 0 = Sunday \u2026 6 = Saturday." },
+  day_of_month: {
+    type: "number",
+    description: "monthly-only: day 1-28 (UTC); 1-28 exists in every month."
+  }
 };
 var TOOLS = [
   {
@@ -38091,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).",
@@ -38377,7 +38449,12 @@ function cadenceFrom(args) {
     if (!Number.isFinite(dayOfWeek)) throw new Error('cadence "weekly" needs `day_of_week`');
     return { kind: "weekly", dayOfWeek, hourUtc, minuteUtc };
   }
-  throw new Error("cadence_kind must be every | daily | weekly");
+  if (kind === "monthly") {
+    const dayOfMonth = Number(args["day_of_month"]);
+    if (!Number.isFinite(dayOfMonth)) throw new Error('cadence "monthly" needs `day_of_month`');
+    return { kind: "monthly", dayOfMonth, hourUtc, minuteUtc };
+  }
+  throw new Error("cadence_kind must be every | daily | weekly | monthly");
 }
 function opFor(name, args) {
   const str = (key, required2 = true) => {
@@ -38397,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.131",
+  "version": "0.0.133",
   "type": "module",
   "exports": {
     ".": "./src/client.ts",