aws-runtime-bridge 1.9.33 → 1.9.41

package/package/acode/dist/ask-user-question-tool.js

@@ -0,0 +1,233 @@
+/** 工具名常量，供 runtime/adapter 引用 */
+export const ASK_USER_QUESTION_TOOL_NAME = "ask_user_question";
+const TOOL_DESCRIPTION = [
+    "向用户提出结构化问题以收集偏好、澄清需求、做决策或提供方向选择。",
+    "每次最多 4 个问题，每个问题 2-4 个选项；UI 会自动追加“其它”选项供用户自定义输入。",
+    "工具调用会阻塞当前轮次直到用户回答；用户回答后答案会作为 tool result 回传给你。",
+    "请勿用此工具请求计划审批——那是 plan 工具的职责。",
+    "如果推荐某个选项，把它放在第一位并在 label 末尾加“（推荐）”。",
+].join("\n");
+/**
+ * 创建 ask_user_question 内置工具。
+ * 由 ACodeRuntime.start() 调用并注入 deps。
+ */
+export function createAskUserQuestionTool(deps, contextVersionProvider) {
+    return {
+        kind: "builtin",
+        toolName: ASK_USER_QUESTION_TOOL_NAME,
+        exposedName: ASK_USER_QUESTION_TOOL_NAME,
+        description: TOOL_DESCRIPTION,
+        inputSchema: buildInputSchema(),
+        async execute(args, context) {
+            const toolCallId = context?.toolCallId;
+            if (!toolCallId) {
+                return {
+                    ok: false,
+                    tool: ASK_USER_QUESTION_TOOL_NAME,
+                    error: "missing toolCallId in execution context",
+                };
+            }
+            const questions = normalizeQuestions(args.questions);
+            if (questions.length === 0) {
+                return {
+                    ok: false,
+                    tool: ASK_USER_QUESTION_TOOL_NAME,
+                    error: "questions must be a non-empty array (1-4 items)",
+                };
+            }
+            // 通知 runtime 发出 question_request 事件
+            deps.onQuestion(toolCallId, questions);
+            // 阻塞等待用户回答；abort/stop/supersede 时会 reject
+            const contextVersion = contextVersionProvider();
+            let answers;
+            try {
+                answers = await deps.waitForAnswer(toolCallId, contextVersion);
+            }
+            catch (error) {
+                const reason = error instanceof Error ? error.message : String(error);
+                return {
+                    ok: false,
+                    tool: ASK_USER_QUESTION_TOOL_NAME,
+                    error: reason,
+                };
+            }
+            const summary = formatAnswerSummary(questions, answers);
+            const result = {
+                ok: true,
+                tool: ASK_USER_QUESTION_TOOL_NAME,
+                answers,
+                summary,
+            };
+            return result;
+        },
+    };
+}
+function buildInputSchema() {
+    return {
+        type: "object",
+        properties: {
+            questions: {
+                type: "array",
+                description: "要提问的问题列表（1-4 个）",
+                minItems: 1,
+                maxItems: 4,
+                items: {
+                    type: "object",
+                    properties: {
+                        question: {
+                            type: "string",
+                            description: "完整问题文本，建议以问号结尾",
+                        },
+                        header: {
+                            type: "string",
+                            description: "≤12 字符的简短标签，用于 UI chip 显示",
+                        },
+                        options: {
+                            type: "array",
+                            description: "2-4 个互斥选项（multiSelect=true 时可不互斥）",
+                            minItems: 2,
+                            maxItems: 4,
+                            items: {
+                                type: "object",
+                                properties: {
+                                    label: {
+                                        type: "string",
+                                        description: "1-5 词的简短标签",
+                                    },
+                                    description: {
+                                        type: "string",
+                                        description: "选项含义或权衡说明",
+                                    },
+                                    requiresCustomInput: {
+                                        type: "boolean",
+                                        description: "选中此项时 UI 显示自定义输入框",
+                                    },
+                                },
+                                required: ["label"],
+                            },
+                        },
+                        multiple: {
+                            type: "boolean",
+                            description: "是否允许多选；默认 false",
+                        },
+                    },
+                    required: ["question", "options"],
+                },
+            },
+            custom: {
+                type: "boolean",
+                description: "是否允许用户补充自定义输入；默认 true",
+            },
+        },
+        required: ["questions"],
+    };
+}
+function normalizeQuestions(raw) {
+    if (!Array.isArray(raw) || raw.length === 0) {
+        return [];
+    }
+    const items = [];
+    for (const entry of raw) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        const obj = entry;
+        const question = typeof obj.question === "string" ? obj.question.trim() : "";
+        if (!question)
+            continue;
+        const options = normalizeOptions(obj.options);
+        if (options.length < 2)
+            continue;
+        const header = typeof obj.header === "string" && obj.header.trim()
+            ? obj.header.trim()
+            : undefined;
+        const multiple = obj.multiple === true || obj.multiSelect === true;
+        items.push({ question, header, options, multiple });
+        if (items.length >= 4)
+            break;
+    }
+    return items;
+}
+function normalizeOptions(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const options = [];
+    for (const entry of raw) {
+        if (typeof entry === "string") {
+            const label = entry.trim();
+            if (label)
+                options.push({ label });
+            continue;
+        }
+        if (!entry || typeof entry !== "object")
+            continue;
+        const obj = entry;
+        const label = typeof obj.label === "string"
+            ? obj.label.trim()
+            : typeof obj.value === "string"
+                ? obj.value.trim()
+                : typeof obj.text === "string"
+                    ? obj.text.trim()
+                    : "";
+        if (!label)
+            continue;
+        const description = typeof obj.description === "string" && obj.description.trim()
+            ? obj.description.trim()
+            : undefined;
+        const requiresCustomInput = obj.requiresCustomInput === true ||
+            obj.requireCustomInput === true ||
+            obj.allowCustomInput === true;
+        options.push({
+            label,
+            ...(description ? { description } : {}),
+            ...(requiresCustomInput ? { requiresCustomInput } : {}),
+        });
+        if (options.length >= 4)
+            break;
+    }
+    return options;
+}
+/**
+ * 将答案格式化为可读摘要，确保即使 answers 序列化丢字段，
+ * LLM 也能从 summary 文本读到答案。
+ */
+function formatAnswerSummary(questions, answers) {
+    const lines = ["用户已回答了您的问题："];
+    questions.forEach((q, index) => {
+        const key = String(index);
+        const answer = answers[key] ||
+            (q.header ? answers[q.header] : "") ||
+            answers[q.question] ||
+            "（未填写）";
+        const prefix = q.header || q.question;
+        lines.push(`• ${prefix}：${answer}`);
+    });
+    return lines.join("\n");
+}
+/** 类型守卫：判断一个值是否为 ask_user_question 工具的成功结果 */
+export function isAskUserQuestionResult(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const obj = value;
+    return (obj.ok === true &&
+        obj.tool === ASK_USER_QUESTION_TOOL_NAME &&
+        typeof obj.answers === "object" &&
+        obj.answers !== null &&
+        typeof obj.summary === "string");
+}
+/** 将成功结果转为 JSON 字符串（供 toToolResultText 调用） */
+export function serializeAskUserQuestionResult(result) {
+    const json = {
+        ok: true,
+        tool: ASK_USER_QUESTION_TOOL_NAME,
+        answers: answersToJsonObject(result.answers),
+        summary: result.summary,
+    };
+    return JSON.stringify(json);
+}
+function answersToJsonObject(answers) {
+    const out = {};
+    for (const [key, value] of Object.entries(answers)) {
+        out[key] = value;
+    }
+    return out;
+}

package/package/acode/dist/built-in-file-tools.d.ts

@@ -15,6 +15,8 @@ export interface ACodeBuiltInTool {
 }
 export interface ACodeBuiltInToolExecutionContext {
     readonly onOutput?: CommandOutputSink;
+    /** 当前工具调用的 ID（toolCall.id），用于需要关联请求与响应的工具（如 ask_user_question） */
+    readonly toolCallId?: string;
 }
 export declare function createBuiltInFileTools(workingDirectory: string, agentId?: string): ACodeBuiltInTool[];
 //# sourceMappingURL=built-in-file-tools.d.ts.map

package/package/acode/dist/built-in-file-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"built-in-file-tools.d.ts","sourceRoot":"","sources":["../src/built-in-file-tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACjC,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,CACL,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,gCAAgC,GACzC,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAufD,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,gBAAgB,EAAE,CAQpB"}
+{"version":3,"file":"built-in-file-tools.d.ts","sourceRoot":"","sources":["../src/built-in-file-tools.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kCAAkC,CAAC;AAiC1C,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACjC,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,CACL,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,gCAAgC,GACzC,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAokCD,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,gBAAgB,EAAE,CASpB"}