hoomanjs 1.37.0 → 1.37.1

package/dist/core/sessions/tolerant-file-storage.js

@@ -0,0 +1,81 @@
+import { basename, extname, join } from "node:path";
+import { readdir } from "node:fs/promises";
+import { FileStorage, } from "@strands-agents/sdk/vended-plugins/context-offloader";
+/** Sidecar file the vended {@link FileStorage} writes; never a real reference. */
+const METADATA_FILE = ".metadata.json";
+/**
+ * Host-filesystem offload storage that tolerates slightly-mangled references.
+ *
+ * The vended `FileStorage.retrieve` resolves the reference to an exact file
+ * path, so a model that copies the reference imperfectly — most commonly by
+ * dropping the content-type extension (`…_0.json` -> `…_0`) or the directory
+ * prefix — gets an unhelpful "reference not found" even though the artifact is
+ * on disk. This wrapper first tries the exact lookup, then falls back to a
+ * basename / extension-insensitive match within the artifact directory.
+ *
+ * It implements {@link Storage} directly (rather than extending `FileStorage`)
+ * so the `ContextOffloader` treats it as an opaque backend and uses it as-is
+ * (no per-agent sandbox rebinding), keeping retrieval on the host-fs path.
+ */
+export class TolerantFileStorage {
+    #artifactDir;
+    #inner;
+    constructor(artifactDir) {
+        this.#artifactDir = artifactDir;
+        this.#inner = new FileStorage(artifactDir);
+    }
+    store(key, content, contentType) {
+        return this.#inner.store(key, content, contentType);
+    }
+    async retrieve(reference) {
+        try {
+            return await this.#inner.retrieve(reference);
+        }
+        catch (error) {
+            const resolved = await this.#resolveReference(reference);
+            if (resolved && resolved !== reference) {
+                return this.#inner.retrieve(resolved);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Best-effort match of a mangled reference to an on-disk artifact filename.
+     * Returns the resolved filename (relative to the artifact dir) or `null`.
+     */
+    async #resolveReference(reference) {
+        let entries;
+        try {
+            entries = await readdir(this.#artifactDir);
+        }
+        catch {
+            return null;
+        }
+        const candidates = entries.filter((entry) => entry !== METADATA_FILE);
+        const wanted = basename(reference.trim());
+        if (!wanted) {
+            return null;
+        }
+        // Exact filename (reference had the right name but a wrong/absent dir).
+        if (candidates.includes(wanted)) {
+            return join(this.#artifactDir, wanted);
+        }
+        // Extension dropped: match on the filename stem (e.g. `…_0` -> `…_0.json`).
+        const stemMatches = candidates.filter((entry) => stripExt(entry) === wanted);
+        if (stemMatches.length === 1) {
+            return join(this.#artifactDir, stemMatches[0]);
+        }
+        // Reference itself carried an extension the model altered; match by stem.
+        const wantedStem = stripExt(wanted);
+        const bothStemMatches = candidates.filter((entry) => stripExt(entry) === wantedStem);
+        if (bothStemMatches.length === 1) {
+            return join(this.#artifactDir, bothStemMatches[0]);
+        }
+        return null;
+    }
+}
+function stripExt(filename) {
+    const ext = extname(filename);
+    return ext ? filename.slice(0, -ext.length) : filename;
+}
+//# sourceMappingURL=tolerant-file-storage.js.map

package/dist/core/sessions/tolerant-file-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tolerant-file-storage.js","sourceRoot":"","sources":["../../../src/core/sessions/tolerant-file-storage.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hoomanjs",
-  "version": "1.37.0",
+  "version": "1.37.1",
   "description": "Hackable AI agent toolkit for building local CLI, ACP, MCP, and channel-driven workflows.",
   "author": {
     "name": "Vaibhav Pandey",