@roll-agent/core 0.3.1 → 0.3.3

package/dist/cli/commands/agent-add.d.ts

@@ -18,4 +18,3 @@ declare const _default: import("citty").CommandDef<{
     };
 }>;
 export default _default;
-//# sourceMappingURL=agent-add.d.ts.map

package/dist/cli/commands/agent-add.js

@@ -1,166 +1 @@
-import { defineCommand } from "citty";
-import { resolve } from "node:path";
-import { existsSync, mkdirSync } from "node:fs";
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
-import { inspectAgentEnvRequirements } from "../../config/helpers.js";
-import { loadAgentsConfig } from "../../config/loader.js";
-import { discoverAgent } from "../../registry/discovery.js";
-import { writeRemoteSkillManifest } from "../../registry/manifest.js";
-import { AgentStore } from "../../registry/store.js";
-import { log } from "../utils/output.js";
-const execFileAsync = promisify(execFile);
-/** 判断输入是否为 Git URL */
-function isGitUrl(input) {
-    return (input.startsWith("https://") ||
-        input.startsWith("http://") ||
-        input.startsWith("git@") ||
-        input.endsWith(".git"));
-}
-/** 从 Git URL 中提取仓库名作为目录名 */
-function repoNameFromUrl(url) {
-    const last = url.split("/").pop() ?? url;
-    return last.replace(/\.git$/, "");
-}
-export default defineCommand({
-    meta: { description: "注册一个 Agent（本地路径、Git URL 或远程 endpoint）" },
-    args: {
-        path: { type: "positional", description: "Agent 本地路径或 Git URL", required: false },
-        remote: { type: "string", description: "远程 MCP endpoint（需配合 --name/--description）" },
-        name: { type: "string", description: "远程 Agent 名称" },
-        description: { type: "string", description: "远程 Agent 描述" },
-    },
-    async run({ args }) {
-        const { agentsConfig } = loadAgentsConfig();
-        let agentDir;
-        if (args.remote) {
-            if (!args.name || !args.description) {
-                log.error("远程注册需要同时提供 --name 和 --description");
-                process.exitCode = 1;
-                return;
-            }
-            agentDir = writeRemoteSkillManifest({
-                dataDir: agentsConfig.dataDir,
-                name: args.name,
-                description: args.description,
-                endpoint: args.remote,
-            });
-        }
-        else if (!args.path) {
-            log.error("请提供本地路径、Git URL，或使用 --remote <endpoint> 注册远程 Agent");
-            process.exitCode = 1;
-            return;
-        }
-        else if (isGitUrl(args.path)) {
-            // Git URL 模式：克隆到 dataDir 下
-            const repoName = repoNameFromUrl(args.path);
-            const cloneTarget = resolve(agentsConfig.dataDir, "repos", repoName);
-            if (existsSync(cloneTarget)) {
-                log.info(`仓库目录已存在，拉取最新代码: ${cloneTarget}`);
-                try {
-                    await execFileAsync("git", ["pull"], { cwd: cloneTarget });
-                }
-                catch (err) {
-                    log.error(`git pull 失败: ${err instanceof Error ? err.message : String(err)}`);
-                    process.exitCode = 1;
-                    return;
-                }
-            }
-            else {
-                log.info(`克隆 ${args.path}...`);
-                const parentDir = resolve(agentsConfig.dataDir, "repos");
-                if (!existsSync(parentDir)) {
-                    mkdirSync(parentDir, { recursive: true });
-                }
-                try {
-                    await execFileAsync("git", ["clone", args.path, cloneTarget]);
-                    log.success("克隆完成");
-                }
-                catch (err) {
-                    log.error(`git clone 失败: ${err instanceof Error ? err.message : String(err)}`);
-                    process.exitCode = 1;
-                    return;
-                }
-            }
-            agentDir = cloneTarget;
-        }
-        else {
-            agentDir = resolve(args.path);
-            if (!existsSync(agentDir)) {
-                log.error(`路径不存在: ${agentDir}`);
-                process.exitCode = 1;
-                return;
-            }
-        }
-        // 1. 解析 SKILL.md
-        log.info("解析 SKILL.md...");
-        const discovered = discoverAgent(agentDir);
-        log.debug(`名称: ${discovered.skill.name}`);
-        log.debug(`描述: ${discovered.skill.description}`);
-        log.debug(`传输: ${discovered.transport.type}`);
-        // 2. 安装依赖（如果存在 package.json）
-        const packageJsonPath = resolve(agentDir, "package.json");
-        const skipInstall = process.env["ROLL_SKIP_INSTALL"] === "1";
-        if (args.remote) {
-            log.info("远程 Agent 使用本地 manifest，无需安装依赖。");
-        }
-        else if (existsSync(packageJsonPath) && !skipInstall) {
-            log.info("安装依赖...");
-            try {
-                await execFileAsync("pnpm", ["install"], { cwd: agentDir });
-                log.success("依赖安装完成");
-            }
-            catch (err) {
-                log.error(`依赖安装失败: ${err instanceof Error ? err.message : ""}`);
-                process.exitCode = 1;
-                return;
-            }
-        }
-        else if (existsSync(packageJsonPath) && skipInstall) {
-            log.warn("检测到 ROLL_SKIP_INSTALL=1，跳过依赖安装。");
-        }
-        // 3. 确定 Agent 来源
-        const source = args.remote
-            ? { type: "remote-manifest", endpoint: args.remote }
-            : args.path && isGitUrl(args.path)
-                ? { type: "git", url: args.path }
-                : { type: "local-path", path: agentDir };
-        // 4. 注册到 store
-        const store = new AgentStore(agentsConfig.dataDir);
-        const agent = {
-            skill: discovered.skill,
-            transport: discovered.transport,
-            runtime: discovered.runtime,
-            installPath: agentDir,
-            registeredAt: new Date().toISOString(),
-            status: "idle",
-            source,
-            ...(discovered.skillBody.length > 0 ? { skillBody: discovered.skillBody } : {}),
-        };
-        try {
-            store.add(agent);
-            log.success(`Agent "${discovered.skill.name}" 注册成功`);
-            reportAgentEnvGuidance(discovered.skill.name, discovered.skill.env, agentsConfig.env);
-        }
-        catch (err) {
-            log.error(err instanceof Error ? err.message : String(err));
-            process.exitCode = 1;
-        }
-    },
-});
-function reportAgentEnvGuidance(agentName, envDeclarations, envMap) {
-    const envReport = inspectAgentEnvRequirements(agentName, envDeclarations, envMap);
-    if (!envReport) {
-        return;
-    }
-    if (envReport.missingRequired.length > 0) {
-        log.warn(`Agent "${agentName}" 仍缺少必填环境变量: ${envReport.missingRequired.map((item) => item.name).join(", ")}`);
-        log.info(`请在 roll.config.yaml 的 agents.env.${agentName} 中显式配置这些项。`);
-        return;
-    }
-    if (envReport.processEnvOnlyRequired.length > 0) {
-        log.warn(`Agent "${agentName}" 当前依赖 shell 环境变量: ${envReport.processEnvOnlyRequired.map((item) => item.name).join(", ")}`);
-        log.info(`建议将这些项写入 roll.config.yaml 的 agents.env.${agentName}。`);
-    }
-}
-//# sourceMappingURL=agent-add.js.map
+import{defineCommand as e}from"citty";import{resolve as t}from"node:path";import{existsSync as r,mkdirSync as i}from"node:fs";import{execFile as o}from"node:child_process";import{promisify as n}from"node:util";import{inspectAgentEnvRequirements as s}from"../../config/helpers.js";import{loadAgentsConfig as a}from"../../config/loader.js";import{discoverAgent as p}from"../../registry/discovery.js";import{writeRemoteSkillManifest as c}from"../../registry/manifest.js";import{AgentStore as d}from"../../registry/store.js";import{log as l}from"../utils/output.js";const m=n(o);function g(e){return e.startsWith("https://")||e.startsWith("http://")||e.startsWith("git@")||e.endsWith(".git")}function f(e){return(e.split("/").pop()??e).replace(/\.git$/,"")}export default e({meta:{description:"注册一个 Agent（本地路径、Git URL 或远程 endpoint）"},args:{path:{type:"positional",description:"Agent 本地路径或 Git URL",required:!1},remote:{type:"string",description:"远程 MCP endpoint（需配合 --name/--description）"},name:{type:"string",description:"远程 Agent 名称"},description:{type:"string",description:"远程 Agent 描述"}},async run({args:e}){const{agentsConfig:o}=a();let n;if(e.remote){if(!e.name||!e.description)return l.error("远程注册需要同时提供 --name 和 --description"),void(process.exitCode=1);n=c({dataDir:o.dataDir,name:e.name,description:e.description,endpoint:e.remote})}else{if(!e.path)return l.error("请提供本地路径、Git URL，或使用 --remote <endpoint> 注册远程 Agent"),void(process.exitCode=1);if(g(e.path)){const s=f(e.path),a=t(o.dataDir,"repos",s);if(r(a)){l.info(`仓库目录已存在，拉取最新代码: ${a}`);try{await m("git",["pull"],{cwd:a})}catch(e){return l.error(`git pull 失败: ${e instanceof Error?e.message:String(e)}`),void(process.exitCode=1)}}else{l.info(`克隆 ${e.path}...`);const n=t(o.dataDir,"repos");r(n)||i(n,{recursive:!0});try{await m("git",["clone",e.path,a]),l.success("克隆完成")}catch(e){return l.error(`git clone 失败: ${e instanceof Error?e.message:String(e)}`),void(process.exitCode=1)}}n=a}else if(n=t(e.path),!r(n))return l.error(`路径不存在: ${n}`),void(process.exitCode=1)}l.info("解析 SKILL.md...");const s=p(n);l.debug(`名称: ${s.skill.name}`),l.debug(`描述: ${s.skill.description}`),l.debug(`传输: ${s.transport.type}`);const h=t(n,"package.json"),y="1"===process.env.ROLL_SKIP_INSTALL;if(e.remote)l.info("远程 Agent 使用本地 manifest，无需安装依赖。");else if(r(h)&&!y){l.info("安装依赖...");try{await m("pnpm",["install"],{cwd:n}),l.success("依赖安装完成")}catch(e){return l.error(`依赖安装失败: ${e instanceof Error?e.message:""}`),void(process.exitCode=1)}}else r(h)&&y&&l.warn("检测到 ROLL_SKIP_INSTALL=1，跳过依赖安装。");const v=e.remote?{type:"remote-manifest",endpoint:e.remote}:e.path&&g(e.path)?{type:"git",url:e.path}:{type:"local-path",path:n},$=new d(o.dataDir),L={skill:s.skill,transport:s.transport,runtime:s.runtime,installPath:n,registeredAt:(new Date).toISOString(),status:"idle",source:v,...s.skillBody.length>0?{skillBody:s.skillBody}:{}};try{$.add(L),l.success(`Agent "${s.skill.name}" 注册成功`),u(s.skill.name,s.skill.env,o.env)}catch(e){l.error(e instanceof Error?e.message:String(e)),process.exitCode=1}}});function u(e,t,r){const i=s(e,t,r);if(i)return i.missingRequired.length>0?(l.warn(`Agent "${e}" 仍缺少必填环境变量: ${i.missingRequired.map(e=>e.name).join(", ")}`),void l.info(`请在 roll.config.yaml 的 agents.env.${e} 中显式配置这些项。`)):void(i.processEnvOnlyRequired.length>0&&(l.warn(`Agent "${e}" 当前依赖 shell 环境变量: ${i.processEnvOnlyRequired.map(e=>e.name).join(", ")}`),l.info(`建议将这些项写入 roll.config.yaml 的 agents.env.${e}。`)))}

