sema-core 1.0.2

package/dist/services/skill/skillParser.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Skill 解析器
+ *
+ * 负责解析 SKILL.md 文件，提取 YAML frontmatter 和 Markdown 内容
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSkillFile = parseSkillFile;
+const fs_1 = require("fs");
+const gray_matter_1 = __importDefault(require("gray-matter"));
+/**
+ * 解析 SKILL.md 文件
+ * @param filePath SKILL.md 的绝对路径
+ * @param baseDir Skill 目录的绝对路径
+ * @param locate Skill 来源：'user' 或 'project'
+ * @returns 解析后的 Skill 对象
+ */
+function parseSkillFile(filePath, baseDir, locate) {
+    const fileContent = (0, fs_1.readFileSync)(filePath, 'utf-8');
+    // 使用 gray-matter 解析 YAML frontmatter
+    const { data, content } = (0, gray_matter_1.default)(fileContent);
+    // 验证必需字段
+    if (!data.name || !data.description) {
+        throw new Error(`Invalid SKILL.md: missing 'name' or 'description' in ${filePath}`);
+    }
+    // 解析 allowed-tools
+    const allowedTools = parseAllowedTools(data['allowed-tools']);
+    const metadata = {
+        name: String(data.name).trim(),
+        description: String(data.description).trim(),
+        'allowed-tools': allowedTools,
+        'when-to-use': data['when-to-use'] ? String(data['when-to-use']).trim() : undefined,
+        model: data.model,
+        'max-thinking-tokens': data['max-thinking-tokens'] ? Number(data['max-thinking-tokens']) : undefined,
+        'disable-model-invocation': Boolean(data['disable-model-invocation']),
+        'argument-hint': data['argument-hint'] ? String(data['argument-hint']).trim() : undefined,
+        version: data.version ? String(data.version).trim() : undefined,
+    };
+    return {
+        metadata,
+        content: content.trim(),
+        filePath,
+        baseDir,
+        locate,
+    };
+}
+/**
+ * 解析 allowed-tools 字段
+ * 支持数组和空格分隔的字符串
+ */
+function parseAllowedTools(value) {
+    if (Array.isArray(value)) {
+        return value.map(v => String(v).trim()).filter(Boolean);
+    }
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (!trimmed)
+            return [];
+        return trimmed.split(/\s+/).map(v => v.trim()).filter(Boolean);
+    }
+    return [];
+}
+//# sourceMappingURL=skillParser.js.map

package/dist/services/skill/skillParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillParser.js","sourceRoot":"","sources":["../../../src/services/skill/skillParser.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;AAaH,wCAiCC;AA5CD,2BAAiC;AACjC,8DAAgC;AAGhC;;;;;;GAMG;AACH,SAAgB,cAAc,CAAC,QAAgB,EAAE,OAAe,EAAE,MAA0B;IAC1F,MAAM,WAAW,GAAG,IAAA,iBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAEnD,qCAAqC;IACrC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAA,qBAAM,EAAC,WAAW,CAAC,CAAA;IAE7C,SAAS;IACT,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,wDAAwD,QAAQ,EAAE,CAAC,CAAA;IACrF,CAAC;IAED,mBAAmB;IACnB,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAA;IAE7D,MAAM,QAAQ,GAAkB;QAC9B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;QAC9B,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE;QAC5C,eAAe,EAAE,YAAY;QAC7B,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;QACnF,KAAK,EAAE,IAAI,CAAC,KAAY;QACxB,qBAAqB,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QACpG,0BAA0B,EAAE,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACrE,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;QACzF,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;KAChE,CAAA;IAED,OAAO;QACL,QAAQ;QACR,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;QACvB,QAAQ;QACR,OAAO;QACP,MAAM;KACP,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACzD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;QAC5B,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAA;QACvB,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAChE,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC"}

