@zixt/host 0.0.130 → 0.0.132

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.130",
+  version: "0.0.132",
   type: "module",
   exports: {
     ".": "./src/client.ts",
@@ -14699,7 +14699,13 @@ var ID_PREFIXES = {
   /** One durable caller-transcript or Manager-speech delivery. */
   voiceTurn: "vtr",
   /** One signed voice-provider webhook receipt. */
-  voiceWebhookEvent: "vwe"
+  voiceWebhookEvent: "vwe",
+  /** Org-singleton Company setup record (PRD OB-5). */
+  companySetup: "cst",
+  /** One durable set of teammate-proposed Automations awaiting an Admin (OB-12). */
+  automationProposalSet: "aps",
+  /** One product-feedback report passed to the Zixt team (MG-23). */
+  productFeedback: "pfb"
 };
 var idPattern = (prefix) => new RegExp(`^${prefix}_[0-9a-f]{32}$`);
 function newId(prefix) {
@@ -14707,6 +14713,7 @@ function newId(prefix) {
 }
 var idSchema = (prefix, name) => external_exports.string().regex(idPattern(prefix), `invalid ${name}`);
 var OrgId = idSchema(ID_PREFIXES.org, "org id");
+var CompanySetupId = idSchema(ID_PREFIXES.companySetup, "company setup id");
 var MemberId = idSchema(ID_PREFIXES.member, "member id");
 var AgentId = idSchema(ID_PREFIXES.agent, "agent id");
 var AgentAvatarId = idSchema(ID_PREFIXES.agentAvatar, "agent avatar id");
@@ -14724,6 +14731,10 @@ var IntegrationLogoId = idSchema(ID_PREFIXES.integrationLogo, "Integration logo
 var ApprovalId = idSchema(ID_PREFIXES.approval, "approval id");
 var ScheduleId = idSchema(ID_PREFIXES.schedule, "schedule id");
 var WebhookAutomationId = idSchema(ID_PREFIXES.webhookAutomation, "Webhook Automation id");
+var AutomationProposalSetId = idSchema(
+  ID_PREFIXES.automationProposalSet,
+  "automation proposal set id"
+);
 var WebhookDeliveryId = idSchema(ID_PREFIXES.webhookDelivery, "webhook delivery id");
 var OrgSkillId = idSchema(ID_PREFIXES.orgSkill, "organization skill id");
 var OrgRoutineId = idSchema(ID_PREFIXES.orgRoutine, "organization routine id");
@@ -15193,9 +15204,12 @@ var LinearProviderTaskOrigin = external_exports.object({
 // ../../packages/contracts/src/skills.ts
 var TeammateRoleTemplate = external_exports.enum([
   "developer",
+  "website",
   "marketing",
   "product",
   "sales",
+  "support",
+  "operations",
   "custom"
 ]);
 var SkillId = external_exports.enum([
@@ -15235,7 +15249,14 @@ var SkillId = external_exports.enum([
   "review-pipeline-risk",
   "identify-expansion-opportunities",
   "synthesize-customer-objections",
-  "prepare-proposals"
+  "prepare-proposals",
+  "maintain-website-content",
+  "keep-website-healthy",
+  "resolve-customer-requests",
+  "maintain-faq-answers",
+  "coordinate-schedules",
+  "prepare-daily-briefs",
+  "maintain-records"
 ]);
 var SkillReferenceId = external_exports.union([SkillId, OrgSkillId]);
 var EnabledSkillIds = external_exports.array(SkillReferenceId).max(200).refine((items) => new Set(items).size === items.length, "duplicate skill").default([]);
@@ -15274,6 +15295,7 @@ var ListOrgSkillsResponse = external_exports.object({
   builtInCustomizations: external_exports.array(OrgBuiltInSkillCustomization)
 });
 var RoutineTemplateCadence = external_exports.discriminatedUnion("kind", [
+  external_exports.object({ kind: external_exports.literal("every"), minutes: external_exports.number().int().min(5).max(1440) }),
   external_exports.object({
     kind: external_exports.literal("daily"),
     hour: external_exports.number().int().min(0).max(23),
@@ -15290,14 +15312,26 @@ var RoutinePresetId = external_exports.enum([
   "developer-weekly-architecture-review",
   "developer-weekly-dependency-review",
   "developer-weekly-release-review",
+  "developer-hourly-service-health-check",
   "product-daily-triage",
   "product-weekly-feedback-review",
   "product-weekly-roadmap-review",
   "marketing-weekly-campaign-review",
   "marketing-weekly-editorial-review",
+  "marketing-daily-review-check",
+  "marketing-daily-ad-spend-check",
+  "marketing-daily-social-inbox-check",
   "sales-daily-follow-up-review",
   "sales-weekly-pipeline-review",
-  "sales-weekly-objection-review"
+  "sales-weekly-objection-review",
+  "sales-daily-inbound-lead-check",
+  "website-weekly-site-audit",
+  "website-daily-uptime-check",
+  "support-daily-inbox-triage",
+  "support-weekly-question-review",
+  "support-hourly-urgent-check",
+  "operations-daily-schedule-brief",
+  "operations-weekly-records-review"
 ]);
 var RoutineTemplateReferenceId = external_exports.union([RoutinePresetId, OrgRoutineId]);
 var OrgRoutine = external_exports.object({
@@ -16830,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([
@@ -16913,6 +16955,77 @@ var ListSchedulesResponse = external_exports.object({
   schedules: external_exports.array(Schedule)
 });
 
+// ../../packages/contracts/src/automation-proposals.ts
+var ItemKey = external_exports.string().regex(/^[a-z][a-z0-9_-]{0,63}$/);
+var AutomationProposalTrigger = external_exports.discriminatedUnion("kind", [
+  /** A recurring schedule; cadence hours are UTC exactly like `schedule_task`. */
+  external_exports.object({ kind: external_exports.literal("schedule"), cadence: ScheduleCadence }),
+  /**
+   * An external system pushes events to a Webhook Automation endpoint (SCH-6).
+   * `source` names who is expected to call ("Grafana"); the bearer secret is
+   * cloud-generated at acceptance and never passes through the proposing run.
+   */
+  external_exports.object({
+    kind: external_exports.literal("webhook"),
+    source: external_exports.string().trim().min(1).max(120).nullable()
+  })
+]);
+var AutomationProposalItemStatus = external_exports.enum(["proposed", "created", "dismissed"]);
+var AutomationProposalItem = external_exports.object({
+  key: ItemKey,
+  name: external_exports.string().trim().min(1).max(120),
+  instructions: external_exports.string().trim().min(1).max(1e4),
+  trigger: AutomationProposalTrigger,
+  /** Honest one line: why this check helps this business. */
+  why: external_exports.string().trim().min(1).max(300),
+  status: AutomationProposalItemStatus,
+  createdScheduleId: ScheduleId.nullable(),
+  createdWebhookAutomationId: WebhookAutomationId.nullable()
+});
+var AutomationProposalSetStatus = external_exports.enum(["pending", "decided"]);
+var AUTOMATION_PROPOSAL_MAX_ITEMS = 10;
+var AutomationProposalSet = external_exports.object({
+  id: AutomationProposalSetId,
+  orgId: OrgId,
+  agentId: AgentId,
+  /** Joined for display; "a removed AI teammate" when the Agent is gone. */
+  agentName: external_exports.string().min(1).max(120).nullable(),
+  taskId: TaskId,
+  /** What was explored / why these, in the teammate's words. */
+  summary: external_exports.string().trim().min(1).max(600),
+  items: external_exports.array(AutomationProposalItem).max(AUTOMATION_PROPOSAL_MAX_ITEMS),
+  status: AutomationProposalSetStatus,
+  originTrust: external_exports.enum(["internal", "external"]),
+  createdAt: IsoDate,
+  decidedAt: IsoDate.nullable(),
+  decidedBy: MemberId.nullable()
+});
+var ListAutomationProposalsResponse = external_exports.object({
+  proposals: external_exports.array(AutomationProposalSet)
+});
+var DecideAutomationProposalsRequest = external_exports.object({
+  accept: external_exports.array(ItemKey).max(AUTOMATION_PROPOSAL_MAX_ITEMS).default([]),
+  dismiss: external_exports.array(ItemKey).max(AUTOMATION_PROPOSAL_MAX_ITEMS).default([])
+}).refine(
+  (value) => value.accept.length + value.dismiss.length > 0,
+  "name at least one proposal to accept or dismiss"
+).refine(
+  (value) => value.accept.every((key) => !value.dismiss.includes(key)),
+  "a proposal cannot be both accepted and dismissed"
+);
+var CreatedWebhookSetup = external_exports.object({
+  itemKey: ItemKey,
+  webhookAutomationId: WebhookAutomationId,
+  endpointUrl: external_exports.string().url(),
+  /** Cloud-generated bearer secret, or null when a raced/recovered acceptance already consumed the one showing. */
+  bearerToken: external_exports.string().min(8).max(200).nullable()
+});
+var DecideAutomationProposalsResponse = external_exports.object({
+  proposalSet: AutomationProposalSet,
+  createdScheduleIds: external_exports.array(ScheduleId),
+  createdWebhooks: external_exports.array(CreatedWebhookSetup)
+});
+
 // ../../packages/contracts/src/reviews.ts
 var TaskReviewMode = external_exports.enum(["none", "required"]);
 var TaskReviewStatus = external_exports.enum(["unreviewed", "accepted", "changes_requested"]);
@@ -18179,6 +18292,24 @@ var AgentOp = external_exports.union([
   }),
   external_exports.object({ kind: external_exports.literal("schedule.list") }),
   external_exports.object({ kind: external_exports.literal("schedule.delete"), scheduleId: ScheduleId }),
+  /**
+   * OB-12: record recurring Automations this teammate recommends, without
+   * creating anything. The set becomes a durable Needs-attention obligation an
+   * Admin decides; `schedule_task` stays the path for work a person asked for.
+   * Zero items is an honest "explored; nothing recurring needed".
+   */
+  external_exports.object({
+    kind: external_exports.literal("automation.propose"),
+    summary: external_exports.string().trim().min(1).max(600),
+    items: external_exports.array(
+      external_exports.object({
+        name: external_exports.string().trim().min(1).max(120),
+        instructions: external_exports.string().trim().min(1).max(1e4),
+        trigger: AutomationProposalTrigger,
+        why: external_exports.string().trim().min(1).max(300)
+      })
+    ).max(AUTOMATION_PROPOSAL_MAX_ITEMS)
+  }),
   external_exports.object({
     kind: external_exports.literal("secret.put"),
     name: SecretName,
@@ -19555,6 +19686,11 @@ var ManagerConfigProjection = external_exports.object({
    * switch for each surface without disconnecting the workspace.
    */
   slack: external_exports.object({ answerMentions: external_exports.boolean(), answerDirectMessages: external_exports.boolean() }).strict(),
+  /**
+   * Index into the bundled Manager portrait set shown wherever the Manager
+   * speaks; every organization starts on the deployment default (0).
+   */
+  portrait: external_exports.number().int().min(0).max(63).default(0),
   revision: external_exports.number().int().min(0),
   updatedAt: external_exports.string().nullable()
 }).strict();
@@ -19569,10 +19705,11 @@ var UpdateManagerRequest = external_exports.object({
     answerMentions: external_exports.boolean().optional(),
     answerDirectMessages: external_exports.boolean().optional()
   }).strict().optional(),
+  portrait: external_exports.number().int().min(0).max(63).optional(),
   /** 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" });
   }
 });
@@ -20970,7 +21107,11 @@ var AttentionItemType = external_exports.enum([
   /** An Automation paused itself and cannot resume without a person's decision. */
   "automation_paused",
   /** An Automation was kept running but its Machine preference changed. */
-  "automation_moved"
+  "automation_moved",
+  /** A teammate proposed recurring Automations awaiting an Admin's decision (OB-12). */
+  "automation_proposal",
+  /** A previously seen Machine went offline; teammates may have no computer to work on. */
+  "machine_offline"
 ]);
 var AttentionCategory = external_exports.enum([
   "answer_question",
@@ -21004,7 +21145,9 @@ var AttentionItem = external_exports.object({
       "readiness",
       "integration",
       "schedule",
-      "manager_questionnaire"
+      "manager_questionnaire",
+      "host",
+      "automation_proposal_set"
     ]),
     id: external_exports.string().min(1),
     version: external_exports.string().min(1)
@@ -21020,7 +21163,9 @@ var AttentionItem = external_exports.object({
         "retry",
         "repair",
         /** Choose a Machine for a paused Automation, or set it back to automatic. */
-        "resume_automation"
+        "resume_automation",
+        /** Create or dismiss a teammate's proposed Automations (OB-12; Admin/Owner). */
+        "decide_automation_proposals"
       ]),
       allowed: external_exports.boolean()
     })
@@ -22014,13 +22159,24 @@ var SetupGuideToolResult = external_exports.object({
   result: external_exports.string().trim().min(1).max(4e3),
   page: SetupGuidePageContext
 });
+var SetupGuideMission = external_exports.object({
+  id: external_exports.string().regex(/^[a-z][a-z0-9_.:-]{0,120}$/),
+  kind: external_exports.enum(["machine", "teammate", "integration", "automation", "first_task"]),
+  goal: external_exports.string().trim().min(1).max(600),
+  targetHref: external_exports.string().startsWith("/").max(2e3),
+  returnHref: external_exports.string().startsWith("/").max(2e3),
+  facts: external_exports.array(SetupGuideContextFact).max(12).default([]),
+  /** Never a secret; the Guide only fills visible non-secure fields with these. */
+  prefills: external_exports.array(SetupGuideActionParameter).max(12).default([])
+});
 var SetupGuideReplyRequest = external_exports.object({
   message: GuideText,
   history: external_exports.array(SetupGuideHistoryMessage).max(12).default([]),
   page: SetupGuidePageContext,
   onboarding: SetupGuideOnboardingState,
   actions: external_exports.array(SetupGuideAvailableAction).max(128),
-  toolResults: external_exports.array(SetupGuideToolResult).max(12).default([])
+  toolResults: external_exports.array(SetupGuideToolResult).max(12).default([]),
+  mission: SetupGuideMission.nullable().optional()
 });
 var SetupGuideProposedAction = external_exports.object({
   actionId: external_exports.string().regex(/^[a-z][a-z0-9_.-]{0,79}$/),
@@ -22045,6 +22201,328 @@ var SetupGuideTranscriptionResponse = external_exports.object({
   text: GuideText
 });
 
+// ../../packages/contracts/src/roles.ts
+var CompanyToolKind = external_exports.enum([
+  "github",
+  "slack",
+  "linear",
+  "email",
+  "mcp",
+  "api",
+  "whatsapp",
+  "browser"
+]);
+var RoleRecommendedIntegration = external_exports.object({
+  kind: CompanyToolKind,
+  label: external_exports.string().trim().min(1).max(80),
+  purpose: external_exports.string().trim().min(1).max(200)
+});
+
+// ../../packages/contracts/src/company-setup.ts
+var Key = external_exports.string().regex(/^[a-z][a-z0-9_-]{0,63}$/);
+var CompanySetupStatus = external_exports.enum([
+  /** No record exists yet. */
+  "not_started",
+  /** The page was opened and the first question prepared; nothing answered. */
+  "offered",
+  "interviewing",
+  /** A plan exists and awaits edits or approval. */
+  "planned",
+  /** The team was created; required and recommended steps are tracked. */
+  "approved"
+]);
+var CompanySetupOrgKind = external_exports.enum(["personal", "company"]);
+var InterviewAnswer = external_exports.discriminatedUnion("kind", [
+  external_exports.object({ kind: external_exports.literal("text"), text: external_exports.string().trim().min(1).max(2e3) }),
+  external_exports.object({ kind: external_exports.literal("skipped") }),
+  /** "Not sure, suggest for me": the planner chooses a sensible default. */
+  external_exports.object({ kind: external_exports.literal("suggest") })
+]);
+var InterviewQuestion = external_exports.object({
+  id: Key,
+  prompt: external_exports.string().trim().min(1).max(400),
+  /** One-line explanation of a Zixt noun the first time it appears; null otherwise. */
+  gloss: external_exports.string().trim().min(1).max(300).nullable(),
+  examples: external_exports.array(external_exports.string().trim().min(1).max(120)).max(6),
+  allowSuggest: external_exports.boolean()
+});
+var InterviewTurn = InterviewQuestion.extend({
+  round: external_exports.number().int().min(1),
+  answer: InterviewAnswer.nullable(),
+  answeredAt: IsoDate.nullable(),
+  /** Tailored options fetched by "Not sure, suggest for me"; the person picks, edits, then continues. */
+  suggestions: external_exports.array(external_exports.string().trim().min(1).max(200)).max(8).default([]),
+  /** The answer here was passed to the Zixt team as product feedback (MG-23); the transcript says so. */
+  feedbackNoted: external_exports.boolean().default(false)
+});
+var CompanySetupInterview = external_exports.object({
+  turns: external_exports.array(InterviewTurn).max(40),
+  /** Increments each time the interview is re-run for an additive re-plan. */
+  round: external_exports.number().int().min(1),
+  complete: external_exports.boolean(),
+  /** The next question is being generated; the interview is neither complete nor waiting on the person. */
+  preparingQuestion: external_exports.boolean().default(false),
+  minimumAnswers: external_exports.number().int().min(1),
+  maximumQuestions: external_exports.number().int().min(1)
+});
+var PlannedToolAvailability = external_exports.enum([
+  /** A connected Integration of this kind already exists. */
+  "connected",
+  /** The Integration catalog can connect it. */
+  "connectable",
+  /** Reachable through an API Integration (Custom API / discovery). */
+  "api_catalog",
+  /** The teammate uses the website through a saved sign-in in its Browser. */
+  "browser",
+  "not_yet"
+]);
+var PlannedTool = external_exports.object({
+  key: Key,
+  label: external_exports.string().trim().min(1).max(80),
+  purpose: external_exports.string().trim().min(1).max(300),
+  kind: CompanyToolKind,
+  availability: PlannedToolAvailability,
+  /** Catalog Integration name when `availability` is connectable or api_catalog. */
+  catalogName: external_exports.string().trim().min(1).max(120).nullable(),
+  why: external_exports.string().trim().min(1).max(300),
+  enabled: external_exports.boolean()
+});
+var PlannedCadence = external_exports.discriminatedUnion("kind", [
+  external_exports.object({
+    kind: external_exports.literal("daily"),
+    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("weekly"),
+    dayOfWeek: external_exports.number().int().min(0).max(6),
+    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"]);
+var PlannedAutomation = external_exports.object({
+  key: Key,
+  name: external_exports.string().trim().min(1).max(120),
+  instructions: external_exports.string().trim().min(1).max(4e3),
+  presetId: RoutinePresetId.nullable(),
+  /** Plans stored before OB-12 carry no trigger and read as schedules. */
+  trigger: PlannedAutomationTrigger.default("schedule"),
+  /** Null only for webhook triggers, which have no cadence. */
+  cadence: PlannedCadence.nullable(),
+  /** The external system expected to call, for webhook triggers ("Grafana"). */
+  webhookSource: external_exports.string().trim().min(1).max(120).nullable().default(null),
+  /** The Automation's work needs a person's decision before it acts. */
+  requiresApproval: external_exports.boolean(),
+  why: external_exports.string().trim().min(1).max(300),
+  enabled: external_exports.boolean()
+});
+var PlannedExploration = external_exports.object({
+  /** What to explore, in plain words ("the support inbox"). */
+  target: external_exports.string().trim().min(1).max(160),
+  /** The complete Task request, ready for the Manager composer. */
+  request: external_exports.string().trim().min(1).max(1200),
+  why: external_exports.string().trim().min(1).max(300),
+  enabled: external_exports.boolean()
+});
+var PlannedTeammate = external_exports.object({
+  key: Key,
+  name: external_exports.string().trim().min(1).max(120),
+  roleTemplate: TeammateRoleTemplate,
+  title: external_exports.string().trim().min(1).max(80),
+  purpose: external_exports.string().trim().min(1).max(600),
+  dayToDay: external_exports.array(external_exports.string().trim().min(1).max(200)).max(6),
+  instructions: external_exports.string().trim().min(1).max(5e4),
+  escalation: external_exports.string().trim().max(1e4),
+  skillIds: external_exports.array(SkillReferenceId).max(40),
+  tools: external_exports.array(PlannedTool).max(8),
+  automations: external_exports.array(PlannedAutomation).max(6),
+  /** Present when the interview left this teammate's proactive needs unknown (OB-12). */
+  exploration: PlannedExploration.nullable().default(null),
+  /** Keys of other planned teammates (or created Agent ids) this teammate hands work to. */
+  handsOffTo: external_exports.array(external_exports.string().trim().min(1).max(120)).max(6),
+  /** Guardrail categories proposed as require_approval because the person said a human decides. */
+  approvals: external_exports.array(ActionCategory).max(20),
+  why: external_exports.string().trim().min(1).max(300),
+  enabled: external_exports.boolean(),
+  /**
+   * Index into the bundled portrait set the person chose for this teammate;
+   * null falls back to a stable name-matched default. Approval turns the
+   * resolved portrait into the created Agent's avatar artwork.
+   */
+  portrait: external_exports.number().int().min(0).max(63).nullable().default(null),
+  /** Set once approval created the Agent; never cleared by a re-plan. */
+  createdAgentId: AgentId.nullable()
+});
+var PlannedMachine = external_exports.object({
+  why: external_exports.string().trim().min(1).max(400),
+  suggestedName: external_exports.string().trim().min(1).max(120),
+  operatingSystem: external_exports.enum(["windows", "macos", "linux", "unknown"])
+});
+var PlannedFirstTask = external_exports.object({
+  title: external_exports.string().trim().min(1).max(160),
+  request: external_exports.string().trim().min(1).max(1200),
+  teammateKey: Key.nullable()
+});
+var CompanySetupPlan = external_exports.object({
+  revision: external_exports.number().int().min(1),
+  summary: external_exports.string().trim().min(1).max(1200),
+  businessName: external_exports.string().trim().min(1).max(120).nullable(),
+  teammates: external_exports.array(PlannedTeammate).min(1).max(8),
+  machine: PlannedMachine,
+  firstTask: PlannedFirstTask.nullable()
+});
+var ProposedTool = PlannedTool.omit({ enabled: true });
+var ProposedAutomation = PlannedAutomation.omit({ enabled: true }).extend({
+  trigger: PlannedAutomationTrigger,
+  webhookSource: external_exports.string().trim().min(1).max(120).nullable()
+});
+var ProposedExploration = PlannedExploration.omit({ enabled: true });
+var ProposedTeammate = PlannedTeammate.omit({
+  createdAgentId: true,
+  enabled: true,
+  // The person picks portraits on the plan; the planner never proposes them.
+  portrait: true
+}).extend({
+  tools: external_exports.array(ProposedTool).max(8),
+  automations: external_exports.array(ProposedAutomation).max(6),
+  exploration: ProposedExploration.nullable()
+});
+var ProposedPlan = CompanySetupPlan.omit({ revision: true }).extend({
+  teammates: external_exports.array(ProposedTeammate).min(1).max(8)
+});
+var CompanySetupStepKind = external_exports.enum([
+  "machine",
+  "teammate",
+  "integration",
+  "automation",
+  /** OB-12: a bounded first Task that discovers what this teammate should watch. */
+  "exploration",
+  "first_task"
+]);
+var CompanySetupStepState = external_exports.enum(["open", "done", "skipped"]);
+var CompanySetupStep = external_exports.object({
+  id: external_exports.string().regex(/^[a-z][a-z0-9_.:-]{0,120}$/),
+  kind: CompanySetupStepKind,
+  required: external_exports.boolean(),
+  title: external_exports.string().trim().min(1).max(160),
+  description: external_exports.string().trim().min(1).max(600),
+  state: CompanySetupStepState,
+  /** What was observed, when the state is done. */
+  evidence: external_exports.object({ summary: external_exports.string().trim().min(1).max(300), at: IsoDate.nullable() }).nullable(),
+  skip: external_exports.object({
+    reason: external_exports.string().trim().min(1).max(500),
+    at: IsoDate,
+    by: MemberId.nullable()
+  }).nullable(),
+  /** The planned teammate this step belongs to, for Integration and Automation steps. */
+  teammateKey: Key.nullable(),
+  teammateName: external_exports.string().trim().min(1).max(120).nullable(),
+  /** The plan item this step tracks (tool key or automation key). */
+  planKey: Key.nullable(),
+  mission: SetupGuideMission.nullable()
+});
+var CompanySetupProgress = external_exports.object({
+  requiredTotal: external_exports.number().int().min(0),
+  requiredDone: external_exports.number().int().min(0),
+  recommendedTotal: external_exports.number().int().min(0),
+  recommendedDone: external_exports.number().int().min(0),
+  /** Every required step is done (skips do not count). */
+  requiredComplete: external_exports.boolean(),
+  /** Every recommended step is done or skipped. */
+  recommendedSettled: external_exports.boolean()
+});
+var CompanySetupApproval = external_exports.object({
+  at: IsoDate,
+  by: MemberId.nullable(),
+  createdAgentIds: external_exports.array(AgentId)
+});
+var CompanySetupView = external_exports.object({
+  id: CompanySetupId.nullable(),
+  orgId: OrgId,
+  status: CompanySetupStatus,
+  orgKind: CompanySetupOrgKind,
+  interview: CompanySetupInterview.nullable(),
+  /** The next unanswered question, when the interview is open. */
+  currentQuestion: InterviewTurn.nullable(),
+  plan: CompanySetupPlan.nullable(),
+  /**
+   * The plan is being proposed in the background (a planner call can take a
+   * minute); the page polls until the plan lands or an error is recorded.
+   */
+  planning: external_exports.object({ startedAt: IsoDate, error: external_exports.string().max(500).nullable() }).nullable(),
+  approval: CompanySetupApproval.nullable(),
+  steps: external_exports.array(CompanySetupStep),
+  progress: CompanySetupProgress,
+  /** Company facts the Guide carries into missions; empty before a plan exists. */
+  contextFacts: external_exports.array(SetupGuideContextFact).max(12),
+  homeCardDismissedAt: IsoDate.nullable(),
+  /**
+   * True only for an Admin of an organization with no record, no teammates, no
+   * Machines, and no Tasks: Home may open the setup page once. Opening it
+   * creates the record, so the redirect never repeats.
+   */
+  suggestRedirect: external_exports.boolean(),
+  viewerCanEdit: external_exports.boolean(),
+  /** Absent when the deployment has no inference configured and no record exists. */
+  interviewAvailable: external_exports.boolean(),
+  startedAt: IsoDate.nullable(),
+  updatedAt: IsoDate.nullable()
+});
+var AnswerCompanySetupQuestionRequest = external_exports.object({
+  questionId: Key,
+  answer: InterviewAnswer
+}).strict();
+var SuggestCompanySetupAnswersRequest = external_exports.object({
+  questionId: Key
+}).strict();
+var UpdateCompanySetupPlanRequest = external_exports.object({
+  /** The full edited plan; the revision must match the stored one. */
+  plan: CompanySetupPlan
+}).strict();
+var ApproveCompanySetupRequest = external_exports.object({
+  planRevision: external_exports.number().int().min(1)
+}).strict();
+var SkipCompanySetupStepRequest = external_exports.object({
+  reason: external_exports.string().trim().min(1).max(500)
+}).strict();
+var ProposeTeammateRequest = external_exports.object({
+  answers: external_exports.array(
+    external_exports.object({
+      question: external_exports.string().trim().min(1).max(400),
+      answer: external_exports.string().trim().min(1).max(2e3)
+    })
+  ).max(6),
+  requestedRole: TeammateRoleTemplate.nullable().optional()
+}).strict();
+var ProposeTeammateResponse = external_exports.object({
+  teammate: ProposedTeammate
+});
+var CompanySetupFunnel = external_exports.object({
+  status: CompanySetupStatus,
+  startedAt: IsoDate.nullable(),
+  planProposedAt: IsoDate.nullable(),
+  planApprovedAt: IsoDate.nullable(),
+  requiredCompletedAt: IsoDate.nullable(),
+  recommendedSettledAt: IsoDate.nullable(),
+  teammatesCreated: external_exports.number().int().min(0),
+  stepsSkipped: external_exports.number().int().min(0)
+});
+var TEAMMATE_PORTRAIT_COUNT = 16;
+var ALL_PORTRAITS = Array.from({ length: TEAMMATE_PORTRAIT_COUNT }, (_, index) => index);
+
+// ../../packages/contracts/src/product-feedback.ts
+var ProductFeedbackKind = external_exports.enum(["frustration", "missing_capability", "feature_request"]);
+var ProductFeedbackSurface = external_exports.enum(["manager", "guide", "company_setup"]);
+
 // src/runners/mcp-client.ts
 var REQUEST_TIMEOUT_MS = 1e4;
 var MAX_BODY_BYTES = 4 * 1024 * 1024;
@@ -37455,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",
@@ -37464,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 = [
   {
@@ -37914,7 +38399,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) => {

package/package.json

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