toolcraft 0.0.766 → 0.0.768

package/composition.json

@@ -133,7 +133,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.766",
+      "version": "0.0.768",
       "license": "MIT"
     },
     {
@@ -143,7 +143,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.766",
+      "version": "0.0.768",
       "license": "MIT"
     },
     {

package/dist/composition.json

@@ -133,7 +133,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.766",
+      "version": "0.0.768",
       "license": "MIT"
     },
     {
@@ -143,7 +143,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.766",
+      "version": "0.0.768",
       "license": "MIT"
     },
     {

package/node_modules/@poe-code/safe-fs/README.md

@@ -86,7 +86,7 @@ cause. Preserve cancellation/control exceptions separately. Cross-family
 | Change the namespace | `mkdir`, `rm`, `rename`, `copyFile` |
 | Remove an empty directory | Optional `rmdir`; never a recursive-delete fallback |
 | Links and metadata | Optional `readlink`, `symlink`, `link`, `chmod`, `utimes`, `truncate` |
-| Enumerate directories lazily | Optional `iterateDirectory`; memory and native backends, with mount/overlay/readonly/quota/device/scoped delegation; backend order, no sorted-array fallback |
+| Enumerate directories lazily | Optional `iterateDirectory`; memory, native and paged S3 backends, with mount/overlay/readonly/quota/device/scoped delegation; backend order, no sorted-array fallback |
 | Stream bytes | Optional `readStream`, `writeStream`, using async iterables of byte chunks |
 | Retain an open file | Optional `open` with positioned I/O and synchronization; memory and real backends support `noFollow: true` to atomically refuse a final symlink |
 | Publish immutable objects atomically | Optional `publishFileConditional` with opaque identity/version stats and authoritative compare-and-publish |

package/node_modules/@poe-code/safe-fs/dist/fs/s3/filesystem.d.ts

@@ -109,6 +109,7 @@ export declare class S3FileSystem implements FileSystem {
     appendFile(path: string, data: Uint8Array, options?: AppendFileOptions): Promise<void>;
     mkdir(input: string, options?: MkdirOptions): Promise<void>;
     readdir(input: string, options?: ReadDirectoryOptions): Promise<DirectoryEntry[]>;
+    iterateDirectory(input: string, options?: FsOptions): AsyncIterable<DirectoryEntry>;
     private tree;
     rmdir(input: string, options?: FsOptions): Promise<void>;
     rm(input: string, options?: RemoveOptions): Promise<void>;

package/node_modules/@poe-code/safe-fs/dist/fs/s3/filesystem.js

@@ -341,25 +341,33 @@ export class S3FileSystem {
         if (key.endsWith("/") && object.Size !== 0)
             fail("ENOTSUP", "listObjectsV2", path, "nonempty slash-suffixed objects cannot be treated as directories");
     }
-    async *pages(prefix, path, options, delimiter, maxKeys = this.pageSize) {
-        const tokens = new Set();
-        let token;
-        let entries = 0;
+    async *pages(prefix, path, options, delimiter, maxKeys = this.pageSize, rememberTokens = true) {
+        // Buffered callers preserve exact repeated-token rejection. Lazy traversal
+        // detects continuation cycles without retaining the whole token history.
+        const tokens = rememberTokens ? new Set() : undefined;
+        let token, checkpoint;
+        let entries = 0, pageCount = 0, span = 0, power = 1;
         do {
             const page = await this.page(prefix, path, options, delimiter, token, maxKeys);
             entries += (page.Contents?.length ?? 0) + (page.CommonPrefixes?.length ?? 0);
-            if (entries > this.maxListEntries || tokens.size >= this.maxListEntries)
+            if (entries > this.maxListEntries || ++pageCount > this.maxListEntries)
                 fail("EFBIG", "listObjectsV2", path, "listing exceeds maxListEntries");
+            const truncated = page.IsTruncated, next = page.NextContinuationToken;
             yield page;
-            if (!page.IsTruncated)
+            if (!truncated)
                 return;
-            token = page.NextContinuationToken;
-            if (typeof token !== "string" || !token || tokens.has(token))
+            if (typeof next !== "string" || !next || next === token || next === checkpoint || tokens?.has(next))
                 fail("EIO", "listObjectsV2", path, "missing or repeated continuation token");
-            tokens.add(token);
+            if (++span === power) {
+                checkpoint = next;
+                span = 0;
+                power = Math.min(Number.MAX_SAFE_INTEGER, power * 2);
+            }
+            tokens?.add(next);
+            token = next;
         } while (true);
     }
-    async inspect(path, options) {
+    async inspect(path, options, rememberTokens = true) {
         if (path === "/") {
             const listing = await this.page(this.prefix, path, options, undefined, undefined, 1);
             const marker = this.prefix && listing.Contents?.some(object => object.Key === this.prefix)
@@ -375,7 +383,7 @@ export class S3FileSystem {
         const directoryKey = this.directoryKey(path);
         let directory = false;
         let hasMarker = false;
-        for await (const children of this.pages(directoryKey, path, options, undefined, 1)) {
+        for await (const children of this.pages(directoryKey, path, options, undefined, 1, rememberTokens)) {
             if ((children.Contents?.length ?? 0) > 0) {
                 directory = true;
                 hasMarker = children.Contents.some(object => object.Key === directoryKey);
@@ -393,7 +401,7 @@ export class S3FileSystem {
             return { stat: this.makeStat("directory", marker), ...(marker ? { metadata: marker } : {}) };
         return undefined;
     }
-    async lookup(path, options) {
+    async lookup(path, options, rememberTokens = true) {
         const ancestors = [];
         for (let parent = posix.dirname(path); path !== "/"; parent = posix.dirname(parent)) {
             ancestors.unshift(parent);
@@ -403,13 +411,13 @@ export class S3FileSystem {
         for (const parent of ancestors) {
             if (parent === "/" && this.prefix === "")
                 continue;
-            const ancestor = await this.inspect(parent, options);
+            const ancestor = await this.inspect(parent, options, rememberTokens);
             if (!ancestor)
                 fail("ENOENT", "stat", parent);
             if (ancestor.stat.type !== "directory")
                 fail("ENOTDIR", "stat", parent);
         }
-        return this.inspect(path, options);
+        return this.inspect(path, options, rememberTokens);
     }
     requireDirectorySuffix(input, info) {
         if (input.endsWith("/") && info?.stat.type === "file")
@@ -596,6 +604,37 @@ export class S3FileSystem {
         }
         return [...entries.values()].sort((left, right) => compareKeys(left.name, right.name));
     }
+    async *iterateDirectory(input, options = {}) {
+        const path = this.path(input);
+        const directory = await this.lookup(path, options, false);
+        if (!directory)
+            fail("ENOENT", "iterateDirectory", path);
+        if (directory.stat.type !== "directory")
+            fail("ENOTDIR", "iterateDirectory", path);
+        const prefix = this.directoryKey(path);
+        for await (const page of this.pages(prefix, path, options, "/", this.pageSize, false)) {
+            // Snapshot one bounded service page before yielding to caller code.
+            if ((page.Contents?.length ?? 0) + (page.CommonPrefixes?.length ?? 0) > this.pageSize)
+                fail("EIO", "iterateDirectory", path, "transport exceeded requested page size");
+            const entries = [];
+            for (const item of page.Contents ?? [])
+                if (item.Key !== prefix)
+                    entries.push({ name: item.Key.slice(prefix.length), type: "file" });
+            for (const item of page.CommonPrefixes ?? [])
+                entries.push({ name: item.Prefix.slice(prefix.length, -1), type: "directory" });
+            for (const entry of entries) {
+                this.checkAbort(options, "iterateDirectory", path);
+                if (!entry.name || entry.name.includes("/"))
+                    fail("EIO", "iterateDirectory", path, "invalid direct child in delimited listing");
+                // Revalidation preserves file/prefix collision detection across pages
+                // and follows the backend's live namespace without retaining all names.
+                const child = await this.lookup(path === "/" ? `/${entry.name}` : `${path}/${entry.name}`, options, false);
+                this.checkAbort(options, "iterateDirectory", path);
+                if (child)
+                    yield { name: entry.name, type: child.stat.type };
+            }
+        }
+    }
     async tree(path, options) {
         const objects = new Map();
         for await (const page of this.pages(this.directoryKey(path), path, options)) {

package/node_modules/@poe-code/safe-fs/dist/fs/scoped.js

@@ -444,7 +444,7 @@ export function scopeFileSystem(filesystem, charge, signal, cleanupCharge = char
                     return executeDispatch(args);
                 if (operations.has(property)) {
                     const optionIndex = ["compareEntry", "createStagedFile", "utimes"].includes(String(property)) ? 3
-                        : ["writeFile", "appendFile", "writeStream", "rename", "copyFile", "link", "symlink", "access", "chmod", "truncate", "resizeFile", "publishFileConditional", "writeFileConditional", "publishStagedFile"].includes(String(property)) ? 2 : 1;
+                        : ["writeFile", "appendFile", "writeStream", "rename", "copyFile", "link", "symlink", "access", "chmod", "truncate", "resizeFile", "publishFileConditional", "writeFileConditional", "publishStagedFile", "publishStagedFileSet"].includes(String(property)) ? 2 : 1;
                     args[optionIndex] = scopeTransportOptions((args[optionIndex] ?? {}), admit, credit);
                 }
                 return runScopedTransportBudget(admit, () => executeDispatch(args), credit);

package/node_modules/tiny-stdio-mcp-server/dist/composition.json

@@ -8,7 +8,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.766",
+      "version": "0.0.768",
       "license": "MIT"
     }
   ]

package/node_modules/toolcraft-schema/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft-schema",
-  "version": "0.0.766",
+  "version": "0.0.768",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft",
-  "version": "0.0.766",
+  "version": "0.0.768",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -175,7 +175,7 @@
     "@poe-code/terminal-text"
   ],
   "optionalDependencies": {
-    "toolcraft-schema": "0.0.766",
+    "toolcraft-schema": "0.0.768",
     "toolcraft-design": "*",
     "@poe-code/frontmatter": "*",
     "@poe-code/agent-mcp-config": "*",