@paulp-o/opencode-auq 1.6.0 → 2.0.0

package/README.md

@@ -5,8 +5,8 @@ OpenCode plugin that forwards `ask_user_questions` to the `auq ask` CLI.
 ## Install
 
 ```bash
-npm install -g auq-mcp-server
-npm install -g @paulp-o/opencode-auq
+bun add -g auq-mcp-server
+bun add -g @paulp-o/opencode-auq
 ```
 
 ## Configure OpenCode

package/dist/generated-schemas.d.ts

@@ -4,7 +4,7 @@
  * This file is generated from src/shared/schemas.ts by scripts/sync-plugin-schemas.mjs
  * Run "npm run sync-plugin-schemas" to regenerate.
  *
- * Generated at: 2026-02-01T12:12:16.659Z
+ * Generated at: 2026-02-06T03:21:22.056Z
  */
 /**
  * Comprehensive tool description - single source of truth.

package/dist/generated-schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generated-schemas.d.ts","sourceRoot":"","sources":["../src/generated-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoEH;;;GAGG;AACH,QAAA,MAAM,gBAAgB,QAUwD,CAAC;AAI/E,eAAO,MAAM,oBAAoB,EAAE,GAA4C,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"generated-schemas.d.ts","sourceRoot":"","sources":["../src/generated-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4IH;;;GAGG;AACH,QAAA,MAAM,gBAAgB,QAWoD,CAAC;AAI3E,eAAO,MAAM,oBAAoB,EAAE,GAA4C,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/generated-schemas.js

@@ -4,10 +4,29 @@
  * This file is generated from src/shared/schemas.ts by scripts/sync-plugin-schemas.mjs
  * Run "npm run sync-plugin-schemas" to regenerate.
  *
- * Generated at: 2026-02-01T12:12:16.659Z
+ * Generated at: 2026-02-06T03:21:22.056Z
  */
 import { tool } from "@opencode-ai/plugin/tool";
 const z = tool.schema;
