@roll-agent/core 0.1.1

package/dist/cli/commands/ask.js

@@ -0,0 +1,103 @@
+import { defineCommand } from "citty";
+import { loadConfig } from "../../config/loader.js";
+import { AgentStore } from "../../registry/store.js";
+import { McpClientManager } from "../../mcp/client-manager.js";
+import { routeWithLLM } from "../../router/llm-router.js";
+import { createProviderModel } from "../../llm/providers.js";
+import { log } from "../utils/output.js";
+/** 默认确认阈值：低于此值时跳过执行 */
+const DEFAULT_CONFIRM_THRESHOLD = 0.5;
+export default defineCommand({
+    meta: { description: "LLM 智能路由，自动选择 Agent 和 tool" },
+    args: {
+        message: { type: "positional", description: "自然语言消息", required: true },
+        json: { type: "boolean", description: "JSON 格式输出", default: false },
+    },
+    async run({ args }) {
+        const { config } = loadConfig();
+        const store = new AgentStore(config.agents.dataDir);
+        const agents = store.list();
+        if (agents.length === 0) {
+            log.error("暂无已注册的 Agent。使用 `roll agent add <path>` 注册。");
+            process.exitCode = 1;
+            return;
+        }
+        // 1. 确定路由用的 LLM model
+        const routerProvider = config.llm.defaultProvider;
+        const routerModelName = config.router.llmModel ?? config.llm.defaultModel;
+        const providerConfig = config.llm.providers[routerProvider];
+        if (!providerConfig) {
+            log.error(`LLM provider "${routerProvider}" 未配置。请检查 roll.config.yaml`);
+            process.exitCode = 1;
+            return;
+        }
+        const model = createProviderModel(routerProvider, routerModelName, providerConfig.apiKey, providerConfig.baseUrl);
+        // 2. LLM 智能路由
+        log.info(`分析意图: "${args.message}"`);
+        let decision;
+        try {
+            decision = await routeWithLLM(args.message, agents, model);
+        }
+        catch (err) {
+            log.error(`LLM 路由失败: ${err instanceof Error ? err.message : String(err)}`);
+            process.exitCode = 1;
+            return;
+        }
+        log.info(`路由决策: ${decision.agentName}.${decision.toolName} (置信度: ${String(decision.confidence)})`);
+        // 3. 置信度检查
+        const threshold = config.router.confirmThreshold ?? DEFAULT_CONFIRM_THRESHOLD;
+        if (decision.confidence < threshold) {
+            log.warn(`置信度 ${String(decision.confidence)} 低于阈值 ${String(threshold)}，跳过执行。` +
+                `\n  可使用 \`roll run ${decision.agentName} ${decision.toolName}\` 手动调用。`);
+            if (args.json) {
+                console.log(JSON.stringify(decision, null, 2));
+            }
+            process.exitCode = 1;
+            return;
+        }
+        // 4. 查找 Agent 并执行
+        const agent = agents.find((a) => a.skill.name === decision.agentName);
+        if (!agent) {
+            log.error(`Agent "${decision.agentName}" 未找到（LLM 返回了无效的 Agent 名称）`);
+            process.exitCode = 1;
+            return;
+        }
+        // 为子 Agent 创建 Sampling model（复用路由用的 LLM model）
+        const samplingModel = createProviderModel(routerProvider, config.llm.defaultModel, providerConfig.apiKey, providerConfig.baseUrl);
+        const clientManager = new McpClientManager();
+        try {
+            log.info(`连接 Agent "${agent.skill.name}"...`);
+            const client = await clientManager.connect(agent.skill.name, agent.transport, agent.installPath, { samplingModel });
+            log.info(`调用 ${agent.skill.name}.${decision.toolName}(${JSON.stringify(decision.input)})`);
+            const result = await client.callTool({
+                name: decision.toolName,
+                arguments: decision.input,
+            });
+            // 数据结果输出到 stdout
+            if (args.json) {
+                console.log(JSON.stringify({ decision, result }, null, 2));
+            }
+            else if (Array.isArray(result.content)) {
+                for (const content of result.content) {
+                    if (typeof content === "object" &&
+                        content !== null &&
+                        "type" in content &&
+                        content.type === "text" &&
+                        "text" in content &&
+                        typeof content.text === "string") {
+                        console.log(content.text);
+                    }
+                }
+            }
+            log.success("调用完成");
+        }
+        catch (err) {
+            log.error(err instanceof Error ? err.message : String(err));
+            process.exitCode = 1;
+        }
+        finally {
+            await clientManager.disconnectAll();
+        }
+    },
+});
+//# sourceMappingURL=ask.js.map

