toolcraft 0.0.864 → 0.0.865

package/composition.json

@@ -138,7 +138,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.864",
+      "version": "0.0.865",
       "license": "MIT"
     },
     {
@@ -148,7 +148,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.864",
+      "version": "0.0.865",
       "license": "MIT"
     },
     {

package/dist/composition.json

@@ -138,7 +138,7 @@
     },
     {
       "name": "toolcraft",
-      "version": "0.0.864",
+      "version": "0.0.865",
       "license": "MIT"
     },
     {
@@ -148,7 +148,7 @@
     },
     {
       "name": "toolcraft-schema",
-      "version": "0.0.864",
+      "version": "0.0.865",
       "license": "MIT"
     },
     {

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

@@ -119,6 +119,8 @@ identities without a default device-count budget. Their optional `maxDevices` ac
 `Infinity` or a positive safe integer. Explicit budgets remain enforced; device numbers
 must still fit the disjoint application/runtime ranges of the uint32 Python stat ABI.
 
+Python filesystem directory cursors use `iterateDirectory` when available, share open-handle admission with files, and drain pending reads before cleanup. Backends without lazy enumeration retain the buffered `readdir` fallback.
+
 `withObjectFileDescriptors(fs, store)` supports large shell and Python descriptor
 writes when the host supplies `store.createStaging`: private externally backed
 pages keep working memory bounded without publishing the growing file after

package/node_modules/@poe-code/safe-fs/dist/python/directory.d.ts

@@ -0,0 +1,9 @@
+import type { FileSystem, FsOptions } from '../contracts/filesystem.js';
+/** One prefetched entry makes acquisition errors eager without buffering a listing. */
+export declare class PythonDirectory {
+    #private;
+    constructor(fs: FileSystem, path: string, options: FsOptions, limit: number);
+    prepare(): Promise<void>;
+    next(): Promise<string | null>;
+    close(): Promise<void>;
+}

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

@@ -0,0 +1,38 @@
+import { FsError } from '../contracts/errors.js';
+/** One prefetched entry makes acquisition errors eager without buffering a listing. */
+export class PythonDirectory {
+    #first;
+    #tail = Promise.resolve();
+    #closing;
+    #count = 0;
+    #iterator;
+    #options;
+    #limit;
+    constructor(fs, path, options, limit) {
+        this.#options = options;
+        this.#limit = limit;
+        const source = fs.iterateDirectory ? fs.iterateDirectory(path, options) : (async function* () { yield* await fs.readdir(path, { ...options, ...limit === Infinity ? {} : { maxEntries: limit } }); })();
+        this.#iterator = source[Symbol.asyncIterator]();
+    }
+    async prepare() { this.#first = await this.#iterator.next(); }
+    next() {
+        if (this.#closing)
+            return Promise.reject(new FsError('EBADF'));
+        const work = this.#tail.then(async () => {
+            this.#options.signal?.throwIfAborted();
+            const value = this.#first ?? await this.#iterator.next();
+            this.#first = undefined;
+            this.#options.signal?.throwIfAborted();
+            if (value.done)
+                return null;
+            if (++this.#count > this.#limit)
+                throw new FsError('EFBIG', { syscall: 'readdir' });
+            return value.value.name;
+        });
+        this.#tail = work.catch(() => { });
+        return work;
+    }
+    close() {
+        return this.#closing ??= this.#tail.then(async () => { this.#first = undefined; await this.#iterator.return?.(); });
+    }
+}

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

@@ -9,7 +9,7 @@ export type PythonFsRequest = {
     readonly op: "write";
     readonly args: readonly [number, Uint8Array, number | null];
 } | {
-    readonly op: "fstat" | "close" | "position" | "descriptorCapabilities";
+    readonly op: "directoryNext" | "fstat" | "close" | "position" | "descriptorCapabilities";
     readonly args: readonly [number];
 } | {
     readonly op: "ftruncate";
@@ -18,7 +18,7 @@ export type PythonFsRequest = {
     readonly op: "sync";
     readonly args: readonly [number, boolean];
 } | {
-    readonly op: "stat" | "lstat" | "readdir" | "realpath" | "readlink" | "rm" | "rmdir" | "rmtree" | "rmtreeSupported";
+    readonly op: "directoryOpen" | "stat" | "lstat" | "readdir" | "realpath" | "readlink" | "rm" | "rmdir" | "rmtree" | "rmtreeSupported";
     readonly args: readonly [string];
 } | {
     readonly op: "rename" | "symlink" | "link";

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

@@ -1,3 +1,4 @@
+import { PythonDirectory } from "./directory.js";
 import { parsePythonFsRequest } from "./request.js";
 import { composeAbortSignals } from "../contracts/abort.js";
 import { FsError } from "../contracts/errors.js";
@@ -57,10 +58,37 @@ export class PythonFileSystem {
     }
     #handle(id) {
         const handle = this.#handles.get(id);
-        if (!handle)
+        if (!handle || handle instanceof PythonDirectory)
             throw new FsError("EBADF");
         return handle;
     }
+    async #acquire(open) {
+        if (this.#handles.size + this.#acquiring >= this.#limit || !Number.isSafeInteger(this.#next))
+            throw new FsError("EMFILE", { syscall: "open" });
+        this.#acquiring++;
+        let handle;
+        try {
+            handle = await open();
+            if (handle instanceof PythonDirectory)
+                await handle.prepare();
+            this.#scope.signal.throwIfAborted();
+            const id = this.#next++;
+            this.#handles.set(id, handle);
+            return id;
+        }
+        catch (error) {
+            if (handle)
+                try {
+                    await handle.close();
+                }
+                catch { /* Preserve acquisition failure. */ }
+            this.#scope.signal.throwIfAborted();
+            throw error;
+        }
+        finally {
+            this.#acquiring--;
+        }
+    }
     #size(size) {
         if (!Number.isSafeInteger(size) || size < 0)
             throw new FsError("EINVAL");
@@ -70,7 +98,9 @@ export class PythonFileSystem {
     async #execute(request) {
         if (request.op === "close") {
             const [id] = request.args;
-            const handle = this.#handle(id);
+            const handle = this.#handles.get(id);
+            if (!handle)
+                throw new FsError("EBADF");
             this.#handles.delete(id);
             await handle.close({ signal: this.#scope.signal });
             return;
@@ -82,40 +112,25 @@ export class PythonFileSystem {
         switch (request.op) {
             case "open": {
                 const [path, supplied] = request.args;
-                if (this.#handles.size + this.#acquiring >= this.#limit || !Number.isSafeInteger(this.#next))
-                    throw new FsError("EMFILE", { syscall: "open" });
-                if (!this.#open && !fs.open)
-                    throw new FsError("ENOTSUP", { syscall: "open", path });
-                this.#acquiring++;
-                let handle;
-                try {
-                    // A following capability query cannot preflight exclusive final-entry acquisition.
-                    // The canonical open remains authoritative for selected-path policy and atomic refusal.
+                return this.#acquire(async () => {
+                    if (!this.#open && !fs.open)
+                        throw new FsError("ENOTSUP", { syscall: "open", path });
+                    // Exclusive creation must reach the canonical atomic operation directly.
                     const capabilities = supplied.creation !== "exclusive" && fs.capabilitiesFor ? await fs.capabilitiesFor(this.#path(path), { signal, ...(supplied.creation === "ifMissing" ? { create: true } : {}) }) : fs.capabilities;
                     if (capabilities.readOnly === true && (supplied.access === "write" || supplied.access === "readwrite" || supplied.creation === "ifMissing" || supplied.creation === "exclusive" || supplied.truncate === true || supplied.append === true))
                         throw new FsError("EROFS", { syscall: "open", path });
                     if (capabilities.open === false)
                         throw new FsError("ENOTSUP", { syscall: "open", path });
                     signal.throwIfAborted();
-                    const open = this.#open ?? fs.open.bind(fs);
-                    handle = await open(this.#path(path), { ...supplied, signal });
-                    signal.throwIfAborted();
-                    const id = this.#next++;
-                    this.#handles.set(id, handle);
-                    return id;
-                }
-                catch (error) {
-                    if (handle)
-                        try {
-                            await handle.close();
-                        }
-                        catch { /* Preserve the acquisition failure. */ }
-                    signal.throwIfAborted();
-                    throw error;
-                }
-                finally {
-                    this.#acquiring--;
-                }
+                    return (this.#open ?? fs.open.bind(fs))(this.#path(path), { ...supplied, signal });
+                });
+            }
+            case "directoryOpen": return this.#acquire(() => new PythonDirectory(fs, this.#path(request.args[0]), options, this.#directoryLimit));
+            case "directoryNext": {
+                const handle = this.#handles.get(request.args[0]);
+                if (!(handle instanceof PythonDirectory))
+                    throw new FsError("EBADF");
+                return handle.next();
             }
             case "descriptorCapabilities": return { ...this.#handle(request.args[0]).capabilities };
             case "fstat": return this.#handle(request.args[0]).stat(options);

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

@@ -2,6 +2,7 @@ import { FsError } from "../contracts/errors.js";
 const argumentKinds = {
     open: ["string", "object"], read: ["number", "number", "position"], write: ["number", "bytes", "position"],
     descriptorCapabilities: ["number"], fstat: ["number"], close: ["number"], position: ["number"], ftruncate: ["number", "number"], sync: ["number", "boolean"],
+    directoryOpen: ["string"], directoryNext: ["number"],
     stat: ["string"], lstat: ["string"], readdir: ["string"], realpath: ["string"], readlink: ["string"], rm: ["string"], rmdir: ["string"], rmtree: ["string"], rmtreeSupported: ["string"],
     rename: ["string", "string"], symlink: ["string", "string"], link: ["string", "string"], mkdir: ["string", "optionalObject"],
     chmod: ["string", "number"], truncate: ["string", "number"], access: ["string", "number"], utimes: ["string", "number", "number"],

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

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

package/node_modules/toolcraft-schema/package.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft",
-  "version": "0.0.864",
+  "version": "0.0.865",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -177,7 +177,7 @@
     "saxes"
   ],
   "optionalDependencies": {
-    "toolcraft-schema": "0.0.864",
+    "toolcraft-schema": "0.0.865",
     "toolcraft-design": "*",
     "@poe-code/frontmatter": "*",
     "@poe-code/agent-mcp-config": "*",