@aigne/core 1.72.0 → 1.74.0-beta

package/dist/prompt/skills/afs/agent-skill/skill-loader.cjs

@@ -0,0 +1,42 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+const require_agent_skill = require('./agent-skill.cjs');
+let front_matter = require("front-matter");
+front_matter = require_rolldown_runtime.__toESM(front_matter);
+
+//#region src/prompt/skills/afs/agent-skill/skill-loader.ts
+function parseSkill(content, path) {
+	const meta = front_matter.default.default(content);
+	return {
+		path,
+		name: meta.attributes.name,
+		description: meta.attributes.description,
+		content: meta.body
+	};
+}
+async function discoverSkillsFromAFS(afs) {
+	const filtered = (await afs.listModules()).filter(({ module: m }) => m.agentSkills === true);
+	if (!filtered.length) return [];
+	const skills = [];
+	for (const module of filtered) {
+		const data = (await afs.list(module.path, {
+			pattern: "**/SKILL.md",
+			maxDepth: 10
+		}).catch(() => ({ data: [] }))).data;
+		for (const entry of data) {
+			const { data: file } = await afs.read(entry.path);
+			if (typeof file?.content !== "string") continue;
+			const dirname = entry.path.split("/").slice(0, -1).join("/");
+			const skill = parseSkill(file.content, dirname);
+			skills.push(skill);
+		}
+	}
+	return skills;
+}
+async function loadAgentSkillFromAFS({ afs }) {
+	const skills = await discoverSkillsFromAFS(afs);
+	if (!skills.length) return;
+	return new require_agent_skill.AgentSkill({ agentSkills: skills });
+}
+
+//#endregion
+exports.loadAgentSkillFromAFS = loadAgentSkillFromAFS;

package/dist/prompt/skills/afs/agent-skill/skill-loader.mjs

@@ -0,0 +1,41 @@
+import { AgentSkill } from "./agent-skill.mjs";
+import fm from "front-matter";
+
+//#region src/prompt/skills/afs/agent-skill/skill-loader.ts
+function parseSkill(content, path) {
+	const meta = fm.default(content);
+	return {
+		path,
+		name: meta.attributes.name,
+		description: meta.attributes.description,
+		content: meta.body
+	};
+}
+async function discoverSkillsFromAFS(afs) {
+	const filtered = (await afs.listModules()).filter(({ module: m }) => m.agentSkills === true);
+	if (!filtered.length) return [];
+	const skills = [];
+	for (const module of filtered) {
+		const data = (await afs.list(module.path, {
+			pattern: "**/SKILL.md",
+			maxDepth: 10
+		}).catch(() => ({ data: [] }))).data;
+		for (const entry of data) {
+			const { data: file } = await afs.read(entry.path);
+			if (typeof file?.content !== "string") continue;
+			const dirname = entry.path.split("/").slice(0, -1).join("/");
+			const skill = parseSkill(file.content, dirname);
+			skills.push(skill);
+		}
+	}
+	return skills;
+}
+async function loadAgentSkillFromAFS({ afs }) {
+	const skills = await discoverSkillsFromAFS(afs);
+	if (!skills.length) return;
+	return new AgentSkill({ agentSkills: skills });
+}
+
+//#endregion
+export { loadAgentSkillFromAFS };
+//# sourceMappingURL=skill-loader.mjs.map

package/dist/prompt/skills/afs/agent-skill/skill-loader.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.mjs","names":[],"sources":["../../../../../src/prompt/skills/afs/agent-skill/skill-loader.ts"],"sourcesContent":["import type { AFS, AFSEntry } from \"@aigne/afs\";\nimport fm from \"front-matter\";\nimport { AgentSkill } from \"./agent-skill.js\";\n\nexport interface Skill {\n  path: string;\n  name: string;\n  description: string;\n  content: string;\n}\n\nfunction parseSkill(content: string, path: string): Skill {\n  const meta = fm.default<{ name: string; description: string }>(content);\n\n  return {\n    path,\n    name: meta.attributes.name as string,\n    description: meta.attributes.description as string,\n    content: meta.body,\n  };\n}\n\nexport async function discoverSkillsFromAFS(afs: AFS): Promise<Skill[]> {\n  const modules = await afs.listModules();\n  const filtered = modules.filter(({ module: m }) => m.agentSkills === true);\n  if (!filtered.length) return [];\n\n  const skills: Skill[] = [];\n  for (const module of filtered) {\n    const data: AFSEntry[] = (\n      await afs\n        .list(module.path, {\n          pattern: \"**/SKILL.md\",\n          maxDepth: 10,\n        })\n        .catch(() => ({ data: [] }))\n    ).data;\n\n    for (const entry of data) {\n      const { data: file } = await afs.read(entry.path);\n      if (typeof file?.content !== \"string\") continue;\n\n      const dirname = entry.path.split(\"/\").slice(0, -1).join(\"/\");\n\n      const skill = parseSkill(file.content, dirname);\n      skills.push(skill);\n    }\n  }\n\n  return skills;\n}\n\nexport async function loadAgentSkillFromAFS({\n  afs,\n}: {\n  afs: AFS;\n}): Promise<AgentSkill | undefined> {\n  const skills = await discoverSkillsFromAFS(afs);\n  if (!skills.length) return;\n\n  return new AgentSkill({\n    agentSkills: skills,\n  });\n}\n"],"mappings":";;;;AAWA,SAAS,WAAW,SAAiB,MAAqB;CACxD,MAAM,OAAO,GAAG,QAA+C,QAAQ;AAEvE,QAAO;EACL;EACA,MAAM,KAAK,WAAW;EACtB,aAAa,KAAK,WAAW;EAC7B,SAAS,KAAK;EACf;;AAGH,eAAsB,sBAAsB,KAA4B;CAEtE,MAAM,YADU,MAAM,IAAI,aAAa,EACd,QAAQ,EAAE,QAAQ,QAAQ,EAAE,gBAAgB,KAAK;AAC1E,KAAI,CAAC,SAAS,OAAQ,QAAO,EAAE;CAE/B,MAAM,SAAkB,EAAE;AAC1B,MAAK,MAAM,UAAU,UAAU;EAC7B,MAAM,QACJ,MAAM,IACH,KAAK,OAAO,MAAM;GACjB,SAAS;GACT,UAAU;GACX,CAAC,CACD,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,EAC9B;AAEF,OAAK,MAAM,SAAS,MAAM;GACxB,MAAM,EAAE,MAAM,SAAS,MAAM,IAAI,KAAK,MAAM,KAAK;AACjD,OAAI,OAAO,MAAM,YAAY,SAAU;GAEvC,MAAM,UAAU,MAAM,KAAK,MAAM,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,KAAK,IAAI;GAE5D,MAAM,QAAQ,WAAW,KAAK,SAAS,QAAQ;AAC/C,UAAO,KAAK,MAAM;;;AAItB,QAAO;;AAGT,eAAsB,sBAAsB,EAC1C,OAGkC;CAClC,MAAM,SAAS,MAAM,sBAAsB,IAAI;AAC/C,KAAI,CAAC,OAAO,OAAQ;AAEpB,QAAO,IAAI,WAAW,EACpB,aAAa,QACd,CAAC"}