package/dist/services/skill/skillRegistry.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Skill 注册表
+ *
+ * 管理 Skill 的全局注册和查找
+ * 实现优先级：项目级 > 全局级
+ */
+import { Skill, SkillRegistry, SkillInfo } from '../../types/skill';
+/**
+ * 初始化 Skill 注册表
+ * 优先级：项目级 > 全局级
+ * 如果有重名 Skill，项目级会覆盖全局级
+ */
+export declare function initializeSkillRegistry(workingDir: string): SkillRegistry;
+/**
+ * 获取 Skill 注册表
+ */
+export declare function getSkillRegistry(): SkillRegistry;
+/**
+ * 根据名称查找 Skill
+ */
+export declare function findSkill(name: string): Skill | undefined;
+/**
+ * 获取所有 Skills 的结构化信息
+ */
+export declare function getSkillsInfo(): SkillInfo[];
+/**
+ * 获取所有 Skills 的简要信息（用于系统提示）
+ */
+export declare function getSkillsSummary(): string;
+/**
+ * 清除注册表缓存（用于测试）
+ */
+export declare function clearSkillRegistry(): void;
+//# sourceMappingURL=skillRegistry.d.ts.map

package/dist/services/skill/skillRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillRegistry.d.ts","sourceRoot":"","sources":["../../../src/services/skill/skillRegistry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AASnE;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAkBzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAGzD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,SAAS,EAAE,CAa3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAmBzC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC"}

package/dist/services/skill/skillRegistry.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Skill 注册表
+ *
+ * 管理 Skill 的全局注册和查找
+ * 实现优先级：项目级 > 全局级
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeSkillRegistry = initializeSkillRegistry;
+exports.getSkillRegistry = getSkillRegistry;
+exports.findSkill = findSkill;
+exports.getSkillsInfo = getSkillsInfo;
+exports.getSkillsSummary = getSkillsSummary;
+exports.clearSkillRegistry = clearSkillRegistry;
+const skillLoader_1 = require("./skillLoader");
+const log_1 = require("../../util/log");
+/**
+ * 全局 Skill 注册表
+ */
+let globalRegistry = null;
+/**
+ * 初始化 Skill 注册表
+ * 优先级：项目级 > 全局级
+ * 如果有重名 Skill，项目级会覆盖全局级
+ */
+function initializeSkillRegistry(workingDir) {
+    const registry = new Map();
+    const skills = (0, skillLoader_1.loadAllSkills)(workingDir);
+    for (const skill of skills) {
+        const name = skill.metadata.name;
+        // 检查重复（后加载的会覆盖先加载的，由于 loadAllSkills 按项目->全局顺序加载，项目级会优先）
+        if (registry.has(name)) {
+            const existingSkill = registry.get(name);
+            (0, log_1.logWarn)(`Duplicate skill name detected: ${name}. Using ${skill.filePath} (override ${existingSkill.filePath})`);
+        }
+        registry.set(name, skill);
+    }
+    globalRegistry = registry;
+    return registry;
+}
+/**
+ * 获取 Skill 注册表
+ */
+function getSkillRegistry() {
+    if (!globalRegistry) {
+        throw new Error('Skill registry not initialized. Call initializeSkillRegistry() first.');
+    }
+    return globalRegistry;
+}
+/**
+ * 根据名称查找 Skill
+ */
+function findSkill(name) {
+    const registry = getSkillRegistry();
+    return registry.get(name);
+}
+/**
+ * 获取所有 Skills 的结构化信息
+ */
+function getSkillsInfo() {
+    const registry = getSkillRegistry();
+    const skillsInfo = [];
+    for (const [name, skill] of registry.entries()) {
+        skillsInfo.push({
+            name,
+            description: skill.metadata.description,
+            locate: skill.locate
+        });
+    }
+    return skillsInfo;
+}
+/**
+ * 获取所有 Skills 的简要信息（用于系统提示）
+ */
+function getSkillsSummary() {
+    const registry = getSkillRegistry();
+    if (registry.size === 0) {
+        return '';
+    }
+    const lines = ['', 'Available Skills:'];
+    for (const [name, skill] of registry.entries()) {
+        const whenToUse = skill.metadata['when-to-use'];
+        const desc = whenToUse ? `${skill.metadata.description} (${whenToUse})` : skill.metadata.description;
+        lines.push(`- ${name}: ${desc}`);
+    }
+    lines.push('');
+    lines.push('When a task requires specific domain knowledge or workflow, use the Skill tool to activate the relevant skill.');
+    return lines.join('\n');
+}
+/**
+ * 清除注册表缓存（用于测试）
+ */
+function clearSkillRegistry() {
+    globalRegistry = null;
+    // 清除 loadAllSkills 的缓存
+    skillLoader_1.loadAllSkills.cache.clear?.();
+}
+//# sourceMappingURL=skillRegistry.js.map

