@qxbyte/muse 0.1.2 → 0.1.3

package/dist/index.js

@@ -1255,6 +1255,61 @@ var MemoryReadTool = defineTool({
   }
 });
 
+// src/tools/builtin/ask-user-question.ts
+import { z as z10 } from "zod";
+var AskQuestionOptionSchema = z10.object({
+  label: z10.string().min(1).describe("Option text shown to the user. Concise (1-5 words)."),
+  description: z10.string().optional().describe("Optional one-line explanation of what this option means."),
+  preview: z10.string().optional().describe(
+    "Optional rich preview rendered in a right-side panel when this option is focused. Use for code/diagram/config snippets that help compare options visually. Multi-line text supported."
+  )
+});
+var AskQuestionSchema = z10.object({
+  question: z10.string().min(1).describe("Full question text (end with ?)."),
+  header: z10.string().min(1).max(16).describe("Very short label (chip), max 12 chars. E.g. 'Auth method'."),
+  options: z10.array(AskQuestionOptionSchema).min(2).max(4).describe("2-4 options. Mutually exclusive unless multiSelect=true."),
+  multiSelect: z10.boolean().optional().describe("Allow multiple selections. Default false.")
+});
+var AskUserQuestionArgs = z10.object({
+  questions: z10.array(AskQuestionSchema).min(1).max(4).describe("1-4 questions to ask the user sequentially.")
+});
+var AskUserQuestionTool = defineTool({
+  name: "AskUserQuestion",
+  description: "Ask the user one or more multiple-choice questions when their input is needed to proceed. Each question has 2-4 options. Use multiSelect=true for non-mutually-exclusive choices. Prefer this over plain-text questions when the answer space is bounded. If the user presses Esc, the entire batch is treated as cancelled.",
+  parameters: AskUserQuestionArgs,
+  permission: "read",
+  summarize: (args) => `AskUserQuestion(${args.questions.length} question${args.questions.length === 1 ? "" : "s"})`,
+  async execute(args, ctx) {
+    if (!ctx.askQuestions) {
+      return {
+        content: "AskUserQuestion is unavailable: this agent run has no question handler. (Internal bug; tell the user.)",
+        isError: true
+      };
+    }
+    const responses = await ctx.askQuestions(args.questions);
+    if (responses.length > 0 && responses[0].cancelled) {
+      return {
+        content: "User cancelled (Esc). No answers were collected.",
+        isError: false
+      };
+    }
+    const blocks = args.questions.map((q, qi) => {
+      const r = responses[qi];
+      const sel = r?.selections ?? [];
+      const ans = sel.length === 0 ? "(no answer)" : sel.join(", ");
+      const notes = r?.notes?.trim();
+      return notes ? `Q: ${q.question}
+A: ${ans}
+Notes: ${notes}` : `Q: ${q.question}
+A: ${ans}`;
+    });
+    return {
+      content: blocks.join("\n\n"),
+      summary: `Asked ${args.questions.length} question${args.questions.length === 1 ? "" : "s"}`
+    };
+  }
+});
+
 // src/tools/builtin/index.ts
 var BUILTIN_TOOLS = [
   ReadTool,
@@ -1266,7 +1321,8 @@ var BUILTIN_TOOLS = [
   TodoWriteTool,
   WebFetchTool,
   MemoryReadTool,
-  MemoryWriteTool
+  MemoryWriteTool,
+  AskUserQuestionTool
 ];
 
 // src/permission/index.ts
@@ -1592,6 +1648,7 @@ ${todoSection}` : this.ctx.systemPrompt;
         this.ctx.events?.onTurnEnd?.();
         return;
       }
+      this.ctx.events?.onAssistantTurn?.();
       for (const call of toolCallsToRun) {
         await this.runToolCall(call);
       }
@@ -1672,7 +1729,8 @@ ${todoSection}` : this.ctx.systemPrompt;
       abortSignal: this.ctx.abortSignal,
       askPermission: async () => true,
       // 已在外层处理
-      todos: this.todos
+      todos: this.todos,
+      askQuestions: this.ctx.events?.onAskQuestions ? (qs) => this.ctx.events.onAskQuestions(qs) : void 0
     };
     const result = await this.ctx.tools.execute(call.name, call.args, toolCtx);
     this.recordToolResult(call.id, call.name, result.content, result.isError ?? false, result.summary, result.diff, result.kind);
@@ -1752,38 +1810,38 @@ import { homedir as homedir6 } from "os";
 import { join as join4, resolve as resolve5 } from "path";
 
 // src/config/types.ts
-import { z as z10 } from "zod";
-var ProviderConfigSchema = z10.object({
-  apiKey: z10.string().optional(),
-  baseUrl: z10.string().optional(),
-  extraHeaders: z10.record(z10.string()).optional()
+import { z as z11 } from "zod";
+var ProviderConfigSchema = z11.object({
+  apiKey: z11.string().optional(),
+  baseUrl: z11.string().optional(),
+  extraHeaders: z11.record(z11.string()).optional()
 }).passthrough();
-var LLMConfigSchema = z10.object({
-  provider: z10.string().optional().describe("Fallback provider preset (only used when no models.local.json entry matches)."),
-  model: z10.string().optional().describe("Active model id; should match an id in models.local.json."),
-  temperature: z10.number().min(0).max(2).optional(),
-  maxTokens: z10.number().int().positive().optional()
+var LLMConfigSchema = z11.object({
+  provider: z11.string().optional().describe("Fallback provider preset (only used when no models.local.json entry matches)."),
+  model: z11.string().optional().describe("Active model id; should match an id in models.local.json."),
+  temperature: z11.number().min(0).max(2).optional(),
+  maxTokens: z11.number().int().positive().optional()
 });
-var PermissionsSchema = z10.object({
-  allow: z10.array(z10.string()).optional(),
-  ask: z10.array(z10.string()).optional(),
-  deny: z10.array(z10.string()).optional(),
-  defaultMode: z10.enum(["strict", "relaxed", "ask"]).optional()
+var PermissionsSchema = z11.object({
+  allow: z11.array(z11.string()).optional(),
+  ask: z11.array(z11.string()).optional(),
+  deny: z11.array(z11.string()).optional(),
+  defaultMode: z11.enum(["strict", "relaxed", "ask"]).optional()
 });
-var UISchema = z10.object({
-  theme: z10.enum(["dark", "light"]).optional(),
-  lang: z10.enum(["en", "zh-CN"]).optional(),
-  showBanner: z10.boolean().optional()
+var UISchema = z11.object({
+  theme: z11.enum(["dark", "light"]).optional(),
+  lang: z11.enum(["en", "zh-CN"]).optional(),
+  showBanner: z11.boolean().optional()
 });
-var SettingsSchema = z10.object({
+var SettingsSchema = z11.object({
   llm: LLMConfigSchema.optional(),
-  providers: z10.record(ProviderConfigSchema).optional(),
+  providers: z11.record(ProviderConfigSchema).optional(),
   permissions: PermissionsSchema.optional(),
   ui: UISchema.optional(),
-  mcpServers: z10.record(z10.unknown()).optional(),
-  skills: z10.object({
-    enabled: z10.boolean().optional(),
-    disabled: z10.array(z10.string()).optional()
+  mcpServers: z11.record(z11.unknown()).optional(),
+  skills: z11.object({
+    enabled: z11.boolean().optional(),
+    disabled: z11.array(z11.string()).optional()
   }).optional()
 }).passthrough();