@zixt/host 0.0.14 → 0.0.15

package/dist/index.js

@@ -31,7 +31,7 @@ import { homedir } from "node:os";
 // package.json
 var package_default = {
   name: "@zixt/host",
-  version: "0.0.14",
+  version: "0.0.15",
   type: "module",
   exports: {
     ".": "./src/client.ts",
@@ -14872,6 +14872,16 @@ var MemberApprovalRequestContext = ApprovalRequestContext.extend({
   }),
   acting: ApprovalRequestContext.shape.acting.extend({ providerPrincipal: external_exports.null() })
 });
+var QuestionChoice = external_exports.object({
+  label: external_exports.string().trim().min(1).max(120),
+  description: external_exports.string().trim().min(1).max(500).optional()
+}).strict();
+var QuestionChoices = external_exports.array(QuestionChoice).min(2).max(5).superRefine((choices, ctx) => {
+  const labels = choices.map(({ label }) => label.toLocaleLowerCase());
+  if (new Set(labels).size !== labels.length) {
+    ctx.addIssue({ code: "custom", message: "question choice labels must be unique" });
+  }
+});
 var Approval = external_exports.object({
   id: ApprovalId,
   orgId: OrgId,
@@ -14882,6 +14892,8 @@ var Approval = external_exports.object({
   summary: external_exports.string().min(1).max(500),
   /** The concrete action payload, rendered verbatim for review (GR-3). */
   payload: external_exports.string().max(5e4),
+  /** Present only when ask_user supplied a bounded multiple-choice question. */
+  questionChoices: QuestionChoices.optional(),
   status: ApprovalStatus,
   deliveryStatus: ApprovalDeliveryStatus,
   /** Why delivery became impossible; null while pending or after delivery. */
@@ -18455,7 +18467,9 @@ var ApprovalRequest = external_exports.object({
   category: external_exports.string(),
   summary: external_exports.string().min(1).max(500),
   /** Concrete action payload rendered verbatim on the approval card (GR-3). */
-  payload: external_exports.string().max(5e4)
+  payload: external_exports.string().max(5e4),
+  /** Optional structured answers for agent.question; absent means free text. */
+  questionChoices: QuestionChoices.optional()
 });
 var JournalAppend = external_exports.object({
   type: external_exports.literal("journal.append"),
@@ -20565,7 +20579,7 @@ var HostClient = class _HostClient {
       const { provider: _provider, ...legacyGrant } = grant;
       return legacyGrant;
     };
-    const requestApproval = (category, summary, payload) => {
+    const requestApproval = (category, summary, payload, questionChoices) => {
       if (authorityController.signal.aborted) {
         return Promise.resolve({ approved: false, guidance: "task was cancelled" });
       }
@@ -20577,7 +20591,8 @@ var HostClient = class _HostClient {
         requestId,
         category: safe(category, 200),
         summary: safe(summary, 500),
-        payload: safe(payload, 5e4)
+        payload: safe(payload, 5e4),
+        ...questionChoices ? { questionChoices: [...questionChoices] } : {}
       });
       return new Promise((resolve13) => {
         const waiters = this.approvalWaiters.get(cancelKey) ?? /* @__PURE__ */ new Map();
@@ -30709,7 +30724,7 @@ var CADENCE_PROPS = {
 var TOOLS = [
   {
     name: "ask_user",
-    description: "Ask the human supervising this task a question and wait for their answer. Use it whenever you need a decision, missing context, or plan approval before proceeding. The answer arrives as text.",
+    description: "Ask the human supervising this task a question and wait for their answer. Use it whenever you need a decision, missing context, or plan approval before proceeding. When there are 2-5 concrete alternatives, provide them as choices; the person can still enter another answer. The answer arrives as text.",
     inputSchema: {
       type: "object",
       properties: {
@@ -30717,9 +30732,35 @@ var TOOLS = [
         context: {
           type: "string",
           description: "Optional supporting detail shown alongside the question."
+        },
+        choices: {
+          type: "array",
+          minItems: 2,
+          maxItems: 5,
+          description: "Optional concrete answers. Omit when the person should type freely.",
+          items: {
+            type: "object",
+            properties: {
+              label: {
+                type: "string",
+                minLength: 1,
+                maxLength: 120,
+                description: "Short answer label."
+              },
+              description: {
+                type: "string",
+                minLength: 1,
+                maxLength: 500,
+                description: "Optional consequence or detail that helps the person choose."
+              }
+            },
+            required: ["label"],
+            additionalProperties: false
+          }
         }
       },
-      required: ["question"]
+      required: ["question"],
+      additionalProperties: false
     }
   },
   {
@@ -31242,7 +31283,22 @@ function createAskUserServer() {
           }
           try {
             const context = typeof args["context"] === "string" ? args["context"] : "";
-            toolText(await handlers.askUser(question, context));
+            const rawChoices = args["choices"];
+            const parsedChoices = rawChoices === void 0 ? void 0 : QuestionChoices.safeParse(rawChoices);
+            if (parsedChoices && !parsedChoices.success) {
+              toolText(
+                "Choices must contain 2-5 unique, non-empty labels with optional descriptions.",
+                true
+              );
+              return;
+            }
+            toolText(
+              await handlers.askUser(
+                question,
+                context,
+                parsedChoices?.success ? parsedChoices.data : void 0
+              )
+            );
           } catch (err) {
             toolText(`The question could not be delivered: ${String(err)}`, true);
           }
@@ -33428,13 +33484,14 @@ function createCliRunner(adapter, opts = {}) {
         throw new Error("prepared provider workspace does not match the task assignment");
       }
       askUserServer.register(runToken, {
-        askUser: async (question, context) => {
+        askUser: async (question, context, choices) => {
           pendingAsks++;
           try {
             const decision = await task.requestApproval(
               "agent.question",
               question.slice(0, 500),
-              (context || question).slice(0, MAX_APPROVAL_PAYLOAD)
+              (context || question).slice(0, MAX_APPROVAL_PAYLOAD),
+              choices
             );
             return decision.guidance ?? (decision.approved ? "Approved. Proceed." : "No. Do not proceed.");
           } finally {

package/package.json

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