@kenkaiiii/ggcoder 5.50.0 → 5.51.1

package/dist/tools/ask-user.js

@@ -0,0 +1,157 @@
+import { z } from "zod";
+import { ASK_USER_TIMEOUT_MS, formatAskResult, } from "../core/ask-user.js";
+/** Beyond this the band stops being a question and becomes a form. */
+const MAX_QUESTIONS = 5;
+const MAX_OPTIONS = 6;
+const Option = z.object({
+    label: z
+        .string()
+        .min(1)
+        .describe("A COMPLETE decision you can act on immediately, in plain words — what the user GETS, " +
+        "not the technical thing you do. Clicking sends this option and NOTHING else, so it " +
+        "must never ask the user to specify, describe, choose or clarify anything further: " +
+        "there is no text box behind a button. Bad: 'Fix something specific', 'Tell me more', " +
+        "'Something else', 'Other'. Good: 'Fix the failing upload test', 'Roll back the last " +
+        "deploy'. Under ~24 chars renders as a chip. Never a bare file path or jargon term."),
+    value: z.string().optional().describe("What you receive if picked. Defaults to the label."),
+    hint: z
+        .string()
+        .optional()
+        .describe("One short line under the label saying what this choice costs or trades off, in " +
+        "everyday language. Use it whenever the difference is not obvious from the label."),
+    recommended: z
+        .boolean()
+        .optional()
+        .describe("Marks your recommendation. Tagged in the UI, never preselected. Max one per question."),
+});
+const Question = z.object({
+    id: z.string().min(1).describe("Stable key your answer comes back under, e.g. `store`."),
+    question: z
+        .string()
+        .min(1)
+        .describe("The question in one plain line a non-technical person can answer without opening the " +
+        "code. Ask about the outcome they want, not the implementation. Define any term you " +
+        "cannot avoid. It must be answerable by a single click — never an open-ended prompt " +
+        "like 'What would you like me to do?', which a button cannot answer."),
+    kind: z
+        .enum(["confirm", "choice", "multi", "text"])
+        .describe("confirm = yes/no · choice = pick one of `options` · multi = pick any of `options` · text = free text only."),
+    detail: z
+        .string()
+        .optional()
+        .describe("One optional line of context under the question — the background they need to choose, " +
+        "in the same plain language."),
+    options: z.array(Option).max(MAX_OPTIONS).optional().describe("Required for choice/multi."),
+    allowOther: z
+        .boolean()
+        .optional()
+        .describe("Offer the free-text escape alongside the options. Default true."),
+});
+const AskUserParams = z.object({
+    questions: z
+        .array(Question)
+        .min(1)
+        .max(MAX_QUESTIONS)
+        .describe("One question, or the few that block you. Never pad the list."),
+});
+/** Yes/No is implied by `confirm`, so the model never has to spell it out. */
+const CONFIRM_OPTIONS = [
+    { label: "Yes", value: "yes" },
+    { label: "No", value: "no" },
+];
+/**
+ * Options that hand the decision straight back to the user.
+ *
+ * A click carries no payload beyond the option itself, so "Fix something
+ * specific" reaches the agent as literally that — an instruction it cannot
+ * act on. Catching it here turns a dead-end question into a tool error the
+ * model can immediately correct, instead of a button that wastes a turn.
+ */
+const DEFERRING = [
+    /\bsomething specific\b/i,
+    /\bsomething else\b/i,
+    /^(other|tell me more|you (choose|decide)|let me (specify|decide|explain))\b/i,
+    /\b(specify|describe|clarify|choose|pick|select|name)\b.*\b(it|one|which|what|something|a file|the file)\b/i,
+];
+function defersBack(option) {
+    return DEFERRING.some((re) => re.test(option.label.trim()));
+}
+function normalize(question) {
+    const options = question.kind === "confirm" && !question.options?.length ? CONFIRM_OPTIONS : question.options;
+    return {
+        id: question.id,
+        question: question.question,
+        kind: question.kind,
+        ...(question.detail ? { detail: question.detail } : {}),
+        ...(options ? { options } : {}),
+        ...(question.allowOther !== undefined ? { allowOther: question.allowOther } : {}),
+    };
+}
+/**
+ * Ask the user a question and block the turn until they answer.
+ *
+ * Registered only by hosts that can actually render it (the gg-app sidecar).
+ * A subagent, a headless run or the TUI has nobody to answer, so the tool is
+ * simply absent there and the agent falls back to asking in prose.
+ */
+export function createAskUserTool(ask) {
+    return {
+        name: "ask_user",
+        description: "Ask the user a question and wait for their answer, rendered as clickable options in the " +
+            "chat. THIS IS HOW YOU ASK — if a reply would otherwise end by asking them anything, ask " +
+            "it here instead. That covers the decision you are blocked on (a product or taste call, a " +
+            "destructive or irreversible action, a real tradeoff) AND the softer closer offering " +
+            'optional follow-up work ("want me to also…?", "should I do X next?"): both are ' +
+            "questions, so both belong on a clickable card rather than in prose. Do NOT use it for " +
+            "anything the code, docs or a command can answer, to confirm work you were already asked " +
+            "to do, or to check in on progress mid-task. No question to ask? Then do not call it — " +
+            "just end the reply.\n\n" +
+            "Write every question and option so a non-technical person can answer it confidently " +
+            "without reading the code: plain words, no jargon, no bare file paths or symbol names, " +
+            "each option describing the OUTCOME they get rather than the change you make. If two " +
+            "options could look the same to someone who has not seen the code, add a `hint` saying " +
+            "what each one costs. Always mark the option you would pick with `recommended`, so an " +
+            "unsure user can accept your judgment in one click.\n\n" +
+            "CRITICAL — every option must be a COMPLETE instruction you can act on the moment it is " +
+            "clicked. A click sends that option and nothing else: the user cannot type, elaborate or " +
+            "narrow it down. So never offer an option that only defers the decision back to them " +
+            "('Fix something specific', 'Choose a file', 'Tell me more', 'Something else'). If you " +
+            "need specifics you do not have, either find them yourself first, or list the actual " +
+            "candidates as separate options. The free-text escape already exists in the UI — you do " +
+            "not need to add an option for it.\n\n" +
+            "This REPLACES writing the question in your reply — do not also end the message with an " +
+            "asking line, and do not restate the options as text.\n\n" +
+            'Good: question "Where should people\'s login sessions be stored?", options "Keep it ' +
+            'simple (one file)" [recommended, hint "No extra setup, fine to a few thousand users"] ' +
+            'and "Use a real database" [hint "More setup now, handles far more users"].\n' +
+            'Bad: question "SQLite or Postgres for the session store?", options "SQLite", ' +
+            '"Postgres" — the user cannot tell what either choice costs them.',
+        parameters: AskUserParams,
+        // The turn is blocked on a human; nothing else in the batch may run first.
+        executionMode: "sequential",
+        // The host's own timeout is the real bound. Without this the loop's 5-min
+        // default would abort the call while the user is still reading the
+        // question, and the answer would land on a tool call that no longer exists.
+        timeoutMs: ASK_USER_TIMEOUT_MS + 30_000,
+        async execute({ questions }) {
+            const ids = new Set(questions.map((q) => q.id));
+            if (ids.size !== questions.length) {
+                return "Error: every question needs a unique `id`.";
+            }
+            const missing = questions.find((q) => (q.kind === "choice" || q.kind === "multi") && (q.options?.length ?? 0) < 2);
+            if (missing) {
+                return `Error: question "${missing.id}" is kind "${missing.kind}" and needs at least 2 options.`;
+            }
+            const deferring = questions.flatMap((q) => q.options ?? []).find(defersBack);
+            if (deferring) {
+                return (`Error: the option "${deferring.label}" asks the user to specify something, but a ` +
+                    "click sends only that option — they cannot type or elaborate. Replace it with the " +
+                    "actual choices, or find the specifics yourself first. (The free-text escape is " +
+                    "already built into the UI.)");
+            }
+            const normalized = questions.map(normalize);
+            return formatAskResult(normalized, await ask({ questions: normalized }));
+        },
+    };
+}
+//# sourceMappingURL=ask-user.js.map