+/**
+ * Default limits - can be overridden by config
+ * These are the hard maximums enforced by the schema (config can only reduce, not increase)
+ */
+const SCHEMA_LIMITS = {
+    MAX_OPTIONS: 10,
+    MAX_QUESTIONS: 10,
+    MIN_OPTIONS: 2,
+    MIN_QUESTIONS: 1,
+};
+/**
+ * Default recommended limits (used when no config is provided)
+ */
+const DEFAULT_LIMITS = {
+    maxOptions: 5,
+    maxQuestions: 5,
+    recommendedOptions: 4,
+    recommendedQuestions: 4,
+};
 const OptionSchema = z.object({
     label: z
         .string()
@@ -19,36 +38,68 @@ const OptionSchema = z.object({
         .describe("Explanation of what this option means or what will happen if chosen. " +
         "Useful for providing context about trade-offs or implications."),
 });
-const QuestionSchema = z.object({
-    prompt: z
-        .string()
-        .describe("The complete question to ask the user. Should be clear, specific, and end with a question mark. " +
-        "Example: 'Which programming language do you want to use?' " +
-        "If multiSelect is true, phrase it accordingly, e.g. 'Which features do you want to enable?'"),
-    title: z
-        .string()
-        .min(1, "Question title is required. Provide a short summary like 'Language' or 'Framework'.")
-        .describe("Very short label displayed as a chip/tag (max 12 chars). " +
-        "Examples: 'Auth method', 'Library', 'Approach'. " +
-        "This title appears in the interface to help users quickly identify questions."),
-    options: z
-        .array(OptionSchema)
-        .min(2)
-        .max(4)
-        .describe("The available choices for this question. Must have 2-4 options. " +
-        "Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). " +
-        "There should be no 'Other' option, that will be provided automatically."),
-    multiSelect: z
-        .boolean()
-        .describe("Set to true to allow the user to select multiple options instead of just one. " +
-        "Use when choices are not mutually exclusive. Default: false (single-select)"),
-});
-const QuestionsSchema = z.array(QuestionSchema).min(1).max(4);
-const AskUserQuestionsParametersSchema = z.object({
-    questions: QuestionsSchema.describe("Questions to ask the user (1-4 questions). " +
-        "Each question must include: prompt (full question text), title (short label, max 12 chars), " +
-        "options (2-4 choices with labels and descriptions), and multiSelect (boolean)."),
-});
+/**
+ * Create a QuestionSchema with configurable option limits
+ * @param maxOptions - Maximum number of options allowed (default: 4, max: 10)
+ */
+function createQuestionSchema(maxOptions = DEFAULT_LIMITS.maxOptions) {
+    // Clamp to valid range
+    const effectiveMax = Math.min(Math.max(maxOptions, SCHEMA_LIMITS.MIN_OPTIONS), SCHEMA_LIMITS.MAX_OPTIONS);
+    return z.object({
+        prompt: z
+            .string()
+            .describe("The complete question to ask the user. Should be clear, specific, and end with a question mark. " +
+            "Example: 'Which programming language do you want to use?' " +
+            "If multiSelect is true, phrase it accordingly, e.g. 'Which features do you want to enable?'"),
+        title: z
+            .string()
+            .min(1, "Question title is required. Provide a short summary like 'Language' or 'Framework'.")
+            .describe("Very short label displayed as a chip/tag (max 12 chars). " +
+            "Examples: 'Auth method', 'Library', 'Approach'. " +
+            "This title appears in the interface to help users quickly identify questions."),
+        options: z
+            .array(OptionSchema)
+            .min(SCHEMA_LIMITS.MIN_OPTIONS)
+            .max(effectiveMax)
+            .describe(`The available choices for this question. Must have ${SCHEMA_LIMITS.MIN_OPTIONS}-${effectiveMax} options. ` +
+            "Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). " +
+            "There should be no 'Other' option, that will be provided automatically."),
+        multiSelect: z
+            .boolean()
+            .describe("Set to true to allow the user to select multiple options instead of just one. " +
+            "Use when choices are not mutually exclusive. Default: false (single-select)"),
+    });
+}
+/**
+ * Create a QuestionsSchema with configurable limits
+ * @param maxQuestions - Maximum number of questions allowed (default: 4, max: 10)
+ * @param maxOptions - Maximum number of options per question (default: 4, max: 10)
+ */
+function createQuestionsSchema(maxQuestions = DEFAULT_LIMITS.maxQuestions, maxOptions = DEFAULT_LIMITS.maxOptions) {
+    const effectiveMaxQuestions = Math.min(Math.max(maxQuestions, SCHEMA_LIMITS.MIN_QUESTIONS), SCHEMA_LIMITS.MAX_QUESTIONS);
+    const questionSchema = createQuestionSchema(maxOptions);
+    return z
+        .array(questionSchema)
+        .min(SCHEMA_LIMITS.MIN_QUESTIONS)
+        .max(effectiveMaxQuestions);
+}
+/**
+ * Create the full parameters schema with configurable limits
+ * @param maxQuestions - Maximum number of questions (default: 4, max: 10)
+ * @param maxOptions - Maximum number of options per question (default: 4, max: 10)
+ */
+function createAskUserQuestionsParametersSchema(maxQuestions = DEFAULT_LIMITS.maxQuestions, maxOptions = DEFAULT_LIMITS.maxOptions) {
+    const questionsSchema = createQuestionsSchema(maxQuestions, maxOptions);
+    return z.object({
+        questions: questionsSchema.describe(`Questions to ask the user (1-${maxQuestions} questions). ` +
+            `Each question must include: prompt (full question text), title (short label, max 12 chars), ` +
+            `options (2-${maxOptions} choices with labels and descriptions), and multiSelect (boolean).`),
+    });
+}
+// Default schemas for backward compatibility (using DEFAULT_LIMITS)
+const QuestionSchema = createQuestionSchema();
+const QuestionsSchema = createQuestionsSchema();
+const AskUserQuestionsParametersSchema = createAskUserQuestionsParametersSchema();
 /**
  * Comprehensive tool description - single source of truth.
  * Used by MCP server and should be synced to opencode-plugin.
@@ -59,10 +110,11 @@ const TOOL_DESCRIPTION = "Use this tool when you need to ask the user questions
     "Get decisions on implementation choices as you work\n" +
     "Offer choices to the user about what direction to take.\n" +
     "Usage notes:\n\n" +
-    "Users will always be able to select \"Other\" to provide custom text input\n" +
+    'Users will always be able to select "Other" to provide custom text input\n' +
     "Use multiSelect: true to allow multiple answers to be selected for a question\n" +
-    "Recommend an option unless absolutely necessary, make it the first option in the list and add \"(Recommended)\" at the end of the label\n" +
-    "Do NOT use this tool to ask \"Is my plan ready?\" or \"Should I proceed?\"";
+    'Recommend an option unless absolutely necessary, make it the first option in the list and add "(Recommended)" at the end of the label\n' +
+    'For multiSelect questions, you MAY mark multiple options as "(Recommended)" if several choices are advisable\n' +
+    'Do NOT use this tool to ask "Is my plan ready?" or "Should I proceed?"';
 // Only export what the plugin needs
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export const AskUserQuestionsArgs = AskUserQuestionsParametersSchema.shape;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAmDlD,eAAO,MAAM,sBAAsB,EAAE,MAcnC,CAAC;AAEH,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAuFlD,eAAO,MAAM,sBAAsB,EAAE,MAgDnC,CAAC;AAEH,eAAe,sBAAsB,CAAC"}

package/dist/index.js

@@ -3,6 +3,33 @@ import { tool } from "@opencode-ai/plugin/tool";
 // Schemas are auto-generated from src/shared/schemas.ts
 // Run "npm run sync-plugin-schemas" to regenerate
 import { AskUserQuestionsArgs, TOOL_DESCRIPTION } from "./generated-schemas.js";
+// Map tool callID -> derived title (used by tool.execute.after)
+const titleByCallId = new Map();
+/**
+ * Generate a summary title for the question set
+ * Format: "Questions: [Q0] Language, [Q1] Framework"
+ */
+function generateQuestionSummary(questions) {
+    const questionLabels = questions
+        .map((q, i) => `[Q${i}] ${q.title}`)
+        .join(", ");
+    return `Questions: ${questionLabels}`;
+}
+function safeSummaryFromArgs(args) {
+    if (!args || typeof args !== "object")
+        return null;
+    const maybeQuestions = args.questions;
+    if (!Array.isArray(maybeQuestions))
+        return null;
+    const questions = maybeQuestions;
+    const labels = questions
+        .map((q, i) => {
+        const title = (q.title || q.prompt || "").toString().trim();
+        return `[Q${i}] ${title || "(untitled)"}`;
+    })
+        .join(", ");
+    return `Questions: ${labels}`;
+}
 const runAuqAsk = async (payload) => new Promise((resolve, reject) => {
     const child = spawn("auq", ["ask"], {
         stdio: ["pipe", "pipe", "pipe"],
@@ -41,9 +68,25 @@ export const AskUserQuestionsPlugin = async () => ({
         ask_user_questions: tool({
             description: TOOL_DESCRIPTION,
             args: AskUserQuestionsArgs,
-            async execute(args) {
+            async execute(args, context) {
+                // Best-effort: set call metadata (some OpenCode UIs won't render this title).
+                const questions = args.questions;
+                const summary = generateQuestionSummary(questions);
+                context.metadata({
+                    title: summary,
+                    metadata: { auqQuestionSummary: summary },
+                });
                 try {
-                    return await runAuqAsk({ questions: args.questions });
+                    // Get working directory from OpenCode context
+                    const workingDirectory = context.directory || context.worktree;
+                    // Build payload explicitly
+                    const payload = {
+                        questions,
+                    };
+                    if (workingDirectory) {
+                        payload.workingDirectory = workingDirectory;
+                    }
+                    return await runAuqAsk(payload);
                 }
                 catch (error) {
                     return `Error in session: ${String(error)}`;
@@ -51,5 +94,22 @@ export const AskUserQuestionsPlugin = async () => ({
             },
         }),
     },
+    // Force the tool call title in OpenCode UI.
+    "tool.execute.before": async (input, output) => {
+        if (input.tool !== "ask_user_questions")
+            return;
+        const summary = safeSummaryFromArgs(output.args);
+        if (summary)
+            titleByCallId.set(input.callID, summary);
+    },
+    "tool.execute.after": async (input, output) => {
+        if (input.tool !== "ask_user_questions")
+            return;
+        const summary = titleByCallId.get(input.callID);
+        if (summary) {
+            output.title = summary;
+        }
+        titleByCallId.delete(input.callID);
+    },
 });
 export default AskUserQuestionsPlugin;

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@paulp-o/opencode-auq",
-  "version": "1.6.0",
+  "version": "2.0.0",
   "description": "OpenCode plugin that forwards ask_user_questions to the auq CLI",
   "type": "module",
   "main": "dist/index.js",
@@ -13,7 +13,7 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "prepublishOnly": "npm run build",
+    "prepublishOnly": "bun run build",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "keywords": [
@@ -35,7 +35,7 @@
     "@opencode-ai/plugin": ">=1.0.0"
   },
   "devDependencies": {
-    "@opencode-ai/plugin": "^1.1.3",
+    "@opencode-ai/plugin": "^1.1.25",
     "@tsconfig/node22": "^22.0.1",
     "@types/node": "^22.13.0",
     "typescript": "^5.8.3"