@ricsam/r5d-browser 0.0.66 → 0.0.68

package/README.md

@@ -22,6 +22,8 @@ r5d-browser start --chrome-path "/Applications/Google Chrome.app/Contents/MacOS/
 
 The profile is stored under `~/.r5d/browser/chrome-profile`. The previous Chrome for Testing profile at `~/.r5d/browser/profile` is preserved but is not migrated automatically, so sign in again the first time you use the new profile. Browser binaries previously installed under `~/.r5d/browser/browsers` are also left untouched, but new versions of `r5d-browser` do not use them. Completed downloads are retained under `~/.r5d/browser/downloads`; agents can list them and copy a selected file into the active session's artifacts. That artifact is then synchronized to every connected worker. Browser screenshots are session artifacts in r5d.dev and are not retained by the browser process.
 
+Agents running JavaScript in a page can save captured text straight into the active session's artifacts by calling `r5dCreateArtifact(filename, content)`, which takes two strings and must be called before the agent's code returns. Each captured file is written to the session artifacts in r5d.dev, synchronized to every connected worker, and reported back as a `$R5D_ARTIFACTS_DIR` path; a single call may create at most 32 files totalling 4 MiB. The function is passed into the agent's code rather than assigned to `window`, so pages can neither call it nor use it to detect automation.
+
 Agents can also create loopback-only TCP port forwards from this Mac to the worker bound to a chat. For example, a forward can map Chrome's `localhost:4323` to `127.0.0.1:3232` on that worker. The relay preserves raw TCP traffic, including HTTP, HTTPS, WebSockets, HMR, and SSE; it never exposes a public listener or permits an arbitrary target host.
 
 Port forwards remain active across agent turns and r5d.dev control-connection reconnects. They are owned by the running `r5d-browser` process, so restarting that process ends them. Agents can list and stop forwards, and the user can inspect or stop them from Settings.

package/dist/cjs/browser-runtime.cjs

@@ -34,6 +34,9 @@ module.exports = __toCommonJS(browser_runtime_exports);
 var import_node_fs = __toESM(require("node:fs"), 1);
 var import_node_path = __toESM(require("node:path"), 1);
 const MAX_DOWNLOAD_CHUNK_BYTES = 1024 * 1024;
