@mindstone/mcp-server-browser-automation 0.2.2 → 0.2.3

package/README.md

@@ -9,7 +9,7 @@ Browser control you can watch: open pages, sign in, click around, fill forms, ta
 
 ## Status
 
-- **Version:** [0.2.2](./CHANGELOG.md) · [npm](https://www.npmjs.com/package/@mindstone/mcp-server-browser-automation)
+- **Version:** [0.2.3](./CHANGELOG.md) · [npm](https://www.npmjs.com/package/@mindstone/mcp-server-browser-automation)
 - **Auth:** None ([`server.json`](./server.json))
 - **Tools:** [21](./src/tools/) (navigation, observation, interaction, sessions, files)
 - **Surface:** browser-automation
@@ -117,6 +117,7 @@ No API keys or credentials are required. The server communicates with the browse
 |---|---|---|
 | `AGENT_BROWSER_SESSION_NAME` | No | Session name for browser persistence (default: `mcp`) |
 | `AGENT_BROWSER_SHOW_WINDOW` | No | Set to `false` to run without a visible browser window. Default is visible (`true`). |
+| `AGENT_BROWSER_AUTOSAVE_INTERVAL_MS` | No | Periodic session autosave interval in milliseconds (needs `agent-browser` 0.31.2 or later). Default `0` (off), because each periodic save briefly opens a tab that brings a visible browser window in front of other apps. The session is still saved when the browser closes (`browser_close`). Any value you set is passed through as-is; an empty or non-numeric value gets the CLI's 30-second default. The `agent-browser` daemon reads it when it starts, so an already-running daemon keeps its previous setting until it exits (for example after `browser_close`). |
 | `MCP_WORKSPACE_PATH` | No | Workspace directory that `browser_pdf` writes into and `browser_upload` reads from. Defaults to the system temp directory. See [Security notes](#security-notes). |
 
 ### MCP Host Configuration

package/dist/browser-client.js

@@ -18,6 +18,16 @@ function buildEnv() {
     if (!env.AGENT_BROWSER_SESSION_NAME) {
         env.AGENT_BROWSER_SESSION_NAME = SESSION_NAME;
     }
+    // A session name turns on the CLI's periodic autosave (every 30s by
+    // default, agent-browser >= 0.31.2). Each save opens a temporary tab, which
+    // brings a visible browser window in front of the user's other apps.
+    // Save-on-close still persists the session, so periodic saves stay off
+    // unless the host sets an interval. A host value, including an empty
+    // string, passes through untouched; the CLI treats empty or non-numeric
+    // values as its 30s default. The daemon reads this only when it starts.
+    if (env.AGENT_BROWSER_AUTOSAVE_INTERVAL_MS === undefined) {
+        env.AGENT_BROWSER_AUTOSAVE_INTERVAL_MS = '0';
+    }
     return env;
 }
 /**

package/dist/index.d.ts

@@ -11,6 +11,8 @@
  *
  * Environment variables:
  * - AGENT_BROWSER_SESSION_NAME: Session name for persistence (default: "mcp")
+ * - AGENT_BROWSER_AUTOSAVE_INTERVAL_MS: Periodic session autosave interval in ms (default: "0", off;
+ *   the session is still saved on close). Read when the agent-browser daemon starts.
  * - MCP_DISABLE_GRACEFUL_FS=1: Disable the graceful-fs EMFILE mitigation patch
  */
 import './installGracefulFs.js';

package/dist/index.js

@@ -11,6 +11,8 @@
  *
  * Environment variables:
  * - AGENT_BROWSER_SESSION_NAME: Session name for persistence (default: "mcp")
+ * - AGENT_BROWSER_AUTOSAVE_INTERVAL_MS: Periodic session autosave interval in ms (default: "0", off;
+ *   the session is still saved on close). Read when the agent-browser daemon starts.
  * - MCP_DISABLE_GRACEFUL_FS=1: Disable the graceful-fs EMFILE mitigation patch
  */
 // MUST be the very first import — installs the graceful-fs EMFILE mitigation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindstone/mcp-server-browser-automation",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "mcpName": "io.github.mindstone/mcp-server-browser-automation",
   "description": "Browser automation MCP server — visible-by-default browser control via accessibility snapshots, navigation, form filling, screenshots, and tab management. Set AGENT_BROWSER_SHOW_WINDOW=false to run quietly.",
   "license": "FSL-1.1-MIT",