package/dist/cli/commands/agent-health.d.ts

@@ -11,4 +11,3 @@ declare const _default: import("citty").CommandDef<{
     };
 }>;
 export default _default;
-//# sourceMappingURL=agent-health.d.ts.map

package/dist/cli/commands/agent-health.js

@@ -1,131 +1 @@
-import { defineCommand } from "citty";
-import { loadAgentsConfig } from "../../config/loader.js";
-import { getAgentLogPath, getAgentPid, probeAgentEndpoint } from "../../registry/process-manager.js";
-import { AgentStore } from "../../registry/store.js";
-import { log } from "../utils/output.js";
-export default defineCommand({
-    meta: { description: "检查 Agent 健康状态（兼容 on-demand / core-managed / external-managed）" },
-    args: {
-        restart: {
-            type: "boolean",
-            description: "兼容旧参数，stdio 按需模式下不生效",
-            default: false,
-        },
-        json: { type: "boolean", description: "JSON 格式输出", default: false },
-    },
-    async run({ args }) {
-        const { agentsConfig } = loadAgentsConfig();
-        const store = new AgentStore(agentsConfig.dataDir);
-        const agents = store.list();
-        if (args.restart) {
-            log.warn("`--restart` 仅为兼容保留参数；v1 不执行自动重启逻辑。");
-        }
-        if (agents.length === 0) {
-            if (args.json) {
-                console.log("[]");
-                return;
-            }
-            log.info("暂无已注册 Agent。");
-            return;
-        }
-        const results = [];
-        for (const agent of agents) {
-            results.push(await checkAgentHealth(agent, store, agentsConfig.dataDir));
-        }
-        const unhealthy = results.filter((result) => !result.healthy);
-        if (args.json) {
-            console.log(JSON.stringify(results, null, 2));
-            if (unhealthy.length > 0) {
-                process.exitCode = 1;
-            }
-            return;
-        }
-        for (const result of results) {
-            if (result.healthy) {
-                log.success(`${result.agentName} [${result.transport}]: ${result.message}`);
-            }
-            else {
-                log.error(`${result.agentName} [${result.transport}]: ${result.message}`);
-            }
-        }
-        if (unhealthy.length > 0) {
-            process.exitCode = 1;
-        }
-    },
-});
-async function checkAgentHealth(agent, store, dataDir) {
-    switch (agent.runtime.ownership) {
-        case "on-demand":
-            return {
-                agentName: agent.skill.name,
-                transport: agent.transport.type,
-                healthy: true,
-                message: "按需模式：无需常驻进程，由 run/ask 在调用时启动",
-            };
-        case "external-managed":
-            return checkExternalManagedHealth(agent, store);
-        case "core-managed":
-            return checkCoreManagedHealth(agent, store, dataDir);
-    }
-}
-async function checkExternalManagedHealth(agent, store) {
-    try {
-        await probeAgentEndpoint(agent, { timeoutMs: 5_000 });
-        store.updateStatus(agent.skill.name, "online");
-        return {
-            agentName: agent.skill.name,
-            transport: agent.transport.type,
-            healthy: true,
-            message: agent.transport.type === "streamable-http"
-                ? `外部服务可连接 (${agent.transport.endpoint})`
-                : "外部服务可连接",
-        };
-    }
-    catch (err) {
-        store.updateStatus(agent.skill.name, "error");
-        return {
-            agentName: agent.skill.name,
-            transport: agent.transport.type,
-            healthy: false,
-            message: agent.transport.type === "streamable-http"
-                ? `外部服务不可连接 (${agent.transport.endpoint}): ${err instanceof Error ? err.message : String(err)}`
-                : `外部服务不可连接: ${err instanceof Error ? err.message : String(err)}`,
-        };
-    }
-}
-async function checkCoreManagedHealth(agent, store, dataDir) {
-    const pid = getAgentPid(dataDir, agent.skill.name);
-    if (pid === undefined) {
-        store.updateStatus(agent.skill.name, "stopped");
-        return {
-            agentName: agent.skill.name,
-            transport: agent.transport.type,
-            healthy: false,
-            message: `未运行（缺少活动 PID）。日志: ${getAgentLogPath(dataDir, agent.skill.name)}`,
-        };
-    }
-    try {
-        await probeAgentEndpoint(agent, { timeoutMs: 5_000 });
-        store.updateStatus(agent.skill.name, "online");
-        return {
-            agentName: agent.skill.name,
-            transport: agent.transport.type,
-            healthy: true,
-            message: agent.transport.type === "streamable-http"
-                ? `运行中 (PID: ${String(pid)})，可连接 (${agent.transport.endpoint})`
-                : `运行中 (PID: ${String(pid)})`,
-        };
-    }
-    catch (err) {
-        store.updateStatus(agent.skill.name, "error");
-        return {
-            agentName: agent.skill.name,
-            transport: agent.transport.type,
-            healthy: false,
-            message: agent.transport.type === "streamable-http"
-                ? `进程存在但不可连接 (${agent.transport.endpoint}): ${err instanceof Error ? err.message : String(err)}。日志: ${getAgentLogPath(dataDir, agent.skill.name)}`
-                : `进程存在但不可连接: ${err instanceof Error ? err.message : String(err)}。日志: ${getAgentLogPath(dataDir, agent.skill.name)}`,
-        };
-    }
-}
-//# sourceMappingURL=agent-health.js.map
+import{defineCommand as t}from"citty";import{loadAgentsConfig as e}from"../../config/loader.js";import{getAgentLogPath as r,getAgentPid as a,probeAgentEndpoint as n}from"../../registry/process-manager.js";import{AgentStore as s}from"../../registry/store.js";import{log as o}from"../utils/output.js";export default t({meta:{description:"检查 Agent 健康状态（兼容 on-demand / core-managed / external-managed）"},args:{restart:{type:"boolean",description:"兼容旧参数，stdio 按需模式下不生效",default:!1},json:{type:"boolean",description:"JSON 格式输出",default:!1}},async run({args:t}){const{agentsConfig:r}=e(),a=new s(r.dataDir),n=a.list();if(t.restart&&o.warn("`--restart` 仅为兼容保留参数；v1 不执行自动重启逻辑。"),0===n.length)return t.json?void console.log("[]"):void o.info("暂无已注册 Agent。");const l=[];for(const t of n)l.push(await i(t,a,r.dataDir));const p=l.filter(t=>!t.healthy);if(t.json)return console.log(JSON.stringify(l,null,2)),void(p.length>0&&(process.exitCode=1));for(const t of l)t.healthy?o.success(`${t.agentName} [${t.transport}]: ${t.message}`):o.error(`${t.agentName} [${t.transport}]: ${t.message}`);p.length>0&&(process.exitCode=1)}});async function i(t,e,r){switch(t.runtime.ownership){case"on-demand":return{agentName:t.skill.name,transport:t.transport.type,healthy:!0,message:"按需模式：无需常驻进程，由 run/ask 在调用时启动"};case"external-managed":return l(t,e);case"core-managed":return p(t,e,r)}}async function l(t,e){try{return await n(t,{timeoutMs:5e3}),e.updateStatus(t.skill.name,"online"),{agentName:t.skill.name,transport:t.transport.type,healthy:!0,message:"streamable-http"===t.transport.type?`外部服务可连接 (${t.transport.endpoint})`:"外部服务可连接"}}catch(r){return e.updateStatus(t.skill.name,"error"),{agentName:t.skill.name,transport:t.transport.type,healthy:!1,message:"streamable-http"===t.transport.type?`外部服务不可连接 (${t.transport.endpoint}): ${r instanceof Error?r.message:String(r)}`:`外部服务不可连接: ${r instanceof Error?r.message:String(r)}`}}}async function p(t,e,s){const o=a(s,t.skill.name);if(void 0===o)return e.updateStatus(t.skill.name,"stopped"),{agentName:t.skill.name,transport:t.transport.type,healthy:!1,message:`未运行（缺少活动 PID）。日志: ${r(s,t.skill.name)}`};try{return await n(t,{timeoutMs:5e3}),e.updateStatus(t.skill.name,"online"),{agentName:t.skill.name,transport:t.transport.type,healthy:!0,message:"streamable-http"===t.transport.type?`运行中 (PID: ${String(o)})，可连接 (${t.transport.endpoint})`:`运行中 (PID: ${String(o)})`}}catch(a){return e.updateStatus(t.skill.name,"error"),{agentName:t.skill.name,transport:t.transport.type,healthy:!1,message:"streamable-http"===t.transport.type?`进程存在但不可连接 (${t.transport.endpoint}): ${a instanceof Error?a.message:String(a)}。日志: ${r(s,t.skill.name)}`:`进程存在但不可连接: ${a instanceof Error?a.message:String(a)}。日志: ${r(s,t.skill.name)}`}}}

