junis 0.2.0 → 0.2.2

package/dist/cli/index.js

@@ -31,7 +31,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "junis",
-      version: "0.2.0",
+      version: "0.2.2",
       description: "One-line device control for AI agents",
       bin: {
         junis: "dist/cli/index.js"
@@ -87,8 +87,12 @@ function loadConfig() {
   }
 }
 function saveConfig(config) {
-  import_fs.default.mkdirSync(CONFIG_DIR, { recursive: true });
-  import_fs.default.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
+  try {
+    import_fs.default.mkdirSync(CONFIG_DIR, { recursive: true });
+    import_fs.default.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
+  } catch (err) {
+    throw new Error(`\uC778\uC99D \uC815\uBCF4 \uC800\uC7A5 \uC2E4\uD328: ${err.message}`);
+  }
 }
 function clearConfig() {
   if (import_fs.default.existsSync(CONFIG_FILE)) {
@@ -276,6 +280,7 @@ var import_path2 = __toESM(require("path"));
 var import_glob = require("glob");
 var import_zod = require("zod");
 var execAsync = (0, import_util.promisify)(import_child_process.exec);
+var execFileAsync = (0, import_util.promisify)(import_child_process.execFile);
 var FilesystemTools = class {
   register(server) {
     server.tool(
@@ -360,8 +365,9 @@ ${error.stderr ?? ""}`
       },
       async ({ pattern, directory, file_pattern }) => {
         try {
-          const { stdout } = await execAsync(
-            `rg --no-heading -n "${pattern}" ${directory}`,
+          const { stdout } = await execFileAsync(
+            "rg",
+            ["--no-heading", "-n", pattern, directory],
             { timeout: 1e4 }
           );
           return { content: [{ type: "text", text: stdout || "\uACB0\uACFC \uC5C6\uC74C" }] };
@@ -498,6 +504,17 @@ var import_zod2 = require("zod");
 var BrowserTools = class {
   browser = null;
   page = null;
+  // 동시 요청 시 race condition 방지용 직렬화 락
+  lock = Promise.resolve();
+  withLock(fn) {
+    let release;
+    const next = new Promise((r) => {
+      release = r;
+    });
+    const current = this.lock;
+    this.lock = this.lock.then(() => next);
+    return current.then(() => fn()).finally(() => release());
+  }
   async init() {
     try {
       this.browser = await import_playwright.chromium.launch({ headless: true });
@@ -520,22 +537,22 @@ var BrowserTools = class {
       "browser_navigate",
       "URL\uB85C \uC774\uB3D9",
       { url: import_zod2.z.string().describe("\uC774\uB3D9\uD560 URL") },
-      async ({ url }) => {
+      ({ url }) => this.withLock(async () => {
         const page = requirePage();
         await page.goto(url, { waitUntil: "domcontentloaded" });
         return {
           content: [{ type: "text", text: `\uC774\uB3D9 \uC644\uB8CC: ${page.url()}` }]
         };
-      }
+      })
     );
     server.tool(
       "browser_click",
       "\uC694\uC18C \uD074\uB9AD",
       { selector: import_zod2.z.string().describe("CSS \uC120\uD0DD\uC790") },
-      async ({ selector }) => {
+      ({ selector }) => this.withLock(async () => {
         await requirePage().click(selector);
         return { content: [{ type: "text", text: "\uD074\uB9AD \uC644\uB8CC" }] };
-      }
+      })
     );
     server.tool(
       "browser_type",
@@ -545,12 +562,12 @@ var BrowserTools = class {
         text: import_zod2.z.string().describe("\uC785\uB825\uD560 \uD14D\uC2A4\uD2B8"),
         clear: import_zod2.z.boolean().optional().default(false).describe("\uAE30\uC874 \uB0B4\uC6A9 \uC0AD\uC81C \uD6C4 \uC785\uB825")
       },
-      async ({ selector, text, clear }) => {
+      ({ selector, text, clear }) => this.withLock(async () => {
         const page = requirePage();
         if (clear) await page.fill(selector, text);
         else await page.type(selector, text);
         return { content: [{ type: "text", text: "\uC785\uB825 \uC644\uB8CC" }] };
-      }
+      })
     );
     server.tool(
       "browser_screenshot",
@@ -559,7 +576,7 @@ var BrowserTools = class {
         path: import_zod2.z.string().optional().describe("\uC800\uC7A5 \uACBD\uB85C (\uC5C6\uC73C\uBA74 base64 \uBC18\uD658)"),
         full_page: import_zod2.z.boolean().optional().default(false)
       },
-      async ({ path: path3, full_page }) => {
+      ({ path: path3, full_page }) => this.withLock(async () => {
         const page = requirePage();
         const screenshot = await page.screenshot({
           path: path3 ?? void 0,
@@ -577,13 +594,13 @@ var BrowserTools = class {
             }
           ]
         };
-      }
+      })
     );
     server.tool(
       "browser_snapshot",
       "\uD398\uC774\uC9C0 \uC811\uADFC\uC131 \uD2B8\uB9AC \uC870\uD68C (\uAD6C\uC870 \uD30C\uC545\uC6A9)",
       {},
-      async () => {
+      () => this.withLock(async () => {
         const page = requirePage();
         const snapshot = await page.locator("body").ariaSnapshot();
         return {
@@ -591,29 +608,29 @@ var BrowserTools = class {
             { type: "text", text: snapshot }
           ]
         };
-      }
+      })
     );
     server.tool(
       "browser_evaluate",
       "JavaScript \uC2E4\uD589",
       { code: import_zod2.z.string().describe("\uC2E4\uD589\uD560 JavaScript \uCF54\uB4DC") },
-      async ({ code }) => {
+      ({ code }) => this.withLock(async () => {
         const result = await requirePage().evaluate(code);
         return {
           content: [
             { type: "text", text: JSON.stringify(result, null, 2) }
           ]
         };
-      }
+      })
     );
     server.tool(
       "browser_pdf",
       "\uD604\uC7AC \uD398\uC774\uC9C0 PDF \uC800\uC7A5",
       { path: import_zod2.z.string().describe("\uC800\uC7A5 \uACBD\uB85C (.pdf)") },
-      async ({ path: path3 }) => {
+      ({ path: path3 }) => this.withLock(async () => {
         await requirePage().pdf({ path: path3 });
         return { content: [{ type: "text", text: `PDF \uC800\uC7A5 \uC644\uB8CC: ${path3}` }] };
-      }
+      })
     );
   }
 };
@@ -626,7 +643,11 @@ var import_util2 = require("util");
 var execAsync2 = (0, import_util2.promisify)(import_child_process2.exec);
 async function readNotebook(filePath) {
   const raw = await import_promises2.default.readFile(filePath, "utf-8");
-  return JSON.parse(raw);
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new Error(`\uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 .ipynb \uD30C\uC77C: ${filePath}`);
+  }
 }
 async function writeNotebook(filePath, nb) {
   await import_promises2.default.writeFile(filePath, JSON.stringify(nb, null, 1), "utf-8");
@@ -725,8 +746,9 @@ var NotebookTools = class {
           nb.cells.push(newCell);
           actualIndex = nb.cells.length - 1;
         } else {
-          nb.cells.splice(position, 0, newCell);
-          actualIndex = position;
+          const clamped = Math.max(0, Math.min(position, nb.cells.length));
+          nb.cells.splice(clamped, 0, newCell);
+          actualIndex = clamped;
         }
         await writeNotebook(filePath, nb);
         return { content: [{ type: "text", text: `\uC140 \uCD94\uAC00 \uC644\uB8CC (index: ${actualIndex})` }] };
@@ -757,13 +779,13 @@ var import_child_process3 = require("child_process");
 var import_util3 = require("util");
 var import_zod4 = require("zod");
 var execAsync3 = (0, import_util3.promisify)(import_child_process3.exec);
+var screenRecordPid = null;
 function platform() {
   if (process.platform === "darwin") return "mac";
   if (process.platform === "win32") return "win";
   return "linux";
 }
 var DeviceTools = class {
-  screenRecordPid = null;
   register(server) {
     server.tool(
       "screen_capture",
@@ -773,15 +795,24 @@ var DeviceTools = class {
       },
       async ({ output_path }) => {
         const p = platform();
+        const isTmp = !output_path;
         const tmpPath = output_path ?? `/tmp/junis_screen_${Date.now()}.png`;
         const cmd = {
           mac: `screencapture -x "${tmpPath}"`,
           win: `nircmd.exe savescreenshot "${tmpPath}"`,
           linux: `scrot "${tmpPath}"`
         }[p];
-        await execAsync3(cmd);
-        const { readFileSync } = await import("fs");
+        try {
+          await execAsync3(cmd);
+        } catch (err) {
+          throw new Error(`\uD654\uBA74 \uCEA1\uCC98 \uC2E4\uD328: ${err.message}`);
+        }
+        const { readFileSync, unlinkSync } = await import("fs");
         const data = readFileSync(tmpPath).toString("base64");
+        if (isTmp) try {
+          unlinkSync(tmpPath);
+        } catch {
+        }
         return {
           content: [{ type: "image", data, mimeType: "image/png" }]
         };
@@ -795,15 +826,24 @@ var DeviceTools = class {
       },
       async ({ output_path }) => {
         const p = platform();
+        const isTmp = !output_path;
         const tmpPath = output_path ?? `/tmp/junis_cam_${Date.now()}.jpg`;
         const cmd = {
           mac: `imagesnap "${tmpPath}"`,
           win: `ffmpeg -f dshow -i video="Default" -frames:v 1 "${tmpPath}"`,
           linux: `fswebcam -r 1280x720 "${tmpPath}"`
         }[p];
-        await execAsync3(cmd);
-        const { readFileSync } = await import("fs");
+        try {
+          await execAsync3(cmd);
+        } catch (err) {
+          throw new Error(`\uCE74\uBA54\uB77C \uCD2C\uC601 \uC2E4\uD328: ${err.message}`);
+        }
+        const { readFileSync, unlinkSync } = await import("fs");
         const data = readFileSync(tmpPath).toString("base64");
+        if (isTmp) try {
+          unlinkSync(tmpPath);
+        } catch {
+        }
         return {
           content: [{ type: "image", data, mimeType: "image/jpeg" }]
         };
@@ -863,7 +903,7 @@ var DeviceTools = class {
       async ({ action, output_path }) => {
         const p = platform();
         if (action === "start") {
-          if (this.screenRecordPid) {
+          if (screenRecordPid) {
             return { content: [{ type: "text", text: "\uC774\uBBF8 \uB179\uD654 \uC911\uC785\uB2C8\uB2E4." }] };
           }
           const tmpPath = output_path ?? `/tmp/junis_record_${Date.now()}.mp4`;
@@ -871,17 +911,17 @@ var DeviceTools = class {
           const cmd = p === "mac" ? ["screencapture", ["-v", tmpPath]] : ["ffmpeg", ["-f", p === "win" ? "gdigrab" : "x11grab", "-i", p === "win" ? "desktop" : ":0.0", tmpPath]];
           const child = spawn(cmd[0], cmd[1], { detached: true, stdio: "ignore" });
           child.unref();
-          this.screenRecordPid = child.pid ?? null;
-          return { content: [{ type: "text", text: `\uB179\uD654 \uC2DC\uC791\uB428. \uC800\uC7A5 \uACBD\uB85C: ${tmpPath} (PID: ${this.screenRecordPid})` }] };
+          screenRecordPid = child.pid ?? null;
+          return { content: [{ type: "text", text: `\uB179\uD654 \uC2DC\uC791\uB428. \uC800\uC7A5 \uACBD\uB85C: ${tmpPath} (PID: ${screenRecordPid})` }] };
         } else {
-          if (!this.screenRecordPid) {
+          if (!screenRecordPid) {
             return { content: [{ type: "text", text: "\uD604\uC7AC \uB179\uD654 \uC911\uC774 \uC544\uB2D9\uB2C8\uB2E4." }] };
           }
           try {
-            process.kill(this.screenRecordPid, "SIGINT");
+            process.kill(screenRecordPid, "SIGINT");
           } catch {
           }
-          this.screenRecordPid = null;
+          screenRecordPid = null;
           return { content: [{ type: "text", text: "\uB179\uD654 \uC911\uC9C0\uB428." }] };
         }
       }
@@ -900,12 +940,15 @@ var DeviceTools = class {
           } catch {
           }
         }
-        const res = await fetch("https://ipapi.co/json/");
+        const res = await fetch("http://ip-api.com/json/");
         const data = await res.json();
+        if (data.status !== "success") {
+          throw new Error(`IP \uC704\uCE58 \uC870\uD68C \uC2E4\uD328: ${data.message ?? data.status}`);
+        }
         return {
           content: [{
             type: "text",
-            text: `\uC704\uB3C4: ${data.latitude}, \uACBD\uB3C4: ${data.longitude}, \uB3C4\uC2DC: ${data.city}, \uAD6D\uAC00: ${data.country_name} (IP \uAE30\uBC18 \uCD94\uC815)`
+            text: `\uC704\uB3C4: ${data.lat}, \uACBD\uB3C4: ${data.lon}, \uB3C4\uC2DC: ${data.city}, \uAD6D\uAC00: ${data.country} (IP \uAE30\uBC18 \uCD94\uC815)`
           }]
         };
       }

package/dist/server/mcp.js

@@ -46,6 +46,7 @@ var import_path = __toESM(require("path"));
 var import_glob = require("glob");
 var import_zod = require("zod");
 var execAsync = (0, import_util.promisify)(import_child_process.exec);
+var execFileAsync = (0, import_util.promisify)(import_child_process.execFile);
 var FilesystemTools = class {
   register(server) {
     server.tool(
@@ -130,8 +131,9 @@ ${error.stderr ?? ""}`
       },
       async ({ pattern, directory, file_pattern }) => {
         try {
-          const { stdout } = await execAsync(
-            `rg --no-heading -n "${pattern}" ${directory}`,
+          const { stdout } = await execFileAsync(
+            "rg",
+            ["--no-heading", "-n", pattern, directory],
             { timeout: 1e4 }
           );
           return { content: [{ type: "text", text: stdout || "\uACB0\uACFC \uC5C6\uC74C" }] };
@@ -268,6 +270,17 @@ var import_zod2 = require("zod");
 var BrowserTools = class {
   browser = null;
   page = null;
+  // 동시 요청 시 race condition 방지용 직렬화 락
+  lock = Promise.resolve();
+  withLock(fn) {
+    let release;
+    const next = new Promise((r) => {
+      release = r;
+    });
+    const current = this.lock;
+    this.lock = this.lock.then(() => next);
+    return current.then(() => fn()).finally(() => release());
+  }
   async init() {
     try {
       this.browser = await import_playwright.chromium.launch({ headless: true });
@@ -290,22 +303,22 @@ var BrowserTools = class {
       "browser_navigate",
       "URL\uB85C \uC774\uB3D9",
       { url: import_zod2.z.string().describe("\uC774\uB3D9\uD560 URL") },
-      async ({ url }) => {
+      ({ url }) => this.withLock(async () => {
         const page = requirePage();
         await page.goto(url, { waitUntil: "domcontentloaded" });
         return {
           content: [{ type: "text", text: `\uC774\uB3D9 \uC644\uB8CC: ${page.url()}` }]
         };
-      }
+      })
     );
     server.tool(
       "browser_click",
       "\uC694\uC18C \uD074\uB9AD",
       { selector: import_zod2.z.string().describe("CSS \uC120\uD0DD\uC790") },
-      async ({ selector }) => {
+      ({ selector }) => this.withLock(async () => {
         await requirePage().click(selector);
         return { content: [{ type: "text", text: "\uD074\uB9AD \uC644\uB8CC" }] };
-      }
+      })
     );
     server.tool(
       "browser_type",
@@ -315,12 +328,12 @@ var BrowserTools = class {
         text: import_zod2.z.string().describe("\uC785\uB825\uD560 \uD14D\uC2A4\uD2B8"),
         clear: import_zod2.z.boolean().optional().default(false).describe("\uAE30\uC874 \uB0B4\uC6A9 \uC0AD\uC81C \uD6C4 \uC785\uB825")
       },
-      async ({ selector, text, clear }) => {
+      ({ selector, text, clear }) => this.withLock(async () => {
         const page = requirePage();
         if (clear) await page.fill(selector, text);
         else await page.type(selector, text);
         return { content: [{ type: "text", text: "\uC785\uB825 \uC644\uB8CC" }] };
-      }
+      })
     );
     server.tool(
       "browser_screenshot",
@@ -329,7 +342,7 @@ var BrowserTools = class {
         path: import_zod2.z.string().optional().describe("\uC800\uC7A5 \uACBD\uB85C (\uC5C6\uC73C\uBA74 base64 \uBC18\uD658)"),
         full_page: import_zod2.z.boolean().optional().default(false)
       },
-      async ({ path: path2, full_page }) => {
+      ({ path: path2, full_page }) => this.withLock(async () => {
         const page = requirePage();
         const screenshot = await page.screenshot({
           path: path2 ?? void 0,
@@ -347,13 +360,13 @@ var BrowserTools = class {
             }
           ]
         };
-      }
+      })
     );
     server.tool(
       "browser_snapshot",
       "\uD398\uC774\uC9C0 \uC811\uADFC\uC131 \uD2B8\uB9AC \uC870\uD68C (\uAD6C\uC870 \uD30C\uC545\uC6A9)",
       {},
-      async () => {
+      () => this.withLock(async () => {
         const page = requirePage();
         const snapshot = await page.locator("body").ariaSnapshot();
         return {
@@ -361,29 +374,29 @@ var BrowserTools = class {
             { type: "text", text: snapshot }
           ]
         };
-      }
+      })
     );
     server.tool(
       "browser_evaluate",
       "JavaScript \uC2E4\uD589",
       { code: import_zod2.z.string().describe("\uC2E4\uD589\uD560 JavaScript \uCF54\uB4DC") },
-      async ({ code }) => {
+      ({ code }) => this.withLock(async () => {
         const result = await requirePage().evaluate(code);
         return {
           content: [
             { type: "text", text: JSON.stringify(result, null, 2) }
           ]
         };
-      }
+      })
     );
     server.tool(
       "browser_pdf",
       "\uD604\uC7AC \uD398\uC774\uC9C0 PDF \uC800\uC7A5",
       { path: import_zod2.z.string().describe("\uC800\uC7A5 \uACBD\uB85C (.pdf)") },
-      async ({ path: path2 }) => {
+      ({ path: path2 }) => this.withLock(async () => {
         await requirePage().pdf({ path: path2 });
         return { content: [{ type: "text", text: `PDF \uC800\uC7A5 \uC644\uB8CC: ${path2}` }] };
-      }
+      })
     );
   }
 };
@@ -396,7 +409,11 @@ var import_util2 = require("util");
 var execAsync2 = (0, import_util2.promisify)(import_child_process2.exec);
 async function readNotebook(filePath) {
   const raw = await import_promises2.default.readFile(filePath, "utf-8");
-  return JSON.parse(raw);
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new Error(`\uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 .ipynb \uD30C\uC77C: ${filePath}`);
+  }
 }
 async function writeNotebook(filePath, nb) {
   await import_promises2.default.writeFile(filePath, JSON.stringify(nb, null, 1), "utf-8");
@@ -495,8 +512,9 @@ var NotebookTools = class {
           nb.cells.push(newCell);
           actualIndex = nb.cells.length - 1;
         } else {
-          nb.cells.splice(position, 0, newCell);
-          actualIndex = position;
+          const clamped = Math.max(0, Math.min(position, nb.cells.length));
+          nb.cells.splice(clamped, 0, newCell);
+          actualIndex = clamped;
         }
         await writeNotebook(filePath, nb);
         return { content: [{ type: "text", text: `\uC140 \uCD94\uAC00 \uC644\uB8CC (index: ${actualIndex})` }] };
@@ -527,13 +545,13 @@ var import_child_process3 = require("child_process");
 var import_util3 = require("util");
 var import_zod4 = require("zod");
 var execAsync3 = (0, import_util3.promisify)(import_child_process3.exec);
+var screenRecordPid = null;
 function platform() {
   if (process.platform === "darwin") return "mac";
   if (process.platform === "win32") return "win";
   return "linux";
 }
 var DeviceTools = class {
-  screenRecordPid = null;
   register(server) {
     server.tool(
       "screen_capture",
@@ -543,15 +561,24 @@ var DeviceTools = class {
       },
       async ({ output_path }) => {
         const p = platform();
+        const isTmp = !output_path;
         const tmpPath = output_path ?? `/tmp/junis_screen_${Date.now()}.png`;
         const cmd = {
           mac: `screencapture -x "${tmpPath}"`,
           win: `nircmd.exe savescreenshot "${tmpPath}"`,
           linux: `scrot "${tmpPath}"`
         }[p];
-        await execAsync3(cmd);
-        const { readFileSync } = await import("fs");
+        try {
+          await execAsync3(cmd);
+        } catch (err) {
+          throw new Error(`\uD654\uBA74 \uCEA1\uCC98 \uC2E4\uD328: ${err.message}`);
+        }
+        const { readFileSync, unlinkSync } = await import("fs");
         const data = readFileSync(tmpPath).toString("base64");
+        if (isTmp) try {
+          unlinkSync(tmpPath);
+        } catch {
+        }
         return {
           content: [{ type: "image", data, mimeType: "image/png" }]
         };
@@ -565,15 +592,24 @@ var DeviceTools = class {
       },
       async ({ output_path }) => {
         const p = platform();
+        const isTmp = !output_path;
         const tmpPath = output_path ?? `/tmp/junis_cam_${Date.now()}.jpg`;
         const cmd = {
           mac: `imagesnap "${tmpPath}"`,
           win: `ffmpeg -f dshow -i video="Default" -frames:v 1 "${tmpPath}"`,
           linux: `fswebcam -r 1280x720 "${tmpPath}"`
         }[p];
-        await execAsync3(cmd);
-        const { readFileSync } = await import("fs");
+        try {
+          await execAsync3(cmd);
+        } catch (err) {
+          throw new Error(`\uCE74\uBA54\uB77C \uCD2C\uC601 \uC2E4\uD328: ${err.message}`);
+        }
+        const { readFileSync, unlinkSync } = await import("fs");
         const data = readFileSync(tmpPath).toString("base64");
+        if (isTmp) try {
+          unlinkSync(tmpPath);
+        } catch {
+        }
         return {
           content: [{ type: "image", data, mimeType: "image/jpeg" }]
         };
@@ -633,7 +669,7 @@ var DeviceTools = class {
       async ({ action, output_path }) => {
         const p = platform();
         if (action === "start") {
-          if (this.screenRecordPid) {
+          if (screenRecordPid) {
             return { content: [{ type: "text", text: "\uC774\uBBF8 \uB179\uD654 \uC911\uC785\uB2C8\uB2E4." }] };
           }
           const tmpPath = output_path ?? `/tmp/junis_record_${Date.now()}.mp4`;
@@ -641,17 +677,17 @@ var DeviceTools = class {
           const cmd = p === "mac" ? ["screencapture", ["-v", tmpPath]] : ["ffmpeg", ["-f", p === "win" ? "gdigrab" : "x11grab", "-i", p === "win" ? "desktop" : ":0.0", tmpPath]];
           const child = spawn(cmd[0], cmd[1], { detached: true, stdio: "ignore" });
           child.unref();
-          this.screenRecordPid = child.pid ?? null;
-          return { content: [{ type: "text", text: `\uB179\uD654 \uC2DC\uC791\uB428. \uC800\uC7A5 \uACBD\uB85C: ${tmpPath} (PID: ${this.screenRecordPid})` }] };
+          screenRecordPid = child.pid ?? null;
+          return { content: [{ type: "text", text: `\uB179\uD654 \uC2DC\uC791\uB428. \uC800\uC7A5 \uACBD\uB85C: ${tmpPath} (PID: ${screenRecordPid})` }] };
         } else {
-          if (!this.screenRecordPid) {
+          if (!screenRecordPid) {
             return { content: [{ type: "text", text: "\uD604\uC7AC \uB179\uD654 \uC911\uC774 \uC544\uB2D9\uB2C8\uB2E4." }] };
           }
           try {
-            process.kill(this.screenRecordPid, "SIGINT");
+            process.kill(screenRecordPid, "SIGINT");
           } catch {
           }
-          this.screenRecordPid = null;
+          screenRecordPid = null;
           return { content: [{ type: "text", text: "\uB179\uD654 \uC911\uC9C0\uB428." }] };
         }
       }
@@ -670,12 +706,15 @@ var DeviceTools = class {
           } catch {
           }
         }
-        const res = await fetch("https://ipapi.co/json/");
+        const res = await fetch("http://ip-api.com/json/");
         const data = await res.json();
+        if (data.status !== "success") {
+          throw new Error(`IP \uC704\uCE58 \uC870\uD68C \uC2E4\uD328: ${data.message ?? data.status}`);
+        }
         return {
           content: [{
             type: "text",
-            text: `\uC704\uB3C4: ${data.latitude}, \uACBD\uB3C4: ${data.longitude}, \uB3C4\uC2DC: ${data.city}, \uAD6D\uAC00: ${data.country_name} (IP \uAE30\uBC18 \uCD94\uC815)`
+            text: `\uC704\uB3C4: ${data.lat}, \uACBD\uB3C4: ${data.lon}, \uB3C4\uC2DC: ${data.city}, \uAD6D\uAC00: ${data.country} (IP \uAE30\uBC18 \uCD94\uC815)`
           }]
         };
       }

package/dist/server/stdio.js

@@ -35,6 +35,7 @@ var import_path = __toESM(require("path"));
 var import_glob = require("glob");
 var import_zod = require("zod");
 var execAsync = (0, import_util.promisify)(import_child_process.exec);
+var execFileAsync = (0, import_util.promisify)(import_child_process.execFile);
 var FilesystemTools = class {
   register(server) {
     server.tool(
@@ -119,8 +120,9 @@ ${error.stderr ?? ""}`
       },
       async ({ pattern, directory, file_pattern }) => {
         try {
-          const { stdout } = await execAsync(
-            `rg --no-heading -n "${pattern}" ${directory}`,
+          const { stdout } = await execFileAsync(
+            "rg",
+            ["--no-heading", "-n", pattern, directory],
             { timeout: 1e4 }
           );
           return { content: [{ type: "text", text: stdout || "\uACB0\uACFC \uC5C6\uC74C" }] };
@@ -257,6 +259,17 @@ var import_zod2 = require("zod");
 var BrowserTools = class {
   browser = null;
   page = null;
+  // 동시 요청 시 race condition 방지용 직렬화 락
+  lock = Promise.resolve();
+  withLock(fn) {
+    let release;
+    const next = new Promise((r) => {
+      release = r;
+    });
+    const current = this.lock;
+    this.lock = this.lock.then(() => next);
+    return current.then(() => fn()).finally(() => release());
+  }
   async init() {
     try {
       this.browser = await import_playwright.chromium.launch({ headless: true });
@@ -279,22 +292,22 @@ var BrowserTools = class {
       "browser_navigate",
       "URL\uB85C \uC774\uB3D9",
       { url: import_zod2.z.string().describe("\uC774\uB3D9\uD560 URL") },
-      async ({ url }) => {
+      ({ url }) => this.withLock(async () => {
         const page = requirePage();
         await page.goto(url, { waitUntil: "domcontentloaded" });
         return {
           content: [{ type: "text", text: `\uC774\uB3D9 \uC644\uB8CC: ${page.url()}` }]
         };
-      }
+      })
     );
     server.tool(
       "browser_click",
       "\uC694\uC18C \uD074\uB9AD",
       { selector: import_zod2.z.string().describe("CSS \uC120\uD0DD\uC790") },
-      async ({ selector }) => {
+      ({ selector }) => this.withLock(async () => {
         await requirePage().click(selector);
         return { content: [{ type: "text", text: "\uD074\uB9AD \uC644\uB8CC" }] };
-      }
+      })
     );
     server.tool(
       "browser_type",
@@ -304,12 +317,12 @@ var BrowserTools = class {
         text: import_zod2.z.string().describe("\uC785\uB825\uD560 \uD14D\uC2A4\uD2B8"),
         clear: import_zod2.z.boolean().optional().default(false).describe("\uAE30\uC874 \uB0B4\uC6A9 \uC0AD\uC81C \uD6C4 \uC785\uB825")
       },
-      async ({ selector, text, clear }) => {
+      ({ selector, text, clear }) => this.withLock(async () => {
         const page = requirePage();
         if (clear) await page.fill(selector, text);
         else await page.type(selector, text);
         return { content: [{ type: "text", text: "\uC785\uB825 \uC644\uB8CC" }] };
-      }
+      })
     );
     server.tool(
       "browser_screenshot",
@@ -318,7 +331,7 @@ var BrowserTools = class {
         path: import_zod2.z.string().optional().describe("\uC800\uC7A5 \uACBD\uB85C (\uC5C6\uC73C\uBA74 base64 \uBC18\uD658)"),
         full_page: import_zod2.z.boolean().optional().default(false)
       },
-      async ({ path: path2, full_page }) => {
+      ({ path: path2, full_page }) => this.withLock(async () => {
         const page = requirePage();
         const screenshot = await page.screenshot({
           path: path2 ?? void 0,
@@ -336,13 +349,13 @@ var BrowserTools = class {
             }
           ]
         };
-      }
+      })
     );
     server.tool(
       "browser_snapshot",
       "\uD398\uC774\uC9C0 \uC811\uADFC\uC131 \uD2B8\uB9AC \uC870\uD68C (\uAD6C\uC870 \uD30C\uC545\uC6A9)",
       {},
-      async () => {
+      () => this.withLock(async () => {
         const page = requirePage();
         const snapshot = await page.locator("body").ariaSnapshot();
         return {
@@ -350,29 +363,29 @@ var BrowserTools = class {
             { type: "text", text: snapshot }
           ]
         };
-      }
+      })
     );
     server.tool(
       "browser_evaluate",
       "JavaScript \uC2E4\uD589",
       { code: import_zod2.z.string().describe("\uC2E4\uD589\uD560 JavaScript \uCF54\uB4DC") },
-      async ({ code }) => {
+      ({ code }) => this.withLock(async () => {
         const result = await requirePage().evaluate(code);
         return {
           content: [
             { type: "text", text: JSON.stringify(result, null, 2) }
           ]
         };
-      }
+      })
     );
     server.tool(
       "browser_pdf",
       "\uD604\uC7AC \uD398\uC774\uC9C0 PDF \uC800\uC7A5",
       { path: import_zod2.z.string().describe("\uC800\uC7A5 \uACBD\uB85C (.pdf)") },
-      async ({ path: path2 }) => {
+      ({ path: path2 }) => this.withLock(async () => {
         await requirePage().pdf({ path: path2 });
         return { content: [{ type: "text", text: `PDF \uC800\uC7A5 \uC644\uB8CC: ${path2}` }] };
-      }
+      })
     );
   }
 };
@@ -385,7 +398,11 @@ var import_util2 = require("util");
 var execAsync2 = (0, import_util2.promisify)(import_child_process2.exec);
 async function readNotebook(filePath) {
   const raw = await import_promises2.default.readFile(filePath, "utf-8");
-  return JSON.parse(raw);
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new Error(`\uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 .ipynb \uD30C\uC77C: ${filePath}`);
+  }
 }
 async function writeNotebook(filePath, nb) {
   await import_promises2.default.writeFile(filePath, JSON.stringify(nb, null, 1), "utf-8");
@@ -484,8 +501,9 @@ var NotebookTools = class {
           nb.cells.push(newCell);
           actualIndex = nb.cells.length - 1;
         } else {
-          nb.cells.splice(position, 0, newCell);
-          actualIndex = position;
+          const clamped = Math.max(0, Math.min(position, nb.cells.length));
+          nb.cells.splice(clamped, 0, newCell);
+          actualIndex = clamped;
         }
         await writeNotebook(filePath, nb);
         return { content: [{ type: "text", text: `\uC140 \uCD94\uAC00 \uC644\uB8CC (index: ${actualIndex})` }] };
@@ -516,13 +534,13 @@ var import_child_process3 = require("child_process");
 var import_util3 = require("util");
 var import_zod4 = require("zod");
 var execAsync3 = (0, import_util3.promisify)(import_child_process3.exec);
+var screenRecordPid = null;
 function platform() {
   if (process.platform === "darwin") return "mac";
   if (process.platform === "win32") return "win";
   return "linux";
 }
 var DeviceTools = class {
-  screenRecordPid = null;
   register(server) {
     server.tool(
       "screen_capture",
@@ -532,15 +550,24 @@ var DeviceTools = class {
       },
       async ({ output_path }) => {
         const p = platform();
+        const isTmp = !output_path;
         const tmpPath = output_path ?? `/tmp/junis_screen_${Date.now()}.png`;
         const cmd = {
           mac: `screencapture -x "${tmpPath}"`,
           win: `nircmd.exe savescreenshot "${tmpPath}"`,
           linux: `scrot "${tmpPath}"`
         }[p];
-        await execAsync3(cmd);
-        const { readFileSync } = await import("fs");
+        try {
+          await execAsync3(cmd);
+        } catch (err) {
+          throw new Error(`\uD654\uBA74 \uCEA1\uCC98 \uC2E4\uD328: ${err.message}`);
+        }
+        const { readFileSync, unlinkSync } = await import("fs");
         const data = readFileSync(tmpPath).toString("base64");
+        if (isTmp) try {
+          unlinkSync(tmpPath);
+        } catch {
+        }
         return {
           content: [{ type: "image", data, mimeType: "image/png" }]
         };
@@ -554,15 +581,24 @@ var DeviceTools = class {
       },
       async ({ output_path }) => {
         const p = platform();
+        const isTmp = !output_path;
         const tmpPath = output_path ?? `/tmp/junis_cam_${Date.now()}.jpg`;
         const cmd = {
           mac: `imagesnap "${tmpPath}"`,
           win: `ffmpeg -f dshow -i video="Default" -frames:v 1 "${tmpPath}"`,
           linux: `fswebcam -r 1280x720 "${tmpPath}"`
         }[p];
-        await execAsync3(cmd);
-        const { readFileSync } = await import("fs");
+        try {
+          await execAsync3(cmd);
+        } catch (err) {
+          throw new Error(`\uCE74\uBA54\uB77C \uCD2C\uC601 \uC2E4\uD328: ${err.message}`);
+        }
+        const { readFileSync, unlinkSync } = await import("fs");
         const data = readFileSync(tmpPath).toString("base64");
+        if (isTmp) try {
+          unlinkSync(tmpPath);
+        } catch {
+        }
         return {
           content: [{ type: "image", data, mimeType: "image/jpeg" }]
         };
@@ -622,7 +658,7 @@ var DeviceTools = class {
       async ({ action, output_path }) => {
         const p = platform();
         if (action === "start") {
-          if (this.screenRecordPid) {
+          if (screenRecordPid) {
             return { content: [{ type: "text", text: "\uC774\uBBF8 \uB179\uD654 \uC911\uC785\uB2C8\uB2E4." }] };
           }
           const tmpPath = output_path ?? `/tmp/junis_record_${Date.now()}.mp4`;
@@ -630,17 +666,17 @@ var DeviceTools = class {
           const cmd = p === "mac" ? ["screencapture", ["-v", tmpPath]] : ["ffmpeg", ["-f", p === "win" ? "gdigrab" : "x11grab", "-i", p === "win" ? "desktop" : ":0.0", tmpPath]];
           const child = spawn(cmd[0], cmd[1], { detached: true, stdio: "ignore" });
           child.unref();
-          this.screenRecordPid = child.pid ?? null;
-          return { content: [{ type: "text", text: `\uB179\uD654 \uC2DC\uC791\uB428. \uC800\uC7A5 \uACBD\uB85C: ${tmpPath} (PID: ${this.screenRecordPid})` }] };
+          screenRecordPid = child.pid ?? null;
+          return { content: [{ type: "text", text: `\uB179\uD654 \uC2DC\uC791\uB428. \uC800\uC7A5 \uACBD\uB85C: ${tmpPath} (PID: ${screenRecordPid})` }] };
         } else {
-          if (!this.screenRecordPid) {
+          if (!screenRecordPid) {
             return { content: [{ type: "text", text: "\uD604\uC7AC \uB179\uD654 \uC911\uC774 \uC544\uB2D9\uB2C8\uB2E4." }] };
           }
           try {
-            process.kill(this.screenRecordPid, "SIGINT");
+            process.kill(screenRecordPid, "SIGINT");
           } catch {
           }
-          this.screenRecordPid = null;
+          screenRecordPid = null;
           return { content: [{ type: "text", text: "\uB179\uD654 \uC911\uC9C0\uB428." }] };
         }
       }
@@ -659,12 +695,15 @@ var DeviceTools = class {
           } catch {
           }
         }
-        const res = await fetch("https://ipapi.co/json/");
+        const res = await fetch("http://ip-api.com/json/");
         const data = await res.json();
+        if (data.status !== "success") {
+          throw new Error(`IP \uC704\uCE58 \uC870\uD68C \uC2E4\uD328: ${data.message ?? data.status}`);
+        }
         return {
           content: [{
             type: "text",
-            text: `\uC704\uB3C4: ${data.latitude}, \uACBD\uB3C4: ${data.longitude}, \uB3C4\uC2DC: ${data.city}, \uAD6D\uAC00: ${data.country_name} (IP \uAE30\uBC18 \uCD94\uC815)`
+            text: `\uC704\uB3C4: ${data.lat}, \uACBD\uB3C4: ${data.lon}, \uB3C4\uC2DC: ${data.city}, \uAD6D\uAC00: ${data.country} (IP \uAE30\uBC18 \uCD94\uC815)`
           }]
         };
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "junis",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "One-line device control for AI agents",
   "bin": {
     "junis": "dist/cli/index.js"