toolcraft 0.0.760 → 0.0.762

package/composition.json

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

package/dist/composition.json

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

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

@@ -4,6 +4,13 @@ An asynchronous filesystem interface for memory, rooted host directories, S3, an
 
 Under `workerd` and `browser` conditions, the root export includes portable filesystems, `S3FileSystem`, and `MockS3Client`. Supply an S3 transport to use object storage without Node globals.
 
+The `storage` subpath exposes `PagedStorage` and `IntegerTable` for temporary
+working data. Supply `{fs, cwd, env, signal}` and an optional page-cache count
+(default 64 pages of 16 KiB). Scratch data uses retained positioned handles in
+`env.TMPDIR` or `cwd`, with conditional unlink and cleanup through `close()`.
+Providers must support those capabilities; there is no host fallback. Use an
+external backend for large data because memory filesystems retain spilled bytes.
+
 ## Quickstart
 
 Install the standalone package; it does not depend on SafeJS, Safe Bash, or the `poe-code` CLI. These examples use TypeScript in a Node ESM application.
@@ -303,6 +310,8 @@ For Workers, `externalSpool` must store payloads outside isolate RAM and satisfy
 
 The reusable metadata-only fixture in [`tests/fixtures/bounded-filesystem.ts`](tests/fixtures/bounded-filesystem.ts) generates file ranges and consumes slow writes without storing payload bytes. [`tests/overlay-bounded.test.ts`](tests/overlay-bounded.test.ts) checks fixed transfer sizes, source backpressure, cancellation/error cleanup, byte results, and Memory publication allocation/identity. These deterministic conformance checks do not qualify a deployed Worker backend; follow the [Worker QA plan](../../docs/plans/safe-fs-bounded-overlay-qa.md) for runtime measurements.
 
+`readFileStream(fs, path, options)` reads through the caller's native stream or retained range handle without calling `readFile`. It accepts the stream range/window options above, defaults to a 64 KiB read window, and closes owned readers on completion, failure or cancellation. `skipStream: true` selects retained ranges after an already-attempted stream reports `ENOTSUP`. Chunks are borrowed until the iterator advances. Native adapters must honor the requested window and backpressure. Whole-file-only backends receive `ENOTSUP`; use a streaming or retained-range backend for sequential Worker operations. This helper bounds its I/O window, not the consuming command's parser or output capture.
+
 `collectBytes(source, { maxBytes, maxMemoryBytes, signal })` snapshots streamed chunks into one growing buffer. `maxBytes` and `maxMemoryBytes` accept explicit `Infinity`. `maxMemoryBytes` limits owned capacity, the current input's full backing buffer, and overlapping allocations during growth; exhaustion throws `EFBIG`. Collection limits are disabled by default on Node, browser, and Worker targets. Each call owns its budget; concurrent collections do not consume one another’s allowance. The returned view may retain geometric spare capacity. Configured budgets cover collection, not caller-retained results, transport buffering, archive decoding, strings, or the rest of the runtime; use streaming APIs and limit concurrent workloads for larger inputs.
 
 <details>

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

@@ -17,3 +17,5 @@ export * from "./fs/s3/http/index.js";
 export { createFileSystem, readConfigRecord, validateFileSystemConfig } from "./config.js";
 export type { FileSystemConfig, FileSystemAdapterDescriptor, FileSystemAdapterRegistry } from "./config.js";
 export { createPortableFileSystemAdapterRegistry } from "./config.portable.js";
+export { readFileStream } from "./fs/read-file-stream.js";
+export { PagedStorage, IntegerTable, type PagedStorageContext } from "./storage.js";

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

@@ -15,3 +15,5 @@ export * from "./fs/s3/index.js";
 export * from "./fs/s3/http/index.js";
 export { createFileSystem, readConfigRecord, validateFileSystemConfig } from "./config.js";
 export { createPortableFileSystemAdapterRegistry } from "./config.portable.js";
+export { readFileStream } from "./fs/read-file-stream.js";
+export { PagedStorage, IntegerTable } from "./storage.js";

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