package/dist/services/skill/skillRegistry.js.map

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

package/dist/tools/AskUserQuestion/AskUserQuestion.d.ts

@@ -0,0 +1,179 @@
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    questions: z.ZodArray<z.ZodObject<{
+        question: z.ZodString;
+        header: z.ZodString;
+        options: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            description: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            description: string;
+            label: string;
+        }, {
+            description: string;
+            label: string;
+        }>, "many">;
+        multiSelect: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        options: {
+            description: string;
+            label: string;
+        }[];
+        question: string;
+        header: string;
+        multiSelect: boolean;
+    }, {
+        options: {
+            description: string;
+            label: string;
+        }[];
+        question: string;
+        header: string;
+        multiSelect?: boolean | undefined;
+    }>, "many">;
+    answers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        source: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        source?: string | undefined;
+    }, {
+        source?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    questions: {
+        options: {
+            description: string;
+            label: string;
+        }[];
+        question: string;
+        header: string;
+        multiSelect: boolean;
+    }[];
+    metadata?: {
+        source?: string | undefined;
+    } | undefined;
+    answers?: Record<string, string> | undefined;
+}, {
+    questions: {
+        options: {
+            description: string;
+            label: string;
+        }[];
+        question: string;
+        header: string;
+        multiSelect?: boolean | undefined;
+    }[];
+    metadata?: {
+        source?: string | undefined;
+    } | undefined;
+    answers?: Record<string, string> | undefined;
+}>;
+interface AskUserQuestionOutput {
+    questions: Array<{
+        question: string;
+        header: string;
+        options: Array<{
+            label: string;
+            description: string;
+        }>;
+        multiSelect: boolean;
+    }>;
+    answers?: Record<string, string>;
+    metadata?: {
+        source?: string;
+    };
+}
+export declare const AskUserQuestionTool: {
+    name: string;
+    description(): string;
+    inputSchema: z.ZodObject<{
+        questions: z.ZodArray<z.ZodObject<{
+            question: z.ZodString;
+            header: z.ZodString;
+            options: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                description: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                description: string;
+                label: string;
+            }, {
+                description: string;
+                label: string;
+            }>, "many">;
+            multiSelect: z.ZodDefault<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            options: {
+                description: string;
+                label: string;
+            }[];
+            question: string;
+            header: string;
+            multiSelect: boolean;
+        }, {
+            options: {
+                description: string;
+                label: string;
+            }[];
+            question: string;
+            header: string;
+            multiSelect?: boolean | undefined;
+        }>, "many">;
+        answers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        metadata: z.ZodOptional<z.ZodObject<{
+            source: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            source?: string | undefined;
+        }, {
+            source?: string | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        questions: {
+            options: {
+                description: string;
+                label: string;
+            }[];
+            question: string;
+            header: string;
+            multiSelect: boolean;
+        }[];
+        metadata?: {
+            source?: string | undefined;
+        } | undefined;
+        answers?: Record<string, string> | undefined;
+    }, {
+        questions: {
+            options: {
+                description: string;
+                label: string;
+            }[];
+            question: string;
+            header: string;
+            multiSelect?: boolean | undefined;
+        }[];
+        metadata?: {
+            source?: string | undefined;
+        } | undefined;
+        answers?: Record<string, string> | undefined;
+    }>;
+    isReadOnly(): true;
+    genToolResultMessage(output: AskUserQuestionOutput): {
+        title: string;
+        summary: string;
+        content: string;
+    };
+    validateInput({ questions }: z.infer<typeof inputSchema>, agentContext: any): Promise<{
+        result: false;
+        message: string;
+    } | {
+        result: true;
+        message?: undefined;
+    }>;
+    call(input: z.infer<typeof inputSchema>, agentContext: any): AsyncGenerator<{
+        type: "result";
+        data: AskUserQuestionOutput;
+        resultForAssistant: string;
+    }, void, unknown>;
+    genResultForAssistant(output: AskUserQuestionOutput): string;
+};
+export {};
+//# sourceMappingURL=AskUserQuestion.d.ts.map

