nudge-ui 0.2.0 → 0.2.2

package/dist/nudge-ui.mjs

@@ -1349,7 +1349,7 @@ var require_container = __commonJS({
     var Node2 = require_node();
     var { isClean, my } = require_symbols();
     var AtRule2;
-    var parse3;
+    var parse4;
     var Root2;
     var Rule2;
     function cleanSource(nodes) {
@@ -1516,7 +1516,7 @@ var require_container = __commonJS({
       }
       normalize(nodes, sample) {
         if (typeof nodes === "string") {
-          nodes = cleanSource(parse3(nodes).nodes);
+          nodes = cleanSource(parse4(nodes).nodes);
         } else if (typeof nodes === "undefined") {
           nodes = [];
         } else if (Array.isArray(nodes)) {
@@ -1725,7 +1725,7 @@ var require_container = __commonJS({
       }
     };
     Container2.registerParse = (dependant) => {
-      parse3 = dependant;
+      parse4 = dependant;
     };
     Container2.registerRule = (dependant) => {
       Rule2 = dependant;
@@ -2064,7 +2064,7 @@ var require_util = __commonJS({
       return path;
     });
     exports.normalize = normalize;
-    function join4(aRoot, aPath) {
+    function join6(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -2096,7 +2096,7 @@ var require_util = __commonJS({
       }
       return joined;
     }
-    exports.join = join4;
+    exports.join = join6;
     exports.isAbsolute = function(aPath) {
       return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
     };
@@ -2310,7 +2310,7 @@ var require_util = __commonJS({
             parsed.path = parsed.path.substring(0, index + 1);
           }
         }
-        sourceURL = join4(urlGenerate(parsed), sourceURL);
+        sourceURL = join6(urlGenerate(parsed), sourceURL);
       }
       return normalize(sourceURL);
     }
@@ -3750,8 +3750,8 @@ var require_source_map = __commonJS({
 var require_previous_map = __commonJS({
   "../../node_modules/.pnpm/postcss@8.5.26/node_modules/postcss/lib/previous-map.js"(exports, module) {
     "use strict";
-    var { existsSync: existsSync2, readFileSync, realpathSync: realpathSync3 } = __require("fs");
-    var { dirname: dirname3, isAbsolute: isAbsolute4, join: join4, relative: relative4, sep: sep3 } = __require("path");
+    var { existsSync: existsSync4, readFileSync, realpathSync: realpathSync3 } = __require("fs");
+    var { dirname: dirname5, isAbsolute: isAbsolute4, join: join6, relative: relative4, sep: sep3 } = __require("path");
     var { SourceMapConsumer, SourceMapGenerator } = require_source_map();
     function realPath(path) {
       try {
@@ -3778,7 +3778,7 @@ var require_previous_map = __commonJS({
         if (!this.mapFile && opts.from) {
           this.mapFile = opts.from;
         }
-        if (this.mapFile) this.root = dirname3(this.mapFile);
+        if (this.mapFile) this.root = dirname5(this.mapFile);
         if (text) this.text = text;
       }
       consumer() {
@@ -3824,13 +3824,13 @@ var require_previous_map = __commonJS({
         if (!trusted && !this.unsafeMap) {
           if (!/\.map$/i.test(path)) return void 0;
           if (!cssFile) return void 0;
-          let rel = relative4(realPath(dirname3(cssFile)), realPath(path));
+          let rel = relative4(realPath(dirname5(cssFile)), realPath(path));
           if (rel === ".." || rel.startsWith(".." + sep3) || isAbsolute4(rel)) {
             return void 0;
           }
         }
-        this.root = dirname3(path);
-        if (existsSync2(path)) {
+        this.root = dirname5(path);
+        if (existsSync4(path)) {
           this.mapFile = path;
           return readFileSync(path, "utf-8").toString().trim();
         }
@@ -3866,7 +3866,7 @@ var require_previous_map = __commonJS({
           return this.decodeInline(this.annotation);
         } else if (this.annotation) {
           let map = this.annotation;
-          if (file) map = join4(dirname3(file), map);
+          if (file) map = join6(dirname5(file), map);
           let unknown = this.loadFile(map, file, false);
           if (unknown) {
             try {
@@ -3898,7 +3898,7 @@ var require_input = __commonJS({
     var { nanoid } = require_non_secure();
     var { isAbsolute: isAbsolute4, resolve: resolve5 } = __require("path");
     var { SourceMapConsumer, SourceMapGenerator } = require_source_map();
-    var { fileURLToPath, pathToFileURL } = __require("url");
+    var { fileURLToPath, pathToFileURL: pathToFileURL2 } = __require("url");
     var CssSyntaxError2 = require_css_syntax_error();
     var PreviousMap = require_previous_map();
     var terminalHighlight = require_terminal_highlight();
@@ -4017,8 +4017,8 @@ var require_input = __commonJS({
           source: this.css
         };
         if (this.file) {
-          if (pathToFileURL) {
-            result.input.url = pathToFileURL(this.file).toString();
+          if (pathToFileURL2) {
+            result.input.url = pathToFileURL2(this.file).toString();
           }
           result.input.file = this.file;
         }
@@ -4076,11 +4076,11 @@ var require_input = __commonJS({
         }
         let fromUrl;
         if (isAbsolute4(from.source)) {
-          fromUrl = pathToFileURL(from.source);
+          fromUrl = pathToFileURL2(from.source);
         } else {
           fromUrl = new URL(
             from.source,
-            this.map.consumer().sourceRoot || pathToFileURL(this.map.mapFile)
+            this.map.consumer().sourceRoot || pathToFileURL2(this.map.mapFile)
           );
         }
         let result = {
@@ -4369,12 +4369,12 @@ var require_fromJSON = __commonJS({
 var require_map_generator = __commonJS({
   "../../node_modules/.pnpm/postcss@8.5.26/node_modules/postcss/lib/map-generator.js"(exports, module) {
     "use strict";
-    var { dirname: dirname3, relative: relative4, resolve: resolve5, sep: sep3 } = __require("path");
+    var { dirname: dirname5, relative: relative4, resolve: resolve5, sep: sep3 } = __require("path");
     var { SourceMapConsumer, SourceMapGenerator } = require_source_map();
-    var { pathToFileURL } = __require("url");
+    var { pathToFileURL: pathToFileURL2 } = __require("url");
     var Input2 = require_input();
     var sourceMapAvailable = Boolean(SourceMapConsumer && SourceMapGenerator);
-    var pathAvailable = Boolean(dirname3 && resolve5 && relative4 && sep3);
+    var pathAvailable = Boolean(dirname5 && resolve5 && relative4 && sep3);
     var MapGenerator = class {
       constructor(stringify2, root2, opts, cssString) {
         this.stringify = stringify2;
@@ -4406,7 +4406,7 @@ var require_map_generator = __commonJS({
       applyPrevMaps() {
         for (let prev of this.previous()) {
           let from = this.toUrl(this.path(prev.file));
-          let root2 = prev.root || dirname3(prev.file);
+          let root2 = prev.root || dirname5(prev.file);
           let map;
           if (this.mapOpts.sourcesContent === false) {
             map = new SourceMapConsumer(prev.text);
@@ -4601,9 +4601,9 @@ var require_map_generator = __commonJS({
         if (/^\w+:\/\//.test(file)) return file;
         let cached = this.memoizedPaths.get(file);
         if (cached) return cached;
-        let from = this.opts.to ? dirname3(this.opts.to) : ".";
+        let from = this.opts.to ? dirname5(this.opts.to) : ".";
         if (typeof this.mapOpts.annotation === "string") {
-          from = dirname3(resolve5(from, this.mapOpts.annotation));
+          from = dirname5(resolve5(from, this.mapOpts.annotation));
         }
         let path = relative4(from, file);
         this.memoizedPaths.set(file, path);
@@ -4665,8 +4665,8 @@ var require_map_generator = __commonJS({
       toFileUrl(path) {
         let cached = this.memoizedFileURLs.get(path);
         if (cached) return cached;
-        if (pathToFileURL) {
-          let fileURL = pathToFileURL(path).toString();
+        if (pathToFileURL2) {
+          let fileURL = pathToFileURL2(path).toString();
           this.memoizedFileURLs.set(path, fileURL);
           return fileURL;
         } else {
@@ -5237,7 +5237,7 @@ var require_parse = __commonJS({
     var Container2 = require_container();
     var Input2 = require_input();
     var Parser2 = require_parser();
-    function parse3(css, opts) {
+    function parse4(css, opts) {
       let input = new Input2(css, opts);
       let parser = new Parser2(input);
       try {
@@ -5258,9 +5258,9 @@ var require_parse = __commonJS({
       }
       return parser.root;
     }
-    module.exports = parse3;
-    parse3.default = parse3;
-    Container2.registerParse(parse3);
+    module.exports = parse4;
+    parse4.default = parse4;
+    Container2.registerParse(parse4);
   }
 });
 
@@ -5366,7 +5366,7 @@ var require_lazy_result = __commonJS({
     var Container2 = require_container();
     var Document2 = require_document();
     var MapGenerator = require_map_generator();
-    var parse3 = require_parse();
+    var parse4 = require_parse();
     var Result2 = require_result();
     var Root2 = require_root();
     var stringify2 = require_stringify();
@@ -5500,7 +5500,7 @@ var require_lazy_result = __commonJS({
             opts.map.prev = css.map;
           }
         } else {
-          let parser = parse3;
+          let parser = parse4;
           if (opts.syntax) parser = opts.syntax.parse;
           if (opts.parser) parser = opts.parser;
           if (parser.parse) parser = parser.parse;
@@ -5891,7 +5891,7 @@ var require_no_work_result = __commonJS({
   "../../node_modules/.pnpm/postcss@8.5.26/node_modules/postcss/lib/no-work-result.js"(exports, module) {
     "use strict";
     var MapGenerator = require_map_generator();
-    var parse3 = require_parse();
+    var parse4 = require_parse();
     var Result2 = require_result();
     var stringify2 = require_stringify();
     var warnOnce = require_warn_once();
@@ -5919,7 +5919,7 @@ var require_no_work_result = __commonJS({
           return this._root;
         }
         let root2;
-        let parser = parse3;
+        let parser = parse4;
         try {
           root2 = parser(this._css, this._opts);
         } catch (error) {
@@ -6074,7 +6074,7 @@ var require_postcss = __commonJS({
     var LazyResult = require_lazy_result();
     var list2 = require_list();
     var Node2 = require_node();
-    var parse3 = require_parse();
+    var parse4 = require_parse();
     var Processor2 = require_processor();
     var Result2 = require_result();
     var Root2 = require_root();
@@ -6119,7 +6119,7 @@ var require_postcss = __commonJS({
       return creator;
     };
     postcss2.stringify = stringify2;
-    postcss2.parse = parse3;
+    postcss2.parse = parse4;
     postcss2.fromJSON = fromJSON2;
     postcss2.list = list2;
     postcss2.comment = (defaults) => new Comment2(defaults);
@@ -6150,6 +6150,60 @@ var require_postcss = __commonJS({
 // src/hosts/static/cli.ts
 import { resolve as resolve4 } from "node:path";
 
+// src/cli/agentCommand.ts
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+function planAgentCommand(args, projectRoot, packageVersion) {
+  const projectRequire = createRequire(join(projectRoot, "package.json"));
+  if (args[0] === "setup") {
+    if (!packageVersion || !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(packageVersion)) {
+      throw new Error("Run agent setup through the installed nudge-ui executable.");
+    }
+    return {
+      executable: process.platform === "win32" ? "npx.cmd" : "npx",
+      args: ["--yes", `create-nudge-ui@${packageVersion}`, "--agent-only", ...args.slice(1)]
+    };
+  }
+  if (args[0] === "doctor") {
+    let entry;
+    try {
+      const packageEntry = projectRequire.resolve(findLocalMcp(projectRoot, projectRequire));
+      entry = join(dirname(packageEntry), "cli.mjs");
+    } catch {
+      throw new Error("Nudge agent integration is not installed. Run nudge-ui agent setup.");
+    }
+    return {
+      executable: process.execPath,
+      args: [entry, "doctor", "--workspace-root", projectRoot, ...args.slice(1)]
+    };
+  }
+  throw new Error("Usage: nudge-ui agent <setup|doctor> [options]");
+}
+function findLocalMcp(projectRoot, projectRequire) {
+  let directory = projectRoot;
+  while (true) {
+    const candidate = join(directory, "node_modules", "@nudge-ui", "mcp");
+    if (existsSync(join(candidate, "package.json"))) return candidate;
+    const parent = dirname(directory);
+    if (parent === directory) break;
+    directory = parent;
+  }
+  if (process.versions.pnp) {
+    return projectRequire.resolve("@nudge-ui/mcp");
+  }
+  throw new Error("MCP is not installed in this project.");
+}
+function runAgentCommand(args, packageVersion) {
+  const command = planAgentCommand(args, process.cwd(), packageVersion);
+  const result = spawnSync(command.executable, command.args, { cwd: process.cwd(), stdio: "inherit" });
+  if (result.error) throw result.error;
+  if (result.status !== 0) {
+    throw new Error(`Nudge agent command exited with status ${result.status ?? "unknown"}.`);
+  }
+}
+
 // src/hosts/static/server.ts
 import { createHash as createHash2 } from "node:crypto";
 import {
@@ -6157,13 +6211,13 @@ import {
 } from "node:http";
 import {
   constants,
-  existsSync,
+  existsSync as existsSync3,
   realpathSync as realpathSync2,
   statSync as statSync2
 } from "node:fs";
 import { open, stat as stat2 } from "node:fs/promises";
-import { dirname as dirname2, extname as extname2, isAbsolute as isAbsolute3, join as join3, relative as relative3, resolve as resolve3 } from "node:path";
-import { createRequire } from "node:module";
+import { dirname as dirname4, extname as extname2, isAbsolute as isAbsolute3, join as join5, relative as relative3, resolve as resolve3 } from "node:path";
+import { createRequire as createRequire3 } from "node:module";
 
 // ../../node_modules/.pnpm/parse5@7.3.0/node_modules/parse5/dist/common/unicode.js
 var UNDEFINED_CODE_POINTS = /* @__PURE__ */ new Set([
@@ -14110,8 +14164,14 @@ function positionAt(positions, offset) {
 var NUDGE_UI_ROUTE_PREFIX = "/__nudge_ui__/";
 var NUDGE_UI_MANIFEST_PATH = `${NUDGE_UI_ROUTE_PREFIX}manifest`;
 var NUDGE_UI_CLIENT_PATH = `${NUDGE_UI_ROUTE_PREFIX}client.mjs`;
+var NUDGE_UI_EDITOR_PATH = `${NUDGE_UI_ROUTE_PREFIX}editor`;
 var NUDGE_UI_RELOAD_PATH = `${NUDGE_UI_ROUTE_PREFIX}reload`;
 var NUDGE_UI_MOUNT_ID = "nudge-ui-root";
+var NUDGE_UI_EDITOR_QUERY_PARAM = "nudge-ui";
+var NUDGE_UI_EDITOR_QUERY_VALUE = "editor";
+function isReservedNudgeUiRoute(pathname) {
+  return pathname === NUDGE_UI_ROUTE_PREFIX.slice(0, -1) || pathname.startsWith(NUDGE_UI_ROUTE_PREFIX);
+}
 
 // src/html/identity.ts
 function runIdentityPass(source, pass) {
@@ -14212,9 +14272,53 @@ function instrumentSourceHtml(source, file) {
   });
 }
 
+// src/transport/editor.ts
+function isNudgeUiEditorDocumentRequest(requestHref, method, headers) {
+  const normalizedMethod = (method ?? "GET").toUpperCase();
+  if (normalizedMethod !== "GET" && normalizedMethod !== "HEAD") return false;
+  const url = new URL(requestHref, "http://nudge-ui.local");
+  if (url.pathname === NUDGE_UI_EDITOR_PATH) return true;
+  if (!isApplicationUrl(url)) return false;
+  if (!url.searchParams.getAll(NUDGE_UI_EDITOR_QUERY_PARAM).includes(NUDGE_UI_EDITOR_QUERY_VALUE)) return false;
+  const header = (name) => {
+    const value = headers?.[name] ?? headers?.[name.toLowerCase()];
+    return typeof value === "string" ? value : value?.join(",") ?? "";
+  };
+  return header("sec-fetch-dest").toLowerCase() === "document" || header("accept").toLowerCase().includes("text/html");
+}
+function isApplicationUrl(url) {
+  return (url.protocol === "http:" || url.protocol === "https:") && url.username === "" && url.password === "" && !isReservedNudgeUiRoute(url.pathname);
+}
+function createNudgeUiEditorDocument() {
+  return `<!doctype html>
+<html lang="en" data-nudge-ui-editor>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Nudge UI</title>
+  <style>html,body,#${NUDGE_UI_MOUNT_ID}{width:100%;height:100%;margin:0}body{overflow:hidden}</style>
+</head>
+<body>
+  <div id="${NUDGE_UI_MOUNT_ID}"></div>
+  <script type="module" src="${NUDGE_UI_CLIENT_PATH}" data-nudge-ui-client data-nudge-ui-manifest="${NUDGE_UI_MANIFEST_PATH}"></script>
+</body>
+</html>`;
+}
+
 // src/transport/index.ts
 var NUDGE_UI_MANIFEST_VERSION = 1;
 
+// src/hosts/environment.ts
+function readNudgeUiEnvironmentSwitch(env = process.env) {
+  const value = env.NUDGE_UI?.trim().toLowerCase();
+  if (value === "0" || value === "false" || value === "off") return "off";
+  if (value === "1" || value === "true" || value === "on") return "on";
+  return null;
+}
+function automationManifestFields(env = process.env) {
+  return readNudgeUiEnvironmentSwitch(env) === "on" ? { inspectAutomatedBrowsers: true } : {};
+}
+
 // src/hosts/static/manifest.ts
 function createStandaloneRuntimeManifest(projectId, tokenSnapshot = emptyTokenSnapshot(), revision = 0) {
   return {
@@ -14243,7 +14347,8 @@ function createStandaloneRuntimeManifest(projectId, tokenSnapshot = emptyTokenSn
       endpoint: NUDGE_UI_RELOAD_PATH,
       strategy: "reload-document",
       events: ["ready", "reload"]
-    }
+    },
+    ...automationManifestFields()
   };
 }
 function emptyTokenSnapshot() {
@@ -14327,6 +14432,81 @@ function escapeAttributeValue2(value) {
   return value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 }
 
+// src/hosts/projectBridge.ts
+import { existsSync as existsSync2 } from "node:fs";
+import { createRequire as createRequire2 } from "node:module";
+import { dirname as dirname2, join as join2, parse as parse2 } from "node:path";
+import { pathToFileURL } from "node:url";
+var runningBridges = /* @__PURE__ */ new Map();
+async function startOptionalProjectBridge(input) {
+  const key = `${input.appRoot}\0${input.origin}`;
+  const running = runningBridges.get(key);
+  if (running) return running;
+  const starting = launchOptionalProjectBridge(input, key);
+  runningBridges.set(key, starting);
+  void starting.then((bridge) => {
+    if (bridge === null && runningBridges.get(key) === starting) runningBridges.delete(key);
+  });
+  return starting;
+}
+async function launchOptionalProjectBridge(input, key) {
+  let modulePath;
+  try {
+    if (!isPnpRuntime() && !hasProjectInstalledMcp(input.appRoot)) {
+      runningBridges.delete(key);
+      return null;
+    }
+    modulePath = createRequire2(join2(input.appRoot, "package.json")).resolve("@nudge-ui/mcp/project");
+  } catch {
+    runningBridges.delete(key);
+    return null;
+  }
+  try {
+    const loaded = await import(pathToFileURL(modulePath).href);
+    if (typeof loaded.startProjectBridge !== "function") {
+      throw new Error("the project bridge export is unavailable");
+    }
+    const runtime = await loaded.startProjectBridge({
+      appRoot: input.appRoot,
+      projectId: input.projectId,
+      origin: input.origin,
+      ...input.allowedOrigins ? { allowedOrigins: input.allowedOrigins } : {}
+    });
+    if (runtime.browser.projectId !== input.projectId || runtime.browser.origin !== input.origin) {
+      await runtime.close().catch(() => void 0);
+      throw new Error("the project bridge returned a different project or origin");
+    }
+    input.info?.(`[nudge-ui] project bridge ready for ${input.projectId}`);
+    let closed = false;
+    return {
+      browser: { baseUrl: runtime.browser.bridgeUrl, autoConnect: true },
+      close: async () => {
+        if (closed) return;
+        closed = true;
+        runningBridges.delete(key);
+        await runtime.close();
+      }
+    };
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    input.warn?.(`[nudge-ui] MCP project bridge failed to start: ${detail}`);
+    runningBridges.delete(key);
+    return null;
+  }
+}
+function isPnpRuntime() {
+  return typeof process.versions.pnp === "string";
+}
+function hasProjectInstalledMcp(appRoot) {
+  let directory = appRoot;
+  const root2 = parse2(directory).root;
+  for (; ; ) {
+    if (existsSync2(join2(directory, "node_modules", "@nudge-ui", "mcp", "package.json"))) return true;
+    if (directory === root2) return false;
+    directory = dirname2(directory);
+  }
+}
+
 // src/project/tokens.ts
 import { createHash } from "node:crypto";
 import {
@@ -14335,7 +14515,7 @@ import {
   realpath,
   stat
 } from "node:fs/promises";
-import { extname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { extname, isAbsolute, join as join3, relative, resolve, sep } from "node:path";
 
 // ../../node_modules/.pnpm/postcss@8.5.26/node_modules/postcss/lib/postcss.mjs
 var import_postcss = __toESM(require_postcss(), 1);
@@ -14343,7 +14523,7 @@ var postcss_default = import_postcss.default;
 var stringify = import_postcss.default.stringify;
 var fromJSON = import_postcss.default.fromJSON;
 var plugin = import_postcss.default.plugin;
-var parse2 = import_postcss.default.parse;
+var parse3 = import_postcss.default.parse;
 var list = import_postcss.default.list;
 var document = import_postcss.default.document;
 var comment = import_postcss.default.comment;
@@ -14932,7 +15112,7 @@ async function walkDirectory(rootDirectory, directory, visitedDirectories, visit
   entries.sort((a, b) => comparePosixStrings(a.name, b.name));
   for (const entry of entries) {
     if (entry.isDirectory() && isExcludedDirectoryName(entry.name)) continue;
-    const absolutePath = join(directory, entry.name);
+    const absolutePath = join3(directory, entry.name);
     const canonicalPath = await canonicalWithinRoot(rootDirectory, absolutePath);
     if (!canonicalPath) continue;
     let stats;
@@ -15031,7 +15211,7 @@ function comparePosixStrings(a, b) {
 import { watch } from "node:fs";
 import { readdir as readdir2 } from "node:fs/promises";
 import { realpathSync, statSync } from "node:fs";
-import { dirname, isAbsolute as isAbsolute2, join as join2, relative as relative2, resolve as resolve2, sep as sep2 } from "node:path";
+import { dirname as dirname3, isAbsolute as isAbsolute2, join as join4, relative as relative2, resolve as resolve2, sep as sep2 } from "node:path";
 function createProjectFileWatcher(options) {
   const rootDirectory = realpathSync(resolve2(options.rootDirectory));
   const debounceMs = Math.max(0, options.debounceMs ?? 60);
@@ -15084,7 +15264,7 @@ function createProjectFileWatcher(options) {
     try {
       directoryWatcher = watch(directory, { persistent: true }, (eventType, filename) => {
         const changedName = filename?.toString();
-        const changedPath = changedName ? join2(directory, changedName) : directory;
+        const changedPath = changedName ? join4(directory, changedName) : directory;
         if (!isProjectPath(rootDirectory, changedPath)) return;
         if (isProjectDirectory(rootDirectory, changedPath)) watchDirectory(changedPath);
         else if (!exists(changedPath)) closeDescendants(changedPath);
@@ -15113,7 +15293,7 @@ function createProjectFileWatcher(options) {
     for (const entry of entries) {
       if (closed) return;
       if (!entry.isDirectory() || isExcludedDirectoryName(entry.name)) continue;
-      const child = join2(directory, entry.name);
+      const child = join4(directory, entry.name);
       if (!isProjectPath(rootDirectory, child)) continue;
       watchDirectory(child);
     }
@@ -15177,7 +15357,7 @@ function canonicalProjectPath(rootDirectory, path) {
     const canonical = realpathSync(path);
     return isWithin(rootDirectory, canonical) && !isSensitiveProjectPath(relative2(rootDirectory, canonical).split(sep2).join("/")) ? canonical : null;
   } catch {
-    const parent = dirname(path);
+    const parent = dirname3(path);
     if (parent === path) return null;
     try {
       const canonicalParent = realpathSync(parent);
@@ -15202,7 +15382,7 @@ function comparePosixStrings2(a, b) {
 var LOOPBACK_HOSTS = /* @__PURE__ */ new Set(["127.0.0.1", "::1", "localhost"]);
 var HTML_EXTENSIONS = /* @__PURE__ */ new Set([".html", ".htm"]);
 var DEFAULT_PORT = 4173;
-var packageRequire = createRequire(import.meta.url);
+var packageRequire = createRequire3(import.meta.url);
 function createStandaloneServer(options) {
   const rootDirectory = canonicalDirectory(options.rootDirectory);
   const host = options.host ?? "127.0.0.1";
@@ -15219,6 +15399,7 @@ function createStandaloneServer(options) {
     EMPTY_PROJECT_TOKEN_SNAPSHOT,
     revision
   );
+  let projectBridge = null;
   const initialTokens = createProjectTokenSnapshot({ rootDirectory, generationLabel: "static-html" }).then((tokens) => {
     manifest = createStandaloneRuntimeManifest(projectId, tokens, revision);
     return tokens;
@@ -15255,7 +15436,10 @@ data: ${JSON.stringify({ revision })}
   const processSettledChanges = (_changes) => {
     changeQueue = changeQueue.then(async () => {
       const tokens = await createProjectTokenSnapshot({ rootDirectory, generationLabel: "static-html" });
-      manifest = createStandaloneRuntimeManifest(projectId, tokens, revision + 1);
+      manifest = {
+        ...createStandaloneRuntimeManifest(projectId, tokens, revision + 1),
+        ...projectBridge ? { agentBridge: projectBridge.browser } : {}
+      };
       revision += 1;
       notifyReload();
     }).catch((error) => {
@@ -15322,7 +15506,22 @@ data: ${JSON.stringify({ revision })}
                 rejectStart(new Error("Standalone server closed during startup."));
                 return;
               }
-              resolveStart(readAddress(httpServer, host));
+              const address = readAddress(httpServer, host);
+              void startOptionalProjectBridge({
+                appRoot: rootDirectory,
+                projectId,
+                origin: address.url.replace(/\/$/, ""),
+                info: (message) => console.info(message),
+                warn: (message) => console.warn(message)
+              }).then((bridge) => {
+                projectBridge = bridge;
+                if (bridge) manifest = { ...manifest, agentBridge: bridge.browser };
+                if (closeRequested) {
+                  rejectStart(new Error("Standalone server closed during startup."));
+                  return;
+                }
+                resolveStart(address);
+              });
             });
           };
           httpServer.once("error", onError);
@@ -15339,7 +15538,10 @@ data: ${JSON.stringify({ revision })}
       const closeWatcher = fileWatcher?.close() ?? Promise.resolve();
       fileWatcher = null;
       closeReloadClients();
-      const closing = closeWatcher.then(() => pendingStart?.catch(() => void 0)).then(() => changeQueue).then(() => {
+      const closing = closeWatcher.then(() => pendingStart?.catch(() => void 0)).then(async () => {
+        await projectBridge?.close();
+        projectBridge = null;
+      }).then(() => changeQueue).then(() => {
         if (!httpServer.listening) return;
         return new Promise((resolveClose, rejectClose) => {
           httpServer.close((error) => {
@@ -15369,13 +15571,13 @@ function resolveDecodedStaticFile(root2, decodedPath) {
   if (!isWithin2(root2, candidate)) return null;
   const canonicalCandidate = canonicalExistingAncestor(candidate);
   if (!canonicalCandidate || !isWithin2(root2, canonicalCandidate)) return null;
-  if (!existsSync(candidate)) return null;
+  if (!existsSync3(candidate)) return null;
   let filePath = canonicalCandidate;
   const stats = statSync2(filePath);
   if (stats.isDirectory()) {
-    const indexCandidate = join3(filePath, "index.html");
+    const indexCandidate = join5(filePath, "index.html");
     const canonicalIndex = canonicalExistingAncestor(indexCandidate);
-    if (!canonicalIndex || !isWithin2(root2, canonicalIndex) || !existsSync(indexCandidate)) {
+    if (!canonicalIndex || !isWithin2(root2, canonicalIndex) || !existsSync3(indexCandidate)) {
       return null;
     }
     if (!statSync2(canonicalIndex).isFile()) return null;
@@ -15396,7 +15598,7 @@ function contentTypeForPath(filePath) {
   const extension = extname2(filePath).toLowerCase();
   return MIME_TYPES2[extension] ?? "application/octet-stream";
 }
-function isReservedNudgeUiRoute(pathname) {
+function isReservedNudgeUiRoute2(pathname) {
   return pathname === NUDGE_UI_ROUTE_PREFIX.slice(0, -1) || pathname.startsWith(NUDGE_UI_ROUTE_PREFIX);
 }
 function canonicalDirectory(directory) {
@@ -15455,7 +15657,7 @@ function canonicalExistingAncestor(candidate) {
       return realpathSync2(current);
     } catch (error) {
       if (!isMissingPathError(error)) return null;
-      const parent = dirname2(current);
+      const parent = dirname4(current);
       if (parent === current) return null;
       current = parent;
     }
@@ -15479,10 +15681,15 @@ async function handleRequest(input) {
     sendText(response, 400, "Bad Request");
     return;
   }
-  if (isReservedNudgeUiRoute(decodedPath)) {
+  if (isReservedNudgeUiRoute2(decodedPath)) {
     await handleNudgeUiRoute(input, decodedPath);
     return;
   }
+  if (isNudgeUiEditorDocumentRequest(request.url ?? "/", request.method, request.headers)) {
+    const body2 = request.method === "HEAD" ? Buffer.alloc(0) : Buffer.from(createNudgeUiEditorDocument(), "utf8");
+    sendBody(response, 200, body2, "text/html; charset=utf-8", { "Cache-Control": "no-store" });
+    return;
+  }
   const resolution = resolveDecodedStaticFile(input.rootDirectory, decodedPath);
   if (!resolution) {
     sendText(response, 404, "Not Found");
@@ -15533,6 +15740,13 @@ async function handleNudgeUiRoute(input, pathname) {
     });
     return;
   }
+  if (pathname === NUDGE_UI_EDITOR_PATH) {
+    const body = input.request.method === "HEAD" ? Buffer.alloc(0) : Buffer.from(createNudgeUiEditorDocument(), "utf8");
+    sendBody(input.response, 200, body, "text/html; charset=utf-8", {
+      "Cache-Control": "no-store"
+    });
+    return;
+  }
   if (pathname === NUDGE_UI_CLIENT_PATH) {
     try {
       const body = await readFileFromDescriptor(input.clientPath ?? resolveDefaultClientPath());
@@ -15687,7 +15901,11 @@ async function runServeCommand(options) {
   console.log(`Nudge UI serving ${server.rootDirectory} at ${address.url}`);
   await waitForTermination(server);
 }
-async function main(args = process.argv.slice(2)) {
+async function main(args = process.argv.slice(2), packageVersion) {
+  if (args[0] === "agent") {
+    runAgentCommand(args.slice(1), packageVersion);
+    return;
+  }
   const options = parseServeArguments(args);
   await runServeCommand(options);
 }