package/dist/cli/commands/agent-info.d.ts

@@ -6,4 +6,3 @@ declare const _default: import("citty").CommandDef<{
     };
 }>;
 export default _default;
-//# sourceMappingURL=agent-info.d.ts.map

package/dist/cli/commands/agent-info.js

@@ -1,57 +1 @@
-import { defineCommand } from "citty";
-import { loadAgentsConfig } from "../../config/loader.js";
-import { inspectAgentEnvRequirements } from "../../config/helpers.js";
-import { formatAgentSourceType, getAgentLocation, inferAgentSourceType, } from "../../registry/source.js";
-import { AgentStore } from "../../registry/store.js";
-export default defineCommand({
-    meta: { description: "查看 Agent 详情" },
-    args: {
-        name: { type: "positional", description: "Agent 名称", required: true },
-    },
-    run({ args }) {
-        const { agentsConfig } = loadAgentsConfig();
-        const store = new AgentStore(agentsConfig.dataDir);
-        const agent = store.findByName(args.name);
-        if (!agent) {
-            console.error(`✗ Agent "${args.name}" 未找到`);
-            process.exitCode = 1;
-            return;
-        }
-        console.log(`名称:     ${agent.skill.name}`);
-        console.log(`描述:     ${agent.skill.description}`);
-        console.log(`状态:     ${agent.status}`);
-        console.log(`来源:     ${formatAgentSourceType(inferAgentSourceType(agent))}`);
-        console.log(`传输:     ${agent.transport.type}`);
-        console.log(`位置:     ${getAgentLocation(agent)}`);
-        console.log(`注册时间: ${agent.registeredAt}`);
-        if (agent.source?.type === "installed-package") {
-            console.log(`安装包:   ${agent.source.packageSpec}`);
-            console.log(`安装目录: ${agent.source.installDir}`);
-        }
-        if (Object.keys(agent.skill.metadata).length > 0) {
-            console.log(`元数据:`);
-            for (const [key, value] of Object.entries(agent.skill.metadata)) {
-                console.log(`  ${key}: ${value}`);
-            }
-        }
-        const envReport = inspectAgentEnvRequirements(agent.skill.name, agent.skill.env, agentsConfig.env);
-        if (envReport) {
-            console.log(`环境变量:`);
-            for (const item of envReport.items) {
-                const status = item.source === "agents.env"
-                    ? "已配置于 agents.env"
-                    : item.source === "process.env"
-                        ? "仅当前 shell 环境"
-                        : item.source === "default"
-                            ? `默认值 (${item.default})`
-                            : "缺失";
-                const level = item.required ? "必填" : "可选";
-                console.log(`  ${item.name}: [${level}] ${status}`);
-                if (item.purpose) {
-                    console.log(`    用途: ${item.purpose}`);
-                }
-            }
-        }
-    },
-});
-//# sourceMappingURL=agent-info.js.map
+import{defineCommand as o}from"citty";import{loadAgentsConfig as e}from"../../config/loader.js";import{inspectAgentEnvRequirements as s}from"../../config/helpers.js";import{formatAgentSourceType as l,getAgentLocation as n,inferAgentSourceType as r}from"../../registry/source.js";import{AgentStore as t}from"../../registry/store.js";export default o({meta:{description:"查看 Agent 详情"},args:{name:{type:"positional",description:"Agent 名称",required:!0}},run({args:o}){const{agentsConfig:c}=e(),i=new t(c.dataDir).findByName(o.name);if(!i)return console.error(`✗ Agent "${o.name}" 未找到`),void(process.exitCode=1);if(console.log(`名称:     ${i.skill.name}`),console.log(`描述:     ${i.skill.description}`),console.log(`状态:     ${i.status}`),console.log(`来源:     ${l(r(i))}`),console.log(`传输:     ${i.transport.type}`),console.log(`位置:     ${n(i)}`),console.log(`注册时间: ${i.registeredAt}`),"installed-package"===i.source?.type&&(console.log(`安装包:   ${i.source.packageSpec}`),console.log(`安装目录: ${i.source.installDir}`)),Object.keys(i.skill.metadata).length>0){console.log("元数据:");for(const[o,e]of Object.entries(i.skill.metadata))console.log(`  ${o}: ${e}`)}const a=s(i.skill.name,i.skill.env,c.env);if(a){console.log("环境变量:");for(const o of a.items){const e="agents.env"===o.source?"已配置于 agents.env":"process.env"===o.source?"仅当前 shell 环境":"default"===o.source?`默认值 (${o.default})`:"缺失",s=o.required?"必填":"可选";console.log(`  ${o.name}: [${s}] ${e}`),o.purpose&&console.log(`    用途: ${o.purpose}`)}}}});