package/dist/tools/AskUserQuestion/AskUserQuestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AskUserQuestion.d.ts","sourceRoot":"","sources":["../../../src/tools/AskUserQuestion/AskUserQuestion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA6DvB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaf,CAAA;AAGF,UAAU,qBAAqB;IAC7B,SAAS,EAAE,KAAK,CAAC;QACf,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,EAAE,KAAK,CAAC;YACb,KAAK,EAAE,MAAM,CAAA;YACb,WAAW,EAAE,MAAM,CAAA;SACpB,CAAC,CAAA;QACF,WAAW,EAAE,OAAO,CAAA;KACrB,CAAC,CAAA;IACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCASD,qBAAqB;;;;;iCA0BjC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,gBAC5B,GAAG;;;;;;;gBAcA,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,gBAAgB,GAAG;;;;;kCA+DnC,qBAAqB;CAeM,CAAA"}

package/dist/tools/AskUserQuestion/AskUserQuestion.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AskUserQuestionTool = void 0;
+const zod_1 = require("zod");
+const prompt_1 = require("./prompt");
+const EventSystem_1 = require("../../events/EventSystem");
+const errors_1 = require("../../types/errors");
+// 选项 schema
+const optionSchema = zod_1.z.strictObject({
+    label: zod_1.z
+        .string()
+        .describe('The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.'),
+    description: zod_1.z
+        .string()
+        .describe('Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.'),
+});
+// 问题 schema
+const questionSchema = zod_1.z.strictObject({
+    question: zod_1.z
+        .string()
+        .describe('The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: "Which library should we use for date formatting?" If multiSelect is true, phrase it accordingly, e.g. "Which features do you want to enable?"'),
+    header: zod_1.z
+        .string()
+        .describe('Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".'),
+    options: zod_1.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: zod_1.z
+        .boolean()
+        .default(false)
+        .describe('Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.'),
+});
+// 元数据 schema
+const metadataSchema = zod_1.z
+    .strictObject({
+    source: zod_1.z
+        .string()
+        .optional()
+        .describe('Optional identifier for the source of this question (e.g., "remember" for /remember command). Used for analytics tracking.'),
+})
+    .optional();
+// 输入 schema
+const inputSchema = zod_1.z.strictObject({
+    questions: zod_1.z
+        .array(questionSchema)
+        .min(1)
+        .max(4)
+        .describe('Questions to ask the user (1-4 questions)'),
+    answers: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.string())
+        .optional()
+        .describe('User answers collected by the permission component'),
+    metadata: metadataSchema.describe('Optional metadata for tracking and analytics purposes. Not displayed to user.'),
+});
+exports.AskUserQuestionTool = {
+    name: prompt_1.TOOL_NAME_FOR_PROMPT,
+    description() {
+        return prompt_1.DESCRIPTION;
+    },
+    inputSchema,
+    isReadOnly() {
+        return true;
+    },
+    genToolResultMessage(output) {
+        const { questions, answers } = output;
+        const questionCount = questions.length;
+        const questionText = questionCount === 1 ? 'question' : 'questions';
+        // 如果有答案，显示答案摘要
+        if (answers && Object.keys(answers).length > 0) {
+            const answeredCount = Object.keys(answers).length;
+            const answeredText = answeredCount === 1 ? 'answer' : 'answers';
+            return {
+                title: 'User Response',
+                summary: ``,
+                content: Object.entries(answers)
+                    .map(([q, a]) => `· ${q}: → ${a}`)
+                    .join('\n'),
+            };
+        }
+        // 没有答案时，显示问题摘要
+        return {
+            title: 'Asking User',
+            summary: `Asked ${questionCount} ${questionText}`,
+            content: questions.map((q) => q.question).join('\n'),
+        };
+    },
+    async validateInput({ questions }, agentContext) {
+        // 验证 header 长度（schema 中未定义此约束）
+        for (const question of questions) {
+            if (question.header.length > 12) {
+                return {
+                    result: false,
+                    message: `Header "${question.header}" exceeds maximum length of 12 characters.`,
+                };
+            }
+        }
+        return { result: true };
+    },
+    async *call(input, agentContext) {
+        const { questions, metadata } = input;
+        const eventBus = (0, EventSystem_1.getEventBus)();
+        const abortController = agentContext.abortController;
+        // 发送问答请求事件
+        const requestData = {
+            agentId: agentContext.agentId,
+            questions: questions.map((q) => ({
+                question: q.question,
+                header: q.header,
+                options: q.options.map((o) => ({
+                    label: o.label,
+                    description: o.description,
+                })),
+                multiSelect: q.multiSelect,
+            })),
+            metadata,
+        };
+        eventBus.emit('ask:question:request', requestData);
+        // 等待用户响应
+        const answers = await new Promise((resolve, reject) => {
+            const handleResponse = (response) => {
+                if (response.agentId !== agentContext.agentId)
+                    return;
+                eventBus.off('ask:question:response', handleResponse);
+                resolve(response.answers);
+            };
+            // 监听中断
+            const handleAbort = () => {
+                eventBus.off('ask:question:response', handleResponse);
+                reject(new Error('User cancelled the question'));
+            };
+            if (abortController?.signal) {
+                abortController.signal.addEventListener('abort', handleAbort, {
+                    once: true,
+                });
+            }
+            eventBus.on('ask:question:response', handleResponse);
+        });
+        // 检查是否被中断
+        (0, errors_1.checkAbortSignal)(abortController);
+        const data = {
+            questions,
+            answers,
+            metadata,
+        };
+        yield {
+            type: 'result',
+            data,
+            resultForAssistant: this.genResultForAssistant(data),
+        };
+    },
+    genResultForAssistant(output) {
+        const { questions, answers } = output;
+        // 如果有用户答案，返回答案信息
+        if (answers && Object.keys(answers).length > 0) {
+            const answerParts = Object.entries(answers).map(([question, answer]) => `"${question}"="${answer}"`);
+            return `User has answered your questions: ${answerParts.join(', ')}. You can now continue with the user's answers in mind.`;
+        }
+        // 没有答案时，返回等待用户响应的信息
+        const questionList = questions.map((q) => `- ${q.question}`).join('\n');
+        return `Waiting for user to answer the following questions:\n${questionList}`;
+    },
+};
+//# sourceMappingURL=AskUserQuestion.js.map

