@roll-agent/core 0.1.1

package/dist/mcp/client-manager.js

@@ -0,0 +1,79 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { registerSamplingHandler } from "./sampling-handler.js";
+/** 默认连接超时（毫秒） */
+const DEFAULT_CONNECT_TIMEOUT_MS = 30_000;
+/**
+ * MCP Client Manager — 管理到子 Agent MCP Server 的连接。
+ *
+ * 支持两种传输模式：
+ * - stdio：spawn 子进程，通过 stdin/stdout 通信
+ * - streamable-http：连接到远程 HTTP MCP Server
+ *
+ * 连接按 agent name 缓存复用，disconnect 时清理。
+ */
+export class McpClientManager {
+    connections = new Map();
+    /**
+     * 获取或创建到指定 Agent 的 MCP 连接。
+     *
+     * @param cwd 仅 stdio 模式使用，作为子进程工作目录
+     */
+    async connect(agentName, transport, cwd, options = {}) {
+        const existing = this.connections.get(agentName);
+        if (existing) {
+            return existing.client;
+        }
+        const timeoutMs = options.timeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS;
+        const samplingCapabilities = options.samplingModel ? { sampling: {} } : {};
+        const client = new Client({ name: `roll-client-${agentName}`, version: "0.0.1" }, { capabilities: samplingCapabilities });
+        // 注册 Sampling Handler（子 Agent 可通过 createMessage 使用指挥官 LLM）
+        if (options.samplingModel) {
+            registerSamplingHandler(client, options.samplingModel);
+        }
+        // 创建 MCP 传输（强制转换为 Transport 以绕过 exactOptionalPropertyTypes 与库类型的不兼容）
+        const mcpTransport = transport.type === "streamable-http"
+            ? new StreamableHTTPClientTransport(new URL(transport.endpoint))
+            : new StdioClientTransport({
+                command: transport.command,
+                args: [...(transport.args ?? [])],
+                cwd,
+            });
+        const connectPromise = client.connect(mcpTransport);
+        let timeoutId;
+        const timeoutPromise = new Promise((_resolve, reject) => {
+            timeoutId = setTimeout(() => reject(new Error(`Connection to "${agentName}" timed out after ${timeoutMs}ms`)), timeoutMs);
+        });
+        try {
+            await Promise.race([connectPromise, timeoutPromise]);
+        }
+        catch (err) {
+            await client.close().catch(() => { });
+            throw err;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+        this.connections.set(agentName, { client, transportType: transport.type });
+        return client;
+    }
+    /** 断开指定 Agent 的连接 */
+    async disconnect(agentName) {
+        const conn = this.connections.get(agentName);
+        if (!conn)
+            return;
+        await conn.client.close();
+        this.connections.delete(agentName);
+    }
+    /** 断开所有连接 */
+    async disconnectAll() {
+        const names = [...this.connections.keys()];
+        await Promise.all(names.map((name) => this.disconnect(name)));
+    }
+    /** 检查是否已连接 */
+    isConnected(agentName) {
+        return this.connections.has(agentName);
+    }
+}
+//# sourceMappingURL=client-manager.js.map

package/dist/mcp/client-manager.js.map

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

package/dist/mcp/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,2 @@
+export { McpClientManager } from "./client-manager.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/mcp/sampling-handler.d.ts

@@ -0,0 +1,12 @@
+import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import type { LanguageModelV3 } from "@ai-sdk/provider";
+/**
+ * 在 MCP Client 上注册 Sampling Handler。
+ *
+ * 当子 Agent（MCP Server）调用 `createMessage` 请求 LLM 推理时，
+ * 该 handler 使用指挥官的 LLM Engine 完成推理并返回结果。
+ *
+ * @see https://spec.modelcontextprotocol.io/specification/client/sampling/
+ */
+export declare function registerSamplingHandler(client: Client, model: LanguageModelV3): void;
+//# sourceMappingURL=sampling-handler.d.ts.map

package/dist/mcp/sampling-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampling-handler.d.ts","sourceRoot":"","sources":["../../src/mcp/sampling-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAuBpF"}

package/dist/mcp/sampling-handler.js

@@ -0,0 +1,56 @@
+import { CreateMessageRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { generateText } from "ai";
+/**
+ * 在 MCP Client 上注册 Sampling Handler。
+ *
+ * 当子 Agent（MCP Server）调用 `createMessage` 请求 LLM 推理时，
+ * 该 handler 使用指挥官的 LLM Engine 完成推理并返回结果。
+ *
+ * @see https://spec.modelcontextprotocol.io/specification/client/sampling/
+ */
+export function registerSamplingHandler(client, model) {
+    client.setRequestHandler(CreateMessageRequestSchema, async (request) => {
+        const messages = convertToModelMessages(request.params.messages);
+        const maxTokens = request.params.maxTokens;
+        let result;
+        try {
+            result = await generateText({
+                model,
+                messages,
+                ...(maxTokens > 0 ? { maxOutputTokens: maxTokens } : {}),
+            });
+        }
+        catch (error) {
+            throw new Error("Sampling handler: LLM generation failed", { cause: error });
+        }
+        return {
+            role: "assistant",
+            content: { type: "text", text: result.text },
+            model: result.response.modelId,
+            ...(result.finishReason === "length" ? { stopReason: "maxTokens" } : { stopReason: "endTurn" }),
+        };
+    });
+}
+/** 将 MCP SamplingMessage[] 转换为 AI SDK ModelMessage[] */
+function convertToModelMessages(messages) {
+    return messages.map((msg) => {
+        const text = extractTextContent(msg.content);
+        if (msg.role === "assistant") {
+            return { role: "assistant", content: [{ type: "text", text }] };
+        }
+        return { role: "user", content: [{ type: "text", text }] };
+    });
+}
+/** 从 MCP content union 中提取文本 */
+function extractTextContent(content) {
+    if (typeof content === "string")
+        return content;
+    if (typeof content === "object" && content !== null && "type" in content) {
+        const typed = content;
+        if (typed.type === "text" && typeof typed.text === "string") {
+            return typed.text;
+        }
+    }
+    return JSON.stringify(content);
+}
+//# sourceMappingURL=sampling-handler.js.map

package/dist/mcp/sampling-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampling-handler.js","sourceRoot":"","sources":["../../src/mcp/sampling-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAIlC;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc,EAAE,KAAsB;IAC5E,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,EAAE,OAAO,EAAgC,EAAE;QACnG,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;QAE3C,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,YAAY,CAAC;gBAC1B,KAAK;gBACL,QAAQ;gBACR,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzD,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,yCAAyC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;YAC5C,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;YAC9B,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;SAChG,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,wDAAwD;AACxD,SAAS,sBAAsB,CAC7B,QAA6E;IAE7E,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAgB,EAAE;QACxC,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAE7C,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC7B,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAClE,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gCAAgC;AAChC,SAAS,kBAAkB,CAAC,OAAgB;IAC1C,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAEhD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;QACzE,MAAM,KAAK,GAAG,OAA0C,CAAC;QACzD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5D,OAAO,KAAK,CAAC,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC"}

package/dist/registry/discovery.d.ts

@@ -0,0 +1,16 @@
+import type { AgentSkill, AgentTransport } from "../types/agent.ts";
+/** SKILL.md 解析结果 */
+export interface DiscoveredAgent {
+    readonly skill: AgentSkill;
+    readonly transport: AgentTransport;
+    readonly skillPath: string;
+    /** SKILL.md body 内容（frontmatter 之后的 markdown 部分） */
+    readonly skillBody: string;
+}
+/**
+ * 解析指定目录下的 SKILL.md，提取 Agent 描述和传输配置。
+ *
+ * @throws 找不到 SKILL.md 或缺少必需字段时抛出错误
+ */
+export declare function discoverAgent(agentDir: string): DiscoveredAgent;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/registry/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/registry/discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEpE,oBAAoB;AACpB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAKD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CA6C/D"}

package/dist/registry/discovery.js

@@ -0,0 +1,72 @@
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import matter from "gray-matter";
+/** SKILL.md 文件名 */
+const SKILL_FILE_NAME = "SKILL.md";
+/**
+ * 解析指定目录下的 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 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 skill = {
+        name,
+        description,
+        ...(typeof frontmatter["license"] === "string" ? { license: frontmatter["license"] } : {}),
+        ...(typeof frontmatter["compatibility"] === "string"
+            ? { compatibility: frontmatter["compatibility"] }
+            : {}),
+        metadata,
+    };
+    // 从 metadata 中解析 Roll 扩展字段，直接通过字段访问收窄类型
+    const transport = resolveTransport(metadata);
+    return { skill, transport, skillPath, skillBody: skillBody.trim() };
+}
+/** 根据 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 };
+}
+//# sourceMappingURL=discovery.js.map

package/dist/registry/discovery.js.map

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

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

@@ -0,0 +1,18 @@
+import type { AgentStore } from "./store.ts";
+/** 健康检查结果 */
+export interface HealthCheckResult {
+    readonly agentName: string;
+    readonly healthy: boolean;
+    readonly restarted: boolean;
+    readonly message: string;
+}
+/**
+ * 检查所有状态为 "online" 的 Agent 是否仍在运行。
+ *
+ * - 如果进程已死且 autoRestart 为 true，尝试自动重启
+ * - 更新 store 中的 Agent 状态
+ */
+export declare function checkAgentHealth(store: AgentStore, dataDir: string, options?: {
+    readonly autoRestart: boolean;
+}): ReadonlyArray<HealthCheckResult>;
+//# sourceMappingURL=health-check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.d.ts","sourceRoot":"","sources":["../../src/registry/health-check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,aAAa;AACb,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;CAA2B,GAClE,aAAa,CAAC,iBAAiB,CAAC,CAsClC"}

package/dist/registry/health-check.js

@@ -0,0 +1,65 @@
+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);
+            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) {
+    try {
+        const newPid = startAgent(agent, dataDir);
+        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

package/dist/registry/health-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.js","sourceRoot":"","sources":["../../src/registry/health-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAY/D;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAiB,EACjB,OAAe,EACf,UAA6C,EAAE,WAAW,EAAE,KAAK,EAAE;IAEnE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,2BAA2B;QAC3B,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAClE,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEnD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;gBAC3B,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,aAAa,MAAM,CAAC,GAAG,CAAC,GAAG;aACrC,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,OAAO;QACP,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;gBAC3B,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,mBAAmB;aAC7B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iBAAiB;AACjB,SAAS,UAAU,CAAC,KAAsB,EAAE,KAAiB,EAAE,OAAe;IAC5E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1C,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC/C,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;YAC3B,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,eAAe,MAAM,CAAC,MAAM,CAAC,GAAG;SAC1C,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;YAC3B,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,SAAS,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SACrE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/registry/index.d.ts

@@ -0,0 +1,5 @@
+export { discoverAgent } from "./discovery.ts";
+export type { DiscoveredAgent } from "./discovery.ts";
+export { AgentStore } from "./store.ts";
+export { startAgent, stopAgent, getAgentPid } from "./process-manager.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,4 @@
+export { discoverAgent } from "./discovery.js";
+export { AgentStore } from "./store.js";
+export { startAgent, stopAgent, getAgentPid } from "./process-manager.js";
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { RegisteredAgent } from "../types/agent.ts";
+/** 读取 Agent 的 PID，如果不存在或进程已死则返回 undefined */
+export declare function getAgentPid(dataDir: string, agentName: string): number | undefined;
+/**
+ * 启动一个 Agent 为后台进程（detached）。
+ *
+ * 仅对 stdio 模式有意义——后台运行 MCP Server。
+ * Streamable HTTP Agent 应由用户自行管理（独立服务）。
+ */
+export declare function startAgent(agent: RegisteredAgent, dataDir: string): number;
+/** 停止一个后台运行的 Agent */
+export declare function stopAgent(dataDir: string, agentName: string): boolean;
+//# sourceMappingURL=process-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../src/registry/process-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAiBzD,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWlF;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAkC1E;AAED,sBAAsB;AACtB,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAiBrE"}

package/dist/registry/process-manager.js

@@ -0,0 +1,82 @@
+import { spawn } from "node:child_process";
+import { readFileSync, writeFileSync, existsSync, unlinkSync, mkdirSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+/** PID 文件存放目录 */
+function pidFilePath(dataDir, agentName) {
+    return resolve(dataDir, "pids", `${agentName}.pid`);
+}
+/** 检查进程是否仍在运行 */
+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 文件
+        unlinkSync(pidFile);
+        return undefined;
+    }
+    return pid;
+}
+/**
+ * 启动一个 Agent 为后台进程（detached）。
+ *
+ * 仅对 stdio 模式有意义——后台运行 MCP Server。
+ * Streamable HTTP Agent 应由用户自行管理（独立服务）。
+ */
+export function startAgent(agent, dataDir) {
+    if (agent.transport.type === "streamable-http") {
+        throw new Error(`Agent "${agent.skill.name}" 使用 streamable-http 传输，请手动启动服务。` +
+            `\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 child = spawn(agent.transport.command, [...(agent.transport.args ?? [])], {
+        cwd: agent.installPath,
+        detached: true,
+        stdio: "ignore",
+    });
+    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 文件
+    const pidFile = pidFilePath(dataDir, agentName);
+    if (existsSync(pidFile)) {
+        unlinkSync(pidFile);
+    }
+    return true;
+}
+//# sourceMappingURL=process-manager.js.map

package/dist/registry/process-manager.js.map

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

package/dist/registry/store.d.ts

@@ -0,0 +1,21 @@
+import type { RegisteredAgent } from "../types/agent.ts";
+/** Agent Store — 管理已注册 Agent 的持久化存储（JSON 文件） */
+export declare class AgentStore {
+    private readonly storePath;
+    constructor(dataDir: string);
+    /** 读取所有已注册 Agent */
+    list(): ReadonlyArray<RegisteredAgent>;
+    /** 根据名称查找 Agent */
+    findByName(name: string): RegisteredAgent | undefined;
+    /** 添加一个 Agent（名称重复则抛错） */
+    add(agent: RegisteredAgent): void;
+    /** 根据名称移除 Agent */
+    remove(name: string): boolean;
+    /** 原子替换指定 Agent（名称可变更） */
+    replace(name: string, next: RegisteredAgent): boolean;
+    /** 更新指定 Agent 的状态 */
+    updateStatus(name: string, status: RegisteredAgent["status"]): void;
+    /** 写入存储文件 */
+    private save;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/registry/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/registry/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKzD,gDAAgD;AAChD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,MAAM;IAI3B,oBAAoB;IACpB,IAAI,IAAI,aAAa,CAAC,eAAe,CAAC;IAoBtC,mBAAmB;IACnB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIrD,0BAA0B;IAC1B,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAYjC,mBAAmB;IACnB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAY7B,0BAA0B;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO;IAiBrD,qBAAqB;IACrB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,IAAI;IAOnE,aAAa;IACb,OAAO,CAAC,IAAI;CAOb"}

package/dist/registry/store.js

@@ -0,0 +1,81 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+/** 持久化存储文件名 */
+const STORE_FILE = "agents.json";
+/** Agent Store — 管理已注册 Agent 的持久化存储（JSON 文件） */
+export class AgentStore {
+    storePath;
+    constructor(dataDir) {
+        this.storePath = resolve(dataDir, STORE_FILE);
+    }
+    /** 读取所有已注册 Agent */
+    list() {
+        if (!existsSync(this.storePath)) {
+            return [];
+        }
+        let parsed;
+        try {
+            const raw = readFileSync(this.storePath, "utf-8");
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            return [];
+        }
+        if (!Array.isArray(parsed)) {
+            return [];
+        }
+        return parsed;
+    }
+    /** 根据名称查找 Agent */
+    findByName(name) {
+        return this.list().find((agent) => agent.skill.name === name);
+    }
+    /** 添加一个 Agent（名称重复则抛错） */
+    add(agent) {
+        const agents = [...this.list()];
+        const existing = agents.findIndex((a) => a.skill.name === agent.skill.name);
+        if (existing !== -1) {
+            throw new Error(`Agent "${agent.skill.name}" is already registered`);
+        }
+        agents.push(agent);
+        this.save(agents);
+    }
+    /** 根据名称移除 Agent */
+    remove(name) {
+        const agents = this.list();
+        const filtered = agents.filter((a) => a.skill.name !== name);
+        if (filtered.length === agents.length) {
+            return false;
+        }
+        this.save([...filtered]);
+        return true;
+    }
+    /** 原子替换指定 Agent（名称可变更） */
+    replace(name, next) {
+        const agents = [...this.list()];
+        const targetIndex = agents.findIndex((a) => a.skill.name === name);
+        if (targetIndex === -1)
+            return false;
+        const conflictIndex = agents.findIndex((a, index) => index !== targetIndex && a.skill.name === next.skill.name);
+        if (conflictIndex !== -1) {
+            throw new Error(`Agent "${next.skill.name}" is already registered`);
+        }
+        agents[targetIndex] = next;
+        this.save(agents);
+        return true;
+    }
+    /** 更新指定 Agent 的状态 */
+    updateStatus(name, status) {
+        const agents = this.list().map((a) => a.skill.name === name ? { ...a, status } : a);
+        this.save([...agents]);
+    }
+    /** 写入存储文件 */
+    save(agents) {
+        const dir = dirname(this.storePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(this.storePath, JSON.stringify(agents, null, 2), "utf-8");
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/registry/store.js.map

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

package/dist/router/declarative.d.ts

@@ -0,0 +1,8 @@
+import type { RegisteredAgent } from "../types/agent.ts";
+/**
+ * 声明式路由：按名称直接查找 Agent。
+ *
+ * 用于 `roll run <agent> <tool>` 场景，不涉及 LLM。
+ */
+export declare function resolveAgent(agentName: string, agents: ReadonlyArray<RegisteredAgent>): RegisteredAgent | undefined;
+//# sourceMappingURL=declarative.d.ts.map

package/dist/router/declarative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarative.d.ts","sourceRoot":"","sources":["../../src/router/declarative.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,GACrC,eAAe,GAAG,SAAS,CAE7B"}