@roll-agent/core 0.1.1

package/dist/cli/commands/update.js

@@ -0,0 +1,237 @@
+import { defineCommand } from "citty";
+import { resolve } from "node:path";
+import { existsSync } from "node:fs";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { loadConfig } from "../../config/loader.js";
+import { AgentStore } from "../../registry/store.js";
+import { discoverAgent } from "../../registry/discovery.js";
+import { McpClientManager } from "../../mcp/client-manager.js";
+import { log, createSpinner } from "../utils/output.js";
+import { checkForUpdate, getCurrentVersion, } from "../utils/update-checker.js";
+const execFileAsync = promisify(execFile);
+/** 推断旧 Agent（无 source 字段）的来源类型 */
+export function inferSourceType(agent) {
+    if (agent.source) {
+        if (agent.source.type === "git")
+            return "git";
+        if (agent.source.type === "local")
+            return "local";
+        return "remote";
+    }
+    // 旧数据兼容：检查 installPath 下是否有 .git 目录
+    if (agent.transport.type === "streamable-http")
+        return "remote";
+    if (existsSync(resolve(agent.installPath, ".git")))
+        return "git";
+    return "local";
+}
+/** 更新 roll-core 自身 */
+async function updateSelf(latest, dryRun) {
+    const current = getCurrentVersion();
+    if (current === latest) {
+        log.info(`roll 已是最新版本 (v${current})`);
+        return false;
+    }
+    log.info(`roll v${current} → v${latest}`);
+    if (dryRun) {
+        log.info("[dry-run] 跳过实际更新");
+        return true;
+    }
+    const spinner = createSpinner("正在更新 @roll-agent/core...").start();
+    try {
+        await execFileAsync("npm", ["install", "-g", `@roll-agent/core@${latest}`], {
+            timeout: 60_000,
+        });
+        spinner.succeed(`roll 已更新到 v${latest}`);
+        return true;
+    }
+    catch (err) {
+        spinner.fail("更新失败");
+        log.error(err instanceof Error ? err.message : String(err));
+        return false;
+    }
+}
+/** 更新 git 来源的 Agent */
+async function updateGitAgent(agent) {
+    const spinner = createSpinner(`更新 ${agent.skill.name} (git pull)...`).start();
+    try {
+        await execFileAsync("git", ["pull"], { cwd: agent.installPath, timeout: 30_000 });
+        spinner.succeed(`${agent.skill.name} 代码已更新`);
+        // 重新安装依赖
+        const packageJsonPath = resolve(agent.installPath, "package.json");
+        if (existsSync(packageJsonPath)) {
+            const depSpinner = createSpinner(`安装 ${agent.skill.name} 依赖...`).start();
+            try {
+                await execFileAsync("pnpm", ["install"], { cwd: agent.installPath, timeout: 60_000 });
+                depSpinner.succeed(`${agent.skill.name} 依赖已更新`);
+            }
+            catch (err) {
+                depSpinner.fail(`${agent.skill.name} 依赖安装失败`);
+                log.error(err instanceof Error ? err.message : String(err));
+                return false;
+            }
+        }
+        return true;
+    }
+    catch (err) {
+        spinner.fail(`${agent.skill.name} 更新失败`);
+        log.error(err instanceof Error ? err.message : String(err));
+        return false;
+    }
+}
+/** 刷新远程 Agent 的 MCP 元数据 */
+async function refreshRemoteAgent(agent) {
+    const spinner = createSpinner(`刷新 ${agent.skill.name} (MCP tools/list)...`).start();
+    const manager = new McpClientManager();
+    try {
+        const client = await manager.connect(agent.skill.name, agent.transport, agent.installPath);
+        const { tools } = await client.listTools();
+        spinner.succeed(`${agent.skill.name} 元数据已刷新（${tools.length} 个 tool）`);
+        return true;
+    }
+    catch (err) {
+        spinner.fail(`${agent.skill.name} 刷新失败`);
+        log.error(err instanceof Error ? err.message : String(err));
+        return false;
+    }
+    finally {
+        await manager.disconnectAll();
+    }
+}
+export default defineCommand({
+    meta: { description: "更新 roll 及已注册的 Agent" },
+    args: {
+        check: {
+            type: "boolean",
+            description: "仅检查可用更新，不执行",
+            default: false,
+        },
+    },
+    async run({ args }) {
+        const isCheckOnly = args.check;
+        // === 1. 检查 roll-core 自身 ===
+        log.info("检查 roll 更新...");
+        const info = await checkForUpdate({ forceRefresh: true });
+        if (info.hasUpdate) {
+            log.success(`roll 有新版本: v${info.current} → v${info.latest}`);
+        }
+        else {
+            log.info(`roll 已是最新版本 (v${info.current})`);
+        }
+        // === 2. 检查已注册 Agent ===
+        const { config } = loadConfig();
+        const store = new AgentStore(config.agents.dataDir);
+        const agents = store.list();
+        const agentSummary = [];
+        for (const agent of agents) {
+            const sourceType = inferSourceType(agent);
+            let action;
+            switch (sourceType) {
+                case "git":
+                    action = "git pull + 重新安装依赖";
+                    break;
+                case "remote":
+                    action = "刷新 MCP 元数据 (tools/list)";
+                    break;
+                case "local":
+                    action = "跳过（本地 Agent 请手动更新）";
+                    break;
+            }
+            agentSummary.push({ name: agent.skill.name, sourceType, action });
+        }
+        if (agents.length > 0) {
+            log.info(`\n已注册 Agent (${agents.length}):`);
+            for (const s of agentSummary) {
+                const tag = s.sourceType === "local" ? "⏭" : "⬆";
+                log.info(`  ${tag} ${s.name} [${s.sourceType}] — ${s.action}`);
+            }
+        }
+        else {
+            log.info("无已注册 Agent");
+        }
+        // --check 模式到此结束
+        if (isCheckOnly)
+            return;
+        // === 3. 执行更新 ===
+        log.info("");
+        // 3a. 更新 roll-core
+        let selfUpdated = false;
+        let selfUpdateFailed = false;
+        if (info.hasUpdate) {
+            selfUpdated = await updateSelf(info.latest, false);
+            if (!selfUpdated)
+                selfUpdateFailed = true;
+        }
+        // 3b. 更新 Agent
+        let updatedCount = 0;
+        let skippedCount = 0;
+        let failedCount = 0;
+        for (const agent of agents) {
+            const sourceType = inferSourceType(agent);
+            switch (sourceType) {
+                case "git": {
+                    const ok = await updateGitAgent(agent);
+                    if (ok) {
+                        // 重新解析 SKILL.md 并更新 store
+                        try {
+                            const discovered = discoverAgent(agent.installPath);
+                            const updated = {
+                                ...agent,
+                                skill: discovered.skill,
+                                transport: discovered.transport,
+                                ...(discovered.skillBody.length > 0 ? { skillBody: discovered.skillBody } : {}),
+                            };
+                            const replaced = store.replace(agent.skill.name, updated);
+                            if (!replaced) {
+                                log.warn(`${agent.skill.name} 已从注册表中移除，跳过元数据刷新`);
+                            }
+                        }
+                        catch (err) {
+                            log.warn(`${agent.skill.name} SKILL.md 重新解析失败: ${err instanceof Error ? err.message : String(err)}`);
+                        }
+                        updatedCount++;
+                    }
+                    else {
+                        failedCount++;
+                    }
+                    break;
+                }
+                case "remote": {
+                    const ok = await refreshRemoteAgent(agent);
+                    if (ok) {
+                        updatedCount++;
+                    }
+                    else {
+                        failedCount++;
+                    }
+                    break;
+                }
+                case "local":
+                    log.warn(`${agent.skill.name} 是本地 Agent，请手动更新后运行 roll agent add <path> 重新注册`);
+                    skippedCount++;
+                    break;
+            }
+        }
+        // === 4. 总结 ===
+        log.info("");
+        const totalFailed = failedCount + (selfUpdateFailed ? 1 : 0);
+        if (totalFailed > 0) {
+            process.exitCode = 1;
+            const rollStatus = selfUpdateFailed
+                ? "roll 更新失败"
+                : selfUpdated
+                    ? "roll ✓"
+                    : "roll 无更新";
+            log.warn(`更新完成但有失败：${rollStatus}${failedCount > 0 ? `，${failedCount} 个 Agent 更新失败` : ""}${updatedCount > 0 ? `，${updatedCount} 个 Agent 已更新` : ""}${skippedCount > 0 ? `，${skippedCount} 个已跳过` : ""}`);
+            return;
+        }
+        if (selfUpdated || updatedCount > 0) {
+            log.success(`更新完成：${selfUpdated ? "roll ✓" : "roll 无更新"}${updatedCount > 0 ? `，${updatedCount} 个 Agent 已更新` : ""}${skippedCount > 0 ? `，${skippedCount} 个已跳过` : ""}`);
+        }
+        else {
+            log.success("一切都已是最新版本");
+        }
+    },
+});
+//# sourceMappingURL=update.js.map

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

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

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

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

