@roll-agent/core 0.3.1 → 0.3.3

package/dist/registry/discovery.js

@@ -1,313 +1 @@
-import { readFileSync, existsSync, realpathSync } from "node:fs";
-import { resolve, sep } from "node:path";
-import matter from "gray-matter";
-import { z } from "zod";
-import { parse as parseYaml } from "yaml";
-import { createDefaultRuntimeForTransport } from "../types/agent.js";
-/** SKILL.md 文件名 */
-const SKILL_FILE_NAME = "SKILL.md";
-const PACKAGE_JSON_FILE_NAME = "package.json";
-const skillEnvDeclarationSchema = z.object({
-    name: z.string().min(1),
-    purpose: z.string().optional(),
-    example: z.string().optional(),
-    default: z.string().optional(),
-});
-const skillEnvDeclarationsSchema = z.object({
-    required: z.array(skillEnvDeclarationSchema).optional(),
-    optional: z.array(skillEnvDeclarationSchema).optional(),
-});
-/**
- * 解析指定目录下的 SKILL.md，提取 Agent 描述和传输配置。
- *
- * @throws 找不到 SKILL.md 或缺少必需字段时抛出错误
- */
-export function discoverAgent(agentDir) {
-    const absDir = resolve(agentDir);
-    const skillPath = resolve(absDir, SKILL_FILE_NAME);
-    if (!existsSync(skillPath)) {
-        throw new Error(`SKILL.md not found in ${absDir}`);
-    }
-    const raw = readFileSync(skillPath, "utf-8");
-    const { data, content: skillBody } = matter(raw);
-    const manifest = readRollAgentManifest(absDir);
-    // 校验必需字段
-    const frontmatter = data;
-    const name = frontmatter["name"];
-    const description = frontmatter["description"];
-    if (typeof name !== "string" || name.length === 0) {
-        throw new Error(`SKILL.md missing required field "name" in ${skillPath}`);
-    }
-    if (typeof description !== "string" || description.length === 0) {
-        throw new Error(`SKILL.md missing required field "description" in ${skillPath}`);
-    }
-    // 提取 metadata
-    const rawMetadata = (frontmatter["metadata"] ?? {});
-    const metadata = {};
-    for (const [key, value] of Object.entries(rawMetadata)) {
-        metadata[key] = String(value);
-    }
-    const license = typeof frontmatter["license"] === "string" ? frontmatter["license"] : undefined;
-    const compatibility = typeof frontmatter["compatibility"] === "string" ? frontmatter["compatibility"] : undefined;
-    const env = loadSkillEnv(absDir, metadata, skillPath);
-    const skill = {
-        name,
-        description,
-        ...(license ? { license } : {}),
-        ...(compatibility ? { compatibility } : {}),
-        metadata,
-        ...(env ? { env } : {}),
-    };
-    const manifestResolution = manifest ? resolveRuntimeFromManifest(manifest) : undefined;
-    if (manifestResolution && hasLegacyRuntimeMetadata(metadata)) {
-        const legacyTransport = resolveTransport(metadata);
-        if (!sameTransport(legacyTransport, manifestResolution.transport)) {
-            throw new Error(`Conflicting runtime metadata in ${skillPath}: package.json#rollAgent and SKILL.md metadata disagree`);
-        }
-    }
-    const transport = manifestResolution?.transport ?? resolveTransport(metadata);
-    const runtime = manifestResolution?.runtime ?? createDefaultRuntimeForTransport(transport);
-    return { skill, transport, runtime, skillPath, skillBody: skillBody.trim() };
-}
-function normalizeSkillEnv(value, skillPath) {
-    if (value === undefined) {
-        return undefined;
-    }
-    const parsed = skillEnvDeclarationsSchema.safeParse(value);
-    if (!parsed.success) {
-        const issues = parsed.error.issues
-            .map((issue) => {
-            const path = issue.path.length > 0 ? `env.${issue.path.join(".")}` : "env";
-            return `${path}: ${issue.message}`;
-        })
-            .join("; ");
-        throw new Error(`SKILL.md has invalid "env" declaration in ${skillPath}: ${issues}`);
-    }
-    const env = parsed.data;
-    if (!env.required && !env.optional) {
-        return undefined;
-    }
-    return {
-        ...(env.required ? { required: env.required.map(normalizeParsedSkillEnvDeclaration) } : {}),
-        ...(env.optional ? { optional: env.optional.map(normalizeParsedSkillEnvDeclaration) } : {}),
-    };
-}
-function loadSkillEnv(agentDir, metadata, skillPath) {
-    const envFile = metadata["roll-env-file"];
-    if (!envFile) {
-        return undefined;
-    }
-    const envPath = resolve(agentDir, envFile);
-    if (!isPathInside(agentDir, envPath)) {
-        throw new Error(`SKILL.md roll-env-file must stay within agent directory: ${skillPath}`);
-    }
-    if (!existsSync(envPath)) {
-        throw new Error(`SKILL.md roll-env-file not found: ${envPath}`);
-    }
-    const realAgentDir = realpathSync(agentDir);
-    const realEnvPath = realpathSync(envPath);
-    if (!isPathInside(realAgentDir, realEnvPath)) {
-        throw new Error(`SKILL.md roll-env-file must stay within agent directory: ${skillPath}`);
-    }
-    let parsed;
-    try {
-        parsed = parseYaml(readFileSync(realEnvPath, "utf-8"));
-    }
-    catch (error) {
-        throw new Error(`Failed to parse roll-env-file for ${skillPath}: ${error instanceof Error ? error.message : String(error)}`);
-    }
-    return normalizeSkillEnv(parsed, realEnvPath);
-}
-function isPathInside(rootDir, targetPath) {
-    return targetPath === rootDir || targetPath.startsWith(`${rootDir}${sep}`);
-}
-function normalizeParsedSkillEnvDeclaration(value) {
-    return {
-        name: value.name,
-        ...(value.purpose ? { purpose: value.purpose } : {}),
-        ...(value.example ? { example: value.example } : {}),
-        ...(value.default ? { default: value.default } : {}),
-    };
-}
-/** 根据 SKILL.md metadata 确定传输模式 */
-function resolveTransport(meta) {
-    const rawTransport = meta["roll-transport"];
-    const transportType = rawTransport === "streamable-http" ? "streamable-http" : "stdio";
-    if (transportType === "streamable-http") {
-        const endpoint = meta["roll-endpoint"];
-        if (!endpoint) {
-            throw new Error(`SKILL.md declares streamable-http transport but missing "roll-endpoint"`);
-        }
-        return { type: "streamable-http", endpoint };
-    }
-    // stdio 模式：使用 roll-command 或默认 node 启动
-    const command = meta["roll-command"] ?? "node --experimental-strip-types src/index.ts";
-    const parts = command.split(/\s+/);
-    const executable = parts[0];
-    const args = parts.slice(1);
-    if (!executable) {
-        throw new Error(`Invalid roll-command in SKILL.md`);
-    }
-    if (args.length > 0) {
-        return { type: "stdio", command: executable, args };
-    }
-    return { type: "stdio", command: executable };
-}
-function readRollAgentManifest(agentDir) {
-    const packageJsonPath = resolve(agentDir, PACKAGE_JSON_FILE_NAME);
-    if (!existsSync(packageJsonPath)) {
-        return undefined;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
-    }
-    catch {
-        throw new Error(`Invalid package.json in ${agentDir}`);
-    }
-    if (!isJsonRecord(parsed) || !isJsonRecord(parsed["rollAgent"])) {
-        return undefined;
-    }
-    const rollAgent = parsed["rollAgent"];
-    const runtime = isJsonRecord(rollAgent["runtime"]) ? rollAgent["runtime"] : undefined;
-    if (!runtime) {
-        throw new Error(`package.json#rollAgent.runtime is required in ${packageJsonPath}`);
-    }
-    const manifest = {
-        runtime: {
-            ownership: readString(runtime["ownership"]) ?? "",
-            transport: readString(runtime["transport"]) ?? "",
-        },
-    };
-    if (isJsonRecord(rollAgent["start"])) {
-        const command = readString(rollAgent["start"]["command"]);
-        const args = normalizeStringArray(rollAgent["start"]["args"]);
-        if (command || args) {
-            manifest.start = {
-                ...(command ? { command } : {}),
-                ...(args ? { args } : {}),
-            };
-        }
-    }
-    if (isJsonRecord(rollAgent["endpoint"])) {
-        const url = readString(rollAgent["endpoint"]["url"]);
-        const path = readString(rollAgent["endpoint"]["path"]);
-        const port = typeof rollAgent["endpoint"]["port"] === "number" ? rollAgent["endpoint"]["port"] : undefined;
-        if (url || path || port !== undefined) {
-            manifest.endpoint = {
-                ...(url ? { url } : {}),
-                ...(path ? { path } : {}),
-                ...(port !== undefined ? { port } : {}),
-            };
-        }
-    }
-    if (isJsonRecord(rollAgent["setup"]) && isJsonRecord(rollAgent["setup"]["playwright"])) {
-        const browsers = normalizeStringArray(rollAgent["setup"]["playwright"]["browsers"]);
-        if (browsers && browsers.length > 0) {
-            manifest.setup = {
-                playwright: {
-                    browsers,
-                },
-            };
-        }
-    }
-    return manifest;
-}
-function resolveRuntimeFromManifest(manifest) {
-    const { ownership, transport } = manifest.runtime;
-    if (ownership === "on-demand" && transport === "stdio") {
-        const command = manifest.start?.command;
-        if (!command) {
-            throw new Error(`package.json#rollAgent.start.command is required for stdio runtime`);
-        }
-        const args = manifest.start?.args;
-        return {
-            transport: args ? { type: "stdio", command, args } : { type: "stdio", command },
-            runtime: { ownership: "on-demand" },
-        };
-    }
-    if (ownership === "core-managed" && transport === "streamable-http") {
-        const command = manifest.start?.command;
-        const endpoint = resolveManifestHttpEndpoint(manifest);
-        const path = manifest.endpoint?.path;
-        const port = manifest.endpoint?.port;
-        if (!command || !path || port === undefined) {
-            throw new Error(`package.json#rollAgent for core-managed streamable-http requires start.command, endpoint.path and endpoint.port`);
-        }
-        const args = manifest.start?.args;
-        const setupBrowsers = manifest.setup?.playwright?.browsers;
-        return {
-            transport: {
-                type: "streamable-http",
-                endpoint,
-            },
-            runtime: {
-                ownership: "core-managed",
-                start: args ? { command, args } : { command },
-                endpoint: { path, port },
-                ...(setupBrowsers && setupBrowsers.length > 0
-                    ? { setup: { playwright: { browsers: setupBrowsers } } }
-                    : {}),
-            },
-        };
-    }
-    if (ownership === "external-managed" && transport === "streamable-http") {
-        return {
-            transport: {
-                type: "streamable-http",
-                endpoint: resolveManifestHttpEndpoint(manifest),
-            },
-            runtime: { ownership: "external-managed" },
-        };
-    }
-    throw new Error(`Unsupported package.json#rollAgent runtime combination: ${ownership}/${transport}`);
-}
-function resolveManifestHttpEndpoint(manifest) {
-    const url = manifest.endpoint?.url;
-    if (url) {
-        return url;
-    }
-    const path = manifest.endpoint?.path;
-    const port = manifest.endpoint?.port;
-    if (!path || port === undefined) {
-        throw new Error(`package.json#rollAgent.streamable-http requires endpoint.url or endpoint.path + endpoint.port`);
-    }
-    return buildLocalHttpEndpoint(path, port);
-}
-function buildLocalHttpEndpoint(path, port) {
-    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
-    return `http://127.0.0.1:${String(port)}${normalizedPath}`;
-}
-function hasLegacyRuntimeMetadata(meta) {
-    return (typeof meta["roll-transport"] === "string" ||
-        typeof meta["roll-endpoint"] === "string" ||
-        typeof meta["roll-command"] === "string");
-}
-function sameTransport(left, right) {
-    if (left.type !== right.type) {
-        return false;
-    }
-    if (left.type === "streamable-http" && right.type === "streamable-http") {
-        return left.endpoint === right.endpoint;
-    }
-    if (left.type !== "stdio" || right.type !== "stdio") {
-        return false;
-    }
-    const leftArgs = left.args ?? [];
-    const rightArgs = right.args ?? [];
-    return left.command === right.command && leftArgs.join("\u0000") === rightArgs.join("\u0000");
-}
-function readString(value) {
-    return typeof value === "string" && value.length > 0 ? value : undefined;
-}
-function normalizeStringArray(value) {
-    if (!Array.isArray(value)) {
-        return undefined;
-    }
-    const next = value.filter((entry) => typeof entry === "string");
-    return next.length > 0 ? next : undefined;
-}
-function isJsonRecord(value) {
-    return typeof value === "object" && value !== null;
-}
-//# sourceMappingURL=discovery.js.map
+import{readFileSync as t,existsSync as r,realpathSync as n}from"node:fs";import{resolve as e,sep as o}from"node:path";import i from"gray-matter";import{z as a}from"zod";import{parse as s}from"yaml";import{createDefaultRuntimeForTransport as p}from"../types/agent.js";const d="SKILL.md",l="package.json",m=a.object({name:a.string().min(1),purpose:a.string().optional(),example:a.string().optional(),default:a.string().optional()}),c=a.object({required:a.array(m).optional(),optional:a.array(m).optional()});export function discoverAgent(n){const o=e(n),a=e(o,d);if(!r(a))throw new Error(`SKILL.md not found in ${o}`);const s=t(a,"utf-8"),{data:l,content:m}=i(s),c=y(o),u=l,g=u.name,h=u.description;if("string"!=typeof g||0===g.length)throw new Error(`SKILL.md missing required field "name" in ${a}`);if("string"!=typeof h||0===h.length)throw new Error(`SKILL.md missing required field "description" in ${a}`);const v=u.metadata??{},$={};for(const[t,r]of Object.entries(v))$[t]=String(r);const j="string"==typeof u.license?u.license:void 0,S="string"==typeof u.compatibility?u.compatibility:void 0,I=f(o,$,a),k={name:g,description:h,...j?{license:j}:{},...S?{compatibility:S}:{},metadata:$,...I?{env:I}:{}},q=c?b(c):void 0;if(q&&L($)){if(!E(w($),q.transport))throw new Error(`Conflicting runtime metadata in ${a}: package.json#rollAgent and SKILL.md metadata disagree`)}const A=q?.transport??w($);return{skill:k,transport:A,runtime:q?.runtime??p(A),skillPath:a,skillBody:m.trim()}}function u(t,r){if(void 0===t)return;const n=c.safeParse(t);if(!n.success){const t=n.error.issues.map(t=>`${t.path.length>0?`env.${t.path.join(".")}`:"env"}: ${t.message}`).join("; ");throw new Error(`SKILL.md has invalid "env" declaration in ${r}: ${t}`)}const e=n.data;return e.required||e.optional?{...e.required?{required:e.required.map(h)}:{},...e.optional?{optional:e.optional.map(h)}:{}}:void 0}function f(o,i,a){const p=i["roll-env-file"];if(!p)return;const d=e(o,p);if(!g(o,d))throw new Error(`SKILL.md roll-env-file must stay within agent directory: ${a}`);if(!r(d))throw new Error(`SKILL.md roll-env-file not found: ${d}`);const l=n(o),m=n(d);if(!g(l,m))throw new Error(`SKILL.md roll-env-file must stay within agent directory: ${a}`);let c;try{c=s(t(m,"utf-8"))}catch(t){throw new Error(`Failed to parse roll-env-file for ${a}: ${t instanceof Error?t.message:String(t)}`)}return u(c,m)}function g(t,r){return r===t||r.startsWith(`${t}${o}`)}function h(t){return{name:t.name,...t.purpose?{purpose:t.purpose}:{},...t.example?{example:t.example}:{},...t.default?{default:t.default}:{}}}function w(t){if("streamable-http"===("streamable-http"===t["roll-transport"]?"streamable-http":"stdio")){const r=t["roll-endpoint"];if(!r)throw new Error('SKILL.md declares streamable-http transport but missing "roll-endpoint"');return{type:"streamable-http",endpoint:r}}const r=(t["roll-command"]??"node --experimental-strip-types src/index.ts").split(/\s+/),n=r[0],e=r.slice(1);if(!n)throw new Error("Invalid roll-command in SKILL.md");return e.length>0?{type:"stdio",command:n,args:e}:{type:"stdio",command:n}}function y(n){const o=e(n,l);if(!r(o))return;let i;try{i=JSON.parse(t(o,"utf-8"))}catch{throw new Error(`Invalid package.json in ${n}`)}if(!I(i)||!I(i.rollAgent))return;const a=i.rollAgent,s=I(a.runtime)?a.runtime:void 0;if(!s)throw new Error(`package.json#rollAgent.runtime is required in ${o}`);const p={runtime:{ownership:j(s.ownership)??"",transport:j(s.transport)??""}};if(I(a.start)){const t=j(a.start.command),r=S(a.start.args);(t||r)&&(p.start={...t?{command:t}:{},...r?{args:r}:{}})}if(I(a.endpoint)){const t=j(a.endpoint.url),r=j(a.endpoint.path),n="number"==typeof a.endpoint.port?a.endpoint.port:void 0;(t||r||void 0!==n)&&(p.endpoint={...t?{url:t}:{},...r?{path:r}:{},...void 0!==n?{port:n}:{}})}if(I(a.setup)&&I(a.setup.playwright)){const t=S(a.setup.playwright.browsers);t&&t.length>0&&(p.setup={playwright:{browsers:t}})}return p}function b(t){const{ownership:r,transport:n}=t.runtime;if("on-demand"===r&&"stdio"===n){const r=t.start?.command;if(!r)throw new Error("package.json#rollAgent.start.command is required for stdio runtime");const n=t.start?.args;return{transport:n?{type:"stdio",command:r,args:n}:{type:"stdio",command:r},runtime:{ownership:"on-demand"}}}if("core-managed"===r&&"streamable-http"===n){const r=t.start?.command,n=v(t),e=t.endpoint?.path,o=t.endpoint?.port;if(!r||!e||void 0===o)throw new Error("package.json#rollAgent for core-managed streamable-http requires start.command, endpoint.path and endpoint.port");const i=t.start?.args,a=t.setup?.playwright?.browsers;return{transport:{type:"streamable-http",endpoint:n},runtime:{ownership:"core-managed",start:i?{command:r,args:i}:{command:r},endpoint:{path:e,port:o},...a&&a.length>0?{setup:{playwright:{browsers:a}}}:{}}}}if("external-managed"===r&&"streamable-http"===n)return{transport:{type:"streamable-http",endpoint:v(t)},runtime:{ownership:"external-managed"}};throw new Error(`Unsupported package.json#rollAgent runtime combination: ${r}/${n}`)}function v(t){const r=t.endpoint?.url;if(r)return r;const n=t.endpoint?.path,e=t.endpoint?.port;if(!n||void 0===e)throw new Error("package.json#rollAgent.streamable-http requires endpoint.url or endpoint.path + endpoint.port");return $(n,e)}function $(t,r){const n=t.startsWith("/")?t:`/${t}`;return`http://127.0.0.1:${String(r)}${n}`}function L(t){return"string"==typeof t["roll-transport"]||"string"==typeof t["roll-endpoint"]||"string"==typeof t["roll-command"]}function E(t,r){if(t.type!==r.type)return!1;if("streamable-http"===t.type&&"streamable-http"===r.type)return t.endpoint===r.endpoint;if("stdio"!==t.type||"stdio"!==r.type)return!1;const n=t.args??[],e=r.args??[];return t.command===r.command&&n.join("\0")===e.join("\0")}function j(t){return"string"==typeof t&&t.length>0?t:void 0}function S(t){if(!Array.isArray(t))return;const r=t.filter(t=>"string"==typeof t);return r.length>0?r:void 0}function I(t){return"object"==typeof t&&null!==t}

