codetraxis 1.0.1 → 1.0.2

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

@@ -432,7 +432,7 @@ async function installAgent(targetDir) {
             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, buildHtmlAgentBundle(port), "utf-8");
+            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");
@@ -564,239 +564,14 @@ async function removeAgent(targetDir) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// HTML patching helpers (for CRA / plain-web projects with public/index.html)
-// ─────────────────────────────────────────────────────────────────────────────
-/** 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`;
-}
-/** Build a self-contained IIFE bundle (no import/export) for injection via <script>. */
-function buildHtmlAgentBundle(serverPort) {
-    // We inline shared + interceptors as one IIFE so it works in any plain HTML page
-    // without a bundler or module system.
-    return `/**
- * codetraxis debug agent — standalone bundle (auto-generated, do not edit).
- * Injected into public/index.html via <script src="/codetraxisAgent.js">.
- */
-(function () {
-  'use strict';
-
-  // ─── bridge ────────────────────────────────────────────────────────────────
-  var PORT = '${serverPort}';
-  var WS_URL = 'ws://localhost:' + PORT + '/agent';
-  var MAX_LEN = 20000;
-  var _ws = null;
-  var _queue = [];
-  var _reconnectTimer = null;
-
-  function connect() {
-    try {
-      _ws = new WebSocket(WS_URL);
-      _ws.onopen = function () {
-        var q = _queue.splice(0);
-        for (var i = 0; i < q.length; i++) _ws.send(q[i]);
-      };
-      _ws.onclose = function () {
-        _ws = null;
-        if (!_reconnectTimer) {
-          _reconnectTimer = setTimeout(function () { _reconnectTimer = null; connect(); }, 3000);
-        }
-      };
-      _ws.onerror = function () { /* suppress */ };
-    } catch (e) { /* WebSocket not available */ }
-  }
-
-  connect();
-
-  var _uid = 0;
-  function uid() { return 'h' + (++_uid) + '_' + Date.now(); }
-
-  function truncate(s) {
-    if (typeof s !== 'string') return s;
-    return s.length > MAX_LEN ? s.slice(0, MAX_LEN) + '…[truncated]' : s;
-  }
-
-  function safeSerialize(v) {
-    if (v === undefined || v === null) return undefined;
-    if (typeof v === 'string') return truncate(v);
-    try { return truncate(JSON.stringify(v)); } catch { return '[unserializable]'; }
-  }
-
-  function send(msg) {
-    try {
-      var s = JSON.stringify(msg);
-      if (_ws && _ws.readyState === 1 /* OPEN */) {
-        _ws.send(s);
-      } else {
-        _queue.push(s);
-      }
-    } catch { /* ignore */ }
-  }
-
-  var bridge = { uid: uid, truncate: truncate, safeSerialize: safeSerialize, send: send };
-
-  // ─── console interceptor ───────────────────────────────────────────────────
-  var LEVELS = ['log', 'warn', 'error', 'info', 'debug'];
-  LEVELS.forEach(function (level) {
-    var orig = console[level].bind(console);
-    console[level] = function () {
-      orig.apply(console, arguments);
-      try {
-        var args = Array.prototype.slice.call(arguments);
-        bridge.send({
-          id: bridge.uid(), type: 'console', level: level, timestamp: Date.now(),
-          args: args.map(function (a) { return bridge.safeSerialize(a); }),
-        });
-      } catch { /* ignore */ }
-    };
-  });
-
-  // ─── fetch interceptor ─────────────────────────────────────────────────────
-  if (typeof fetch !== 'undefined') {
-    var _origFetch = fetch;
-    fetch = function (input, init) {
-      var id    = bridge.uid();
-      var start = Date.now();
-      var method  = (init && init.method ? init.method : 'GET').toUpperCase();
-      var url     = typeof input === 'string' ? input : input instanceof URL ? input.toString() : (input.url || String(input));
-      var reqBody = init && init.body != null ? bridge.truncate(String(init.body)) : undefined;
-      var reqHeaders;
-      try {
-        if (init && init.headers) {
-          reqHeaders = {};
-          var h = new Headers(init.headers);
-          h.forEach(function (v, k) { reqHeaders[k] = v; });
-        }
-      } catch { /* ignore */ }
-
-      bridge.send({ id: id, type: 'network', transport: 'fetch', method: method, url: url,
-        requestBody: reqBody, requestHeaders: reqHeaders, state: 'pending', timestamp: start });
-
-      return _origFetch.call(this, input, init).then(function (response) {
-        var cloned = response.clone();
-        var resHeaders = {};
-        try { response.headers.forEach(function (v, k) { resHeaders[k] = v; }); } catch { /* ignore */ }
-        cloned.text().then(function (body) {
-          bridge.send({ id: id, type: 'network', transport: 'fetch', method: method, url: url,
-            status: response.status, requestBody: reqBody, requestHeaders: reqHeaders,
-            responseBody: bridge.truncate(body), responseHeaders: resHeaders,
-            state: response.ok ? 'success' : 'error',
-            duration: Date.now() - start, timestamp: start });
-        }).catch(function () {
-          bridge.send({ id: id, type: 'network', transport: 'fetch', method: method, url: url,
-            status: response.status, requestBody: reqBody, requestHeaders: reqHeaders,
-            responseHeaders: resHeaders,
-            state: response.ok ? 'success' : 'error',
-            duration: Date.now() - start, timestamp: start });
-        });
-        return response;
-      }).catch(function (err) {
-        bridge.send({ id: id, type: 'network', transport: 'fetch', method: method, url: url,
-          requestBody: reqBody, requestHeaders: reqHeaders,
-          state: 'error', duration: Date.now() - start, timestamp: start });
-        throw err;
-      });
-    };
-  }
-
-  // ─── XHR interceptor ──────────────────────────────────────────────────────
-  try {
-    var proto = XMLHttpRequest.prototype;
-    var _origOpen = proto.open;
-    proto.open = function (method, url) {
-      this.__tv_method = method.toUpperCase();
-      this.__tv_url    = String(url);
-      return _origOpen.apply(this, arguments);
-    };
-    var _origSetHeader = proto.setRequestHeader;
-    proto.setRequestHeader = function (name, value) {
-      if (!this.__tv_reqHeaders) this.__tv_reqHeaders = {};
-      this.__tv_reqHeaders[name] = value;
-      return _origSetHeader.apply(this, arguments);
-    };
-    var _origSend = proto.send;
-    proto.send = function (body) {
-      var self     = this;
-      var id       = bridge.uid();
-      var method   = this.__tv_method  || 'GET';
-      var url      = this.__tv_url     || '';
-      var reqHeaders = this.__tv_reqHeaders;
-      var start    = Date.now();
-      var reqBody;
-      if (body != null) {
-        try {
-          reqBody = typeof body === 'string' ? bridge.truncate(body)
-            : body instanceof URLSearchParams ? bridge.truncate(body.toString())
-            : '[binary]';
-        } catch { /* ignore */ }
-      }
-      bridge.send({ id: id, type: 'network', transport: 'xhr', method: method, url: url,
-        requestBody: reqBody, requestHeaders: reqHeaders, state: 'pending', timestamp: start });
-
-      this.addEventListener('load', function () {
-        var resBody, resHeaders;
-        try { resBody = bridge.truncate(self.responseText); } catch { /* binary */ }
-        try {
-          var raw = self.getAllResponseHeaders();
-          if (raw) {
-            resHeaders = {};
-            raw.trim().split(/\r?\n/).forEach(function (line) {
-              var idx = line.indexOf(': ');
-              if (idx > 0) resHeaders[line.slice(0, idx).toLowerCase()] = line.slice(idx + 2);
-            });
-          }
-        } catch { /* ignore */ }
-        bridge.send({ id: id, type: 'network', transport: 'xhr', method: method, url: url,
-          status: self.status, requestBody: reqBody, requestHeaders: reqHeaders,
-          responseBody: resBody, responseHeaders: resHeaders,
-          state: self.status >= 200 && self.status < 400 ? 'success' : 'error',
-          duration: Date.now() - start, timestamp: start });
-      });
-      this.addEventListener('error', function () {
-        bridge.send({ id: id, type: 'network', transport: 'xhr', method: method, url: url,
-          requestBody: reqBody, requestHeaders: reqHeaders,
-          state: 'error', duration: Date.now() - start, timestamp: start });
-      });
-      return _origSend.apply(this, arguments);
-    };
-  } catch (e) { /* XHR not available */ }
-
-})();
-`;
-}
-// ─────────────────────────────────────────────────────────────────────────────
-// Agent source — modular architecture
+// Agent source location
 //