package/dist/tools/AskUserQuestion/AskUserQuestion.js.map

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

package/dist/tools/AskUserQuestion/prompt.d.ts

@@ -0,0 +1,3 @@
+export declare const TOOL_NAME_FOR_PROMPT = "AskUserQuestion";
+export declare const DESCRIPTION = "Use this tool when you need to ask the user questions during execution. This allows you to:\n1. Gather user preferences or requirements\n2. Clarify ambiguous instructions\n3. Get decisions on implementation choices as you work\n4. Offer choices to the user about what direction to take.\n\nUsage notes:\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- If you recommend a specific option, make that the first option in the list and add \"(Recommended)\" at the end of the label\n\nPlan mode note: In plan mode, use this tool to clarify requirements or choose between approaches BEFORE finalizing your plan. Do NOT use this tool to ask \"Is my plan ready?\" or \"Should I proceed?\" - use ExitPlanMode for plan approval.";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/tools/AskUserQuestion/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/tools/AskUserQuestion/prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,oBAAoB,CAAA;AAErD,eAAO,MAAM,WAAW,o0BAWmN,CAAA"}

package/dist/tools/AskUserQuestion/prompt.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DESCRIPTION = exports.TOOL_NAME_FOR_PROMPT = void 0;
+exports.TOOL_NAME_FOR_PROMPT = 'AskUserQuestion';
+exports.DESCRIPTION = `Use this tool when you need to ask the user questions during execution. This allows you to:
+1. Gather user preferences or requirements
+2. Clarify ambiguous instructions
+3. Get decisions on implementation choices as you work
+4. Offer choices to the user about what direction to take.
+
+Usage notes:
+- Users will always be able to select "Other" to provide custom text input
+- Use multiSelect: true to allow multiple answers to be selected for a question
+- If you recommend a specific option, make that the first option in the list and add "(Recommended)" at the end of the label
+
+Plan mode note: In plan mode, use this tool to clarify requirements or choose between approaches BEFORE finalizing your plan. Do NOT use this tool to ask "Is my plan ready?" or "Should I proceed?" - use ExitPlanMode for plan approval.`;
+//# sourceMappingURL=prompt.js.map

package/dist/tools/AskUserQuestion/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/tools/AskUserQuestion/prompt.ts"],"names":[],"mappings":";;;AAAa,QAAA,oBAAoB,GAAG,iBAAiB,CAAA;AAExC,QAAA,WAAW,GAAG;;;;;;;;;;;2OAWgN,CAAA"}