package/dist/prompt/skills/afs/base.cjs

@@ -0,0 +1,9 @@
+const require_agent = require('../../../agents/agent.cjs');
+
+//#region src/prompt/skills/afs/base.ts
+var AFSSkillBase = class extends require_agent.Agent {
+	tag = "AFS";
+};
+
+//#endregion
+exports.AFSSkillBase = AFSSkillBase;

package/dist/prompt/skills/afs/base.mjs

@@ -0,0 +1,10 @@
+import { Agent } from "../../../agents/agent.mjs";
+
+//#region src/prompt/skills/afs/base.ts
+var AFSSkillBase = class extends Agent {
+	tag = "AFS";
+};
+
+//#endregion
+export { AFSSkillBase };
+//# sourceMappingURL=base.mjs.map

package/dist/prompt/skills/afs/base.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.mjs","names":[],"sources":["../../../../src/prompt/skills/afs/base.ts"],"sourcesContent":["import { Agent, type Message } from \"../../../agents/agent.js\";\n\nexport abstract class AFSSkillBase<\n  I extends Message = Message,\n  O extends Message = Message,\n> extends Agent<I, O> {\n  override tag = \"AFS\";\n}\n"],"mappings":";;;AAEA,IAAsB,eAAtB,cAGU,MAAY;CACpB,AAAS,MAAM"}

package/dist/prompt/skills/afs/delete.cjs

@@ -0,0 +1,50 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_base = require('./base.cjs');
+let zod = require("zod");
+
+//#region src/prompt/skills/afs/delete.ts
+var AFSDeleteAgent = class extends require_base.AFSSkillBase {
+	constructor(options) {
+		super({
+			name: "afs_delete",
+			description: `Permanently delete files or directories from the Agentic File System (AFS)
+- Removes files or directories at the specified AFS path
+- Supports recursive deletion for directories with contents
+- Use with caution as deletion is permanent
+
+Usage:
+- The path must be an absolute AFS path starting with "/" (e.g., "/docs/old-file.md", "/temp")
+- This is NOT a local system file path - it operates within the AFS virtual file system
+- To delete a directory, you MUST set recursive=true
+- Deleting a non-empty directory without recursive=true will fail
+- This operation cannot be undone`,
+			...options,
+			inputSchema: zod.z.object({
+				path: zod.z.string().describe("Absolute AFS path to delete (e.g., '/docs/old-file.md', '/temp'). Must start with '/'"),
+				recursive: zod.z.boolean().optional().default(false).describe("MUST be set to true to delete directories. Default: false (files only)")
+			}),
+			outputSchema: zod.z.object({
+				status: zod.z.string(),
+				tool: zod.z.string(),
+				path: zod.z.string(),
+				message: zod.z.string().optional()
+			})
+		});
+	}
+	async process(input, options) {
+		if (!this.afs) throw new Error("AFS is not configured for this agent.");
+		const result = await this.afs.delete(input.path, {
+			recursive: input.recursive ?? false,
+			context: options.context
+		});
+		return {
+			status: "success",
+			tool: "afs_delete",
+			path: input.path,
+			...result
+		};
+	}
+};
+
+//#endregion
+exports.AFSDeleteAgent = AFSDeleteAgent;

package/dist/prompt/skills/afs/delete.mjs

@@ -0,0 +1,50 @@
+import { AFSSkillBase } from "./base.mjs";
+import { z as z$1 } from "zod";
+
+//#region src/prompt/skills/afs/delete.ts
+var AFSDeleteAgent = class extends AFSSkillBase {
+	constructor(options) {
+		super({
+			name: "afs_delete",
+			description: `Permanently delete files or directories from the Agentic File System (AFS)
+- Removes files or directories at the specified AFS path
+- Supports recursive deletion for directories with contents
+- Use with caution as deletion is permanent
+
+Usage:
+- The path must be an absolute AFS path starting with "/" (e.g., "/docs/old-file.md", "/temp")
+- This is NOT a local system file path - it operates within the AFS virtual file system
+- To delete a directory, you MUST set recursive=true
+- Deleting a non-empty directory without recursive=true will fail
+- This operation cannot be undone`,
+			...options,
+			inputSchema: z$1.object({
+				path: z$1.string().describe("Absolute AFS path to delete (e.g., '/docs/old-file.md', '/temp'). Must start with '/'"),
+				recursive: z$1.boolean().optional().default(false).describe("MUST be set to true to delete directories. Default: false (files only)")
+			}),
+			outputSchema: z$1.object({
+				status: z$1.string(),
+				tool: z$1.string(),
+				path: z$1.string(),
+				message: z$1.string().optional()
+			})
+		});
+	}
+	async process(input, options) {
+		if (!this.afs) throw new Error("AFS is not configured for this agent.");
+		const result = await this.afs.delete(input.path, {
+			recursive: input.recursive ?? false,
+			context: options.context
+		});
+		return {
+			status: "success",
+			tool: "afs_delete",
+			path: input.path,
+			...result
+		};
+	}
+};
+
+//#endregion
+export { AFSDeleteAgent };
+//# sourceMappingURL=delete.mjs.map