+const MAX_RUN_JS_RESULT_BYTES = 1024 * 1024;
+const MAX_RUN_JS_ARTIFACT_BYTES = 4 * 1024 * 1024;
+const MAX_RUN_JS_ARTIFACT_COUNT = 32;
 class BrowserRuntime {
   constructor(context, downloadsPath) {
     this.context = context;
@@ -272,17 +275,46 @@ class BrowserRuntime {
         return { tabId, characters: input.text.length };
       case "run_js": {
         if (typeof input.code !== "string") throw new Error("run_js requires code.");
-        const result = await page.evaluate(async (code) => {
-          const invoke = new Function(`"use strict"; return (async () => {
+        const evaluated = await page.evaluate(
+          async ({ code, maxBytes, maxCount }) => {
+            const artifacts = [];
+            let totalBytes = 0;
+            const r5dCreateArtifact = (filename, content) => {
+              if (typeof filename !== "string" || !filename.trim()) {
+                throw new TypeError("r5dCreateArtifact(filename, content): filename must be a non-empty string.");
+              }
+              if (typeof content !== "string") {
+                throw new TypeError(
+                  `r5dCreateArtifact(${JSON.stringify(filename)}, content): content must be a string. Use JSON.stringify(value) for objects.`
+                );
+              }
+              if (artifacts.length >= maxCount) {
+                throw new RangeError(`r5dCreateArtifact: at most ${maxCount} artifacts can be created in one browser_run_js call.`);
+              }
+              totalBytes += new TextEncoder().encode(content).length;
+              if (totalBytes > maxBytes) {
+                throw new RangeError(`r5dCreateArtifact: artifact content exceeded the ${maxBytes} byte budget for one browser_run_js call.`);
+              }
+              artifacts.push({ filename, content });
+              return filename;
+            };
+            const invoke = new Function("r5dCreateArtifact", `"use strict"; return (async () => {
 ${code}
 })()`);
-          return await invoke();
-        }, input.code);
-        const serialized = JSON.stringify(result);
-        if (serialized && Buffer.byteLength(serialized) > 1024 * 1024) {
+            try {
+              return { result: await invoke(r5dCreateArtifact), artifacts };
+            } catch (error) {
+              if (artifacts.length === 0) throw error;
+              return { artifacts, failure: error instanceof Error ? error.message : String(error) };
+            }
+          },
+          { code: input.code, maxBytes: MAX_RUN_JS_ARTIFACT_BYTES, maxCount: MAX_RUN_JS_ARTIFACT_COUNT }
+        );
+        const serialized = JSON.stringify(evaluated.result);
+        if (serialized && Buffer.byteLength(serialized) > MAX_RUN_JS_RESULT_BYTES) {
           throw new Error("Browser JavaScript result exceeded the 1 MiB limit.");
         }
-        return { tabId, result };
+        return { tabId, result: evaluated.result, artifacts: evaluated.artifacts, failure: evaluated.failure };
       }
       default:
         throw new Error(`Unsupported browser operation: ${action}`);

package/dist/cjs/main.cjs

@@ -150,7 +150,7 @@ async function connectLoop(params) {
             version: findVersion(),
             chromiumVersion: params.chromiumVersion,
             profilePath: params.profilePath,
-            capabilities: { portForwarding: true }
+            capabilities: { portForwarding: true, runJsArtifacts: true }
           },
           tabs: await params.runtime.listTabs(),
           portForwards: params.portForwards.list()

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/r5d-browser",
-  "version": "0.0.66",
+  "version": "0.0.68",
   "type": "commonjs"
 }

package/dist/mjs/browser-runtime.mjs

@@ -1,6 +1,9 @@
 import fs from "node:fs";
 import path from "node:path";
 const MAX_DOWNLOAD_CHUNK_BYTES = 1024 * 1024;
+const MAX_RUN_JS_RESULT_BYTES = 1024 * 1024;
+const MAX_RUN_JS_ARTIFACT_BYTES = 4 * 1024 * 1024;
+const MAX_RUN_JS_ARTIFACT_COUNT = 32;
 class BrowserRuntime {
   constructor(context, downloadsPath) {
     this.context = context;
@@ -239,17 +242,46 @@ class BrowserRuntime {
         return { tabId, characters: input.text.length };
       case "run_js": {
         if (typeof input.code !== "string") throw new Error("run_js requires code.");
-        const result = await page.evaluate(async (code) => {
-          const invoke = new Function(`"use strict"; return (async () => {
+        const evaluated = await page.evaluate(
+          async ({ code, maxBytes, maxCount }) => {
+            const artifacts = [];
+            let totalBytes = 0;
+            const r5dCreateArtifact = (filename, content) => {
+              if (typeof filename !== "string" || !filename.trim()) {
+                throw new TypeError("r5dCreateArtifact(filename, content): filename must be a non-empty string.");
+              }
+              if (typeof content !== "string") {
+                throw new TypeError(
+                  `r5dCreateArtifact(${JSON.stringify(filename)}, content): content must be a string. Use JSON.stringify(value) for objects.`
+                );
+              }
+              if (artifacts.length >= maxCount) {
+                throw new RangeError(`r5dCreateArtifact: at most ${maxCount} artifacts can be created in one browser_run_js call.`);
+              }
+              totalBytes += new TextEncoder().encode(content).length;
+              if (totalBytes > maxBytes) {
+                throw new RangeError(`r5dCreateArtifact: artifact content exceeded the ${maxBytes} byte budget for one browser_run_js call.`);
+              }
+              artifacts.push({ filename, content });
+              return filename;
+            };
+            const invoke = new Function("r5dCreateArtifact", `"use strict"; return (async () => {
 ${code}
 })()`);
-          return await invoke();
-        }, input.code);
-        const serialized = JSON.stringify(result);
-        if (serialized && Buffer.byteLength(serialized) > 1024 * 1024) {
+            try {
+              return { result: await invoke(r5dCreateArtifact), artifacts };
+            } catch (error) {
+              if (artifacts.length === 0) throw error;
+              return { artifacts, failure: error instanceof Error ? error.message : String(error) };
+            }
+          },
+          { code: input.code, maxBytes: MAX_RUN_JS_ARTIFACT_BYTES, maxCount: MAX_RUN_JS_ARTIFACT_COUNT }
+        );
+        const serialized = JSON.stringify(evaluated.result);
+        if (serialized && Buffer.byteLength(serialized) > MAX_RUN_JS_RESULT_BYTES) {
           throw new Error("Browser JavaScript result exceeded the 1 MiB limit.");
         }
-        return { tabId, result };
+        return { tabId, result: evaluated.result, artifacts: evaluated.artifacts, failure: evaluated.failure };
       }
       default:
         throw new Error(`Unsupported browser operation: ${action}`);

package/dist/mjs/main.mjs

@@ -127,7 +127,7 @@ async function connectLoop(params) {
             version: findVersion(),
             chromiumVersion: params.chromiumVersion,
             profilePath: params.profilePath,
-            capabilities: { portForwarding: true }
+            capabilities: { portForwarding: true, runJsArtifacts: true }
           },
           tabs: await params.runtime.listTabs(),
           portForwards: params.portForwards.list()

package/dist/mjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/r5d-browser",
-  "version": "0.0.66",
+  "version": "0.0.68",
   "type": "module"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/r5d-browser",
-  "version": "0.0.66",
+  "version": "0.0.68",
   "type": "module",
   "main": "./dist/cjs/main.cjs",
   "module": "./dist/mjs/main.mjs",