package/dist/registry/health-check.d.ts

@@ -16,4 +16,3 @@ export declare function checkAgentHealth(store: AgentStore, dataDir: string, opt
     readonly autoRestart: boolean;
     readonly agentEnvMap?: Readonly<Record<string, Readonly<Record<string, string>>>>;
 }): ReadonlyArray<HealthCheckResult>;
-//# sourceMappingURL=health-check.d.ts.map

package/dist/registry/health-check.js

@@ -1,65 +1 @@
-import { getAgentPid, startAgent } from "./process-manager.js";
-/**
- * 检查所有状态为 "online" 的 Agent 是否仍在运行。
- *
- * - 如果进程已死且 autoRestart 为 true，尝试自动重启
- * - 更新 store 中的 Agent 状态
- */
-export function checkAgentHealth(store, dataDir, options = { autoRestart: false }) {
-    const agents = store.list();
-    const results = [];
-    for (const agent of agents) {
-        // 只检查 stdio 模式且预期在线的 Agent
-        if (agent.transport.type !== "stdio" || agent.status !== "online") {
-            continue;
-        }
-        const pid = getAgentPid(dataDir, agent.skill.name);
-        if (pid !== undefined) {
-            results.push({
-                agentName: agent.skill.name,
-                healthy: true,
-                restarted: false,
-                message: `运行中 (PID: ${String(pid)})`,
-            });
-            continue;
-        }
-        // 进程已死
-        if (options.autoRestart) {
-            const restarted = tryRestart(agent, store, dataDir, options.agentEnvMap?.[agent.skill.name]);
-            results.push(restarted);
-        }
-        else {
-            store.updateStatus(agent.skill.name, "error");
-            results.push({
-                agentName: agent.skill.name,
-                healthy: false,
-                restarted: false,
-                message: "进程已退出，状态更新为 error",
-            });
-        }
-    }
-    return results;
-}
-/** 尝试重启 Agent */
-function tryRestart(agent, store, dataDir, env) {
-    try {
-        const newPid = startAgent(agent, dataDir, env);
-        store.updateStatus(agent.skill.name, "online");
-        return {
-            agentName: agent.skill.name,
-            healthy: true,
-            restarted: true,
-            message: `已自动重启 (PID: ${String(newPid)})`,
-        };
-    }
-    catch (err) {
-        store.updateStatus(agent.skill.name, "error");
-        return {
-            agentName: agent.skill.name,
-            healthy: false,
-            restarted: false,
-            message: `重启失败: ${err instanceof Error ? err.message : String(err)}`,
-        };
-    }
-}
-//# sourceMappingURL=health-check.js.map
+import{getAgentPid as e,startAgent as t}from"./process-manager.js";export function checkAgentHealth(t,s,n={autoRestart:!1}){const r=t.list(),l=[];for(const o of r){if("stdio"!==o.transport.type||"online"!==o.status)continue;const r=e(s,o.skill.name);if(void 0===r)if(n.autoRestart){const e=a(o,t,s,n.agentEnvMap?.[o.skill.name]);l.push(e)}else t.updateStatus(o.skill.name,"error"),l.push({agentName:o.skill.name,healthy:!1,restarted:!1,message:"进程已退出，状态更新为 error"});else l.push({agentName:o.skill.name,healthy:!0,restarted:!1,message:`运行中 (PID: ${String(r)})`})}return l}function a(e,a,s,n){try{const r=t(e,s,n);return a.updateStatus(e.skill.name,"online"),{agentName:e.skill.name,healthy:!0,restarted:!0,message:`已自动重启 (PID: ${String(r)})`}}catch(t){return a.updateStatus(e.skill.name,"error"),{agentName:e.skill.name,healthy:!1,restarted:!1,message:`重启失败: ${t instanceof Error?t.message:String(t)}`}}}