package/dist/prompt/skills/afs/delete.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.mjs","names":["z"],"sources":["../../../../src/prompt/skills/afs/delete.ts"],"sourcesContent":["import { z } from \"zod\";\nimport type { AgentInvokeOptions, AgentOptions, Message } from \"../../../agents/agent.js\";\nimport { AFSSkillBase } from \"./base.js\";\n\nexport interface AFSDeleteInput extends Message {\n  path: string;\n  recursive?: boolean;\n}\n\nexport interface AFSDeleteOutput extends Message {\n  status: string;\n  tool: string;\n  path: string;\n  message?: string;\n}\n\nexport interface AFSDeleteAgentOptions extends AgentOptions<AFSDeleteInput, AFSDeleteOutput> {\n  afs: NonNullable<AgentOptions<AFSDeleteInput, AFSDeleteOutput>[\"afs\"]>;\n}\n\nexport class AFSDeleteAgent extends AFSSkillBase<AFSDeleteInput, AFSDeleteOutput> {\n  constructor(options: AFSDeleteAgentOptions) {\n    super({\n      name: \"afs_delete\",\n      description: `Permanently delete files or directories from the Agentic File System (AFS)\n- Removes files or directories at the specified AFS path\n- Supports recursive deletion for directories with contents\n- Use with caution as deletion is permanent\n\nUsage:\n- The path must be an absolute AFS path starting with \"/\" (e.g., \"/docs/old-file.md\", \"/temp\")\n- This is NOT a local system file path - it operates within the AFS virtual file system\n- To delete a directory, you MUST set recursive=true\n- Deleting a non-empty directory without recursive=true will fail\n- This operation cannot be undone`,\n      ...options,\n      inputSchema: z.object({\n        path: z\n          .string()\n          .describe(\n            \"Absolute AFS path to delete (e.g., '/docs/old-file.md', '/temp'). Must start with '/'\",\n          ),\n        recursive: z\n          .boolean()\n          .optional()\n          .default(false)\n          .describe(\"MUST be set to true to delete directories. Default: false (files only)\"),\n      }),\n      outputSchema: z.object({\n        status: z.string(),\n        tool: z.string(),\n        path: z.string(),\n        message: z.string().optional(),\n      }),\n    });\n  }\n\n  async process(input: AFSDeleteInput, options: AgentInvokeOptions): Promise<AFSDeleteOutput> {\n    if (!this.afs) throw new Error(\"AFS is not configured for this agent.\");\n\n    const result = await this.afs.delete(input.path, {\n      recursive: input.recursive ?? false,\n      context: options.context,\n    });\n\n    return {\n      status: \"success\",\n      tool: \"afs_delete\",\n      path: input.path,\n      ...result,\n    };\n  }\n}\n"],"mappings":";;;;AAoBA,IAAa,iBAAb,cAAoC,aAA8C;CAChF,YAAY,SAAgC;AAC1C,QAAM;GACJ,MAAM;GACN,aAAa;;;;;;;;;;;GAWb,GAAG;GACH,aAAaA,IAAE,OAAO;IACpB,MAAMA,IACH,QAAQ,CACR,SACC,wFACD;IACH,WAAWA,IACR,SAAS,CACT,UAAU,CACV,QAAQ,MAAM,CACd,SAAS,yEAAyE;IACtF,CAAC;GACF,cAAcA,IAAE,OAAO;IACrB,QAAQA,IAAE,QAAQ;IAClB,MAAMA,IAAE,QAAQ;IAChB,MAAMA,IAAE,QAAQ;IAChB,SAASA,IAAE,QAAQ,CAAC,UAAU;IAC/B,CAAC;GACH,CAAC;;CAGJ,MAAM,QAAQ,OAAuB,SAAuD;AAC1F,MAAI,CAAC,KAAK,IAAK,OAAM,IAAI,MAAM,wCAAwC;EAEvE,MAAM,SAAS,MAAM,KAAK,IAAI,OAAO,MAAM,MAAM;GAC/C,WAAW,MAAM,aAAa;GAC9B,SAAS,QAAQ;GAClB,CAAC;AAEF,SAAO;GACL,QAAQ;GACR,MAAM;GACN,MAAM,MAAM;GACZ,GAAG;GACJ"}

package/dist/prompt/skills/afs/edit.cjs

