@zixt/host 0.0.137 → 0.0.139

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.137",
+  version: "0.0.139",
   type: "module",
   exports: {
     ".": "./src/client.ts",
@@ -14676,6 +14676,8 @@ var ID_PREFIXES = {
   managerApiAction: "maa",
   /** One Manager-prepared Webhook Automation setup card (MG-21). */
   managerWebhookAction: "mwa",
+  /** One Manager-prepared Email Integration setup card (MG-24). */
+  managerEmailSetup: "mes",
   /** One Manager-authored questionnaire waiting in a Conversation. */
   managerQuestionnaire: "mqu",
   /** One Manager inference call's token-metering row (MG-8). */
@@ -14763,6 +14765,10 @@ var ManagerWebhookActionId = idSchema(
   ID_PREFIXES.managerWebhookAction,
   "Manager webhook action id"
 );
+var ManagerEmailSetupId = idSchema(
+  ID_PREFIXES.managerEmailSetup,
+  "Manager email setup id"
+);
 var ManagerQuestionnaireId = idSchema(
   ID_PREFIXES.managerQuestionnaire,
   "Manager questionnaire id"
@@ -16930,6 +16936,11 @@ var Schedule = external_exports.object({
   /** TS-16 for standing work: every tick's Task asks for this exact Machine;
    * null lets the dispatcher pick each time. */
   requestedHostId: HostId.nullable().default(null),
+  /**
+   * Every tick's Task requires the AI teammate Browser, so dispatch waits for
+   * a Machine with fresh Browser capability instead of running blind (OB-14).
+   */
+  requiresBrowser: external_exports.boolean().default(false),
   enabled: external_exports.boolean(),
   lastRunAt: IsoDate.nullable(),
   skippedRuns: external_exports.number().int().min(0).default(0),
@@ -16949,7 +16960,8 @@ var CreateScheduleRequest = external_exports.object({
   presetId: Schedule.shape.presetId.removeDefault().optional(),
   cadence: ScheduleCadence,
   endsAt: IsoDate.nullable().optional(),
-  requestedHostId: HostId.nullable().optional()
+  requestedHostId: HostId.nullable().optional(),
+  requiresBrowser: external_exports.boolean().optional()
 });
 var UpdateScheduleRequest = external_exports.object({
   name: Schedule.shape.name,
@@ -16958,6 +16970,7 @@ var UpdateScheduleRequest = external_exports.object({
   cadence: ScheduleCadence,
   endsAt: IsoDate.nullable(),
   requestedHostId: HostId.nullable(),
+  requiresBrowser: external_exports.boolean(),
   enabled: external_exports.boolean()
 }).partial().refine((v) => Object.keys(v).length > 0, "empty update");
 var ListSchedulesResponse = external_exports.object({
@@ -16977,9 +16990,21 @@ var AutomationProposalTrigger = external_exports.discriminatedUnion("kind", [
   external_exports.object({
     kind: external_exports.literal("webhook"),
     source: external_exports.string().trim().min(1).max(120).nullable()
-  })
+  }),
+  /**
+   * One Task, created queued on the proposing teammate when an Admin accepts
+   * (OB-14). Initiative sweeps propose the work they find here; nothing is
+   * created or starts until the decision.
+   */
+  external_exports.object({ kind: external_exports.literal("task") })
+]);
+var AutomationProposalItemStatus = external_exports.enum([
+  "proposed",
+  "created",
+  "dismissed",
+  /** Replaced undecided by a newer sweep from the same teammate: neither accepted nor refused (OB-14). */
+  "superseded"
 ]);
-var AutomationProposalItemStatus = external_exports.enum(["proposed", "created", "dismissed"]);
 var AutomationProposalItem = external_exports.object({
   key: ItemKey,
   name: external_exports.string().trim().min(1).max(120),
@@ -16989,7 +17014,9 @@ var AutomationProposalItem = external_exports.object({
   why: external_exports.string().trim().min(1).max(300),
   status: AutomationProposalItemStatus,
   createdScheduleId: ScheduleId.nullable(),
-  createdWebhookAutomationId: WebhookAutomationId.nullable()
+  createdWebhookAutomationId: WebhookAutomationId.nullable(),
+  /** The queued Task an accepted task-trigger item created (OB-14). */
+  createdTaskId: TaskId.nullable()
 });
 var AutomationProposalSetStatus = external_exports.enum(["pending", "decided"]);
 var AUTOMATION_PROPOSAL_MAX_ITEMS = 10;
@@ -17007,7 +17034,14 @@ var AutomationProposalSet = external_exports.object({
   originTrust: external_exports.enum(["internal", "external"]),
   createdAt: IsoDate,
   decidedAt: IsoDate.nullable(),
-  decidedBy: MemberId.nullable()
+  /** Null on a superseded or empty set: no person decided it. */
+  decidedBy: MemberId.nullable(),
+  /**
+   * The newer sweep that replaced this set while it sat undecided (OB-14).
+   * A recurring sweep restates what still matters, so at most one proposal
+   * card per teammate ever waits.
+   */
+  supersededBySetId: AutomationProposalSetId.nullable().default(null)
 });
 var ListAutomationProposalsResponse = external_exports.object({
   proposals: external_exports.array(AutomationProposalSet)
@@ -17032,7 +17066,9 @@ var CreatedWebhookSetup = external_exports.object({
 var DecideAutomationProposalsResponse = external_exports.object({
   proposalSet: AutomationProposalSet,
   createdScheduleIds: external_exports.array(ScheduleId),
-  createdWebhooks: external_exports.array(CreatedWebhookSetup)
+  createdWebhooks: external_exports.array(CreatedWebhookSetup),
+  /** Tasks created queued from accepted task-trigger items (OB-14). */
+  createdTaskIds: external_exports.array(TaskId)
 });
 
 // ../../packages/contracts/src/reviews.ts
@@ -19861,7 +19897,9 @@ var ConversationEventProjection = external_exports.discriminatedUnion("kind", [
     /** Present only for a Webhook Automation secure setup card (MG-21). */
     webhookActionId: ManagerWebhookActionId.nullable().optional(),
     /** Present only for a Manager-authored questionnaire (MG-22). */
-    questionnaireId: ManagerQuestionnaireId.nullable().optional()
+    questionnaireId: ManagerQuestionnaireId.nullable().optional(),
+    /** Present only for an Email Integration setup card (MG-24). */
+    emailSetupId: ManagerEmailSetupId.nullable().optional()
   }).strict(),
   /** A mirrored child-Task event: what the teammate wrote or became. */
   external_exports.object({
@@ -19934,6 +19972,44 @@ var ManagerIntegrationActionResponse = external_exports.object({
   action: ManagerIntegrationActionProjection,
   oauth: ManagerIntegrationOAuthStart.nullable()
 }).strict();
+var ManagerEmailSetupPrefill = external_exports.object({
+  /** Connection name as it will appear under Integrations. */
+  name: external_exports.string().min(1).max(120).optional(),
+  provider: EmailProviderPreset.optional(),
+  mode: EmailConnectionMode.optional(),
+  fromName: external_exports.string().max(200).optional(),
+  fromAddress: external_exports.string().max(320).optional(),
+  replyTo: external_exports.string().max(320).optional(),
+  usageNotes: external_exports.string().max(4e3).optional(),
+  /** custom provider only; presets carry their own servers. */
+  smtpHost: external_exports.string().max(255).optional(),
+  smtpPort: external_exports.number().int().min(1).max(65535).optional(),
+  incomingHost: external_exports.string().max(255).optional(),
+  incomingPort: external_exports.number().int().min(1).max(65535).optional(),
+  /** Sign-in name for the mailbox, when the person said it. Never a password. */
+  username: external_exports.string().max(320).optional(),
+  watch: external_exports.object({
+    enabled: external_exports.boolean(),
+    senderContains: external_exports.string().max(200).optional(),
+    recipientContains: external_exports.string().max(200).optional(),
+    subjectContains: external_exports.string().max(200).optional(),
+    instructions: external_exports.string().max(2e4).optional()
+  }).strict().optional()
+}).strict();
+var ManagerEmailSetupStatus = external_exports.enum(["open", "completed", "dismissed"]);
+var ManagerEmailSetupProjection = external_exports.object({
+  id: ManagerEmailSetupId,
+  conversationId: ConversationId,
+  prefill: ManagerEmailSetupPrefill,
+  status: ManagerEmailSetupStatus,
+  /** True when the requesting member is the person this card was prepared for. */
+  mine: external_exports.boolean(),
+  /** The Email connection the card produced; present once completed. */
+  connectionId: external_exports.string().nullable(),
+  connectionName: external_exports.string().max(120).nullable(),
+  createdAt: external_exports.string()
+}).strict();
+var CompleteManagerEmailSetupRequest = external_exports.object({ connectionId: external_exports.string().min(1).max(100) }).strict();
 var ManagerCredentialRequestStatus = external_exports.enum([
   "awaiting_entry",
   "storing",
@@ -38798,6 +38874,45 @@ var TOOLS = [
       required: ["summary", "automations"]
     }
   },
+  {
+    name: "propose_tasks",
+    description: "Propose one-time Tasks 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 is created or starts until a person approves. Use this when your own research or a routine sweep finds work worth doing that nobody asked for. Use create_task only for work your current instructions already authorize. Give each item an honest one-line why. An empty list honestly records that nothing worth proposing was found.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        summary: {
+          type: "string",
+          minLength: 1,
+          maxLength: 600,
+          description: "One line: what you researched or noticed, and why this work."
+        },
+        tasks: {
+          type: "array",
+          maxItems: 10,
+          items: {
+            type: "object",
+            properties: {
+              name: { type: "string", minLength: 1, maxLength: 120 },
+              instructions: {
+                type: "string",
+                minLength: 1,
+                maxLength: 1e4,
+                description: "The full brief the Task would run from, ready as written."
+              },
+              why: {
+                type: "string",
+                minLength: 1,
+                maxLength: 300,
+                description: "Honest one line: why this work helps this business."
+              }
+            },
+            required: ["name", "instructions", "why"]
+          }
+        }
+      },
+      required: ["summary", "tasks"]
+    }
+  },
   {
     name: "list_schedules",
     description: "List your own schedules (id, name, cadence, enabled, next run).",
@@ -39006,7 +39121,7 @@ var TOOLS = [
   },
   {
     name: "create_task",
-    description: "Open a new task, for yourself (omit agent_id) or for another AI teammate. This is real work: it queues, dispatches, and reports like a task a human opened. Check list_tasks first so you do not open a duplicate of something already queued or running. Omit requested_host_id for Auto routing; provide it only to require one eligible Machine.",
+    description: "Open a new task, for yourself (omit agent_id) or for another AI teammate. This is real work: it queues, dispatches, and reports like a task a human opened. Check list_tasks first so you do not open a duplicate of something already queued or running. Omit requested_host_id for Auto routing; provide it only to require one eligible Machine. Use this for work your current instructions already authorize you to start; when you found new work on your own initiative and a person should decide first whether it is worth doing, use propose_tasks instead.",
     inputSchema: {
       type: "object",
       properties: {
@@ -39152,6 +39267,33 @@ function opFor(name, args) {
         })
       };
     }
+    case "propose_tasks": {
+      const rawItems = args["tasks"];
+      if (!Array.isArray(rawItems)) throw new Error("missing required argument `tasks`");
+      return {
+        kind: "automation.propose",
+        summary: str("summary"),
+        items: rawItems.map((raw, index) => {
+          if (typeof raw !== "object" || raw === null) {
+            throw new Error(`tasks[${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(`tasks[${index}] is missing \`${key}\``);
+            }
+            return value;
+          };
+          return {
+            name: field("name"),
+            instructions: field("instructions"),
+            why: field("why"),
+            trigger: { kind: "task" }
+          };
+        })
+      };
+    }
     case "list_schedules":
       return { kind: "schedule.list" };
     case "cancel_schedule":

package/package.json

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