-// 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
+// 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
 // ─────────────────────────────────────────────────────────────────────────────
-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";
-    // 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.${ext}`), buildSharedSource(serverPort, useJs), "utf-8");
-    await promises_1.default.writeFile(node_path_1.default.join(interceptorsDir, `consoleInterceptor.${ext}`), buildConsoleInterceptorSource(useJs), "utf-8");
-    await promises_1.default.writeFile(node_path_1.default.join(interceptorsDir, `fetchInterceptor.${ext}`), buildFetchInterceptorSource(useJs), "utf-8");
-    await promises_1.default.writeFile(node_path_1.default.join(interceptorsDir, `xhrInterceptor.${ext}`), buildXhrInterceptorSource(useJs), "utf-8");
-    await promises_1.default.writeFile(node_path_1.default.join(agentDir, `index.${ext}`), buildAgentIndexSource(kind, serverPort, useJs), "utf-8");
-}
+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.
@@ -809,976 +584,102 @@ function stripTypescript(src) {
         .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`, `: number`, `: void`, `: unknown`, `: any`, `: never`
+        // remove inline type annotations: `: string`, `: boolean`, etc.
         .replace(/:\s*(string|number|boolean|void|unknown|any|never|null|undefined)\b/g, "")
-        // remove `: SomeInterface` / `: Record<...>` / `: Array<...>` etc. (complex types)
+        // 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 in function calls / declarations (simple)
+        // remove `<Type>` generic parameters
         .replace(/<[A-Z][A-Za-z0-9_, ]*>/g, "")
-        // clean up resulting double spaces / empty lines
+        // clean up resulting blank lines
         .replace(/\n{3,}/g, "\n\n")
         .trimEnd() + "\n";
 }
-// ─── shared.ts / shared.js ───────────────────────────────────────────────────
-function buildSharedSource(serverPort, useJs = false) {
-    if (useJs) {
-        return `/**
- * codetraxis agent — shared bridge (auto-generated, do not edit).
- */
-
-export function createTreeViewerBridge(serverPort) {
-  const g = globalThis;
-
-  const isWeb =
-    typeof g.document !== "undefined" &&
-    typeof g.addEventListener === "function";
-
-  let ws = null;
-  let wsReady = false;
-  const queue = [];
-
-  const getHost = () => {
-    if (typeof g.__TREE_VIEWER_HOST__ === "string" && g.__TREE_VIEWER_HOST__) {
-      return g.__TREE_VIEWER_HOST__;
-    }
-    if (isWeb && g.location?.hostname) return g.location.hostname;
-    return "localhost";
-  };
-
-  const connect = () => {
-    try {
-      const WS = typeof WebSocket !== "undefined" ? WebSocket : g.WebSocket;
-      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, max = 500000) =>
-    value.length > max ? \`\${value.slice(0, max)}…[truncated]\` : value;
-
-  const safeSerialize = (value, depth = 0) => {
-    if (depth > 4)                   return "[depth limit]";
-    if (value == null)               return value;
-    if (typeof value === "function") return \`[Function: \${value.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();
-    const walk = (obj, d) => {
-      if (seen.has(obj)) return "[circular]";
-      seen.add(obj);
-      const r = {};
-      let n = 0;
-      for (const k in obj) {
-        if (n++ > 500) { r["..."] = "[truncated]"; break; }
-        try { r[k] = safeSerialize(obj[k], d + 1); }
-        catch { r[k] = "[unserializable]"; }
-      }
-      return r;
-    };
-    return walk(value, depth);
-  };
-
-  const uid = () =>
-    \`\${Math.random().toString(36).slice(2)}\${Date.now().toString(36)}\`;
-
-  const send = (event) => {
-    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 };
-}
-`;
-    }
-    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;
+// ─── 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;
 }
-
-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 / .js ─────────────────────────────────────────────
-function buildConsoleInterceptorSource(useJs = false) {
-    if (useJs) {
-        return `/**
- * codetraxis agent — console interceptor (auto-generated, do not edit).
- */
-
-const INSTALLED_KEY = "__tv_console_installed__";
-
-export function setupConsoleInterceptor(bridge) {
-  const g = globalThis;
-  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"].forEach(level => {
-    console[level] = (...args) => {
-      original[level](...args);
-      bridge.send({
-        id: bridge.uid(),
-        type: "console",
-        level,
-        args: args.map(a => bridge.safeSerialize(a)),
-        timestamp: Date.now(),
-      });
-    };
-  });
-}
-`;
-    }
-    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 / .js ───────────────────────────────────────────────
-function buildFetchInterceptorSource(useJs = false) {
-    if (useJs) {
-        return `/**
- * codetraxis agent — fetch interceptor (auto-generated, do not edit).
- */
-
-const INSTALLED_KEY = "__tv_fetch_installed__";
-
-function normalizeHeaders(headers) {
-  if (!headers) return undefined;
-  const result = {};
-  try {
-    if (headers instanceof Headers) {
-      headers.forEach((v, k) => { result[k] = v; });
-    } else if (Array.isArray(headers)) {
-      headers.forEach(([k, v]) => { result[k] = v; });
-    } else {
-      Object.assign(result, headers);
-    }
-    return result;
-  } catch { return undefined; }
-}
-
-export function setupFetchInterceptor(bridge) {
-  const g = globalThis;
-  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, init) {
-    const url =
-      typeof input === "string" ? input
-      : input instanceof URL   ? input.href
-      : input.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;
-    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;
-      try {
-        responseHeaders = {};
-        response.headers.forEach((v, k) => { responseHeaders[k] = v; });
-      } catch { /* ignore */ }
-
-      let responseBody;
-      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;
-    }
-  };
-}
-`;
-    }
-    return `/**
- * codetraxis agent — fetch interceptor (auto-generated, do not edit).
- */
-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; }
+// ─────────────────────────────────────────────────────────────────────────────
+// Agent source — modular architecture
+//
+// 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, 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 });
+    // 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");
 }
-
-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]"; }
+/** 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>`);
     }
-
-    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;
+    if (/<\/head>/i.test(html)) {
+        return html.replace(/<\/head>/i, `  ${tag}\n</head>`);
     }
-  };
-}
-`;
-}
-// ─── xhrInterceptor.ts / .js ─────────────────────────────────────────────────
-function buildXhrInterceptorSource(useJs = false) {
-    if (useJs) {
-        return `/**
- * codetraxis agent — XHR interceptor (auto-generated, do not edit).
- */
-
-const INSTALLED_KEY = "__tv_xhr_installed__";
-
-export function setupXhrInterceptor(bridge) {
-  if (typeof XMLHttpRequest === "undefined") return;
-  const g = globalThis;
-  if (g[INSTALLED_KEY]) return;
-  g[INSTALLED_KEY] = true;
-
-  try {
-    const proto = XMLHttpRequest.prototype;
-
-    const _origOpen = proto.open;
-    proto.open = function(method, url, ...rest) {
-      this.__tv_method     = method.toUpperCase();
-      this.__tv_url        = String(url);
-      this.__tv_reqHeaders = undefined;
-      return _origOpen.apply(this, [method, url, ...rest]);
-    };
-
-    const _origSetHeader = proto.setRequestHeader;
-    proto.setRequestHeader = function(name, value) {
-      if (!this.__tv_reqHeaders) this.__tv_reqHeaders = {};
-      this.__tv_reqHeaders[name] = value;
-      return _origSetHeader.apply(this, [name, value]);
-    };
-
-    const _origSend = proto.send;
-    proto.send = function(body) {
-      const id         = bridge.uid();
-      const method     = this.__tv_method ?? "GET";
-      const url        = this.__tv_url    ?? "";
-      const reqHeaders = this.__tv_reqHeaders;
-      const start      = Date.now();
-
-      let requestBody;
-      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;
-        try { responseBody = bridge.truncate(this.responseText); } catch { /* binary */ }
-
-        let responseHeaders;
-        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 */ }
+    // No recognisable tags — just append
+    return html + `\n${tag}\n`;
 }
-`;
-    }
+/** 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 — 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).
+ * 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_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 });
-      });
+(function () {
+  'use strict';
 
-      this.addEventListener("error", () => {
-        bridge.send({ id, type: "network", transport: "xhr", method, url,
-          requestBody, requestHeaders: reqHeaders,
-          state: "error", duration: Date.now() - start, timestamp: start });
-      });
+${strip(shared)}
+${strip(console_)}
+${strip(fetch_)}
+${strip(xhr_)}
 
-      return _origSend.apply(this, [body]);
-    };
-  } catch { /* not available */ }
-}
+  const _bridge = createTreeViewerBridge("${serverPort}");
+  setupConsoleInterceptor(_bridge);
+  setupFetchInterceptor(_bridge);
+  setupXhrInterceptor(_bridge);
+})();
 `;
 }