@@ -0,0 +1,92 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_base = require('./base.cjs');
+let zod = require("zod");
+
+//#region src/prompt/skills/afs/edit.ts
+const CONTEXT_LINES = 4;
+var AFSEditAgent = class extends require_base.AFSSkillBase {
+	constructor(options) {
+		super({
+			name: "afs_edit",
+			description: `Performs exact string replacements in files within the Agentic File System (AFS).
+
+Usage:
+- You must use afs_read at least once before editing to understand the file content
+- The path must be an absolute AFS path starting with "/" (e.g., "/docs/readme.md")
+- Preserve exact indentation (tabs/spaces) as it appears in the file
+- The edit will FAIL if oldString is not found in the file
+- The edit will FAIL if oldString appears multiple times (unless replaceAll is true)
+- Use replaceAll to replace/rename strings across the entire file`,
+			...options,
+			inputSchema: zod.z.object({
+				path: zod.z.string().describe("Absolute AFS path to the file to edit (e.g., '/docs/readme.md'). Must start with '/'"),
+				oldString: zod.z.string().describe("The exact text to replace. Must match file content exactly including whitespace"),
+				newString: zod.z.string().describe("The text to replace it with (must be different from oldString)"),
+				replaceAll: zod.z.boolean().optional().default(false).describe("Replace all occurrences of oldString (default: false)")
+			}),
+			outputSchema: zod.z.object({
+				status: zod.z.string(),
+				tool: zod.z.string(),
+				path: zod.z.string(),
+				message: zod.z.string(),
+				snippet: zod.z.string()
+			})
+		});
+	}
+	async process(input, options) {
+		if (!this.afs) throw new Error("AFS is not configured for this agent.");
+		const { path, oldString, newString, replaceAll = false } = input;
+		if (oldString === newString) throw new Error("oldString and newString must be different");
+		const readResult = await this.afs.read(path, { context: options.context });
+		if (!readResult.data?.content || typeof readResult.data.content !== "string") throw new Error(`Cannot read file content from: ${path}`);
+		const originalContent = readResult.data.content;
+		const occurrences = this.countOccurrences(originalContent, oldString);
+		if (occurrences === 0) throw new Error(`oldString not found in file: ${path}`);
+		if (occurrences > 1 && !replaceAll) throw new Error(`oldString appears ${occurrences} times in file. Use replaceAll=true to replace all occurrences, or provide more context to make oldString unique.`);
+		const firstOccurrenceIndex = originalContent.indexOf(oldString);
+		const updatedContent = replaceAll ? originalContent.split(oldString).join(newString) : originalContent.replace(oldString, newString);
+		await this.afs.write(path, { content: updatedContent }, { context: options.context });
+		const snippet = this.extractSnippet(updatedContent, firstOccurrenceIndex, newString.length);
+		const replacementCount = replaceAll ? occurrences : 1;
+		return {
+			status: "success",
+			tool: "afs_edit",
+			path,
+			message: `Replaced ${replacementCount} occurrence${replacementCount > 1 ? "s" : ""} in ${path}`,
+			snippet
+		};
+	}
+	countOccurrences(text, search) {
+		let count = 0;
+		let position = text.indexOf(search);
+		while (position !== -1) {
+			count++;
+			position = text.indexOf(search, position + search.length);
+		}
+		return count;
+	}
+	extractSnippet(content, editStartIndex, newStringLength) {
+		const lines = content.split("\n");
+		let charCount = 0;
+		let editStartLine = 0;
+		for (let i = 0; i < lines.length; i++) {
+			const lineLength = (lines[i]?.length ?? 0) + 1;
+			if (charCount + lineLength > editStartIndex) {
+				editStartLine = i;
+				break;
+			}
+			charCount += lineLength;
+		}
+		const newContentLines = content.substring(editStartIndex, editStartIndex + newStringLength).split("\n").length;
+		const editEndLine = editStartLine + newContentLines - 1;
+		const startLine = Math.max(0, editStartLine - CONTEXT_LINES);
+		const endLine = Math.min(lines.length - 1, editEndLine + CONTEXT_LINES);
+		return lines.slice(startLine, endLine + 1).map((line, idx) => {
+			const lineNum = startLine + idx + 1;
+			return `${String(lineNum).padStart(4)}| ${line}`;
+		}).join("\n");
+	}
+};
+
+//#endregion
+exports.AFSEditAgent = AFSEditAgent;

package/dist/prompt/skills/afs/edit.mjs

@@ -0,0 +1,92 @@
+import { AFSSkillBase } from "./base.mjs";
+import { z as z$1 } from "zod";
+
+//#region src/prompt/skills/afs/edit.ts
+const CONTEXT_LINES = 4;
+var AFSEditAgent = class extends AFSSkillBase {
+	constructor(options) {
+		super({
+			name: "afs_edit",
+			description: `Performs exact string replacements in files within the Agentic File System (AFS).
+
+Usage:
+- You must use afs_read at least once before editing to understand the file content
+- The path must be an absolute AFS path starting with "/" (e.g., "/docs/readme.md")
+- Preserve exact indentation (tabs/spaces) as it appears in the file
+- The edit will FAIL if oldString is not found in the file
+- The edit will FAIL if oldString appears multiple times (unless replaceAll is true)
+- Use replaceAll to replace/rename strings across the entire file`,
+			...options,
+			inputSchema: z$1.object({
+				path: z$1.string().describe("Absolute AFS path to the file to edit (e.g., '/docs/readme.md'). Must start with '/'"),
+				oldString: z$1.string().describe("The exact text to replace. Must match file content exactly including whitespace"),
+				newString: z$1.string().describe("The text to replace it with (must be different from oldString)"),
+				replaceAll: z$1.boolean().optional().default(false).describe("Replace all occurrences of oldString (default: false)")
+			}),
+			outputSchema: z$1.object({
+				status: z$1.string(),
+				tool: z$1.string(),
+				path: z$1.string(),
+				message: z$1.string(),
+				snippet: z$1.string()
+			})
+		});
+	}
+	async process(input, options) {
+		if (!this.afs) throw new Error("AFS is not configured for this agent.");
+		const { path, oldString, newString, replaceAll = false } = input;
+		if (oldString === newString) throw new Error("oldString and newString must be different");
+		const readResult = await this.afs.read(path, { context: options.context });
+		if (!readResult.data?.content || typeof readResult.data.content !== "string") throw new Error(`Cannot read file content from: ${path}`);
+		const originalContent = readResult.data.content;
+		const occurrences = this.countOccurrences(originalContent, oldString);
+		if (occurrences === 0) throw new Error(`oldString not found in file: ${path}`);
+		if (occurrences > 1 && !replaceAll) throw new Error(`oldString appears ${occurrences} times in file. Use replaceAll=true to replace all occurrences, or provide more context to make oldString unique.`);
+		const firstOccurrenceIndex = originalContent.indexOf(oldString);
+		const updatedContent = replaceAll ? originalContent.split(oldString).join(newString) : originalContent.replace(oldString, newString);
+		await this.afs.write(path, { content: updatedContent }, { context: options.context });
+		const snippet = this.extractSnippet(updatedContent, firstOccurrenceIndex, newString.length);
+		const replacementCount = replaceAll ? occurrences : 1;
+		return {
+			status: "success",
+			tool: "afs_edit",
+			path,
+			message: `Replaced ${replacementCount} occurrence${replacementCount > 1 ? "s" : ""} in ${path}`,
+			snippet
+		};
+	}
+	countOccurrences(text, search) {
+		let count = 0;
+		let position = text.indexOf(search);
+		while (position !== -1) {
+			count++;
+			position = text.indexOf(search, position + search.length);
+		}
+		return count;
+	}
+	extractSnippet(content, editStartIndex, newStringLength) {
+		const lines = content.split("\n");
+		let charCount = 0;
+		let editStartLine = 0;
+		for (let i = 0; i < lines.length; i++) {
+			const lineLength = (lines[i]?.length ?? 0) + 1;
+			if (charCount + lineLength > editStartIndex) {
+				editStartLine = i;
+				break;
+			}
+			charCount += lineLength;
+		}
+		const newContentLines = content.substring(editStartIndex, editStartIndex + newStringLength).split("\n").length;
+		const editEndLine = editStartLine + newContentLines - 1;
+		const startLine = Math.max(0, editStartLine - CONTEXT_LINES);
+		const endLine = Math.min(lines.length - 1, editEndLine + CONTEXT_LINES);
+		return lines.slice(startLine, endLine + 1).map((line, idx) => {
+			const lineNum = startLine + idx + 1;
+			return `${String(lineNum).padStart(4)}| ${line}`;
+		}).join("\n");
+	}
+};
+
+//#endregion
+export { AFSEditAgent };
+//# sourceMappingURL=edit.mjs.map

