codetraxis 1.0.0 → 1.0.2

package/server/dist/utils/agent/agentInstaller.js

@@ -82,10 +82,11 @@ async function detectProjectKind(targetDir) {
         return "expo";
     if (deps["react-native"] && !deps["expo"])
         return "react-native";
-    if (deps["vite"] || deps["@vitejs/plugin-react"] || deps["@vitejs/plugin-react-swc"])
-        return "vite-react";
+    // react-scripts takes priority over vite (project may have both)
     if (deps["react-scripts"])
         return "cra-react";
+    if (deps["vite"] || deps["@vitejs/plugin-react"] || deps["@vitejs/plugin-react-swc"])
+        return "vite-react";
     if (deps["webpack"] || deps["@webpack-cli/generators"])
         return "webpack-react";
     if (await fileExists(node_path_1.default.join(targetDir, "index.html")) && !deps["react"])
@@ -148,6 +149,7 @@ async function scanDirForPattern(dir, patterns, maxDepth = 3, _depth = 0) {
 // Step 3 — per-framework adapters
 // ─────────────────────────────────────────────────────────────────────────────
 async function resolveVitePlan(targetDir) {
+    // 1. Try to find <script type="module" src="..."> in index.html
     for (const htmlPath of ["index.html", "public/index.html"]) {
         const htmlFile = node_path_1.default.join(targetDir, htmlPath);
         if (!(await fileExists(htmlFile)))
@@ -162,15 +164,24 @@ async function resolveVitePlan(targetDir) {
                     reason: `Vite: index.html <script type="module" src="${match[1]}">` };
             }
         }
-        // index.html exists but no module script → HTML patch
-        return { strategy: "patch-html", htmlFile, scriptSrc: "/codetraxisAgent.js",
-            confidence: 0.6, reason: "Vite: index.html found, no module entry detected" };
     }
-    // Fallback: semantic scan
+    // 2. Semantic scan — look for createRoot / ReactDOM.render in JS/JSX/TS/TSX
     const found = await scanDirForPattern(targetDir, WEB_BOOTSTRAP_PATTERNS);
     if (found)
         return { strategy: "inject-import", targetFile: found.file, confidence: found.confidence,
-            reason: `Vite fallback: ${found.reason}` };
+            reason: `Vite semantic: ${found.reason}` };
+    // 3. Well-known candidate filenames
+    const found2 = await resolveCandidateFallback(targetDir);
+    if (found2.strategy === "inject-import")
+        return { ...found2, reason: `Vite candidate: ${found2.reason}` };
+    // 4. Last resort — patch index.html if it exists
+    for (const htmlPath of ["index.html", "public/index.html"]) {
+        const htmlFile = node_path_1.default.join(targetDir, htmlPath);
+        if (await fileExists(htmlFile)) {
+            return { strategy: "patch-html", htmlFile, scriptSrc: "/codetraxisAgent.js",
+                confidence: 0.5, reason: "Vite: index.html found, no JS entry detected" };
+        }
+    }
     return { strategy: "manual", reason: "Vite project: no entry file found" };
 }
 async function resolveNextjsPlan(targetDir) {
@@ -414,9 +425,25 @@ async function installAgent(targetDir) {
             return { success: false, alreadyInstalled: false, projectKind: kind, strategy: "manual", error: plan.reason };
         }
         if (plan.strategy === "patch-html") {
+            const publicDir = node_path_1.default.dirname(plan.htmlFile);
+            const bundleFile = node_path_1.default.join(publicDir, "codetraxisAgent.js");
+            const port = process.env.PORT ?? "3333";
+            // Check if already installed
+            const htmlSource = await promises_1.default.readFile(plan.htmlFile, "utf-8");
+            const alreadyInstalled = htmlSource.includes("codetraxisAgent.js");
+            // Always overwrite the bundle so it stays up-to-date
+            await promises_1.default.writeFile(bundleFile, await buildHtmlAgentBundle(port), "utf-8");
+            // Patch index.html only if not already patched
+            if (!alreadyInstalled) {
+                await promises_1.default.writeFile(plan.htmlFile, patchHtmlFile(htmlSource, plan.scriptSrc), "utf-8");
+            }
             return {
-                success: false, alreadyInstalled: false, projectKind: kind, strategy: "patch-html",
-                error: `HTML patching not yet supported. Add <script src="${plan.scriptSrc}"> manually to ${plan.htmlFile}`,
+                success: true,
+                alreadyInstalled,
+                entryFile: plan.htmlFile,
+                agentFile: bundleFile,
+                projectKind: kind,
+                strategy: "patch-html",
             };
         }
         // strategy === "inject-import"
@@ -428,7 +455,12 @@ async function installAgent(targetDir) {
             // expo-router: entry is in app/ — put agent at project root instead
             ? targetDir
             : node_path_1.default.dirname(targetFile);
-        const agentFile = node_path_1.default.join(agentDir, "codetraxisAgent", "index.ts");
+        // Use .js extension for plain JS projects (webpack / CRA without TS)
+        // so webpack can resolve ./codetraxisAgent without a TypeScript loader.
+        const entryExt = node_path_1.default.extname(targetFile); // .js | .jsx | .ts | .tsx
+        const useJs = entryExt === ".js" || entryExt === ".jsx";
+        const agentIndexExt = useJs ? "js" : "ts";
+        const agentFile = node_path_1.default.join(agentDir, "codetraxisAgent", `index.${agentIndexExt}`);
         // Import path from the entry file to the agent folder's index
         let agentImportPath = AGENT_IMPORT_MARKER; // default: "./codetraxisAgent"
         if (agentDir !== node_path_1.default.dirname(targetFile)) {
@@ -439,7 +471,7 @@ async function installAgent(targetDir) {
         const entrySource = await promises_1.default.readFile(targetFile, "utf-8");
         const alreadyInstalled = entrySource.includes("codetraxisAgent");
         // Always overwrite the agent folder so the latest version is always present.
-        await writeAgentFiles(agentDir, process.env.PORT ?? "3333", kind);
+        await writeAgentFiles(agentDir, process.env.PORT ?? "3333", kind, useJs);
         // Only inject the import if it's not there yet.
         if (!alreadyInstalled) {
             await promises_1.default.writeFile(targetFile, injectImportAst(entrySource, agentImportPath), "utf-8");
@@ -455,11 +487,36 @@ async function installAgent(targetDir) {
 // ─────────────────────────────────────────────────────────────────────────────
 async function findEntryFile(targetDir) {
     const { plan } = await buildInstallPlan(targetDir);
-    return plan.strategy === "inject-import" ? plan.targetFile : null;
+    if (plan.strategy === "inject-import")
+        return plan.targetFile;
+    if (plan.strategy === "patch-html")
+        return plan.htmlFile;
+    return null;
 }
 async function removeAgent(targetDir) {
     try {
-        const entryFile = await findEntryFile(targetDir);
+        const { plan } = await buildInstallPlan(targetDir);
+        // ── patch-html case ───────────────────────────────────────────────────────
+        if (plan.strategy === "patch-html") {
+            const publicDir = node_path_1.default.dirname(plan.htmlFile);
+            const bundleFile = node_path_1.default.join(publicDir, "codetraxisAgent.js");
+            // Remove <script> tag from index.html
+            const htmlSource = await promises_1.default.readFile(plan.htmlFile, "utf-8");
+            if (htmlSource.includes("codetraxisAgent.js")) {
+                const cleaned = htmlSource
+                    .split("\n")
+                    .filter(line => !line.includes("codetraxisAgent.js"))
+                    .join("\n");
+                await promises_1.default.writeFile(plan.htmlFile, cleaned, "utf-8");
+            }
+            // Remove the bundle file
+            if (await fileExists(bundleFile)) {
+                await promises_1.default.unlink(bundleFile);
+            }
+            return { success: true, entryFile: plan.htmlFile, agentFile: bundleFile };
+        }
+        // ── inject-import case ────────────────────────────────────────────────────
+        const entryFile = plan.strategy === "inject-import" ? plan.targetFile : null;
         if (!entryFile) {
             return { success: false, error: "Entry file not found" };
         }
@@ -507,521 +564,122 @@ async function removeAgent(targetDir) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
+// Agent source location
+//
+// In production: __dirname = server/dist/utils/agent/
+//                pkg root  = ../../../../   → codetraxisAgent/ at root
+// In dev (ts-node): __dirname = server/src/utils/agent/
+//                   pkg root  = ../../../../   → codetraxisAgent/ at root
+// ─────────────────────────────────────────────────────────────────────────────
+const AGENT_SRC_DIR = node_path_1.default.resolve(__dirname, "../../../../codetraxisAgent");
+// ─── Strip TypeScript annotations for plain JS projects ──────────────────────
+// Removes: import type ..., : Type, <Type>, as Type, interface ..., export type ...
+// Keeps the runtime logic intact so webpack/babel can process it without ts-loader.
+function stripTypescript(src) {
+    return src
+        // remove `import type { ... } from "..."` lines
+        .replace(/^import type\s+\{[^}]*\}\s+from\s+['"][^'"]+['"];?\s*$/gm, "")
+        // remove `export type ...` and `export interface ...` blocks (single or multi-line)
+        .replace(/^export\s+(?:type|interface)\s+\w+[^{]*\{[^}]*\};?\s*$/gm, "")
+        .replace(/^export\s+(?:type|interface)\s+[^=\n]+=[^;\n]+;?\s*$/gm, "")
+        // remove `interface Foo { ... }` blocks
+        .replace(/^interface\s+\w+[^{]*\{[\s\S]*?\}\s*$/gm, "")
+        // remove inline type annotations: `: string`, `: boolean`, etc.
+        .replace(/:\s*(string|number|boolean|void|unknown|any|never|null|undefined)\b/g, "")
+        // remove `: SomeInterface` / `: Record<...>` etc.
+        .replace(/:\s*[A-Z][A-Za-z0-9_]*(?:<[^>]*>)?/g, "")
+        // remove `as SomeType` casts
+        .replace(/\bas\s+[A-Za-z][A-Za-z0-9_<>, |&[\]]*(?=\s*[),;\]}])/g, "")
+        // remove `<Type>` generic parameters
+        .replace(/<[A-Z][A-Za-z0-9_, ]*>/g, "")
+        // clean up resulting blank lines
+        .replace(/\n{3,}/g, "\n\n")
+        .trimEnd() + "\n";
+}
+// ─── Read agent source file and apply substitutions ──────────────────────────
+async function readAgentFile(relativePath, port, useJs) {
+    const fullPath = node_path_1.default.join(AGENT_SRC_DIR, relativePath);
+    let src = await promises_1.default.readFile(fullPath, "utf-8");
+    src = src.split("__PORT__").join(port);
+    if (useJs)
+        src = stripTypescript(src);
+    return src;
+}
+// ─────────────────────────────────────────────────────────────────────────────
 // Agent source — modular architecture
 //
-// Generates a codetraxisAgent/ folder with:
-//   shared.ts                      — bridge (WS transport + helpers)
-//   interceptors/consoleInterceptor.ts
-//   interceptors/fetchInterceptor.ts
-//   interceptors/xhrInterceptor.ts  — for React Native & raw XHR users
-//   index.ts                        — wires everything together
+// Reads from codetraxisAgent/ at package root and writes to target project:
+//   shared.ts/js
+//   interceptors/consoleInterceptor.ts/js
+//   interceptors/fetchInterceptor.ts/js
+//   interceptors/xhrInterceptor.ts/js
+//   index.ts/js   (with __PORT__ and __XHR_LINE__ substituted)
 // ─────────────────────────────────────────────────────────────────────────────
-async function writeAgentFiles(agentParentDir, serverPort, kind) {
+async function writeAgentFiles(agentParentDir, serverPort, kind, useJs = false) {
     const agentDir = node_path_1.default.join(agentParentDir, "codetraxisAgent");
     const interceptorsDir = node_path_1.default.join(agentDir, "interceptors");
+    const ext = useJs ? "js" : "ts";
+    const isRn = kind === "expo" || kind === "react-native";
+    // Always wipe the old agent folder first so stale .ts/.js files don't coexist
+    await promises_1.default.rm(agentDir, { recursive: true, force: true });
     await promises_1.default.mkdir(interceptorsDir, { recursive: true });
-    await promises_1.default.writeFile(node_path_1.default.join(agentDir, "shared.ts"), buildSharedSource(serverPort), "utf-8");
-    await promises_1.default.writeFile(node_path_1.default.join(interceptorsDir, "consoleInterceptor.ts"), buildConsoleInterceptorSource(), "utf-8");
-    await promises_1.default.writeFile(node_path_1.default.join(interceptorsDir, "fetchInterceptor.ts"), buildFetchInterceptorSource(), "utf-8");
-    await promises_1.default.writeFile(node_path_1.default.join(interceptorsDir, "xhrInterceptor.ts"), buildXhrInterceptorSource(), "utf-8");
-    await promises_1.default.writeFile(node_path_1.default.join(agentDir, "index.ts"), buildAgentIndexSource(kind), "utf-8");
+    // shared
+    await promises_1.default.writeFile(node_path_1.default.join(agentDir, `shared.${ext}`), await readAgentFile("shared.ts", serverPort, useJs), "utf-8");
+    // interceptors
+    await promises_1.default.writeFile(node_path_1.default.join(interceptorsDir, `consoleInterceptor.${ext}`), await readAgentFile("interceptors/consoleInterceptor.ts", serverPort, useJs), "utf-8");
+    await promises_1.default.writeFile(node_path_1.default.join(interceptorsDir, `fetchInterceptor.${ext}`), await readAgentFile("interceptors/fetchInterceptor.ts", serverPort, useJs), "utf-8");
+    await promises_1.default.writeFile(node_path_1.default.join(interceptorsDir, `xhrInterceptor.${ext}`), await readAgentFile("interceptors/xhrInterceptor.ts", serverPort, useJs), "utf-8");
+    // index — substitute __XHR_LINE__ based on project kind
+    const xhrLine = isRn
+        ? "setupXhrInterceptor(treeViewerBridge); // React Native uses XHR under the hood"
+        : "setupXhrInterceptor(treeViewerBridge);";
+    let indexSrc = await readAgentFile("index.ts", serverPort, useJs);
+    indexSrc = indexSrc.split("__XHR_LINE__").join(xhrLine);
+    await promises_1.default.writeFile(node_path_1.default.join(agentDir, `index.${ext}`), indexSrc, "utf-8");
 }
-// ─── shared.ts ────────────────────────────────────────────────────────────────
-function buildSharedSource(serverPort) {
-    return `/**
- * codetraxis agent — shared bridge (auto-generated, do not edit).
- */
-
-export type TreeViewerEvent = Record<string, unknown>;
-
-export interface TreeViewerBridge {
-  send: (event: TreeViewerEvent) => void;
-  uid: () => string;
-  safeSerialize: (value: unknown, depth?: number) => unknown;
-  truncate: (value: string, max?: number) => string;
-  isWeb: boolean;
+/** Insert <script src="..."> just before </body> (or </head> as fallback). */
+function patchHtmlFile(html, scriptSrc) {
+    const tag = `<script src="${scriptSrc}"></script>`;
+    if (html.includes(tag))
+        return html; // idempotent
+    if (/<\/body>/i.test(html)) {
+        return html.replace(/<\/body>/i, `  ${tag}\n</body>`);
+    }
+    if (/<\/head>/i.test(html)) {
+        return html.replace(/<\/head>/i, `  ${tag}\n</head>`);
+    }
+    // No recognisable tags — just append
+    return html + `\n${tag}\n`;
 }
-
-export function createTreeViewerBridge(serverPort: string): TreeViewerBridge {
-  const g = globalThis as Record<string, any>;
-
-  const isWeb: boolean =
-    typeof g.document !== "undefined" &&
-    typeof g.addEventListener === "function";
-
-  let ws: WebSocket | null = null;
-  let wsReady = false;
-  const queue: string[] = [];
-
-  const getHost = (): string => {
-    if (typeof g.__TREE_VIEWER_HOST__ === "string" && g.__TREE_VIEWER_HOST__) {
-      return g.__TREE_VIEWER_HOST__ as string;
-    }
-    if (isWeb && g.location?.hostname) return g.location.hostname as string;
-    return "localhost";
-  };
-
-  const connect = () => {
-    try {
-      const WS =
-        typeof WebSocket !== "undefined"
-          ? WebSocket
-          : (g.WebSocket as typeof WebSocket | undefined);
-      if (!WS) return;
-
-      ws = new WS(\`ws://\${getHost()}:${serverPort}/agent\`);
-      ws.onopen  = () => {
-        wsReady = true;
-        while (queue.length > 0) {
-          const item = queue.shift();
-          if (item && ws) ws.send(item);
-        }
-      };
-      ws.onclose = () => { wsReady = false; setTimeout(connect, 3000); };
-      ws.onerror = () => { wsReady = false; };
-    } catch { /* unavailable */ }
-  };
-  connect();
-
-  const truncate = (value: string, max = 500000): string =>
-    value.length > max ? \`\${value.slice(0, max)}…[truncated]\` : value;
-
-  const safeSerialize = (value: unknown, depth = 0): unknown => {
-    if (depth > 4)            return "[depth limit]";
-    if (value == null)        return value;
-    if (typeof value === "function") return \`[Function: \${(value as Function).name || "anonymous"}]\`;
-    if (typeof value === "symbol")   return value.toString();
-    if (typeof value !== "object")   return value;
-    if (value instanceof Error) return { __error: true, name: value.name, message: value.message, stack: value.stack };
-    if (Array.isArray(value))   return value.slice(0, 1000).map(i => safeSerialize(i, depth + 1));
-
-    const seen = new WeakSet<object>();
-    const walk = (obj: object, d: number): Record<string, unknown> | string => {
-      if (seen.has(obj)) return "[circular]";
-      seen.add(obj);
-      const r: Record<string, unknown> = {};
-      let n = 0;
-      for (const k in obj as Record<string, unknown>) {
-        if (n++ > 500) { r["..."] = "[truncated]"; break; }
-        try { r[k] = safeSerialize((obj as Record<string, unknown>)[k], d + 1); }
-        catch { r[k] = "[unserializable]"; }
-      }
-      return r;
-    };
-    return walk(value as object, depth);
-  };
-
-  const uid = () =>
-    \`\${Math.random().toString(36).slice(2)}\${Date.now().toString(36)}\`;
-
-  const send = (event: TreeViewerEvent) => {
-    try {
-      const payload = JSON.stringify(event);
-      if (wsReady && ws) { ws.send(payload); }
-      else { queue.push(payload); if (queue.length > 200) queue.shift(); }
-    } catch { /* ignore */ }
-  };
-
-  return { send, uid, safeSerialize, truncate, isWeb };
-}
-`;
-}
-// ─── consoleInterceptor.ts ────────────────────────────────────────────────────
-function buildConsoleInterceptorSource() {
-    return `/**
- * codetraxis agent — console interceptor (auto-generated, do not edit).
- */
-import type { TreeViewerBridge } from "../shared";
-
-const INSTALLED_KEY = "__tv_console_installed__";
-
-export function setupConsoleInterceptor(bridge: TreeViewerBridge): void {
-  const g = globalThis as Record<string, any>;
-  if (g[INSTALLED_KEY]) return;
-  g[INSTALLED_KEY] = true;
-
-  const original = {
-    log:   console.log.bind(console),
-    info:  console.info.bind(console),
-    warn:  console.warn.bind(console),
-    error: console.error.bind(console),
-  };
-
-  (["log", "info", "warn", "error"] as const).forEach(level => {
-    // @ts-ignore
-    console[level] = (...args: unknown[]) => {
-      original[level](...args);
-      bridge.send({
-        id: bridge.uid(),
-        type: "console",
-        level,
-        args: args.map(a => bridge.safeSerialize(a)),
-        timestamp: Date.now(),
-      });
-    };
-  });
-}
-`;
-}
-// ─── fetchInterceptor.ts ──────────────────────────────────────────────────────
-function buildFetchInterceptorSource() {
+/** Build a self-contained IIFE bundle for plain-HTML projects by reading agent sources from disk. */
+async function buildHtmlAgentBundle(serverPort) {
+    const read = (rel) => readAgentFile(rel, serverPort, true /* JS */);
+    const shared = await read("shared.ts");
+    const console_ = await read("interceptors/consoleInterceptor.ts");
+    const fetch_ = await read("interceptors/fetchInterceptor.ts");
+    const xhr_ = await read("interceptors/xhrInterceptor.ts");
+    // Convert ESM exports to local variable assignments for IIFE context
+    const strip = (src) => src
+        .replace(/^export\s+function\s+/gm, "function ")
+        .replace(/^export\s+(const|let|var)\s+/gm, "$1 ")
+        .replace(/^import[^\n]+\n/gm, "")
+        .replace(/^export\s+\{\s*\};\s*$/gm, "");
     return `/**
- * codetraxis agent — fetch interceptor (auto-generated, do not edit).
+ * codetraxis debug agent — standalone bundle (auto-generated, do not edit).
+ * Injected into public/index.html via <script src="/codetraxisAgent.js">.
  */
-import type { TreeViewerBridge } from "../shared";
-
-const INSTALLED_KEY = "__tv_fetch_installed__";
-
-function normalizeHeaders(headers: HeadersInit | undefined): Record<string, string> | undefined {
-  if (!headers) return undefined;
-  const result: Record<string, string> = {};
-  try {
-    if (headers instanceof Headers) {
-      headers.forEach((v, k) => { result[k] = v; });
-    } else if (Array.isArray(headers)) {
-      (headers as [string, string][]).forEach(([k, v]) => { result[k] = v; });
-    } else {
-      Object.assign(result, headers as Record<string, string>);
-    }
-    return result;
-  } catch { return undefined; }
-}
-
-export function setupFetchInterceptor(bridge: TreeViewerBridge): void {
-  const g = globalThis as Record<string, any>;
-  if (g[INSTALLED_KEY]) return;
-  g[INSTALLED_KEY] = true;
-
-  const originalFetch =
-    typeof globalThis.fetch === "function"
-      ? globalThis.fetch.bind(globalThis)
-      : null;
-  if (!originalFetch) return;
-
-  globalThis.fetch = async function tvFetch(
-    input: RequestInfo | URL,
-    init?: RequestInit,
-  ): Promise<Response> {
-    const url =
-      typeof input === "string" ? input
-      : input instanceof URL   ? input.href
-      : (input as Request).url;
-
-    const method = (init?.method ?? (input instanceof Request ? input.method : "GET")).toUpperCase();
-    const id    = bridge.uid();
-    const start = Date.now();
-
-    const requestHeaders = normalizeHeaders(
-      init?.headers ?? (input instanceof Request ? input.headers : undefined),
-    );
-
-    let requestBody: string | undefined;
-    const rawBody = init?.body;
-    if (rawBody != null) {
-      try {
-        requestBody =
-          typeof rawBody === "string"       ? bridge.truncate(rawBody)
-          : rawBody instanceof URLSearchParams ? bridge.truncate(rawBody.toString())
-          : "[binary]";
-      } catch { requestBody = "[unserializable-body]"; }
-    }
-
-    bridge.send({ id, type: "network", transport: "fetch", method, url,
-      requestHeaders, requestBody, state: "pending", timestamp: start });
-
-    try {
-      const response = await originalFetch(input, init);
-
-      let responseHeaders: Record<string, string> | undefined;
-      try {
-        responseHeaders = {};
-        response.headers.forEach((v, k) => { responseHeaders![k] = v; });
-      } catch { /* ignore */ }
-
-      let responseBody: string | undefined;
-      try { responseBody = bridge.truncate(await response.clone().text()); }
-      catch { responseBody = "[binary]"; }
-
-      bridge.send({ id, type: "network", transport: "fetch", method, url,
-        status: response.status, requestHeaders, requestBody,
-        responseHeaders, responseBody,
-        state: response.ok ? "success" : "error",
-        duration: Date.now() - start, timestamp: start });
-
-      return response;
-    } catch (error) {
-      bridge.send({ id, type: "network", transport: "fetch", method, url,
-        requestHeaders, requestBody, state: "error",
-        duration: Date.now() - start, timestamp: start,
-        error: bridge.safeSerialize(error) });
-      throw error;
-    }
-  };
-}
-`;
-}
-// ─── xhrInterceptor.ts ────────────────────────────────────────────────────────
-function buildXhrInterceptorSource() {
-    return `/**
- * codetraxis agent — XHR interceptor (auto-generated, do not edit).
- * Patches XMLHttpRequest.prototype so existing references (e.g. axios
- * internals captured at import time) are also intercepted.
- * Works in browser and React Native (which ships its own XHR polyfill).
- */
-import type { TreeViewerBridge } from "../shared";
-
-const INSTALLED_KEY = "__tv_xhr_installed__";
-
-export function setupXhrInterceptor(bridge: TreeViewerBridge): void {
-  if (typeof XMLHttpRequest === "undefined") return;
-  const g = globalThis as Record<string, any>;
-  if (g[INSTALLED_KEY]) return;
-  g[INSTALLED_KEY] = true;
-
-  try {
-    const proto = XMLHttpRequest.prototype;
-
-    const _origOpen = proto.open;
-    proto.open = function(this: XMLHttpRequest, method: string, url: string, ...rest: unknown[]) {
-      (this as any).__tv_method     = method.toUpperCase();
-      (this as any).__tv_url        = String(url);
-      (this as any).__tv_reqHeaders = undefined;
-      return (_origOpen as Function).apply(this, [method, url, ...rest]);
-    };
-
-    const _origSetHeader = proto.setRequestHeader;
-    proto.setRequestHeader = function(this: XMLHttpRequest, name: string, value: string) {
-      if (!(this as any).__tv_reqHeaders) (this as any).__tv_reqHeaders = {} as Record<string, string>;
-      (this as any).__tv_reqHeaders[name] = value;
-      return _origSetHeader.apply(this, [name, value]);
-    };
-
-    const _origSend = proto.send;
-    proto.send = function(this: XMLHttpRequest, body?: Document | XMLHttpRequestBodyInit | null) {
-      const id         = bridge.uid();
-      const method     = (this as any).__tv_method ?? "GET";
-      const url        = (this as any).__tv_url    ?? "";
-      const reqHeaders = (this as any).__tv_reqHeaders as Record<string, string> | undefined;
-      const start      = Date.now();
-
-      let requestBody: string | undefined;
-      if (body != null) {
-        try {
-          requestBody =
-            typeof body === "string"       ? bridge.truncate(body)
-            : body instanceof URLSearchParams ? bridge.truncate(body.toString())
-            : "[binary]";
-        } catch { /* ignore */ }
-      }
-
-      bridge.send({ id, type: "network", transport: "xhr", method, url,
-        requestBody, requestHeaders: reqHeaders, state: "pending", timestamp: start });
-
-      this.addEventListener("load", () => {
-        let responseBody: string | undefined;
-        try { responseBody = bridge.truncate(this.responseText); } catch { /* binary */ }
-
-        let responseHeaders: Record<string, string> | undefined;
-        try {
-          const raw = this.getAllResponseHeaders();
-          if (raw) {
-            responseHeaders = {};
-            raw.trim().split(/\\r?\\n/).forEach(line => {
-              const idx = line.indexOf(": ");
-              if (idx > 0) responseHeaders![line.slice(0, idx).toLowerCase()] = line.slice(idx + 2);
-            });
-          }
-        } catch { /* ignore */ }
-
-        bridge.send({ id, type: "network", transport: "xhr", method, url,
-          status: this.status, requestBody, requestHeaders: reqHeaders,
-          responseBody, responseHeaders,
-          state: this.status >= 200 && this.status < 400 ? "success" : "error",
-          duration: Date.now() - start, timestamp: start });
-      });
-
-      this.addEventListener("error", () => {
-        bridge.send({ id, type: "network", transport: "xhr", method, url,
-          requestBody, requestHeaders: reqHeaders,
-          state: "error", duration: Date.now() - start, timestamp: start });
-      });
-
-      return _origSend.apply(this, [body]);
-    };
-  } catch { /* not available */ }
-}
+(function () {
+  'use strict';
+
+${strip(shared)}
+${strip(console_)}
+${strip(fetch_)}
+${strip(xhr_)}
+
+  const _bridge = createTreeViewerBridge("${serverPort}");
+  setupConsoleInterceptor(_bridge);
+  setupFetchInterceptor(_bridge);
+  setupXhrInterceptor(_bridge);
+})();
 `;
 }
-// ─── index.ts ─────────────────────────────────────────────────────────────────
-function buildAgentIndexSource(kind) {
-    const isRn = kind === "expo" || kind === "react-native";
-    return `/**
- * codetraxis debug agent — entry point (auto-generated, do not edit).
- */
-import { createTreeViewerBridge } from "./shared";
-import { setupConsoleInterceptor } from "./interceptors/consoleInterceptor";
-import { setupFetchInterceptor }   from "./interceptors/fetchInterceptor";
-import { setupXhrInterceptor }     from "./interceptors/xhrInterceptor";
-
-export const treeViewerBridge = createTreeViewerBridge("__PORT__");
-
-setupConsoleInterceptor(treeViewerBridge);
-setupFetchInterceptor(treeViewerBridge);
-${isRn ? "setupXhrInterceptor(treeViewerBridge); // React Native uses XHR under the hood" : "setupXhrInterceptor(treeViewerBridge);"}
-
-// ─── Auto-attach default axios instance ──────────────────────────────────────
-// If the project uses axios, we attach interceptors to the default instance.
-// For axios.create() instances, call attachAxios(instance) manually.
-try {
-  // eslint-disable-next-line @typescript-eslint/no-require-imports
-  const axiosModule = require("axios");
-  const axiosInstance = axiosModule?.default ?? axiosModule;
-  if (axiosInstance?.interceptors) {
-    attachAxios(axiosInstance);
-  }
-} catch { /* axios not installed — skip */ }
-
-// ─── attachAxios — for axios.create() instances ───────────────────────────────
-// Usage: import { attachAxios } from "./codetraxisAgent";
-//        attachAxios(myAxiosInstance);
-export function attachAxios(instance: any): void {
-  if (!instance?.interceptors) return;
-
-  const INSTALLED_KEY = "__tv_axios_installed__";
-  if (instance[INSTALLED_KEY]) return;
-  instance[INSTALLED_KEY] = true;
-
-  const REQ_ID_KEY    = "__tv_req_id__";
-  const REQ_START_KEY = "__tv_req_start__";
-
-  const joinUrl = (base?: string, url?: string) => {
-    if (!base) return url || "";
-    if (!url)  return base;
-    try { return new URL(url, base).toString(); } catch { return \`\${base}\${url}\`; }
-  };
-
-  const normalizeHeaders = (h: unknown): Record<string, string> | undefined => {
-    if (!h) return undefined;
-    try {
-      if (typeof (h as any).toJSON === "function") return (h as any).toJSON() as Record<string, string>;
-      return { ...(h as Record<string, string>) };
-    } catch { return undefined; }
-  };
-
-  instance.interceptors.request.use(
-    (config: any) => {
-      const id    = treeViewerBridge.uid();
-      const start = Date.now();
-      config[REQ_ID_KEY]    = id;
-      config[REQ_START_KEY] = start;
-      treeViewerBridge.send({
-        id, type: "network", transport: "axios",
-        method: (config.method || "get").toUpperCase(),
-        url: joinUrl(config.baseURL, config.url),
-        requestHeaders: normalizeHeaders(config.headers),
-        requestBody: treeViewerBridge.safeSerialize(config.data),
-        state: "pending", timestamp: start,
-      });
-      return config;
-    },
-    (error: any) => {
-      treeViewerBridge.send({
-        id: treeViewerBridge.uid(), type: "network", transport: "axios",
-        state: "error", timestamp: Date.now(),
-        error: treeViewerBridge.safeSerialize(error),
-      });
-      return Promise.reject(error);
-    },
-  );
-
-  instance.interceptors.response.use(
-    (response: any) => {
-      const id    = response.config[REQ_ID_KEY]    || treeViewerBridge.uid();
-      const start = response.config[REQ_START_KEY] || Date.now();
-      treeViewerBridge.send({
-        id, type: "network", transport: "axios",
-        method: (response.config.method || "get").toUpperCase(),
-        url: joinUrl(response.config.baseURL, response.config.url),
-        status: response.status,
-        requestHeaders: normalizeHeaders(response.config.headers),
-        requestBody: treeViewerBridge.safeSerialize(response.config.data),
-        responseHeaders: normalizeHeaders(response.headers),
-        responseBody: treeViewerBridge.safeSerialize(response.data),
-        state: "success", duration: Date.now() - start, timestamp: start,
-      });
-      return response;
-    },
-    (error: any) => {
-      const cfg   = error?.config || {};
-      const id    = cfg[REQ_ID_KEY]    || treeViewerBridge.uid();
-      const start = cfg[REQ_START_KEY] || Date.now();
-      treeViewerBridge.send({
-        id, type: "network", transport: "axios",
-        method: (cfg.method || "get").toUpperCase(),
-        url: joinUrl(cfg.baseURL, cfg.url),
-        status: error?.response?.status,
-        requestHeaders: normalizeHeaders(cfg.headers),
-        requestBody: treeViewerBridge.safeSerialize(cfg.data),
-        responseHeaders: normalizeHeaders(error?.response?.headers),
-        responseBody: treeViewerBridge.safeSerialize(error?.response?.data),
-        state: "error", duration: Date.now() - start, timestamp: start,
-        error: treeViewerBridge.safeSerialize({ message: error?.message, code: error?.code, name: error?.name }),
-      });
-      return Promise.reject(error);
-    },
-  );
-}
-
-// ─── attachSocketIO — for socket.io-client instances ─────────────────────────
-// React Native uses socket.io which doesn't go through globalThis.WebSocket.
-// Usage: import { attachSocketIO } from "./codetraxisAgent";
-//        attachSocketIO(socket);  // call after getChatSocket() or io()
-export function attachSocketIO(socket: any): void {
-  if (!socket) return;
-
-  const INSTALLED_KEY = "__tv_sio_installed__";
-  if (socket[INSTALLED_KEY]) return;
-  socket[INSTALLED_KEY] = true;
-
-  const url: string = socket.io?.uri ?? socket.nsp ?? "socket.io";
-
-  // ── Incoming events ──────────────────────────────────────────────────────
-  socket.onAny((event: string, ...args: unknown[]) => {
-    treeViewerBridge.send({
-      id: treeViewerBridge.uid(),
-      type: "network",
-      transport: "websocket",
-      url,
-      method: "MESSAGE",
-      responseBody: treeViewerBridge.truncate(
-        JSON.stringify({ event, data: args.length === 1 ? args[0] : args }),
-      ),
-      state: "success",
-      timestamp: Date.now(),
-    });
-  });
-
-  // ── Outgoing events ──────────────────────────────────────────────────────
-  const origEmit = socket.emit.bind(socket);
-  socket.emit = (event: string, ...args: unknown[]) => {
-    if (!["ping", "pong"].includes(event)) {
-      treeViewerBridge.send({
-        id: treeViewerBridge.uid(),
-        type: "network",
-        transport: "websocket",
-        url,
-        method: "SEND",
-        requestBody: treeViewerBridge.truncate(
-          JSON.stringify({ event, data: args[0] }),
-        ),
-        state: "success",
-        timestamp: Date.now(),
-      });
-    }
-    return origEmit(event, ...args);
-  };
-}
-
-export {};
-`.replace("__PORT__", "${process.env.PORT ?? '3333'}");
-}