@zixt/host 0.0.43 → 0.0.44

package/dist/index.js

@@ -31,7 +31,7 @@ import { homedir } from "node:os";
 // package.json
 var package_default = {
   name: "@zixt/host",
-  version: "0.0.43",
+  version: "0.0.44",
   type: "module",
   exports: {
     ".": "./src/client.ts",
@@ -14648,7 +14648,15 @@ var ID_PREFIXES = {
   /** One file a person attached to a chat message ('att' is taken by attempt). */
   attachment: "atc",
   /** One curated memory entry an agent chose to keep ('mem' is taken by member). */
-  memory: "mry"
+  memory: "mry",
+  /** Org-singleton Manager configuration (PRD §8.13). */
+  manager: "mgr",
+  /** One Manager conversation thread (MG-2). */
+  conversation: "cnv",
+  /** One immutable Conversation timeline entry. */
+  conversationEvent: "cve",
+  /** One Manager inference call's token-metering row (MG-8). */
+  managerUsage: "mgu"
 };
 var idPattern = (prefix) => new RegExp(`^${prefix}_[0-9a-f]{32}$`);
 function newId(prefix) {
@@ -14671,6 +14679,9 @@ var OrgRoutineId = idSchema(ID_PREFIXES.orgRoutine, "organization routine id");
 var BrowserSessionId = idSchema(ID_PREFIXES.browserSession, "browser session id");
 var AttachmentId = idSchema(ID_PREFIXES.attachment, "attachment id");
 var MemoryId = idSchema(ID_PREFIXES.memory, "memory id");
+var ManagerId = idSchema(ID_PREFIXES.manager, "manager id");
+var ConversationId = idSchema(ID_PREFIXES.conversation, "conversation id");
+var ConversationEventId = idSchema(ID_PREFIXES.conversationEvent, "conversation event id");
 
 // ../../packages/contracts/src/browser.ts
 var BrowserViewport = external_exports.object({
@@ -14853,7 +14864,7 @@ var ApprovalDeliveryStatus = external_exports.enum(["pending", "delivered", "no_
 var ApprovalCategory = external_exports.union([ActionCategory, external_exports.literal("agent.question")]);
 var ApprovalRequestContext = external_exports.object({
   requester: external_exports.object({
-    source: external_exports.enum(["manual", "webhook", "message", "schedule", "agent", "handoff"]).nullable(),
+    source: external_exports.enum(["manual", "webhook", "message", "schedule", "agent", "handoff", "manager"]).nullable(),
     trust: external_exports.enum(["internal", "external"]).nullable(),
     contentTrust: PromptContentTrust.nullable(),
     requestedBy: external_exports.string().min(1).nullable(),
@@ -15801,7 +15812,7 @@ var TaskAttemptExecutionContext = external_exports.object({
   identity: external_exports.object({
     actingAgentId: AgentId,
     source: external_exports.object({
-      source: external_exports.enum(["manual", "webhook", "message", "schedule", "agent", "handoff"]),
+      source: external_exports.enum(["manual", "webhook", "message", "schedule", "agent", "handoff", "manager"]),
       trust: external_exports.enum(["internal", "external"]),
       /** Current attempt prompt authority; absent only on pre-TS-10 snapshots. */
       contentTrust: PromptContentTrust.optional(),
@@ -15830,7 +15841,7 @@ var MemberTaskAttemptExecutionContext = TaskAttemptExecutionContext.omit({
   identity: external_exports.object({
     actingAgentId: AgentId,
     source: external_exports.object({
-      source: external_exports.enum(["manual", "webhook", "message", "schedule", "agent", "handoff"]),
+      source: external_exports.enum(["manual", "webhook", "message", "schedule", "agent", "handoff", "manager"]),
       trust: external_exports.enum(["internal", "external"]),
       contentTrust: PromptContentTrust.optional(),
       requestedBy: external_exports.null(),
@@ -15915,7 +15926,8 @@ var TaskStatus = external_exports.enum([
   "cancelled"
 ]);
 var TaskOrigin = external_exports.object({
-  source: external_exports.enum(["manual", "webhook", "message", "schedule", "agent", "handoff"]),
+  /** `manager` = delegated from a Manager Conversation (MG-4). */
+  source: external_exports.enum(["manual", "webhook", "message", "schedule", "agent", "handoff", "manager"]),
   /** TS-10: external content is data, not instructions. */
   trust: external_exports.enum(["internal", "external"]),
   /** Member id, connector name, or agent id — whoever caused the task. */
@@ -15984,6 +15996,12 @@ var Task = external_exports.object({
   /** Higher runs first; FIFO within equal priority. */
   priority: external_exports.number().int().min(0).max(9),
   origin: TaskOrigin,
+  /**
+   * The Manager thread this Task was delegated from (MG-4); null for
+   * engine-born work (webhook, schedule, provider). Lets task lists tell
+   * thread-backed work from standalone rows without a second lookup.
+   */
+  conversationId: ConversationId.nullable().default(null),
   /** Formal human review is opt-in per Task; ordinary Chat defaults to none. */
   reviewMode: TaskReviewMode.default("none"),
   /** Assignment epoch — bumped every time the task is (re)assigned (PRD §7.4). */
@@ -16457,7 +16475,7 @@ var ListTasksResponse = external_exports.object({
 });
 
 // ../../packages/contracts/src/protocol.ts
-var PROTOCOL_VERSION = 5;
+var PROTOCOL_VERSION = 6;
 var TASK_CANCEL_ACK_EVENT = "zixt.task.cancel.acknowledged";
 var TASK_CREDENTIAL_ROLLOVER_ACK_EVENT = "zixt.task.credential_rollover.acknowledged";
 var UnwoundAssignmentRef = external_exports.object({
@@ -16960,7 +16978,18 @@ var TaskAssign = external_exports.object({
      * so protocol-v5 outbox rows and hosts remain parseable during rollout;
      * current clouds always populate it for newly dispatched work.
      */
-    origin: TaskOrigin.pick({ source: true, trust: true }).extend({
+    origin: TaskOrigin.pick({ trust: true }).extend({
+      /**
+       * Trigger classification, kept as a lenient string on the wire on
+       * purpose. The Host uses it for a display label and telemetry only,
+       * never for behavior, while the enum on the durable Task keeps its
+       * closed meaning. Parsing it strictly here made adding one source
+       * (`manager`) a breaking wire change: a Host built against the older
+       * enum failed the whole frame union and dropped `task.assign`
+       * silently, so the work sat Assigned forever with no diagnosis. An
+       * unknown value now degrades to an unlabeled source instead.
+       */
+      source: external_exports.string().min(1).max(64),
       /** Cloud-verified provider source; never inferred from provider-authored text. */
       provider: ProviderKind.optional(),
       /**
@@ -18553,6 +18582,134 @@ var LinearOAuthPopupMessage = external_exports.discriminatedUnion("ok", [
   LinearOAuthPopupFailure
 ]);
 
+// ../../packages/contracts/src/manager.ts
+var MANAGER_DISPLAY_NAME_MAX = 60;
+var MANAGER_INSTRUCTIONS_MAX = 2e4;
+var CONVERSATION_MESSAGE_MAX = 1e5;
+var CONVERSATION_LIST_LIMIT = 50;
+var ManagerReasoningEffort = external_exports.enum([
+  "none",
+  "minimal",
+  "low",
+  "medium",
+  "high",
+  "xhigh",
+  "max"
+]);
+var ManagerConfigProjection = external_exports.object({
+  id: ManagerId,
+  /** Shown in the UI and on chat channels; the persona carries the personality (MG-7). */
+  displayName: external_exports.string().min(1).max(MANAGER_DISPLAY_NAME_MAX),
+  /** Appended to the product-owned built-in system prompt; never replaces it. */
+  instructions: external_exports.string().max(MANAGER_INSTRUCTIONS_MAX),
+  model: external_exports.string().min(1).max(100),
+  reasoningEffort: ManagerReasoningEffort,
+  /**
+   * Where the Manager answers on Slack. The workspace bot speaks for the
+   * Manager (MG-1), so the per-teammate mention/DM switches that used to
+   * decide this belong here now — an organization keeps a truthful off
+   * switch for each surface without disconnecting the workspace.
+   */
+  slack: external_exports.object({ answerMentions: external_exports.boolean(), answerDirectMessages: external_exports.boolean() }).strict(),
+  revision: external_exports.number().int().min(0),
+  updatedAt: external_exports.string().nullable()
+}).strict();
+var ManagerMode = external_exports.enum(["openai", "demo", "unconfigured"]);
+var GetManagerResponse = external_exports.object({ manager: ManagerConfigProjection, mode: ManagerMode }).strict();
+var UpdateManagerRequest = external_exports.object({
+  displayName: external_exports.string().min(1).max(MANAGER_DISPLAY_NAME_MAX).optional(),
+  instructions: external_exports.string().max(MANAGER_INSTRUCTIONS_MAX).optional(),
+  model: external_exports.string().min(1).max(100).optional(),
+  reasoningEffort: ManagerReasoningEffort.optional(),
+  slack: external_exports.object({
+    answerMentions: external_exports.boolean().optional(),
+    answerDirectMessages: external_exports.boolean().optional()
+  }).strict().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) {
+    ctx.addIssue({ code: "custom", message: "nothing to update" });
+  }
+});
+var ConversationChannel = external_exports.enum(["web", "slack", "whatsapp"]);
+var ConversationStatus = external_exports.enum(["idle", "thinking"]);
+var ConversationProjection = external_exports.object({
+  id: ConversationId,
+  /** First message prefix until the Manager supplies a concise title. */
+  title: external_exports.string().min(1).max(200),
+  channel: ConversationChannel,
+  status: ConversationStatus,
+  /** TS-10 origin trust of the channel; propagated into every delegated Task. */
+  trust: external_exports.enum(["internal", "external"]),
+  /** Subject of whoever opened the thread (member subject or provider actor). */
+  createdBy: external_exports.string(),
+  createdAt: external_exports.string(),
+  lastActivityAt: external_exports.string(),
+  archivedAt: external_exports.string().nullable()
+}).strict();
+var conversationEventBase = {
+  id: ConversationEventId,
+  at: external_exports.string()
+};
+var ConversationEventProjection = external_exports.discriminatedUnion("kind", [
+  /** A human message into the Conversation. */
+  external_exports.object({
+    ...conversationEventBase,
+    kind: external_exports.literal("user"),
+    text: external_exports.string(),
+    author: external_exports.object({ subject: external_exports.string(), displayName: external_exports.string().nullable() }).strict()
+  }).strict(),
+  /** The Manager's prose reply. */
+  external_exports.object({ ...conversationEventBase, kind: external_exports.literal("manager"), text: external_exports.string() }).strict(),
+  /** One Manager tool step: a delegation, follow-up, or status check. */
+  external_exports.object({
+    ...conversationEventBase,
+    kind: external_exports.literal("tool"),
+    tool: external_exports.string(),
+    summary: external_exports.string(),
+    taskId: TaskId.nullable(),
+    agentId: AgentId.nullable()
+  }).strict(),
+  /** A mirrored child-Task event: what the teammate wrote or became. */
+  external_exports.object({
+    ...conversationEventBase,
+    kind: external_exports.literal("task"),
+    taskId: TaskId,
+    agentId: AgentId.nullable(),
+    eventKind: external_exports.enum(["response", "error", "status", "question"]),
+    summary: external_exports.string(),
+    taskStatus: TaskStatus.nullable()
+  }).strict(),
+  /** A Manager loop failure a person should see (provider outage, refusal). */
+  external_exports.object({ ...conversationEventBase, kind: external_exports.literal("error"), message: external_exports.string() }).strict()
+]);
+var CreateConversationRequest = external_exports.object({
+  /** Stable client-generated key: retrying the same submission returns one Conversation. */
+  requestId: external_exports.uuid(),
+  message: external_exports.string().min(1).max(CONVERSATION_MESSAGE_MAX)
+}).strict();
+var PostConversationMessageRequest = external_exports.object({ message: external_exports.string().min(1).max(CONVERSATION_MESSAGE_MAX) }).strict();
+var UpdateConversationRequest = external_exports.object({
+  title: external_exports.string().min(1).max(200).optional(),
+  archived: external_exports.boolean().optional()
+}).strict().superRefine((value, ctx) => {
+  if (value.title === void 0 && value.archived === void 0) {
+    ctx.addIssue({ code: "custom", message: "nothing to update" });
+  }
+});
+var ConversationResponse = external_exports.object({ conversation: ConversationProjection }).strict();
+var ListConversationsResponse = external_exports.object({ conversations: external_exports.array(ConversationProjection).max(CONVERSATION_LIST_LIMIT) }).strict();
+var ConversationDetailResponse = external_exports.object({
+  conversation: ConversationProjection,
+  events: external_exports.array(ConversationEventProjection)
+}).strict();
+var ManagerStreamFrame = external_exports.discriminatedUnion("type", [
+  external_exports.object({ type: external_exports.literal("event"), event: ConversationEventProjection }).strict(),
+  external_exports.object({ type: external_exports.literal("delta"), text: external_exports.string() }).strict(),
+  external_exports.object({ type: external_exports.literal("conversation"), conversation: ConversationProjection }).strict()
+]);
+
 // ../../packages/contracts/src/slack.ts
 var SlackInstallationProjection = external_exports.object({
   id: external_exports.string(),
@@ -37694,6 +37851,8 @@ function taskSourceLabel(origin) {
       return "Message";
     case "webhook":
       return "Webhook";
+    case "manager":
+      return "Manager";
     default:
       return void 0;
   }

package/package.json

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