package/dist/prompt/skills/afs/edit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.mjs","names":["z"],"sources":["../../../../src/prompt/skills/afs/edit.ts"],"sourcesContent":["import { z } from \"zod\";\nimport type { AgentInvokeOptions, AgentOptions, Message } from \"../../../agents/agent.js\";\nimport { AFSSkillBase } from \"./base.js\";\n\nconst CONTEXT_LINES = 4; // Number of lines to show before and after the edit\n\nexport interface AFSEditInput extends Message {\n  path: string;\n  oldString: string;\n  newString: string;\n  replaceAll?: boolean;\n}\n\nexport interface AFSEditOutput extends Message {\n  status: string;\n  tool: string;\n  path: string;\n  message: string;\n  snippet: string;\n}\n\nexport interface AFSEditAgentOptions extends AgentOptions<AFSEditInput, AFSEditOutput> {\n  afs: NonNullable<AgentOptions<AFSEditInput, AFSEditOutput>[\"afs\"]>;\n}\n\nexport class AFSEditAgent extends AFSSkillBase<AFSEditInput, AFSEditOutput> {\n  constructor(options: AFSEditAgentOptions) {\n    super({\n      name: \"afs_edit\",\n      description: `Performs exact string replacements in files within the Agentic File System (AFS).\n\nUsage:\n- You must use afs_read at least once before editing to understand the file content\n- The path must be an absolute AFS path starting with \"/\" (e.g., \"/docs/readme.md\")\n- Preserve exact indentation (tabs/spaces) as it appears in the file\n- The edit will FAIL if oldString is not found in the file\n- The edit will FAIL if oldString appears multiple times (unless replaceAll is true)\n- Use replaceAll to replace/rename strings across the entire file`,\n      ...options,\n      inputSchema: z.object({\n        path: z\n          .string()\n          .describe(\n            \"Absolute AFS path to the file to edit (e.g., '/docs/readme.md'). Must start with '/'\",\n          ),\n        oldString: z\n          .string()\n          .describe(\n            \"The exact text to replace. Must match file content exactly including whitespace\",\n          ),\n        newString: z\n          .string()\n          .describe(\"The text to replace it with (must be different from oldString)\"),\n        replaceAll: z\n          .boolean()\n          .optional()\n          .default(false)\n          .describe(\"Replace all occurrences of oldString (default: false)\"),\n      }),\n      outputSchema: z.object({\n        status: z.string(),\n        tool: z.string(),\n        path: z.string(),\n        message: z.string(),\n        snippet: z.string(),\n      }),\n    });\n  }\n\n  async process(input: AFSEditInput, options: AgentInvokeOptions): Promise<AFSEditOutput> {\n    if (!this.afs) throw new Error(\"AFS is not configured for this agent.\");\n\n    const { path, oldString, newString, replaceAll = false } = input;\n\n    if (oldString === newString) {\n      throw new Error(\"oldString and newString must be different\");\n    }\n\n    const readResult = await this.afs.read(path, { context: options.context });\n    if (!readResult.data?.content || typeof readResult.data.content !== \"string\") {\n      throw new Error(`Cannot read file content from: ${path}`);\n    }\n\n    const originalContent = readResult.data.content;\n\n    // Check if oldString exists in the file\n    const occurrences = this.countOccurrences(originalContent, oldString);\n    if (occurrences === 0) {\n      throw new Error(`oldString not found in file: ${path}`);\n    }\n\n    if (occurrences > 1 && !replaceAll) {\n      throw new Error(\n        `oldString appears ${occurrences} times in file. Use replaceAll=true to replace all occurrences, or provide more context to make oldString unique.`,\n      );\n    }\n\n    // Find the position of the first occurrence for snippet extraction\n    const firstOccurrenceIndex = originalContent.indexOf(oldString);\n\n    // Perform the replacement\n    const updatedContent = replaceAll\n      ? originalContent.split(oldString).join(newString)\n      : originalContent.replace(oldString, newString);\n\n    await this.afs.write(path, { content: updatedContent }, { context: options.context });\n\n    // Generate snippet around the edit location\n    const snippet = this.extractSnippet(updatedContent, firstOccurrenceIndex, newString.length);\n\n    const replacementCount = replaceAll ? occurrences : 1;\n    return {\n      status: \"success\",\n      tool: \"afs_edit\",\n      path,\n      message: `Replaced ${replacementCount} occurrence${replacementCount > 1 ? \"s\" : \"\"} in ${path}`,\n      snippet,\n    };\n  }\n\n  private countOccurrences(text: string, search: string): number {\n    let count = 0;\n    let position = text.indexOf(search);\n    while (position !== -1) {\n      count++;\n      position = text.indexOf(search, position + search.length);\n    }\n    return count;\n  }\n\n  private extractSnippet(content: string, editStartIndex: number, newStringLength: number): string {\n    const lines = content.split(\"\\n\");\n\n    // Find the line number where the edit starts\n    let charCount = 0;\n    let editStartLine = 0;\n    for (let i = 0; i < lines.length; i++) {\n      const lineLength = (lines[i]?.length ?? 0) + 1; // +1 for newline\n      if (charCount + lineLength > editStartIndex) {\n        editStartLine = i;\n        break;\n      }\n      charCount += lineLength;\n    }\n\n    // Calculate how many lines the new content spans\n    const newContentLines = content\n      .substring(editStartIndex, editStartIndex + newStringLength)\n      .split(\"\\n\").length;\n    const editEndLine = editStartLine + newContentLines - 1;\n\n    // Extract lines with context\n    const startLine = Math.max(0, editStartLine - CONTEXT_LINES);\n    const endLine = Math.min(lines.length - 1, editEndLine + CONTEXT_LINES);\n\n    // Format with line numbers (1-based)\n    const snippetLines = lines.slice(startLine, endLine + 1).map((line, idx) => {\n      const lineNum = startLine + idx + 1;\n      return `${String(lineNum).padStart(4)}| ${line}`;\n    });\n\n    return snippetLines.join(\"\\n\");\n  }\n}\n"],"mappings":"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"}