package/dist/cli/commands/ask.js.map

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

package/dist/cli/commands/config.d.ts

@@ -0,0 +1,19 @@
+declare const _default: import("citty").CommandDef<{
+    action: {
+        type: "positional";
+        description: string;
+        required: true;
+    };
+    key: {
+        type: "positional";
+        description: string;
+        required: false;
+    };
+    value: {
+        type: "positional";
+        description: string;
+        required: false;
+    };
+}>;
+export default _default;
+//# sourceMappingURL=config.d.ts.map

package/dist/cli/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAOA,wBA0BG"}

package/dist/cli/commands/config.js

@@ -0,0 +1,142 @@
+import { defineCommand } from "citty";
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { loadConfig } from "../../config/loader.js";
+export default defineCommand({
+    meta: { description: "管理全局配置" },
+    args: {
+        action: { type: "positional", description: "操作（init/get/set）", required: true },
+        key: { type: "positional", description: "配置键（get/set 时使用，点号分隔）", required: false },
+        value: { type: "positional", description: "配置值（set 时使用）", required: false },
+    },
+    async run({ args }) {
+        if (args.action === "init") {
+            await initConfig();
+            return;
+        }
+        if (args.action === "get") {
+            getConfig(args.key);
+            return;
+        }
+        if (args.action === "set") {
+            setConfig(args.key, args.value);
+            return;
+        }
+        console.error(`✗ 未知操作: ${args.action}。可用: init, get, set`);
+        process.exitCode = 1;
+    },
+});
+/** 交互式初始化配置文件 */
+async function initConfig() {
+    const configPath = resolve(process.cwd(), "roll.config.yaml");
+    if (existsSync(configPath)) {
+        console.error(`⚠ 配置文件已存在: ${configPath}`);
+        const rl = createInterface({ input: process.stdin, output: process.stderr });
+        const answer = await rl.question("是否覆盖？(y/N) ");
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+            console.error("已取消。");
+            return;
+        }
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    const provider = (await rl.question("默认 LLM provider (anthropic/openai/qwen) [anthropic]: ")) || "anthropic";
+    const model = (await rl.question("默认 model [claude-sonnet-4-20250514]: ")) || "claude-sonnet-4-20250514";
+    const apiKeyEnv = (await rl.question("API Key 环境变量名 [ANTHROPIC_API_KEY]: ")) || "ANTHROPIC_API_KEY";
+    rl.close();
+    const yaml = `llm:
+  default-provider: ${provider}
+  default-model: ${model}
+  providers:
+    ${provider}:
+      api-key: \${${apiKeyEnv}}
+
+router:
+  mode: declarative
+
+agents:
+  data-dir: ~/.roll-agent/agents
+`;
+    writeFileSync(configPath, yaml, "utf-8");
+    console.log(`✓ 配置文件已创建: ${configPath}`);
+}
+/** 查看配置值 */
+function getConfig(key) {
+    const { config, configPath } = loadConfig();
+    if (!key) {
+        console.log(JSON.stringify(config, null, 2));
+        if (configPath) {
+            console.error(`(来源: ${configPath})`);
+        }
+        return;
+    }
+    // 支持点号路径访问：llm.defaultProvider
+    const parts = key.split(".");
+    let current = config;
+    for (const part of parts) {
+        if (typeof current !== "object" || current === null) {
+            console.error(`✗ 配置键 "${key}" 不存在`);
+            process.exitCode = 1;
+            return;
+        }
+        current = current[part];
+    }
+    if (current === undefined) {
+        console.error(`✗ 配置键 "${key}" 不存在`);
+        process.exitCode = 1;
+        return;
+    }
+    console.log(typeof current === "object" ? JSON.stringify(current, null, 2) : String(current));
+}
+/**
+ * camelCase 键转换为 kebab-case（与 YAML 文件格式保持一致）。
+ * 例如 `defaultProvider` → `default-provider`
+ */
+function camelToKebab(str) {
+    return str.replace(/[A-Z]/g, (ch) => `-${ch.toLowerCase()}`);
+}
+/** 设置配置值并写回 YAML 文件 */
+function setConfig(key, value) {
+    if (!key || value === undefined) {
+        console.error("✗ 用法: roll config set <key> <value>");
+        console.error("  示例: roll config set llm.defaultModel claude-sonnet-4-20250514");
+        process.exitCode = 1;
+        return;
+    }
+    const { configPath } = loadConfig();
+    if (!configPath) {
+        console.error("✗ 未找到配置文件。请先运行 roll config init");
+        process.exitCode = 1;
+        return;
+    }
+    // 读取原始 YAML 为 JS 对象
+    const raw = readFileSync(configPath, "utf-8");
+    const doc = (parseYaml(raw) ?? {});
+    // 按点号路径设置值（使用 kebab-case 键匹配 YAML 格式）
+    const parts = key.split(".");
+    let current = doc;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const kebabKey = camelToKebab(parts[i]);
+        const next = current[kebabKey];
+        if (typeof next !== "object" || next === null || Array.isArray(next)) {
+            current[kebabKey] = {};
+        }
+        current = current[kebabKey];
+    }
+    const lastKey = camelToKebab(parts[parts.length - 1]);
+    // 尝试解析为数字/布尔值，否则保持字符串
+    let parsed = value;
+    if (value === "true")
+        parsed = true;
+    else if (value === "false")
+        parsed = false;
+    else if (/^\d+(\.\d+)?$/.test(value))
+        parsed = Number(value);
+    current[lastKey] = parsed;
+    writeFileSync(configPath, stringifyYaml(doc, { lineWidth: 0 }), "utf-8");
+    console.log(`✓ ${key} = ${String(parsed)}`);
+    console.error(`  (已写入: ${configPath})`);
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/cli/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,eAAe,aAAa,CAAC;IAC3B,IAAI,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE;IAC/B,IAAI,EAAE;QACJ,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC/E,GAAG,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,QAAQ,EAAE,KAAK,EAAE;QAClF,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE;KAC5E;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,UAAU,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC1B,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC1B,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,OAAO;QACT,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,MAAM,qBAAqB,CAAC,CAAC;QAC3D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;CACF,CAAC,CAAC;AAEH,iBAAiB;AACjB,KAAK,UAAU,UAAU;IACvB,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,kBAAkB,CAAC,CAAC;IAE9D,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,cAAc,UAAU,EAAE,CAAC,CAAC;QAC1C,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAChD,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;IACH,CAAC;IAED,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE7E,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC,CAAC,IAAI,WAAW,CAAC;IAC7G,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC,CAAC,IAAI,0BAA0B,CAAC;IACzG,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC,CAAC,IAAI,mBAAmB,CAAC;IAEpG,EAAE,CAAC,KAAK,EAAE,CAAC;IAEX,MAAM,IAAI,GAAG;sBACO,QAAQ;mBACX,KAAK;;MAElB,QAAQ;oBACM,SAAS;;;;;;;CAO5B,CAAC;IAEA,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,cAAc,UAAU,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,YAAY;AACZ,SAAS,SAAS,CAAC,GAAuB;IACxC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAAC;IAE5C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,QAAQ,UAAU,GAAG,CAAC,CAAC;QACvC,CAAC;QACD,OAAO;IACT,CAAC;IAED,+BAA+B;IAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,OAAO,GAAY,MAAM,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACpD,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,OAAO,CAAC,CAAC;YACpC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,OAAO,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,OAAO,CAAC,CAAC;QACpC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AAChG,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,uBAAuB;AACvB,SAAS,SAAS,CAAC,GAAuB,EAAE,KAAyB;IACnE,IAAI,CAAC,GAAG,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACjF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAAC;IAEpC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,oBAAoB;IACpB,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAC;IAE9D,sCAAsC;IACtC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,OAAO,GAA4B,GAAG,CAAC;IAE3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAW,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACrE,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QACzB,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,QAAQ,CAA4B,CAAC;IACzD,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAW,CAAC,CAAC;IAEhE,sBAAsB;IACtB,IAAI,MAAM,GAAY,KAAK,CAAC;IAC5B,IAAI,KAAK,KAAK,MAAM;QAAE,MAAM,GAAG,IAAI,CAAC;SAC/B,IAAI,KAAK,KAAK,OAAO;QAAE,MAAM,GAAG,KAAK,CAAC;SACtC,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE7D,OAAO,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC;IAE1B,aAAa,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,KAAK,CAAC,WAAW,UAAU,GAAG,CAAC,CAAC;AAC1C,CAAC"}

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,10 @@
+export declare function isNodeVersionSupported(version: string): boolean;
+declare const _default: import("citty").CommandDef<{
+    json: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+}>;
+export default _default;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAmBA,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAe/D;;;;;;;;AAED,wBAuGG"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,123 @@
+import { defineCommand } from "citty";
+import { existsSync } from "node:fs";
+import { loadConfig } from "../../config/loader.js";
+import { AgentStore } from "../../registry/store.js";
+const STATUS_ICONS = {
+    ok: "✓",
+    warn: "⚠",
+    fail: "✗",
+};
+const MIN_NODE_VERSION = { major: 22, minor: 6, patch: 0 };
+export function isNodeVersionSupported(version) {
+    const match = /^(\d+)\.(\d+)\.(\d+)/.exec(version);
+    if (!match)
+        return false;
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    const patch = Number(match[3]);
+    if (major > MIN_NODE_VERSION.major)
+        return true;
+    if (major < MIN_NODE_VERSION.major)
+        return false;
+    if (minor > MIN_NODE_VERSION.minor)
+        return true;
+    if (minor < MIN_NODE_VERSION.minor)
+        return false;
+    return patch >= MIN_NODE_VERSION.patch;
+}
+export default defineCommand({
+    meta: { description: "诊断系统状态" },
+    args: {
+        json: { type: "boolean", description: "JSON 格式输出", default: false },
+    },
+    run({ args }) {
+        const checks = [];
+        // 1. Node.js 版本
+        const nodeVersion = process.versions.node;
+        checks.push(isNodeVersionSupported(nodeVersion)
+            ? { name: "Node.js 版本", status: "ok", message: `v${nodeVersion}` }
+            : { name: "Node.js 版本", status: "fail", message: `v${nodeVersion} (需要 ≥22.6.0)` });
+        // 2. 配置文件（只加载一次，后续复用）
+        let loadResult;
+        try {
+            loadResult = loadConfig();
+            if (loadResult.configPath) {
+                checks.push({ name: "配置文件", status: "ok", message: loadResult.configPath });
+            }
+            else {
+                checks.push({ name: "配置文件", status: "warn", message: "未找到，使用默认配置" });
+            }
+        }
+        catch (err) {
+            checks.push({
+                name: "配置文件",
+                status: "fail",
+                message: err instanceof Error ? err.message : String(err),
+            });
+        }
+        // 3. LLM Provider 配置
+        if (loadResult) {
+            const { config } = loadResult;
+            const providers = Object.keys(config.llm.providers);
+            if (providers.length > 0) {
+                // 检查 API key 是否像是未解析的环境变量
+                const unresolved = providers.filter((p) => {
+                    const key = config.llm.providers[p]?.apiKey ?? "";
+                    return key.startsWith("${") || key.length === 0;
+                });
+                if (unresolved.length > 0) {
+                    checks.push({
+                        name: "LLM Providers",
+                        status: "warn",
+                        message: `${providers.join(", ")} (${unresolved.join(", ")} API key 未设置)`,
+                    });
+                }
+                else {
+                    checks.push({
+                        name: "LLM Providers",
+                        status: "ok",
+                        message: providers.join(", "),
+                    });
+                }
+            }
+            else {
+                checks.push({
+                    name: "LLM Providers",
+                    status: "warn",
+                    message: "未配置任何 provider",
+                });
+            }
+            // 4. Agent 数据目录
+            const dataDir = config.agents.dataDir;
+            checks.push(existsSync(dataDir)
+                ? { name: "Agent 数据目录", status: "ok", message: dataDir }
+                : { name: "Agent 数据目录", status: "warn", message: `${dataDir} (不存在，首次 add 时创建)` });
+            // 5. 已注册 Agent
+            const store = new AgentStore(config.agents.dataDir);
+            const agents = store.list();
+            checks.push({
+                name: "已注册 Agent",
+                status: agents.length > 0 ? "ok" : "warn",
+                message: agents.length > 0
+                    ? `${String(agents.length)} 个 (${agents.map((a) => a.skill.name).join(", ")})`
+                    : "无",
+            });
+        }
+        // 输出
+        if (args.json) {
+            console.log(JSON.stringify(checks, null, 2));
+            return;
+        }
+        console.log("Roll Agent 系统诊断\n");
+        for (const check of checks) {
+            const icon = STATUS_ICONS[check.status];
+            console.log(`  ${icon} ${check.name}: ${check.message}`);
+        }
+        const hasFailure = checks.some((c) => c.status === "fail");
+        console.log(hasFailure ? "\n存在问题，请修复后重试。" : "\n系统状态正常。");
+        if (hasFailure) {
+            process.exitCode = 1;
+        }
+    },
+});
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

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