-// ─── index.ts ─────────────────────────────────────────────────────────────────
-function buildAgentIndexSource(kind, serverPort, useJs = false) {
-    const isRn = kind === "expo" || kind === "react-native";
-    if (useJs) {
-        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 ──────────────────────────────────────
-try {
-  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) {
-  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, url) => {
-    if (!base) return url || "";
-    if (!url)  return base;
-    try { return new URL(url, base).toString(); } catch { return \`\${base}\${url}\`; }
-  };
-
-  const normalizeHeaders = (h) => {
-    if (!h) return undefined;
-    try {
-      if (typeof h.toJSON === "function") return h.toJSON();
-      return { ...h };
-    } catch { return undefined; }
-  };
-
-  instance.interceptors.request.use(
-    (config) => {
-      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) => {
-      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) => {
-      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) => {
-      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 ─────────────────────────
-// Usage: import { attachSocketIO } from "./codetraxisAgent";
-//        attachSocketIO(socket);
-export function attachSocketIO(socket) {
-  if (!socket) return;
-
-  const INSTALLED_KEY = "__tv_sio_installed__";
-  if (socket[INSTALLED_KEY]) return;
-  socket[INSTALLED_KEY] = true;
-
-  const url = socket.io?.uri ?? socket.nsp ?? "socket.io";
-
-  socket.onAny((event, ...args) => {
-    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(),
-    });
-  });
-
-  const origEmit = socket.emit.bind(socket);
-  socket.emit = (event, ...args) => {
-    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);
-  };
-}
-`.replace("__PORT__", serverPort);
-    }
-    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__", serverPort);
-}