package/dist/registry/index.d.ts

@@ -4,4 +4,3 @@ export { AgentStore } from "./store.ts";
 export { startAgent, stopAgent, stopAgentGracefully, getAgentPid, getAgentLogPath, probeAgentEndpoint, waitForAgentReady, } from "./process-manager.ts";
 export { runAgentSetup } from "./runtime-setup.ts";
 export type { AgentSetupOptions, AgentSetupResult } from "./runtime-setup.ts";
-//# sourceMappingURL=index.d.ts.map

package/dist/registry/index.js

@@ -1,5 +1 @@
-export { discoverAgent } from "./discovery.js";
-export { AgentStore } from "./store.js";
-export { startAgent, stopAgent, stopAgentGracefully, getAgentPid, getAgentLogPath, probeAgentEndpoint, waitForAgentReady, } from "./process-manager.js";
-export { runAgentSetup } from "./runtime-setup.js";
-//# sourceMappingURL=index.js.map
+export{discoverAgent}from"./discovery.js";export{AgentStore}from"./store.js";export{startAgent,stopAgent,stopAgentGracefully,getAgentPid,getAgentLogPath,probeAgentEndpoint,waitForAgentReady}from"./process-manager.js";export{runAgentSetup}from"./runtime-setup.js";

package/dist/registry/manifest.d.ts

