@inspecto-dev/plugin 0.3.9 → 0.3.11

package/dist/astro.cjs

@@ -36,7 +36,7 @@ __export(astro_exports, {
 });
 module.exports = __toCommonJS(astro_exports);
 
-// ../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.10_typescript@5.9.3_yaml@2.8.3/node_modules/tsup/assets/cjs_shims.js
+// ../../node_modules/.pnpm/tsup@8.5.1_jiti@2.7.0_postcss@8.5.14_typescript@5.9.3_yaml@2.8.4/node_modules/tsup/assets/cjs_shims.js
 var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
 var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 
@@ -47,7 +47,7 @@ var import_node_path4 = __toESM(require("path"), 1);
 var import_node_os2 = __toESM(require("os"), 1);
 var import_node_crypto2 = __toESM(require("crypto"), 1);
 var import_portfinder = __toESM(require("portfinder"), 1);
-var import_types2 = require("@inspecto-dev/types");
+var import_types3 = require("@inspecto-dev/types");
 
 // src/server/snippet.ts
 var fs = __toESM(require("fs"), 1);
@@ -409,13 +409,28 @@ function resolveIntents(serverPrompts) {
           );
           continue;
         }
-        if (!item.aiIntent) {
-          configLogger.warn(`Intent "${item.id}" is missing required "aiIntent".`);
-          continue;
+        if (item.kind === "workflow") {
+          if (!item.prompt) {
+            configLogger.warn(`Workflow "${item.id}" missing required "prompt", skipping`);
+            continue;
+          }
+          result.push({
+            kind: "workflow",
+            id: item.id,
+            label: item.label ?? item.id,
+            prompt: item.prompt,
+            confirm: item.confirm ?? false,
+            enabled: item.enabled ?? true
+          });
+        } else {
+          if (!item.aiIntent) {
+            configLogger.warn(`Intent "${item.id}" is missing required "aiIntent".`);
+            continue;
+          }
+          result.push(
+            baseMap.has(item.id) ? { ...baseMap.get(item.id), ...item } : item
+          );
         }
-        result.push(
-          baseMap.has(item.id) ? { ...baseMap.get(item.id), ...item } : item
-        );
       }
     }
     return result;
@@ -435,26 +450,61 @@ function resolveIntents(serverPrompts) {
         configLogger.warn('Intent object missing required "id" field, skipping.');
         continue;
       }
-      if (!item.aiIntent) {
-        configLogger.warn(`Intent "${item.id}" is missing required "aiIntent".`);
-        continue;
-      }
-      const existingIdx = merged.findIndex((i2) => i2.id === item.id);
-      if (existingIdx !== -1) {
-        if (item.enabled === false) {
-          merged.splice(existingIdx, 1);
+      if (item.kind === "workflow") {
+        if (!item.prompt) {
+          configLogger.warn(`Workflow "${item.id}" missing required "prompt", skipping`);
+          continue;
+        }
+        const wfConfig = {
+          kind: "workflow",
+          id: item.id,
+          label: item.label ?? item.id,
+          prompt: item.prompt,
+          confirm: item.confirm ?? false,
+          enabled: item.enabled ?? true
+        };
+        const existingIdx = merged.findIndex((i2) => i2.id === item.id);
+        if (existingIdx !== -1) {
+          if (item.enabled === false) {
+            merged.splice(existingIdx, 1);
+          } else {
+            merged[existingIdx] = wfConfig;
+          }
         } else {
-          merged[existingIdx] = { ...merged[existingIdx], ...item };
+          if (item.enabled !== false) {
+            merged.push(wfConfig);
+          }
         }
       } else {
-        if (item.enabled !== false) {
-          merged.push(item);
+        if (!item.aiIntent) {
+          configLogger.warn(`Intent "${item.id}" is missing required "aiIntent".`);
+          continue;
+        }
+        const existingIdx = merged.findIndex((i2) => i2.id === item.id);
+        if (existingIdx !== -1) {
+          if (item.enabled === false) {
+            merged.splice(existingIdx, 1);
+          } else {
+            merged[existingIdx] = { ...merged[existingIdx], ...item };
+          }
+        } else {
+          if (item.enabled !== false) {
+            merged.push(item);
+          }
         }
       }
     }
   }
   return merged;
 }
+function resolveWorkflowSlots(intents) {
+  return intents.filter(import_types.isWorkflowConfig).filter((w3) => w3.enabled !== false).map((w3) => ({
+    id: w3.id,
+    label: w3.label ?? w3.id,
+    prompt: w3.prompt,
+    confirm: w3.confirm ?? false
+  }));
+}
 var watchers = [];
 function watchConfig(onReload, cwd = process.cwd(), gitRoot) {
   if (isWatching) return;
@@ -684,6 +734,10 @@ function assertPathWithinIdeOpenScope(file, projectRoot) {
   }
 }
 