@@ -219,7 +219,7 @@ export class MountFileSystem {
                     && await this.supportsDirectoryValidation(location.path.slice(0, location.path.lastIndexOf("/")) || "/", options, true)
                 : this.capabilities.conditionalChmod;
             const { synchronousDirectoryValidation: ignoredValidation, synchronousStagingResolution: ignoredResolution, ...ordinary } = resize;
-            const withOpen = { ...ordinary, retainedStagingWrite: false, ...(conditionalChmod === undefined ? {} : { conditionalChmod }), ...(resolution === undefined ? {} : { synchronousStagingResolution: resolution }), ...(validation === undefined ? {} : { synchronousDirectoryValidation: validation }), atomicStagingAncestry: ancestry, ...(typeof location.mount.backend.open === "function" ? {} : { open: false }) };
+            const withOpen = { ...ordinary, ...(conditionalChmod === undefined ? {} : { conditionalChmod }), ...(resolution === undefined ? {} : { synchronousStagingResolution: resolution }), ...(validation === undefined ? {} : { synchronousDirectoryValidation: validation }), atomicStagingAncestry: ancestry, ...(typeof location.mount.backend.open === "function" ? {} : { open: false }) };
             const capabilities = location.synthetic ? { ...withOpen, open: false, retainedRead: false }
                 : retainedResizeCapabilities(location.mount.backend, retainedReadCapabilities(location.mount.backend, withOpen));
             if (location.synthetic)
@@ -973,7 +973,11 @@ export class MountFileSystem {
                     return Object.freeze(staging);
                 const backendCleanup = receipt.cleanup;
                 const cleanup = createStagingCleanup(staging.directory.path, controls => this.operation("removeStagedFile", staging.directory.path, controls, () => backendCleanup.remove(controls), undefined, true), () => backendCleanup.close());
-                return Object.freeze({ ...staging, cleanup });
+                const writer = receipt.writer;
+                return Object.freeze({ ...staging, cleanup, ...(writer ? { writer: Object.freeze({
+                            write: (bytes, controls = {}) => this.operation("stagedWrite", staging.file.path, controls, () => writer.write(bytes, controls), undefined, true),
+                            finish: (controls = {}) => this.operation("stagedFinish", staging.file.path, controls, async () => snapshotStat(await writer.finish(controls)), undefined, true),
+                        }) } : {}) });
             }
             catch (error) {
                 await finishCleanup(() => receipt.cleanup?.close(), true);

package/node_modules/@poe-code/safe-fs/dist/fs/read-file-stream.d.ts

@@ -0,0 +1,7 @@
+import type { FileSystem, ReadStreamOptions } from "../contracts/filesystem.js";
+/** Sequential payload access without a whole-file fallback. The injected backend
+ * must supply streaming reads or retained range reads; no private storage is used.
+ * Chunks are borrowed until the consumer advances the iterator. */
+export declare function readFileStream(fs: FileSystem, path: string, options?: ReadStreamOptions & {
+    readonly skipStream?: boolean;
+}): AsyncGenerator<Uint8Array>;

package/node_modules/@poe-code/safe-fs/dist/fs/read-file-stream.js

@@ -0,0 +1,77 @@
+import { FsError } from "../contracts/errors.js";
+import { finishCleanup } from "../contracts/cleanup.js";
+import { openRetainedReadFile } from "./capabilities.js";
+const byteLength = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(Uint8Array.prototype), "byteLength").get;
+const byteKind = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(Uint8Array.prototype), Symbol.toStringTag).get;
+/** Sequential payload access without a whole-file fallback. The injected backend
+ * must supply streaming reads or retained range reads; no private storage is used.
+ * Chunks are borrowed until the consumer advances the iterator. */
+export async function* readFileStream(fs, path, options = {}) {
+    const { signal } = options;
+    signal?.throwIfAborted();
+    const chunkSize = options.chunkSize ?? 65536;
+    let position = options.start ?? 0;
+    const end = options.endExclusive ?? Number.MAX_SAFE_INTEGER;
+    if (!Number.isSafeInteger(chunkSize) || chunkSize <= 0 || !Number.isSafeInteger(position) || position < 0
+        || !Number.isSafeInteger(end) || end < position)
+        throw new FsError("EINVAL", { path, syscall: "readStream" });
+    const capabilities = await fs.capabilitiesFor?.(path, options) ?? fs.capabilities;
+    signal?.throwIfAborted();
+    if (!options.skipStream && fs.readStream && fs.capabilities?.streamingRead !== false && capabilities?.streamingRead !== false) {
+        let emitted = false;
+        let reading = true;
+        try {
+            const source = fs.readStream(path, { ...options, chunkSize });
+            const iterator = source[Symbol.asyncIterator]();
+            let done = false, failed = true;
+            try {
+                while (true) {
+                    signal?.throwIfAborted();
+                    const item = await iterator.next();
+                    signal?.throwIfAborted();
+                    if (item.done) {
+                        done = true;
+                        break;
+                    }
+                    reading = false;
+                    if (byteLength.call(item.value))
+                        emitted = true;
+                    yield item.value;
+                    reading = true;
+                }
+                failed = false;
+            }
+            finally {
+                if (!done)
+                    await finishCleanup(() => iterator.return?.(), failed);
+            }
+            return;
+        }
+        catch (error) {
+            signal?.throwIfAborted();
+            if (!reading || emitted || !(error instanceof FsError) || error.code !== "ENOTSUP")
+                throw error;
+        }
+    }
+    const handle = await openRetainedReadFile(fs, path, options);
+    let failed = true;
+    try {
+        while (position < end) {
+            signal?.throwIfAborted();
+            const maximum = Math.min(chunkSize, end - position);
+            const bytes = await handle.read(position, maximum, options);
+            signal?.throwIfAborted();
+            if (byteKind.call(bytes) !== "Uint8Array" || byteLength.call(bytes) > maximum)
+                throw new FsError("EIO", { path, syscall: "read" });
+            const length = byteLength.call(bytes);
+            if (!length)
+                break;
+            position += length;
+            yield bytes;
+        }
+        failed = false;
+    }
+    finally {
+        await finishCleanup(() => handle.close(), failed);
+    }
+}

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