@@ -6,4 +6,3 @@ export interface RemoteManifestInput {
 }
 /** 为远程 MCP Agent 生成本地 manifest 目录，便于后续统一管理。 */
 export declare function writeRemoteSkillManifest(input: RemoteManifestInput): string;
-//# sourceMappingURL=manifest.d.ts.map

package/dist/registry/manifest.js

@@ -1,24 +1 @@
-import { mkdirSync, writeFileSync } from "node:fs";
-import { resolve } from "node:path";
-import { sanitizeInstallId } from "./source.js";
-function yamlString(value) {
-    return JSON.stringify(value);
-}
-/** 为远程 MCP Agent 生成本地 manifest 目录，便于后续统一管理。 */
-export function writeRemoteSkillManifest(input) {
-    const targetDir = resolve(input.dataDir, "remote", sanitizeInstallId(input.name));
-    mkdirSync(targetDir, { recursive: true });
-    const skillMd = `---
-name: ${yamlString(input.name)}
-description: ${yamlString(input.description)}
-metadata:
-  roll-transport: streamable-http
-  roll-endpoint: ${yamlString(input.endpoint)}
----
-
-Remote MCP Agent registered via \`roll agent add --remote\`.
-`;
-    writeFileSync(resolve(targetDir, "SKILL.md"), skillMd, "utf-8");
-    return targetDir;
-}
-//# sourceMappingURL=manifest.js.map
+import{mkdirSync as t,writeFileSync as e}from"node:fs";import{resolve as n}from"node:path";import{sanitizeInstallId as r}from"./source.js";function o(t){return JSON.stringify(t)}export function writeRemoteSkillManifest(i){const a=n(i.dataDir,"remote",r(i.name));t(a,{recursive:!0});const m=`---\nname: ${o(i.name)}\ndescription: ${o(i.description)}\nmetadata:\n  roll-transport: streamable-http\n  roll-endpoint: ${o(i.endpoint)}\n---\n\nRemote MCP Agent registered via \`roll agent add --remote\`.\n`;return e(n(a,"SKILL.md"),m,"utf-8"),a}

