@aigne/afs-cli 1.11.0-beta.10 → 1.11.0-beta.12

package/dist/mcp/tools.cjs

@@ -9,6 +9,28 @@ const require_path_utils = require('../path-utils.cjs');
 let zod = require("zod");
 
 //#region src/mcp/tools.ts
+/** Default timeout for MCP tool calls (30 seconds) */
+const TOOL_TIMEOUT_MS = 3e4;
+/** Extended timeout for exec operations (5 minutes) — covers agent-run and other long-running actions */
+const EXEC_TIMEOUT_MS = 3e5;
+/**
+* Wrap an async operation with a timeout.
+* Returns an error result instead of blocking the MCP connection indefinitely.
+*/
+function withTimeout(fn, timeoutMs = TOOL_TIMEOUT_MS) {
+	return new Promise((resolve, reject) => {
+		const timer = setTimeout(() => {
+			reject(/* @__PURE__ */ new Error(`Operation timed out after ${timeoutMs / 1e3}s`));
+		}, timeoutMs);
+		fn().then((result) => {
+			clearTimeout(timer);
+			resolve(result);
+		}, (error) => {
+			clearTimeout(timer);
+			reject(error);
+		});
+	});
+}
 /**
 * Create a safe error result for MCP tools.
 * Strips stack traces and internal details from error messages.
@@ -35,10 +57,17 @@ function textResult(text) {
 * Register all AFS tools on the MCP server.
 */
 function registerTools(server, afs) {
-	server.tool("afs_read", "Read content at an AFS path", { path: zod.z.string().describe("AFS path to read, e.g. /modules/fs/README.md or $afs:ns/path") }, async ({ path }) => {
+	server.tool("afs_read", "Read content at an AFS path", {
+		path: zod.z.string().describe("AFS path to read, e.g. /modules/fs/README.md or $afs:ns/path"),
+		startLine: zod.z.number().int().optional().describe("Start line (1-indexed, inclusive)"),
+		endLine: zod.z.number().int().optional().describe("End line (1-indexed, inclusive). -1 for end of file")
+	}, async ({ path, startLine, endLine }) => {
 		try {
 			const canonicalPath = require_path_utils.cliPathToCanonical(path);
-			const result = await afs.read(canonicalPath);
+			const result = await withTimeout(() => afs.read(canonicalPath, {
+				startLine,
+				endLine
+			}));
 			if (!result.data) return {
 				isError: true,
 				content: [{
@@ -59,11 +88,11 @@ function registerTools(server, afs) {
 	}, async ({ path, depth, pattern, limit }) => {
 		try {
 			const canonicalPath = require_path_utils.cliPathToCanonical(path);
-			const result = await afs.list(canonicalPath, {
+			const result = await withTimeout(() => afs.list(canonicalPath, {
 				maxDepth: depth ?? 1,
 				pattern,
 				limit
-			});
+			}));
 			if (result.data.length === 0 && result.message) return {
 				isError: true,
 				content: [{
@@ -78,11 +107,32 @@ function registerTools(server, afs) {
 	});
 	server.tool("afs_write", "Write content to an AFS path", {
 		path: zod.z.string().describe("AFS path to write to"),
-		content: zod.z.union([zod.z.string(), zod.z.record(zod.z.string(), zod.z.unknown())]).describe("Content to write (string or JSON object)")
-	}, async ({ path, content }) => {
+		content: zod.z.union([zod.z.string(), zod.z.record(zod.z.string(), zod.z.unknown())]).optional().describe("Content to write (string or JSON object)"),
+		mode: zod.z.enum([
+			"replace",
+			"append",
+			"prepend",
+			"patch",
+			"create",
+			"update"
+		]).optional().default("replace").describe("Write mode: replace (default), append, prepend, or patch"),
+		patches: zod.z.array(zod.z.object({
+			op: zod.z.enum([
+				"str_replace",
+				"insert_before",
+				"insert_after",
+				"delete"
+			]),
+			target: zod.z.string().describe("Unique string to locate in the file"),
+			content: zod.z.string().optional().default("").describe("Replacement/insertion content")
+		})).optional().describe("Patch operations (only used with mode=patch)")
+	}, async ({ path, content, mode, patches }) => {
 		try {
 			const canonicalPath = require_path_utils.cliPathToCanonical(path);
-			return textResult(require_write.formatWriteOutput(await afs.write(canonicalPath, { content }), "llm"));
+			const payload = {};
+			if (content !== void 0) payload.content = content;
+			if (patches) payload.patches = patches;
+			return textResult(require_write.formatWriteOutput(await withTimeout(() => afs.write(canonicalPath, payload, { mode })), "llm"));
 		} catch (error) {
 			return errorResult(error);
 		}
@@ -93,7 +143,7 @@ function registerTools(server, afs) {
 	}, async ({ path, recursive }) => {
 		try {
 			const canonicalPath = require_path_utils.cliPathToCanonical(path);
-			return textResult(require_delete.formatDeleteOutput(await afs.delete(canonicalPath, { recursive }), "llm", { path }));
+			return textResult(require_delete.formatDeleteOutput(await withTimeout(() => afs.delete(canonicalPath, { recursive })), "llm", { path }));
 		} catch (error) {
 			return errorResult(error);
 		}
@@ -106,7 +156,7 @@ function registerTools(server, afs) {
 	}, async ({ path, query, limit }) => {
 		try {
 			const canonicalPath = require_path_utils.cliPathToCanonical(path);
-			return textResult(require_ls.formatLsOutput(await afs.search(canonicalPath, query, { limit }), "llm", { path }));
+			return textResult(require_ls.formatLsOutput(await withTimeout(() => afs.search(canonicalPath, query, { limit })), "llm", { path }));
 		} catch (error) {
 			return errorResult(error);
 		}
@@ -117,7 +167,7 @@ function registerTools(server, afs) {
 	}, async ({ path, args }) => {
 		try {
 			const canonicalPath = require_path_utils.cliPathToCanonical(path);
-			return textResult(require_exec.formatExecOutput(await afs.exec(canonicalPath, args ?? {}), "llm", { path }));
+			return textResult(require_exec.formatExecOutput(await withTimeout(() => afs.exec(canonicalPath, args ?? {}), EXEC_TIMEOUT_MS), "llm", { path }));
 		} catch (error) {
 			return errorResult(error);
 		}
@@ -125,7 +175,7 @@ function registerTools(server, afs) {
 	server.tool("afs_stat", "Get metadata for an AFS path", { path: zod.z.string().describe("AFS path to stat") }, async ({ path }) => {
 		try {
 			const canonicalPath = require_path_utils.cliPathToCanonical(path);
-			const result = await afs.stat(canonicalPath);
+			const result = await withTimeout(() => afs.stat(canonicalPath));
 			if (!result.data) return {
 				isError: true,
 				content: [{
@@ -141,7 +191,7 @@ function registerTools(server, afs) {
 	server.tool("afs_explain", "Get a human-readable explanation for an AFS path or topic", { path: zod.z.string().describe("AFS path or topic to explain") }, async ({ path }) => {
 		try {
 			const canonicalPath = require_path_utils.cliPathToCanonical(path);
-			return textResult((await afs.explain(canonicalPath)).content);
+			return textResult((await withTimeout(() => afs.explain(canonicalPath))).content);
 		} catch (error) {
 			return errorResult(error);
 		}

package/dist/mcp/tools.mjs

@@ -8,6 +8,28 @@ import { cliPathToCanonical } from "../path-utils.mjs";
 import { z } from "zod";
 
 //#region src/mcp/tools.ts
+/** Default timeout for MCP tool calls (30 seconds) */
+const TOOL_TIMEOUT_MS = 3e4;
+/** Extended timeout for exec operations (5 minutes) — covers agent-run and other long-running actions */
+const EXEC_TIMEOUT_MS = 3e5;
+/**
+* Wrap an async operation with a timeout.
+* Returns an error result instead of blocking the MCP connection indefinitely.
+*/
+function withTimeout(fn, timeoutMs = TOOL_TIMEOUT_MS) {
+	return new Promise((resolve, reject) => {
+		const timer = setTimeout(() => {
+			reject(/* @__PURE__ */ new Error(`Operation timed out after ${timeoutMs / 1e3}s`));
+		}, timeoutMs);
+		fn().then((result) => {
+			clearTimeout(timer);
+			resolve(result);
+		}, (error) => {
+			clearTimeout(timer);
+			reject(error);
+		});
+	});
+}
 /**
 * Create a safe error result for MCP tools.
 * Strips stack traces and internal details from error messages.
@@ -34,10 +56,17 @@ function textResult(text) {
 * Register all AFS tools on the MCP server.
 */
 function registerTools(server, afs) {
-	server.tool("afs_read", "Read content at an AFS path", { path: z.string().describe("AFS path to read, e.g. /modules/fs/README.md or $afs:ns/path") }, async ({ path }) => {
+	server.tool("afs_read", "Read content at an AFS path", {
+		path: z.string().describe("AFS path to read, e.g. /modules/fs/README.md or $afs:ns/path"),
+		startLine: z.number().int().optional().describe("Start line (1-indexed, inclusive)"),
+		endLine: z.number().int().optional().describe("End line (1-indexed, inclusive). -1 for end of file")
+	}, async ({ path, startLine, endLine }) => {
 		try {
 			const canonicalPath = cliPathToCanonical(path);
-			const result = await afs.read(canonicalPath);
+			const result = await withTimeout(() => afs.read(canonicalPath, {
+				startLine,
+				endLine
+			}));
 			if (!result.data) return {
 				isError: true,
 				content: [{
@@ -58,11 +87,11 @@ function registerTools(server, afs) {
 	}, async ({ path, depth, pattern, limit }) => {
 		try {
 			const canonicalPath = cliPathToCanonical(path);
-			const result = await afs.list(canonicalPath, {
+			const result = await withTimeout(() => afs.list(canonicalPath, {
 				maxDepth: depth ?? 1,
 				pattern,
 				limit
-			});
+			}));
 			if (result.data.length === 0 && result.message) return {
 				isError: true,
 				content: [{
@@ -77,11 +106,32 @@ function registerTools(server, afs) {
 	});
 	server.tool("afs_write", "Write content to an AFS path", {
 		path: z.string().describe("AFS path to write to"),
-		content: z.union([z.string(), z.record(z.string(), z.unknown())]).describe("Content to write (string or JSON object)")
-	}, async ({ path, content }) => {
+		content: z.union([z.string(), z.record(z.string(), z.unknown())]).optional().describe("Content to write (string or JSON object)"),
+		mode: z.enum([
+			"replace",
+			"append",
+			"prepend",
+			"patch",
+			"create",
+			"update"
+		]).optional().default("replace").describe("Write mode: replace (default), append, prepend, or patch"),
+		patches: z.array(z.object({
+			op: z.enum([
+				"str_replace",
+				"insert_before",
+				"insert_after",
+				"delete"
+			]),
+			target: z.string().describe("Unique string to locate in the file"),
+			content: z.string().optional().default("").describe("Replacement/insertion content")
+		})).optional().describe("Patch operations (only used with mode=patch)")
+	}, async ({ path, content, mode, patches }) => {
 		try {
 			const canonicalPath = cliPathToCanonical(path);
-			return textResult(formatWriteOutput(await afs.write(canonicalPath, { content }), "llm"));
+			const payload = {};
+			if (content !== void 0) payload.content = content;
+			if (patches) payload.patches = patches;
+			return textResult(formatWriteOutput(await withTimeout(() => afs.write(canonicalPath, payload, { mode })), "llm"));
 		} catch (error) {
 			return errorResult(error);
 		}
@@ -92,7 +142,7 @@ function registerTools(server, afs) {
 	}, async ({ path, recursive }) => {
 		try {
 			const canonicalPath = cliPathToCanonical(path);
-			return textResult(formatDeleteOutput(await afs.delete(canonicalPath, { recursive }), "llm", { path }));
+			return textResult(formatDeleteOutput(await withTimeout(() => afs.delete(canonicalPath, { recursive })), "llm", { path }));
 		} catch (error) {
 			return errorResult(error);
 		}
@@ -105,7 +155,7 @@ function registerTools(server, afs) {
 	}, async ({ path, query, limit }) => {
 		try {
 			const canonicalPath = cliPathToCanonical(path);
-			return textResult(formatLsOutput(await afs.search(canonicalPath, query, { limit }), "llm", { path }));
+			return textResult(formatLsOutput(await withTimeout(() => afs.search(canonicalPath, query, { limit })), "llm", { path }));
 		} catch (error) {
 			return errorResult(error);
 		}
@@ -116,7 +166,7 @@ function registerTools(server, afs) {
 	}, async ({ path, args }) => {
 		try {
 			const canonicalPath = cliPathToCanonical(path);
-			return textResult(formatExecOutput(await afs.exec(canonicalPath, args ?? {}), "llm", { path }));
+			return textResult(formatExecOutput(await withTimeout(() => afs.exec(canonicalPath, args ?? {}), EXEC_TIMEOUT_MS), "llm", { path }));
 		} catch (error) {
 			return errorResult(error);
 		}
@@ -124,7 +174,7 @@ function registerTools(server, afs) {
 	server.tool("afs_stat", "Get metadata for an AFS path", { path: z.string().describe("AFS path to stat") }, async ({ path }) => {
 		try {
 			const canonicalPath = cliPathToCanonical(path);
-			const result = await afs.stat(canonicalPath);
+			const result = await withTimeout(() => afs.stat(canonicalPath));
 			if (!result.data) return {
 				isError: true,
 				content: [{
@@ -140,7 +190,7 @@ function registerTools(server, afs) {
 	server.tool("afs_explain", "Get a human-readable explanation for an AFS path or topic", { path: z.string().describe("AFS path or topic to explain") }, async ({ path }) => {
 		try {
 			const canonicalPath = cliPathToCanonical(path);
-			return textResult((await afs.explain(canonicalPath)).content);
+			return textResult((await withTimeout(() => afs.explain(canonicalPath))).content);
 		} catch (error) {
 			return errorResult(error);
 		}

package/dist/mcp/tools.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tools.mjs","names":[],"sources":["../../src/mcp/tools.ts"],"sourcesContent":["/**\n * AFS MCP Tools Registration\n *\n * Registers all 10 AFS operations as MCP tools.\n */\n\nimport type { AFS } from \"@aigne/afs\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport { formatDeleteOutput } from \"../core/formatters/delete.js\";\nimport { formatExecOutput } from \"../core/formatters/exec.js\";\nimport { formatLsOutput } from \"../core/formatters/ls.js\";\nimport { formatReadOutput } from \"../core/formatters/read.js\";\nimport { formatStatOutput } from \"../core/formatters/stat.js\";\nimport { formatWriteOutput } from \"../core/formatters/write.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\n\n/**\n * Create a safe error result for MCP tools.\n * Strips stack traces and internal details from error messages.\n */\nfunction errorResult(error: unknown) {\n  const message = error instanceof Error ? error.message : String(error);\n  const safeMessage = message.split(\"\\n\")[0] || \"Operation failed\";\n  return {\n    isError: true as const,\n    content: [{ type: \"text\" as const, text: safeMessage }],\n  };\n}\n\n/**\n * Create a text result for MCP tools.\n */\nfunction textResult(text: string) {\n  return {\n    content: [{ type: \"text\" as const, text }],\n  };\n}\n\n/**\n * Register all AFS tools on the MCP server.\n */\nexport function registerTools(server: McpServer, afs: AFS): void {\n  // afs_read - Read content at a path\n  server.tool(\n    \"afs_read\",\n    \"Read content at an AFS path\",\n    { path: z.string().describe(\"AFS path to read, e.g. /modules/fs/README.md or $afs:ns/path\") },\n    async ({ path }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const result = await afs.read(canonicalPath);\n        if (!result.data) {\n          return {\n            isError: true as const,\n            content: [{ type: \"text\" as const, text: result.message || \"Not found\" }],\n          };\n        }\n        const formatted = formatReadOutput(result, \"llm\", { path });\n        return textResult(formatted);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  // afs_list - List directory contents\n  server.tool(\n    \"afs_list\",\n    \"List directory contents at an AFS path\",\n    {\n      path: z.string().describe(\"AFS path to list\"),\n      depth: z.number().optional().describe(\"Recursion depth, default 1\"),\n      pattern: z.string().optional().describe(\"Filter pattern, e.g. *.md\"),\n      limit: z.number().optional().describe(\"Max entries to return\"),\n    },\n    async ({ path, depth, pattern, limit }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const result = await afs.list(canonicalPath, {\n          maxDepth: depth ?? 1,\n          pattern,\n          limit,\n        });\n        if (result.data.length === 0 && result.message) {\n          return {\n            isError: true as const,\n            content: [{ type: \"text\" as const, text: result.message }],\n          };\n        }\n        const formatted = formatLsOutput(result, \"llm\", { path });\n        return textResult(formatted);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  // afs_write - Write content to a path\n  server.tool(\n    \"afs_write\",\n    \"Write content to an AFS path\",\n    {\n      path: z.string().describe(\"AFS path to write to\"),\n      content: z\n        .union([z.string(), z.record(z.string(), z.unknown())])\n        .describe(\"Content to write (string or JSON object)\"),\n    },\n    async ({ path, content }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const result = await afs.write(canonicalPath, { content });\n        const formatted = formatWriteOutput(result, \"llm\");\n        return textResult(formatted);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  // afs_delete - Delete a path\n  server.tool(\n    \"afs_delete\",\n    \"Delete a file or directory at an AFS path\",\n    {\n      path: z.string().describe(\"AFS path to delete\"),\n      recursive: z.boolean().optional().describe(\"Delete recursively\"),\n    },\n    async ({ path, recursive }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const result = await afs.delete(canonicalPath, { recursive });\n        const formatted = formatDeleteOutput(result, \"llm\", { path });\n        return textResult(formatted);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  // afs_search - Search for content\n  server.tool(\n    \"afs_search\",\n    \"Search for content within an AFS path\",\n    {\n      path: z.string().describe(\"Base path to search from\"),\n      query: z.string().describe(\"Search query\"),\n      pattern: z.string().optional().describe(\"File pattern filter\"),\n      limit: z.number().optional().describe(\"Max results\"),\n    },\n    async ({ path, query, limit }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const result = await afs.search(canonicalPath, query, { limit });\n        // Search results use list formatter\n        const formatted = formatLsOutput(result as any, \"llm\", { path });\n        return textResult(formatted);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  // afs_exec - Execute an action\n  server.tool(\n    \"afs_exec\",\n    \"Execute an action. Use afs_list on {path}/.actions to discover available actions and their inputSchema.\",\n    {\n      path: z.string().describe(\"Action path, e.g. /modules/sqlite/users/.actions/insert\"),\n      args: z\n        .record(z.string(), z.unknown())\n        .optional()\n        .describe(\"Action arguments matching the action's inputSchema\"),\n    },\n    async ({ path, args }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const result = await afs.exec(canonicalPath, args ?? {});\n        const formatted = formatExecOutput(result, \"llm\", { path });\n        return textResult(formatted);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  // afs_stat - Get path metadata\n  server.tool(\n    \"afs_stat\",\n    \"Get metadata for an AFS path\",\n    { path: z.string().describe(\"AFS path to stat\") },\n    async ({ path }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const result = await afs.stat(canonicalPath);\n        if (!result.data) {\n          return {\n            isError: true as const,\n            content: [{ type: \"text\" as const, text: result.message || \"Not found\" }],\n          };\n        }\n        const formatted = formatStatOutput(result, \"llm\");\n        return textResult(formatted);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  // afs_explain - Get human-readable explanation\n  server.tool(\n    \"afs_explain\",\n    \"Get a human-readable explanation for an AFS path or topic\",\n    { path: z.string().describe(\"AFS path or topic to explain\") },\n    async ({ path }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const result = await afs.explain(canonicalPath);\n        // explain returns { format, content } directly\n        return textResult(result.content);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"tools.mjs","names":[],"sources":["../../src/mcp/tools.ts"],"sourcesContent":["/**\n * AFS MCP Tools Registration\n *\n * Registers AFS operations as MCP tools.\n */\n\nimport type { AFS } from \"@aigne/afs\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport { formatDeleteOutput } from \"../core/formatters/delete.js\";\nimport { formatExecOutput } from \"../core/formatters/exec.js\";\nimport { formatLsOutput } from \"../core/formatters/ls.js\";\nimport { formatReadOutput } from \"../core/formatters/read.js\";\nimport { formatStatOutput } from \"../core/formatters/stat.js\";\nimport { formatWriteOutput } from \"../core/formatters/write.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\n\n/** Default timeout for MCP tool calls (30 seconds) */\nconst TOOL_TIMEOUT_MS = 30_000;\n\n/** Extended timeout for exec operations (5 minutes) — covers agent-run and other long-running actions */\nconst EXEC_TIMEOUT_MS = 300_000;\n\n/**\n * Wrap an async operation with a timeout.\n * Returns an error result instead of blocking the MCP connection indefinitely.\n */\nfunction withTimeout<T>(fn: () => Promise<T>, timeoutMs = TOOL_TIMEOUT_MS): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    const timer = setTimeout(() => {\n      reject(new Error(`Operation timed out after ${timeoutMs / 1000}s`));\n    }, timeoutMs);\n\n    fn().then(\n      (result) => {\n        clearTimeout(timer);\n        resolve(result);\n      },\n      (error) => {\n        clearTimeout(timer);\n        reject(error);\n      },\n    );\n  });\n}\n\n/**\n * Create a safe error result for MCP tools.\n * Strips stack traces and internal details from error messages.\n */\nfunction errorResult(error: unknown) {\n  const message = error instanceof Error ? error.message : String(error);\n  const safeMessage = message.split(\"\\n\")[0] || \"Operation failed\";\n  return {\n    isError: true as const,\n    content: [{ type: \"text\" as const, text: safeMessage }],\n  };\n}\n\n/**\n * Create a text result for MCP tools.\n */\nfunction textResult(text: string) {\n  return {\n    content: [{ type: \"text\" as const, text }],\n  };\n}\n\n/**\n * Register all AFS tools on the MCP server.\n */\nexport function registerTools(server: McpServer, afs: AFS): void {\n  // afs_read - Read content at a path\n  server.tool(\n    \"afs_read\",\n    \"Read content at an AFS path\",\n    {\n      path: z.string().describe(\"AFS path to read, e.g. /modules/fs/README.md or $afs:ns/path\"),\n      startLine: z.number().int().optional().describe(\"Start line (1-indexed, inclusive)\"),\n      endLine: z\n        .number()\n        .int()\n        .optional()\n        .describe(\"End line (1-indexed, inclusive). -1 for end of file\"),\n    },\n    async ({ path, startLine, endLine }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const result = await withTimeout(() => afs.read(canonicalPath, { startLine, endLine }));\n        if (!result.data) {\n          return {\n            isError: true as const,\n            content: [{ type: \"text\" as const, text: result.message || \"Not found\" }],\n          };\n        }\n        const formatted = formatReadOutput(result, \"llm\", { path });\n        return textResult(formatted);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  // afs_list - List directory contents\n  server.tool(\n    \"afs_list\",\n    \"List directory contents at an AFS path\",\n    {\n      path: z.string().describe(\"AFS path to list\"),\n      depth: z.number().optional().describe(\"Recursion depth, default 1\"),\n      pattern: z.string().optional().describe(\"Filter pattern, e.g. *.md\"),\n      limit: z.number().optional().describe(\"Max entries to return\"),\n    },\n    async ({ path, depth, pattern, limit }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const result = await withTimeout(() =>\n          afs.list(canonicalPath, {\n            maxDepth: depth ?? 1,\n            pattern,\n            limit,\n          }),\n        );\n        if (result.data.length === 0 && result.message) {\n          return {\n            isError: true as const,\n            content: [{ type: \"text\" as const, text: result.message }],\n          };\n        }\n        const formatted = formatLsOutput(result, \"llm\", { path });\n        return textResult(formatted);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  // afs_write - Write content to a path\n  server.tool(\n    \"afs_write\",\n    \"Write content to an AFS path\",\n    {\n      path: z.string().describe(\"AFS path to write to\"),\n      content: z\n        .union([z.string(), z.record(z.string(), z.unknown())])\n        .optional()\n        .describe(\"Content to write (string or JSON object)\"),\n      mode: z\n        .enum([\"replace\", \"append\", \"prepend\", \"patch\", \"create\", \"update\"])\n        .optional()\n        .default(\"replace\")\n        .describe(\"Write mode: replace (default), append, prepend, or patch\"),\n      patches: z\n        .array(\n          z.object({\n            op: z.enum([\"str_replace\", \"insert_before\", \"insert_after\", \"delete\"]),\n            target: z.string().describe(\"Unique string to locate in the file\"),\n            content: z.string().optional().default(\"\").describe(\"Replacement/insertion content\"),\n          }),\n        )\n        .optional()\n        .describe(\"Patch operations (only used with mode=patch)\"),\n    },\n    async ({ path, content, mode, patches }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const payload: Record<string, unknown> = {};\n        if (content !== undefined) payload.content = content;\n        if (patches) payload.patches = patches;\n        const result = await withTimeout(() => afs.write(canonicalPath, payload, { mode }));\n        const formatted = formatWriteOutput(result, \"llm\");\n        return textResult(formatted);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  // afs_delete - Delete a path\n  server.tool(\n    \"afs_delete\",\n    \"Delete a file or directory at an AFS path\",\n    {\n      path: z.string().describe(\"AFS path to delete\"),\n      recursive: z.boolean().optional().describe(\"Delete recursively\"),\n    },\n    async ({ path, recursive }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const result = await withTimeout(() => afs.delete(canonicalPath, { recursive }));\n        const formatted = formatDeleteOutput(result, \"llm\", { path });\n        return textResult(formatted);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  // afs_search - Search for content\n  server.tool(\n    \"afs_search\",\n    \"Search for content within an AFS path\",\n    {\n      path: z.string().describe(\"Base path to search from\"),\n      query: z.string().describe(\"Search query\"),\n      pattern: z.string().optional().describe(\"File pattern filter\"),\n      limit: z.number().optional().describe(\"Max results\"),\n    },\n    async ({ path, query, limit }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const result = await withTimeout(() => afs.search(canonicalPath, query, { limit }));\n        // Search results use list formatter\n        const formatted = formatLsOutput(result as any, \"llm\", { path });\n        return textResult(formatted);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  // afs_exec - Execute an action\n  server.tool(\n    \"afs_exec\",\n    \"Execute an action. Use afs_list on {path}/.actions to discover available actions and their inputSchema.\",\n    {\n      path: z.string().describe(\"Action path, e.g. /modules/sqlite/users/.actions/insert\"),\n      args: z\n        .record(z.string(), z.unknown())\n        .optional()\n        .describe(\"Action arguments matching the action's inputSchema\"),\n    },\n    async ({ path, args }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const result = await withTimeout(\n          () => afs.exec(canonicalPath, args ?? {}),\n          EXEC_TIMEOUT_MS,\n        );\n        const formatted = formatExecOutput(result, \"llm\", { path });\n        return textResult(formatted);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  // afs_stat - Get path metadata\n  server.tool(\n    \"afs_stat\",\n    \"Get metadata for an AFS path\",\n    { path: z.string().describe(\"AFS path to stat\") },\n    async ({ path }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const result = await withTimeout(() => afs.stat(canonicalPath));\n        if (!result.data) {\n          return {\n            isError: true as const,\n            content: [{ type: \"text\" as const, text: result.message || \"Not found\" }],\n          };\n        }\n        const formatted = formatStatOutput(result, \"llm\");\n        return textResult(formatted);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n\n  // afs_explain - Get human-readable explanation\n  server.tool(\n    \"afs_explain\",\n    \"Get a human-readable explanation for an AFS path or topic\",\n    { path: z.string().describe(\"AFS path or topic to explain\") },\n    async ({ path }) => {\n      try {\n        const canonicalPath = cliPathToCanonical(path);\n        const result = await withTimeout(() => afs.explain(canonicalPath));\n        // explain returns { format, content } directly\n        return textResult(result.content);\n      } catch (error) {\n        return errorResult(error);\n      }\n    },\n  );\n}\n"],"mappings":"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"}

package/dist/program/daemon-integration.cjs

@@ -0,0 +1,46 @@
+
+//#region src/program/daemon-integration.ts
+/**
+* Handle /api/programs/* HTTP requests.
+*
+* Routes:
+* - GET  /api/programs       → list activated programs
+* - POST /api/programs/reload → reload all programs
+*/
+async function handleProgramsAPI(request, programManager) {
+	const url = new URL(request.url);
+	const method = request.method;
+	const path = url.pathname;
+	if (method === "GET" && path === "/api/programs") {
+		const programs = programManager.getActivatedPrograms();
+		return Response.json({ programs });
+	}
+	if (method === "POST" && path === "/api/programs/reload") try {
+		await programManager.reload();
+		return Response.json({ ok: true });
+	} catch (err) {
+		const safeMessage = (err instanceof Error ? err.message : String(err)).replace(/\/[^\s"']+/g, "[path]");
+		return Response.json({ error: safeMessage }, { status: 500 });
+	}
+	return Response.json({ error: "Not found" }, { status: 404 });
+}
+/**
+* Notify the running daemon to reload programs.
+* Silently skips if daemon is not running.
+* Silently swallows errors (best-effort notification).
+*/
+async function notifyDaemonReload(options) {
+	const fetchFn = options.fetch ?? globalThis.fetch;
+	try {
+		const status = await options.getDaemonStatus();
+		if (!status) return;
+		await fetchFn(`${status.url}/api/programs/reload`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" }
+		});
+	} catch {}
+}
+
+//#endregion
+exports.handleProgramsAPI = handleProgramsAPI;
+exports.notifyDaemonReload = notifyDaemonReload;

package/dist/program/daemon-integration.mjs

@@ -0,0 +1,45 @@
+//#region src/program/daemon-integration.ts
+/**
+* Handle /api/programs/* HTTP requests.
+*
+* Routes:
+* - GET  /api/programs       → list activated programs
+* - POST /api/programs/reload → reload all programs
+*/
+async function handleProgramsAPI(request, programManager) {
+	const url = new URL(request.url);
+	const method = request.method;
+	const path = url.pathname;
+	if (method === "GET" && path === "/api/programs") {
+		const programs = programManager.getActivatedPrograms();
+		return Response.json({ programs });
+	}
+	if (method === "POST" && path === "/api/programs/reload") try {
+		await programManager.reload();
+		return Response.json({ ok: true });
+	} catch (err) {
+		const safeMessage = (err instanceof Error ? err.message : String(err)).replace(/\/[^\s"']+/g, "[path]");
+		return Response.json({ error: safeMessage }, { status: 500 });
+	}
+	return Response.json({ error: "Not found" }, { status: 404 });
+}
+/**
+* Notify the running daemon to reload programs.
+* Silently skips if daemon is not running.
+* Silently swallows errors (best-effort notification).
+*/
+async function notifyDaemonReload(options) {
+	const fetchFn = options.fetch ?? globalThis.fetch;
+	try {
+		const status = await options.getDaemonStatus();
+		if (!status) return;
+		await fetchFn(`${status.url}/api/programs/reload`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" }
+		});
+	} catch {}
+}
+
+//#endregion
+export { handleProgramsAPI, notifyDaemonReload };
+//# sourceMappingURL=daemon-integration.mjs.map

package/dist/program/daemon-integration.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-integration.mjs","names":[],"sources":["../../src/program/daemon-integration.ts"],"sourcesContent":["/**\n * Daemon Integration for Program Activation\n *\n * Provides:\n * - HTTP API handler for /api/programs/* routes\n * - Daemon reload notification for install/uninstall hooks\n */\n\nimport type { ProgramManager } from \"./program-manager.js\";\n\n// ─── HTTP API Handler ───────────────────────────────────────────────────────\n\n/**\n * Handle /api/programs/* HTTP requests.\n *\n * Routes:\n * - GET  /api/programs       → list activated programs\n * - POST /api/programs/reload → reload all programs\n */\nexport async function handleProgramsAPI(\n  request: Request,\n  programManager: ProgramManager,\n): Promise<Response> {\n  const url = new URL(request.url);\n  const method = request.method;\n  const path = url.pathname;\n\n  // GET /api/programs — list activated programs\n  if (method === \"GET\" && path === \"/api/programs\") {\n    const programs = programManager.getActivatedPrograms();\n    return Response.json({ programs });\n  }\n\n  // POST /api/programs/reload — trigger reload\n  if (method === \"POST\" && path === \"/api/programs/reload\") {\n    try {\n      await programManager.reload();\n      return Response.json({ ok: true });\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      // Sanitize error: strip filesystem paths\n      const safeMessage = message.replace(/\\/[^\\s\"']+/g, \"[path]\");\n      return Response.json({ error: safeMessage }, { status: 500 });\n    }\n  }\n\n  // Unknown route\n  return Response.json({ error: \"Not found\" }, { status: 404 });\n}\n\n// ─── Daemon Reload Notification ─────────────────────────────────────────────\n\nexport interface NotifyDaemonReloadOptions {\n  /** Check if daemon is running. Returns null if not running. */\n  getDaemonStatus: () => Promise<{ pid: number; port: number; url: string } | null>;\n  /** HTTP fetch function (injectable for testing). Default: global fetch. */\n  fetch?: (url: string, init?: RequestInit) => Promise<Response>;\n}\n\n/**\n * Notify the running daemon to reload programs.\n * Silently skips if daemon is not running.\n * Silently swallows errors (best-effort notification).\n */\nexport async function notifyDaemonReload(options: NotifyDaemonReloadOptions): Promise<void> {\n  const fetchFn = options.fetch ?? globalThis.fetch;\n\n  try {\n    const status = await options.getDaemonStatus();\n    if (!status) return; // Daemon not running\n\n    await fetchFn(`${status.url}/api/programs/reload`, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n    });\n  } catch {\n    // Best-effort — swallow errors\n  }\n}\n"],"mappings":";;;;;;;;AAmBA,eAAsB,kBACpB,SACA,gBACmB;CACnB,MAAM,MAAM,IAAI,IAAI,QAAQ,IAAI;CAChC,MAAM,SAAS,QAAQ;CACvB,MAAM,OAAO,IAAI;AAGjB,KAAI,WAAW,SAAS,SAAS,iBAAiB;EAChD,MAAM,WAAW,eAAe,sBAAsB;AACtD,SAAO,SAAS,KAAK,EAAE,UAAU,CAAC;;AAIpC,KAAI,WAAW,UAAU,SAAS,uBAChC,KAAI;AACF,QAAM,eAAe,QAAQ;AAC7B,SAAO,SAAS,KAAK,EAAE,IAAI,MAAM,CAAC;UAC3B,KAAK;EAGZ,MAAM,eAFU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,EAEpC,QAAQ,eAAe,SAAS;AAC5D,SAAO,SAAS,KAAK,EAAE,OAAO,aAAa,EAAE,EAAE,QAAQ,KAAK,CAAC;;AAKjE,QAAO,SAAS,KAAK,EAAE,OAAO,aAAa,EAAE,EAAE,QAAQ,KAAK,CAAC;;;;;;;AAiB/D,eAAsB,mBAAmB,SAAmD;CAC1F,MAAM,UAAU,QAAQ,SAAS,WAAW;AAE5C,KAAI;EACF,MAAM,SAAS,MAAM,QAAQ,iBAAiB;AAC9C,MAAI,CAAC,OAAQ;AAEb,QAAM,QAAQ,GAAG,OAAO,IAAI,uBAAuB;GACjD,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAChD,CAAC;SACI"}

package/dist/program/program-manager.cjs

@@ -0,0 +1,162 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let ufo = require("ufo");
+let _aigne_afs = require("@aigne/afs");
+
+//#region src/program/program-manager.ts
+/**
+* ProgramManager — manages activation and deactivation of installed programs.
+*
+* Activation creates a persistent Runtime AFS, registers EventBus subscriptions
+* and cron jobs for trigger-bearing scripts. Deactivation cleans up everything.
+*/
+var ProgramManager = class {
+	activated = /* @__PURE__ */ new Map();
+	reloadLock = null;
+	deps;
+	constructor(deps) {
+		this.deps = deps;
+	}
+	/**
+	* Activate a single program by ID.
+	* Creates Runtime AFS, registers event/cron subscriptions.
+	* If already activated, deactivates first then re-activates.
+	*/
+	async activate(programId) {
+		const program = (await this.deps.listPrograms()).find((p) => p.id === programId);
+		if (!program) throw new Error(`Program "${programId}" not found in installed programs`);
+		if (this.activated.has(programId)) await this.deactivate(programId);
+		const triggerInfo = await this.deps.scanTriggers(program.installPath);
+		if (!triggerInfo || triggerInfo.triggers.length === 0) return;
+		const createAFS = this.deps.createProgramAFS ?? _aigne_afs.createProgramAFS;
+		const dataPath = this.deps.dataDir(programId);
+		const { afs, manifest, ownedProviders } = await createAFS(program.mountPath, dataPath, this.deps.globalAFS, this.deps.createProvider ? { createProvider: this.deps.createProvider } : void 0);
+		const eventUnsubs = [];
+		const cronHandles = [];
+		for (const trigger of triggerInfo.triggers) if (trigger.trigger.kind === "event" && trigger.trigger.path) {
+			if (afs.subscribe) {
+				const unsub = afs.subscribe({ path: trigger.trigger.path }, (event) => {
+					this.deps.onTrigger?.(programId, trigger.scriptPath, trigger.jobName, event);
+					this.executeTriggerJob(programId, afs, trigger, event);
+				});
+				eventUnsubs.push(unsub);
+			}
+		} else if (trigger.trigger.kind === "cron" && trigger.trigger.expression) {
+			if (this.deps.createCron) {
+				const handle = this.deps.createCron(trigger.trigger.expression, () => {
+					const cronEvent = {
+						type: "cron",
+						path: `/cron/${programId}/${trigger.jobName}`,
+						source: "program-manager",
+						timestamp: Date.now()
+					};
+					this.deps.onTrigger?.(programId, trigger.scriptPath, trigger.jobName, cronEvent);
+					this.executeTriggerJob(programId, afs, trigger, cronEvent);
+				});
+				cronHandles.push(handle);
+			}
+		}
+		this.activated.set(programId, {
+			manifest,
+			runtimeAFS: afs,
+			ownedProviders,
+			eventUnsubs,
+			cronHandles
+		});
+	}
+	/**
+	* Deactivate a program by ID.
+	* Cancels subscriptions, stops cron jobs, closes owned providers.
+	* No-op if program is not activated.
+	*/
+	async deactivate(programId) {
+		const state = this.activated.get(programId);
+		if (!state) return;
+		this.activated.delete(programId);
+		for (const unsub of state.eventUnsubs) try {
+			unsub();
+		} catch {}
+		for (const cron of state.cronHandles) try {
+			cron.stop();
+		} catch {}
+		for (const provider of state.ownedProviders) try {
+			await provider.close?.();
+		} catch {}
+	}
+	/**
+	* Activate all installed programs that have triggers.
+	* Failures on individual programs are skipped.
+	*/
+	async activateAll() {
+		const programs = await this.deps.listPrograms();
+		for (const program of programs) try {
+			await this.activate(program.id);
+		} catch (err) {
+			console.error(`[PM] Failed to activate "${program.id}":`, err instanceof Error ? err.message : err);
+		}
+	}
+	/**
+	* Deactivate all currently activated programs.
+	*/
+	async deactivateAll() {
+		const ids = [...this.activated.keys()];
+		for (const id of ids) await this.deactivate(id);
+	}
+	/**
+	* Reload all programs: deactivateAll + activateAll.
+	* Serialized via lock to prevent concurrent reloads.
+	*/
+	async reload() {
+		if (this.reloadLock) await this.reloadLock;
+		this.reloadLock = (async () => {
+			try {
+				await this.deactivateAll();
+				await this.activateAll();
+			} finally {
+				this.reloadLock = null;
+			}
+		})();
+		await this.reloadLock;
+	}
+	/**
+	* Get list of activated program IDs.
+	*/
+	getActivatedPrograms() {
+		return [...this.activated.keys()];
+	}
+	/**
+	* Execute a trigger job via the runtime AFS's ASH provider.
+	* Reads script source from /program/scripts/..., then calls /ash/.actions/run
+	* with job name and event data.
+	*/
+	async executeTriggerJob(programId, runtimeAFS, trigger, event) {
+		try {
+			const scriptPath = (0, ufo.joinURL)("/program", trigger.scriptPath);
+			if (!runtimeAFS.read) {
+				console.error(`[PM] Cannot execute trigger: runtime AFS has no read()`);
+				return;
+			}
+			const readResult = await runtimeAFS.read(scriptPath, {});
+			const source = String(readResult.data?.content ?? "");
+			if (!source.trim()) {
+				console.error(`[PM] Script source empty: ${scriptPath}`);
+				return;
+			}
+			if (!runtimeAFS.exec) {
+				console.error(`[PM] Cannot execute trigger: runtime AFS has no exec()`);
+				return;
+			}
+			const result = await runtimeAFS.exec("/ash/.actions/run", {
+				source,
+				job: trigger.jobName,
+				event,
+				_runtime_afs: runtimeAFS
+			}, {});
+			if (!result.success) console.error(`[PM] Job "${programId}/${trigger.jobName}" failed:`, result.data ?? result.error);
+		} catch (err) {
+			console.error(`[PM] Job "${programId}/${trigger.jobName}" threw:`, err instanceof Error ? err.message : err);
+		}
+	}
+};
+
+//#endregion
+exports.ProgramManager = ProgramManager;