@inspecto-dev/plugin 0.3.9 → 0.3.11

package/dist/astro.d.cts

@@ -6,7 +6,7 @@ interface AstroConfigSetupContext {
     injectScript: (stage: 'page' | 'head-inline' | 'before-hydration' | 'page-ssr', content: string) => void;
     updateConfig: (newConfig: Record<string, unknown>) => unknown;
 }
-declare function getAstroInjectedScript(serverPort: number): string;
+declare function getAstroInjectedScript(serverPort: number, publicServerUrl?: string): string;
 declare function astroIntegration(options?: UnpluginOptions): {
     name: string;
     hooks: {

package/dist/astro.d.ts

@@ -6,7 +6,7 @@ interface AstroConfigSetupContext {
     injectScript: (stage: 'page' | 'head-inline' | 'before-hydration' | 'page-ssr', content: string) => void;
     updateConfig: (newConfig: Record<string, unknown>) => unknown;
 }
-declare function getAstroInjectedScript(serverPort: number): string;
+declare function getAstroInjectedScript(serverPort: number, publicServerUrl?: string): string;
 declare function astroIntegration(options?: UnpluginOptions): {
     name: string;
     hooks: {

package/dist/astro.js

@@ -130,7 +130,8 @@ import { createDefu } from "defu";
 import {
   DEFAULT_PROVIDER_MODE,
   VALID_MODES,
-  DEFAULT_INTENTS
+  DEFAULT_INTENTS,
+  isWorkflowConfig
 } from "@inspecto-dev/types";
 
 // src/utils/logger.ts
@@ -378,13 +379,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;
@@ -404,26 +420,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(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;
@@ -653,6 +704,10 @@ function assertPathWithinIdeOpenScope(file, projectRoot) {
   }
 }
 
+// src/server/annotation-dispatch.ts
+import { exec } from "child_process";
+import { promisify } from "util";
+
 // src/server/session-store.ts
 var DEFAULT_STATUS = "pending";
 function createAnnotationSessionStore(options = {}) {
@@ -660,8 +715,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);
@@ -721,7 +780,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),
@@ -836,6 +895,7 @@ function cloneValue(value) {
 }
 
 // src/server/annotation-dispatch.ts
+var execAsync = promisify(exec);
 var AnnotationDispatchError = class extends Error {
   constructor(message, errorCode) {
     super(message);
@@ -847,9 +907,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,
@@ -875,6 +940,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";
 }
@@ -911,7 +1003,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) {
@@ -1013,6 +1105,7 @@ function getAnnotationDispatchErrorCode(error) {
 }
 
 // src/server/client-config.ts
+import { isAiIntentConfig } from "@inspecto-dev/types";
 async function buildClientConfig(serverState2) {
   const userConfig = loadUserConfigSync(false, serverState2.cwd, serverState2.configRoot);
   const promptsConfig = await loadPromptsConfig(false, serverState2.cwd, serverState2.configRoot);
@@ -1024,11 +1117,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(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,
@@ -1125,33 +1220,70 @@ import fs4 from "fs";
 import path4 from "path";
 import { execSync } from "child_process";
 var serverLogger3 = createLogger("inspecto:server", { logLevel: getGlobalLogLevel() });
-function resolveProjectRoot() {
-  const cwd = process.cwd();
-  let gitRoot;
+function resolveGitRoot(_cwd) {
   try {
-    gitRoot = execSync("git rev-parse --show-toplevel", { encoding: "utf-8" }).trim();
+    const output = 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 (fs4.existsSync(path4.join(current, ".inspecto"))) return current;
-      if (current === stop) break;
-      const parent = path4.dirname(current);
-      if (parent === current) break;
-      current = parent;
-    }
     return null;
-  };
-  const cwdMatch = search(cwd, path4.parse(cwd).root);
-  if (cwdMatch) return cwdMatch;
-  const repoMatch = search(gitRoot, path4.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 = path4.dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  return null;
+}
+function resolveWorkspaceRoot() {
+  const cwd = process.cwd();
+  const inspectoRoot = findNearestAncestorWith(
+    cwd,
+    (dir) => fs4.existsSync(path4.join(dir, ".inspecto"))
+  );
+  if (inspectoRoot) return inspectoRoot;
+  const packageRoot = findNearestAncestorWith(
+    cwd,
+    (dir) => fs4.existsSync(path4.join(dir, "package.json"))
+  );
+  if (packageRoot) return packageRoot;
+  return resolveGitRoot(cwd) ?? cwd;
+}
+function resolveProjectRoot() {
+  const cwd = process.cwd();
+  const packageRoot = findNearestAncestorWith(
+    cwd,
+    (dir) => fs4.existsSync(path4.join(dir, "package.json"))
+  );
+  if (packageRoot) return packageRoot;
+  const inspectoRoot = findNearestAncestorWith(
+    cwd,
+    (dir) => fs4.existsSync(path4.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
@@ -1206,8 +1338,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);
   portfinder.basePort = 5678;
   const port = await portfinder.getPortPromise();
   watchConfig(
@@ -1234,7 +1367,7 @@ async function startServer() {
     });
   });
   await new Promise((resolve2, reject) => {
-    serverInstance.listen(port, "0.0.0.0", () => {
+    serverInstance.listen(port, serverHost, () => {
       serverInstance.unref();
       resolve2();
     });
@@ -1256,7 +1389,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) {
@@ -1618,10 +1751,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);
@@ -1630,7 +1776,7 @@ ${snippet}
     filePath: location.file,
     line: location.line,
     column: location.column,
-    snippet
+    ...snippet !== void 0 ? { snippet } : {}
   });
 }
 function getBatchDispatchStatusCode(errorCode, success) {
@@ -2380,26 +2526,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);
@@ -2413,7 +2561,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, {
@@ -2428,11 +2576,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;
       });
@@ -2445,13 +2594,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
             );
           }
         );
@@ -2485,12 +2635,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__,
 });
 `;
 }
@@ -2523,6 +2674,11 @@ var InspectoPlugin = createUnplugin((userOptions = {}) => {
     }
     return serverPort;
   };
+  const getPublicServerUrl = (port) => resolvePublicServerUrl({
+    cwd: serverState.cwd || process.cwd(),
+    configRoot: serverState.configRoot || projectRoot,
+    port
+  });
   return {
     name: "inspecto-overlay",
     enforce: "pre",
@@ -2535,7 +2691,7 @@ var InspectoPlugin = createUnplugin((userOptions = {}) => {
     },
     webpack: (compiler) => {
       if (isProduction) return;
-      injectWebpack(compiler, ensureServer, resolveClientModule);
+      injectWebpack(compiler, ensureServer, getPublicServerUrl, resolveClientModule);
     },
     rspack: (compiler) => {
       if (isProduction) return;
@@ -2561,7 +2717,10 @@ var InspectoPlugin = 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;
       },
@@ -2619,10 +2778,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__,
 });
@@ -2642,7 +2801,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
+            })
+          )
+        );
       }
     }
   };