libfx 0.0.1 → 0.0.2

package/README.md

@@ -73,6 +73,6 @@ The staging script includes `zig-out/lib/libfx.node` by default for local testin
 
 The npm `latest` dist-tag is the stable channel. The `dev` dist-tag tracks successful builds from `main` and uses immutable prerelease versions. Publishing runs through `.github/workflows/publish-libfx.yml` with npm trusted publishing and provenance. Configure the npm trusted publisher for the `vercel-labs/fx` repository, workflow filename `publish-libfx.yml`, and GitHub environment `npm`. Because npm requires a package to exist before trusted publishing can be configured, the first `libfx` version must be published once by a maintainer before enabling that relationship.
 
-JavaScript hosts may also provide configuration, prompt history, session persistence, device login, URL opening, and a foreground workspace. The optional workspace adapter exposes only `run_command`, delegated to the host.
+JavaScript hosts can provide configuration, prompt history, session persistence, device login, URL opening, and a foreground workspace. The optional workspace adapter exposes only `terminal` with `{ action: "exec", command }`; command execution is delegated to the host in a clean, root-fixed environment.
 
 WebAssembly builds do not include native processes, OS sandboxing, native MCP, subagents, skills, auto-upgrade, clipboard integration, arbitrary WASI filesystem access, or web search.

package/fx-sdk.js

@@ -4,6 +4,7 @@ const strictDecoder = new TextDecoder("utf-8", { fatal: true });
 const workspaceInfoLimit = 4 * 1024;
 const workspaceCommandLimit = 64 * 1024;
 const workspaceOutputLimit = 64 * 1024;
+const streamReadsPerTaskYield = 32;
 
 function validWorkspacePath(path) {
   if (typeof path !== "string" || !path.startsWith("/") || path.includes("\0")) return false;
@@ -205,6 +206,13 @@ function raceWithTimeout(promise, timeoutMs, timeoutValue) {
   });
 }
 
+function yieldToHostTask() {
+  if (typeof globalThis.setImmediate === "function") {
+    return new Promise((resolve) => globalThis.setImmediate(resolve));
+  }
+  return new Promise((resolve) => setTimeout(resolve, 0));
+}
+
 function createRuntime(options) {
   const stdin = new ByteQueue();
   const streams = new Map();
@@ -332,6 +340,7 @@ function createRuntime(options) {
     options.onTerminalPoll?.();
     if (stdin.chunks.length) return 1;
     if (stdin.closed) return -1;
+    if (timeoutMs === 0) return 0;
     return stdin.wait(timeoutMs >= 0 ? timeoutMs : undefined).then(() =>
       stdin.chunks.length ? 1 : (stdin.closed ? -1 : 0));
   }
@@ -355,6 +364,7 @@ function createRuntime(options) {
       pendingRead: null,
       readResult: null,
       readError: null,
+      readsSinceTaskYield: 0,
     };
     streams.set(handle, state);
     state.responseSettled = Promise.resolve().then(() => options.fetch(text(urlPtr, urlLen), {
@@ -389,6 +399,13 @@ function createRuntime(options) {
   function streamNext(handle, outPtr, outCap) {
     const state = streams.get(handle);
     if (!state) return -1;
+    const yieldAfterReadyResult = (result) => {
+      if (result <= 0) return result;
+      state.readsSinceTaskYield += 1;
+      if (state.readsSinceTaskYield < streamReadsPerTaskYield) return result;
+      state.readsSinceTaskYield = 0;
+      return yieldToHostTask().then(() => result);
+    };
     const copy = (chunk) => {
       const written = chunk.subarray(0, outCap);
       bytes(outPtr, written.length).set(written);
@@ -406,7 +423,7 @@ function createRuntime(options) {
       return copy(value);
     };
     const immediate = consume();
-    if (immediate !== null) return immediate;
+    if (immediate !== null) return yieldAfterReadyResult(immediate);
     if (!state.reader) return 0;
     if (!state.pendingRead) {
       state.pendingRead = state.reader.read().then((result) => {
@@ -420,7 +437,7 @@ function createRuntime(options) {
     return raceWithTimeout(state.pendingRead.then(() => true), 50, false).then((ready) => {
       if (!ready) return -3;
       const result = consume();
-      return result === null ? -3 : result;
+      return result === null ? -3 : yieldAfterReadyResult(result);
     });
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libfx",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Embed fx agents and terminals in JavaScript hosts",
   "type": "module",
   "repository": {