kevlar-4u 1.0.0

package/dist/prompts/reviewDispatcherPrompt.js

@@ -0,0 +1,67 @@
+// ⚠️ 内部设计参考，不再通过 MCP Prompts 暴露。
+// review_content_wizard 工具在服务端内部已实现相同逻辑。
+export const REVIEW_DISPATCHER_PROMPT = `你是一个内容评论调度引擎，负责为用户提交的内容匹配合适的评论员，协调子代理执行评论任务，并在所有评论完成后生成结构化诊断报告交付给用户。
+
+**一、评论员匹配**
+
+角色库检查（优先执行）：
+- 若角色数量 = 0：停止匹配流程，提示用户：「当前还没有可用的评论员，请先创建至少一个角色，再提交内容进行评论。」（注意：在提示创建前，务必记录并暂存用户本次提交的文案内容，以便在角色创建完成后自动或手动唤醒并继续本次评论任务）
+- 若角色数量 = 1-2：跳过推荐步骤，直接展示全部可用角色，说明：「当前只有 N 位评论员可用，已为你展示全部角色，请确认是否使用。」
+- 若角色数量 ≥ 3：执行正常匹配推荐流程
+
+用户提交内容后，分析内容的类型、风格、平台特征，从已创建的角色库中自动匹配最合适的评论员组合。
+（读取指南：角色库文件为 Markdown 格式，以“键：值”或无标题平铺方式存储。请通过提取“兴趣方向”、“常用平台”、“性格特质”等字段进行交叉比对。）
+向用户展示推荐名单并请求确认：
+
+> 我为这篇内容推荐了以下评论员：
+> - [角色A]（推荐理由：[结构化理由]）
+> - [角色B]（推荐理由：[结构化理由]）
+>
+> 确认使用以上评论员，还是需要从完整列表中自选？
+
+推荐理由必须包含以下三项中的至少两项：
+① 内容类型匹配：该角色的兴趣方向与内容主题的关联
+② 平台匹配：该角色的常用平台与内容分发渠道一致
+③ 风格匹配：该角色的性格特质与内容风格的关联
+示例格式：「角色A（推荐理由：内容是数码类测评，该角色兴趣方向包含科技数码，且常用平台为小红书，与本次内容分发渠道一致）」
+
+用户确认后，所有选中的评论员并行开始执行评论任务。
+用户选择自选时，列出剩余评论员供用户勾选。自选列表展示格式（每个角色一行）：
+[角色名] · [常用平台] · [一句话描述]
+示例：
+- 挑剔的数码买家 · 小红书 · 习惯先看评论区，对没有真实使用感受的内容直接划走
+
+**二、子代理协调**
+
+评论员确认后，将以下信息传递给每个子代理：
+- 待评论的完整内容
+- 该评论员的完整角色描述（从角色库读取）
+- 执行指令：按 reviewPersonaPrompt 完成评论任务并返回诊断输出
+
+子代理执行过程全部在后台进行，执行细节不对用户展示。
+
+子代理执行异常处理：
+- 若某个子代理返回错误或超时未响应：标记该评论员状态为「执行失败」，不阻塞其他子代理的执行。汇总时在对应评论员位置输出：「[角色名] · 本次执行未能完成。错误原因：[透传子代理返回的具体报错信息]。」并提供修复建议引导用户。
+- 若所有子代理均失败：告知用户「本次评论全部未能完成」，提供每个子代理的具体报错原因并提示重试，不生成空报告。
+
+**三、报告汇总与交付**
+
+所有子代理返回诊断输出后，按评论员顺序平铺汇总，向用户完整展示。
+展示完毕后询问用户：
+
+> 评论已全部完成，是否需要将报告保存到桌面？
+
+用户选择保存：生成 Markdown 格式文件（保留原生的评分块形式），保存位置仅限桌面，不支持其他任何路径，其他路径请求一律拒绝。
+用户不保存：流程结束，不生成文件。
+
+文件命名格式（保存时使用）：
+\`kevlar_{内容前10个字（去除标点）}_{YYYYMMDD_HHMM}.md\`
+示例：\`kevlar_我做了一套适合内容创作_20250519_1430.md\`
+（若内容前10个字包含特殊字符或空格，统一替换为下划线。）
+
+**四、注意事项**
+
+1. 调度层只负责匹配、协调、汇总，不干预任何评论员的评论内容
+2. 每个评论员的评分和结论反映该角色的主观视角，不做跨评论员平均或汇总
+3. 保存路径只允许桌面，任何其他路径请求一律拒绝（注：此规则约束宿主 AI 的行为，Kevlar 服务端本身不具备写出最终报告文件的能力）`;
+//# sourceMappingURL=reviewDispatcherPrompt.js.map

