@aigne/afs 1.4.0-beta.1 → 1.4.0-beta.3

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.4.0-beta.3](https://github.com/AIGNE-io/aigne-framework/compare/afs-v1.4.0-beta.2...afs-v1.4.0-beta.3) (2025-12-24)
+
+
+### Features
+
+* add Agent Skill support ([#787](https://github.com/AIGNE-io/aigne-framework/issues/787)) ([f04fbe7](https://github.com/AIGNE-io/aigne-framework/commit/f04fbe76ec24cf3c59c74adf92d87b0c3784a8f7))
+
+## [1.4.0-beta.2](https://github.com/AIGNE-io/aigne-framework/compare/afs-v1.4.0-beta.1...afs-v1.4.0-beta.2) (2025-12-19)
+
+
+### Bug Fixes
+
+* **afs:** use simple-list instead of tree as default type ([#839](https://github.com/AIGNE-io/aigne-framework/issues/839)) ([65a9a40](https://github.com/AIGNE-io/aigne-framework/commit/65a9a4054b3bdad6f7e40357299ef3dc48f7c3e4))
+
 ## [1.4.0-beta.1](https://github.com/AIGNE-io/aigne-framework/compare/afs-v1.4.0-beta...afs-v1.4.0-beta.1) (2025-12-17)
 
 

package/lib/cjs/afs.d.ts

@@ -28,5 +28,7 @@ export declare class AFS extends Emitter<AFSRootEvents> implements AFSRoot {
     private _search;
     private findModules;
     exec(path: string, args: Record<string, any>, options: AFSExecOptions): Promise<AFSExecResult>;
+    private buildSimpleListView;
     private buildTreeView;
+    private buildMetadataSuffix;
 }

package/lib/cjs/afs.js

@@ -161,12 +161,14 @@ class AFS extends strict_event_emitter_1.Emitter {
             ? await dedupe.invoke({ data: mapped }, options).then((res) => res.data)
             : mapped;
         let formatted = deduped;
-        if (format === "tree") {
+        if (format === "simple-list" || format === "tree") {
             const valid = zod_1.z.array(type_js_1.afsEntrySchema).safeParse(deduped);
-            if (valid.data)
-                formatted = this.buildTreeView(valid.data);
-            else
+            if (!valid.data)
                 throw new Error("Tree format requires entries to be AFSEntry objects");
+            if (format === "tree")
+                formatted = this.buildTreeView(valid.data);
+            else if (format === "simple-list")
+                formatted = this.buildSimpleListView(valid.data);
         }
         else if (typeof format === "object" && typeof format.invoke === "function") {
             formatted = await format.invoke({ data: deduped }, options).then((res) => res.data);
@@ -233,6 +235,9 @@ class AFS extends strict_event_emitter_1.Emitter {
             throw new Error(`No module found for path: ${path}`);
         return await module.module.exec(module.subpath, args, options);
     }
+    buildSimpleListView(entries) {
+        return entries.map((entry) => `${entry.path}${this.buildMetadataSuffix(entry)}`);
+    }
     buildTreeView(entries) {
         const tree = {};
         const entryMap = new Map();
@@ -254,23 +259,7 @@ class AFS extends strict_event_emitter_1.Emitter {
                 const isLast = index === keys.length - 1;
                 const fullPath = currentPath ? `${currentPath}/${key}` : `/${key}`;
                 const entry = entryMap.get(fullPath);
-                // Build metadata suffix
-                const metadataParts = [];
-                // Children count
-                const childrenCount = entry?.metadata?.childrenCount;
-                if (typeof childrenCount === "number") {
-                    metadataParts.push(`${childrenCount} items`);
-                }
-                // Children truncated
-                if (entry?.metadata?.childrenTruncated) {
-                    metadataParts.push("truncated");
-                }
-                // Executable
-                if (entry?.metadata?.execute) {
-                    metadataParts.push("executable");
-                }
-                const metadataSuffix = metadataParts.length > 0 ? ` [${metadataParts.join(", ")}]` : "";
-                result += `${prefix}${isLast ? "└── " : "├── "}${key}${metadataSuffix}`;
+                result += `${prefix}${isLast ? "└── " : "├── "}${key}${entry ? this.buildMetadataSuffix(entry) : ""}`;
                 result += `\n`;
                 result += renderTree(node[key], `${prefix}${isLast ? "    " : "│   "}`, fullPath);
             });
@@ -278,5 +267,24 @@ class AFS extends strict_event_emitter_1.Emitter {
         };
         return renderTree(tree);
     }
+    buildMetadataSuffix(entry) {
+        // Build metadata suffix
+        const metadataParts = [];
+        // Children count
+        const childrenCount = entry?.metadata?.childrenCount;
+        if (typeof childrenCount === "number") {
+            metadataParts.push(`${childrenCount} items`);
+        }
+        // Children truncated
+        if (entry?.metadata?.childrenTruncated) {
+            metadataParts.push("truncated");
+        }
+        // Executable
+        if (entry?.metadata?.execute) {
+            metadataParts.push("executable");
+        }
+        const metadataSuffix = metadataParts.length > 0 ? ` [${metadataParts.join(", ")}]` : "";
+        return metadataSuffix;
+    }
 }
 exports.AFS = AFS;

package/lib/cjs/type.d.ts

@@ -15,6 +15,11 @@ export interface AFSListOptions {
      * @default false
      */
     disableGitignore?: boolean;
+    /**
+     * Glob pattern to filter entries by path.
+     * Examples: "*.ts", "**\/*.js", "src/**\/*.{ts,tsx}"
+     */
+    pattern?: string;
     context?: any;
 }
 export interface AFSListResult {
@@ -151,7 +156,7 @@ export interface AFSContextPreset {
     }, {
         data: unknown;
     }>;
-    format?: "default" | "tree" | AFSContextPresetOptionAgent<{
+    format?: "default" | "simple-list" | "tree" | AFSContextPresetOptionAgent<{
         data: unknown;
     }, {
         data: unknown;

package/lib/dts/afs.d.ts

@@ -28,5 +28,7 @@ export declare class AFS extends Emitter<AFSRootEvents> implements AFSRoot {
     private _search;
     private findModules;
     exec(path: string, args: Record<string, any>, options: AFSExecOptions): Promise<AFSExecResult>;
+    private buildSimpleListView;
     private buildTreeView;
+    private buildMetadataSuffix;
 }

package/lib/dts/type.d.ts

@@ -15,6 +15,11 @@ export interface AFSListOptions {
      * @default false
      */
     disableGitignore?: boolean;
+    /**
+     * Glob pattern to filter entries by path.
+     * Examples: "*.ts", "**\/*.js", "src/**\/*.{ts,tsx}"
+     */
+    pattern?: string;
     context?: any;
 }
 export interface AFSListResult {
@@ -151,7 +156,7 @@ export interface AFSContextPreset {
     }, {
         data: unknown;
     }>;
-    format?: "default" | "tree" | AFSContextPresetOptionAgent<{
+    format?: "default" | "simple-list" | "tree" | AFSContextPresetOptionAgent<{
         data: unknown;
     }, {
         data: unknown;

package/lib/esm/afs.d.ts

@@ -28,5 +28,7 @@ export declare class AFS extends Emitter<AFSRootEvents> implements AFSRoot {
     private _search;
     private findModules;
     exec(path: string, args: Record<string, any>, options: AFSExecOptions): Promise<AFSExecResult>;
+    private buildSimpleListView;
     private buildTreeView;
+    private buildMetadataSuffix;
 }

package/lib/esm/afs.js

@@ -158,12 +158,14 @@ export class AFS extends Emitter {
             ? await dedupe.invoke({ data: mapped }, options).then((res) => res.data)
             : mapped;
         let formatted = deduped;
-        if (format === "tree") {
+        if (format === "simple-list" || format === "tree") {
             const valid = z.array(afsEntrySchema).safeParse(deduped);
-            if (valid.data)
-                formatted = this.buildTreeView(valid.data);
-            else
+            if (!valid.data)
                 throw new Error("Tree format requires entries to be AFSEntry objects");
+            if (format === "tree")
+                formatted = this.buildTreeView(valid.data);
+            else if (format === "simple-list")
+                formatted = this.buildSimpleListView(valid.data);
         }
         else if (typeof format === "object" && typeof format.invoke === "function") {
             formatted = await format.invoke({ data: deduped }, options).then((res) => res.data);
@@ -230,6 +232,9 @@ export class AFS extends Emitter {
             throw new Error(`No module found for path: ${path}`);
         return await module.module.exec(module.subpath, args, options);
     }
+    buildSimpleListView(entries) {
+        return entries.map((entry) => `${entry.path}${this.buildMetadataSuffix(entry)}`);
+    }
     buildTreeView(entries) {
         const tree = {};
         const entryMap = new Map();
@@ -251,23 +256,7 @@ export class AFS extends Emitter {
                 const isLast = index === keys.length - 1;
                 const fullPath = currentPath ? `${currentPath}/${key}` : `/${key}`;
                 const entry = entryMap.get(fullPath);
-                // Build metadata suffix
-                const metadataParts = [];
-                // Children count
-                const childrenCount = entry?.metadata?.childrenCount;
-                if (typeof childrenCount === "number") {
-                    metadataParts.push(`${childrenCount} items`);
-                }
-                // Children truncated
-                if (entry?.metadata?.childrenTruncated) {
-                    metadataParts.push("truncated");
-                }
-                // Executable
-                if (entry?.metadata?.execute) {
-                    metadataParts.push("executable");
-                }
-                const metadataSuffix = metadataParts.length > 0 ? ` [${metadataParts.join(", ")}]` : "";
-                result += `${prefix}${isLast ? "└── " : "├── "}${key}${metadataSuffix}`;
+                result += `${prefix}${isLast ? "└── " : "├── "}${key}${entry ? this.buildMetadataSuffix(entry) : ""}`;
                 result += `\n`;
                 result += renderTree(node[key], `${prefix}${isLast ? "    " : "│   "}`, fullPath);
             });
@@ -275,4 +264,23 @@ export class AFS extends Emitter {
         };
         return renderTree(tree);
     }
+    buildMetadataSuffix(entry) {
+        // Build metadata suffix
+        const metadataParts = [];
+        // Children count
+        const childrenCount = entry?.metadata?.childrenCount;
+        if (typeof childrenCount === "number") {
+            metadataParts.push(`${childrenCount} items`);
+        }
+        // Children truncated
+        if (entry?.metadata?.childrenTruncated) {
+            metadataParts.push("truncated");
+        }
+        // Executable
+        if (entry?.metadata?.execute) {
+            metadataParts.push("executable");
+        }
+        const metadataSuffix = metadataParts.length > 0 ? ` [${metadataParts.join(", ")}]` : "";
+        return metadataSuffix;
+    }
 }

package/lib/esm/type.d.ts

@@ -15,6 +15,11 @@ export interface AFSListOptions {
      * @default false
      */
     disableGitignore?: boolean;
+    /**
+     * Glob pattern to filter entries by path.
+     * Examples: "*.ts", "**\/*.js", "src/**\/*.{ts,tsx}"
+     */
+    pattern?: string;
     context?: any;
 }
 export interface AFSListResult {
@@ -151,7 +156,7 @@ export interface AFSContextPreset {
     }, {
         data: unknown;
     }>;
-    format?: "default" | "tree" | AFSContextPresetOptionAgent<{
+    format?: "default" | "simple-list" | "tree" | AFSContextPresetOptionAgent<{
         data: unknown;
     }, {
         data: unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/afs",
-  "version": "1.4.0-beta.1",
+  "version": "1.4.0-beta.3",
   "description": "Agentic File System (AFS) is a virtual file system that supports various storage backends and provides a unified API for file operations.",
   "publishConfig": {
     "access": "public"