package/dist/prompt/skills/afs/exec.cjs

@@ -0,0 +1,36 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_base = require('./base.cjs');
+let zod = require("zod");
+
+//#region src/prompt/skills/afs/exec.ts
+var AFSExecAgent = class extends require_base.AFSSkillBase {
+	constructor(options) {
+		super({
+			name: "afs_exec",
+			description: `Execute files marked as executable in the Agentic File System (AFS)
+- Runs executable entries (functions, agents, skills) registered at a given AFS path
+- Passes arguments to the executable and returns its output
+- Use this to invoke dynamic functionality stored in AFS
+
+Usage:
+- The path must be an absolute AFS path to an executable entry (e.g., "/skills/summarize", "/agents/translator")
+- This is NOT a local system file path - it operates within the AFS virtual file system
+- Use afs_list to discover available executables (look for entries with execute metadata)
+- Arguments must be a valid JSON string matching the executable's input schema
+- The executable's input/output schema can be found in its metadata`,
+			...options,
+			inputSchema: zod.z.object({
+				path: zod.z.string().describe("Absolute AFS path to the executable (e.g., '/skills/summarize'). Must start with '/'"),
+				args: zod.z.string().describe("JSON string of arguments matching the executable's input schema (e.g., '{\"text\": \"hello\"}')")
+			}),
+			outputSchema: zod.z.object({ data: zod.z.record(zod.z.any()) })
+		});
+	}
+	async process(input, options) {
+		if (!this.afs) throw new Error("AFS is not configured for this agent.");
+		return { ...await this.afs.exec(input.path, JSON.parse(input.args), { context: options.context }) };
+	}
+};
+
+//#endregion
+exports.AFSExecAgent = AFSExecAgent;

package/dist/prompt/skills/afs/exec.mjs

@@ -0,0 +1,36 @@
+import { AFSSkillBase } from "./base.mjs";
+import { z as z$1 } from "zod";
+
+//#region src/prompt/skills/afs/exec.ts
+var AFSExecAgent = class extends AFSSkillBase {
+	constructor(options) {
+		super({
+			name: "afs_exec",
+			description: `Execute files marked as executable in the Agentic File System (AFS)
+- Runs executable entries (functions, agents, skills) registered at a given AFS path
+- Passes arguments to the executable and returns its output
+- Use this to invoke dynamic functionality stored in AFS
+
+Usage:
+- The path must be an absolute AFS path to an executable entry (e.g., "/skills/summarize", "/agents/translator")
+- This is NOT a local system file path - it operates within the AFS virtual file system
+- Use afs_list to discover available executables (look for entries with execute metadata)
+- Arguments must be a valid JSON string matching the executable's input schema
+- The executable's input/output schema can be found in its metadata`,
+			...options,
+			inputSchema: z$1.object({
+				path: z$1.string().describe("Absolute AFS path to the executable (e.g., '/skills/summarize'). Must start with '/'"),
+				args: z$1.string().describe("JSON string of arguments matching the executable's input schema (e.g., '{\"text\": \"hello\"}')")
+			}),
+			outputSchema: z$1.object({ data: z$1.record(z$1.any()) })
+		});
+	}
+	async process(input, options) {
+		if (!this.afs) throw new Error("AFS is not configured for this agent.");
+		return { ...await this.afs.exec(input.path, JSON.parse(input.args), { context: options.context }) };
+	}
+};
+
+//#endregion
+export { AFSExecAgent };
+//# sourceMappingURL=exec.mjs.map

