@rol1n/pi-kit 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,99 @@
-# Temporary Holding Version
+# pi-kit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Pi extensions and prompt templates, published together as **`@rol1n/pi-kit`** or as individual extension packages. Each extension's README describes its commands, settings, platform support, and dependencies.
+
+## Install
+
+```sh
+pi install npm:@rol1n/pi-kit
+```
+
+Install from GitHub or a local checkout during development:
+
+```sh
+pi install git:git@github.com:RolinShmily/pi-kit.git
+pi install /absolute/path/to/pi-kit
+```
+
+Update an installed package with `pi update npm:@rol1n/pi-kit`, or update all Pi packages with `pi update --extensions`.
+
+## Extensions
+
+| Package and documentation | Purpose | Included in the kit |
+|---|---|---|
+| [ask-u-questions](extensions/ask-u-questions/README.md) | Interactive questions | Yes |
+| [continue-signal](extensions/continue-signal/README.md) | Resume an idle agent | Yes |
+| [custom-providers](extensions/custom-providers/README.md) | Additional model providers and gateway configuration | Yes |
+| [image-generate](extensions/image-generate/README.md) | Image generation and model selection | Yes |
+| [memory-log](extensions/memory-log/README.md) | Background observational memory | Yes |
+| [model-vision](extensions/model-vision/README.md) | Image understanding and OCR | No |
+| [multi-harness](extensions/multi-harness/README.md) | Delegate to Pi, Codex, Claude, and OpenCode | Yes |
+| [oai-subquota](extensions/oai-subquota/README.md) | Codex subscription quota | Yes |
+| [prompt-snipaste](extensions/prompt-snipaste/README.md) | Select snippets for the next user message | Yes |
+| [screenshot](extensions/screenshot/README.md) | Reference the latest Windows/WSL screenshot | No |
+| [srp-theme](extensions/srp-theme/README.md) | Footer, prompt preview, and throughput display | Yes |
+| [subagent](extensions/subagent/README.md) | Delegate to asynchronous Pi workers | Yes |
+| [tui-asr](extensions/tui-asr/README.md) | Streaming voice dictation | Yes |
+| [web-reach](extensions/web-reach/README.md) | Web search and page extraction | Yes |
+| [windows-wheel-fix](extensions/windows-wheel-fix/README.md) | Windows ConPTY/Zellij mouse reporting | Yes, active only on Windows |
+
+Independent package names use the `@rol1n/<name>` scope, such as `@rol1n/memory-log` or `@rol1n/multi-harness`. Each package has its own release version and README; the implementation is shared with the kit.
+
+Every extension uses the same directory layout:
+
+```text
+extensions/<name>/
+├── index.ts          # Pi entrypoint and registration
+├── README.md         # Package documentation
+└── ...               # Modules grouped by responsibility
+```
+
+UI, transport, parsing, and storage helpers live beside the entrypoint as needed. Small extensions can remain a single cohesive `index.ts`.
+
+## Resource selection
+
+The kit currently exposes 13 extension entrypoints and the seven templates in [prompts](prompts/). Personal skills, provider credentials, MCP servers, and keybindings remain normal Pi configuration.
+
+Use `pi config` or narrow package resources in personal/project settings:
+
+```json
+{
+  "packages": [
+    {
+      "source": "npm:@rol1n/pi-kit",
+      "extensions": ["extensions/**", "!extensions/tui-asr/**"],
+      "prompts": ["prompts/diagnose-report.md"]
+    }
+  ]
+}
+```
+
+Omit a resource field to load the package defaults; use `[]` to disable that resource type. Filters select resources already exposed by the package. When also installing an independent extension package, exclude its entry from the kit to avoid loading the same feature twice.
+
+## Build and publish
+
+From a source checkout, edit [kit.config.json](https://github.com/RolinShmily/pi-kit/blob/main/kit.config.json) to choose each extension's `bundle` flag, package name, version, entrypoint, runtime files, and README. Then synchronize and inspect the aggregate release:
+
+```sh
+npm run manifest
+npm run check
+npm pack --dry-run --ignore-scripts
+npm publish --access public
+```
+
+Prepare an independent release from the same source:
+
+```sh
+npm run prepare:extension -- memory-log
+cd dist/extensions/memory-log
+npm pack --dry-run --ignore-scripts
+npm publish --access public
+```
+
+The preparation command copies that extension's README to the package root and includes shared implementation files where needed. Add new runtime assets to its `files` list. Names and versions are configured independently; use an available npm name and a new version for each publication. Preparation does not install dependencies or publish anything.
+
+All packages link to [RolinShmily/pi-kit](https://github.com/RolinShmily/pi-kit). The `pi-package` keyword makes each published package eligible for the Pi gallery; indexing can take time. Pi supplies the host libraries declared as peer dependencies.
+
+## Attribution
+
+Existing author and copyright notices remain with their source files. Upstream issue references and integration details are linked from the individual extension READMEs, including the [Windows terminal workaround](extensions/windows-wheel-fix/README.md).

package/extensions/ask-u-questions/README.md

@@ -0,0 +1,32 @@
+# ask-u-questions
+
+Interactive single-choice, multiple-choice, and free-text questions for Pi. Registers the `ask_user_question` tool and serializes dialogs through a shared UI lock.
+
+## Install
+
+```sh
+pi install npm:@rol1n/ask-u-questions
+```
+
+Also included in `@rol1n/pi-kit`. Enable one copy of the extension.
+
+## Use
+
+The agent calls the tool with a question and optional choices:
+
+```json
+{
+  "question": "Which output format should I use?",
+  "options": [
+    { "label": "Markdown (Recommended)", "value": "markdown" },
+    { "label": "JSON", "value": "json" }
+  ],
+  "multiSelect": false
+}
+```
+
+Omit `options` or supply an empty array for free-text input. Set `multiSelect` only when several choices are expected. `details` adds supporting context; an Other choice is supplied automatically for choice questions.
+
+## Requirements and behavior
+
+Use an interactive Pi terminal session for dialogs. Results distinguish answered, cancelled, and unavailable states, so a cancelled dialog is not an approval. No API credentials or package-specific settings are required.

package/extensions/ask-u-questions/answers.ts

@@ -0,0 +1,53 @@
+import type { AskAnswer, AskOption } from "./types.ts";
+
+export function normalizeOptions(
+  options: Array<{ label: string; value?: string; description?: string }> | undefined,
+): AskOption[] {
+  return (options || [])
+    .map((option) => ({
+      label: option.label.trim(),
+      value: option.value?.trim() || option.label.trim(),
+      description: option.description?.trim() || undefined,
+    }))
+    .filter((option) => option.label.length > 0);
+}
+
+export function isChineseContext(
+  question: string,
+  options?: Array<{ label?: string; description?: string }>,
+  context?: string,
+): boolean {
+  if (/[\u4e00-\u9fa5]/.test(question)) return true;
+  if (context && /[\u4e00-\u9fa5]/.test(context)) return true;
+  if (options && options.some((o) => (o.label && /[\u4e00-\u9fa5]/.test(o.label)) || (o.description && /[\u4e00-\u9fa5]/.test(o.description)))) {
+    return true;
+  }
+  return false;
+}
+
+export function getOtherLabel(options: AskOption[], isZh = false): string {
+  if (isZh) {
+    return options.some((option) => option.label === "其他（自定义输入）")
+      ? "自定义输入"
+      : "其他（自定义输入）";
+  }
+  return options.some((option) => option.label === "Other (custom input)")
+    ? "Custom input"
+    : "Other (custom input)";
+}
+
+function answerSortRank(answer: AskAnswer): number {
+  switch (answer.type) {
+    case "option":
+      return answer.index;
+    case "other":
+      return Number.MAX_SAFE_INTEGER - 1;
+    case "text":
+      return Number.MAX_SAFE_INTEGER;
+  }
+}
+
+export function sortAnswers(answers: AskAnswer[]): AskAnswer[] {
+  return [...answers].sort((a, b) => answerSortRank(a) - answerSortRank(b));
+}
+

package/extensions/ask-u-questions/dialog-ui.ts

@@ -0,0 +1,57 @@
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { type EditorTheme, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+
+export function createEditorTheme(theme: Theme): EditorTheme {
+  return {
+    borderColor: (s) => theme.fg("accent", s),
+    selectList: {
+      selectedPrefix: (t) => theme.fg("accent", t),
+      selectedText: (t) => theme.fg("accent", t),
+      description: (t) => theme.fg("muted", t),
+      scrollInfo: (t) => theme.fg("dim", t),
+      noMatch: (t) => theme.fg("warning", t),
+    },
+  };
+}
+
+export function addWrapped(
+  lines: string[],
+  text: string,
+  width: number,
+  firstIndent = " ",
+  restIndent = firstIndent,
+  styleFn?: (line: string) => string,
+): void {
+  if (!text) return;
+  const paragraphs = text.split(/\r?\n/);
+  for (let pIdx = 0; pIdx < paragraphs.length; pIdx++) {
+    const paragraph = paragraphs[pIdx];
+    if (paragraph.length === 0) {
+      lines.push("");
+      continue;
+    }
+    const isFirstParagraph = pIdx === 0;
+    const currentFirstIndent = isFirstParagraph ? firstIndent : restIndent;
+    const firstWidth = Math.max(1, width - visibleWidth(currentFirstIndent));
+    const restWidth = Math.max(1, width - visibleWidth(restIndent));
+
+    if (firstWidth === restWidth) {
+      const wrapped = wrapTextWithAnsi(paragraph, firstWidth);
+      for (let i = 0; i < wrapped.length; i++) {
+        const indent = isFirstParagraph && i === 0 ? firstIndent : restIndent;
+        const rawLine = wrapped[i];
+        const styled = styleFn ? styleFn(rawLine) : rawLine;
+        lines.push(truncateToWidth(`${indent}${styled}`, width));
+      }
+    } else {
+      const wrapped = wrapTextWithAnsi(paragraph, Math.min(firstWidth, restWidth));
+      for (let i = 0; i < wrapped.length; i++) {
+        const indent = isFirstParagraph && i === 0 ? firstIndent : restIndent;
+        const rawLine = wrapped[i];
+        const styled = styleFn ? styleFn(rawLine) : rawLine;
+        lines.push(truncateToWidth(`${indent}${styled}`, width));
+      }
+    }
+  }
+}
+

package/extensions/ask-u-questions/index.ts

@@ -0,0 +1,88 @@
+/** Interactive questions, serialized through the shared dialog lock. */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { AskUserQuestionMode } from "./types.ts";
+import { AskUserQuestionParams } from "./schema.ts";
+import { normalizeOptions } from "./answers.ts";
+import { buildResult, cancelledResult, unavailableResult } from "./results.ts";
+import { askSingleChoice } from "./single-choice.ts";
+import { askMultiChoice } from "./multi-choice.ts";
+import { withUILock } from "./ui-lock.ts";
+import { questionRenderers } from "./tool-renderers.ts";
+
+export type { AskOption, TextAnswer, OptionAnswer, OtherAnswer, AskAnswer, AskUserQuestionStatus, AskUserQuestionMode, AskUserQuestionResultDetails } from "./types.ts";
+
+export default function (pi: ExtensionAPI) {
+  pi.registerTool({
+    name: "ask_user_question",
+    label: "Ask User Question",
+    description:
+      "Ask the user a clear question and pause execution until they select an option or provide input. Useful when requirements are ambiguous, user preferences or architectural decisions are needed, or critical operations require explicit user confirmation. Always phrase the question and options in the same language as the conversation context. Ask exactly one focused question per call.",
+    promptSnippet:
+      "Ask the user a question to clarify requirements or gather decisions instead of making assumptions.",
+    promptGuidelines: [
+      "Always phrase the question and options in the same language as the conversation context (e.g. ask in Chinese if conversing in Chinese, ask in English if conversing in English).",
+      "Ask exactly one specific question per tool call.",
+      "If you need input across multiple distinct dimensions, make separate tool calls instead of combining them into one.",
+      "When options are provided, an 'Other (custom input)' choice is automatically available in the user interface.",
+      "Set multiSelect: true only when the user is expected to select multiple choices.",
+      'Put the recommended option first in the list and append "(Recommended)" to its label.',
+      "Prefer using this tool whenever multiple valid implementation paths exist that depend on user preference.",
+    ],
+    parameters: AskUserQuestionParams,
+
+    async execute(_toolCallId, params, signal, _onUpdate, ctx) {
+      const options = normalizeOptions(params.options);
+      const context = params.details?.trim() || undefined;
+      const mode: AskUserQuestionMode =
+        options.length === 0
+          ? "text"
+          : params.multiSelect
+            ? "multi-select"
+            : "single-select";
+
+      if (signal?.aborted) {
+        return cancelledResult(params.question, mode, context);
+      }
+
+      if (!ctx.hasUI) {
+        return unavailableResult(
+          params.question,
+          mode,
+          "ask_user_question requires an interactive TUI environment",
+          context,
+        );
+      }
+
+      return withUILock(async () => {
+        if (mode === "text") {
+          const editorTitle = context
+            ? `${params.question}\n\n${context}`
+            : params.question;
+          const answer = await ctx.ui.editor(editorTitle);
+          if (answer === undefined) {
+            return cancelledResult(params.question, mode, context);
+          }
+          return buildResult(params.question, context, mode, [
+            { type: "text", label: answer.trim(), value: answer.trim() },
+          ]);
+        }
+
+        if (mode === "single-select") {
+          const answer = await askSingleChoice(ctx, params.question, context, options);
+          if (!answer) {
+            return cancelledResult(params.question, mode, context);
+          }
+          return buildResult(params.question, context, mode, [answer]);
+        }
+
+        const answers = await askMultiChoice(ctx, params.question, context, options);
+        if (!answers) {
+          return cancelledResult(params.question, mode, context);
+        }
+        return buildResult(params.question, context, mode, answers);
+      });
+    },
+
+    ...questionRenderers,
+  });
+}

package/extensions/ask-u-questions/multi-choice.ts

@@ -0,0 +1,260 @@
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { Editor, Key, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import type { AskAnswer, AskOption, DisplayOption } from "./types.ts";
+import { getOtherLabel, isChineseContext, sortAnswers } from "./answers.ts";
+import { addWrapped, createEditorTheme } from "./dialog-ui.ts";
+
+export async function askMultiChoice(
+  ctx: ExtensionContext,
+  question: string,
+  context: string | undefined,
+  options: AskOption[],
+): Promise<AskAnswer[] | null> {
+  const isZh = isChineseContext(question, options, context);
+  const otherLabel = getOtherLabel(options, isZh);
+  const choiceItems: DisplayOption[] = options.map((option, index) => ({
+    ...option,
+    id: `option:${index}`,
+    index: index + 1,
+  }));
+  const submitItem: DisplayOption = {
+    id: "submit",
+    label: isZh ? "提交确认" : "Confirm & Submit",
+    value: "__submit__",
+    isSubmit: true,
+  };
+  const allItems: DisplayOption[] = [
+    ...choiceItems,
+    { id: "other", label: otherLabel, value: "__other__", isOther: true },
+    submitItem,
+  ];
+
+  return ctx.ui.custom<AskAnswer[] | null>(
+    (tui, theme, _kb, done: (result: AskAnswer[] | null) => void) => {
+      let optionIndex = 0;
+      let editMode = false;
+      let cachedLines: string[] | undefined;
+      let cachedWidth = -1;
+      let componentFocused = false;
+      const selected = new Map<string, AskAnswer>();
+      const editor = new Editor(tui, createEditorTheme(theme));
+
+      editor.onSubmit = (value) => {
+        const trimmed = value.trim();
+        if (!trimmed) return;
+        selected.set("other", { type: "other", label: trimmed, value: trimmed });
+        editMode = false;
+        editor.focused = false;
+        refresh();
+      };
+
+      function refresh() {
+        cachedLines = undefined;
+        tui.requestRender();
+      }
+
+      function toggleOption(item: DisplayOption) {
+        if (selected.has(item.id)) {
+          selected.delete(item.id);
+        } else {
+          selected.set(item.id, {
+            type: "option",
+            label: item.label,
+            value: item.value,
+            index: item.index!,
+          });
+        }
+        refresh();
+      }
+
+      function handleInput(data: string) {
+        if (editMode) {
+          if (matchesKey(data, Key.escape)) {
+            editMode = false;
+            editor.focused = false;
+            editor.setText(selected.get("other")?.label || "");
+            refresh();
+            return;
+          }
+          editor.handleInput(data);
+          refresh();
+          return;
+        }
+
+        if (matchesKey(data, Key.up)) {
+          optionIndex = Math.max(0, optionIndex - 1);
+          refresh();
+          return;
+        }
+        if (matchesKey(data, Key.down)) {
+          optionIndex = Math.min(allItems.length - 1, optionIndex + 1);
+          refresh();
+          return;
+        }
+
+        const current = allItems[optionIndex];
+        if (matchesKey(data, Key.space)) {
+          if (current.isSubmit) return;
+          if (current.isOther) {
+            if (selected.has("other")) {
+              selected.delete("other");
+              refresh();
+            } else {
+              editMode = true;
+              editor.focused = componentFocused;
+              editor.setText("");
+              refresh();
+            }
+            return;
+          }
+          toggleOption(current);
+          return;
+        }
+
+        if (matchesKey(data, Key.enter)) {
+          if (current.isSubmit) {
+            if (selected.size > 0) {
+              done(sortAnswers(Array.from(selected.values())));
+            }
+            return;
+          }
+          if (current.isOther) {
+            editMode = true;
+            editor.focused = componentFocused;
+            editor.setText(selected.get("other")?.label || "");
+            refresh();
+            return;
+          }
+          toggleOption(current);
+          return;
+        }
+
+        if (matchesKey(data, Key.escape)) {
+          done(null);
+        }
+      }
+
+      function render(width: number): string[] {
+        if (cachedLines && cachedWidth === width) return cachedLines;
+
+        const lines: string[] = [];
+        const add = (text: string) => lines.push(truncateToWidth(text, width));
+
+        add(theme.fg("accent", "─".repeat(width)));
+
+        if (editMode) {
+          addWrapped(lines, question, width, " ", " ", (l) => theme.fg("text", theme.bold(l)));
+          if (context) {
+            addWrapped(lines, context, width, " ", " ", (l) => theme.fg("muted", l));
+          }
+          lines.push("");
+          const header = allItems[optionIndex]?.label || otherLabel;
+          add(theme.fg("accent", ` > ${header}:`));
+          for (const line of editor.render(Math.max(1, width - 4))) {
+            add(`   ${line}`);
+          }
+          lines.push("");
+          const editHint = isZh
+            ? " Enter 保存 • Esc 返回多选"
+            : " Enter to save • Esc to return";
+          add(theme.fg("dim", editHint));
+          add(theme.fg("accent", "─".repeat(width)));
+          cachedLines = lines;
+          cachedWidth = width;
+          return lines;
+        }
+
+        addWrapped(lines, question, width, " ", " ", (l) => theme.fg("text", theme.bold(l)));
+        if (context) {
+          addWrapped(lines, context, width, " ", " ", (l) => theme.fg("muted", l));
+        }
+        lines.push("");
+
+        for (let i = 0; i < allItems.length; i++) {
+          const item = allItems[i];
+          const isFocused = i === optionIndex;
+          const prefix = isFocused ? theme.fg("accent", " > ") : "   ";
+
+          if (item.isSubmit) {
+            const hasSelected = selected.size > 0;
+            const countText = isZh
+              ? `(已选 ${selected.size} 项)`
+              : `(${selected.size} selected)`;
+            const label = hasSelected
+              ? `✓ ${item.label} ${countText}`
+              : `○ ${item.label}`;
+            const styled = isFocused
+              ? theme.bold(theme.fg("accent", label))
+              : theme.fg(hasSelected ? "success" : "dim", label);
+            lines.push(truncateToWidth(`${prefix}${styled}`, width));
+            continue;
+          }
+
+          if (item.isOther) {
+            const other = selected.get("other");
+            const marker = other ? "[x]" : "[ ]";
+            const suffix = other ? ` — ${other.label}` : "";
+            const label = `${marker} ${item.label}${suffix}`;
+            const styled = isFocused
+              ? theme.bold(theme.fg("accent", label))
+              : theme.fg(other ? "success" : "text", label);
+            lines.push(truncateToWidth(`${prefix}${styled}`, width));
+            continue;
+          }
+
+          const checked = selected.has(item.id);
+          const marker = checked ? "[x] " : "[ ] ";
+          const numPrefix = `${item.index}. `;
+          const firstIndent = `${prefix}${checked ? theme.fg("success", marker) : marker}${numPrefix}`;
+          const restIndent = " ".repeat(visibleWidth(firstIndent));
+          const styleLabel = (l: string) => {
+            if (isFocused) return theme.bold(theme.fg("accent", l));
+            if (checked) return theme.fg("success", l);
+            return theme.fg("text", l);
+          };
+
+          addWrapped(lines, item.label, width, firstIndent, restIndent, styleLabel);
+
+          if (item.description) {
+            const descIndent = " ".repeat(visibleWidth(firstIndent));
+            const descStyle = (l: string) => theme.fg("muted", l);
+            addWrapped(lines, item.description, width, descIndent, descIndent, descStyle);
+          }
+        }
+
+        lines.push("");
+        if (selected.size === 0) {
+          const warnText = isZh
+            ? " 请至少选择一项回答后再提交。"
+            : " Please select at least one option before submitting.";
+          add(theme.fg("warning", warnText));
+        }
+        const navHint = isZh
+          ? " ↑↓ 切换 • 空格 勾选 • Enter 编辑/提交 • Esc 取消"
+          : " ↑↓ to navigate • Space to select • Enter to edit/submit • Esc to cancel";
+        add(theme.fg("dim", navHint));
+        add(theme.fg("accent", "─".repeat(width)));
+
+        cachedLines = lines;
+        cachedWidth = width;
+        return lines;
+      }
+
+      return {
+        render,
+        invalidate: () => {
+          cachedLines = undefined;
+        },
+        handleInput,
+        get focused(): boolean {
+          return componentFocused;
+        },
+        set focused(value: boolean) {
+          componentFocused = value;
+          editor.focused = editMode && componentFocused;
+        },
+      };
+    },
+  );
+}
+

package/extensions/ask-u-questions/results.ts

@@ -0,0 +1,83 @@
+import type { AskAnswer, AskUserQuestionMode, AskUserQuestionResultDetails, AskUserQuestionStatus } from "./types.ts";
+import { isChineseContext } from "./answers.ts";
+
+function formatAnswerForModel(answer: AskAnswer): string {
+  switch (answer.type) {
+    case "text":
+      return answer.label;
+    case "other":
+      return `Other: ${answer.label}`;
+    case "option":
+      return `${answer.index}. ${answer.label}`;
+  }
+}
+
+function buildStructuredResult(
+  status: AskUserQuestionStatus,
+  question: string,
+  mode: AskUserQuestionMode,
+  answers: AskAnswer[],
+  context?: string,
+  message?: string,
+): AskUserQuestionResultDetails {
+  return {
+    status,
+    question,
+    context,
+    mode,
+    answers,
+    message,
+  };
+}
+
+export function cancelledResult(question: string, mode: AskUserQuestionMode, context?: string) {
+  const isZh = isChineseContext(question, undefined, context);
+  const message = isZh ? "用户取消了本次提问" : "User cancelled the question.";
+  return {
+    content: [{ type: "text" as const, text: message }],
+    details: buildStructuredResult("cancelled", question, mode, [], context, message),
+  };
+}
+
+export function unavailableResult(question: string, mode: AskUserQuestionMode, message: string, context?: string) {
+  return {
+    content: [{ type: "text" as const, text: message }],
+    details: buildStructuredResult("unavailable", question, mode, [], context, message),
+  };
+}
+
+export function buildResult(
+  question: string,
+  context: string | undefined,
+  mode: AskUserQuestionMode,
+  answers: AskAnswer[],
+) {
+  const isZh = isChineseContext(question, answers, context);
+  let text: string;
+  if (mode === "text") {
+    const answer = answers[0];
+    if (isZh) {
+      text = answer.label.trim().length > 0
+        ? `用户输入回答: ${answer.label}`
+        : "用户提交了空回答";
+    } else {
+      text = answer.label.trim().length > 0
+        ? `User answered: ${answer.label}`
+        : "User submitted an empty answer";
+    }
+  } else if (mode === "single-select") {
+    text = isZh
+      ? `用户选择项: ${formatAnswerForModel(answers[0])}`
+      : `User selected: ${formatAnswerForModel(answers[0])}`;
+  } else {
+    text = isZh
+      ? `用户选择多项:\n${answers.map((answer) => `- ${formatAnswerForModel(answer)}`).join("\n")}`
+      : `User selected multiple:\n${answers.map((answer) => `- ${formatAnswerForModel(answer)}`).join("\n")}`;
+  }
+
+  return {
+    content: [{ type: "text" as const, text }],
+    details: buildStructuredResult("answered", question, mode, answers, context),
+  };
+}
+