package/dist/cli/commands/agent-install.d.ts

@@ -16,4 +16,3 @@ declare const _default: import("citty").CommandDef<{
     };
 }>;
 export default _default;
-//# sourceMappingURL=agent-install.d.ts.map

package/dist/cli/commands/agent-install.js

@@ -1,173 +1 @@
-import { defineCommand } from "citty";
-import { existsSync, mkdirSync, statSync } from "node:fs";
-import { resolve } from "node:path";
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
-import { inspectAgentEnvRequirements } from "../../config/helpers.js";
-import { loadAgentsConfig } from "../../config/loader.js";
-import { discoverAgent } from "../../registry/discovery.js";
-import { startAgent, stopAgentGracefully, waitForAgentReady, } from "../../registry/process-manager.js";
-import { runAgentSetup } from "../../registry/runtime-setup.js";
-import { AgentStore } from "../../registry/store.js";
-import { parsePackageName, resolveInstalledPackageRoot, sanitizeInstallId, } from "../../registry/source.js";
-import { log } from "../utils/output.js";
-const execFileAsync = promisify(execFile);
-function isGitUrl(input) {
-    return (input.startsWith("git@") ||
-        input.startsWith("git+") ||
-        input.startsWith("github:") ||
-        input.startsWith("gitlab:") ||
-        input.startsWith("bitbucket:") ||
-        input.endsWith(".git"));
-}
-export default defineCommand({
-    meta: { description: "安装已编译的 Agent 包并注册到本地" },
-    args: {
-        package: { type: "positional", description: "npm package spec", required: true },
-        skipBrowserSetup: {
-            type: "boolean",
-            description: "跳过浏览器运行时安装",
-            default: false,
-        },
-        noStart: {
-            type: "boolean",
-            description: "安装后不自动启动 core-managed Agent",
-            default: false,
-        },
-    },
-    async run({ args }) {
-        const { agentsConfig } = loadAgentsConfig();
-        const packageSpec = args.package;
-        if (isGitUrl(packageSpec)) {
-            log.error(`Git URL 请使用 \`roll agent add ${packageSpec}\` 注册，不要使用 \`roll agent install\``);
-            process.exitCode = 1;
-            return;
-        }
-        const resolvedInputPath = resolve(packageSpec);
-        if (existsSync(resolvedInputPath) && statSync(resolvedInputPath).isDirectory()) {
-            log.error(`本地源码目录请使用 \`roll agent add ${packageSpec}\` 注册，不要使用 \`roll agent install\``);
-            process.exitCode = 1;
-            return;
-        }
-        const packageName = parsePackageName(packageSpec);
-        const installDir = resolve(agentsConfig.dataDir, "installed", sanitizeInstallId(packageName));
-        if (!existsSync(installDir)) {
-            mkdirSync(installDir, { recursive: true });
-        }
-        log.info(`安装 ${packageSpec}...`);
-        try {
-            await execFileAsync("npm", ["install", "--prefix", installDir, packageSpec], {
-                timeout: 120_000,
-            });
-        }
-        catch (err) {
-            log.error(`安装失败: ${err instanceof Error ? err.message : String(err)}`);
-            process.exitCode = 1;
-            return;
-        }
-        const packageRoot = resolveInstalledPackageRoot(installDir, packageName);
-        if (!existsSync(packageRoot)) {
-            log.error(`安装完成但未找到包目录: ${packageRoot}`);
-            process.exitCode = 1;
-            return;
-        }
-        log.info("解析已安装 Agent 的 SKILL.md...");
-        const discovered = discoverAgent(packageRoot);
-        const store = new AgentStore(agentsConfig.dataDir);
-        const agent = {
-            skill: discovered.skill,
-            transport: discovered.transport,
-            runtime: discovered.runtime,
-            installPath: packageRoot,
-            registeredAt: new Date().toISOString(),
-            status: "idle",
-            source: {
-                type: "installed-package",
-                packageName,
-                packageSpec,
-                installDir,
-            },
-            ...(discovered.skillBody.length > 0 ? { skillBody: discovered.skillBody } : {}),
-        };
-        if (agent.runtime.ownership === "core-managed" &&
-            agent.runtime.setup?.playwright &&
-            !args.skipBrowserSetup) {
-            log.info(`即将安装浏览器运行时 (${agent.runtime.setup.playwright.browsers.join(", ")})，这可能需要一些时间...`);
-        }
-        const setupResult = await runAgentSetup(agent, {
-            skipBrowserSetup: args.skipBrowserSetup,
-        });
-        if (!setupResult.ok) {
-            log.warn(`Agent setup 失败：${setupResult.message}`);
-            if (setupResult.retryCommand) {
-                log.info(`重试命令: ${setupResult.retryCommand}`);
-            }
-        }
-        else if (!setupResult.skipped) {
-            log.success(setupResult.message);
-        }
-        else {
-            log.info(setupResult.message);
-        }
-        const existing = store.findByName(discovered.skill.name);
-        try {
-            const wasRunning = existing?.runtime.ownership === "core-managed" &&
-                existing.status === "online";
-            if (existing?.source?.type === "installed-package") {
-                store.replace(existing.skill.name, agent);
-            }
-            else {
-                store.add(agent);
-            }
-            if (!setupResult.ok) {
-                store.updateStatus(discovered.skill.name, "error");
-                process.exitCode = 1;
-                return;
-            }
-            if (agent.runtime.ownership === "core-managed" && !args.noStart) {
-                if (wasRunning) {
-                    await stopAgentGracefully(agentsConfig.dataDir, agent.skill.name);
-                }
-                store.updateStatus(agent.skill.name, "starting");
-                let started = false;
-                try {
-                    startAgent(agent, agentsConfig.dataDir);
-                    started = true;
-                    await waitForAgentReady(agent, { startupTimeoutMs: 15_000, probeTimeoutMs: 2_000 });
-                    store.updateStatus(agent.skill.name, "online");
-                }
-                catch (err) {
-                    if (started) {
-                        await stopAgentGracefully(agentsConfig.dataDir, agent.skill.name).catch(() => { });
-                    }
-                    store.updateStatus(agent.skill.name, "error");
-                    log.error(`Agent "${discovered.skill.name}" 已安装，但自动启动失败：${err instanceof Error ? err.message : String(err)}`);
-                    process.exitCode = 1;
-                    return;
-                }
-            }
-            log.success(`Agent "${discovered.skill.name}" 安装并注册成功`);
-            reportAgentEnvGuidance(discovered.skill.name, discovered.skill.env, agentsConfig.env);
-        }
-        catch (err) {
-            log.error(err instanceof Error ? err.message : String(err));
-            process.exitCode = 1;
-        }
-    },
-});
-function reportAgentEnvGuidance(agentName, envDeclarations, envMap) {
-    const envReport = inspectAgentEnvRequirements(agentName, envDeclarations, envMap);
-    if (!envReport) {
-        return;
-    }
-    if (envReport.missingRequired.length > 0) {
-        log.warn(`Agent "${agentName}" 仍缺少必填环境变量: ${envReport.missingRequired.map((item) => item.name).join(", ")}`);
-        log.info(`请在 roll.config.yaml 的 agents.env.${agentName} 中显式配置这些项。`);
-        return;
-    }
-    if (envReport.processEnvOnlyRequired.length > 0) {
-        log.warn(`Agent "${agentName}" 当前依赖 shell 环境变量: ${envReport.processEnvOnlyRequired.map((item) => item.name).join(", ")}`);
-        log.info(`建议将这些项写入 roll.config.yaml 的 agents.env.${agentName}。`);
-    }
-}
-//# sourceMappingURL=agent-install.js.map
+import{defineCommand as e}from"citty";import{existsSync as t,mkdirSync as r,statSync as i}from"node:fs";import{resolve as s}from"node:path";import{execFile as o}from"node:child_process";import{promisify as n}from"node:util";import{inspectAgentEnvRequirements as a}from"../../config/helpers.js";import{loadAgentsConfig as l}from"../../config/loader.js";import{discoverAgent as p}from"../../registry/discovery.js";import{startAgent as m,stopAgentGracefully as c,waitForAgentReady as d}from"../../registry/process-manager.js";import{runAgentSetup as g}from"../../registry/runtime-setup.js";import{AgentStore as u}from"../../registry/store.js";import{parsePackageName as f,resolveInstalledPackageRoot as k,sanitizeInstallId as y}from"../../registry/source.js";import{log as h}from"../utils/output.js";const w=n(o);function S(e){return e.startsWith("git@")||e.startsWith("git+")||e.startsWith("github:")||e.startsWith("gitlab:")||e.startsWith("bitbucket:")||e.endsWith(".git")}export default e({meta:{description:"安装已编译的 Agent 包并注册到本地"},args:{package:{type:"positional",description:"npm package spec",required:!0},skipBrowserSetup:{type:"boolean",description:"跳过浏览器运行时安装",default:!1},noStart:{type:"boolean",description:"安装后不自动启动 core-managed Agent",default:!1}},async run({args:e}){const{agentsConfig:o}=l(),n=e.package;if(S(n))return h.error(`Git URL 请使用 \`roll agent add ${n}\` 注册，不要使用 \`roll agent install\``),void(process.exitCode=1);const a=s(n);if(t(a)&&i(a).isDirectory())return h.error(`本地源码目录请使用 \`roll agent add ${n}\` 注册，不要使用 \`roll agent install\``),void(process.exitCode=1);const v=f(n),j=s(o.dataDir,"installed",y(v));t(j)||r(j,{recursive:!0}),h.info(`安装 ${n}...`);try{await w("npm",["install","--prefix",j,n],{timeout:12e4})}catch(e){return h.error(`安装失败: ${e instanceof Error?e.message:String(e)}`),void(process.exitCode=1)}const C=k(j,v);if(!t(C))return h.error(`安装完成但未找到包目录: ${C}`),void(process.exitCode=1);h.info("解析已安装 Agent 的 SKILL.md...");const x=p(C),A=new u(o.dataDir),b={skill:x.skill,transport:x.transport,runtime:x.runtime,installPath:C,registeredAt:(new Date).toISOString(),status:"idle",source:{type:"installed-package",packageName:v,packageSpec:n,installDir:j},...x.skillBody.length>0?{skillBody:x.skillBody}:{}};"core-managed"===b.runtime.ownership&&b.runtime.setup?.playwright&&!e.skipBrowserSetup&&h.info(`即将安装浏览器运行时 (${b.runtime.setup.playwright.browsers.join(", ")})，这可能需要一些时间...`);const B=await g(b,{skipBrowserSetup:e.skipBrowserSetup});B.ok?B.skipped?h.info(B.message):h.success(B.message):(h.warn(`Agent setup 失败：${B.message}`),B.retryCommand&&h.info(`重试命令: ${B.retryCommand}`));const D=A.findByName(x.skill.name);try{const t="core-managed"===D?.runtime.ownership&&"online"===D.status;if("installed-package"===D?.source?.type?A.replace(D.skill.name,b):A.add(b),!B.ok)return A.updateStatus(x.skill.name,"error"),void(process.exitCode=1);if("core-managed"===b.runtime.ownership&&!e.noStart){t&&await c(o.dataDir,b.skill.name),A.updateStatus(b.skill.name,"starting");let e=!1;try{m(b,o.dataDir),e=!0,await d(b,{startupTimeoutMs:15e3,probeTimeoutMs:2e3}),A.updateStatus(b.skill.name,"online")}catch(t){return e&&await c(o.dataDir,b.skill.name).catch(()=>{}),A.updateStatus(b.skill.name,"error"),h.error(`Agent "${x.skill.name}" 已安装，但自动启动失败：${t instanceof Error?t.message:String(t)}`),void(process.exitCode=1)}}h.success(`Agent "${x.skill.name}" 安装并注册成功`),$(x.skill.name,x.skill.env,o.env)}catch(e){h.error(e instanceof Error?e.message:String(e)),process.exitCode=1}}});function $(e,t,r){const i=a(e,t,r);if(i)return i.missingRequired.length>0?(h.warn(`Agent "${e}" 仍缺少必填环境变量: ${i.missingRequired.map(e=>e.name).join(", ")}`),void h.info(`请在 roll.config.yaml 的 agents.env.${e} 中显式配置这些项。`)):void(i.processEnvOnlyRequired.length>0&&(h.warn(`Agent "${e}" 当前依赖 shell 环境变量: ${i.processEnvOnlyRequired.map(e=>e.name).join(", ")}`),h.info(`建议将这些项写入 roll.config.yaml 的 agents.env.${e}。`)))}