package/dist/prompt/skills/afs/exec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.mjs","names":["z"],"sources":["../../../../src/prompt/skills/afs/exec.ts"],"sourcesContent":["import { z } from \"zod\";\nimport type { AgentInvokeOptions, AgentOptions, Message } from \"../../../agents/agent.js\";\nimport { AFSSkillBase } from \"./base.js\";\n\nexport interface AFSExecInput extends Message {\n  path: string;\n  args: string;\n}\n\nexport interface AFSExecOutput extends Message {\n  data: Record<string, any>;\n}\n\nexport interface AFSExecAgentOptions extends AgentOptions<AFSExecInput, AFSExecOutput> {\n  afs: NonNullable<AgentOptions<AFSExecInput, AFSExecOutput>[\"afs\"]>;\n}\n\nexport class AFSExecAgent extends AFSSkillBase<AFSExecInput, AFSExecOutput> {\n  constructor(options: AFSExecAgentOptions) {\n    super({\n      name: \"afs_exec\",\n      description: `Execute files marked as executable in the Agentic File System (AFS)\n- Runs executable entries (functions, agents, skills) registered at a given AFS path\n- Passes arguments to the executable and returns its output\n- Use this to invoke dynamic functionality stored in AFS\n\nUsage:\n- The path must be an absolute AFS path to an executable entry (e.g., \"/skills/summarize\", \"/agents/translator\")\n- This is NOT a local system file path - it operates within the AFS virtual file system\n- Use afs_list to discover available executables (look for entries with execute metadata)\n- Arguments must be a valid JSON string matching the executable's input schema\n- The executable's input/output schema can be found in its metadata`,\n      ...options,\n      inputSchema: z.object({\n        path: z\n          .string()\n          .describe(\n            \"Absolute AFS path to the executable (e.g., '/skills/summarize'). Must start with '/'\",\n          ),\n        args: z\n          .string()\n          .describe(\n            'JSON string of arguments matching the executable\\'s input schema (e.g., \\'{\"text\": \"hello\"}\\')',\n          ),\n      }),\n      outputSchema: z.object({\n        data: z.record(z.any()),\n      }),\n    });\n  }\n\n  async process(input: AFSExecInput, options: AgentInvokeOptions): Promise<AFSExecOutput> {\n    if (!this.afs) throw new Error(\"AFS is not configured for this agent.\");\n\n    return {\n      ...(await this.afs.exec(input.path, JSON.parse(input.args), { context: options.context })),\n    };\n  }\n}\n"],"mappings":";;;;AAiBA,IAAa,eAAb,cAAkC,aAA0C;CAC1E,YAAY,SAA8B;AACxC,QAAM;GACJ,MAAM;GACN,aAAa;;;;;;;;;;;GAWb,GAAG;GACH,aAAaA,IAAE,OAAO;IACpB,MAAMA,IACH,QAAQ,CACR,SACC,uFACD;IACH,MAAMA,IACH,QAAQ,CACR,SACC,kGACD;IACJ,CAAC;GACF,cAAcA,IAAE,OAAO,EACrB,MAAMA,IAAE,OAAOA,IAAE,KAAK,CAAC,EACxB,CAAC;GACH,CAAC;;CAGJ,MAAM,QAAQ,OAAqB,SAAqD;AACtF,MAAI,CAAC,KAAK,IAAK,OAAM,IAAI,MAAM,wCAAwC;AAEvE,SAAO,EACL,GAAI,MAAM,KAAK,IAAI,KAAK,MAAM,MAAM,KAAK,MAAM,MAAM,KAAK,EAAE,EAAE,SAAS,QAAQ,SAAS,CAAC,EAC1F"}

package/dist/prompt/skills/afs/index.cjs

@@ -0,0 +1,28 @@
+const require_utils_type_utils = require('../../../utils/type-utils.cjs');
+const require_skill_loader = require('./agent-skill/skill-loader.cjs');
+const require_delete = require('./delete.cjs');
+const require_edit = require('./edit.cjs');
+const require_exec = require('./exec.cjs');
+const require_list = require('./list.cjs');
+const require_read = require('./read.cjs');
+const require_rename = require('./rename.cjs');
+const require_search = require('./search.cjs');
+const require_write = require('./write.cjs');
+
+//#region src/prompt/skills/afs/index.ts
+async function getAFSSkills(afs) {
+	return [
+		new require_list.AFSListAgent({ afs }),
+		new require_search.AFSSearchAgent({ afs }),
+		new require_read.AFSReadAgent({ afs }),
+		new require_write.AFSWriteAgent({ afs }),
+		new require_edit.AFSEditAgent({ afs }),
+		new require_delete.AFSDeleteAgent({ afs }),
+		new require_rename.AFSRenameAgent({ afs }),
+		new require_exec.AFSExecAgent({ afs }),
+		await require_skill_loader.loadAgentSkillFromAFS({ afs })
+	].filter(require_utils_type_utils.isNonNullable);
+}
+
+//#endregion
+exports.getAFSSkills = getAFSSkills;

package/dist/prompt/skills/afs/index.mjs

@@ -0,0 +1,29 @@
+import { isNonNullable } from "../../../utils/type-utils.mjs";
+import { loadAgentSkillFromAFS } from "./agent-skill/skill-loader.mjs";
+import { AFSDeleteAgent } from "./delete.mjs";
+import { AFSEditAgent } from "./edit.mjs";
+import { AFSExecAgent } from "./exec.mjs";
+import { AFSListAgent } from "./list.mjs";
+import { AFSReadAgent } from "./read.mjs";
+import { AFSRenameAgent } from "./rename.mjs";
+import { AFSSearchAgent } from "./search.mjs";
+import { AFSWriteAgent } from "./write.mjs";
+
+//#region src/prompt/skills/afs/index.ts
+async function getAFSSkills(afs) {
+	return [
+		new AFSListAgent({ afs }),
+		new AFSSearchAgent({ afs }),
+		new AFSReadAgent({ afs }),
+		new AFSWriteAgent({ afs }),
+		new AFSEditAgent({ afs }),
+		new AFSDeleteAgent({ afs }),
+		new AFSRenameAgent({ afs }),
+		new AFSExecAgent({ afs }),
+		await loadAgentSkillFromAFS({ afs })
+	].filter(isNonNullable);
+}
+
+//#endregion
+export { getAFSSkills };
+//# sourceMappingURL=index.mjs.map

