@daugasauron/dolly 0.1.5 → 0.1.6

package/README.md

@@ -2,16 +2,17 @@
 
 Dolly is a POSIX-like userspace for wasm64 that runs in a browser tab: a Wasm
 kernel, programs in private Wasm memories, and host modules that bridge it to
-the browser. These npm packages put it in a page of your own. Their first use is
-an agent in place of a web frontend (`docs/agent-frontend.md` in the repository).
+the browser. These npm packages put it in a page of your own: this document is
+`boot()` and the page around it. [Dolly from npm](npm.md) is the guide to the
+packages and to `dolly-build`, which builds an image of your own: a coding agent
+with your tools and skills, as a static site.
 
 | Package | What it holds |
 | --- | --- |
 | `@daugasauron/dolly` | The runtime: `boot()`, the kernel, the process runtime, its image builder, and the host modules that are its own machinery (`runtime`, `http`, `threads`, `dso`, `stack`, `nena`, `snapshot`, `packages`) |
 | `@daugasauron/dolly-host-NAME` | One device host module each: `display` (Ghostty's terminal and programs' frames), `input`, `gpu`, `audio`, `microphone`, `touch`, `download` (as `dolly-host-save`: npm takes no new name with the word), `upload`, `html`, `sockets`, `pty` |
-| `@daugasauron/dolly-image-NAME` | An image's directory for `boot()`: `default` (a shell, its text tools, the terminal, curl, `amy`, `nena`, `ps`, `html`), `pi-minimal` (the Pi coding agent with JavaScript, a shell, POSIX tools, curl, ripgrep and fd, on `display`, `input`, `download` and `html` alone: the README's "Pi with npm"), `python-data` (`default` with Python 3.14, pip, the C compiler, NumPy, pandas, Matplotlib and seaborn). Its README gives the install line and the `FROM` row of a recipe built on it. Its `amy-index.txt` lists the packages the image holds, so `amy list` and `amy info` describe them |
-| `@daugasauron/dolly-package-NAME` | A package for an image of your own: `git` (with diff and patch), `cc` (the C and C++ compiler with Make), `python` (3.14 with pip; it brings `libffi` and `cc`), `numpy`, `pandas`, `matplotlib`, `seaborn` and `python-dateutil`. Its directory holds its catalog, metadata, packs and recipes, as an image's does, and nothing to boot; it depends on the packages it installs, so npm installs them with it |
-| `@daugasauron/dolly-build` | The `dolly-build` command: a project with an image of your own, `FROM` `pi-minimal` with the packages it `INSTALL`s, built in a browser into a site a static host serves ("Your own image" below) |
+| `@daugasauron/dolly-image-NAME` | An image's directory for `boot()`: `default` (a shell, its text tools, the terminal, curl, `amy`, `nena`, `ps`), `pi-minimal` (the Pi coding agent with JavaScript, a shell, POSIX tools, curl, ripgrep and fd, on `display`, `input`, `download` and `html` alone: the README's "Pi with npm"), `python-data` (`default` with Python 3.14, pip, the C compiler, NumPy, pandas, Matplotlib and seaborn). Its README gives the install line and the `FROM` row of a recipe built on it. Its `amy-index.txt` lists the packages the image holds, so `amy list` and `amy info` describe them |
+| `@daugasauron/dolly-package-NAME`, `@daugasauron/dolly-build` | Packages for an image of your own, and the command that builds it ([Dolly from npm](npm.md)) |
 
 ```sh
 npm install @daugasauron/dolly @daugasauron/dolly-image-default \
@@ -33,7 +34,7 @@ in `.yarnrc.yml`: Plug'n'Play leaves no files to serve.
 <meta charset="utf-8">
 <main id="dolly" style="position:fixed;inset:0"></main>
 <script type="module">
-  import { boot } from "./node_modules/@daugasauron/dolly/src/browser.mjs";
+  import { boot } from "./node_modules/@daugasauron/dolly/page/browser.mjs";
   import { images, image, modules } from "./node_modules/@daugasauron/dolly-image-default/index.mjs";
   const dolly = await boot(document.querySelector("#dolly"), { images, image, modules });
 </script>
@@ -50,7 +51,7 @@ the page's.
 
 | Option | Meaning |
 | --- | --- |
-| `images` | URL of an image directory: `dist/dolly-images.json`, the images' metadata and packs, their recipes, all data. `@daugasauron/dolly-image-default`'s `index.mjs` exports its own. A page has one image directory. The packs an image reads stay in the origin's private storage, so it starts again without downloading them (`src/pack-store.mjs`) |
+| `images` | URL of an image directory: `dist/dolly-images.json`, the images' metadata and packs, their recipes, all data. `@daugasauron/dolly-image-default`'s `index.mjs` exports its own. A page has one image directory, which is also `amy`'s package server unless a session names another (`amy server URL`, [Dollyfile](dollyfile.md)). The packs an image reads stay in the origin's private storage, so it starts again without downloading them (`page/pack-store.mjs`) |
 | `image` | The image to run, by name |
 | `modules` | URLs of the `module.json` of each host module the page has. The registry loads these and no other; an image's `REQUIRES HOST` must be among them |
 | `site` | Optional: the URL of a site that serves Dolly's own pages (`session/`, `sessions/`, `docs/`), as Dolly's site does. Given, a saved session names itself in the tab's URL as the site's session route and modules link to those pages |
@@ -80,9 +81,10 @@ WebGPU adapter, a device that fails to open with `ENODEV`.
 
 ## Colours
 
-The terminal's colours and the popups' are the page's, not the image's. Set
-these on the element (or above it) in your style sheet to match your page;
-unset, they are Dolly's:
+The terminal's colours, the popups' and those of the rest of Dolly's own UI in
+the element (the boot log, the status line, the dialogs, the notices and the
+indicators) are the page's, not the image's. Set these on the element (or above
+it) in your style sheet to match your page; unset, they are Dolly's:
 
 ```css
 #dolly {