@@ -23,3 +23,4 @@ export { createFileSystem, readConfigRecord, validateFileSystemConfig } from "./
 export type { FileSystemConfig, FileSystemAdapterDescriptor, FileSystemAdapterRegistry } from "./config.js";
 export { createNodeFileSystemAdapterRegistry } from "./config.node.js";
 export { createPortableFileSystemAdapterRegistry } from "./config.portable.js";
+export { readFileStream } from "./fs/read-file-stream.js";

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

@@ -19,3 +19,4 @@ export * from "./node/index.js";
 export { createFileSystem, readConfigRecord, validateFileSystemConfig } from "./config.js";
 export { createNodeFileSystemAdapterRegistry } from "./config.node.js";
 export { createPortableFileSystemAdapterRegistry } from "./config.portable.js";
+export { readFileStream } from "./fs/read-file-stream.js";

package/node_modules/@poe-code/safe-fs/dist/runtime-core.d.ts

@@ -25,3 +25,4 @@ export declare function tryWriteMemoryFileSync(fs: FileSystem, path: string, dat
 export declare function tryMkdirMemorySync(fs: FileSystem, path: string, recursive: boolean, mode: number, signal?: AbortSignal, dirPrefixHint?: string): boolean;
 export declare function tryRmRfMemorySync(fs: FileSystem, path: string, signal?: AbortSignal): boolean;
 export declare function tryWriteMemoryFileInDirSync(fs: FileSystem, dirPrefix: string, name: string, data: Uint8Array, append: boolean, mode: number, signal?: AbortSignal): boolean;
+export { readFileStream } from "./fs/read-file-stream.js";

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

@@ -55,3 +55,4 @@ export function tryRmRfMemorySync(fs, path, signal) {
 export function tryWriteMemoryFileInDirSync(fs, dirPrefix, name, data, append, mode, signal) {
     return Boolean((fs && _getMemHooks()?.byProto?.get(Object.getPrototypeOf(fs))?.tryWriteMemoryFileInDirSync)?.(fs, dirPrefix, name, data, append, mode, signal));
 }
+export { readFileStream } from "./fs/read-file-stream.js";

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

@@ -0,0 +1,49 @@
+import type { FileSystem } from "./contracts/filesystem.js";
+export interface PagedStorageContext {
+    readonly fs: FileSystem;
+    readonly cwd: string;
+    readonly env: Readonly<Record<string, string | undefined>>;
+    readonly signal: AbortSignal;
+}
+/** A bounded page cache backed only by the caller filesystem. The default is
+ * one MiB; callers own close() on every outcome. Memory filesystems still retain
+ * spilled data in RAM, so large workloads require an external backing provider. */
+export declare class PagedStorage {
+    private readonly context;
+    private readonly maxPages;
+    private readonly pages;
+    private readonly controller;
+    private readonly signal;
+    private descriptor;
+    private parent;
+    private initial;
+    private path;
+    private diskLength;
+    private unlinked;
+    private end;
+    private active;
+    private closing;
+    constructor(context: PagedStorageContext, maxPages?: number);
+    allocate(length: number): number;
+    private operation;
+    private spill;
+    private flush;
+    private page;
+    write(position: number, bytes: Uint8Array): Promise<void>;
+    append(bytes: Uint8Array): Promise<number>;
+    read(position: number, length: number): Promise<Uint8Array>;
+    close(): Promise<void>;
+}
+/** Fixed-depth radix index: both dense and sparse 64-bit keys use bounded RAM. */
+export declare class IntegerTable {
+    private readonly storage;
+    private readonly maxEntries;
+    private root;
+    private readonly cache;
+    constructor(storage: PagedStorage, maxEntries?: number);
+    private retain;
+    get(key: bigint): Promise<bigint | undefined>;
+    set(key: bigint, value: bigint): Promise<void>;
+    private lookup;
+    private persist;
+}

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

@@ -0,0 +1,265 @@
+import { FsError, isFsError } from "./contracts/errors.js";
+const pageBytes = 16 * 1024;
+let serial = 0;
+/** A bounded page cache backed only by the caller filesystem. The default is
+ * one MiB; callers own close() on every outcome. Memory filesystems still retain
+ * spilled data in RAM, so large workloads require an external backing provider. */
+export class PagedStorage {
+    context;
+    maxPages;
+    pages = new Map();
+    controller = new AbortController();
+    signal;
+    descriptor;
+    parent;
+    initial;
+    path;
+    diskLength = 0;
+    unlinked = false;
+    end = 8; // Zero is the absent-pointer sentinel.
+    active = Promise.resolve();
+    closing;
+    constructor(context, maxPages = 64) {
+        this.context = context;
+        this.maxPages = maxPages;
+        if (!Number.isSafeInteger(maxPages) || maxPages < 1)
+            throw new RangeError("Invalid storage page cache size");
+        this.signal = AbortSignal.any([context.signal, this.controller.signal]);
+    }
+    allocate(length) {
+        this.signal.throwIfAborted();
+        if (!Number.isSafeInteger(length) || length < 0 || length > Number.MAX_SAFE_INTEGER - this.end)
+            throw new FsError("EFBIG");
+        const offset = this.end;
+        this.end += length;
+        return offset;
+    }
+    operation(action) {
+        this.signal.throwIfAborted();
+        const work = this.active.then(() => {
+            this.signal.throwIfAborted();
+            return action();
+        });
+        this.active = work.then(() => undefined, () => undefined);
+        return work;
+    }
+    async spill() {
+        const { fs, cwd, env } = this.context;
+        if (!fs.open || !fs.removeFileConditional)
+            throw new FsError("ENOTSUP", { message: "spill storage requires retained read/write handles and conditional removal" });
+        const selected = env.TMPDIR || cwd;
+        const directory = selected.startsWith("/") ? selected : `${cwd}/${selected}`;
+        this.parent = await fs.stat(directory, { signal: this.signal });
+        this.signal.throwIfAborted();
+        if (this.parent.type !== "directory")
+            throw new FsError("ENOTDIR", { path: directory });
+        for (let attempt = 0; attempt < 128; attempt++) {
+            const path = `${directory.endsWith("/") ? directory : directory + "/"}.storage-${++serial}`;
+            try {
+                this.descriptor = await fs.open(path, { access: "readwrite", creation: "exclusive", mode: 0o600, signal: this.signal });
+                this.path = path;
+                break;
+            }
+            catch (error) {
+                this.signal.throwIfAborted();
+                if (!isFsError(error) || error.code !== "EEXIST")
+                    throw error;
+            }
+        }
+        if (!this.descriptor)
+            throw new FsError("EEXIST", { path: directory });
+        // Retain the acquisition receipt even if cancellation wins immediately after open.
+        this.initial = await this.descriptor.stat();
+        this.signal.throwIfAborted();
+        if (!this.descriptor.capabilities.positionedRead || !this.descriptor.capabilities.positionedWrite)
+            throw new FsError("ENOTSUP");
+        // Detach the name before storing input. A later output or random-source path
+        // cannot alias our scratch file; the retained descriptor owns its lifetime.
+        await fs.removeFileConditional(this.path, { parent: this.parent, expected: this.initial, signal: this.signal });
+        this.unlinked = true;
+        for (const [number, page] of this.pages)
+            await this.flush(number, page);
+    }
+    async flush(number, page) {
+        if (!page.dirty)
+            return;
+        let offset = 0;
+        while (offset < pageBytes) {
+            this.signal.throwIfAborted();
+            const count = await this.descriptor.write(page.bytes.subarray(offset), number * pageBytes + offset, { signal: this.signal });
+            this.signal.throwIfAborted();
+            if (!Number.isSafeInteger(count) || count <= 0 || count > pageBytes - offset)
+                throw new FsError("EIO");
+            offset += count;
+        }
+        this.diskLength = Math.max(this.diskLength, (number + 1) * pageBytes);
+        page.dirty = false;
+    }
+    async page(number) {
+        this.signal.throwIfAborted();
+        const cached = this.pages.get(number);
+        if (cached) {
+            this.pages.delete(number);
+            this.pages.set(number, cached);
+            return cached;
+        }
+        if (this.pages.size === this.maxPages) {
+            if (!this.descriptor)
+                await this.spill();
+            const [oldNumber, oldPage] = this.pages.entries().next().value;
+            await this.flush(oldNumber, oldPage);
+            this.pages.delete(oldNumber);
+        }
+        const page = { bytes: new Uint8Array(pageBytes), dirty: false };
+        if (number * pageBytes < this.diskLength) {
+            let offset = 0;
+            while (offset < pageBytes) {
+                const count = await this.descriptor.read(page.bytes.subarray(offset), number * pageBytes + offset, { signal: this.signal });
+                this.signal.throwIfAborted();
+                if (!Number.isSafeInteger(count) || count <= 0 || count > pageBytes - offset)
+                    throw new FsError("EIO");
+                offset += count;
+            }
+        }
+        this.pages.set(number, page);
+        return page;
+    }
+    write(position, bytes) {
+        if (!Number.isSafeInteger(position) || position < 8 || position + bytes.length > this.end)
+            throw new RangeError("Invalid paged storage range");
+        return this.operation(async () => {
+            for (let offset = 0; offset < bytes.length;) {
+                const target = position + offset;
+                const page = await this.page(Math.floor(target / pageBytes));
+                const count = Math.min(bytes.length - offset, pageBytes - target % pageBytes);
+                page.bytes.set(bytes.subarray(offset, offset + count), target % pageBytes);
+                page.dirty = true;
+                offset += count;
+            }
+        });
+    }
+    async append(bytes) {
+        const position = this.allocate(bytes.length);
+        await this.write(position, bytes);
+        return position;
+    }
+    read(position, length) {
+        if (!Number.isSafeInteger(position) || position < 8 || !Number.isSafeInteger(length) || length < 0 || length > pageBytes || position + length > this.end)
+            throw new RangeError("Invalid paged storage range");
+        return this.operation(async () => {
+            const bytes = new Uint8Array(length);
+            for (let offset = 0; offset < length;) {
+                const source = position + offset;
+                const page = await this.page(Math.floor(source / pageBytes));
+                const count = Math.min(length - offset, pageBytes - source % pageBytes);
+                bytes.set(page.bytes.subarray(source % pageBytes, source % pageBytes + count), offset);
+                offset += count;
+            }
+            return bytes;
+        });
+    }
+    close() {
+        this.controller.abort(new FsError("ECANCELED"));
+        return this.closing ??= (async () => {
+            await this.active.catch(() => { });
+            this.pages.clear();
+            const descriptor = this.descriptor;
+            if (!descriptor)
+                return;
+            const cancellation = new FsError("ECANCELED");
+            try {
+                if (!this.unlinked) {
+                    const expected = this.initial ?? await descriptor.stat();
+                    await this.context.fs.removeFileConditional(this.path, { parent: this.parent, expected }).catch(error => {
+                        if (!isFsError(error) || error.code !== "ENOENT")
+                            throw error;
+                    });
+                }
+            }
+            finally {
+                // Conditional descriptors must discard their private staged writes, not
+                // publish the scratch data when the command retires its handle.
+                await descriptor.close({ signal: AbortSignal.abort(cancellation) }).catch(error => {
+                    if (error !== cancellation)
+                        throw error;
+                });
+            }
+        })();
+    }
+}
+/** Fixed-depth radix index: both dense and sparse 64-bit keys use bounded RAM. */
+export class IntegerTable {
+    storage;
+    maxEntries;
+    root = 0;
+    cache = new Map();
+    constructor(storage, maxEntries = 4096) {
+        this.storage = storage;
+        this.maxEntries = maxEntries;
+        if (!Number.isSafeInteger(maxEntries) || maxEntries < 1)
+            throw new RangeError("Invalid integer table cache size");
+    }
+    async retain(key, value, dirty) {
+        if (this.cache.size === this.maxEntries && !this.cache.has(key)) {
+            const [oldKey, old] = this.cache.entries().next().value;
+            if (old.dirty)
+                await this.persist(oldKey, old.value);
+            this.cache.delete(oldKey);
+        }
+        this.cache.delete(key);
+        this.cache.set(key, { value, dirty });
+    }
+    async get(key) {
+        const cached = this.cache.get(key);
+        if (cached) {
+            this.cache.delete(key);
+            this.cache.set(key, cached);
+            return cached.value;
+        }
+        const value = await this.lookup(key);
+        if (value !== undefined)
+            await this.retain(key, value, false);
+        return value;
+    }
+    async set(key, value) {
+        if (key < 0n || key > 0xffffffffffffffffn || value < 0n || value >= 0xffffffffffffffffn)
+            throw new RangeError("Invalid storage integer table value");
+        await this.retain(key, value, true);
+    }
+    async lookup(key) {
+        let node = this.root;
+        for (let shift = 60n; shift >= 0n; shift -= 4n) {
+            if (!node)
+                return undefined;
+            const slot = node + Number((key >> shift) & 15n) * 8;
+            const bytes = await this.storage.read(slot, 8);
+            const value = new DataView(bytes.buffer, bytes.byteOffset, 8).getBigUint64(0, true);
+            if (shift === 0n)
+                return value === 0n ? undefined : value - 1n;
+            node = Number(value);
+        }
+        return undefined;
+    }
+    async persist(key, value) {
+        if (!this.root)
+            this.root = this.storage.allocate(128);
+        let node = this.root;
+        for (let shift = 60n; shift >= 0n; shift -= 4n) {
+            const slot = node + Number((key >> shift) & 15n) * 8;
+            const bytes = await this.storage.read(slot, 8);
+            const view = new DataView(bytes.buffer, bytes.byteOffset, 8);
+            if (shift === 0n) {
+                view.setBigUint64(0, value + 1n, true);
+                await this.storage.write(slot, bytes);
+                return;
+            }
+            let child = Number(view.getBigUint64(0, true));
+            if (!child) {
+                child = this.storage.allocate(128);
+                view.setBigUint64(0, BigInt(child), true);
+                await this.storage.write(slot, bytes);
+            }
+            node = child;
+        }
+    }
+}

package/node_modules/@poe-code/safe-fs/package.json

@@ -161,6 +161,13 @@
     "./bridge": {
       "types": "./dist/bridge/index.d.ts",
       "import": "./dist/bridge/index.js"
+    },
+    "./storage": {
+      "types": "./dist/storage.d.ts",
+      "workerd": "./dist/storage.js",
+      "browser": "./dist/storage.js",
+      "worker": "./dist/storage.js",
+      "import": "./dist/storage.js"
     }
   },
   "files": [

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

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

package/node_modules/toolcraft-schema/package.json

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

package/package.json

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