@aigne/core 1.72.0-beta.3 → 1.72.0-beta.5

package/lib/esm/prompt/skills/afs/write.js

@@ -4,16 +4,30 @@ export class AFSWriteAgent extends AFSSkillBase {
     constructor(options) {
         super({
             name: "afs_write",
-            description: "Create new file or append content to existing file. Use when creating files, rewriting entire files, or appending to files.",
+            description: `Write or create files in the Agentic File System (AFS)
+- Creates a new file or overwrites an existing file with the provided content
+- Supports append mode to add content to the end of existing files
+- Use this tool when creating new files or completely replacing file contents
+
+Usage:
+- The path must be an absolute AFS path starting with "/" (e.g., "/docs/new-file.md", "/memory/user/notes")
+- This is NOT a local system file path - it operates within the AFS virtual file system
+- By default, this tool overwrites the entire file content
+- Use append mode to add content to the end of an existing file without replacing it
+- For partial edits to existing files, prefer using afs_edit instead`,
             ...options,
             inputSchema: z.object({
-                path: z.string().describe("Absolute file path to write"),
-                content: z.string().describe("Complete file content or content to append"),
+                path: z
+                    .string()
+                    .describe("Absolute AFS path for the file to write (e.g., '/docs/new-file.md'). Must start with '/'"),
+                content: z
+                    .string()
+                    .describe("The content to write to the file. In overwrite mode, this replaces the entire file"),
                 append: z
                     .boolean()
                     .optional()
                     .default(false)
-                    .describe("Append mode: add content to end of file (default: false, overwrites file)"),
+                    .describe("Set to true to append content to the end of an existing file. Default: false (overwrites entire file)"),
             }),
             outputSchema: z.object({
                 status: z.string(),
@@ -26,7 +40,7 @@ export class AFSWriteAgent extends AFSSkillBase {
     async process(input, _options) {
         if (!this.afs)
             throw new Error("AFS is not configured for this agent.");
-        const result = await this.afs.write(input.path, {
+        const _result = await this.afs.write(input.path, {
             content: input.content,
         }, {
             append: input.append ?? false,
@@ -35,7 +49,7 @@ export class AFSWriteAgent extends AFSSkillBase {
             status: "success",
             tool: "afs_write",
             path: input.path,
-            ...result,
+            message: "File written successfully",
         };
     }
 }

package/lib/esm/prompt/template.d.ts

@@ -42,11 +42,11 @@ export declare class AgentMessageTemplate extends ChatMessageTemplate {
     static from(template?: ChatModelInputMessage["content"], toolCalls?: ChatModelOutputToolCall[], name?: string, options?: FormatOptions, cacheControl?: ChatModelInputMessage["cacheControl"]): AgentMessageTemplate;
     constructor(content?: ChatModelInputMessage["content"], toolCalls?: ChatModelOutputToolCall[] | undefined, name?: string, options?: FormatOptions, cacheControl?: ChatModelInputMessage["cacheControl"]);
     format(_variables?: Record<string, unknown>, _options?: FormatOptions): Promise<{
-        role: "agent" | "system" | "user" | "tool";
+        role: "system" | "user" | "agent" | "tool";
         name: string | undefined;
         content: ChatModelInputMessageContent | undefined;
         toolCalls: ChatModelOutputToolCall[] | undefined;
-        cacheControl: import("../agents/chat-model.js").CacheControl | undefined;
+        cacheControl: import("../index.js").CacheControl | undefined;
     }>;
 }
 export declare class ToolMessageTemplate extends ChatMessageTemplate {
@@ -54,11 +54,11 @@ export declare class ToolMessageTemplate extends ChatMessageTemplate {
     static from(content: object | string, toolCallId: string, name?: string, options?: FormatOptions, cacheControl?: ChatModelInputMessage["cacheControl"]): ToolMessageTemplate;
     constructor(content: object | string, toolCallId: string, name?: string, options?: FormatOptions, cacheControl?: ChatModelInputMessage["cacheControl"]);
     format(_variables?: Record<string, unknown>, _options?: FormatOptions): Promise<{
-        role: "agent" | "system" | "user" | "tool";
+        role: "system" | "user" | "agent" | "tool";
         name: string | undefined;
         content: ChatModelInputMessageContent | undefined;
         toolCallId: string;
-        cacheControl: import("../agents/chat-model.js").CacheControl | undefined;
+        cacheControl: import("../index.js").CacheControl | undefined;
     }>;
 }
 export declare class ChatMessagesTemplate {
@@ -83,21 +83,21 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
         ttl?: "5m" | "1h" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    role: "system";
     content: string;
-    name?: string | undefined;
+    role: "system";
     cacheControl?: {
         type: "ephemeral";
         ttl?: "5m" | "1h" | undefined;
     } | undefined;
+    name?: string | undefined;
 }, {
-    role: "system";
     content: string;
-    name?: string | undefined;
+    role: "system";
     cacheControl?: {
         type: "ephemeral";
         ttl?: "5m" | "1h" | undefined;
     } | undefined;
+    name?: string | undefined;
 }>, z.ZodObject<{
     role: z.ZodLiteral<"user">;
     content: z.ZodString;
@@ -113,21 +113,21 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
         ttl?: "5m" | "1h" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    role: "user";
     content: string;
-    name?: string | undefined;
+    role: "user";
     cacheControl?: {
         type: "ephemeral";
         ttl?: "5m" | "1h" | undefined;
     } | undefined;
+    name?: string | undefined;
 }, {
-    role: "user";
     content: string;
-    name?: string | undefined;
+    role: "user";
     cacheControl?: {
         type: "ephemeral";
         ttl?: "5m" | "1h" | undefined;
     } | undefined;
+    name?: string | undefined;
 }>, z.ZodObject<{
     role: z.ZodLiteral<"agent">;
     content: z.ZodOptional<z.ZodString>;
@@ -172,8 +172,11 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     role: "agent";
-    name?: string | undefined;
     content?: string | undefined;
+    cacheControl?: {
+        type: "ephemeral";
+        ttl?: "5m" | "1h" | undefined;
+    } | undefined;
     toolCalls?: {
         function: {
             name: string;
@@ -182,14 +185,14 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
         type: "function";
         id: string;
     }[] | undefined;
+    name?: string | undefined;
+}, {
+    role: "agent";
+    content?: string | undefined;
     cacheControl?: {
         type: "ephemeral";
         ttl?: "5m" | "1h" | undefined;
     } | undefined;
-}, {
-    role: "agent";
-    name?: string | undefined;
-    content?: string | undefined;
     toolCalls?: {
         function: {
             name: string;
@@ -198,10 +201,7 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
         type: "function";
         id: string;
     }[] | undefined;
-    cacheControl?: {
-        type: "ephemeral";
-        ttl?: "5m" | "1h" | undefined;
-    } | undefined;
+    name?: string | undefined;
 }>, z.ZodObject<{
     role: z.ZodLiteral<"tool">;
     content: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, string, string | Record<string, unknown>>;
@@ -218,23 +218,23 @@ declare const chatMessageSchema: z.ZodUnion<[z.ZodObject<{
         ttl?: "5m" | "1h" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    role: "tool";
     content: string;
+    role: "tool";
     toolCallId: string;
-    name?: string | undefined;
     cacheControl?: {
         type: "ephemeral";
         ttl?: "5m" | "1h" | undefined;
     } | undefined;
+    name?: string | undefined;
 }, {
-    role: "tool";
     content: string | Record<string, unknown>;
+    role: "tool";
     toolCallId: string;
-    name?: string | undefined;
     cacheControl?: {
         type: "ephemeral";
         ttl?: "5m" | "1h" | undefined;
     } | undefined;
+    name?: string | undefined;
 }>]>;
 export declare function safeParseChatMessages(messages: unknown): ChatMessageTemplate[] | undefined;
 export declare function parseChatMessages(messages: (z.infer<typeof chatMessageSchema> & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/core",
-  "version": "1.72.0-beta.3",
+  "version": "1.72.0-beta.5",
   "description": "The functional core of agentic AI",
   "publishConfig": {
     "access": "public"
@@ -78,6 +78,7 @@
     "debug": "^4.4.3",
     "eventsource-parser": "^3.0.6",
     "fast-deep-equal": "^3.1.3",
+    "front-matter": "^4.0.2",
     "immer": "^10.1.3",
     "is-network-error": "^1.2.0",
     "jaison": "^2.0.2",
@@ -92,10 +93,10 @@
     "zod": "^3.25.67",
     "zod-from-json-schema": "^0.0.5",
     "zod-to-json-schema": "^3.24.6",
-    "@aigne/afs": "^1.4.0-beta.2",
-    "@aigne/platform-helpers": "^0.6.7-beta",
+    "@aigne/afs": "^1.4.0-beta.3",
     "@aigne/observability-api": "^0.11.14-beta.1",
-    "@aigne/afs-history": "^1.2.0-beta.2"
+    "@aigne/afs-history": "^1.2.0-beta.3",
+    "@aigne/platform-helpers": "^0.6.7-beta"
   },
   "devDependencies": {
     "@types/bun": "^1.2.22",