package/dist/cli/commands/run.d.ts

@@ -0,0 +1,24 @@
+declare const _default: import("citty").CommandDef<{
+    agent: {
+        type: "positional";
+        description: string;
+        required: true;
+    };
+    tool: {
+        type: "positional";
+        description: string;
+        required: true;
+    };
+    json: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+}>;
+export default _default;
+/**
+ * 从 rawArgs 中解析 --key value 格式的参数。
+ * 支持 --limit 10（数字自动转换）和 --dryRun（布尔标志）。
+ */
+export declare function parseToolArgs(rawArgs: string[]): Record<string, unknown>;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/run.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAOA,wBA0FG;AAMH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyCxE"}

package/dist/cli/commands/run.js

@@ -0,0 +1,124 @@
+import { defineCommand } from "citty";
+import { loadConfig } from "../../config/loader.js";
+import { AgentStore } from "../../registry/store.js";
+import { McpClientManager } from "../../mcp/client-manager.js";
+import { createProviderModel } from "../../llm/providers.js";
+import { log } from "../utils/output.js";
+export default defineCommand({
+    meta: { description: "声明式调用 Agent 的指定 tool" },
+    args: {
+        agent: { type: "positional", description: "Agent 名称", required: true },
+        tool: { type: "positional", description: "Tool 名称", required: true },
+        json: { type: "boolean", description: "JSON 格式输出", default: false },
+    },
+    async run({ args, rawArgs }) {
+        const { config } = loadConfig();
+        const store = new AgentStore(config.agents.dataDir);
+        // 1. 查找已注册的 Agent
+        const agent = store.findByName(args.agent);
+        if (!agent) {
+            log.error(`Agent "${args.agent}" 未注册。使用 \`roll agent list\` 查看已注册 Agent。`);
+            process.exitCode = 1;
+            return;
+        }
+        // 2. 解析额外参数 (--key value 格式)
+        const toolArgs = parseToolArgs(rawArgs);
+        // 3. 连接 MCP Server
+        const clientManager = new McpClientManager();
+        try {
+            // 尝试创建 Sampling model（为子 Agent 提供 LLM 能力）
+            const providerName = config.llm.defaultProvider;
+            const providerConfig = config.llm.providers[providerName];
+            const samplingModel = providerConfig
+                ? createProviderModel(providerName, config.llm.defaultModel, providerConfig.apiKey, providerConfig.baseUrl)
+                : undefined;
+            log.info(`连接 Agent "${agent.skill.name}"...`);
+            const client = await clientManager.connect(agent.skill.name, agent.transport, agent.installPath, ...(samplingModel ? [{ samplingModel }] : []));
+            // 4. 列出 tools 验证目标 tool 存在
+            const { tools } = await client.listTools();
+            const targetTool = tools.find((t) => t.name === args.tool);
+            if (!targetTool) {
+                const available = tools.map((t) => t.name).join(", ");
+                log.error(`Tool "${args.tool}" 不存在。可用 tools: ${available}`);
+                process.exitCode = 1;
+                return;
+            }
+            // 5. 调用 tool
+            log.info(`调用 ${agent.skill.name}.${args.tool}(${JSON.stringify(toolArgs)})`);
+            const result = await client.callTool({
+                name: args.tool,
+                arguments: toolArgs,
+            });
+            // 6. 输出结果（stdout，不经过 log）
+            if (args.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else if (Array.isArray(result.content)) {
+                for (const content of result.content) {
+                    if (typeof content === "object" &&
+                        content !== null &&
+                        "type" in content &&
+                        content.type === "text" &&
+                        "text" in content &&
+                        typeof content.text === "string") {
+                        console.log(content.text);
+                    }
+                }
+            }
+            log.success("调用完成");
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const cause = err instanceof Error && err.cause ? `\n  cause: ${String(err.cause)}` : "";
+            log.error(`${message}${cause}`);
+            process.exitCode = 1;
+        }
+        finally {
+            await clientManager.disconnectAll();
+        }
+    },
+});
+/** run 命令的 CLI 保留参数（不应透传给 tool） */
+const CLI_FLAG_OPTIONS = new Set(["json", "verbose", "v", "help", "h", "version"]);
+const CLI_VALUE_OPTIONS = new Set(["config"]);
+/**
+ * 从 rawArgs 中解析 --key value 格式的参数。
+ * 支持 --limit 10（数字自动转换）和 --dryRun（布尔标志）。
+ */
+export function parseToolArgs(rawArgs) {
+    const result = {};
+    // 跳过前面的 positional args（agent 和 tool 名称）
+    let i = 0;
+    while (i < rawArgs.length && !rawArgs[i]?.startsWith("--")) {
+        i++;
+    }
+    while (i < rawArgs.length) {
+        const arg = rawArgs[i];
+        if (!arg?.startsWith("--")) {
+            i++;
+            continue;
+        }
+        const key = arg.slice(2);
+        const nextArg = rawArgs[i + 1];
+        // 跳过 run 命令自身参数，避免污染 tool input
+        if (CLI_FLAG_OPTIONS.has(key)) {
+            i++;
+            continue;
+        }
+        if (CLI_VALUE_OPTIONS.has(key)) {
+            i += nextArg && !nextArg.startsWith("--") ? 2 : 1;
+            continue;
+        }
+        if (!nextArg || nextArg.startsWith("--")) {
+            result[key] = true;
+            i++;
+        }
+        else {
+            const num = Number(nextArg);
+            result[key] = Number.isNaN(num) ? nextArg : num;
+            i += 2;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/commands/run.js.map

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

package/dist/cli/commands/update.d.ts

@@ -0,0 +1,12 @@
+import type { RegisteredAgent } from "../../types/agent.ts";
+/** 推断旧 Agent（无 source 字段）的来源类型 */
+export declare function inferSourceType(agent: RegisteredAgent): "git" | "local" | "remote";
+declare const _default: import("citty").CommandDef<{
+    check: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+}>;
+export default _default;
+//# sourceMappingURL=update.d.ts.map

package/dist/cli/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI5D,kCAAkC;AAClC,wBAAgB,eAAe,CAC7B,KAAK,EAAE,eAAe,GACrB,KAAK,GAAG,OAAO,GAAG,QAAQ,CAU5B;;;;;;;;AA+ED,wBA0JG"}