@aigne/core 1.71.0-beta.2 → 1.71.0-beta.5

package/CHANGELOG.md

@@ -1,5 +1,61 @@
 # Changelog
 
+## [1.71.0-beta.5](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.71.0-beta.4...core-v1.71.0-beta.5) (2025-12-11)
+
+
+### Features
+
+* **afs:** add edit/delete/rename methods for AFS ([#820](https://github.com/AIGNE-io/aigne-framework/issues/820)) ([68cb508](https://github.com/AIGNE-io/aigne-framework/commit/68cb508d1cfc9c516d56303018139f1e567f897e))
+
+
+### Bug Fixes
+
+* **core:** support access agent instance by `this` in function agent ([#822](https://github.com/AIGNE-io/aigne-framework/issues/822)) ([68103bc](https://github.com/AIGNE-io/aigne-framework/commit/68103bc8d6d553e1c1374595db98ff61f3046842))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.3.0-beta.3
+    * @aigne/afs-history bumped to 1.1.3-beta.3
+
+## [1.71.0-beta.4](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.71.0-beta.3...core-v1.71.0-beta.4) (2025-12-10)
+
+
+### Bug Fixes
+
+* bump version ([af04b69](https://github.com/AIGNE-io/aigne-framework/commit/af04b6931951afa35d52065430acc7fef4b10087))
+* **core:** support load third agent in skills ([#819](https://github.com/AIGNE-io/aigne-framework/issues/819)) ([bcbb140](https://github.com/AIGNE-io/aigne-framework/commit/bcbb1404d2fe9c709d99a8c28883b21dd107a844))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.3.0-beta.2
+    * @aigne/afs-history bumped to 1.1.3-beta.2
+    * @aigne/observability-api bumped to 0.11.13-beta.1
+    * @aigne/platform-helpers bumped to 0.6.6-beta
+
+## [1.71.0-beta.3](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.71.0-beta.2...core-v1.71.0-beta.3) (2025-12-10)
+
+
+### Bug Fixes
+
+* **afs:** add case-sensitive option for search with case-insensitive default ([#814](https://github.com/AIGNE-io/aigne-framework/issues/814)) ([9dc9446](https://github.com/AIGNE-io/aigne-framework/commit/9dc944635104fc311e7756b4bde0a20275cfe8ec))
+* **core:** disable Immer autofreeze to return mutable response objects ([#817](https://github.com/AIGNE-io/aigne-framework/issues/817)) ([a3d0651](https://github.com/AIGNE-io/aigne-framework/commit/a3d06512cdadb9d85f92b7e8d2fd85b4f35a804b))
+* **observability:** improve trace shutdown handling and exit status  ([#813](https://github.com/AIGNE-io/aigne-framework/issues/813)) ([6215f13](https://github.com/AIGNE-io/aigne-framework/commit/6215f13243b23103c1793a4559798f0e90722384))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/afs bumped to 1.3.0-beta.1
+    * @aigne/afs-history bumped to 1.1.3-beta.1
+    * @aigne/observability-api bumped to 0.11.13-beta
+
 ## [1.71.0-beta.2](https://github.com/AIGNE-io/aigne-framework/compare/core-v1.71.0-beta.1...core-v1.71.0-beta.2) (2025-12-09)
 
 

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

@@ -938,4 +938,4 @@ export declare class FunctionAgent<I extends Message = Message, O extends Messag
  * @param context Execution context
  * @returns Processing result, can be synchronous or asynchronous
  */
-export type FunctionAgentFn<I extends Message = any, O extends Message = any> = (input: I, options: AgentInvokeOptions) => PromiseOrValue<AgentProcessResult<O>>;
+export type FunctionAgentFn<I extends Message = any, O extends Message = any, A extends FunctionAgent<I, O> = FunctionAgent<I, O>> = (this: A, input: I, options: AgentInvokeOptions) => PromiseOrValue<AgentProcessResult<O>>;

package/lib/cjs/agents/agent.js

@@ -917,7 +917,7 @@ class FunctionAgent extends Agent {
      * @returns Processing result
      */
     process(input, options) {
-        return this._process(input, options);
+        return this._process.apply(this, [input, options]);
     }
 }
 exports.FunctionAgent = FunctionAgent;

package/lib/cjs/agents/user-agent.js

@@ -32,7 +32,7 @@ class UserAgent extends agent_js_1.Agent {
     });
     async process(input, options) {
         if (this._process) {
-            return this._process(input, options);
+            return this._process.apply(this, [input, options]);
         }
         if (this.activeAgent) {
             const [output, agent] = await this.invokeChildAgent(this.activeAgent, input, {

package/lib/cjs/aigne/aigne.d.ts

@@ -113,6 +113,10 @@ export declare class AIGNE<U extends UserContext = UserContext> {
      * @hidden
      */
     readonly messageQueue: MessageQueue;
+    /**
+     * Collection of all context IDs created by this AIGNE instance.
+     */
+    readonly contextIds: Set<string>;
     /**
      * Collection of skill agents available to this AIGNE instance.
      * Provides indexed access by skill name.
@@ -324,7 +328,8 @@ export declare class AIGNE<U extends UserContext = UserContext> {
     [Symbol.asyncDispose](): Promise<void>;
     /**
      * Initializes handlers for process exit events to ensure clean shutdown.
-     * This registers handlers for SIGINT and exit events to properly terminate all agents.
+     * This registers handlers for SIGINT/SIGTERM to properly terminate all agents.
+     * Note: 'exit' event cannot run async code, so we handle cleanup in signal handlers.
      */
     private initProcessExitHandler;
 }

package/lib/cjs/aigne/aigne.js

@@ -99,6 +99,10 @@ class AIGNE {
      * @hidden
      */
     messageQueue = new message_queue_js_1.MessageQueue();
+    /**
+     * Collection of all context IDs created by this AIGNE instance.
+     */
+    contextIds = new Set();
     /**
      * Collection of skill agents available to this AIGNE instance.
      * Provides indexed access by skill name.
@@ -200,7 +204,7 @@ class AIGNE {
      */
     async shutdown() {
         // Close observer first to flush any pending traces
-        await this.observer?.close();
+        await this.observer?.close(Array.from(this.contextIds));
         for (const tool of this.skills) {
             await tool.shutdown();
         }
@@ -220,12 +224,17 @@ class AIGNE {
     }
     /**
      * Initializes handlers for process exit events to ensure clean shutdown.
-     * This registers handlers for SIGINT and exit events to properly terminate all agents.
+     * This registers handlers for SIGINT/SIGTERM to properly terminate all agents.
+     * Note: 'exit' event cannot run async code, so we handle cleanup in signal handlers.
      */
     initProcessExitHandler() {
-        const shutdownAndExit = () => this.shutdown();
+        const originalExit = process.exit;
+        // @ts-ignore
+        process.exit = (...args) => {
+            this.shutdown().finally(() => originalExit(...args));
+        };
+        const shutdownAndExit = () => this.shutdown().finally(() => originalExit(0));
         process.on("SIGINT", shutdownAndExit);
-        process.on("exit", shutdownAndExit);
     }
 }
 exports.AIGNE = AIGNE;

package/lib/cjs/aigne/context.d.ts

@@ -149,7 +149,6 @@ export interface Context<U extends UserContext = UserContext> extends TypedEvent
  * @hidden
  */
 export declare class AIGNEContext implements Context {
-    static exitCount: number;
     constructor(parent?: ConstructorParameters<typeof AIGNEContextShared>[0], { reset }?: {
         reset?: boolean;
     });
@@ -183,7 +182,6 @@ export declare class AIGNEContext implements Context {
     subscribe: Context["subscribe"];
     unsubscribe: Context["unsubscribe"];
     emit<K extends keyof ContextEmitEventMap>(eventName: K, ...args: Args<K, ContextEmitEventMap>): boolean;
-    initProcessExitHandler(): void;
     private trace;
     on<K extends keyof ContextEventMap>(eventName: K, listener: Listener<K, ContextEventMap>): this;
     once<K extends keyof ContextEventMap>(eventName: K, listener: Listener<K, ContextEventMap>): this;
@@ -194,6 +192,7 @@ declare class AIGNEContextShared {
     constructor(parent?: (Pick<Context, "model" | "imageModel" | "agents" | "skills" | "limits" | "observer" | "metadata"> & {
         messageQueue?: MessageQueue;
         events?: Emitter<any>;
+        contextIds?: Set<string>;
     }) | undefined);
     readonly messageQueue: MessageQueue;
     readonly events: Emitter<any>;
@@ -205,6 +204,7 @@ declare class AIGNEContextShared {
     get metadata(): AIGNEMetadata | undefined;
     get limits(): ContextLimits | undefined;
     usage: ContextUsage;
+    contextIds: Set<string>;
     userContext: Context["userContext"];
     memories: Context["memories"];
     hooks: AgentHooks[];

package/lib/cjs/aigne/context.js

@@ -23,7 +23,6 @@ const usage_js_1 = require("./usage.js");
  * @hidden
  */
 class AIGNEContext {
-    static exitCount = 0;
     constructor(parent, { reset } = {}) {
         const tracer = parent?.observer?.tracer;
         if (parent instanceof AIGNEContext && !reset) {
@@ -47,7 +46,7 @@ class AIGNEContext {
             this.rootId = this.span?.spanContext?.().traceId ?? (0, uuid_1.v7)();
         }
         this.id = this.span?.spanContext()?.spanId ?? (0, uuid_1.v7)();
-        this.initProcessExitHandler();
+        this.internal.contextIds.add(this.id);
     }
     id;
     parentId;
@@ -203,26 +202,6 @@ class AIGNEContext {
         this.trace(eventName, args, b);
         return this.internal.events.emit(eventName, ...newArgs);
     }
-    initProcessExitHandler() {
-        if (this.parentId)
-            return;
-        AIGNEContext.exitCount++;
-        process.once("SIGINT", async () => {
-            try {
-                if (process.env.AIGNE_OBSERVABILITY_DISABLED)
-                    return;
-                await this.observer?.update(this.id, {
-                    status: { code: api_1.SpanStatusCode.ERROR, message: "SIGINT" },
-                });
-            }
-            finally {
-                AIGNEContext.exitCount--;
-                if (AIGNEContext.exitCount === 0) {
-                    process.exit(0);
-                }
-            }
-        });
-    }
     async trace(eventName, args, b) {
         if (process.env.AIGNE_OBSERVABILITY_DISABLED)
             return;
@@ -258,12 +237,14 @@ class AIGNEContext {
                     await this.observer?.update(this.id, { output });
                     span.setStatus({ code: api_1.SpanStatusCode.OK });
                     span.end();
+                    this.internal.contextIds.delete(this.id);
                     break;
                 }
                 case "agentFailed": {
                     const { error } = args[0];
                     span.setStatus({ code: api_1.SpanStatusCode.ERROR, message: error.message });
                     span.end();
+                    this.internal.contextIds.delete(this.id);
                     break;
                 }
             }
@@ -292,6 +273,7 @@ class AIGNEContextShared {
         this.parent = parent;
         this.messageQueue = this.parent?.messageQueue ?? new message_queue_js_1.MessageQueue();
         this.events = this.parent?.events ?? new strict_event_emitter_1.Emitter();
+        this.contextIds = this.parent?.contextIds ?? new Set();
     }
     messageQueue;
     events;
@@ -317,6 +299,7 @@ class AIGNEContextShared {
         return this.parent?.limits;
     }
     usage = (0, usage_js_1.newEmptyContextUsage)();
+    contextIds;
     userContext = {};
     memories = [];
     hooks = [];

package/lib/cjs/loader/agent-js.d.ts

@@ -1 +1,2 @@
-export declare function loadAgentFromJsFile(path: string): Promise<import("../index.js").Agent<any, any> | import("./agent-yaml.js").AgentSchema>;
+import type { LoadOptions } from "./index.js";
+export declare function loadAgentFromJsFile(path: string, options: LoadOptions): Promise<import("../index.js").Agent<any, any> | import("./agent-yaml.js").AgentSchema>;

package/lib/cjs/loader/agent-js.js

@@ -7,7 +7,7 @@ const type_utils_js_1 = require("../utils/type-utils.js");
 const agent_yaml_js_1 = require("./agent-yaml.js");
 const error_js_1 = require("./error.js");
 const importFn = new Function("path", "return import(path)");
-async function loadAgentFromJsFile(path) {
+async function loadAgentFromJsFile(path, options) {
     const url = index_js_1.nodejs.path.isAbsolute(path) ? index_js_1.nodejs.url.pathToFileURL(path).toString() : path;
     const { default: agent } = await (0, type_utils_js_1.tryOrThrow)(() => importFn(url), (error) => new error_js_1.LoadJsAgentError(`Failed to load agent definition from ${url}: ${error.message}`));
     if ((0, agent_utils_js_1.isAgent)(agent))
@@ -17,5 +17,5 @@ async function loadAgentFromJsFile(path) {
         process: agent,
         name: agent.agent_name || agent.agentName || agent.name,
         ...agent,
-    }), (error) => new Error(`Failed to parse agent from ${path}: ${error.message}`));
+    }, options), (error) => new Error(`Failed to parse agent from ${path}: ${error.message}`));
 }

package/lib/cjs/loader/agent-yaml.d.ts

@@ -101,13 +101,14 @@ export interface ThirdAgentSchema extends BaseAgentSchema {
     [key: string]: any;
 }
 export type AgentSchema = AIAgentSchema | ImageAgentSchema | MCPAgentSchema | TeamAgentSchema | TransformAgentSchema | FunctionAgentSchema | ThirdAgentSchema;
-export declare function parseAgentFile(path: string, data: any): Promise<AgentSchema>;
-export declare function loadAgentFromYamlFile(path: string, options?: LoadOptions): Promise<AgentSchema>;
+export declare function parseAgentFile(path: string, data: any, options: LoadOptions): Promise<AgentSchema>;
+export declare function loadAgentFromYamlFile(path: string, options: LoadOptions): Promise<AgentSchema>;
 export declare const getInstructionsSchema: ({ filepath }: {
     filepath: string;
 }) => ZodType<Instructions>;
-export declare const getAgentSchema: ({ filepath }: {
+export declare const getAgentSchema: ({ filepath, options, }: {
     filepath: string;
+    options?: LoadOptions;
 }) => ZodType<AgentSchema, z.ZodTypeDef, AgentSchema>;
 export declare const getNestAgentSchema: ({ filepath, }: {
     filepath: string;

package/lib/cjs/loader/agent-yaml.js

@@ -13,8 +13,8 @@ const team_agent_js_1 = require("../agents/team-agent.js");
 const type_utils_js_1 = require("../utils/type-utils.js");
 const function_agent_js_1 = require("./function-agent.js");
 const schema_js_1 = require("./schema.js");
-async function parseAgentFile(path, data) {
-    const agentSchema = (0, exports.getAgentSchema)({ filepath: path });
+async function parseAgentFile(path, data, options) {
+    const agentSchema = (0, exports.getAgentSchema)({ filepath: path, options });
     return agentSchema.parseAsync({
         ...data,
         model: data.model || data.chatModel || data.chat_model,
@@ -23,22 +23,11 @@ async function parseAgentFile(path, data) {
 async function loadAgentFromYamlFile(path, options) {
     const raw = await (0, type_utils_js_1.tryOrThrow)(() => index_js_1.nodejs.fs.readFile(path, "utf8"), (error) => new Error(`Failed to load agent definition from ${path}: ${error.message}`));
     const json = (0, type_utils_js_1.tryOrThrow)(() => (0, yaml_1.parse)(raw), (error) => new Error(`Failed to parse agent definition from ${path}: ${error.message}`));
-    if (!["ai", "image", "mcp", "team", "transform", "function"].includes(json?.type)) {
-        if (typeof json?.type === "string") {
-            if (!options?.require)
-                throw new Error(`Module loader is not provided to load agent type module ${json.type} from ${path}`);
-            const Mod = await options.require(json.type, { parent: path });
-            if (typeof Mod?.default?.prototype?.constructor !== "function") {
-                throw new Error(`The agent type module ${json.type} does not export a default Agent class`);
-            }
-            json.agentClass = Mod.default;
-        }
-    }
     const agent = await (0, type_utils_js_1.tryOrThrow)(async () => await parseAgentFile(path, {
         ...json,
         type: json.type ?? "ai",
         skills: json.skills ?? json.tools,
-    }), (error) => new Error(`Failed to validate agent definition from ${path}: ${error.message}`));
+    }, options), (error) => new Error(`Failed to validate agent definition from ${path}: ${error.message}`));
     return agent;
 }
 const instructionItemSchema = zod_1.z.union([
@@ -76,7 +65,7 @@ const getInstructionsSchema = ({ filepath }) => zod_1.z
     return [await parseInstructionItem({ filepath })(v)];
 });
 exports.getInstructionsSchema = getInstructionsSchema;
-const getAgentSchema = ({ filepath }) => {
+const getAgentSchema = ({ filepath, options, }) => {
     const agentSchema = zod_1.z.lazy(() => {
         const nestAgentSchema = zod_1.z.lazy(() => zod_1.z.union([
             agentSchema,
@@ -133,7 +122,22 @@ const getAgentSchema = ({ filepath }) => {
             shareAFS: (0, schema_js_1.optionalize)(zod_1.z.boolean()),
         });
         const instructionsSchema = (0, exports.getInstructionsSchema)({ filepath: filepath });
-        return (0, schema_js_1.camelizeSchema)(zod_1.z.union([
+        return (0, schema_js_1.camelizeSchema)((0, schema_js_1.preprocessSchema)(async (json) => {
+            if (typeof json === "object" &&
+                json &&
+                "type" in json &&
+                typeof json.type === "string" &&
+                !["ai", "image", "mcp", "team", "transform", "function"].includes(json.type)) {
+                if (!options?.require)
+                    throw new Error(`Module loader is not provided to load agent type module ${json.type} from ${filepath}`);
+                const Mod = await options.require(json.type, { parent: filepath });
+                if (typeof Mod?.default?.prototype?.constructor !== "function") {
+                    throw new Error(`The agent type module ${json.type} does not export a default Agent class`);
+                }
+                Object.assign(json, { agentClass: Mod.default });
+            }
+            return json;
+        }, zod_1.z.union([
             zod_1.z
                 .object({
                 type: zod_1.z.string(),
@@ -204,7 +208,7 @@ const getAgentSchema = ({ filepath }) => {
                 })
                     .extend(baseAgentSchema.shape),
             ]),
-        ]));
+        ])));
     });
     return agentSchema;
 };

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

@@ -28,9 +28,9 @@ export interface LoadOptions {
     }) => Promise<any>;
 }
 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>;
-export declare function parseAgent(path: string, agent: Awaited<ReturnType<typeof loadAgentFromYamlFile>>, options?: LoadOptions, agentOptions?: AgentOptions): Promise<Agent>;
+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>;
+export declare function parseAgent(path: string, agent: Awaited<ReturnType<typeof loadAgentFromYamlFile>>, options: LoadOptions, agentOptions?: AgentOptions): Promise<Agent>;
 type CliAgent = string | {
     url?: string;
     name?: string;

package/lib/cjs/loader/index.js

@@ -70,7 +70,7 @@ async function load(path, options = {}) {
 }
 async function loadAgent(path, options, agentOptions) {
     if ([".js", ".mjs", ".ts", ".mts"].includes(index_js_1.nodejs.path.extname(path))) {
-        const agent = await (0, agent_js_js_1.loadAgentFromJsFile)(path);
+        const agent = await (0, agent_js_js_1.loadAgentFromJsFile)(path, options);
         if (agent instanceof agent_js_1.Agent)
             return agent;
         return parseAgent(path, agent, options, agentOptions);

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

@@ -148,4 +148,5 @@ export declare function optionalize<T>(schema: ZodType<T>): ZodType<T | undefine
 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 {};

package/lib/cjs/loader/schema.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.imageModelSchema = exports.chatModelSchema = exports.defaultInputSchema = exports.inputOutputSchema = void 0;
 exports.optionalize = optionalize;
 exports.camelizeSchema = camelizeSchema;
+exports.preprocessSchema = preprocessSchema;
 const index_js_1 = require("@aigne/platform-helpers/nodejs/index.js");
 const yaml_1 = require("yaml");
 const zod_1 = require("zod");
@@ -97,3 +98,6 @@ function optionalize(schema) {
 function camelizeSchema(schema, { shallow = true } = {}) {
     return zod_1.z.preprocess((v) => ((0, type_utils_js_1.isRecord)(v) ? (0, camelize_js_1.camelize)(v, shallow) : v), schema);
 }
+function preprocessSchema(fn, schema) {
+    return zod_1.z.preprocess(fn, schema);
+}

package/lib/cjs/memory/recorder.js

@@ -57,7 +57,7 @@ class MemoryRecorder extends agent_js_1.Agent {
         if (!this._process) {
             throw new Error("MemoryRecorder process function is not defined.");
         }
-        return this._process(input, options);
+        return this._process.apply(this, [input, options]);
     }
 }
 exports.MemoryRecorder = MemoryRecorder;

package/lib/cjs/memory/retriever.js

@@ -54,7 +54,7 @@ class MemoryRetriever extends agent_js_1.Agent {
         if (!this._process) {
             throw new Error("MemoryRetriever process function is not implemented.");
         }
-        return this._process(input, options);
+        return this._process.apply(this, [input, options]);
     }
 }
 exports.MemoryRetriever = MemoryRetriever;

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

@@ -15,7 +15,7 @@ const type_utils_js_1 = require("../utils/type-utils.js");
 const afs_builtin_prompt_js_1 = require("./prompts/afs-builtin-prompt.js");
 const memory_message_template_js_1 = require("./prompts/memory-message-template.js");
 const structured_stream_instructions_js_1 = require("./prompts/structured-stream-instructions.js");
-const afs_js_1 = require("./skills/afs.js");
+const index_js_2 = require("./skills/afs/index.js");
 const template_js_1 = require("./template.js");
 class PromptBuilder {
     static from(instructions, { workingDir } = {}) {
@@ -117,7 +117,7 @@ class PromptBuilder {
                     const afs = options.agent?.afs;
                     if (!afs)
                         return [];
-                    return (0, afs_js_1.getAFSSkills)(afs).then((skills) => skills.map((s) => (0, type_utils_js_1.pick)(s, ["name", "description"])));
+                    return (0, index_js_2.getAFSSkills)(afs).then((skills) => skills.map((s) => (0, type_utils_js_1.pick)(s, ["name", "description"])));
                 },
             },
             $agent: {
@@ -364,7 +364,7 @@ class PromptBuilder {
             .concat(options.agent?.memoryAgentsAsTools ? options.agent.memories : [])
             .flatMap((i) => (i.isInvokable ? i : i.skills)), (i) => i.name);
         if (options.agent?.afs) {
-            toolAgents.push(...(await (0, afs_js_1.getAFSSkills)(options.agent.afs)));
+            toolAgents.push(...(await (0, index_js_2.getAFSSkills)(options.agent.afs)));
         }
         const tools = toolAgents.map((i) => ({
             type: "function",

package/lib/cjs/prompt/skills/afs/delete.d.ts

@@ -0,0 +1,18 @@
+import { Agent, type AgentInvokeOptions, type AgentOptions, type Message } from "../../../agents/agent.js";
+export interface AFSDeleteInput extends Message {
+    path: string;
+    recursive?: boolean;
+}
+export interface AFSDeleteOutput extends Message {
+    status: string;
+    tool: string;
+    path: string;
+    message?: string;
+}
+export interface AFSDeleteAgentOptions extends AgentOptions<AFSDeleteInput, AFSDeleteOutput> {
+    afs: NonNullable<AgentOptions<AFSDeleteInput, AFSDeleteOutput>["afs"]>;
+}
+export declare class AFSDeleteAgent extends Agent<AFSDeleteInput, AFSDeleteOutput> {
+    constructor(options: AFSDeleteAgentOptions);
+    process(input: AFSDeleteInput, _options: AgentInvokeOptions): Promise<AFSDeleteOutput>;
+}

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

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AFSDeleteAgent = void 0;
+const zod_1 = require("zod");
+const agent_js_1 = require("../../../agents/agent.js");
+class AFSDeleteAgent extends agent_js_1.Agent {
+    constructor(options) {
+        super({
+            name: "afs_delete",
+            description: "Permanently delete files or directories. Use when removing unwanted files or cleaning up temporary data.",
+            ...options,
+            inputSchema: zod_1.z.object({
+                path: zod_1.z.string().describe("Absolute file or directory path to delete"),
+                recursive: zod_1.z
+                    .boolean()
+                    .optional()
+                    .default(false)
+                    .describe("Allow directory deletion (default: false, required for directories)"),
+            }),
+            outputSchema: zod_1.z.object({
+                status: zod_1.z.string(),
+                tool: zod_1.z.string(),
+                path: zod_1.z.string(),
+                message: zod_1.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,
+        });
+        return {
+            status: "success",
+            tool: "afs_delete",
+            path: input.path,
+            ...result,
+        };
+    }
+}
+exports.AFSDeleteAgent = AFSDeleteAgent;

package/lib/cjs/prompt/skills/afs/edit.d.ts

@@ -0,0 +1,26 @@
+import { Agent, type AgentInvokeOptions, type AgentOptions, type Message } from "../../../agents/agent.js";
+export interface Patch {
+    start_line: number;
+    end_line: number;
+    replace?: string;
+    delete: boolean;
+}
+export interface AFSEditInput extends Message {
+    path: string;
+    patches: Patch[];
+}
+export interface AFSEditOutput extends Message {
+    status: string;
+    tool: string;
+    path: string;
+    message: string;
+    content: string;
+}
+export interface AFSEditAgentOptions extends AgentOptions<AFSEditInput, AFSEditOutput> {
+    afs: NonNullable<AgentOptions<AFSEditInput, AFSEditOutput>["afs"]>;
+}
+export declare class AFSEditAgent extends Agent<AFSEditInput, AFSEditOutput> {
+    constructor(options: AFSEditAgentOptions);
+    process(input: AFSEditInput, _options: AgentInvokeOptions): Promise<AFSEditOutput>;
+    applyCustomPatches(text: string, patches: Patch[]): string;
+}