package/dist/registry/process-manager.d.ts

@@ -26,4 +26,3 @@ export declare function stopAgentGracefully(dataDir: string, agentName: string,
     readonly timeoutMs?: number;
     readonly intervalMs?: number;
 }): Promise<boolean>;
-//# sourceMappingURL=process-manager.d.ts.map

package/dist/registry/process-manager.js

@@ -1,204 +1 @@
-import { spawn } from "node:child_process";
-import { closeSync, existsSync, mkdirSync, openSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
-import { resolve, dirname, basename } from "node:path";
-import { McpClientManager } from "../mcp/client-manager.js";
-/** PID 文件存放目录 */
-function pidFilePath(dataDir, agentName) {
-    return resolve(dataDir, "pids", `${agentName}.pid`);
-}
-function removePidFile(dataDir, agentName) {
-    const pidFile = pidFilePath(dataDir, agentName);
-    if (existsSync(pidFile)) {
-        unlinkSync(pidFile);
-    }
-}
-/** Agent 日志文件路径 */
-export function getAgentLogPath(dataDir, agentName) {
-    return resolve(dataDir, "logs", `${agentName}.log`);
-}
-/** 检查进程是否仍在运行 */
-function isProcessAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/** 读取 Agent 的 PID，如果不存在或进程已死则返回 undefined */
-export function getAgentPid(dataDir, agentName) {
-    const pidFile = pidFilePath(dataDir, agentName);
-    if (!existsSync(pidFile))
-        return undefined;
-    const pid = Number(readFileSync(pidFile, "utf-8").trim());
-    if (Number.isNaN(pid) || !isProcessAlive(pid)) {
-        // 清理过期的 PID 文件
-        removePidFile(dataDir, agentName);
-        return undefined;
-    }
-    return pid;
-}
-/** 检查 core-managed Agent 对应的 MCP endpoint 是否已就绪。 */
-export async function probeAgentEndpoint(agent, options = {}) {
-    const clientManager = new McpClientManager();
-    try {
-        const client = await clientManager.connect(agent.skill.name, agent.transport, agent.installPath, options.timeoutMs !== undefined ? { timeoutMs: options.timeoutMs } : {});
-        await client.listTools();
-    }
-    finally {
-        await clientManager.disconnectAll();
-    }
-}
-/** 轮询等待 Agent MCP endpoint 就绪。 */
-export async function waitForAgentReady(agent, options = {}) {
-    const startupTimeoutMs = options.startupTimeoutMs ?? 15_000;
-    const probeTimeoutMs = options.probeTimeoutMs ?? 2_000;
-    const intervalMs = options.intervalMs ?? 500;
-    const deadline = Date.now() + startupTimeoutMs;
-    let lastError;
-    while (Date.now() < deadline) {
-        try {
-            await probeAgentEndpoint(agent, { timeoutMs: probeTimeoutMs });
-            return;
-        }
-        catch (err) {
-            lastError = err;
-            await sleep(intervalMs);
-        }
-    }
-    throw new Error(`Agent "${agent.skill.name}" did not become ready within ${startupTimeoutMs}ms${lastError ? `: ${lastError instanceof Error ? lastError.message : String(lastError)}` : ""}`);
-}
-/**
- * 启动一个 Agent 为后台进程（detached）。
- *
- * - `stdio + on-demand`：保留给旧健康检查逻辑使用
- * - `streamable-http + core-managed`：作为本地常驻后台服务启动
- */
-export function startAgent(agent, dataDir, env) {
-    if (agent.transport.type === "streamable-http" && agent.runtime.ownership !== "core-managed") {
-        throw new Error(`Agent "${agent.skill.name}" 使用 streamable-http 传输且非 core-managed，请手动启动服务。` +
-            `\n  端点: ${agent.transport.endpoint}`);
-    }
-    const existingPid = getAgentPid(dataDir, agent.skill.name);
-    if (existingPid !== undefined) {
-        throw new Error(`Agent "${agent.skill.name}" 已在运行 (PID: ${String(existingPid)})`);
-    }
-    const spawnSpec = resolveSpawnSpec(agent);
-    const logPath = getAgentLogPath(dataDir, agent.skill.name);
-    const logDir = dirname(logPath);
-    if (!existsSync(logDir)) {
-        mkdirSync(logDir, { recursive: true });
-    }
-    const logFd = openSync(logPath, "a");
-    const child = spawn(spawnSpec.command, [...(spawnSpec.args ?? [])], {
-        cwd: agent.installPath,
-        detached: true,
-        stdio: ["ignore", logFd, logFd],
-        ...(env ? { env: { ...process.env, ...env } } : {}),
-    });
-    closeSync(logFd);
-    child.unref();
-    if (!child.pid) {
-        throw new Error(`Failed to start agent "${agent.skill.name}"`);
-    }
-    // 写入 PID 文件
-    const pidFile = pidFilePath(dataDir, agent.skill.name);
-    const pidDir = dirname(pidFile);
-    if (!existsSync(pidDir)) {
-        mkdirSync(pidDir, { recursive: true });
-    }
-    writeFileSync(pidFile, String(child.pid), "utf-8");
-    return child.pid;
-}
-/** 停止一个后台运行的 Agent */
-export function stopAgent(dataDir, agentName) {
-    const pid = getAgentPid(dataDir, agentName);
-    if (pid === undefined)
-        return false;
-    try {
-        process.kill(pid, "SIGTERM");
-    }
-    catch {
-        // 进程可能已退出
-    }
-    // 清理 PID 文件
-    removePidFile(dataDir, agentName);
-    return true;
-}
-export async function stopAgentGracefully(dataDir, agentName, options = {}) {
-    const pid = getAgentPid(dataDir, agentName);
-    if (pid === undefined)
-        return false;
-    try {
-        process.kill(pid, "SIGTERM");
-    }
-    catch {
-        removePidFile(dataDir, agentName);
-        return true;
-    }
-    const timeoutMs = options.timeoutMs ?? 15_000;
-    const intervalMs = options.intervalMs ?? 200;
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-        if (!isProcessAlive(pid)) {
-            removePidFile(dataDir, agentName);
-            return true;
-        }
-        await sleep(intervalMs);
-    }
-    throw new Error(`Agent "${agentName}" did not stop within ${timeoutMs}ms`);
-}
-function resolveSpawnSpec(agent) {
-    if (agent.transport.type === "stdio") {
-        return {
-            command: agent.transport.command,
-            ...(agent.transport.args ? { args: agent.transport.args } : {}),
-        };
-    }
-    if (agent.runtime.ownership === "core-managed") {
-        const fallbackSpec = resolveManagedDevSpawnSpec(agent);
-        if (fallbackSpec) {
-            return fallbackSpec;
-        }
-        return {
-            command: agent.runtime.start.command,
-            ...(agent.runtime.start.args ? { args: agent.runtime.start.args } : {}),
-        };
-    }
-    throw new Error(`Agent "${agent.skill.name}" does not have a managed runtime start command`);
-}
-function resolveManagedDevSpawnSpec(agent) {
-    if (agent.runtime.ownership !== "core-managed" ||
-        !isNodeCommand(agent.runtime.start.command) ||
-        !agent.runtime.start.args ||
-        agent.runtime.start.args.length !== 1) {
-        return undefined;
-    }
-    if (agent.source?.type === "installed-package" || agent.source?.type === "remote-manifest") {
-        return undefined;
-    }
-    const [entryArg] = agent.runtime.start.args;
-    if (!entryArg?.startsWith("dist/") || !entryArg.endsWith(".js")) {
-        return undefined;
-    }
-    const sourceEntry = entryArg.replace(/^dist\//, "src/").replace(/\.js$/, ".ts");
-    if (!existsSync(resolve(agent.installPath, sourceEntry))) {
-        return undefined;
-    }
-    // Local-path / git development sources may not have dist built yet.
-    return {
-        command: agent.runtime.start.command,
-        args: ["--experimental-strip-types", sourceEntry],
-    };
-}
-function isNodeCommand(command) {
-    const normalized = basename(command).toLowerCase();
-    return command === "node" || normalized === "node" || normalized === "node.exe";
-}
-function sleep(ms) {
-    return new Promise((resolve) => {
-        setTimeout(resolve, ms);
-    });
-}
-//# sourceMappingURL=process-manager.js.map
+import{spawn as t}from"node:child_process";import{closeSync as n,existsSync as r,mkdirSync as e,openSync as o,readFileSync as i,unlinkSync as a,writeFileSync as s}from"node:fs";import{resolve as c,dirname as m}from"node:path";import{McpClientManager as u}from"../mcp/client-manager.js";import{resolveDevSpawnSpec as p}from"./dev-spawn.js";import{inferAgentSourceType as l}from"./source.js";function d(t,n){return c(t,"pids",`${n}.pid`)}function g(t,n){const e=d(t,n);r(e)&&a(e)}export function getAgentLogPath(t,n){return c(t,"logs",`${n}.log`)}function f(t){try{return process.kill(t,0),!0}catch{return!1}}export function getAgentPid(t,n){const e=d(t,n);if(!r(e))return;const o=Number(i(e,"utf-8").trim());if(!Number.isNaN(o)&&f(o))return o;g(t,n)}export async function probeAgentEndpoint(t,n={}){const r=new u;try{const e=await r.connect(t.skill.name,t.transport,t.installPath,void 0!==n.timeoutMs?{timeoutMs:n.timeoutMs}:{});await e.listTools()}finally{await r.disconnectAll()}}export async function waitForAgentReady(t,n={}){const r=n.startupTimeoutMs??15e3,e=n.probeTimeoutMs??2e3,o=n.intervalMs??500,i=Date.now()+r;let a;for(;Date.now()<i;)try{return void await probeAgentEndpoint(t,{timeoutMs:e})}catch(t){a=t,await h(o)}throw new Error(`Agent "${t.skill.name}" did not become ready within ${r}ms${a?`: ${a instanceof Error?a.message:String(a)}`:""}`)}export function startAgent(i,a,c){if("streamable-http"===i.transport.type&&"core-managed"!==i.runtime.ownership)throw new Error(`Agent "${i.skill.name}" 使用 streamable-http 传输且非 core-managed，请手动启动服务。\n  端点: ${i.transport.endpoint}`);const u=getAgentPid(a,i.skill.name);if(void 0!==u)throw new Error(`Agent "${i.skill.name}" 已在运行 (PID: ${String(u)})`);const p=w(i),l=getAgentLogPath(a,i.skill.name),g=m(l);r(g)||e(g,{recursive:!0});const f=o(l,"a"),h=t(p.command,[...p.args??[]],{cwd:i.installPath,detached:!0,stdio:["ignore",f,f],...c?{env:{...process.env,...c}}:{}});if(n(f),h.unref(),!h.pid)throw new Error(`Failed to start agent "${i.skill.name}"`);const A=d(a,i.skill.name),y=m(A);return r(y)||e(y,{recursive:!0}),s(A,String(h.pid),"utf-8"),h.pid}export function stopAgent(t,n){const r=getAgentPid(t,n);if(void 0===r)return!1;try{process.kill(r,"SIGTERM")}catch{}return g(t,n),!0}export async function stopAgentGracefully(t,n,r={}){const e=getAgentPid(t,n);if(void 0===e)return!1;try{process.kill(e,"SIGTERM")}catch{return g(t,n),!0}const o=r.timeoutMs??15e3,i=r.intervalMs??200,a=Date.now()+o;for(;Date.now()<a;){if(!f(e))return g(t,n),!0;await h(i)}throw new Error(`Agent "${n}" did not stop within ${o}ms`)}function w(t){if("stdio"===t.transport.type){const n=p(t.transport.command,t.transport.args,t.installPath,l(t));return n||{command:t.transport.command,...t.transport.args?{args:t.transport.args}:{}}}if("core-managed"===t.runtime.ownership){const n=p(t.runtime.start.command,t.runtime.start.args,t.installPath,l(t));return n||{command:t.runtime.start.command,...t.runtime.start.args?{args:t.runtime.start.args}:{}}}throw new Error(`Agent "${t.skill.name}" does not have a managed runtime start command`)}function h(t){return new Promise(n=>{setTimeout(n,t)})}

package/dist/registry/runtime-setup.d.ts

@@ -9,4 +9,3 @@ export interface AgentSetupResult {
     readonly retryCommand?: string;
 }
 export declare function runAgentSetup(agent: RegisteredAgent, options?: AgentSetupOptions): Promise<AgentSetupResult>;
-//# sourceMappingURL=runtime-setup.d.ts.map