package/dist/tools/ask-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user.js","sourceRoot":"","sources":["../../src/tools/ask-user.ts"],"names":[],"mappings":"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"}

package/dist/tools/prompt-hints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-hints.d.ts","sourceRoot":"","sources":["../../src/tools/prompt-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA2CpD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC;IAChD,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd,CAqBA,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAKxE;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EA8B/C,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAsB/C,CAAC"}
+{"version":3,"file":"prompt-hints.d.ts","sourceRoot":"","sources":["../../src/tools/prompt-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+CpD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC;IAChD,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd,CAqBA,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAKxE;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EA+B/C,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAsB/C,CAAC"}

package/dist/tools/prompt-hints.js

@@ -28,6 +28,9 @@ export const TOOL_PROMPT_HINTS = {
     list_agents: "List child agent IDs, states, turns and token totals.",
     interrupt_agent: "Interrupt a child agent's current turn, keeping its context for a follow-up.",
     tasks: "Manage the project task list. Never proactively — only on explicit request, or at a slash-command's task-handoff step.",
+    ask_user: "Any question ending a reply — blocker or optional next step — goes here as clickable " +
+        "options, never prose. Plain words; mark your pick `recommended`. A click sends only that " +
+        "option, so each must be a complete instruction, not one asking them to specify.",
     enter_plan: "Enter read-only plan mode for complex/risky tasks before implementation; draft a plan under .gg/plans/.",
     exit_plan: "Submit a .gg/plans/ markdown plan for user approval and leave plan mode.",
     subagent: "Delegate focused, isolated subtasks (research, parallel exploration).",
@@ -86,6 +89,7 @@ export function buildToolSteering(activeTools) {
  * would otherwise cost the agent a capability with no signal at all.
  */
 export const BUILTIN_TOOL_NAMES = [
+    "ask_user",
     "bash",
     "code_nav",
     "code_search",

package/dist/tools/prompt-hints.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-hints.js","sourceRoot":"","sources":["../../src/tools/prompt-hints.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prompt-hints.js","sourceRoot":"","sources":["../../src/tools/prompt-hints.ts"],"names":[],"mappings":"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"}

package/dist/tools/tool-tiers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-tiers.d.ts","sourceRoot":"","sources":["../../src/tools/tool-tiers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAqB5C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAUhD,CAAC;AAIF,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,4EAA4E;IAC5E,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,iBAAiB,CAQnF"}
+{"version":3,"file":"tool-tiers.d.ts","sourceRoot":"","sources":["../../src/tools/tool-tiers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAyB5C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAUhD,CAAC;AAIF,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,4EAA4E;IAC5E,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,iBAAiB,CAQnF"}

package/dist/tools/tool-tiers.js

@@ -18,6 +18,10 @@
  * rates hold: measure that, not just the token saving, before moving a name.
  */
 export const CORE_TOOL_NAMES = [
+    // Core wherever it is registered at all (the app sidecar): a question the
+    // model must `tool_search` for first is a question it writes in prose
+    // instead. Hosts with nobody to answer never build it, so they pay nothing.
+    "ask_user",
     "read",
     "write",
     "edit",

package/dist/tools/tool-tiers.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-tiers.js","sourceRoot":"","sources":["../../src/tools/tool-tiers.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,IAAI;IACJ,aAAa;IACb,UAAU;IACV,YAAY;IACZ,WAAW;IACX,aAAa;IACb,WAAW;IACX,WAAW;IACX,UAAU;IACV,aAAa;IACb,OAAO;IACP,YAAY;IACZ,WAAW;IACX,aAAa;CACd,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IACpD,aAAa;IACb,YAAY;IACZ,gBAAgB;IAChB,OAAO;IACP,cAAc;IACd,eAAe;IACf,YAAY;IACZ,aAAa;IACb,iBAAiB;CAClB,CAAC;AAEF,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC,mBAAmB,CAAC,CAAC;AASvE;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAA2B;IAC9D,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAgB,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YAChD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"tool-tiers.js","sourceRoot":"","sources":["../../src/tools/tool-tiers.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,0EAA0E;IAC1E,sEAAsE;IACtE,4EAA4E;IAC5E,UAAU;IACV,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,IAAI;IACJ,aAAa;IACb,UAAU;IACV,YAAY;IACZ,WAAW;IACX,aAAa;IACb,WAAW;IACX,WAAW;IACX,UAAU;IACV,aAAa;IACb,OAAO;IACP,YAAY;IACZ,WAAW;IACX,aAAa;CACd,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IACpD,aAAa;IACb,YAAY;IACZ,gBAAgB;IAChB,OAAO;IACP,cAAc;IACd,eAAe;IACf,YAAY;IACZ,aAAa;IACb,iBAAiB;CAClB,CAAC;AAEF,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC,mBAAmB,CAAC,CAAC;AASvE;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAA2B;IAC9D,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAgB,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YAChD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kenkaiiii/ggcoder",
-  "version": "5.50.0",
+  "version": "5.51.1",
   "type": "module",
   "description": "CLI coding agent with OAuth authentication for Anthropic, OpenAI, and Gemini",
   "license": "MIT",
@@ -115,9 +115,9 @@
     "typescript-language-server": "^5.3.0",
     "wrap-ansi": "^10.0.0",
     "zod": "^4.4.3",
-    "@kenkaiiii/gg-agent": "5.50.0",
-    "@kenkaiiii/gg-ai": "5.50.0",
-    "@kenkaiiii/gg-core": "5.50.0"
+    "@kenkaiiii/gg-ai": "5.51.1",
+    "@kenkaiiii/gg-agent": "5.51.1",
+    "@kenkaiiii/gg-core": "5.51.1"
   },
   "optionalDependencies": {
     "@huggingface/transformers": "^3.6.0",