iframer-cli 2.0.0 → 2.0.1

package/mcp-server.cjs

@@ -28429,7 +28429,22 @@ async function apiDelete(endpoint) {
 function err(message) {
   return { content: [{ type: "text", text: message }], isError: true };
 }
-var INSTRUCTIONS = `iframer — browser access for AI agents when normal methods fail.
+var IS_DEV = !!process.env.IFRAMER_URL;
+var INSTRUCTIONS = IS_DEV ? `iframer-dev — local development instance of iframer (connects to ${process.env.IFRAMER_URL}).
+
+This is the LOCAL dev server running in Docker on localhost. Use this MCP when developing or testing iframer itself.
+
+IMPORTANT: This connects to the local Docker container, NOT to api.iframer.sh. The browser session runs inside Docker with a virtual display (noVNC available at http://localhost:6080).
+
+WORKFLOW:
+1. Use "execute" with a pipeline of steps — the session starts automatically inside Docker
+2. iframer handles obstacles (captcha, cookie banners) automatically
+3. If execute fails, read the error — it tells you exactly what went wrong and where
+4. Call "session" action=stop when done to save session state
+
+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.` : `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.
 
@@ -28513,6 +28528,7 @@ var stepSchema = exports_external.discriminatedUnion("type", [
   exports_external.object({ type: exports_external.literal("click"), selector: exports_external.string() }),
   exports_external.object({ type: exports_external.literal("fill"), selector: exports_external.string(), value: exports_external.string() }),
   exports_external.object({ type: exports_external.literal("human-click"), selector: exports_external.string().optional(), x: exports_external.number().optional(), y: exports_external.number().optional() }),
+  exports_external.object({ type: exports_external.literal("right-click"), selector: exports_external.string().optional(), x: exports_external.number().optional(), y: exports_external.number().optional() }),
   exports_external.object({ type: exports_external.literal("human-type"), selector: exports_external.string(), value: exports_external.string() }),
   exports_external.object({ type: exports_external.literal("evaluate"), expression: exports_external.string() }),
   exports_external.object({ type: exports_external.literal("extract"), expression: exports_external.string() }),
@@ -28583,16 +28599,20 @@ Obstacles handled:`);
     if (data.error) {
       lines.push(`
 --- Failure ---`);
-      lines.push(`Failed at step ${data.error.failedAtStep}: ${JSON.stringify(data.error.failedStep)}`);
-      lines.push(`Error type: ${data.error.errorType}`);
-      lines.push(`Message: ${data.error.message}`);
-      lines.push(`Retryable: ${data.error.retryable}`);
-      if (data.error.suggestion)
-        lines.push(`Suggestion: ${data.error.suggestion}`);
-      if (data.error.pageState?.screenshotUrl)
-        lines.push(`Screenshot at failure: ${data.error.pageState.screenshotUrl}`);
-      if (data.error.pageState?.url)
-        lines.push(`URL at failure: ${data.error.pageState.url}`);
+      if (typeof data.error === "string") {
+        lines.push(`Error: ${data.error}`);
+      } else {
+        lines.push(`Failed at step ${data.error.failedAtStep}: ${JSON.stringify(data.error.failedStep)}`);
+        lines.push(`Error type: ${data.error.errorType}`);
+        lines.push(`Message: ${data.error.message}`);
+        lines.push(`Retryable: ${data.error.retryable}`);
+        if (data.error.suggestion)
+          lines.push(`Suggestion: ${data.error.suggestion}`);
+        if (data.error.pageState?.screenshotUrl)
+          lines.push(`Screenshot at failure: ${data.error.pageState.screenshotUrl}`);
+        if (data.error.pageState?.url)
+          lines.push(`URL at failure: ${data.error.pageState.url}`);
+      }
     }
     return { content: [{ type: "text", text: lines.join(`
 `) }] };

package/package.json

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