@@ -98,7 +100,9 @@ and bright yellow (`-3`, `-11`) the accent, bright black (`-8`) `#77736c` and
 the others the text's colour, so a program's red shows as its text does. A
 value may be any CSS colour; one that is not counts as unset. The terminal
 takes them at boot and whenever they change, by any rule or media query; a
-popup as it opens.
+popup as it opens. Dolly's UI draws its quieter lines in bright black (`-8`),
+its raised and sunken parts in mixes of the background and the text, and an
+alert in `#e98773`.
 
 ## Popups
 
@@ -121,6 +125,31 @@ the popup its bytes; without one, name fonts the system has. The page reads the
 properties each time a popup opens. Dolly's site sets
 `"Dolly IosevkaTerm SemiBold", monospace` and its font file.
 
+## A terminal into the session
+
+An image that declares `console@0` (`@daugasauron/dolly-host-console`) gives
+boot()'s handle `openConsole({ columns, rows, argv })`: a terminal the page
+holds, with `argv`'s program started on it, for something other than the
+page's own terminal to use, such as a socket to another machine. It resolves
+to `{ output, write(bytes), resize(columns, rows), close(), exited }`:
+`output` is a `ReadableStream` of what the programs show, which ends when the
+last of them lets go of the terminal; `write` takes bytes or text as typed,
+Ctrl+C included, and resolves to how many it took, fewer while the input is
+full; `exited` is the program's status. The terminal is a pseudo-terminal's
+([process model](process-model.md#pseudo-terminals)). With `pipes: true` in
+place of the size, the program's standard streams are pipes: `write` is its
+input byte for byte, `endInput()` ends it, `interrupt()` is its Ctrl+C (SIGINT
+to the program, as a terminal's interrupt key), and `output` and `errors` are
+its standard output and error apart.
+
+```js
+const shell = await dolly.openConsole({ columns: 100, rows: 30, argv: ["/bin/slop"] });
+await shell.write("echo hello\r");
+const sort = await dolly.openConsole({ pipes: true, argv: ["/bin/sort"] });
+await sort.write("b\na\n");
+await sort.endInput();
+```
+
 ## Serving
 
 - Serve the installed packages as they lie: the runtime finds its own files
@@ -133,76 +162,20 @@ properties each time a popup opens. Dolly's site sets
   as `application/json`: a browser imports a host module's manifest and an image
   directory's catalog and metadata only with that type.
 - No bundler is needed: these are ES modules, Workers and Wasm files.
+- A Content-Security-Policy that Dolly runs under, with no `'unsafe-inline'` or
+  `'unsafe-eval'`: `default-src 'self'; script-src 'self' 'wasm-unsafe-eval' blob:;
+  worker-src 'self' blob:; img-src 'self' blob:; object-src 'none'; base-uri 'none'`,
+  with `connect-src` naming the origins the HTTP policy allows (or their relay).
+  WebAssembly needs `'wasm-unsafe-eval'`; processes start in Workers from `blob:` URLs
+  of code fetched once, so a program starts without a request. Neither boot() nor a
+  host module writes a script or style element (the popup is a frame in which no
+  script runs), so the page's own script and style, as files, are all the policy
+  admits ([test](../test/csp-browser.mjs)).
 
 ## Your own image
 
-`dolly-build` builds a Dollyfile (`docs/dollyfile.md` in the repository)
-`FROM` the installed `pi-minimal`, with the packages whose directories are
-installed beside it, into a site: a directory that any static host serves as it
-lies. The build runs in a headless browser, with the installed runtime's own
-builder, as the catalog's images are built; the command serves the packages to
-it on 127.0.0.1 and writes what it hands back. Nothing of it, nor of the site,
-the page or the image, fetches from the network: after `npm install`, the
-packages hold every file. The build's browser reaches that server and the URLs
-of the recipe's own `SOURCE` rows alone; its own requests (its vendor's updates,
-clock and autofill) go to a proxy of the command's that refuses them.
-
-```sh
-npm install @daugasauron/dolly-build @daugasauron/dolly-package-git
-npx dolly-build init my-pi git
-npx dolly-build Dollyfile-my-pi my-pi
-```
-
-- `dolly-build init NAME [PACKAGE…]` writes a project where the packages are
-  installed, and refuses to write over a file: `Dollyfile-NAME` (the host modules
-  of `pi-minimal` and of each package, `FROM` `pi-minimal` and `INSTALL` of each
-  package at the installed pins, rows for Pi's instructions, a skill, an extension,
-  a tool and the script that starts Pi, and `pi-minimal`'s `ENTRY`) and `public/`,
-  the page's files: `index.html` (the policy, the popups' font, and the files of
-  `workspace/` and `theme.json` for `boot()`'s `files`, listed by `workspace.json`),
-  `theme.json` (the sandbox's colours: Pi's theme, written over the image's at
-  boot, whose background, text, accent and muted the page sets as the terminal's
-  and the popups') and `workspace/README.md`; and, unless the project has one, a
-  `.gitignore` for `node_modules/` and the site. It names the host module
-  package to install when a package needs one the page lacks (`python`'s `sockets`).
-  The repository README's "Pi with npm" says what each file is for.
-- The recipe is the one place that declares the sandbox. Add rows before `ENTRY`:
-  `FILE` with a body (indented four spaces) for a file, `INSTALL` of a package
-  whose directory is installed (every package it needs comes with it, so `python`
-  brings `cc`), `SLOP` to run the image's tools at build time. `FROM` carries the
-  base's files, environment and exports but not its host modules or `ENTRY`, so the
-  recipe repeats those; a package's `REQUIRES HOST` rows must be among the recipe's,
-  and the build names a missing one. A recipe is at most 128 KiB; `/workspace` is
-  never part of an image (`boot()`'s `files` writes the project at each boot).
-- `dolly-build Dollyfile-NAME OUT` writes the site `OUT`, replacing the one it
-  wrote there before: the files of `public/`, `workspace.json` (the files under
-  `public/workspace/`), the runtime (`dolly/`), the device host modules the recipe
-  declares (`dolly-host-NAME/`), `coi-serviceworker.js` and `image/`, the image's
-  directory as an image package lays it out (its catalog, metadata and packs, the
-  recipes it was built from, its `amy-index.txt` and an `index.mjs`). The page
-  imports `./dolly/src/browser.mjs` and `./image/index.mjs`. An image this recipe
-  built on this runtime is kept, so a change to `public/` alone takes seconds.
-  `--browser chrome` (the default: your Chrome), `chromium` or `firefox`
-  (Playwright's, after `npx playwright-core install chromium` or `firefox`).
-  Both commands run where the packages are installed: the directory whose
-  `node_modules/@daugasauron/` holds them (npm, pnpm and Yarn 1 alike). A row
-  that names an image no installed package holds at that pin fails naming the row.
-- Serve `OUT` with any static file server, `python3 -m http.server -d OUT` on
-  your machine. Where the host sends the isolation headers ("Serving" above) the
-  page is isolated; where it does not, `init`'s page registers
-  `coi-serviceworker.js`, which adds them to the site's own responses, and loads
-  again under it.
-- A recipe may start `FROM` another installed image instead, `python-data` say: its
-  package's README gives the `FROM` row, and the recipe repeats the image's `REQUIRES HOST`
-  rows (a FILE of the project's own script and a SLOP that runs it at build time, for
-  example). `init` writes Pi's project only; the page in `public/index.html` is then one
-  as in "A page" above that imports `./dolly/src/browser.mjs` and `./image/index.mjs`,
-  with the lines of `init`'s page that register `coi-serviceworker.js` for a host
-  without the headers.
-- An image is built for the installed versions: after the packages update, the
-  rows' pins are others (`init` in an empty directory writes the new ones), and it
-  is built again. Packages of two versions in one `node_modules` fail the build,
-  naming both.
+`dolly-build` (`@daugasauron/dolly-build`) builds a recipe of your own from
+installed packages into a static site: [Dolly from npm](npm.md).
 
 ## Host modules
 

package/coi-serviceworker.js

@@ -1,15 +1,30 @@
-// GitHub Pages cannot configure COOP/COEP response headers. This worker adds
-// them only to Dolly's same-origin static responses so shared wasm64 memory is
-// available there. Cross-origin requests, including the explicit HTTP broker,
-// pass through unchanged.
-self.addEventListener("install", () => self.skipWaiting());
-self.addEventListener("activate", (event) => event.waitUntil(self.clients.claim()));
+// The site's service worker, for its own same-origin GET and HEAD responses; it
+// holds no policy and reaches nothing a page's fetch does not. Cross-origin
+// requests, including the explicit HTTP broker's, pass through unchanged.
+// - GitHub Pages cannot configure COOP/COEP response headers: the worker adds
+//   them where a response lacks them, so shared wasm64 memory is available there.
+// - Where the network fails, a GET is answered from this site's kept runtime: the
+//   files a saved session opens with, which the page stores when a session is
+//   saved, each checked against the site's list (site/offline.mjs). A response the
+//   server gives, an error among them, is never replaced.
+const kept = `dolly-offline ${self.registration.scope} `;
+async function keptResponse(request, failure) {
+  for (const name of request.method === "GET" ? await caches.keys() : []) {
+    const response = name.startsWith(kept) && await (await caches.open(name)).match(request, { ignoreSearch: true });
+    if (response) return response;
+  }
+  throw failure;
+}
+// It controls the pages loaded after it and never takes over a running one
+// (no clients.claim, no skipWaiting): a page whose Workers wait in Atomics.wait
+// stalls its fetches in Firefox while its controller changes.
 self.addEventListener("fetch", (event) => {
   const target = new URL(event.request.url);
   if (target.origin !== self.location.origin) return;
   event.respondWith((async () => {
-    const response = await fetch(event.request);
-    if (response.type === "opaque" || response.type === "opaqueredirect") return response;
+    const response = await fetch(event.request).catch(failure => keptResponse(event.request, failure));
+    if (response.type === "opaque" || response.type === "opaqueredirect" ||
+        response.headers.has("Cross-Origin-Embedder-Policy")) return response;
     const headers = new Headers(response.headers);
     // Fetch exposes a decoded body while origin transport headers can still
     // describe its compressed representation. A reconstructed Response must

package/dist/dolly-build-id.mjs

@@ -1 +1 @@
-export const DOLLY_BUILD_ID = "sha256:4dab85fcfe184d0632f281d1ff0a7839f9ac8176e6f1656819881e8ca38c3c27";
+export const DOLLY_BUILD_ID = "sha256:d8f91a7526e31cfd010f30ba48cea8912e4aa9cdd6b1497fd9a96d46ea2eee52";

package/dist/dolly-image-build-id.mjs

@@ -1 +1 @@
-export const DOLLY_IMAGE_BUILD_ID = "sha256:b9e16e76c04b07f3e0a20b6a399a1b736c1c8d9e103554634abb910a34d6c341";
+export const DOLLY_IMAGE_BUILD_ID = "sha256:87c272432c019ccd35bc35fd5576682681a35c1abdcd36f18e456f608d23b758";

package/dist/dolly-process-abi.mjs

@@ -1 +1 @@
-export const DOLLY_PROCESS_ABI_DIGEST = "36d9bdf963bcc094b53c3b7e44f244aeb2e9213d99a729a90fd01b2f9a368c5f";
+export const DOLLY_PROCESS_ABI_DIGEST = "a193b87b75700fc2617daafe583c8693499f2c408124e6d8473d518cdf32c67b";

package/dist/dolly-process-dso.mjs

@@ -1,5 +1,8 @@
 // dist/dolly-process-abi.mjs
-var DOLLY_PROCESS_ABI_DIGEST = "36d9bdf963bcc094b53c3b7e44f244aeb2e9213d99a729a90fd01b2f9a368c5f";
+var DOLLY_PROCESS_ABI_DIGEST = "a193b87b75700fc2617daafe583c8693499f2c408124e6d8473d518cdf32c67b";
+
+// dist/dolly-kernel-plugin-abi.mjs
+var DOLLY_KERNEL_PLUGIN_IMPORTS = Object.freeze(["fopen", "fseek", "fclose", "ftell", "malloc", "fread", "free", "dolly_assert_fail", "realloc", "strcmp", "strncmp", "strlen", "memcmp", "bcmp", "write", "__errno_location", "lseek", "preadv", "close", "fstat", "unlinkat", "openat", "realpath", "readv", "dolly_input_decoder_install"]);
 
 // host/dso/abi.mjs
 var DOLLY_DSO_OPEN = 112;
@@ -16,7 +19,7 @@ var DOLLY_FFI_CLOSURE_FREE = 122;
 var DOLLY_FFI_CLOSURE_PREP = 123;
 var DOLLY_ERRNO = Object.freeze({ E2BIG: 1, EACCES: 2, EADDRINUSE: 3, EADDRNOTAVAIL: 4, EAFNOSUPPORT: 5, EAGAIN: 6, EALREADY: 7, EBADF: 8, EBADMSG: 9, EBUSY: 10, ECANCELED: 11, ECHILD: 12, ECONNABORTED: 13, ECONNREFUSED: 14, ECONNRESET: 15, EDEADLK: 16, EDESTADDRREQ: 17, EDOM: 18, EDQUOT: 19, EEXIST: 20, EFAULT: 21, EFBIG: 22, EHOSTUNREACH: 23, EIDRM: 24, EILSEQ: 25, EINPROGRESS: 26, EINTR: 27, EINVAL: 28, EIO: 29, EISCONN: 30, EISDIR: 31, ELOOP: 32, EMFILE: 33, EMLINK: 34, EMSGSIZE: 35, EMULTIHOP: 36, ENAMETOOLONG: 37, ENETDOWN: 38, ENETRESET: 39, ENETUNREACH: 40, ENFILE: 41, ENOBUFS: 42, ENODEV: 43, ENOENT: 44, ENOEXEC: 45, ENOLCK: 46, ENOLINK: 47, ENOMEM: 48, ENOMSG: 49, ENOPROTOOPT: 50, ENOSPC: 51, ENOSYS: 52, ENOTCONN: 53, ENOTDIR: 54, ENOTEMPTY: 55, ENOTRECOVERABLE: 56, ENOTSOCK: 57, ENOTTY: 59, ENXIO: 60, EOVERFLOW: 61, EOWNERDEAD: 62, EPERM: 63, EPIPE: 64, EPROTO: 65, EPROTONOSUPPORT: 66, EPROTOTYPE: 67, ERANGE: 68, EROFS: 69, ESPIPE: 70, ESRCH: 71, ESTALE: 72, ETIMEDOUT: 73, ETXTBSY: 74, EXDEV: 75, ENODATA: 116, ENOTSUP: 138 });
 
-// src/wasm-interface.mjs
+// page/wasm-interface.mjs
 var decoder = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
 var valueTypes = /* @__PURE__ */ new Map([
   [127, "i32"],
@@ -386,15 +389,20 @@ var DOLLY_HOST_NAME_BYTES = 32;
 var DOLLY_HOST_DIGEST_BYTES = 32;
 var DOLLY_HOST_MAX_RECORDS = 64;
 
-// src/snapshot-records.mjs
+// host/runtime/abi.mjs
+var DOLLY_SNAPSHOT_MAX_MEBIBYTES = 2048;
+var DOLLY_ERRNO2 = Object.freeze({ E2BIG: 1, EACCES: 2, EADDRINUSE: 3, EADDRNOTAVAIL: 4, EAFNOSUPPORT: 5, EAGAIN: 6, EALREADY: 7, EBADF: 8, EBADMSG: 9, EBUSY: 10, ECANCELED: 11, ECHILD: 12, ECONNABORTED: 13, ECONNREFUSED: 14, ECONNRESET: 15, EDEADLK: 16, EDESTADDRREQ: 17, EDOM: 18, EDQUOT: 19, EEXIST: 20, EFAULT: 21, EFBIG: 22, EHOSTUNREACH: 23, EIDRM: 24, EILSEQ: 25, EINPROGRESS: 26, EINTR: 27, EINVAL: 28, EIO: 29, EISCONN: 30, EISDIR: 31, ELOOP: 32, EMFILE: 33, EMLINK: 34, EMSGSIZE: 35, EMULTIHOP: 36, ENAMETOOLONG: 37, ENETDOWN: 38, ENETRESET: 39, ENETUNREACH: 40, ENFILE: 41, ENOBUFS: 42, ENODEV: 43, ENOENT: 44, ENOEXEC: 45, ENOLCK: 46, ENOLINK: 47, ENOMEM: 48, ENOMSG: 49, ENOPROTOOPT: 50, ENOSPC: 51, ENOSYS: 52, ENOTCONN: 53, ENOTDIR: 54, ENOTEMPTY: 55, ENOTRECOVERABLE: 56, ENOTSOCK: 57, ENOTTY: 59, ENXIO: 60, EOVERFLOW: 61, EOWNERDEAD: 62, EPERM: 63, EPIPE: 64, EPROTO: 65, EPROTONOSUPPORT: 66, EPROTOTYPE: 67, ERANGE: 68, EROFS: 69, ESPIPE: 70, ESRCH: 71, ESTALE: 72, ETIMEDOUT: 73, ETXTBSY: 74, EXDEV: 75, ENODATA: 116, ENOTSUP: 138 });
+
+// page/snapshot-records.mjs
 var decoder2 = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
-var MAX_SNAPSHOT_BYTES = 2 * 1024 * 1024 * 1024;
+var encoder = new TextEncoder();
+var MAX_SNAPSHOT_BYTES = DOLLY_SNAPSHOT_MAX_MEBIBYTES * 1024 * 1024;
 var MAX_SNAPSHOT_PACKS = MAX_SNAPSHOT_BYTES / (1024 * 1024);
 
-// src/version.mjs
-var DOLLY_VERSION = "0.1.5";
+// page/version.mjs
+var DOLLY_VERSION = "0.1.6";
 
-// src/static-asset.mjs
+// page/static-asset.mjs
 var STATIC_PART_BYTES = 20 * 1024 * 1024;
 var hex = (bytes) => Array.from(bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes), (byte) => byte.toString(16).padStart(2, "0")).join("");
 var sitePrefix = `/v${DOLLY_VERSION}`;
@@ -1176,7 +1184,7 @@ function createProcessFfi({
   });
 }
 
-// src/process-abi.mjs
+// page/process-abi.mjs
 function unique(entries, key) {
   const result = /* @__PURE__ */ new Map();
   for (const entry of entries) {
@@ -1406,7 +1414,7 @@ function createThreadRecords({ memory, address, allocate, apply }) {
 // host/dso/process.mjs
 var DSO_RESPONSE_SIZE = 16 + DOLLY_DSO_ERROR_CAPACITY;
 var LOAD_FAILED = 2147483648;
-var encoder = new TextEncoder();
+var encoder2 = new TextEncoder();
 var decoder3 = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
 var configuration;
 var instance;
@@ -1704,7 +1712,7 @@ function symbolIndex(handle, name, value) {
   return threadRecords.change((publish) => {
     const indexed = functionIndices.get(value.value);
     if (indexed !== void 0) return indexed;
-    const bytes = encoder.encode(name);
+    const bytes = encoder2.encode(name);
     const copy = keep(bytes);
     const index = functionIndex(value.value);
     publish({ kind: DOLLY_DSO_SYMBOL, values: [handle, copy, BigInt(bytes.length), index, 0n] }, true);
@@ -1756,7 +1764,7 @@ function futexWait(request) {
 }
 function writeDsoResponse(response, value = 0n, error = 0, message = "") {
   if (response.size < DSO_RESPONSE_SIZE) return -BigInt(DOLLY_ERRNO.ENOBUFS);
-  const bytes = encoder.encode(message);
+  const bytes = encoder2.encode(message);
   const messageSize = Math.min(bytes.length, DOLLY_DSO_ERROR_CAPACITY);
   const output = new Uint8Array(
     configuration.memory.buffer,

package/dist/dolly-process-worker.mjs

@@ -1,4 +1,4 @@
-// src/process-constants.mjs
+// page/process-constants.mjs
 var DOLLY_PROCESS_PACKET_LIMIT = 1048576;
 var DOLLY_PROCESS_EXIT = 5;
 var DOLLY_PROCESS_CLOCK_TIME = 48;
@@ -85,51 +85,105 @@ var DOLLY_ERRNO = Object.freeze({
 });
 var DOLLY_PROCESS_SIZEOF = Object.freeze({
   dolly_process_vector_sizes: 16,
+  dolly_process_exit_request: 8,
   dolly_process_fd_io_request: 16,
   dolly_process_fd_pread_request: 24,
   dolly_process_fd_truncate_request: 16,
   dolly_process_fd_request: 8,
   dolly_process_timestamp: 16,
   dolly_process_fd_times_request: 40,
+  dolly_process_io_result: 8,
   dolly_process_fd_dup_request: 16,
+  dolly_process_fd_dup_response: 8,
   dolly_process_fd_flags: 8,
   dolly_process_fd_lock_request: 32,
   dolly_process_fd_lock_response: 24,
+  dolly_process_pipe_request: 8,
+  dolly_process_pipe_response: 8,
   dolly_process_poll_request: 16,
   dolly_process_poll_query: 8,
   dolly_process_poll_response: 16,
   dolly_process_poll_result: 8,
-  dolly_process_directory_entry: 24,
   dolly_process_directory_request: 24,
-  dolly_process_stat_response: 88,
-  dolly_process_filesystem_stat_response: 96,
-  dolly_process_spawn_request: 72,
-  dolly_process_fd_mapping: 8,
+  dolly_process_directory_entry: 24,
+  dolly_process_fd_seek_request: 16,
+  dolly_process_fd_seek_response: 8,
+  dolly_process_clock_request: 16,
+  dolly_process_clock_response: 8,
+  dolly_process_clock_sleep_request: 16,
   dolly_process_exec_state: 16,
+  dolly_process_fd_mapping: 8,
+  dolly_process_spawn_request: 72,
+  dolly_process_spawn_response: 8,
   dolly_process_exec_request: 48,
-  dolly_process_pipe_request: 8,
-  dolly_process_two_path_request: 16,
-  dolly_process_path_times_request: 48,
-  dolly_process_terminal_request: 24,
-  dolly_process_terminal_response: 16,
-  dolly_process_clock_sleep_request: 16,
-  dolly_process_exit_request: 8,
   dolly_process_wait_request: 8,
   dolly_process_wait_response: 16,
+  dolly_process_info_response: 8,
   dolly_process_signal_request: 8,
-  dolly_process_alarm: 16,
   dolly_process_signal_dispositions: 8,
-  dolly_process_fd_seek_request: 16,
-  dolly_process_clock_request: 16,
-  dolly_process_path_request: 16
+  dolly_process_alarm: 16,
+  dolly_process_terminal_request: 24,
+  dolly_process_terminal_response: 16,
+  dolly_process_path_request: 16,
+  dolly_process_path_times_request: 48,
+  dolly_process_path_open_response: 8,
+  dolly_process_stat_response: 88,
+  dolly_process_filesystem_stat_response: 96,
+  dolly_process_two_path_request: 16
+});
+var DOLLY_PROCESS_OFFSETOF = Object.freeze({
+  dolly_process_vector_sizes: Object.freeze({ "count": 0, "reserved": 4, "bytes": 8 }),
+  dolly_process_exit_request: Object.freeze({ "status": 0, "signal_number": 4 }),
+  dolly_process_fd_io_request: Object.freeze({ "descriptor": 0, "reserved": 4, "size": 8 }),
+  dolly_process_fd_pread_request: Object.freeze({ "descriptor": 0, "reserved": 4, "offset": 8, "size": 16 }),
+  dolly_process_fd_truncate_request: Object.freeze({ "descriptor": 0, "reserved": 4, "size": 8 }),
+  dolly_process_fd_request: Object.freeze({ "descriptor": 0, "reserved": 4 }),
+  dolly_process_timestamp: Object.freeze({ "seconds": 0, "nanoseconds": 8, "flags": 12 }),
+  dolly_process_fd_times_request: Object.freeze({ "descriptor": 0, "reserved": 4, "access": 8, "modification": 24 }),
+  dolly_process_io_result: Object.freeze({ "size": 0 }),
+  dolly_process_fd_dup_request: Object.freeze({ "source_descriptor": 0, "target_descriptor": 4, "flags": 8, "reserved": 12 }),
+  dolly_process_fd_dup_response: Object.freeze({ "descriptor": 0, "reserved": 4 }),
+  dolly_process_fd_flags: Object.freeze({ "descriptor": 0, "flags": 4 }),
+  dolly_process_fd_lock_request: Object.freeze({ "descriptor": 0, "flags": 4, "type": 8, "whence": 12, "start": 16, "length": 24 }),
+  dolly_process_fd_lock_response: Object.freeze({ "type": 0, "pid": 4, "start": 8, "length": 16 }),
+  dolly_process_pipe_request: Object.freeze({ "flags": 0, "reserved": 4 }),
+  dolly_process_pipe_response: Object.freeze({ "read_descriptor": 0, "write_descriptor": 4 }),
+  dolly_process_poll_request: Object.freeze({ "deadline_nanoseconds": 0, "count": 8, "reserved": 12 }),
+  dolly_process_poll_query: Object.freeze({ "descriptor": 0, "events": 4, "reserved": 6 }),
+  dolly_process_poll_response: Object.freeze({ "ready": 0, "count": 4, "reserved": 8 }),
+  dolly_process_poll_result: Object.freeze({ "events": 0, "reserved": 2, "reserved2": 4 }),
+  dolly_process_directory_request: Object.freeze({ "descriptor": 0, "maximum_entries": 4, "cookie": 8, "reserved": 16 }),
+  dolly_process_directory_entry: Object.freeze({ "inode": 0, "next_cookie": 8, "file_type": 16, "name_size": 20 }),
+  dolly_process_fd_seek_request: Object.freeze({ "descriptor": 0, "whence": 4, "offset": 8 }),
+  dolly_process_fd_seek_response: Object.freeze({ "offset": 0 }),
+  dolly_process_clock_request: Object.freeze({ "clock_id": 0, "reserved": 4, "precision_nanoseconds": 8 }),
+  dolly_process_clock_response: Object.freeze({ "nanoseconds": 0 }),
+  dolly_process_clock_sleep_request: Object.freeze({ "clock_id": 0, "flags": 4, "deadline_nanoseconds": 8 }),
+  dolly_process_exec_state: Object.freeze({ "blocked_signals": 0, "ignored_signals": 4, "pending_signals": 8, "reserved": 12 }),
+  dolly_process_fd_mapping: Object.freeze({ "source_descriptor": 0, "target_descriptor": 4 }),
+  dolly_process_spawn_request: Object.freeze({ "flags": 0, "argument_count": 4, "environment_count": 8, "cwd_size": 12, "mapping_count": 16, "descriptor_inheritance": 20, "reserved": 24, "path_size": 28, "argument_bytes": 32, "environment_bytes": 40, "deadline_nanoseconds": 48, "signals": 56 }),
+  dolly_process_spawn_response: Object.freeze({ "pid": 0, "reserved": 4 }),
+  dolly_process_exec_request: Object.freeze({ "signals": 0, "argument_count": 16, "environment_count": 20, "path_size": 24, "reserved": 28, "argument_bytes": 32, "environment_bytes": 40 }),
+  dolly_process_wait_request: Object.freeze({ "pid": 0, "flags": 4 }),
+  dolly_process_wait_response: Object.freeze({ "pid": 0, "status": 4, "signal_number": 8, "reserved": 12 }),
+  dolly_process_info_response: Object.freeze({ "pid": 0, "parent_pid": 4 }),
+  dolly_process_signal_request: Object.freeze({ "pid": 0, "signal_number": 4 }),
+  dolly_process_signal_dispositions: Object.freeze({ "ignored_signals": 0, "handled_signals": 4 }),
+  dolly_process_alarm: Object.freeze({ "value_nanoseconds": 0, "interval_nanoseconds": 8 }),
+  dolly_process_terminal_request: Object.freeze({ "operation": 0, "descriptor": 4, "flags": 8, "reserved": 12, "deadline_nanoseconds": 16 }),
+  dolly_process_terminal_response: Object.freeze({ "value": 0, "columns": 8, "rows": 12 }),
+  dolly_process_path_request: Object.freeze({ "directory_descriptor": 0, "flags": 4, "reserved": 8, "path_size": 12 }),
+  dolly_process_path_times_request: Object.freeze({ "directory_descriptor": 0, "flags": 4, "reserved": 8, "path_size": 12, "access": 16, "modification": 32 }),
+  dolly_process_path_open_response: Object.freeze({ "descriptor": 0, "reserved": 4 }),
+  dolly_process_stat_response: Object.freeze({ "device": 0, "inode": 8, "size": 16, "access_nanoseconds": 24, "modification_nanoseconds": 32, "change_nanoseconds": 40, "blocks": 48, "mode": 56, "link_count": 60, "user": 64, "group": 68, "block_size": 72, "file_type": 76, "reserved": 80 }),
+  dolly_process_filesystem_stat_response: Object.freeze({ "type": 0, "block_size": 8, "blocks": 16, "blocks_free": 24, "blocks_available": 32, "files": 40, "files_free": 48, "maximum_name_length": 56, "fragment_size": 64, "flags": 72, "filesystem_id": 80, "reserved": 88 }),
+  dolly_process_two_path_request: Object.freeze({ "old_directory_descriptor": 0, "new_directory_descriptor": 4, "old_path_size": 8, "new_path_size": 12 })
 });
 
-// host/threads/abi.mjs
-var DOLLY_THREAD_SPAWN = 144;
-var DOLLY_THREAD_EXIT = 146;
-var DOLLY_ERRNO2 = Object.freeze({ E2BIG: 1, EACCES: 2, EADDRINUSE: 3, EADDRNOTAVAIL: 4, EAFNOSUPPORT: 5, EAGAIN: 6, EALREADY: 7, EBADF: 8, EBADMSG: 9, EBUSY: 10, ECANCELED: 11, ECHILD: 12, ECONNABORTED: 13, ECONNREFUSED: 14, ECONNRESET: 15, EDEADLK: 16, EDESTADDRREQ: 17, EDOM: 18, EDQUOT: 19, EEXIST: 20, EFAULT: 21, EFBIG: 22, EHOSTUNREACH: 23, EIDRM: 24, EILSEQ: 25, EINPROGRESS: 26, EINTR: 27, EINVAL: 28, EIO: 29, EISCONN: 30, EISDIR: 31, ELOOP: 32, EMFILE: 33, EMLINK: 34, EMSGSIZE: 35, EMULTIHOP: 36, ENAMETOOLONG: 37, ENETDOWN: 38, ENETRESET: 39, ENETUNREACH: 40, ENFILE: 41, ENOBUFS: 42, ENODEV: 43, ENOENT: 44, ENOEXEC: 45, ENOLCK: 46, ENOLINK: 47, ENOMEM: 48, ENOMSG: 49, ENOPROTOOPT: 50, ENOSPC: 51, ENOSYS: 52, ENOTCONN: 53, ENOTDIR: 54, ENOTEMPTY: 55, ENOTRECOVERABLE: 56, ENOTSOCK: 57, ENOTTY: 59, ENXIO: 60, EOVERFLOW: 61, EOWNERDEAD: 62, EPERM: 63, EPIPE: 64, EPROTO: 65, EPROTONOSUPPORT: 66, EPROTOTYPE: 67, ERANGE: 68, EROFS: 69, ESPIPE: 70, ESRCH: 71, ESTALE: 72, ETIMEDOUT: 73, ETXTBSY: 74, EXDEV: 75, ENODATA: 116, ENOTSUP: 138 });
-
-// src/process-worker.mjs
+// page/process-worker.mjs
+var clockField = DOLLY_PROCESS_OFFSETOF.dolly_process_clock_request;
+var clockRequestSize = DOLLY_PROCESS_SIZEOF.dolly_process_clock_request;
+var clockResponseSize = DOLLY_PROCESS_SIZEOF.dolly_process_clock_response;
 var PROCESS_EXIT = Symbol("Dolly process exit");
 var THREAD_EXIT = Symbol("Dolly thread exit");
 var UNSTARTED = Symbol("Dolly thread ended before it started");
@@ -148,7 +202,8 @@ var configuration = await new Promise((resolve, reject) => {
     resolve(event.data);
   });
 });
-if (!(configuration.module instanceof WebAssembly.Module || configuration.module instanceof MessagePort) || !(configuration.gateModule instanceof WebAssembly.Module) || !(configuration.kernelMemory instanceof WebAssembly.Memory) || !(configuration.control instanceof SharedArrayBuffer) || !Array.isArray(configuration.local) || configuration.control.byteLength !== 32 || !Number.isFinite(configuration.clockOrigin) || !Number.isSafeInteger(configuration.mailbox) || configuration.mailbox <= 0 || typeof configuration.memory?.initial !== "bigint" || typeof configuration.memory?.maximum !== "bigint" || configuration.port !== void 0 && !(configuration.port instanceof MessagePort) || !Number.isInteger(configuration.pid) || configuration.pid <= 0) {
+var threadOperations = configuration.threaded ? configuration.threadOperations : {};
+if (!(configuration.module instanceof WebAssembly.Module || configuration.module instanceof MessagePort) || !(configuration.gateModule instanceof WebAssembly.Module) || !(configuration.kernelMemory instanceof WebAssembly.Memory) || !(configuration.control instanceof SharedArrayBuffer) || !Array.isArray(configuration.local) || configuration.control.byteLength !== 32 || !Number.isFinite(configuration.clockOrigin) || !Number.isSafeInteger(configuration.mailbox) || configuration.mailbox <= 0 || typeof configuration.memory?.initial !== "bigint" || typeof configuration.memory?.maximum !== "bigint" || configuration.port !== void 0 && !(configuration.port instanceof MessagePort) || !Number.isInteger(configuration.pid) || configuration.pid <= 0 || configuration.threaded && !(Number.isInteger(configuration.threadOperations?.spawn) && Number.isInteger(configuration.threadOperations?.exit))) {
   throw new Error("Dolly process received an invalid configuration");
 }
 var control = new Int32Array(configuration.control);
@@ -245,8 +300,8 @@ function clockResponse(clock, response, now) {
   const nanoseconds = Math.round(
     (clock === DOLLY_PROCESS_CLOCK_REALTIME ? Date.now() : now + clockOffset) * 1e6
   );
-  new DataView(memory.buffer, response.address, 8).setBigUint64(0, BigInt(nanoseconds), true);
-  return 8n;
+  new DataView(memory.buffer, response.address, clockResponseSize).setBigUint64(DOLLY_PROCESS_OFFSETOF.dolly_process_clock_response.nanoseconds, BigInt(nanoseconds), true);
+  return BigInt(clockResponseSize);
 }
 function copyRequest(request) {
   if (Atomics.compareExchange(control, 4, 0, 1) !== 0) return false;
@@ -276,12 +331,12 @@ function call(operation, requestAddressValue, requestSizeValue, responseAddressV
   for (const module of localModules) {
     if (module.handles(operation)) return module.call(operation, request, response);
   }
-  const exitingResult = operation === DOLLY_THREAD_EXIT && request.size === 8 ? new DataView(memory.buffer, request.address, 8).getBigUint64(0, true) : void 0;
+  const exitingResult = operation === threadOperations.exit && request.size === 8 ? new DataView(memory.buffer, request.address, 8).getBigUint64(0, true) : void 0;
   let clock;
-  if (operation === DOLLY_PROCESS_CLOCK_TIME && request.size === 16 && response.size >= 8 && response.size <= DOLLY_PROCESS_PACKET_LIMIT) {
-    const packet = new DataView(memory.buffer, request.address, 16);
-    const id = packet.getUint32(0, true);
-    if ((id === DOLLY_PROCESS_CLOCK_REALTIME || id === DOLLY_PROCESS_CLOCK_MONOTONIC) && packet.getUint32(4, true) === 0) clock = id;
+  if (operation === DOLLY_PROCESS_CLOCK_TIME && request.size === clockRequestSize && response.size >= clockResponseSize && response.size <= DOLLY_PROCESS_PACKET_LIMIT) {
+    const packet = new DataView(memory.buffer, request.address, clockRequestSize);
+    const id = packet.getUint32(clockField.clock_id, true);
+    if ((id === DOLLY_PROCESS_CLOCK_REALTIME || id === DOLLY_PROCESS_CLOCK_MONOTONIC) && packet.getUint32(clockField.reserved, true) === 0) clock = id;
     const now = performance.now();
     if (clock !== void 0 && now - lastSignalCheck < 1) return clockResponse(clock, response, now);
   }
@@ -295,7 +350,7 @@ function call(operation, requestAddressValue, requestSizeValue, responseAddressV
   const memoryBytes = memory.buffer.byteLength;
   let channel;
   if (openChannels.length) closeReceivedChannels();
-  if (operation === DOLLY_THREAD_SPAWN && configuration.threaded) {
+  if (operation === threadOperations.spawn && configuration.threaded) {
     if (!reserveMaximum()) return -BigInt(DOLLY_ERRNO.EAGAIN);
     channel = new MessageChannel();
   }
@@ -334,7 +389,7 @@ function call(operation, requestAddressValue, requestSizeValue, responseAddressV
   if (result === deferredResult) return ended(PROCESS_EXIT);
   if (result > 0n) gate.exports.response(mailbox, BigInt(response.address), result);
   lastSignalCheck = result === -BigInt(DOLLY_ERRNO.EINTR) ? -Infinity : performance.now();
-  if (operation === DOLLY_THREAD_EXIT && result >= 0n) {
+  if (operation === threadOperations.exit && result >= 0n) {
     threadResult = exitingResult;
     for (const module of localModules) module.leaving?.();
     return ended(THREAD_EXIT);