package/dist/cli/index.js

@@ -0,0 +1,31 @@
+import { defineCommand, runMain } from "citty";
+import chalk from "chalk";
+import { checkForUpdate, getCurrentVersion } from "./utils/update-checker.js";
+const CLI_VERSION = getCurrentVersion();
+const main = defineCommand({
+    meta: {
+        name: "roll",
+        version: CLI_VERSION,
+        description: "花卷 Agent — 轻量级 Agent 编排系统",
+    },
+    subCommands: {
+        agent: () => import("./commands/agent.js").then((m) => m.default),
+        run: () => import("./commands/run.js").then((m) => m.default),
+        ask: () => import("./commands/ask.js").then((m) => m.default),
+        config: () => import("./commands/config.js").then((m) => m.default),
+        doctor: () => import("./commands/doctor.js").then((m) => m.default),
+        update: () => import("./commands/update.js").then((m) => m.default),
+    },
+});
+// 启动提示只读缓存，保证不阻塞 CLI 退出。
+const updateCheckPromise = checkForUpdate({ allowNetwork: false }).catch(() => undefined);
+runMain(main).then(() => {
+    updateCheckPromise
+        .then((info) => {
+        if (info?.hasUpdate) {
+            console.error(`\n${chalk.yellow("⬆")} roll ${chalk.green(`v${info.latest}`)} available (current: v${info.current}). Run ${chalk.cyan("roll update")} to upgrade.`);
+        }
+    })
+        .catch(() => undefined);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9E,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAC;AAExC,MAAM,IAAI,GAAG,aAAa,CAAC;IACzB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE,2BAA2B;KACzC;IACD,WAAW,EAAE;QACX,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QACjE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7D,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7D,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QACnE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QACnE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;KACpE;CACF,CAAC,CAAC;AAEH,yBAAyB;AACzB,MAAM,kBAAkB,GAAG,cAAc,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CACtE,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;AAEF,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;IACtB,kBAAkB;SACf,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,EAAE,SAAS,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CACX,KAAK,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,yBAAyB,IAAI,CAAC,OAAO,UAAU,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,cAAc,CACpJ,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC"}

package/dist/cli/smoke.e2e.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=smoke.e2e.d.ts.map

package/dist/cli/smoke.e2e.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.e2e.d.ts","sourceRoot":"","sources":["../../src/cli/smoke.e2e.ts"],"names":[],"mappings":""}

package/dist/cli/smoke.e2e.js

@@ -0,0 +1,57 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { tmpdir } from "node:os";
+import { randomUUID } from "node:crypto";
+import { spawnSync } from "node:child_process";
+function runRoll(args, cwd, env = {}) {
+    const cliEntry = resolve(import.meta.dirname, "index.ts");
+    const result = spawnSync(process.execPath, ["--experimental-strip-types", cliEntry, ...args], {
+        cwd,
+        encoding: "utf-8",
+        env: { ...process.env, NO_COLOR: "1", ...env },
+    });
+    return {
+        status: result.status,
+        stdout: result.stdout,
+        stderr: result.stderr,
+    };
+}
+function buildConfigYaml(dataDir) {
+    return `llm:
+  default-provider: anthropic
+  default-model: claude-sonnet-4-20250514
+  providers: {}
+
+router:
+  mode: declarative
+
+agents:
+  data-dir: ${dataDir}
+`;
+}
+test("e2e smoke: register boss-reply agent and run get_unread", { timeout: 120_000 }, () => {
+    const workspace = mkdtempSync(resolve(tmpdir(), `roll-e2e-${randomUUID()}-`));
+    try {
+        const repoRoot = resolve(import.meta.dirname, "../../../../");
+        const bossAgentPath = resolve(repoRoot, "agents/boss-reply");
+        const dataDir = resolve(workspace, "agents-data");
+        writeFileSync(resolve(workspace, "roll.config.yaml"), buildConfigYaml(dataDir), "utf-8");
+        const addResult = runRoll(["agent", "add", bossAgentPath], workspace, {
+            ROLL_SKIP_INSTALL: "1",
+        });
+        assert.equal(addResult.status, 0, `agent add failed\nstdout:\n${addResult.stdout}\nstderr:\n${addResult.stderr}`);
+        const listResult = runRoll(["agent", "list", "--json"], workspace);
+        assert.equal(listResult.status, 0, `agent list failed\nstdout:\n${listResult.stdout}\nstderr:\n${listResult.stderr}`);
+        const listedAgents = JSON.parse(listResult.stdout);
+        assert.ok(listedAgents.some((agent) => agent.skill.name === "boss-reply-agent"));
+        const runResult = runRoll(["run", "boss-reply-agent", "get_unread"], workspace);
+        assert.equal(runResult.status, 0, `roll run failed\nstdout:\n${runResult.stdout}\nstderr:\n${runResult.stderr}`);
+        assert.match(runResult.stdout, /"messages"\s*:\s*\[\]/);
+    }
+    finally {
+        rmSync(workspace, { recursive: true, force: true });
+    }
+});
+//# sourceMappingURL=smoke.e2e.js.map

package/dist/cli/smoke.e2e.js.map

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

package/dist/cli/utils/output.d.ts

@@ -0,0 +1,24 @@
+import type { Ora } from "ora";
+/** 日志级别 */
+declare const LOG_LEVELS: {
+    readonly debug: 0;
+    readonly info: 1;
+    readonly warn: 2;
+    readonly error: 3;
+    readonly silent: 4;
+};
+type LogLevel = keyof typeof LOG_LEVELS;
+/** 设置全局日志级别 */
+export declare function setLogLevel(level: LogLevel): void;
+/** 结构化日志输出（写入 stderr，不干扰 stdout 数据流） */
+export declare const log: {
+    debug(message: string): void;
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+};
+/** 创建 spinner（用于长时间操作的加载动画） */
+export declare function createSpinner(text: string): Ora;
+export {};
+//# sourceMappingURL=output.d.ts.map

package/dist/cli/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/output.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE/B,WAAW;AACX,QAAA,MAAM,UAAU;;;;;;CAMN,CAAC;AAEX,KAAK,QAAQ,GAAG,MAAM,OAAO,UAAU,CAAC;AAKxC,eAAe;AACf,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAMD,wCAAwC;AACxC,eAAO,MAAM,GAAG;mBACC,MAAM,GAAG,IAAI;kBAKd,MAAM,GAAG,IAAI;qBAKV,MAAM,GAAG,IAAI;kBAKhB,MAAM,GAAG,IAAI;mBAKZ,MAAM,GAAG,IAAI;CAK7B,CAAC;AAEF,+BAA+B;AAC/B,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAE/C"}

package/dist/cli/utils/output.js

@@ -0,0 +1,52 @@
+import chalk from "chalk";
+import ora from "ora";
+/** 日志级别 */
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+/** 全局日志级别，可通过 setLogLevel 修改 */
+let currentLevel = "info";
+/** 设置全局日志级别 */
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+function shouldLog(level) {
+    return LOG_LEVELS[level] >= LOG_LEVELS[currentLevel];
+}
+/** 结构化日志输出（写入 stderr，不干扰 stdout 数据流） */
+export const log = {
+    debug(message) {
+        if (shouldLog("debug")) {
+            console.error(chalk.gray(`[debug] ${message}`));
+        }
+    },
+    info(message) {
+        if (shouldLog("info")) {
+            console.error(chalk.blue("→") + ` ${message}`);
+        }
+    },
+    success(message) {
+        if (shouldLog("info")) {
+            console.error(chalk.green("✓") + ` ${message}`);
+        }
+    },
+    warn(message) {
+        if (shouldLog("warn")) {
+            console.error(chalk.yellow("⚠") + ` ${message}`);
+        }
+    },
+    error(message) {
+        if (shouldLog("error")) {
+            console.error(chalk.red("✗") + ` ${message}`);
+        }
+    },
+};
+/** 创建 spinner（用于长时间操作的加载动画） */
+export function createSpinner(text) {
+    return ora({ text, stream: process.stderr });
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/cli/utils/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AAGtB,WAAW;AACX,MAAM,UAAU,GAAG;IACjB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACD,CAAC;AAIX,gCAAgC;AAChC,IAAI,YAAY,GAAa,MAAM,CAAC;AAEpC,eAAe;AACf,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;AACvD,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,KAAK,CAAC,OAAe;QACnB,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,IAAI,CAAC,OAAe;QAClB,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IACD,OAAO,CAAC,OAAe;QACrB,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,IAAI,CAAC,OAAe;QAClB,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,KAAK,CAAC,OAAe;QACnB,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+BAA+B;AAC/B,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/cli/utils/prompt.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prompt.d.ts.map

package/dist/cli/utils/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/prompt.ts"],"names":[],"mappings":""}

package/dist/cli/utils/prompt.js

@@ -0,0 +1,4 @@
+export {};
+// Interactive input utilities
+// TODO: implement
+//# sourceMappingURL=prompt.js.map

package/dist/cli/utils/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/cli/utils/prompt.ts"],"names":[],"mappings":";AAAA,8BAA8B;AAC9B,kBAAkB"}

package/dist/cli/utils/update-checker.d.ts

@@ -0,0 +1,24 @@
+interface CheckForUpdateOptions {
+    /** 强制忽略缓存，始终尝试联网查询 */
+    readonly forceRefresh?: boolean;
+    /** 是否允许联网查询 npm registry */
+    readonly allowNetwork?: boolean;
+}
+/** 从 npm registry 查询最新版本 */
+export declare function fetchLatestVersion(): Promise<string | undefined>;
+/** 获取当前安装的版本 */
+export declare function getCurrentVersion(): string;
+export interface UpdateInfo {
+    readonly current: string;
+    readonly latest: string;
+    readonly hasUpdate: boolean;
+}
+/**
+ * 检查是否有新版本可用。
+ *
+ * 使用 24h 文件缓存避免频繁网络请求。
+ * 设计为不抛异常 — 任何失败静默返回无更新。
+ */
+export declare function checkForUpdate(options?: CheckForUpdateOptions): Promise<UpdateInfo>;
+export {};
+//# sourceMappingURL=update-checker.d.ts.map

package/dist/cli/utils/update-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-checker.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/update-checker.ts"],"names":[],"mappings":"AAwBA,UAAU,qBAAqB;IAC7B,sBAAsB;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,4BAA4B;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAyCD,4BAA4B;AAC5B,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAWtE;AAED,gBAAgB;AAChB,wBAAgB,iBAAiB,IAAI,MAAM,CAc1C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAiBD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,UAAU,CAAC,CA2CrB"}

package/dist/cli/utils/update-checker.js

@@ -0,0 +1,146 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { homedir } from "node:os";
+const execFileAsync = promisify(execFile);
+/** 缓存有效期：24 小时 */
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+/** 包名 */
+const PACKAGE_NAME = "@roll-agent/core";
+/** 缓存文件路径 */
+function getCachePath() {
+    return resolve(homedir(), ".roll-agent", "update-check.json");
+}
+function isUpdateCache(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    if (!("latestVersion" in value) || !("checkedAt" in value))
+        return false;
+    return (typeof value.latestVersion === "string" &&
+        typeof value.checkedAt === "number");
+}
+/** 读取缓存 */
+function readCache() {
+    const cachePath = getCachePath();
+    if (!existsSync(cachePath))
+        return undefined;
+    try {
+        const raw = readFileSync(cachePath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (isUpdateCache(parsed))
+            return parsed;
+    }
+    catch {
+        // 缓存损坏，忽略
+    }
+    return undefined;
+}
+/** 写入缓存 */
+function writeCache(latestVersion) {
+    try {
+        const cachePath = getCachePath();
+        const dir = dirname(cachePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        const cache = { latestVersion, checkedAt: Date.now() };
+        writeFileSync(cachePath, JSON.stringify(cache), "utf-8");
+    }
+    catch {
+        // 缓存写入失败不影响主流程
+    }
+}
+/** 从 npm registry 查询最新版本 */
+export async function fetchLatestVersion() {
+    try {
+        const { stdout } = await execFileAsync("npm", ["view", PACKAGE_NAME, "version"], {
+            timeout: 5000,
+            encoding: "utf-8",
+        });
+        const version = stdout.trim();
+        return version.length > 0 ? version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 获取当前安装的版本 */
+export function getCurrentVersion() {
+    // 从 package.json 读取，兼容开发和安装环境
+    try {
+        const pkgPath = resolve(import.meta.dirname, "../../../package.json");
+        const raw = readFileSync(pkgPath, "utf-8");
+        const pkg = JSON.parse(raw);
+        if (typeof pkg === "object" && pkg !== null && "version" in pkg) {
+            const version = pkg.version;
+            if (typeof version === "string")
+                return version;
+        }
+    }
+    catch {
+        // fallback
+    }
+    return "0.0.0";
+}
+/** 比较语义化版本，返回 a > b */
+function isNewerVersion(latest, current) {
+    const parse = (v) => v.replace(/^v/, "").split(".").map(Number);
+    const l = parse(latest);
+    const c = parse(current);
+    for (let i = 0; i < 3; i++) {
+        const lv = l[i] ?? 0;
+        const cv = c[i] ?? 0;
+        if (lv > cv)
+            return true;
+        if (lv < cv)
+            return false;
+    }
+    return false;
+}
+/**
+ * 检查是否有新版本可用。
+ *
+ * 使用 24h 文件缓存避免频繁网络请求。
+ * 设计为不抛异常 — 任何失败静默返回无更新。
+ */
+export async function checkForUpdate(options = {}) {
+    const forceRefresh = options.forceRefresh ?? false;
+    const allowNetwork = options.allowNetwork ?? true;
+    const current = getCurrentVersion();
+    const cache = readCache();
+    // 优先读缓存
+    if (!forceRefresh && cache && Date.now() - cache.checkedAt < CACHE_TTL_MS) {
+        return {
+            current,
+            latest: cache.latestVersion,
+            hasUpdate: isNewerVersion(cache.latestVersion, current),
+        };
+    }
+    if (!allowNetwork) {
+        if (cache) {
+            return {
+                current,
+                latest: cache.latestVersion,
+                hasUpdate: isNewerVersion(cache.latestVersion, current),
+            };
+        }
+        return { current, latest: current, hasUpdate: false };
+    }
+    // 缓存过期或不存在，查询 npm
+    const latest = await fetchLatestVersion();
+    if (latest) {
+        writeCache(latest);
+        return { current, latest, hasUpdate: isNewerVersion(latest, current) };
+    }
+    // 查询失败，使用旧缓存或返回无更新
+    if (cache) {
+        return {
+            current,
+            latest: cache.latestVersion,
+            hasUpdate: isNewerVersion(cache.latestVersion, current),
+        };
+    }
+    return { current, latest: current, hasUpdate: false };
+}
+//# sourceMappingURL=update-checker.js.map