@aigne/core 1.72.0-beta.2 → 1.72.0-beta.4

package/lib/cjs/loader/agents.d.ts

@@ -0,0 +1,4 @@
+import type { AgentClass } from "../agents/types.ts";
+export declare const builtinAgents: {
+    [type: string]: AgentClass;
+};

package/lib/cjs/loader/agents.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.builtinAgents = void 0;
+const agent_js_1 = require("../agents/agent.js");
+const ai_agent_js_1 = require("../agents/ai-agent.js");
+const image_agent_js_1 = require("../agents/image-agent.js");
+const mcp_agent_js_1 = require("../agents/mcp-agent.js");
+const team_agent_js_1 = require("../agents/team-agent.js");
+const transform_agent_js_1 = require("../agents/transform-agent.js");
+exports.builtinAgents = {
+    ai: ai_agent_js_1.AIAgent,
+    function: agent_js_1.FunctionAgent,
+    image: image_agent_js_1.ImageAgent,
+    mcp: mcp_agent_js_1.MCPAgent,
+    team: team_agent_js_1.TeamAgent,
+    transform: transform_agent_js_1.TransformAgent,
+};

package/lib/cjs/loader/index.d.ts

@@ -5,9 +5,8 @@ import type { ChatModel } from "../agents/chat-model.js";
 import type { ImageModel } from "../agents/image-model.js";
 import type { AIGNEOptions } from "../aigne/aigne.js";
 import type { MemoryAgent, MemoryAgentOptions } from "../memory/memory.js";
-import { PromptBuilder } from "../prompt/prompt-builder.js";
 import { type PromiseOrValue } from "../utils/type-utils.js";
-import { type Instructions, loadAgentFromYamlFile, type NestAgentSchema } from "./agent-yaml.js";
+import { loadAgentFromYamlFile, type NestAgentSchema } from "./agent-yaml.js";
 export interface LoadOptions {
     memories?: {
         new (parameters?: MemoryAgentOptions): MemoryAgent;
@@ -19,7 +18,10 @@ export interface LoadOptions {
         availableModules?: {
             module: string;
             alias?: string[];
-            create: (options?: Record<string, any>) => PromiseOrValue<AFSModule>;
+            load: (options: {
+                filepath: string;
+                parsed?: object;
+            }) => PromiseOrValue<AFSModule>;
         }[];
     };
     aigne?: z.infer<typeof aigneFileSchema>;
@@ -27,6 +29,9 @@ export interface LoadOptions {
         parent?: string;
     }) => Promise<any>;
 }
+export interface AgentLoadOptions extends LoadOptions {
+    loadNestAgent: (path: string, agent: NestAgentSchema, options: LoadOptions, agentOptions?: AgentOptions<any, any> & Record<string, unknown>) => Promise<Agent>;
+}
 export declare function load(path: string, options?: LoadOptions): Promise<AIGNEOptions>;
 export declare function loadAgent(path: string, options: LoadOptions, agentOptions?: AgentOptions): Promise<Agent>;
 export declare function loadNestAgent(path: string, agent: NestAgentSchema, options: LoadOptions, agentOptions?: AgentOptions<any, any> & Record<string, unknown>): Promise<Agent>;
@@ -67,9 +72,9 @@ declare const aigneFileSchema: z.ZodObject<{
         } | undefined, z.ZodTypeDef, number | {
             $get: string;
         } | undefined>;