package/dist/prompts/reviewDispatcherPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewDispatcherPrompt.js","sourceRoot":"","sources":["../../src/prompts/reviewDispatcherPrompt.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AACzC,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uEA+D+B,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createKevlarServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwDpE,wBAAgB,kBAAkB,IAAI,SAAS,CAsH9C"}

package/dist/server.js

@@ -0,0 +1,156 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import * as path from "path";
+import * as fs from "fs";
+import { fileURLToPath } from "url";
+import { createToolRegistry } from "./tools/index.js";
+import { logger } from "./utils/logger.js";
+import { formatErrorResponse } from "./utils/errors.js";
+import { getErrorInfo } from "./utils/observability.js";
+import { isSamplingSupported, setClientInfo } from "./execution/client.js";
+import { setConfigPath } from "./execution/config.js";
+// Priority:
+//   1. KEVLAR_SKILLS_DIR environment variable (absolute path)
+//   2. <repo-root>/skills/  (relative to this file's compiled location)
+function resolveSkillsDir() {
+    if (process.env.KEVLAR_SKILLS_DIR) {
+        return path.resolve(process.env.KEVLAR_SKILLS_DIR);
+    }
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    // dist/ after compilation; go up one level to repo root
+    const repoRoot = path.resolve(__dirname, "..");
+    return path.join(repoRoot, "skills");
+}
+async function cleanStaleDrafts(tmpDir) {
+    try {
+        if (!fs.existsSync(tmpDir))
+            return;
+        const files = await fs.promises.readdir(tmpDir);
+        const now = Date.now();
+        for (const file of files) {
+            if (!file.endsWith('_draft.json') && !file.endsWith('_wizard.json') && !file.endsWith('_review_wizard.json') && !file.endsWith('_configure_wizard.json') && !file.endsWith('_delete_wizard.json'))
+                continue;
+            const filePath = path.join(tmpDir, file);
+            try {
+                const data = await fs.promises.readFile(filePath, 'utf-8');
+                const state = JSON.parse(data);
+                if (state.createdAt && now - state.createdAt > 86400000) {
+                    await fs.promises.unlink(filePath);
+                    logger.info("Cleaned stale wizard state", { event: "clean_stale_wizard", file });
+                }
+            }
+            catch (err) {
+            }
+        }
+    }
+    catch (err) {
+        const info = getErrorInfo(err);
+        logger.warn("Failed to clean stale wizard states", { event: "clean_stale_wizards_error", error: info.code, message: info.message });
+    }
+}
+export function createKevlarServer() {
+    const skillsDir = resolveSkillsDir();
+    const tmpDir = path.join(skillsDir, "tmp");
+    setConfigPath(skillsDir);
+    if (!fs.existsSync(skillsDir)) {
+        fs.mkdirSync(skillsDir, { recursive: true });
+        logger.info("Created skills directory", { event: "dir_created", path: skillsDir });
+    }
+    else {
+        logger.info("Using skills directory", { event: "dir_using", path: skillsDir });
+    }
+    cleanStaleDrafts(tmpDir).catch(() => { });
+    const mcpServer = new McpServer({
+        name: "kevlar",
+        version: "1.0.0",
+    }, {
+        capabilities: {
+            tools: {},
+            prompts: {},
+        },
+    });
+    const underlyingServer = mcpServer.server;
+    const updateClientSamplingSupport = () => {
+        const clientVersion = underlyingServer.getClientVersion();
+        if (clientVersion) {
+            setClientInfo(clientVersion.name, clientVersion.version);
+            return isSamplingSupported(clientVersion.name);
+        }
+        return false;
+    };
+    const createMultiTurnSamplingFn = (serverInstance) => {
+        return async (params) => {
+            try {
+                const result = await serverInstance.createMessage({
+                    systemPrompt: params.systemPrompt,
+                    messages: params.messages.map(m => ({
+                        role: m.role,
+                        content: { type: "text", text: m.content }
+                    })),
+                    maxTokens: params.maxTokens || 4096,
+                });
+                const textContent = result.content.type === "text" ? result.content.text : "";
+                return {
+                    content: textContent,
+                    stopReason: result.stopReason,
+                };
+            }
+            catch (err) {
+                const info = getErrorInfo(err);
+                logger.error("Multi-turn Sampling request failed", {
+                    event: "multi_sampling_request_error",
+                    error: info.code,
+                    message: info.message,
+                    recoverable: info.recoverable,
+                });
+                throw new Error(`多轮 Sampling 调用失败: ${info.message}`);
+            }
+        };
+    };
+    const deps = {
+        skillsDir,
+        tmpDir,
+        createMultiTurnSamplingFn: () => createMultiTurnSamplingFn(underlyingServer),
+        updateClientSamplingSupport,
+    };
+    const { registry, toolDefinitions } = createToolRegistry(deps);
+    underlyingServer.setRequestHandler(ListToolsRequestSchema, async () => {
+        return { tools: toolDefinitions };
+    });
+    underlyingServer.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const startTime = Date.now();
+        logger.debug("Tool call received", { event: "tool_called", tool: name });
+        try {
+            const sanitizedArgs = args && typeof args === "object" ? args : undefined;
+            const handler = registry.get(name);
+            if (!handler) {
+                logger.warn("Unknown tool requested", { event: "unknown_tool", tool: name });
+                throw new Error(`Unknown tool: ${name}`);
+            }
+            const result = await handler(sanitizedArgs);
+            logger.info("Tool completed", {
+                event: "tool_completed",
+                tool: name,
+                durationMs: Date.now() - startTime,
+            });
+            return result;
+        }
+        catch (err) {
+            const durationMs = Date.now() - startTime;
+            const info = getErrorInfo(err);
+            logger.error("Tool execution failed", {
+                event: "tool_error",
+                tool: name,
+                error: info.code,
+                message: info.message,
+                recoverable: info.recoverable,
+                durationMs,
+            });
+            return formatErrorResponse(err);
+        }
+    });
+    return mcpServer;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/configureTool.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Configure Tool
+ *
+ * Write user preferences to kevlar-config.json.
+ * Does NOT handle API keys - those come from environment variables only.
+ */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { ToolResult } from "../utils/types.js";
+import type { ToolModule } from "./types.js";
+export declare const configureToolDefinition: Tool;
+export interface ConfigureInput {
+    mode?: "auto" | "orchestration" | "mcp_sampling" | "direct_api";
+    maxConcurrency?: number;
+}
+export declare const configureModule: ToolModule;
+export declare function handleConfigure(input: ConfigureInput): Promise<ToolResult>;
+//# sourceMappingURL=configureTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configureTool.d.ts","sourceRoot":"","sources":["../../src/tools/configureTool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAQ7C,eAAO,MAAM,uBAAuB,EAAE,IAuBrC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,cAAc,GAAG,YAAY,CAAC;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,eAAe,EAAE,UAM7B,CAAC;AAEF,wBAAsB,eAAe,CACpC,KAAK,EAAE,cAAc,GACnB,OAAO,CAAC,UAAU,CAAC,CA0ErB"}

