iframer-cli 2.1.0 → 2.1.2

package/cli.js

@@ -516,6 +516,44 @@ async function main() {
 
     // ─── Install MCP ──────────────────────────────────────────────
 
+    case "proxy": {
+      const action = args[0];
+      if (!action || !["start", "stop", "status"].includes(action)) {
+        console.log("  Usage: iframer proxy <start|stop|status> [proxy-url]");
+        console.log("  Note:  'start' requires a proxy URL (e.g. socks5://host:port).");
+        console.log("         To use your home IP automatically, use the iframer MCP tool instead.");
+        break;
+      }
+      if (action === "status") {
+        const res = await fetch(`${getServer()}/proxy`);
+        const data = await res.json();
+        console.log(JSON.stringify(data, null, 2));
+      } else if (action === "stop") {
+        const res = await fetch(`${getServer()}/proxy`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ server: null }),
+        });
+        const data = await res.json();
+        console.log(JSON.stringify(data, null, 2));
+      } else if (action === "start") {
+        const proxyUrl = args[1];
+        if (!proxyUrl) {
+          console.error("  Error: 'proxy start' requires a proxy URL, e.g.: iframer proxy start socks5://host:port");
+          console.error("  To route through your home IP automatically, use the iframer MCP tool.");
+          process.exit(1);
+        }
+        const res = await fetch(`${getServer()}/proxy`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ server: proxyUrl }),
+        });
+        const data = await res.json();
+        console.log(JSON.stringify(data, null, 2));
+      }
+      break;
+    }
+
     case "install-mcp": {
       const mcpServerPath = path.join(__dirname, "mcp-server.cjs");
       if (!fs.existsSync(mcpServerPath)) {
@@ -553,6 +591,7 @@ async function main() {
     logout                         Remove saved credentials
     status                         Show current auth status
     install-mcp                    Install the iframer MCP into Claude Code
+    proxy <start|stop|status>      Control the home proxy (routes browser through your IP)
 
   Credentials:
     credentials add <domain>       Store login credentials (encrypted, server-side)

package/mcp-server.cjs

@@ -28541,9 +28541,10 @@ async function startTunnel(apiBaseUrl, authToken) {
       } catch {}
     };
     ws.onerror = (err) => fail(`WebSocket error: ${err?.message ?? "unknown"}`);
-    ws.onclose = () => {
+    ws.onclose = (event) => {
       sockets.forEach((s) => s.destroy());
       sockets.clear();
+      fail(`Tunnel closed by server (code=${event?.code ?? "?"}, reason=${event?.reason ?? "unknown"})`);
     };
     setTimeout(() => fail("Tunnel setup timed out (10s)"), 1e4);
   });
@@ -28605,9 +28606,9 @@ WORKFLOW:
 
 TIMEOUTS: Each step has a 20-second stale-state timeout. If nothing changes for 20s, iframer aborts with a detailed error.
 
-CREDENTIALS: Use "credentials" action=store to save login details encrypted server-side.
+CREDENTIALS: NEVER ask the user for passwords or credentials in the chat. Always use "credentials" action=store — it opens a secure prompt so the user types credentials directly into the terminal. You never see them. Then use a login step in "execute".
 
-HOME PROXY: If the site is showing captchas or bot detection, use "proxy action=start" to route the browser through the user's own home network IP. This runs a SOCKS5 proxy on the user's Mac so all browser traffic exits from their real IP address. Use "proxy action=stop" to go back to the default proxy. Always try this before attempting to solve captchas manually.` : `iframer — browser access for AI agents when normal methods fail.
+BOT DETECTION / CAPTCHA RULE: If a captcha appears, try solve-captcha first. If it fails or keeps reappearing, immediately call "proxy action=start" — do NOT ask the user to solve it manually. The proxy restarts the session automatically; then retry the full flow from scratch. Only report failure if the captcha persists after the proxy is active.` : `iframer — browser access for AI agents when normal methods fail.
 
 PHILOSOPHY: You are a capable agent. Do your work locally first. Only call iframer when you hit a wall: captcha, login-gated content, heavy bot detection, or content that requires a real browser to render. iframer is a swiss knife you pull out for hard problems, not your default browsing tool.
 
@@ -28627,9 +28628,9 @@ WORKFLOW:
 
 TIMEOUTS: Each step has a 20-second stale-state timeout. If nothing changes on the page for 20s, iframer aborts and returns a detailed error. Retry, adjust your approach, or tell the user why it failed.
 
-CREDENTIALS: Use "credentials" action=store to prompt the user for login details. They're encrypted server-side — you never see them. Then use a login step in "execute".
+CREDENTIALS: NEVER ask the user for passwords or credentials in the chat. Always use "credentials" action=store — it opens a secure prompt so the user types credentials directly into the terminal. You never see them. Then use a login step in "execute".
 
-HOME PROXY: If the site is showing captchas or bot detection, use "proxy action=start" to route the browser through the user's own home network IP. This runs a SOCKS5 proxy on the user's Mac so all browser traffic exits from their real IP address. Use "proxy action=stop" to go back to the default proxy. Always try this before attempting to solve captchas manually.`;
+BOT DETECTION / CAPTCHA RULE: If a captcha appears, try solve-captcha first. If it fails or keeps reappearing, immediately call "proxy action=start" — do NOT ask the user to solve it manually. The proxy restarts the session automatically; then retry the full flow from scratch. Only report failure if the captcha persists after the proxy is active.`;
 var server = new McpServer({ name: "iframer", version: "2.0.0" }, { instructions: INSTRUCTIONS });
 server.tool("status", `Get the full state of iframer in one call. Call this first. Returns: API health, auth status, active session, stored credentials.`, {}, async () => {
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iframer-cli",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "CLI for iframer — browser access for AI agents",
   "bin": {
     "iframer": "./cli.js"