-        thinkingEffort: ZodType<number | "high" | "medium" | "low" | "minimal" | {
+        thinkingEffort: ZodType<number | "high" | "low" | "medium" | "minimal" | {
             $get: string;
-        } | undefined, z.ZodTypeDef, number | "high" | "medium" | "low" | "minimal" | {
+        } | undefined, z.ZodTypeDef, number | "high" | "low" | "medium" | "minimal" | {
             $get: string;
         } | undefined>;
     }, z.ZodTypeAny, "passthrough"> | undefined, z.ZodTypeDef, z.objectInputType<{
@@ -98,9 +103,9 @@ declare const aigneFileSchema: z.ZodObject<{
         } | undefined, z.ZodTypeDef, number | {
             $get: string;
         } | undefined>;
-        thinkingEffort: ZodType<number | "high" | "medium" | "low" | "minimal" | {
+        thinkingEffort: ZodType<number | "high" | "low" | "medium" | "minimal" | {
             $get: string;
-        } | undefined, z.ZodTypeDef, number | "high" | "medium" | "low" | "minimal" | {
+        } | undefined, z.ZodTypeDef, number | "high" | "low" | "medium" | "minimal" | {
             $get: string;
         } | undefined>;
     }, z.ZodTypeAny, "passthrough"> | undefined>;
@@ -132,6 +137,7 @@ declare const aigneFileSchema: z.ZodObject<{
         chat?: string | undefined;
     } | undefined>;
 }, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
     model?: z.objectInputType<{
         model: ZodType<string | {
             $get: string;
@@ -158,13 +164,12 @@ declare const aigneFileSchema: z.ZodObject<{
         } | undefined, z.ZodTypeDef, number | {
             $get: string;
         } | undefined>;
-        thinkingEffort: ZodType<number | "high" | "medium" | "low" | "minimal" | {
+        thinkingEffort: ZodType<number | "high" | "low" | "medium" | "minimal" | {
             $get: string;
-        } | undefined, z.ZodTypeDef, number | "high" | "medium" | "low" | "minimal" | {
+        } | undefined, z.ZodTypeDef, number | "high" | "low" | "medium" | "minimal" | {
             $get: string;
         } | undefined>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
-    name?: string | undefined;
     description?: string | undefined;
     imageModel?: z.objectInputType<{
         model: ZodType<string | {
@@ -183,6 +188,7 @@ declare const aigneFileSchema: z.ZodObject<{
         chat?: string | undefined;
     } | undefined;
 }, {
+    name?: string | undefined;
     model?: z.objectInputType<{
         model: ZodType<string | {
             $get: string;
@@ -209,13 +215,12 @@ declare const aigneFileSchema: z.ZodObject<{
         } | undefined, z.ZodTypeDef, number | {
             $get: string;
         } | undefined>;
-        thinkingEffort: ZodType<number | "high" | "medium" | "low" | "minimal" | {
+        thinkingEffort: ZodType<number | "high" | "low" | "medium" | "minimal" | {
             $get: string;
-        } | undefined, z.ZodTypeDef, number | "high" | "medium" | "low" | "minimal" | {
+        } | undefined, z.ZodTypeDef, number | "high" | "low" | "medium" | "minimal" | {
             $get: string;
         } | undefined>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
-    name?: string | undefined;
     description?: string | undefined;
     imageModel?: z.objectInputType<{
         model: ZodType<string | {
@@ -239,5 +244,4 @@ export declare function loadAIGNEFile(path: string): Promise<{
     rootDir: string;
 }>;
 export declare function findAIGNEFile(path: string): Promise<string>;
-export declare function instructionsToPromptBuilder(instructions: Instructions): PromptBuilder;
 export {};

package/lib/cjs/loader/index.js

@@ -6,23 +6,16 @@ exports.loadNestAgent = loadNestAgent;
 exports.parseAgent = parseAgent;
 exports.loadAIGNEFile = loadAIGNEFile;
 exports.findAIGNEFile = findAIGNEFile;
-exports.instructionsToPromptBuilder = instructionsToPromptBuilder;
 const afs_1 = require("@aigne/afs");
 const index_js_1 = require("@aigne/platform-helpers/nodejs/index.js");
 const yaml_1 = require("yaml");
 const zod_1 = require("zod");
 const agent_js_1 = require("../agents/agent.js");
-const ai_agent_js_1 = require("../agents/ai-agent.js");
-const image_agent_js_1 = require("../agents/image-agent.js");
-const mcp_agent_js_1 = require("../agents/mcp-agent.js");
-const team_agent_js_1 = require("../agents/team-agent.js");
-const transform_agent_js_1 = require("../agents/transform-agent.js");
-const prompt_builder_js_1 = require("../prompt/prompt-builder.js");
-const template_js_1 = require("../prompt/template.js");
 const agent_utils_js_1 = require("../utils/agent-utils.js");
 const type_utils_js_1 = require("../utils/type-utils.js");
 const agent_js_js_1 = require("./agent-js.js");
 const agent_yaml_js_1 = require("./agent-yaml.js");
+const agents_js_1 = require("./agents.js");
 const schema_js_1 = require("./schema.js");
 const AIGNE_FILE_NAME = ["aigne.yaml", "aigne.yml"];
 async function load(path, options = {}) {
@@ -163,7 +156,10 @@ async function parseAgent(path, agent, options, agentOptions) {
             const mod = options?.afs?.availableModules?.find((mod) => mod.module === moduleName || mod.alias?.includes(moduleName));
             if (!mod)
                 throw new Error(`AFS module not found: ${typeof m === "string" ? m : m.module}`);
-            const module = await mod.create(typeof m === "string" ? {} : m.options);
+            const module = await mod.load({
+                filepath: path,
+                parsed: typeof m === "string" ? {} : m.options,
+            });
             afs.mount(module);
         }
     }
@@ -195,73 +191,24 @@ async function parseAgent(path, agent, options, agentOptions) {
         skills: [...(agentOptions?.skills || []), ...skills],
         afs: afs || agentOptions?.afs,
     };
-    let instructions;
-    if ("instructions" in agent && agent.instructions && ["ai", "image"].includes(agent.type)) {
-        instructions = instructionsToPromptBuilder(agent.instructions);
-    }
-    switch (agent.type) {
-        case "ai": {
-            return ai_agent_js_1.AIAgent.from({
-                ...baseOptions,
-                instructions,
-            });
-        }
-        case "image": {
-            if (!instructions)
-                throw new Error(`Missing required instructions for image agent at path: ${path}`);
-            return image_agent_js_1.ImageAgent.from({
-                ...baseOptions,
-                instructions,
-            });
-        }
-        case "mcp": {
-            if (agent.url) {
-                return mcp_agent_js_1.MCPAgent.from({
-                    ...baseOptions,
-                    url: agent.url,
-                });
-            }
-            if (agent.command) {
-                return mcp_agent_js_1.MCPAgent.from({
-                    ...baseOptions,
-                    command: agent.command,
-                    args: agent.args,
-                });
-            }
-            throw new Error(`Missing url or command in mcp agent: ${path}`);
-        }
-        case "team": {
-            return team_agent_js_1.TeamAgent.from({
-                ...baseOptions,
-                mode: agent.mode,
-                iterateOn: agent.iterateOn,
-                reflection: agent.reflection && {
-                    ...agent.reflection,
-                    reviewer: await loadNestAgent(path, agent.reflection.reviewer, options),
-                },
-            });
-        }
-        case "transform": {
-            return transform_agent_js_1.TransformAgent.from({
-                ...baseOptions,
-                jsonata: agent.jsonata,
-            });
-        }
-        case "function": {
-            return agent_js_1.FunctionAgent.from({
-                ...baseOptions,
-                process: agent.process,
-            });
+    let agentClass = agents_js_1.builtinAgents[agent.type];
+    if (!agentClass) {
+        if (!options?.require)
+            throw new Error(`Module loader is not provided to load agent type module ${agent.type} from ${path}`);
+        const Mod = await options.require(agent.type, { parent: path });
+        if (typeof Mod?.default?.prototype?.constructor !== "function") {
+            throw new Error(`The agent type module ${agent.type} does not export a default Agent class`);
         }
+        agentClass = Mod.default;
     }
-    if ("agentClass" in agent && agent.agentClass) {
-        return await agent.agentClass.load({
-            filepath: path,
-            parsed: baseOptions,
-            options,
-        });
+    if (!agentClass) {
+        throw new Error(`Unsupported agent type: ${agent.type} from ${path}`);
     }
-    throw new Error(`Unsupported agent type: ${"type" in agent ? agent.type : "unknown"} at path: ${path}`);
+    return await agentClass.load({
+        filepath: path,
+        parsed: baseOptions,
+        options: { ...options, loadNestAgent },
+    });
 }
 async function loadMemory(memories, provider, options) {
     const M = !provider
@@ -317,11 +264,3 @@ async function findAIGNEFile(path) {
     }
     throw new Error(`aigne.yaml not found in ${path}. Please ensure you are in the correct directory or provide a valid path.`);
 }
-function instructionsToPromptBuilder(instructions) {
-    return new prompt_builder_js_1.PromptBuilder({
-        instructions: template_js_1.ChatMessagesTemplate.from((0, template_js_1.parseChatMessages)(instructions.map((i) => ({
-            ...i,
-            options: { workingDir: index_js_1.nodejs.path.dirname(i.path) },
-        })))),
-    });
-}

package/lib/cjs/loader/schema.d.ts

@@ -1,4 +1,6 @@
 import { type ZodType, z } from "zod";
+import { type Role } from "../agents/chat-model.js";
+import { PromptBuilder } from "../prompt/prompt-builder.js";
 export declare const inputOutputSchema: ({ path }: {
     path: string;
 }) => z.ZodUnion<[ZodType<any, z.ZodTypeDef, any>, z.ZodEffects<z.ZodObject<{
@@ -55,9 +57,9 @@ declare const chatModelObjectSchema: z.ZodObject<{
     } | undefined, z.ZodTypeDef, number | {
         $get: string;
     } | undefined>;
-    thinkingEffort: ZodType<number | "high" | "medium" | "low" | "minimal" | {
+    thinkingEffort: ZodType<number | "high" | "low" | "medium" | "minimal" | {
         $get: string;
-    } | undefined, z.ZodTypeDef, number | "high" | "medium" | "low" | "minimal" | {
+    } | undefined, z.ZodTypeDef, number | "high" | "low" | "medium" | "minimal" | {
         $get: string;
     } | undefined>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
@@ -86,9 +88,9 @@ declare const chatModelObjectSchema: z.ZodObject<{
     } | undefined, z.ZodTypeDef, number | {
         $get: string;
     } | undefined>;
-    thinkingEffort: ZodType<number | "high" | "medium" | "low" | "minimal" | {
+    thinkingEffort: ZodType<number | "high" | "low" | "medium" | "minimal" | {
         $get: string;
-    } | undefined, z.ZodTypeDef, number | "high" | "medium" | "low" | "minimal" | {
+    } | undefined, z.ZodTypeDef, number | "high" | "low" | "medium" | "minimal" | {
         $get: string;
     } | undefined>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
@@ -117,9 +119,9 @@ declare const chatModelObjectSchema: z.ZodObject<{
     } | undefined, z.ZodTypeDef, number | {
         $get: string;
     } | undefined>;
-    thinkingEffort: ZodType<number | "high" | "medium" | "low" | "minimal" | {
+    thinkingEffort: ZodType<number | "high" | "low" | "medium" | "minimal" | {
         $get: string;
-    } | undefined, z.ZodTypeDef, number | "high" | "medium" | "low" | "minimal" | {
+    } | undefined, z.ZodTypeDef, number | "high" | "low" | "medium" | "minimal" | {
         $get: string;
     } | undefined>;
 }, z.ZodTypeAny, "passthrough">>;
@@ -149,4 +151,17 @@ export declare function camelizeSchema<T extends ZodType>(schema: T, { shallow }
     shallow?: boolean;
 }): T;
 export declare function preprocessSchema<T extends ZodType>(fn: (data: unknown) => unknown, schema: T): T;
+export type Instructions = {
+    role: Exclude<Role, "tool">;
+    content: string;
+    path: string;
+    cacheControl?: {
+        type: "ephemeral";
+        ttl?: "5m" | "1h";
+    };
+}[];
+export declare const getInstructionsSchema: ({ filepath }: {
+    filepath: string;
+}) => ZodType<Instructions>;
+export declare function instructionsToPromptBuilder(instructions: Instructions | string): PromptBuilder;
 export {};

package/lib/cjs/loader/schema.js

@@ -1,13 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.imageModelSchema = exports.chatModelSchema = exports.defaultInputSchema = exports.inputOutputSchema = void 0;
+exports.getInstructionsSchema = exports.imageModelSchema = exports.chatModelSchema = exports.defaultInputSchema = exports.inputOutputSchema = void 0;
 exports.optionalize = optionalize;
 exports.camelizeSchema = camelizeSchema;
 exports.preprocessSchema = preprocessSchema;
+exports.instructionsToPromptBuilder = instructionsToPromptBuilder;
 const index_js_1 = require("@aigne/platform-helpers/nodejs/index.js");
 const yaml_1 = require("yaml");
 const zod_1 = require("zod");
 const agent_js_1 = require("../agents/agent.js");
+const chat_model_js_1 = require("../agents/chat-model.js");
+const prompt_builder_js_1 = require("../prompt/prompt-builder.js");
+const template_js_1 = require("../prompt/template.js");
 const camelize_js_1 = require("../utils/camelize.js");
 const type_utils_js_1 = require("../utils/type-utils.js");
 const inputOutputSchema = ({ path }) => {
@@ -101,3 +105,58 @@ function camelizeSchema(schema, { shallow = true } = {}) {
 function preprocessSchema(fn, schema) {
     return zod_1.z.preprocess(fn, schema);
 }
+const instructionItemSchema = camelizeSchema(zod_1.z.union([
+    zod_1.z.object({
+        role: chat_model_js_1.roleSchema.default("system"),
+        url: zod_1.z.string(),
+        cacheControl: optionalize(zod_1.z.object({
+            type: zod_1.z.literal("ephemeral"),
+            ttl: optionalize(zod_1.z.union([zod_1.z.literal("5m"), zod_1.z.literal("1h")])),
+        })),
+    }),
+    zod_1.z.object({
+        role: chat_model_js_1.roleSchema.default("system"),
+        content: zod_1.z.string(),
+        cacheControl: optionalize(zod_1.z.object({
+            type: zod_1.z.literal("ephemeral"),
+            ttl: optionalize(zod_1.z.union([zod_1.z.literal("5m"), zod_1.z.literal("1h")])),
+        })),
+    }),
+]));
+const parseInstructionItem = ({ filepath }) => async ({ role, cacheControl, ...v }) => {
+    if (role === "tool")
+        throw new Error(`'tool' role is not allowed in instruction item in agent file ${filepath}`);
+    if ("content" in v && typeof v.content === "string") {
+        return { role, content: v.content, path: filepath, cacheControl };
+    }
+    if ("url" in v && typeof v.url === "string") {
+        const url = index_js_1.nodejs.path.isAbsolute(v.url)
+            ? v.url
+            : index_js_1.nodejs.path.join(index_js_1.nodejs.path.dirname(filepath), v.url);
+        return index_js_1.nodejs.fs
+            .readFile(url, "utf8")
+            .then((content) => ({ role, content, path: url, cacheControl }));
+    }
+    throw new Error(`Invalid instruction item in agent file ${filepath}. Expected 'content' or 'url' property`);
+};
+const getInstructionsSchema = ({ filepath }) => zod_1.z
+    .union([zod_1.z.string(), instructionItemSchema, zod_1.z.array(instructionItemSchema)])
+    .transform(async (v) => {
+    if (typeof v === "string")
+        return [{ role: "system", content: v, path: filepath }];
+    if (Array.isArray(v)) {
+        return Promise.all(v.map((item) => parseInstructionItem({ filepath })(item)));
+    }
+    return [await parseInstructionItem({ filepath })(v)];
+});
+exports.getInstructionsSchema = getInstructionsSchema;
+function instructionsToPromptBuilder(instructions) {
+    return new prompt_builder_js_1.PromptBuilder({
+        instructions: typeof instructions === "string"
+            ? instructions
+            : template_js_1.ChatMessagesTemplate.from((0, template_js_1.parseChatMessages)(instructions.map((i) => ({
+                ...i,
+                options: { workingDir: index_js_1.nodejs.path.dirname(i.path) },
+            })))),
+    });
+}

package/lib/cjs/prompt/prompt-builder.js

@@ -119,7 +119,6 @@ class PromptBuilder {
         const afs = options.agent?.afs;
         if (afs && options.agent?.historyConfig?.disabled !== true) {
             const historyModule = (await afs.listModules()).find((m) => m.module instanceof afs_history_1.AFSHistory);
-            messages.push(await template_js_1.SystemMessageTemplate.from(await (0, afs_builtin_prompt_js_1.getAFSSystemPrompt)(afs)).format({}));
             if (historyModule) {
                 const history = await afs.list(historyModule.path, {
                     limit: options.agent?.maxRetrieveMemoryCount || 10,

package/lib/cjs/prompt/skills/afs/agent-skill/agent-skill.d.ts

@@ -0,0 +1,17 @@
+import { Agent, type AgentOptions, type Message } from "../../../../agents/agent.js";
+import type { Skill } from "./skill-loader.js";
+export interface SkillToolInput extends Message {
+    skill: string;
+    args?: string;
+}
+export interface SkillToolOutput extends Message {
+    result: string;
+}
+export interface SkillToolOptions extends AgentOptions<SkillToolInput, SkillToolOutput> {
+    agentSkills: Skill[];
+}
+export declare class AgentSkill extends Agent<SkillToolInput, SkillToolOutput> {
+    constructor(options: SkillToolOptions);
+    private agentSkills;
+    process(input: SkillToolInput): Promise<SkillToolOutput>;
+}

package/lib/cjs/prompt/skills/afs/agent-skill/agent-skill.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentSkill = void 0;
+const zod_1 = require("zod");
+const agent_js_1 = require("../../../../agents/agent.js");
+const skillToolInputSchema = zod_1.z.object({
+    skill: zod_1.z.string().describe("The name of the skill agent to invoke."),
+    args: zod_1.z.string().optional().describe("The arguments to pass to the skill."),
+});
+class AgentSkill extends agent_js_1.Agent {
+    constructor(options) {
+        super({
+            name: "Skill",
+            taskTitle: "Invoke {{skill}}: {{args}}",
+            ...options,
+            description: `\
+Execute a skill within the main conversation
+
+<skills_instructions>
+When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively. Skills provide specialized capabilities and domain knowledge.
+
+When users ask you to run a "slash command" or reference "/" (e.g., "/commit", "/review-pr"), they are referring to a skill. Use this tool to invoke the corresponding skill.
+
+User: "run /commit" Assistant: [Calls Skill tool with skill: "commit"]
+How to invoke:
+
+Use this tool with the skill name and optional arguments
+
+Important:
+
+When a skill is relevant, you must invoke this tool IMMEDIATELY as your first action
+NEVER just announce or mention a skill in your text response without actually calling this tool
+This is a BLOCKING REQUIREMENT: invoke the relevant Skill tool BEFORE generating any other response about the task
+Only use skills listed in <available_skills> below
+Do not invoke a skill that is already running
+Do not use this tool for built-in CLI commands (like /help, /clear, etc.)
+</skills_instructions>
+
+<available_skills>
+${options.agentSkills.map((s) => `${s.name}: ${s.description}`).join("\n\n")}
+</available_skills>
+`,
+            inputSchema: skillToolInputSchema,
+        });
+        this.agentSkills = options.agentSkills;
+    }
+    agentSkills;
+    async process(input) {
+        const skill = this.agentSkills.find((s) => s.name === input.skill);
+        if (!skill)
+            throw new Error(`Skill not found: ${input.skill}`);
+        return {
+            result: `\
+Base directory for this skill: ${skill.path}
+
+${skill.content}
+
+${input.args ? `ARGUMENTS: ${input.args ?? "None"}` : ""}
+`,
+        };
+    }
+}
+exports.AgentSkill = AgentSkill;

package/lib/cjs/prompt/skills/afs/agent-skill/skill-loader.d.ts

@@ -0,0 +1,13 @@
+import type { AFS } from "@aigne/afs";
+import { AgentSkill } from "./agent-skill.js";
+export interface Skill {
+    path: string;
+    name: string;
+    description: string;
+    content: string;
+}
+export declare function loadSkill(path: string): Promise<Skill>;
+export declare function loadSkills(paths: string[]): Promise<Skill[]>;
+export declare function loadAgentSkillFromAFS({ afs, }: {
+    afs: AFS;
+}): Promise<AgentSkill | undefined>;

package/lib/cjs/prompt/skills/afs/agent-skill/skill-loader.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSkill = loadSkill;
+exports.loadSkills = loadSkills;
+exports.loadAgentSkillFromAFS = loadAgentSkillFromAFS;
+const index_js_1 = require("@aigne/platform-helpers/nodejs/index.js");
+const front_matter_1 = __importDefault(require("front-matter"));
+const agent_skill_js_1 = require("./agent-skill.js");
+function parseSkill(content, path) {
+    const meta = (0, front_matter_1.default)(content);
+    return {
+        path,
+        name: meta.attributes.name,
+        description: meta.attributes.description,
+        content: meta.body,
+    };
+}
+async function loadSkill(path) {
+    const entry = index_js_1.nodejs.path.join(path, "SKILL.md");
+    const skill = await index_js_1.nodejs.fs.readFile(entry, "utf-8");
+    return parseSkill(skill, path);
+}
+async function loadSkills(paths) {
+    const skills = [];
+    for (const path of paths) {
+        const skill = await loadSkill(path);
+        skills.push(skill);
+    }
+    return skills;
+}
+async function loadAgentSkillFromAFS({ afs, }) {
+    const modules = await afs.listModules();
+    const filtered = modules.filter(({ module: m }) => "options" in m &&
+        typeof m.options === "object" &&
+        m.options &&
+        "agentSkills" in m.options &&
+        m.options.agentSkills === true);
+    if (!filtered.length)
+        return;
+    const skills = [];
+    for (const module of filtered) {
+        const data = (await afs.list(module.path, {
+            pattern: "**/SKILL.md",
+        })).data;
+        for (const entry of data) {
+            const { data: file } = await afs.read(entry.path);
+            if (typeof file?.content !== "string")
+                continue;
+            const skill = parseSkill(file.content, index_js_1.nodejs.path.dirname(entry.path));
+            skills.push(skill);
+        }
+    }
+    if (!skills.length)
+        return;
+    return new agent_skill_js_1.AgentSkill({
+        agentSkills: skills,
+    });
+}

package/lib/cjs/prompt/skills/afs/delete.js

@@ -7,15 +7,27 @@ class AFSDeleteAgent extends base_js_1.AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_delete",
-            description: "Permanently delete files or directories. Use when removing unwanted files or cleaning up temporary data.",
+            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_1.z.object({
-                path: zod_1.z.string().describe("Absolute file or directory path to delete"),
+                path: zod_1.z
+                    .string()
+                    .describe("Absolute AFS path to delete (e.g., '/docs/old-file.md', '/temp'). Must start with '/'"),
                 recursive: zod_1.z
                     .boolean()
                     .optional()
                     .default(false)
-                    .describe("Allow directory deletion (default: false, required for directories)"),
+                    .describe("MUST be set to true to delete directories. Default: false (files only)"),
             }),
             outputSchema: zod_1.z.object({
                 status: zod_1.z.string(),

package/lib/cjs/prompt/skills/afs/edit.js

@@ -7,19 +7,42 @@ class AFSEditAgent extends base_js_1.AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_edit",
-            description: "Apply precise line-based patches to modify file content. Use when making targeted changes without rewriting the entire file.",
+            description: `Apply precise line-based patches to modify files in the Agentic File System (AFS)
+- Performs targeted edits using line numbers without rewriting the entire file
+- Supports both replacing and deleting line ranges
+- Multiple patches can be applied in a single operation
+
+Usage:
+- The path must be an absolute AFS path starting with "/" (e.g., "/docs/readme.md")
+- This is NOT a local system file path - it operates within the AFS virtual file system
+- IMPORTANT: You MUST use afs_read with withLineNumbers=true before editing to get accurate line numbers
+- Line numbers are 0-based: first line is 0, second line is 1, etc.
+- The range [start_line, end_line) is exclusive on end_line`,
             ...options,
             inputSchema: zod_1.z.object({
-                path: zod_1.z.string().describe("Absolute file path to edit"),
+                path: zod_1.z
+                    .string()
+                    .describe("Absolute AFS path to the file to edit (e.g., '/docs/readme.md'). Must start with '/'"),
                 patches: zod_1.z
                     .array(zod_1.z.object({
-                    start_line: zod_1.z.number().int().describe("Start line number (0-based, inclusive)"),
-                    end_line: zod_1.z.number().int().describe("End line number (0-based, exclusive)"),
-                    replace: zod_1.z.string().optional().describe("New content to replace the line range"),
-                    delete: zod_1.z.boolean().describe("Delete mode: true to delete lines, false to replace"),
+                    start_line: zod_1.z
+                        .number()
+                        .int()
+                        .describe("Start line number (0-based, inclusive). First line is 0"),
+                    end_line: zod_1.z
+                        .number()
+                        .int()
+                        .describe("End line number (0-based, exclusive). To edit line 5 only, use start_line=5, end_line=6"),
+                    replace: zod_1.z
+                        .string()
+                        .optional()
+                        .describe("New content to insert. Omit when delete=true"),
+                    delete: zod_1.z
+                        .boolean()
+                        .describe("Set to true to delete the line range. Set to false to replace with 'replace' content"),
                 }))
                     .min(1)
-                    .describe("List of patches to apply sequentially"),
+                    .describe("Array of patches to apply. Each patch specifies a line range and the operation (delete or replace)"),
             }),
             outputSchema: zod_1.z.object({
                 status: zod_1.z.string(),