+// src/server/annotation-dispatch.ts
+var import_node_child_process2 = require("child_process");
+var import_node_util = require("util");
+
 // src/server/session-store.ts
 var DEFAULT_STATUS = "pending";
 function createAnnotationSessionStore(options = {}) {
@@ -691,8 +745,12 @@ function createAnnotationSessionStore(options = {}) {
   const listeners = /* @__PURE__ */ new Set();
   const now = options.now ?? (() => Date.now());
   const createId = options.createId ?? createRandomId;
-  function findNewestMatchingSession(statuses) {
-    return [...sessions.values()].filter((session) => statuses ? statuses.has(session.status) : true).sort((left, right) => right.updatedAt - left.updatedAt)[0] ?? null;
+  function findNewestMatchingSession(statuses, source) {
+    return [...sessions.values()].filter((session) => {
+      if (statuses && !statuses.has(session.status)) return false;
+      if (source && session.source !== source) return false;
+      return true;
+    }).sort((left, right) => right.updatedAt - left.updatedAt)[0] ?? null;
   }
   function updateSessionStatus(id, status) {
     const session = sessions.get(id);
@@ -752,7 +810,7 @@ function createAnnotationSessionStore(options = {}) {
     },
     async claimNextSession(options2 = {}) {
       const statuses = normalizeStatuses(DEFAULT_STATUS);
-      const existingSession = findNewestMatchingSession(statuses);
+      const existingSession = findNewestMatchingSession(statuses, options2.source);
       if (existingSession) {
         return {
           session: claimSession(existingSession.id, statuses),
@@ -867,6 +925,7 @@ function cloneValue(value) {
 }
 
 // src/server/annotation-dispatch.ts
+var execAsync = (0, import_node_util.promisify)(import_node_child_process2.exec);
 var AnnotationDispatchError = class extends Error {
   constructor(message, errorCode) {
     super(message);
@@ -878,9 +937,14 @@ async function dispatchAnnotationsToAi(req, state, store = annotationSessionStor
   try {
     validateAnnotationDispatchRequest(req, state);
     const batch = normalizeAnnotationBatch(req);
-    const prompt = buildAnnotationBatchPrompt(batch);
+    let prompt = buildAnnotationBatchPrompt(batch);
+    if (req.source === "workflow") {
+      prompt = await appendProjectMetadata(prompt, state);
+    }
     const deliveryMode = normalizeDeliveryMode(req.deliveryMode);
     const session = store.createSession({
+      source: req.source || "annotation",
+      ...req.workflowId ? { workflowId: req.workflowId } : {},
       instruction: batch.instruction,
       annotations: toSessionAnnotations(batch.annotations),
       deliveryMode,
@@ -906,6 +970,33 @@ async function dispatchAnnotationsToAi(req, state, store = annotationSessionStor
     };
   }
 }
+async function appendProjectMetadata(prompt, state) {
+  const lines = ["\n## Project"];
+  lines.push(`- Root: ${state.projectRoot}`);
+  try {
+    const options = {
+      cwd: state.projectRoot,
+      encoding: "utf-8",
+      timeout: 2e3
+    };
+    const { stdout: branchStdout } = await execAsync("git branch --show-current", options);
+    const branch = branchStdout.trim();
+    lines.push(`- Branch: ${branch}`);
+    const { stdout: statusStdout } = await execAsync("git status --porcelain", options);
+    const statusRaw = statusStdout.trim();
+    const entries = statusRaw ? statusRaw.split("\n") : [];
+    const staged = entries.filter((l) => l[0] !== " " && l[0] !== "?").length;
+    const unstaged = entries.filter((l) => l[1] !== " " && l[1] !== "?").length;
+    const untracked = entries.filter((l) => l[0] === "?").length;
+    lines.push(`- Status: ${staged} staged, ${unstaged} unstaged, ${untracked} untracked`);
+  } catch (err) {
+    console.warn("[inspecto] Failed to get git status for workflow:", err);
+    lines.push("- Git: unavailable or check timeout");
+  }
+  return `${prompt}
+
+${lines.join("\n")}`;
+}
 function normalizeDeliveryMode(input) {
   return input === "agent" ? "agent" : "ide";
 }
@@ -942,7 +1033,7 @@ function toSessionSummary(session) {
   };
 }
 function validateAnnotationDispatchRequest(req, state) {
-  if (!req.annotations.length) {
+  if (!req.annotations.length && req.source !== "workflow") {
     throw new AnnotationDispatchError("At least one annotation is required.", "INVALID_REQUEST");
   }
   for (const annotation of req.annotations) {
@@ -1044,6 +1135,7 @@ function getAnnotationDispatchErrorCode(error) {
 }
 
 // src/server/client-config.ts
+var import_types2 = require("@inspecto-dev/types");
 async function buildClientConfig(serverState2) {
   const userConfig = loadUserConfigSync(false, serverState2.cwd, serverState2.configRoot);
   const promptsConfig = await loadPromptsConfig(false, serverState2.cwd, serverState2.configRoot);
@@ -1055,11 +1147,13 @@ async function buildClientConfig(serverState2) {
     const { scheme: _scheme, ...rest } = serverState2.ideInfo;
     info = rest;
   }
+  const allIntents = resolveIntents(promptsConfig);
   return {
     ...info,
-    prompts: resolveIntents(promptsConfig),
+    prompts: allIntents.filter(import_types2.isAiIntentConfig),
+    workflows: resolveWorkflowSlots(allIntents),
     hotKeys: userConfig["inspector.hotKey"] ?? "alt",
-    annotateDeliveryMode: userConfig["annotate.deliveryMode"] ?? "both",
+    annotateDeliveryMode: userConfig["annotate.deliveryMode"] ?? "agent",
     includeSnippet: userConfig["prompt.includeSnippet"] ?? false,
     runtimeContext: {
       enabled: true,
@@ -1072,7 +1166,7 @@ async function buildClientConfig(serverState2) {
 }
 
 // src/server/open-file.ts
-var import_node_child_process2 = require("child_process");
+var import_node_child_process3 = require("child_process");
 var import_launch_ide2 = require("launch-ide");
 var serverLogger2 = createLogger("inspecto:server", { logLevel: getGlobalLogLevel() });
 var VSCODE_FAMILY_SCHEMES = [
@@ -1123,11 +1217,11 @@ function handleOpenFileRequest(body, serverState2) {
     serverLogger2.debug(`SOURCE_OPEN: Bypassing launchIDE, using URI scheme directly: ${uri}`);
     try {
       if (process.platform === "darwin") {
-        (0, import_node_child_process2.execFileSync)("open", [uri]);
+        (0, import_node_child_process3.execFileSync)("open", [uri]);
       } else if (process.platform === "win32") {
-        (0, import_node_child_process2.execFileSync)("cmd", ["/c", "start", '""', uri]);
+        (0, import_node_child_process3.execFileSync)("cmd", ["/c", "start", '""', uri]);
       } else {
-        (0, import_node_child_process2.execFileSync)("xdg-open", [uri]);
+        (0, import_node_child_process3.execFileSync)("xdg-open", [uri]);
       }
     } catch (e) {
       serverLogger2.error(`Failed to launch URI for SOURCE_OPEN (${uri}):`, e);
@@ -1154,35 +1248,72 @@ function handleOpenFileRequest(body, serverState2) {
 // src/server/project-root.ts
 var import_node_fs3 = __toESM(require("fs"), 1);
 var import_node_path3 = __toESM(require("path"), 1);
-var import_node_child_process3 = require("child_process");
+var import_node_child_process4 = require("child_process");
 var serverLogger3 = createLogger("inspecto:server", { logLevel: getGlobalLogLevel() });
-function resolveProjectRoot() {
-  const cwd = process.cwd();
-  let gitRoot;
+function resolveGitRoot(_cwd) {
   try {
-    gitRoot = (0, import_node_child_process3.execSync)("git rev-parse --show-toplevel", { encoding: "utf-8" }).trim();
+    const output = (0, import_node_child_process4.execSync)("git rev-parse --show-toplevel", { encoding: "utf-8" });
+    return typeof output === "string" ? output.trim() : null;
   } catch (e) {
     serverLogger3.warn("Failed to resolve git root via git rev-parse:", e);
-    gitRoot = cwd;
-  }
-  const visited = /* @__PURE__ */ new Set();
-  const search = (start, stop) => {
-    let current = start;
-    while (!visited.has(current)) {
-      visited.add(current);
-      if (import_node_fs3.default.existsSync(import_node_path3.default.join(current, ".inspecto"))) return current;
-      if (current === stop) break;
-      const parent = import_node_path3.default.dirname(current);
-      if (parent === current) break;
-      current = parent;
-    }
     return null;
-  };
-  const cwdMatch = search(cwd, import_node_path3.default.parse(cwd).root);
-  if (cwdMatch) return cwdMatch;
-  const repoMatch = search(gitRoot, import_node_path3.default.parse(gitRoot).root);
-  if (repoMatch) return repoMatch;
-  return gitRoot;
+  }
+}
+function findNearestAncestorWith(start, predicate) {
+  let current = start;
+  while (true) {
+    if (predicate(current)) return current;
+    const parent = import_node_path3.default.dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  return null;
+}
+function resolveWorkspaceRoot() {
+  const cwd = process.cwd();
+  const inspectoRoot = findNearestAncestorWith(
+    cwd,
+    (dir) => import_node_fs3.default.existsSync(import_node_path3.default.join(dir, ".inspecto"))
+  );
+  if (inspectoRoot) return inspectoRoot;
+  const packageRoot = findNearestAncestorWith(
+    cwd,
+    (dir) => import_node_fs3.default.existsSync(import_node_path3.default.join(dir, "package.json"))
+  );
+  if (packageRoot) return packageRoot;
+  return resolveGitRoot(cwd) ?? cwd;
+}
+function resolveProjectRoot() {
+  const cwd = process.cwd();
+  const packageRoot = findNearestAncestorWith(
+    cwd,
+    (dir) => import_node_fs3.default.existsSync(import_node_path3.default.join(dir, "package.json"))
+  );
+  if (packageRoot) return packageRoot;
+  const inspectoRoot = findNearestAncestorWith(
+    cwd,
+    (dir) => import_node_fs3.default.existsSync(import_node_path3.default.join(dir, ".inspecto"))
+  );
+  if (inspectoRoot) return inspectoRoot;
+  return resolveGitRoot(cwd) ?? cwd;
+}
+
+// src/server/server-url.ts
+function resolveServerHost(cwd, configRoot) {
+  if (process.env["VITEST"]) return "127.0.0.1";
+  const userConfig = loadUserConfigSync(false, cwd, configRoot);
+  const configuredHost = userConfig["server.host"]?.trim();
+  if (configuredHost) return configuredHost;
+  return "127.0.0.1";
+}
+function resolvePublicServerUrl(args) {
+  const userConfig = loadUserConfigSync(false, args.cwd, args.configRoot);
+  const configuredPublicUrl = userConfig["server.publicUrl"]?.trim();
+  if (configuredPublicUrl) {
+    return configuredPublicUrl.replace(/\/$/, "");
+  }
+  const host = resolveServerHost(args.cwd, args.configRoot);
+  return `http://${host}:${args.port}`;
 }
 
 // src/server/index.ts
@@ -1237,8 +1368,9 @@ async function startServer() {
     return serverState.port;
   }
   serverState.projectRoot = resolveProjectRoot();
-  serverState.configRoot = serverState.projectRoot;
+  serverState.configRoot = resolveWorkspaceRoot();
   serverState.cwd = process.cwd();
+  const serverHost = resolveServerHost(serverState.cwd, serverState.configRoot);
   import_portfinder.default.basePort = 5678;
   const port = await import_portfinder.default.getPortPromise();
   watchConfig(
@@ -1265,7 +1397,7 @@ async function startServer() {
     });
   });
   await new Promise((resolve2, reject) => {
-    serverInstance.listen(port, "0.0.0.0", () => {
+    serverInstance.listen(port, serverHost, () => {
       serverInstance.unref();
       resolve2();
     });
@@ -1287,7 +1419,7 @@ async function startServer() {
     } catch {
     }
   });
-  serverLogger4.info(`server running at http://0.0.0.0:${port}`);
+  serverLogger4.info(`server running at http://${serverHost}:${port}`);
   return port;
 }
 async function readBody(req) {
@@ -1300,19 +1432,19 @@ async function readBody(req) {
 }
 async function handleRequest(url, req, res) {
   const pathname = url.pathname;
-  if ((pathname === "/health" || pathname === import_types2.INSPECTO_API_PATHS.HEALTH) && req.method === "GET") {
+  if ((pathname === "/health" || pathname === import_types3.INSPECTO_API_PATHS.HEALTH) && req.method === "GET") {
     res.writeHead(200, { "Content-Type": "application/json" });
     res.end(JSON.stringify({ ok: true, port: serverState.port }));
     return;
   }
-  if (pathname === import_types2.INSPECTO_API_PATHS.CLIENT_CONFIG && req.method === "GET") {
+  if (pathname === import_types3.INSPECTO_API_PATHS.CLIENT_CONFIG && req.method === "GET") {
     const config = await buildClientConfig(serverState);
     delete config.providers;
     res.writeHead(200, { "Content-Type": "application/json" });
     res.end(JSON.stringify(config));
     return;
   }
-  if (pathname === import_types2.INSPECTO_API_PATHS.IDE_INFO && req.method === "POST") {
+  if (pathname === import_types3.INSPECTO_API_PATHS.IDE_INFO && req.method === "POST") {
     try {
       const body = JSON.parse(await readBody(req));
       const ideWorkspace = body.workspaceRoot || "";
@@ -1333,13 +1465,13 @@ async function handleRequest(url, req, res) {
       res.writeHead(200, { "Content-Type": "application/json" });
       res.end(JSON.stringify({ success: true }));
     } catch (e) {
-      serverLogger4.error(`Error parsing ${import_types2.INSPECTO_API_PATHS.IDE_INFO} POST request:`, e);
+      serverLogger4.error(`Error parsing ${import_types3.INSPECTO_API_PATHS.IDE_INFO} POST request:`, e);
       res.writeHead(400, { "Content-Type": "application/json" });
       res.end(JSON.stringify({ error: "Invalid JSON body" }));
     }
     return;
   }
-  if ((pathname === import_types2.INSPECTO_API_PATHS.SOURCE_OPEN || pathname === import_types2.INSPECTO_API_PATHS.IDE_OPEN) && req.method === "POST") {
+  if ((pathname === import_types3.INSPECTO_API_PATHS.SOURCE_OPEN || pathname === import_types3.INSPECTO_API_PATHS.IDE_OPEN) && req.method === "POST") {
     let body;
     try {
       body = JSON.parse(await readBody(req));
@@ -1362,7 +1494,7 @@ async function handleRequest(url, req, res) {
     res.end(JSON.stringify({ success: true }));
     return;
   }
-  if (pathname === import_types2.INSPECTO_API_PATHS.PROJECT_SNIPPET && req.method === "GET") {
+  if (pathname === import_types3.INSPECTO_API_PATHS.PROJECT_SNIPPET && req.method === "GET") {
     const file = url.searchParams.get("file") ?? "";
     const line = parseInt(url.searchParams.get("line") ?? "1", 10);
     const column = parseInt(url.searchParams.get("column") ?? "1", 10);
@@ -1396,7 +1528,7 @@ async function handleRequest(url, req, res) {
     }
     return;
   }
-  if (pathname === import_types2.INSPECTO_API_PATHS.AI_DISPATCH && req.method === "POST") {
+  if (pathname === import_types3.INSPECTO_API_PATHS.AI_DISPATCH && req.method === "POST") {
     try {
       const rawBody = await readBody(req);
       const body = JSON.parse(rawBody);
@@ -1404,13 +1536,13 @@ async function handleRequest(url, req, res) {
       res.writeHead(result.success ? 200 : 500, { "Content-Type": "application/json" });
       res.end(JSON.stringify(result));
     } catch (e) {
-      serverLogger4.error(`Error parsing ${import_types2.INSPECTO_API_PATHS.AI_DISPATCH} request:`, e);
+      serverLogger4.error(`Error parsing ${import_types3.INSPECTO_API_PATHS.AI_DISPATCH} request:`, e);
       res.writeHead(500, { "Content-Type": "application/json" });
       res.end(JSON.stringify({ success: false, error: String(e), errorCode: "INTERNAL_ERROR" }));
     }
     return;
   }
-  if (pathname === import_types2.INSPECTO_API_PATHS.AI_BATCH_DISPATCH && req.method === "POST") {
+  if (pathname === import_types3.INSPECTO_API_PATHS.AI_BATCH_DISPATCH && req.method === "POST") {
     try {
       const rawBody = await readBody(req);
       const body = JSON.parse(rawBody);
@@ -1420,13 +1552,13 @@ async function handleRequest(url, req, res) {
       });
       res.end(JSON.stringify(result));
     } catch (e) {
-      serverLogger4.error(`Error parsing ${import_types2.INSPECTO_API_PATHS.AI_BATCH_DISPATCH} request:`, e);
+      serverLogger4.error(`Error parsing ${import_types3.INSPECTO_API_PATHS.AI_BATCH_DISPATCH} request:`, e);
       res.writeHead(500, { "Content-Type": "application/json" });
       res.end(JSON.stringify({ success: false, error: String(e), errorCode: "INTERNAL_ERROR" }));
     }
     return;
   }
-  if (pathname === import_types2.INSPECTO_API_PATHS.SESSION_CLAIM_NEXT && req.method === "POST") {
+  if (pathname === import_types3.INSPECTO_API_PATHS.SESSION_CLAIM_NEXT && req.method === "POST") {
     try {
       const rawBody = await readBody(req);
       const body = rawBody ? JSON.parse(rawBody) : {};
@@ -1453,7 +1585,7 @@ async function handleRequest(url, req, res) {
     }
     return;
   }
-  if (pathname === import_types2.INSPECTO_API_PATHS.SESSION_EVENTS && req.method === "GET") {
+  if (pathname === import_types3.INSPECTO_API_PATHS.SESSION_EVENTS && req.method === "GET") {
     const statusParam = url.searchParams.getAll("status");
     const statuses = statusParam.length ? new Set(statusParam) : null;
     const sessionId = url.searchParams.get("sessionId")?.trim() || null;
@@ -1481,7 +1613,7 @@ data: ${JSON.stringify({ ok: true })}
     });
     return;
   }
-  if (pathname === import_types2.INSPECTO_API_PATHS.SESSIONS && req.method === "GET") {
+  if (pathname === import_types3.INSPECTO_API_PATHS.SESSIONS && req.method === "GET") {
     const statusParam = url.searchParams.getAll("status");
     const sessions = annotationSessionStore.listSessions(
       statusParam.length ? {
@@ -1492,8 +1624,8 @@ data: ${JSON.stringify({ ok: true })}
     res.end(JSON.stringify({ success: true, sessions }));
     return;
   }
-  if (pathname.startsWith(`${import_types2.INSPECTO_API_PATHS.SESSIONS}/`) && req.method === "GET") {
-    const sessionId = pathname.substring(import_types2.INSPECTO_API_PATHS.SESSIONS.length + 1);
+  if (pathname.startsWith(`${import_types3.INSPECTO_API_PATHS.SESSIONS}/`) && req.method === "GET") {
+    const sessionId = pathname.substring(import_types3.INSPECTO_API_PATHS.SESSIONS.length + 1);
     const session = annotationSessionStore.getSession(sessionId);
     if (!session) {
       res.writeHead(404, { "Content-Type": "application/json" });
@@ -1504,10 +1636,10 @@ data: ${JSON.stringify({ ok: true })}
     res.end(JSON.stringify({ success: true, session }));
     return;
   }
-  if (pathname.startsWith(`${import_types2.INSPECTO_API_PATHS.SESSIONS}/`) && pathname.endsWith(import_types2.INSPECTO_API_PATHS.SESSION_REPLY_SUFFIX) && req.method === "POST") {
+  if (pathname.startsWith(`${import_types3.INSPECTO_API_PATHS.SESSIONS}/`) && pathname.endsWith(import_types3.INSPECTO_API_PATHS.SESSION_REPLY_SUFFIX) && req.method === "POST") {
     const sessionId = pathname.slice(
-      import_types2.INSPECTO_API_PATHS.SESSIONS.length + 1,
-      -import_types2.INSPECTO_API_PATHS.SESSION_REPLY_SUFFIX.length
+      import_types3.INSPECTO_API_PATHS.SESSIONS.length + 1,
+      -import_types3.INSPECTO_API_PATHS.SESSION_REPLY_SUFFIX.length
     );
     try {
       const rawBody = await readBody(req);
@@ -1540,10 +1672,10 @@ data: ${JSON.stringify({ ok: true })}
     }
     return;
   }
-  if (pathname.startsWith(`${import_types2.INSPECTO_API_PATHS.SESSIONS}/`) && pathname.endsWith(import_types2.INSPECTO_API_PATHS.SESSION_RESOLVE_SUFFIX) && req.method === "POST") {
+  if (pathname.startsWith(`${import_types3.INSPECTO_API_PATHS.SESSIONS}/`) && pathname.endsWith(import_types3.INSPECTO_API_PATHS.SESSION_RESOLVE_SUFFIX) && req.method === "POST") {
     const sessionId = pathname.slice(
-      import_types2.INSPECTO_API_PATHS.SESSIONS.length + 1,
-      -import_types2.INSPECTO_API_PATHS.SESSION_RESOLVE_SUFFIX.length
+      import_types3.INSPECTO_API_PATHS.SESSIONS.length + 1,
+      -import_types3.INSPECTO_API_PATHS.SESSION_RESOLVE_SUFFIX.length
     );
     try {
       const rawBody = await readBody(req);
@@ -1591,10 +1723,10 @@ data: ${JSON.stringify({ ok: true })}
     }
     return;
   }
-  if (pathname.startsWith(`${import_types2.INSPECTO_API_PATHS.SESSIONS}/`) && pathname.endsWith(import_types2.INSPECTO_API_PATHS.SESSION_DISMISS_SUFFIX) && req.method === "POST") {
+  if (pathname.startsWith(`${import_types3.INSPECTO_API_PATHS.SESSIONS}/`) && pathname.endsWith(import_types3.INSPECTO_API_PATHS.SESSION_DISMISS_SUFFIX) && req.method === "POST") {
     const sessionId = pathname.slice(
-      import_types2.INSPECTO_API_PATHS.SESSIONS.length + 1,
-      -import_types2.INSPECTO_API_PATHS.SESSION_DISMISS_SUFFIX.length
+      import_types3.INSPECTO_API_PATHS.SESSIONS.length + 1,
+      -import_types3.INSPECTO_API_PATHS.SESSION_DISMISS_SUFFIX.length
     );
     try {
       const rawBody = await readBody(req);
@@ -1632,8 +1764,8 @@ data: ${JSON.stringify({ ok: true })}
     }
     return;
   }
-  if (pathname.startsWith(`${import_types2.INSPECTO_API_PATHS.AI_TICKET}/`) && req.method === "GET") {
-    const ticketId = pathname.substring(import_types2.INSPECTO_API_PATHS.AI_TICKET.length + 1);
+  if (pathname.startsWith(`${import_types3.INSPECTO_API_PATHS.AI_TICKET}/`) && req.method === "GET") {
+    const ticketId = pathname.substring(import_types3.INSPECTO_API_PATHS.AI_TICKET.length + 1);
     const payloadStr = readTicket(ticketId);
     if (!payloadStr) {
       res.writeHead(404, { "Content-Type": "application/json" });
@@ -1649,10 +1781,23 @@ data: ${JSON.stringify({ ok: true })}
 }
 async function dispatchToAi(req) {
   const { location, snippet, prompt } = req;
-  const formattedPrompt = prompt ?? `Please help me with this code from \`${location.file}\` (line ${location.line}):
+  if (prompt?.trim()) {
+    const runtime2 = resolvePromptDispatchRuntime(serverState);
+    return dispatchPromptThroughIde(runtime2, {
+      prompt: prompt.trim()
+    });
+  }
+  if (!location) {
+    return {
+      success: false,
+      error: "Source location is required when prompt is omitted.",
+      errorCode: "INVALID_REQUEST"
+    };
+  }
+  const formattedPrompt = `Please help me with this code from \`${location.file}\` (line ${location.line}):
 
 \`\`\`
-${snippet}
+${snippet ?? ""}
 \`\`\`
 `;
   const runtime = resolvePromptDispatchRuntime(serverState);
@@ -1661,7 +1806,7 @@ ${snippet}
     filePath: location.file,
     line: location.line,
     column: location.column,
-    snippet
+    ...snippet !== void 0 ? { snippet } : {}
   });
 }
 function getBatchDispatchStatusCode(errorCode, success) {
@@ -2411,26 +2556,28 @@ var resolveClientModule = () => {
 };
 
 // src/injectors/webpack.ts
-function getWebpackHtmlScript(serverPort) {
+function getWebpackHtmlScript(serverPort, publicServerUrl) {
   return `
 window.__AI_INSPECTOR_PORT__ = ${serverPort};
+window.__AI_INSPECTOR_SERVER_URL__ = '${publicServerUrl ?? `http://127.0.0.1:${serverPort}`}';
   window.addEventListener('load', () => {
     if (window.InspectoClient) {
       window.InspectoClient.mountInspector({
-        serverUrl: 'http://0.0.0.0:' + window.__AI_INSPECTOR_PORT__,
+        serverUrl: window.__AI_INSPECTOR_SERVER_URL__,
       });
     }
   });
 `;
 }
-function getWebpackAssetScript(serverPort) {
+function getWebpackAssetScript(serverPort, publicServerUrl) {
   return `
 if (typeof window !== 'undefined') {
   window.__AI_INSPECTOR_PORT__ = ${serverPort};
+  window.__AI_INSPECTOR_SERVER_URL__ = '${publicServerUrl ?? `http://127.0.0.1:${serverPort}`}';
   const _initInspecto = () => {
     if (window.InspectoClient) {
       window.InspectoClient.mountInspector({
-        serverUrl: 'http://0.0.0.0:' + window.__AI_INSPECTOR_PORT__,
+        serverUrl: window.__AI_INSPECTOR_SERVER_URL__,
       });
     } else {
       setTimeout(_initInspecto, 100);
@@ -2444,7 +2591,7 @@ if (typeof window !== 'undefined') {
 }
 `;
 }
-function injectWebpack(compiler, serverPortFn, resolveClientModule2) {
+function injectWebpack(compiler, serverPortFn, publicServerUrlFn, resolveClientModule2) {
   const inspectoClientPath = resolveClientModule2();
   if (compiler.webpack && compiler.webpack.EntryPlugin) {
     new compiler.webpack.EntryPlugin(compiler.context, inspectoClientPath, {
@@ -2459,11 +2606,12 @@ function injectWebpack(compiler, serverPortFn, resolveClientModule2) {
       const hooks = HtmlWebpackPlugin.constructor.getHooks(compilation);
       hooks.alterAssetTagGroups.tapPromise("inspecto-overlay", async (data) => {
         const port = await serverPortFn();
+        const publicServerUrl = publicServerUrlFn(port);
         data.headTags.unshift({
           tagName: "script",
           voidTag: false,
           meta: { plugin: "inspecto-overlay" },
-          innerHTML: getWebpackHtmlScript(port)
+          innerHTML: getWebpackHtmlScript(port, publicServerUrl)
         });
         return data;
       });
@@ -2476,13 +2624,14 @@ function injectWebpack(compiler, serverPortFn, resolveClientModule2) {
           },
           async (assets) => {
             const port = await serverPortFn();
+            const publicServerUrl = publicServerUrlFn(port);
             const mainAssetKey = Object.keys(assets).find(
               (key) => key.endsWith(".js") && (key.includes("main") || key.includes("app") || key.includes("umi"))
             );
             if (!mainAssetKey) return;
             const originalSource = assets[mainAssetKey].source();
             assets[mainAssetKey] = new compiler.webpack.sources.RawSource(
-              getWebpackAssetScript(port) + "\n" + originalSource
+              getWebpackAssetScript(port, publicServerUrl) + "\n" + originalSource
             );
           }
         );
@@ -2516,12 +2665,13 @@ function injectRspack(compiler, serverPortFn, resolveClientModule2) {
 }
 
 // src/injectors/vite.ts
-function getViteVirtualModuleScript(serverPort) {
+function getViteVirtualModuleScript(serverPort, publicServerUrl) {
   return `
 import { mountInspector } from '@inspecto-dev/core';
 window.__AI_INSPECTOR_PORT__ = ${serverPort};
+window.__AI_INSPECTOR_SERVER_URL__ = '${publicServerUrl ?? `http://127.0.0.1:${serverPort}`}';
 mountInspector({
-  serverUrl: 'http://0.0.0.0:' + window.__AI_INSPECTOR_PORT__,
+  serverUrl: window.__AI_INSPECTOR_SERVER_URL__,
 });
 `;
 }
@@ -2554,6 +2704,11 @@ var InspectoPlugin = (0, import_unplugin.createUnplugin)((userOptions = {}) => {
     }
     return serverPort;
   };
+  const getPublicServerUrl = (port) => resolvePublicServerUrl({
+    cwd: serverState.cwd || process.cwd(),
+    configRoot: serverState.configRoot || projectRoot,
+    port
+  });
   return {
     name: "inspecto-overlay",
     enforce: "pre",
@@ -2566,7 +2721,7 @@ var InspectoPlugin = (0, import_unplugin.createUnplugin)((userOptions = {}) => {
     },
     webpack: (compiler) => {
       if (isProduction) return;
-      injectWebpack(compiler, ensureServer, resolveClientModule);
+      injectWebpack(compiler, ensureServer, getPublicServerUrl, resolveClientModule);
     },
     rspack: (compiler) => {
       if (isProduction) return;
@@ -2592,7 +2747,10 @@ var InspectoPlugin = (0, import_unplugin.createUnplugin)((userOptions = {}) => {
       },
       load(id) {
         if (id === VITE_VIRTUAL_MODULE_ID) {
-          return getViteVirtualModuleScript(serverPort ?? DEFAULT_PORT);
+          return getViteVirtualModuleScript(
+            serverPort ?? DEFAULT_PORT,
+            getPublicServerUrl(serverPort ?? DEFAULT_PORT)
+          );
         }
         return null;
       },
@@ -2650,10 +2808,10 @@ var rollupPlugin = InspectoPlugin.rollup;
 var esbuildPlugin = InspectoPlugin.esbuild;
 
 // src/astro.ts
-function getAstroInjectedScript(serverPort) {
+function getAstroInjectedScript(serverPort, publicServerUrl) {
   return `
 import { mountInspector } from '@inspecto-dev/core';
-window.__AI_INSPECTOR_SERVER_URL__ = 'http://0.0.0.0:${serverPort}';
+window.__AI_INSPECTOR_SERVER_URL__ = '${publicServerUrl ?? `http://127.0.0.1:${serverPort}`}';
 mountInspector({
   serverUrl: window.__AI_INSPECTOR_SERVER_URL__,
 });
@@ -2673,7 +2831,17 @@ function astroIntegration(options) {
           return;
         }
         const serverPort = await startServer();
-        injectScript("page", getAstroInjectedScript(serverPort));
+        injectScript(
+          "page",
+          getAstroInjectedScript(
+            serverPort,
+            resolvePublicServerUrl({
+              cwd: serverState.cwd || process.cwd(),
+              configRoot: serverState.configRoot || process.cwd(),
+              port: serverPort
+            })
+          )
+        );
       }
     }
   };