package/dist/tools/configureTool.js

@@ -0,0 +1,104 @@
+/**
+ * Configure Tool
+ *
+ * Write user preferences to kevlar-config.json.
+ * Does NOT handle API keys - those come from environment variables only.
+ */
+import { updateConfig, isValidMode, isValidConcurrency, } from "../execution/config.js";
+import { logger, getErrorInfo } from "../utils/observability.js";
+export const configureToolDefinition = {
+    name: "configure",
+    description: "直接修改 Kevlar 运行配置（执行模式、并发数等），改动即时写入 kevlar-config.json。" +
+        "无需对话确认，适合明确的单次配置变更场景。" +
+        "如需先预览再写入，请使用 configure_wizard。",
+    inputSchema: {
+        type: "object",
+        properties: {
+            mode: {
+                type: "string",
+                enum: ["auto", "orchestration", "mcp_sampling", "direct_api"],
+                description: "执行模式。不传则不修改当前值。",
+            },
+            maxConcurrency: {
+                type: "number",
+                minimum: 1,
+                maximum: 10,
+                description: "最大并发数（仅 mcp_sampling / direct_api 模式生效）。不传则不修改。",
+            },
+        },
+    },
+};
+export const configureModule = {
+    definition: configureToolDefinition,
+    handler: () => async (args) => {
+        if (!args)
+            throw new Error("配置需要提供参数");
+        return await handleConfigure(args);
+    },
+};
+export async function handleConfigure(input) {
+    // Validate mode
+    if (input.mode !== undefined && !isValidMode(input.mode)) {
+        return {
+            content: [{ type: "text", text: `❌ 无效的执行模式：${input.mode}` }],
+            isError: true,
+        };
+    }
+    // Validate concurrency
+    if (input.maxConcurrency !== undefined &&
+        !isValidConcurrency(input.maxConcurrency)) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "❌ 并发数必须在 1-10 之间",
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        const updated = await updateConfig({
+            mode: input.mode,
+            maxConcurrency: input.maxConcurrency,
+        });
+        const changes = [];
+        if (input.mode !== undefined) {
+            const modeLabels = {
+                auto: "自动",
+                orchestration: "宿主辅助兜底模式",
+                mcp_sampling: "MCP 采样模式",
+                direct_api: "直接 API 模式",
+            };
+            changes.push(`执行模式：${modeLabels[input.mode]}`);
+        }
+        if (input.maxConcurrency !== undefined) {
+            changes.push(`并发数：${input.maxConcurrency}`);
+        }
+        const changesText = changes.length > 0 ? changes.join("、") : "（无变更）";
+        logger.info("Configuration updated via tool", {
+            event: "configure_tool",
+            mode: input.mode,
+            maxConcurrency: input.maxConcurrency,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `✅ 配置已更新
+- ${changesText}
+
+下次评测（review_content_wizard）时自动生效。`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const info = getErrorInfo(err);
+        return {
+            content: [{ type: "text", text: `❌ 配置更新失败：${info.message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=configureTool.js.map

package/dist/tools/configureTool.js.map

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

package/dist/tools/configureWizardTool.d.ts

@@ -0,0 +1,11 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { ToolResult } from "../utils/types.js";
+import type { ToolModule } from "./types.js";
+export declare const configureWizardToolDefinition: Tool;
+export interface ConfigureWizardInput {
+    sessionId?: string;
+    userMessage: string;
+}
+export declare const configureWizardModule: ToolModule;
+export declare function handleConfigureWizard(tmpDir: string, input: ConfigureWizardInput): Promise<ToolResult>;
+//# sourceMappingURL=configureWizardTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configureWizardTool.d.ts","sourceRoot":"","sources":["../../src/tools/configureWizardTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG1D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,eAAO,MAAM,6BAA6B,EAAE,IAoB3C,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACpB;AAaD,eAAO,MAAM,qBAAqB,EAAE,UAMnC,CAAC;AAEF,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,oBAAoB,GACzB,OAAO,CAAC,UAAU,CAAC,CAkDrB"}

package/dist/tools/configureWizardTool.js

@@ -0,0 +1,205 @@
+import * as path from "path";
+import * as fs from "fs";
+import { handleConfigure } from "./configureTool.js";
+import { isValidMode, isValidConcurrency } from "../execution/config.js";
+import { logger, getErrorInfo } from "../utils/observability.js";
+export const configureWizardToolDefinition = {
+    name: "configure_wizard",
+    description: "当用户说「设置/配置/切换模式/改并发数」时，调用此工具。工具先预览配置变更，用户确认后才写入 kevlar-config.json。API Key 不由此工具处理，只能通过环境变量设置。",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sessionId: {
+                type: "string",
+                description: "配置向导的会话标识。首次调用请留空，工具会自动生成并返回一个 sessionId。后续调用必须传入此值以继续上一次的配置会话。",
+            },
+            userMessage: {
+                type: "string",
+                description: "用户在当前步骤的回复内容。首次调用时传入用户原话（例如「切换到 MCP 采样模式」「并发数改成 5」），工具解析变更项并预览。后续步骤传入用户对工具提问的回复。",
+            },
+        },
+        required: ["userMessage"],
+    },
+};
+const CONFIRM_PHRASE = "确认修改配置";
+export const configureWizardModule = {
+    definition: configureWizardToolDefinition,
+    handler: (deps) => async (args) => {
+        if (!args)
+            throw new Error("配置向导需要提供参数");
+        return await handleConfigureWizard(deps.tmpDir, args);
+    },
+};
+export async function handleConfigureWizard(tmpDir, input) {
+    if (!input.userMessage || typeof input.userMessage !== "string") {
+        return {
+            content: [{ type: "text", text: "❌ 请提供当前步骤的用户回复。" }],
+            isError: true,
+        };
+    }
+    try {
+        await fs.promises.mkdir(tmpDir, { recursive: true });
+        const state = await loadOrCreateState(tmpDir, input);
+        if (!input.sessionId) {
+            const pending = parseConfigRequest(input.userMessage);
+            validatePending(pending);
+            state.pending = pending;
+            await saveState(tmpDir, state);
+            return toolResponse(state, buildPreviewMessage(pending));
+        }
+        if (state.step === "completed") {
+            return toolResponse(state, "这个配置修改流程已经完成。");
+        }
+        if (!normalize(input.userMessage).includes(normalize(CONFIRM_PHRASE))) {
+            await saveState(tmpDir, state);
+            return toolResponse(state, `请回复完整确认语「${CONFIRM_PHRASE}」后再写入配置。`);
+        }
+        const result = await handleConfigure(state.pending);
+        if (!result.isError) {
+            state.step = "completed";
+            await saveState(tmpDir, state);
+            await cleanupState(tmpDir, state.sessionId);
+        }
+        return result;
+    }
+    catch (err) {
+        const info = getErrorInfo(err);
+        logger.error("Configure wizard failed", {
+            event: "configure_wizard_error",
+            error: info.code,
+            message: info.message,
+        });
+        return {
+            content: [{ type: "text", text: `❌ 配置向导失败：${info.message}` }],
+            isError: true,
+        };
+    }
+}
+function parseConfigRequest(message) {
+    const normalized = message.toLowerCase();
+    const pending = {};
+    if (/direct[\s_-]*api|直接\s*api|直连/.test(normalized)) {
+        pending.mode = "direct_api";
+    }
+    else if (/mcp[\s_-]*sampling|sampling|采样/.test(normalized)) {
+        pending.mode = "mcp_sampling";
+    }
+    else if (/orchestration|编排|兜底|宿主辅助/.test(normalized)) {
+        pending.mode = "orchestration";
+    }
+    else if (/auto|自动/.test(normalized)) {
+        pending.mode = "auto";
+    }
+    const concurrencyMatch = normalized.match(/(?:并发|concurrency|maxconcurrency)\D*(10|[1-9])/);
+    if (concurrencyMatch) {
+        pending.maxConcurrency = Number(concurrencyMatch[1]);
+    }
+    if (!pending.mode && pending.maxConcurrency === undefined) {
+        throw new Error("没有识别到要修改的配置。请说明执行模式或并发数。");
+    }
+    return pending;
+}
+function validatePending(pending) {
+    if (pending.mode !== undefined && !isValidMode(pending.mode)) {
+        throw new Error(`无效的执行模式：${pending.mode}`);
+    }
+    if (pending.maxConcurrency !== undefined &&
+        !isValidConcurrency(pending.maxConcurrency)) {
+        throw new Error("并发数必须在 1-10 之间");
+    }
+}
+function buildPreviewMessage(pending) {
+    const lines = ["准备修改配置：", ""];
+    if (pending.mode) {
+        lines.push(`- 执行模式：${modeLabel(pending.mode)}`);
+    }
+    if (pending.maxConcurrency !== undefined) {
+        lines.push(`- 并发数：${pending.maxConcurrency}`);
+    }
+    lines.push("");
+    lines.push(`如确认写入配置，请回复：${CONFIRM_PHRASE}`);
+    return lines.join("\n");
+}
+async function loadOrCreateState(tmpDir, input) {
+    if (input.sessionId && !/^[a-z0-9-]+$/.test(input.sessionId)) {
+        throw new Error("sessionId 格式不合法。");
+    }
+    const sessionId = input.sessionId ||
+        `wizard-configure-${Math.random().toString(36).substring(2, 10)}`;
+    const statePath = getStatePath(tmpDir, sessionId);
+    if (input.sessionId && fs.existsSync(statePath)) {
+        const raw = await fs.promises.readFile(statePath, "utf-8");
+        return JSON.parse(raw);
+    }
+    return {
+        sessionId,
+        createdAt: Date.now(),
+        step: "confirmConfigure",
+        pending: {},
+    };
+}
+async function saveState(tmpDir, state) {
+    await fs.promises.mkdir(tmpDir, { recursive: true });
+    const statePath = getStatePath(tmpDir, state.sessionId);
+    const tmpPath = statePath + ".tmp";
+    await fs.promises.writeFile(tmpPath, JSON.stringify(state, null, 2), "utf-8");
+    await fs.promises.rename(tmpPath, statePath);
+}
+async function cleanupState(tmpDir, sessionId) {
+    const statePath = getStatePath(tmpDir, sessionId);
+    try {
+        if (fs.existsSync(statePath))
+            await fs.promises.unlink(statePath);
+    }
+    catch (err) {
+        const info = getErrorInfo(err);
+        logger.warn("Failed to clean configure wizard state", {
+            event: "configure_wizard_cleanup_error",
+            path: statePath,
+            error: info.code,
+            message: info.message,
+        });
+    }
+}
+function getStatePath(tmpDir, sessionId) {
+    return path.join(tmpDir, `${sessionId}_configure_wizard.json`);
+}
+function toolResponse(state, assistantMessage) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: [
+                    assistantMessage,
+                    "",
+                    "```kevlar-state",
+                    `sessionId: ${state.sessionId}`,
+                    "workflow: configure",
+                    `currentStep: ${state.step}`,
+                    state.pending.mode
+                        ? `pendingMode: ${state.pending.mode}`
+                        : undefined,
+                    state.pending.maxConcurrency !== undefined
+                        ? `pendingMaxConcurrency: ${state.pending.maxConcurrency}`
+                        : undefined,
+                    "```",
+                ]
+                    .filter(Boolean)
+                    .join("\n"),
+            },
+        ],
+    };
+}
+function modeLabel(mode) {
+    const labels = {
+        auto: "自动",
+        orchestration: "宿主辅助兜底模式",
+        mcp_sampling: "MCP 采样模式",
+        direct_api: "直接 API 模式",
+    };
+    return labels[mode];
+}
+function normalize(input) {
+    return input.replace(/\s+/g, "").toLowerCase();
+}
+//# sourceMappingURL=configureWizardTool.js.map

package/dist/tools/configureWizardTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configureWizardTool.js","sourceRoot":"","sources":["../../src/tools/configureWizardTool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAkB,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEzE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEjE,MAAM,CAAC,MAAM,6BAA6B,GAAS;IAClD,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACV,gGAAgG;IACjG,WAAW,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACX,SAAS,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EACV,iEAAiE;aAClE;YACD,WAAW,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACV,kFAAkF;aACnF;SACD;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KACzB;CACD,CAAC;AAgBF,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEhC,MAAM,CAAC,MAAM,qBAAqB,GAAe;IAChD,UAAU,EAAE,6BAA6B;IACzC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACjC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;QACzC,OAAO,MAAM,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAW,CAAC,CAAC;IAC9D,CAAC;CACD,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAC1C,MAAc,EACd,KAA2B;IAE3B,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACjE,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;YACpD,OAAO,EAAE,IAAI;SACb,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACtD,eAAe,CAAC,OAAO,CAAC,CAAC;YACzB,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;YACxB,MAAM,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC/B,OAAO,YAAY,CAAC,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAChC,OAAO,YAAY,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;YACvE,MAAM,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC/B,OAAO,YAAY,CAClB,KAAK,EACL,YAAY,cAAc,UAAU,CACpC,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC;YACzB,MAAM,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC/B,MAAM,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE;YACvC,KAAK,EAAE,wBAAwB;YAC/B,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,OAAO,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC,CAAC;QACH,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7D,OAAO,EAAE,IAAI;SACb,CAAC;IACH,CAAC;AACF,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAe;IAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACzC,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,IAAI,8BAA8B,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC;IAC7B,CAAC;SAAM,IAAI,gCAAgC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9D,OAAO,CAAC,IAAI,GAAG,cAAc,CAAC;IAC/B,CAAC;SAAM,IAAI,0BAA0B,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,OAAO,CAAC,IAAI,GAAG,eAAe,CAAC;IAChC,CAAC;SAAM,IAAI,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,gBAAgB,GAAG,UAAU,CAAC,KAAK,CACxC,gDAAgD,CAChD,CAAC;IACF,IAAI,gBAAgB,EAAE,CAAC;QACtB,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,OAAuB;IAC/C,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,IACC,OAAO,CAAC,cAAc,KAAK,SAAS;QACpC,CAAC,kBAAkB,CAAC,OAAO,CAAC,cAAc,CAAC,EAC1C,CAAC;QACF,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACnC,CAAC;AACF,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAuB;IACnD,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC9B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,UAAU,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,eAAe,cAAc,EAAE,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC/B,MAAc,EACd,KAA2B;IAE3B,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,SAAS,GACd,KAAK,CAAC,SAAS;QACf,oBAAoB,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACnE,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClD,IAAI,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;IAChD,CAAC;IAED,OAAO;QACN,SAAS;QACT,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,EAAE;KACX,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CACvB,MAAc,EACd,KAA2B;IAE3B,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACnC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAC1B,OAAO,EACP,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAC9B,OAAO,CACP,CAAC;IACF,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,SAAiB;IAC5D,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClD,IAAI,CAAC;QACJ,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE;YACrD,KAAK,EAAE,gCAAgC;YACvC,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,OAAO,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC,CAAC;IACJ,CAAC;AACF,CAAC;AAED,SAAS,YAAY,CAAC,MAAc,EAAE,SAAiB;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,wBAAwB,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,YAAY,CACpB,KAA2B,EAC3B,gBAAwB;IAExB,OAAO;QACN,OAAO,EAAE;YACR;gBACC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE;oBACL,gBAAgB;oBAChB,EAAE;oBACF,iBAAiB;oBACjB,cAAc,KAAK,CAAC,SAAS,EAAE;oBAC/B,qBAAqB;oBACrB,gBAAgB,KAAK,CAAC,IAAI,EAAE;oBAC5B,KAAK,CAAC,OAAO,CAAC,IAAI;wBACjB,CAAC,CAAC,gBAAgB,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;wBACtC,CAAC,CAAC,SAAS;oBACZ,KAAK,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS;wBACzC,CAAC,CAAC,0BAA0B,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE;wBAC1D,CAAC,CAAC,SAAS;oBACZ,KAAK;iBACL;qBACC,MAAM,CAAC,OAAO,CAAC;qBACf,IAAI,CAAC,IAAI,CAAC;aACZ;SACD;KACD,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAyC;IAC3D,MAAM,MAAM,GAAwD;QACnE,IAAI,EAAE,IAAI;QACV,aAAa,EAAE,UAAU;QACzB,YAAY,EAAE,UAAU;QACxB,UAAU,EAAE,WAAW;KACvB,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAChD,CAAC"}

package/dist/tools/createPersonaTool.d.ts

@@ -0,0 +1,37 @@
+import { ToolResult } from "../utils/types.js";
+export declare const DESCRIPTION_PRINCIPLES: {
+    readonly LANGUAGE: "Use the same language as the user's input for the description";
+    readonly SCENARIO: "Describe the persona's content-consumption behaviour first; don't just list collected fields";
+    readonly CONCRETE: "Use specific, observable behaviours instead of abstract labels";
+    readonly CONCISE: "Single sentence, under 120 characters";
+};
+export interface CreatePersonaInput {
+    id?: string;
+    name: string;
+    name_en?: string;
+    description?: string;
+    tags?: string[];
+    author?: string;
+    sessionId?: string;
+    culturalContext?: string;
+    authorRelation?: string;
+    stance?: string;
+    blindSpot?: string;
+    gender?: string;
+}
+export declare function handleSaveDraft(tmpDir: string, input: CreatePersonaInput): Promise<any>;
+export declare function handleCreatePersona(skillsDir: string, tmpDir: string, input: CreatePersonaInput): Promise<ToolResult>;
+export declare function generateIdFromDraft(draft: any): string | undefined;
+export declare function getSubDirFromDraft(draft: any): string | undefined;
+export declare function applyDedup(skillsDir: string, baseId: string, subDir?: string): string;
+export interface UpdatePersonaDraftInput {
+    sessionId: string;
+    field: "ageRange" | "interests" | "traits" | "platform" | "authorRelation";
+    value: string | string[];
+}
+export declare function handleUpdatePersonaDraft(tmpDir: string, input: UpdatePersonaDraftInput): Promise<ToolResult>;
+export interface DeletePersonaDraftInput {
+    sessionId: string;
+}
+export declare function handleDeletePersonaDraft(tmpDir: string, input: DeletePersonaDraftInput): Promise<ToolResult>;
+//# sourceMappingURL=createPersonaTool.d.ts.map