golem-file-io-scala

Define a Scala.js facade with @JSImport("node:fs", JSImport.Namespace) exposing readFileSync, writeFileSync, and appendFileSync. Call these methods inside your agent implementation to read text or binary files and write output.

Scala Golem agents compile to JavaScript via Scala.js and run in a QuickJS-based WASM runtime, so JVM APIs like java.io.File and java.nio.file are unavailable. Filesystem access must go through the node:fs module using Scala.js interop.

WASI modules like node:fs are unavailable during the build-time wizer pre-initialization phase. Use lazy val or defer node:fs access to method bodies so the import happens at runtime instead of during pre-initialization.

Only files provisioned with read-write permission, or files in non-provisioned paths, can be written. Files added with read-only permission cannot be modified, so write outputs to paths like /tmp instead.

Yes, each agent instance has its own isolated filesystem, and file changes persist across invocations as durable state. Files written by one invocation remain available to later invocations of the same agent.