junis 0.2.0 → 0.2.3

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.3",
       description: "One-line device control for AI agents",
       bin: {
         junis: "dist/cli/index.js"
@@ -87,8 +87,15 @@ 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) {
+    console.error(`
+\u274C \uC124\uC815 \uD30C\uC77C \uC800\uC7A5 \uC2E4\uD328: ${err.message}`);
+    console.error(`   \uC218\uB3D9\uC73C\uB85C ${CONFIG_FILE} \uC5D0 \uC800\uC7A5\uD574\uC8FC\uC138\uC694.`);
+    console.error(`   \uB0B4\uC6A9: ${JSON.stringify(config, null, 2)}`);
+  }
 }
 function clearConfig() {
   if (import_fs.default.existsSync(CONFIG_FILE)) {
@@ -113,11 +120,19 @@ var JUNIS_WEB = (() => {
   return null;
 })();
 async function authenticate(deviceName, platform2, onBrowserOpen, onWaiting) {
-  const startRes = await fetch(`${JUNIS_API}/api/auth/device/start`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ device_name: deviceName, platform: platform2 })
-  });
+  let startRes;
+  try {
+    startRes = await fetch(`${JUNIS_API}/api/auth/device/start`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ device_name: deviceName, platform: platform2 })
+    });
+  } catch (err) {
+    throw new Error(
+      `\uC11C\uBC84\uC5D0 \uC5F0\uACB0\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uC778\uD130\uB137 \uC5F0\uACB0\uC744 \uD655\uC778\uD558\uAC70\uB098 \uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574\uC8FC\uC138\uC694.
+(${err.message})`
+    );
+  }
   if (!startRes.ok) {
     const body = await startRes.text().catch(() => "");
     throw new Error(`Auth \uC2DC\uC791 \uC2E4\uD328: ${startRes.status} ${body}`);
@@ -125,15 +140,29 @@ async function authenticate(deviceName, platform2, onBrowserOpen, onWaiting) {
   const startData = await startRes.json();
   const verificationUri = JUNIS_WEB ? startData.verification_uri.replace(/^https?:\/\/[^/]+/, JUNIS_WEB) : startData.verification_uri;
   onBrowserOpen?.(verificationUri);
-  await (0, import_open.default)(verificationUri);
+  try {
+    await (0, import_open.default)(verificationUri);
+  } catch {
+    console.warn(`
+\u26A0\uFE0F  \uBE0C\uB77C\uC6B0\uC800\uB97C \uC790\uB3D9\uC73C\uB85C \uC5F4 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uC544\uB798 URL\uC744 \uC9C1\uC811 \uC5F4\uC5B4\uC8FC\uC138\uC694:
+
+  ${verificationUri}
+`);
+  }
   const deadline = Date.now() + startData.expires_in * 1e3;
   const intervalMs = startData.interval * 1e3;
   let waitingCallbackCalled = false;
   while (Date.now() < deadline) {
     await sleep(intervalMs);
-    const pollRes = await fetch(
-      `${JUNIS_API}/api/auth/device/poll?code=${startData.device_code}`
-    );
+    let pollRes;
+    try {
+      pollRes = await fetch(
+        `${JUNIS_API}/api/auth/device/poll?code=${startData.device_code}`
+      );
+    } catch {
+      onWaiting?.();
+      continue;
+    }
     if (pollRes.status === 202) {
       if (!waitingCallbackCalled) {
         waitingCallbackCalled = true;
@@ -184,15 +213,18 @@ var RelayClient = class {
     if (this.destroyed) return;
     const url = `${JUNIS_WS}/ws/devices/${this.config.device_key}`;
     console.log(`\u{1F517} \uB9B4\uB808\uC774 \uC11C\uBC84 \uC5F0\uACB0 \uC911...`);
-    this.ws = new import_ws.default(url, {
+    const ws = new import_ws.default(url, {
       headers: { Authorization: `Bearer ${this.config.token}` }
     });
-    this.ws.on("open", () => {
+    this.ws = ws;
+    ws.on("open", () => {
+      if (this.ws !== ws) return;
       console.log("\u2705 \uB9B4\uB808\uC774 \uC11C\uBC84 \uC5F0\uACB0\uB428");
       this.reconnectDelay = 1e3;
       this.startHeartbeat();
     });
-    this.ws.on("message", async (raw) => {
+    ws.on("message", async (raw) => {
+      if (this.ws !== ws) return;
       try {
         const msg = JSON.parse(raw.toString());
         if (msg.type === "pong") return;
@@ -211,9 +243,10 @@ var RelayClient = class {
       } catch {
       }
     });
-    this.ws.on("close", async (code) => {
-      this.stopHeartbeat();
+    ws.on("close", async (code) => {
       if (this.destroyed) return;
+      if (this.ws !== ws) return;
+      this.stopHeartbeat();
       if (code === 4001) {
         this.destroyed = true;
         if (this.onAuthExpired) {
@@ -230,7 +263,7 @@ var RelayClient = class {
       setTimeout(() => this.connect(), this.reconnectDelay);
       this.reconnectDelay = Math.min(this.reconnectDelay * 2, 3e4);
     });
-    this.ws.on("error", (err) => {
+    ws.on("error", (err) => {
       console.error(`\uB9B4\uB808\uC774 \uC624\uB958: ${err.message}`);
     });
   }
@@ -276,6 +309,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(
@@ -321,8 +355,16 @@ ${error.stderr ?? ""}`
         encoding: import_zod.z.enum(["utf-8", "base64"]).optional().default("utf-8").describe("\uC778\uCF54\uB529")
       },
       async ({ path: filePath, encoding }) => {
-        const content = await import_promises.default.readFile(filePath, encoding);
-        return { content: [{ type: "text", text: content }] };
+        try {
+          const content = await import_promises.default.readFile(filePath, encoding);
+          return { content: [{ type: "text", text: content }] };
+        } catch (err) {
+          const e = err;
+          if (e.code === "ENOENT") {
+            return { content: [{ type: "text", text: `\u274C \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${filePath}` }], isError: true };
+          }
+          return { content: [{ type: "text", text: `\u274C \uD30C\uC77C \uC77D\uAE30 \uC2E4\uD328: ${e.message}` }], isError: true };
+        }
       }
     );
     server.tool(
@@ -345,9 +387,17 @@ ${error.stderr ?? ""}`
         path: import_zod.z.string().describe("\uB514\uB809\uD1A0\uB9AC \uACBD\uB85C")
       },
       async ({ path: dirPath }) => {
-        const entries = await import_promises.default.readdir(dirPath, { withFileTypes: true });
-        const lines = entries.map((e) => `${e.isDirectory() ? "\u{1F4C1}" : "\u{1F4C4}"} ${e.name}`);
-        return { content: [{ type: "text", text: lines.join("\n") }] };
+        try {
+          const entries = await import_promises.default.readdir(dirPath, { withFileTypes: true });
+          const lines = entries.map((e) => `${e.isDirectory() ? "\u{1F4C1}" : "\u{1F4C4}"} ${e.name}`);
+          return { content: [{ type: "text", text: lines.join("\n") }] };
+        } catch (err) {
+          const e = err;
+          if (e.code === "ENOENT") {
+            return { content: [{ type: "text", text: `\u274C \uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${dirPath}` }], isError: true };
+          }
+          return { content: [{ type: "text", text: `\u274C \uB514\uB809\uD1A0\uB9AC \uC77D\uAE30 \uC2E4\uD328: ${e.message}` }], isError: true };
+        }
       }
     );
     server.tool(
@@ -360,18 +410,20 @@ ${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" }] };
         } catch {
-          const files = await (0, import_glob.glob)(file_pattern, { cwd: directory });
+          const safeDirectory = import_path2.default.resolve(directory);
+          const files = await (0, import_glob.glob)(file_pattern, { cwd: safeDirectory });
           const results = [];
           for (const file of files.slice(0, 100)) {
             try {
               const content = await import_promises.default.readFile(
-                import_path2.default.join(directory, file),
+                import_path2.default.join(safeDirectory, file),
                 "utf-8"
               );
               const lines = content.split("\n");
@@ -498,6 +550,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 +583,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 +608,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,14 +622,14 @@ 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: path4, full_page }) => this.withLock(async () => {
         const page = requirePage();
         const screenshot = await page.screenshot({
-          path: path3 ?? void 0,
+          path: path4 ?? void 0,
           fullPage: full_page
         });
-        if (path3) {
-          return { content: [{ type: "text", text: `\uC800\uC7A5 \uC644\uB8CC: ${path3}` }] };
+        if (path4) {
+          return { content: [{ type: "text", text: `\uC800\uC7A5 \uC644\uB8CC: ${path4}` }] };
         }
         return {
           content: [
@@ -577,13 +640,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 +654,36 @@ 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 }) => {
-        const result = await requirePage().evaluate(code);
-        return {
-          content: [
-            { type: "text", text: JSON.stringify(result, null, 2) }
-          ]
-        };
-      }
+      ({ code }) => this.withLock(async () => {
+        try {
+          const result = await requirePage().evaluate(code);
+          return {
+            content: [
+              { type: "text", text: typeof result === "string" ? result : JSON.stringify(result, null, 2) }
+            ]
+          };
+        } catch (err) {
+          return {
+            content: [{ type: "text", text: `\u274C JavaScript \uC2E4\uD589 \uC624\uB958: ${err.message}` }],
+            isError: true
+          };
+        }
+      })
     );
     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 }) => {
-        await requirePage().pdf({ path: path3 });
-        return { content: [{ type: "text", text: `PDF \uC800\uC7A5 \uC644\uB8CC: ${path3}` }] };
-      }
+      ({ path: path4 }) => this.withLock(async () => {
+        await requirePage().pdf({ path: path4 });
+        return { content: [{ type: "text", text: `PDF \uC800\uC7A5 \uC644\uB8CC: ${path4}` }] };
+      })
     );
   }
 };
@@ -626,7 +696,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 Jupyter \uB178\uD2B8\uBD81 \uD30C\uC77C\uC785\uB2C8\uB2E4: ${filePath}`);
+  }
 }
 async function writeNotebook(filePath, nb) {
   await import_promises2.default.writeFile(filePath, JSON.stringify(nb, null, 1), "utf-8");
@@ -721,15 +795,21 @@ var NotebookTools = class {
           execution_count: cellType === "code" ? null : void 0
         };
         let actualIndex;
+        let warning = "";
         if (position === void 0 || position === null) {
           nb.cells.push(newCell);
           actualIndex = nb.cells.length - 1;
+        } else if (position > nb.cells.length) {
+          nb.cells.push(newCell);
+          actualIndex = nb.cells.length - 1;
+          warning = ` (\uACBD\uACE0: position ${position}\uC774 \uBC94\uC704\uB97C \uCD08\uACFC\uD558\uC5EC \uB05D(index: ${actualIndex})\uC5D0 \uCD94\uAC00\uB428)`;
         } else {
-          nb.cells.splice(position, 0, newCell);
-          actualIndex = position;
+          const clamped = Math.max(0, position);
+          nb.cells.splice(clamped, 0, newCell);
+          actualIndex = clamped;
         }
         await writeNotebook(filePath, nb);
-        return { content: [{ type: "text", text: `\uC140 \uCD94\uAC00 \uC644\uB8CC (index: ${actualIndex})` }] };
+        return { content: [{ type: "text", text: `\uC140 \uCD94\uAC00 \uC644\uB8CC (index: ${actualIndex})${warning}` }] };
       }
     );
     server.tool(
@@ -757,13 +837,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 +853,26 @@ 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 +886,31 @@ 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) {
+          const e = err;
+          return {
+            content: [{ type: "text", text: `\u274C \uCE74\uBA54\uB77C\uB97C \uCC3E\uC744 \uC218 \uC5C6\uAC70\uB098 \uC811\uADFC\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.
+\uC6D0\uC778: ${e.message}
+
+\uCE74\uBA54\uB77C\uAC00 \uC5F0\uACB0\uB418\uC5B4 \uC788\uB294\uC9C0 \uD655\uC778\uD558\uC138\uC694.` }],
+            isError: true
+          };
+        }
+        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" }]
         };
@@ -818,11 +925,17 @@ var DeviceTools = class {
       },
       async ({ title, message }) => {
         const p = platform();
-        const cmd = {
-          mac: `osascript -e 'display notification "${message}" with title "${title}"'`,
-          win: `powershell -Command "[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType=WindowsRuntime]::CreateToastNotifier('Junis').Show([Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom, ContentType=WindowsRuntime]::new())"`,
-          linux: `notify-send "${title}" "${message}"`
-        }[p];
+        let cmd;
+        if (p === "win") {
+          const script = `Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.MessageBox]::Show('${message.replace(/'/g, "''")}', '${title.replace(/'/g, "''")}')`;
+          const encoded = Buffer.from(script, "utf16le").toString("base64");
+          cmd = `powershell -NoProfile -EncodedCommand ${encoded}`;
+        } else {
+          cmd = {
+            mac: `osascript -e 'display notification "${message.replace(/"/g, '\\"')}" with title "${title.replace(/"/g, '\\"')}"'`,
+            linux: `notify-send "${title.replace(/"/g, '\\"')}" "${message.replace(/"/g, '\\"')}"`
+          }[p] ?? "";
+        }
         await execAsync3(cmd);
         return { content: [{ type: "text", text: "\uC54C\uB9BC \uC804\uC1A1 \uC644\uB8CC" }] };
       }
@@ -863,25 +976,26 @@ 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`;
-          const { spawn } = await import("child_process");
+          const { spawn: spawn2 } = await import("child_process");
           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" });
+          const child = spawn2(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");
+            await new Promise((r) => setTimeout(r, 1e3));
           } catch {
           }
-          this.screenRecordPid = null;
+          screenRecordPid = null;
           return { content: [{ type: "text", text: "\uB179\uD654 \uC911\uC9C0\uB428." }] };
         }
       }
@@ -900,12 +1014,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)`
           }]
         };
       }
@@ -1178,6 +1295,171 @@ async function handleMCPRequest(id, payload) {
   return null;
 }
 
+// src/cli/daemon.ts
+var import_fs2 = __toESM(require("fs"));
+var import_path3 = __toESM(require("path"));
+var import_os2 = __toESM(require("os"));
+var import_child_process4 = require("child_process");
+var CONFIG_DIR2 = import_path3.default.join(import_os2.default.homedir(), ".junis");
+var PID_FILE = import_path3.default.join(CONFIG_DIR2, "junis.pid");
+var LOG_DIR = import_path3.default.join(CONFIG_DIR2, "logs");
+var LOG_FILE = import_path3.default.join(LOG_DIR, "junis.log");
+var PLIST_PATH = import_path3.default.join(
+  import_os2.default.homedir(),
+  "Library/LaunchAgents/ai.junis.plist"
+);
+var SYSTEMD_PATH = import_path3.default.join(
+  import_os2.default.homedir(),
+  ".config/systemd/user/junis.service"
+);
+function isRunning() {
+  try {
+    if (!import_fs2.default.existsSync(PID_FILE)) return { running: false };
+    const pid = parseInt(import_fs2.default.readFileSync(PID_FILE, "utf-8").trim(), 10);
+    if (isNaN(pid)) return { running: false };
+    process.kill(pid, 0);
+    return { running: true, pid };
+  } catch {
+    try {
+      import_fs2.default.unlinkSync(PID_FILE);
+    } catch {
+    }
+    return { running: false };
+  }
+}
+function writePid(pid) {
+  import_fs2.default.mkdirSync(CONFIG_DIR2, { recursive: true });
+  import_fs2.default.writeFileSync(PID_FILE, String(pid), "utf-8");
+}
+function startDaemon(port) {
+  import_fs2.default.mkdirSync(LOG_DIR, { recursive: true });
+  const nodePath = process.execPath;
+  const scriptPath = process.argv[1];
+  const out = import_fs2.default.openSync(LOG_FILE, "a");
+  const err = import_fs2.default.openSync(LOG_FILE, "a");
+  const child = (0, import_child_process4.spawn)(nodePath, [scriptPath, "start", "--daemon", "--port", String(port)], {
+    detached: true,
+    stdio: ["ignore", out, err]
+  });
+  child.unref();
+  const pid = child.pid;
+  writePid(pid);
+}
+function stopDaemon() {
+  const { running, pid } = isRunning();
+  if (!running || !pid) return false;
+  try {
+    process.kill(pid, "SIGTERM");
+    try {
+      import_fs2.default.unlinkSync(PID_FILE);
+    } catch {
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+var ServiceManager = class {
+  get platform() {
+    if (process.platform === "darwin") return "mac";
+    if (process.platform === "win32") return "win";
+    return "linux";
+  }
+  async install() {
+    const nodePath = process.execPath;
+    const scriptPath = process.argv[1];
+    if (this.platform === "mac") {
+      const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>ai.junis</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${nodePath}</string>
+    <string>${scriptPath}</string>
+    <string>start</string>
+    <string>--daemon</string>
+  </array>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>HOME</key>
+    <string>${import_os2.default.homedir()}</string>
+    <key>PATH</key>
+    <string>${process.env.PATH ?? "/usr/local/bin:/usr/bin:/bin"}</string>
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${LOG_FILE}</string>
+  <key>StandardErrorPath</key>
+  <string>${LOG_FILE}</string>
+</dict>
+</plist>`;
+      import_fs2.default.mkdirSync(import_path3.default.dirname(PLIST_PATH), { recursive: true });
+      import_fs2.default.mkdirSync(LOG_DIR, { recursive: true });
+      import_fs2.default.writeFileSync(PLIST_PATH, plist, "utf-8");
+      try {
+        (0, import_child_process4.execSync)(`launchctl unload "${PLIST_PATH}" 2>/dev/null || true`);
+        (0, import_child_process4.execSync)(`launchctl load "${PLIST_PATH}"`);
+      } catch (e) {
+        throw new Error(`launchctl load \uC2E4\uD328: ${e.message}`);
+      }
+    } else if (this.platform === "linux") {
+      const unit = `[Unit]
+Description=Junis Device Agent
+After=network.target
+
+[Service]
+ExecStart=${nodePath} ${scriptPath} start --daemon
+Restart=always
+RestartSec=5
+Environment=HOME=${import_os2.default.homedir()}
+Environment=PATH=${process.env.PATH ?? "/usr/local/bin:/usr/bin:/bin"}
+StandardOutput=append:${LOG_FILE}
+StandardError=append:${LOG_FILE}
+
+[Install]
+WantedBy=default.target`;
+      import_fs2.default.mkdirSync(import_path3.default.dirname(SYSTEMD_PATH), { recursive: true });
+      import_fs2.default.mkdirSync(LOG_DIR, { recursive: true });
+      import_fs2.default.writeFileSync(SYSTEMD_PATH, unit, "utf-8");
+      (0, import_child_process4.execSync)("systemctl --user daemon-reload");
+      (0, import_child_process4.execSync)("systemctl --user enable junis");
+      (0, import_child_process4.execSync)("systemctl --user start junis");
+    } else {
+      (0, import_child_process4.execSync)(
+        `schtasks /Create /F /TN "Junis" /TR "${nodePath} ${scriptPath} start --daemon" /SC ONLOGON /RL HIGHEST`
+      );
+    }
+  }
+  async uninstall() {
+    if (this.platform === "mac") {
+      try {
+        (0, import_child_process4.execSync)(`launchctl unload "${PLIST_PATH}" 2>/dev/null || true`);
+        if (import_fs2.default.existsSync(PLIST_PATH)) import_fs2.default.unlinkSync(PLIST_PATH);
+      } catch {
+      }
+    } else if (this.platform === "linux") {
+      try {
+        (0, import_child_process4.execSync)("systemctl --user stop junis 2>/dev/null || true");
+        (0, import_child_process4.execSync)("systemctl --user disable junis 2>/dev/null || true");
+        if (import_fs2.default.existsSync(SYSTEMD_PATH)) import_fs2.default.unlinkSync(SYSTEMD_PATH);
+        (0, import_child_process4.execSync)("systemctl --user daemon-reload 2>/dev/null || true");
+      } catch {
+      }
+    } else {
+      try {
+        (0, import_child_process4.execSync)('schtasks /Delete /F /TN "Junis" 2>nul || true');
+      } catch {
+      }
+    }
+  }
+};
+
 // src/cli/index.ts
 var { version } = require_package();
 import_commander.program.name("junis").description("AI\uAC00 \uB0B4 \uB514\uBC14\uC774\uC2A4\uB97C \uC644\uC804 \uC81C\uC5B4\uD558\uB294 MCP \uC11C\uBC84").version(version);
@@ -1185,9 +1467,9 @@ function getSystemInfo() {
   const platform2 = process.platform;
   if (platform2 === "darwin") {
     try {
-      const { execSync } = require("child_process");
-      const sw = execSync("sw_vers -productVersion", { encoding: "utf8" }).trim();
-      const hw = execSync("sysctl -n machdep.cpu.brand_string", { encoding: "utf8" }).trim();
+      const { execSync: execSync2 } = require("child_process");
+      const sw = execSync2("sw_vers -productVersion", { encoding: "utf8" }).trim();
+      const hw = execSync2("sysctl -n machdep.cpu.brand_string", { encoding: "utf8" }).trim();
       return `macOS ${sw} (${hw})`;
     } catch {
       return "macOS";
@@ -1229,22 +1511,67 @@ function printStep1(port) {
   console.log(` \u25C9 Local MCP endpoint ........... http://localhost:${port}/mcp`);
   console.log("");
 }
-import_commander.program.command("start", { isDefault: true }).description("Junis \uC5D0\uC774\uC804\uD2B8\uC640 \uC5F0\uACB0 \uC2DC\uC791").option("--local", "\uB85C\uCEEC MCP \uC11C\uBC84\uB9CC \uC2E4\uD589 (\uD074\uB77C\uC6B0\uB4DC \uC5F0\uACB0 \uC5C6\uC74C)").option("--port <number>", "\uD3EC\uD2B8 \uBC88\uD638", "3000").option("--reset", "\uAE30\uC874 \uC778\uC99D \uCD08\uAE30\uD654 \uD6C4 \uC7AC\uB85C\uADF8\uC778").action(async (options) => {
+import_commander.program.command("start", { isDefault: true }).description("Junis \uC5D0\uC774\uC804\uD2B8\uC640 \uC5F0\uACB0 \uC2DC\uC791").option("--local", "\uB85C\uCEEC MCP \uC11C\uBC84\uB9CC \uC2E4\uD589 (\uD074\uB77C\uC6B0\uB4DC \uC5F0\uACB0 \uC5C6\uC74C)").option("--port <number>", "\uD3EC\uD2B8 \uBC88\uD638", "3000").option("--reset", "\uAE30\uC874 \uC778\uC99D \uCD08\uAE30\uD654 \uD6C4 \uC7AC\uB85C\uADF8\uC778").option("--daemon", "\uB370\uBAAC \uBAA8\uB4DC\uB85C \uC2E4\uD589 (\uB0B4\uBD80\uC6A9, launchd/systemd\uC5D0\uC11C \uC0AC\uC6A9)").action(async (options) => {
   const port = parseInt(options.port, 10);
+  if (options.daemon) {
+    if (options.local) {
+      await startMCPServer(port);
+      return;
+    }
+    let config2 = options.reset ? null : loadConfig();
+    if (!config2) {
+      console.error("\u274C \uC778\uC99D \uC815\uBCF4 \uC5C6\uC74C. npx junis \uB97C \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
+      process.exit(1);
+    }
+    const deviceName2 = config2.device_name;
+    const platformName2 = process.platform === "darwin" ? "macos" : process.platform === "win32" ? "windows" : "linux";
+    const actualPort = await startMCPServer(port);
+    console.log(`[junis daemon] MCP server started on port ${actualPort}`);
+    const relay = new RelayClient(config2, handleMCPRequest, async () => {
+      console.log("[junis daemon] \uC138\uC158 \uB9CC\uB8CC - \uC7AC\uC778\uC99D \uD544\uC694");
+      try {
+        let waitingPrinted = false;
+        const authResult = await authenticate(
+          deviceName2,
+          platformName2,
+          (uri) => {
+            console.log(`[junis daemon] \uBE0C\uB77C\uC6B0\uC800 \uC7AC\uC778\uC99D: ${uri}`);
+          },
+          () => {
+            if (!waitingPrinted) waitingPrinted = true;
+          }
+        );
+        config2.token = authResult.token;
+        saveConfig(config2);
+        relay.restart();
+      } catch (e) {
+        console.error("[junis daemon] \uC7AC\uC778\uC99D \uC2E4\uD328:", e);
+        process.exit(1);
+      }
+    });
+    await relay.connect();
+    console.log("[junis daemon] relay connected");
+    return;
+  }
   printBanner();
   if (options.local) {
-    const actualPort2 = await startMCPServer(port);
-    printStep1(actualPort2);
+    const actualPort = await startMCPServer(port);
+    printStep1(actualPort);
     console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
     console.log(" \u2705 ALL SET \u2014 Local MCP server is running");
     console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
     return;
   }
+  const { running, pid } = isRunning();
+  if (running) {
+    console.log(`\u2705 Junis \uC2E4\uD589 \uC911\uC785\uB2C8\uB2E4. (PID: ${pid})`);
+    console.log("   \uC885\uB8CC\uD558\uB824\uBA74: npx junis stop");
+    return;
+  }
   let config = options.reset ? null : loadConfig();
   const deviceName = config?.device_name ?? `${process.env["USER"] ?? "user"}'s ${getDeviceName()}`;
   const platformName = process.platform === "darwin" ? "macos" : process.platform === "win32" ? "windows" : "linux";
-  const actualPort = await startMCPServer(port);
-  printStep1(actualPort);
+  printStep1(port);
   if (!config) {
     let waitingPrinted = false;
     const authResult = await authenticate(
@@ -1305,53 +1632,42 @@ import_commander.program.command("start", { isDefault: true }).description("Juni
     console.log(" \u25C9 Status ....................... \u{1F7E2} online");
     console.log("");
   }
-  const relay = new RelayClient(config, handleMCPRequest, async () => {
-    console.log("\n\u{1F511} \uC138\uC158\uC774 \uB9CC\uB8CC\uB410\uC2B5\uB2C8\uB2E4. \uC790\uB3D9\uC73C\uB85C \uC7AC\uC778\uC99D\uD569\uB2C8\uB2E4...");
-    try {
-      let waitingPrinted = false;
-      const authResult = await authenticate(
-        deviceName,
-        platformName,
-        (uri) => {
-          console.log(" Opening browser for re-auth...");
-          console.log(` \u2192 ${uri}`);
-          process.stdout.write(" Waiting for login \xB7");
-        },
-        () => {
-          process.stdout.write("\xB7");
-        }
-      );
-      console.log(`
- \u2705 \uC7AC\uC778\uC99D \uC644\uB8CC`);
-      config.token = authResult.token;
-      saveConfig(config);
-      relay.restart();
-    } catch (e) {
-      console.error("\n\u274C \uC7AC\uC778\uC99D \uC2E4\uD328:", e);
-      process.exit(1);
-    }
-  });
-  await relay.connect();
   console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-  console.log(" \u2705 ALL SET \u2014 Your AI can now control this device");
+  console.log(" STEP 5 \xB7 Starting Background Service");
   console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  const svc = new ServiceManager();
+  try {
+    await svc.install();
+    console.log(" \u25C9 Service registered ........... \u2705");
+    console.log(" \u25C9 Auto-start on boot ........... \u2705");
+  } catch (e) {
+    console.warn(` \u26A0\uFE0F  \uC11C\uBE44\uC2A4 \uB4F1\uB85D \uC2E4\uD328: ${e.message}`);
+    console.warn("    \uBC31\uADF8\uB77C\uC6B4\uB4DC \uD504\uB85C\uC138\uC2A4\uB85C\uB9CC \uC2E4\uD589\uD569\uB2C8\uB2E4.");
+    startDaemon(port);
+  }
   const webUrl = process.env.JUNIS_WEB_URL ?? "https://junis.ai";
   console.log("");
-  console.log(" Opening your AI team...");
+  console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  console.log(" \u2705 ALL SET \u2014 Junis\uAC00 \uBC31\uADF8\uB77C\uC6B4\uB4DC\uC5D0\uC11C \uC2E4\uD589 \uC911\uC785\uB2C8\uB2E4.");
+  console.log("    \uBD80\uD305 \uC2DC \uC790\uB3D9\uC73C\uB85C \uC2DC\uC791\uB429\uB2C8\uB2E4.");
+  console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  console.log("");
   console.log(` \u2192 ${webUrl}`);
-  console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
-  console.log("\u2502                                              \u2502");
-  console.log("\u2502  Try asking your AI:                         \u2502");
-  console.log("\u2502                                              \u2502");
-  console.log('\u2502  "\uB370\uC2A4\uD06C\uD1B1 \uD30C\uC77C \uBAA9\uB85D \uBCF4\uC5EC\uC918"                 \u2502');
-  console.log('\u2502  "\uD06C\uB86C\uC5D0\uC11C \uC624\uB298 \uB274\uC2A4 \uAC80\uC0C9\uD574\uC918"               \u2502');
-  console.log('\u2502  "\uCE74\uBA54\uB77C\uB85C \uC0AC\uC9C4 \uD55C \uC7A5 \uCC0D\uC5B4\uC918"                \u2502');
-  console.log('\u2502  "\uC774 \uC8FC\uD53C\uD130 \uB178\uD2B8\uBD81 3\uBC88 \uC140 \uC218\uC815\uD574\uC918"          \u2502');
-  console.log("\u2502                                              \u2502");
-  console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
   console.log("");
-  console.log(" Device agent running. Press Ctrl+C to disconnect.");
+  console.log("   \uC885\uB8CC\uD558\uB824\uBA74: npx junis stop");
   console.log("");
+  process.exit(0);
+});
+import_commander.program.command("stop").description("\uBC31\uADF8\uB77C\uC6B4\uB4DC \uC11C\uBE44\uC2A4 \uC911\uC9C0 \uBC0F \uC790\uB3D9\uC2DC\uC791 \uD574\uC81C").action(async () => {
+  const stopped = stopDaemon();
+  const svc = new ServiceManager();
+  await svc.uninstall();
+  if (stopped) {
+    console.log("\u2705 Junis \uC11C\uBE44\uC2A4\uAC00 \uC911\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
+  } else {
+    console.log("\u2139\uFE0F  \uC2E4\uD589 \uC911\uC778 Junis \uD504\uB85C\uC138\uC2A4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
+  }
+  console.log("   \uC790\uB3D9\uC2DC\uC791\uC774 \uD574\uC81C\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
 });
 import_commander.program.command("logout").description("\uC778\uC99D \uC815\uBCF4 \uC0AD\uC81C").action(() => {
   clearConfig();
@@ -1359,14 +1675,17 @@ import_commander.program.command("logout").description("\uC778\uC99D \uC815\uBCF
 });
 import_commander.program.command("status").description("\uD604\uC7AC \uC0C1\uD0DC \uD655\uC778").action(() => {
   const config = loadConfig();
+  const { running, pid } = isRunning();
   if (!config) {
     console.log("\u274C \uC778\uC99D \uC5C6\uC74C (npx junis \uC2E4\uD589 \uD544\uC694)");
+  } else if (running) {
+    console.log(`\u2705 \uC2E4\uD589 \uC911 (PID: ${pid})`);
+    console.log(`   \uB514\uBC14\uC774\uC2A4: ${config.device_name}`);
+    console.log(`   \uB4F1\uB85D\uC77C: ${config.created_at}`);
   } else {
-    console.log(
-      `\u2705 \uC778\uC99D\uB428
-   \uB514\uBC14\uC774\uC2A4: ${config.device_name}
-   \uB4F1\uB85D\uC77C: ${config.created_at}`
-    );
+    console.log("\u26A0\uFE0F  \uC778\uC99D\uB428, \uC11C\uBE44\uC2A4 \uC911\uC9C0 \uC0C1\uD0DC");
+    console.log(`   \uB514\uBC14\uC774\uC2A4: ${config.device_name}`);
+    console.log("   \uC2DC\uC791\uD558\uB824\uBA74: npx junis");
   }
 });
 import_commander.program.parse();