package/dist/cli/commands/agent-list.d.ts

@@ -6,4 +6,3 @@ declare const _default: import("citty").CommandDef<{
     };
 }>;
 export default _default;
-//# sourceMappingURL=agent-list.d.ts.map

package/dist/cli/commands/agent-list.js

@@ -1,39 +1 @@
-import { defineCommand } from "citty";
-import Table from "cli-table3";
-import { loadAgentsConfig } from "../../config/loader.js";
-import { formatAgentSourceType, getAgentLocation, inferAgentSourceType, } from "../../registry/source.js";
-import { AgentStore } from "../../registry/store.js";
-export default defineCommand({
-    meta: { description: "列出所有已注册 Agent" },
-    args: {
-        json: { type: "boolean", description: "JSON 格式输出", default: false },
-    },
-    run({ args }) {
-        const { agentsConfig } = loadAgentsConfig();
-        const store = new AgentStore(agentsConfig.dataDir);
-        const agents = store.list();
-        if (args.json) {
-            console.log(JSON.stringify(agents, null, 2));
-            return;
-        }
-        if (agents.length === 0) {
-            console.log("暂无已注册的 Agent。可使用 `roll agent add <path>`、`roll agent install <package>` 或 `roll agent add --remote <endpoint>`。");
-            return;
-        }
-        const table = new Table({
-            head: ["Name", "Status", "Source", "Transport", "Location"],
-            style: { head: ["cyan"] },
-        });
-        for (const agent of agents) {
-            table.push([
-                agent.skill.name,
-                agent.status,
-                formatAgentSourceType(inferAgentSourceType(agent)),
-                agent.transport.type,
-                getAgentLocation(agent),
-            ]);
-        }
-        console.log(table.toString());
-    },
-});
-//# sourceMappingURL=agent-list.js.map
+import{defineCommand as o}from"citty";import t from"cli-table3";import{loadAgentsConfig as r}from"../../config/loader.js";import{formatAgentSourceType as e,getAgentLocation as n,inferAgentSourceType as s}from"../../registry/source.js";import{AgentStore as a}from"../../registry/store.js";export default o({meta:{description:"列出所有已注册 Agent"},args:{json:{type:"boolean",description:"JSON 格式输出",default:!1}},run({args:o}){const{agentsConfig:i}=r(),l=new a(i.dataDir).list();if(o.json)return void console.log(JSON.stringify(l,null,2));if(0===l.length)return void console.log("暂无已注册的 Agent。可使用 `roll agent add <path>`、`roll agent install <package>` 或 `roll agent add --remote <endpoint>`。");const g=new t({head:["Name","Status","Source","Transport","Location"],style:{head:["cyan"]}});for(const o of l)g.push([o.skill.name,o.status,e(s(o)),o.transport.type,n(o)]);console.log(g.toString())}});

package/dist/cli/commands/agent-remove.d.ts

@@ -6,4 +6,3 @@ declare const _default: import("citty").CommandDef<{
     };
 }>;
 export default _default;
-//# sourceMappingURL=agent-remove.d.ts.map