package/dist/prompt/skills/afs/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/prompt/skills/afs/index.ts"],"sourcesContent":["import type { AFS } from \"@aigne/afs\";\nimport type { Agent } from \"../../../agents/agent.js\";\nimport { isNonNullable } from \"../../../utils/type-utils.js\";\nimport { loadAgentSkillFromAFS } from \"./agent-skill/skill-loader.js\";\nimport { AFSDeleteAgent } from \"./delete.js\";\nimport { AFSEditAgent } from \"./edit.js\";\nimport { AFSExecAgent } from \"./exec.js\";\nimport { AFSListAgent } from \"./list.js\";\nimport { AFSReadAgent } from \"./read.js\";\nimport { AFSRenameAgent } from \"./rename.js\";\nimport { AFSSearchAgent } from \"./search.js\";\nimport { AFSWriteAgent } from \"./write.js\";\n\nexport async function getAFSSkills(afs: AFS): Promise<Agent[]> {\n  return [\n    new AFSListAgent({ afs }),\n    new AFSSearchAgent({ afs }),\n    new AFSReadAgent({ afs }),\n    new AFSWriteAgent({ afs }),\n    new AFSEditAgent({ afs }),\n    new AFSDeleteAgent({ afs }),\n    new AFSRenameAgent({ afs }),\n    new AFSExecAgent({ afs }),\n    await loadAgentSkillFromAFS({ afs }),\n  ].filter(isNonNullable);\n}\n"],"mappings":";;;;;;;;;;;;AAaA,eAAsB,aAAa,KAA4B;AAC7D,QAAO;EACL,IAAI,aAAa,EAAE,KAAK,CAAC;EACzB,IAAI,eAAe,EAAE,KAAK,CAAC;EAC3B,IAAI,aAAa,EAAE,KAAK,CAAC;EACzB,IAAI,cAAc,EAAE,KAAK,CAAC;EAC1B,IAAI,aAAa,EAAE,KAAK,CAAC;EACzB,IAAI,eAAe,EAAE,KAAK,CAAC;EAC3B,IAAI,eAAe,EAAE,KAAK,CAAC;EAC3B,IAAI,aAAa,EAAE,KAAK,CAAC;EACzB,MAAM,sBAAsB,EAAE,KAAK,CAAC;EACrC,CAAC,OAAO,cAAc"}

package/dist/prompt/skills/afs/list.cjs

@@ -0,0 +1,69 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_base = require('./base.cjs');
+let zod = require("zod");
+
+//#region src/prompt/skills/afs/list.ts
+var AFSListAgent = class extends require_base.AFSSkillBase {
+	constructor(options) {
+		super({
+			name: "afs_list",
+			description: `List contents within the Agentic File System (AFS)
+- Returns files and directories at the specified AFS path
+- Supports recursive listing with configurable depth
+- Supports glob pattern filtering to match specific files
+- By default respects .gitignore rules to filter out ignored files
+- Use this tool when you need to explore AFS contents or understand file organization
+
+Usage:
+- The path must be an absolute AFS path starting with "/" (e.g., "/", "/docs", "/memory/user")
+- This is NOT a local system file path - it operates within the AFS virtual file system
+- Use maxDepth to control recursion depth (default: 1, current directory only)
+- Use pattern to filter entries by glob pattern:
+  - "*.ts" - match TypeScript files in current directory
+  - "**/*.js" - match all JavaScript files recursively
+  - "src/**/*.{ts,tsx}" - match TypeScript files in src directory
+- Results are filtered by .gitignore by default; set disableGitignore to include ignored files`,
+			...options,
+			inputSchema: zod.z.object({
+				path: zod.z.string().describe("Absolute AFS path to list (e.g., '/', '/docs', '/memory/user'). Must start with '/'"),
+				options: zod.z.object({
+					maxDepth: zod.z.number().optional().describe("Maximum depth of directory recursion. 1 = current directory only, 2 = include subdirectories, etc. Default: 1"),
+					disableGitignore: zod.z.boolean().optional().describe("Set to true to include files normally ignored by .gitignore rules. Default: false (respects .gitignore)"),
+					maxChildren: zod.z.number().optional().describe("Maximum number of entries to return per directory. Useful for large directories to avoid overwhelming output"),
+					pattern: zod.z.string().optional().describe("Glob pattern to filter entries by path")
+				}).optional()
+			}),
+			outputSchema: zod.z.object({
+				status: zod.z.string(),
+				tool: zod.z.string(),
+				path: zod.z.string(),
+				options: zod.z.record(zod.z.any()).optional(),
+				message: zod.z.string().optional(),
+				data: zod.z.unknown()
+			})
+		});
+	}
+	formatOutput(output) {
+		if (typeof output.data === "string") return output.data;
+		return super.formatOutput(output);
+	}
+	async process(input, options) {
+		if (!this.afs) throw new Error("AFS is not configured for this agent.");
+		const { data, message } = await this.afs.list(input.path, {
+			...input.options,
+			format: "simple-list",
+			context: options.context
+		});
+		return {
+			status: "success",
+			tool: "afs_list",
+			path: input.path,
+			options: input.options,
+			message,
+			data
+		};
+	}
+};
+
+//#endregion
+exports.AFSListAgent = AFSListAgent;