crawlio-browser 1.3.0 → 1.4.0

package/dist/mcp-server/index.js

@@ -1,1540 +1,16 @@
 import {
-  __commonJS,
-  __toESM
-} from "./chunk-JSBRDJBE.js";
-
-// node_modules/ip-address/dist/common.js
-var require_common = __commonJS({
-  "node_modules/ip-address/dist/common.js"(exports) {
-    "use strict";
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.isInSubnet = isInSubnet;
-    exports.isCorrect = isCorrect;
-    exports.numberToPaddedHex = numberToPaddedHex;
-    exports.stringToPaddedHex = stringToPaddedHex;
-    exports.testBit = testBit;
-    function isInSubnet(address) {
-      if (this.subnetMask < address.subnetMask) {
-        return false;
-      }
-      if (this.mask(address.subnetMask) === address.mask()) {
-        return true;
-      }
-      return false;
-    }
-    function isCorrect(defaultBits) {
-      return function() {
-        if (this.addressMinusSuffix !== this.correctForm()) {
-          return false;
-        }
-        if (this.subnetMask === defaultBits && !this.parsedSubnet) {
-          return true;
-        }
-        return this.parsedSubnet === String(this.subnetMask);
-      };
-    }
-    function numberToPaddedHex(number) {
-      return number.toString(16).padStart(2, "0");
-    }
-    function stringToPaddedHex(numberString) {
-      return numberToPaddedHex(parseInt(numberString, 10));
-    }
-    function testBit(binaryValue, position) {
-      const { length } = binaryValue;
-      if (position > length) {
-        return false;
-      }
-      const positionInString = length - position;
-      return binaryValue.substring(positionInString, positionInString + 1) === "1";
-    }
-  }
-});
-
-// node_modules/ip-address/dist/v4/constants.js
-var require_constants = __commonJS({
-  "node_modules/ip-address/dist/v4/constants.js"(exports) {
-    "use strict";
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.RE_SUBNET_STRING = exports.RE_ADDRESS = exports.GROUPS = exports.BITS = void 0;
-    exports.BITS = 32;
-    exports.GROUPS = 4;
-    exports.RE_ADDRESS = /^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/g;
-    exports.RE_SUBNET_STRING = /\/\d{1,2}$/;
-  }
-});
-
-// node_modules/ip-address/dist/address-error.js
-var require_address_error = __commonJS({
-  "node_modules/ip-address/dist/address-error.js"(exports) {
-    "use strict";
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.AddressError = void 0;
-    var AddressError = class extends Error {
-      constructor(message, parseMessage) {
-        super(message);
-        this.name = "AddressError";
-        this.parseMessage = parseMessage;
-      }
-    };
-    exports.AddressError = AddressError;
-  }
-});
-
-// node_modules/ip-address/dist/ipv4.js
-var require_ipv4 = __commonJS({
-  "node_modules/ip-address/dist/ipv4.js"(exports) {
-    "use strict";
-    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      var desc = Object.getOwnPropertyDescriptor(m, k);
-      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-        desc = { enumerable: true, get: function() {
-          return m[k];
-        } };
-      }
-      Object.defineProperty(o, k2, desc);
-    }) : (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      o[k2] = m[k];
-    }));
-    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? (function(o, v) {
-      Object.defineProperty(o, "default", { enumerable: true, value: v });
-    }) : function(o, v) {
-      o["default"] = v;
-    });
-    var __importStar = exports && exports.__importStar || function(mod) {
-      if (mod && mod.__esModule) return mod;
-      var result = {};
-      if (mod != null) {
-        for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-      }
-      __setModuleDefault(result, mod);
-      return result;
-    };
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.Address4 = void 0;
-    var common = __importStar(require_common());
-    var constants = __importStar(require_constants());
-    var address_error_1 = require_address_error();
-    var Address4 = class _Address4 {
-      constructor(address) {
-        this.groups = constants.GROUPS;
-        this.parsedAddress = [];
-        this.parsedSubnet = "";
-        this.subnet = "/32";
-        this.subnetMask = 32;
-        this.v4 = true;
-        this.isCorrect = common.isCorrect(constants.BITS);
-        this.isInSubnet = common.isInSubnet;
-        this.address = address;
-        const subnet = constants.RE_SUBNET_STRING.exec(address);
-        if (subnet) {
-          this.parsedSubnet = subnet[0].replace("/", "");
-          this.subnetMask = parseInt(this.parsedSubnet, 10);
-          this.subnet = `/${this.subnetMask}`;
-          if (this.subnetMask < 0 || this.subnetMask > constants.BITS) {
-            throw new address_error_1.AddressError("Invalid subnet mask.");
-          }
-          address = address.replace(constants.RE_SUBNET_STRING, "");
-        }
-        this.addressMinusSuffix = address;
-        this.parsedAddress = this.parse(address);
-      }
-      static isValid(address) {
-        try {
-          new _Address4(address);
-          return true;
-        } catch (e) {
-          return false;
-        }
-      }
-      /*
-       * Parses a v4 address
-       */
-      parse(address) {
-        const groups = address.split(".");
-        if (!address.match(constants.RE_ADDRESS)) {
-          throw new address_error_1.AddressError("Invalid IPv4 address.");
-        }
-        return groups;
-      }
-      /**
-       * Returns the correct form of an address
-       * @memberof Address4
-       * @instance
-       * @returns {String}
-       */
-      correctForm() {
-        return this.parsedAddress.map((part) => parseInt(part, 10)).join(".");
-      }
-      /**
-       * Converts a hex string to an IPv4 address object
-       * @memberof Address4
-       * @static
-       * @param {string} hex - a hex string to convert
-       * @returns {Address4}
-       */
-      static fromHex(hex) {
-        const padded = hex.replace(/:/g, "").padStart(8, "0");
-        const groups = [];
-        let i;
-        for (i = 0; i < 8; i += 2) {
-          const h = padded.slice(i, i + 2);
-          groups.push(parseInt(h, 16));
-        }
-        return new _Address4(groups.join("."));
-      }
-      /**
-       * Converts an integer into a IPv4 address object
-       * @memberof Address4
-       * @static
-       * @param {integer} integer - a number to convert
-       * @returns {Address4}
-       */
-      static fromInteger(integer) {
-        return _Address4.fromHex(integer.toString(16));
-      }
-      /**
-       * Return an address from in-addr.arpa form
-       * @memberof Address4
-       * @static
-       * @param {string} arpaFormAddress - an 'in-addr.arpa' form ipv4 address
-       * @returns {Adress4}
-       * @example
-       * var address = Address4.fromArpa(42.2.0.192.in-addr.arpa.)
-       * address.correctForm(); // '192.0.2.42'
-       */
-      static fromArpa(arpaFormAddress) {
-        const leader = arpaFormAddress.replace(/(\.in-addr\.arpa)?\.$/, "");
-        const address = leader.split(".").reverse().join(".");
-        return new _Address4(address);
-      }
-      /**
-       * Converts an IPv4 address object to a hex string
-       * @memberof Address4
-       * @instance
-       * @returns {String}
-       */
-      toHex() {
-        return this.parsedAddress.map((part) => common.stringToPaddedHex(part)).join(":");
-      }
-      /**
-       * Converts an IPv4 address object to an array of bytes
-       * @memberof Address4
-       * @instance
-       * @returns {Array}
-       */
-      toArray() {
-        return this.parsedAddress.map((part) => parseInt(part, 10));
-      }
-      /**
-       * Converts an IPv4 address object to an IPv6 address group
-       * @memberof Address4
-       * @instance
-       * @returns {String}
-       */
-      toGroup6() {
-        const output = [];
-        let i;
-        for (i = 0; i < constants.GROUPS; i += 2) {
-          output.push(`${common.stringToPaddedHex(this.parsedAddress[i])}${common.stringToPaddedHex(this.parsedAddress[i + 1])}`);
-        }
-        return output.join(":");
-      }
-      /**
-       * Returns the address as a `bigint`
-       * @memberof Address4
-       * @instance
-       * @returns {bigint}
-       */
-      bigInt() {
-        return BigInt(`0x${this.parsedAddress.map((n) => common.stringToPaddedHex(n)).join("")}`);
-      }
-      /**
-       * Helper function getting start address.
-       * @memberof Address4
-       * @instance
-       * @returns {bigint}
-       */
-      _startAddress() {
-        return BigInt(`0b${this.mask() + "0".repeat(constants.BITS - this.subnetMask)}`);
-      }
-      /**
-       * The first address in the range given by this address' subnet.
-       * Often referred to as the Network Address.
-       * @memberof Address4
-       * @instance
-       * @returns {Address4}
-       */
-      startAddress() {
-        return _Address4.fromBigInt(this._startAddress());
-      }
-      /**
-       * The first host address in the range given by this address's subnet ie
-       * the first address after the Network Address
-       * @memberof Address4
-       * @instance
-       * @returns {Address4}
-       */
-      startAddressExclusive() {
-        const adjust = BigInt("1");
-        return _Address4.fromBigInt(this._startAddress() + adjust);
-      }
-      /**
-       * Helper function getting end address.
-       * @memberof Address4
-       * @instance
-       * @returns {bigint}
-       */
-      _endAddress() {
-        return BigInt(`0b${this.mask() + "1".repeat(constants.BITS - this.subnetMask)}`);
-      }
-      /**
-       * The last address in the range given by this address' subnet
-       * Often referred to as the Broadcast
-       * @memberof Address4
-       * @instance
-       * @returns {Address4}
-       */
-      endAddress() {
-        return _Address4.fromBigInt(this._endAddress());
-      }
-      /**
-       * The last host address in the range given by this address's subnet ie
-       * the last address prior to the Broadcast Address
-       * @memberof Address4
-       * @instance
-       * @returns {Address4}
-       */
-      endAddressExclusive() {
-        const adjust = BigInt("1");
-        return _Address4.fromBigInt(this._endAddress() - adjust);
-      }
-      /**
-       * Converts a BigInt to a v4 address object
-       * @memberof Address4
-       * @static
-       * @param {bigint} bigInt - a BigInt to convert
-       * @returns {Address4}
-       */
-      static fromBigInt(bigInt) {
-        return _Address4.fromHex(bigInt.toString(16));
-      }
-      /**
-       * Returns the first n bits of the address, defaulting to the
-       * subnet mask
-       * @memberof Address4
-       * @instance
-       * @returns {String}
-       */
-      mask(mask) {
-        if (mask === void 0) {
-          mask = this.subnetMask;
-        }
-        return this.getBitsBase2(0, mask);
-      }
-      /**
-       * Returns the bits in the given range as a base-2 string
-       * @memberof Address4
-       * @instance
-       * @returns {string}
-       */
-      getBitsBase2(start, end) {
-        return this.binaryZeroPad().slice(start, end);
-      }
-      /**
-       * Return the reversed ip6.arpa form of the address
-       * @memberof Address4
-       * @param {Object} options
-       * @param {boolean} options.omitSuffix - omit the "in-addr.arpa" suffix
-       * @instance
-       * @returns {String}
-       */
-      reverseForm(options) {
-        if (!options) {
-          options = {};
-        }
-        const reversed = this.correctForm().split(".").reverse().join(".");
-        if (options.omitSuffix) {
-          return reversed;
-        }
-        return `${reversed}.in-addr.arpa.`;
-      }
-      /**
-       * Returns true if the given address is a multicast address
-       * @memberof Address4
-       * @instance
-       * @returns {boolean}
-       */
-      isMulticast() {
-        return this.isInSubnet(new _Address4("224.0.0.0/4"));
-      }
-      /**
-       * Returns a zero-padded base-2 string representation of the address
-       * @memberof Address4
-       * @instance
-       * @returns {string}
-       */
-      binaryZeroPad() {
-        return this.bigInt().toString(2).padStart(constants.BITS, "0");
-      }
-      /**
-       * Groups an IPv4 address for inclusion at the end of an IPv6 address
-       * @returns {String}
-       */
-      groupForV6() {
-        const segments = this.parsedAddress;
-        return this.address.replace(constants.RE_ADDRESS, `<span class="hover-group group-v4 group-6">${segments.slice(0, 2).join(".")}</span>.<span class="hover-group group-v4 group-7">${segments.slice(2, 4).join(".")}</span>`);
-      }
-    };
-    exports.Address4 = Address4;
-  }
-});
-
-// node_modules/ip-address/dist/v6/constants.js
-var require_constants2 = __commonJS({
-  "node_modules/ip-address/dist/v6/constants.js"(exports) {
-    "use strict";
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.RE_URL_WITH_PORT = exports.RE_URL = exports.RE_ZONE_STRING = exports.RE_SUBNET_STRING = exports.RE_BAD_ADDRESS = exports.RE_BAD_CHARACTERS = exports.TYPES = exports.SCOPES = exports.GROUPS = exports.BITS = void 0;
-    exports.BITS = 128;
-    exports.GROUPS = 8;
-    exports.SCOPES = {
-      0: "Reserved",
-      1: "Interface local",
-      2: "Link local",
-      4: "Admin local",
-      5: "Site local",
-      8: "Organization local",
-      14: "Global",
-      15: "Reserved"
-    };
-    exports.TYPES = {
-      "ff01::1/128": "Multicast (All nodes on this interface)",
-      "ff01::2/128": "Multicast (All routers on this interface)",
-      "ff02::1/128": "Multicast (All nodes on this link)",
-      "ff02::2/128": "Multicast (All routers on this link)",
-      "ff05::2/128": "Multicast (All routers in this site)",
-      "ff02::5/128": "Multicast (OSPFv3 AllSPF routers)",
-      "ff02::6/128": "Multicast (OSPFv3 AllDR routers)",
-      "ff02::9/128": "Multicast (RIP routers)",
-      "ff02::a/128": "Multicast (EIGRP routers)",
-      "ff02::d/128": "Multicast (PIM routers)",
-      "ff02::16/128": "Multicast (MLDv2 reports)",
-      "ff01::fb/128": "Multicast (mDNSv6)",
-      "ff02::fb/128": "Multicast (mDNSv6)",
-      "ff05::fb/128": "Multicast (mDNSv6)",
-      "ff02::1:2/128": "Multicast (All DHCP servers and relay agents on this link)",
-      "ff05::1:2/128": "Multicast (All DHCP servers and relay agents in this site)",
-      "ff02::1:3/128": "Multicast (All DHCP servers on this link)",
-      "ff05::1:3/128": "Multicast (All DHCP servers in this site)",
-      "::/128": "Unspecified",
-      "::1/128": "Loopback",
-      "ff00::/8": "Multicast",
-      "fe80::/10": "Link-local unicast"
-    };
-    exports.RE_BAD_CHARACTERS = /([^0-9a-f:/%])/gi;
-    exports.RE_BAD_ADDRESS = /([0-9a-f]{5,}|:{3,}|[^:]:$|^:[^:]|\/$)/gi;
-    exports.RE_SUBNET_STRING = /\/\d{1,3}(?=%|$)/;
-    exports.RE_ZONE_STRING = /%.*$/;
-    exports.RE_URL = /^\[{0,1}([0-9a-f:]+)\]{0,1}/;
-    exports.RE_URL_WITH_PORT = /\[([0-9a-f:]+)\]:([0-9]{1,5})/;
-  }
-});
-
-// node_modules/ip-address/dist/v6/helpers.js
-var require_helpers = __commonJS({
-  "node_modules/ip-address/dist/v6/helpers.js"(exports) {
-    "use strict";
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.spanAllZeroes = spanAllZeroes;
-    exports.spanAll = spanAll;
-    exports.spanLeadingZeroes = spanLeadingZeroes;
-    exports.simpleGroup = simpleGroup;
-    function spanAllZeroes(s) {
-      return s.replace(/(0+)/g, '<span class="zero">$1</span>');
-    }
-    function spanAll(s, offset = 0) {
-      const letters = s.split("");
-      return letters.map((n, i) => `<span class="digit value-${n} position-${i + offset}">${spanAllZeroes(n)}</span>`).join("");
-    }
-    function spanLeadingZeroesSimple(group) {
-      return group.replace(/^(0+)/, '<span class="zero">$1</span>');
-    }
-    function spanLeadingZeroes(address) {
-      const groups = address.split(":");
-      return groups.map((g) => spanLeadingZeroesSimple(g)).join(":");
-    }
-    function simpleGroup(addressString, offset = 0) {
-      const groups = addressString.split(":");
-      return groups.map((g, i) => {
-        if (/group-v4/.test(g)) {
-          return g;
-        }
-        return `<span class="hover-group group-${i + offset}">${spanLeadingZeroesSimple(g)}</span>`;
-      });
-    }
-  }
-});
-
-// node_modules/ip-address/dist/v6/regular-expressions.js
-var require_regular_expressions = __commonJS({
-  "node_modules/ip-address/dist/v6/regular-expressions.js"(exports) {
-    "use strict";
-    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      var desc = Object.getOwnPropertyDescriptor(m, k);
-      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-        desc = { enumerable: true, get: function() {
-          return m[k];
-        } };
-      }
-      Object.defineProperty(o, k2, desc);
-    }) : (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      o[k2] = m[k];
-    }));
-    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? (function(o, v) {
-      Object.defineProperty(o, "default", { enumerable: true, value: v });
-    }) : function(o, v) {
-      o["default"] = v;
-    });
-    var __importStar = exports && exports.__importStar || function(mod) {
-      if (mod && mod.__esModule) return mod;
-      var result = {};
-      if (mod != null) {
-        for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-      }
-      __setModuleDefault(result, mod);
-      return result;
-    };
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.ADDRESS_BOUNDARY = void 0;
-    exports.groupPossibilities = groupPossibilities;
-    exports.padGroup = padGroup;
-    exports.simpleRegularExpression = simpleRegularExpression;
-    exports.possibleElisions = possibleElisions;
-    var v6 = __importStar(require_constants2());
-    function groupPossibilities(possibilities) {
-      return `(${possibilities.join("|")})`;
-    }
-    function padGroup(group) {
-      if (group.length < 4) {
-        return `0{0,${4 - group.length}}${group}`;
-      }
-      return group;
-    }
-    exports.ADDRESS_BOUNDARY = "[^A-Fa-f0-9:]";
-    function simpleRegularExpression(groups) {
-      const zeroIndexes = [];
-      groups.forEach((group, i) => {
-        const groupInteger = parseInt(group, 16);
-        if (groupInteger === 0) {
-          zeroIndexes.push(i);
-        }
-      });
-      const possibilities = zeroIndexes.map((zeroIndex) => groups.map((group, i) => {
-        if (i === zeroIndex) {
-          const elision = i === 0 || i === v6.GROUPS - 1 ? ":" : "";
-          return groupPossibilities([padGroup(group), elision]);
-        }
-        return padGroup(group);
-      }).join(":"));
-      possibilities.push(groups.map(padGroup).join(":"));
-      return groupPossibilities(possibilities);
-    }
-    function possibleElisions(elidedGroups, moreLeft, moreRight) {
-      const left = moreLeft ? "" : ":";
-      const right = moreRight ? "" : ":";
-      const possibilities = [];
-      if (!moreLeft && !moreRight) {
-        possibilities.push("::");
-      }
-      if (moreLeft && moreRight) {
-        possibilities.push("");
-      }
-      if (moreRight && !moreLeft || !moreRight && moreLeft) {
-        possibilities.push(":");
-      }
-      possibilities.push(`${left}(:0{1,4}){1,${elidedGroups - 1}}`);
-      possibilities.push(`(0{1,4}:){1,${elidedGroups - 1}}${right}`);
-      possibilities.push(`(0{1,4}:){${elidedGroups - 1}}0{1,4}`);
-      for (let groups = 1; groups < elidedGroups - 1; groups++) {
-        for (let position = 1; position < elidedGroups - groups; position++) {
-          possibilities.push(`(0{1,4}:){${position}}:(0{1,4}:){${elidedGroups - position - groups - 1}}0{1,4}`);
-        }
-      }
-      return groupPossibilities(possibilities);
-    }
-  }
-});
-
-// node_modules/ip-address/dist/ipv6.js
-var require_ipv6 = __commonJS({
-  "node_modules/ip-address/dist/ipv6.js"(exports) {
-    "use strict";
-    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      var desc = Object.getOwnPropertyDescriptor(m, k);
-      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-        desc = { enumerable: true, get: function() {
-          return m[k];
-        } };
-      }
-      Object.defineProperty(o, k2, desc);
-    }) : (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      o[k2] = m[k];
-    }));
-    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? (function(o, v) {
-      Object.defineProperty(o, "default", { enumerable: true, value: v });
-    }) : function(o, v) {
-      o["default"] = v;
-    });
-    var __importStar = exports && exports.__importStar || function(mod) {
-      if (mod && mod.__esModule) return mod;
-      var result = {};
-      if (mod != null) {
-        for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-      }
-      __setModuleDefault(result, mod);
-      return result;
-    };
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.Address6 = void 0;
-    var common = __importStar(require_common());
-    var constants4 = __importStar(require_constants());
-    var constants6 = __importStar(require_constants2());
-    var helpers = __importStar(require_helpers());
-    var ipv4_1 = require_ipv4();
-    var regular_expressions_1 = require_regular_expressions();
-    var address_error_1 = require_address_error();
-    var common_1 = require_common();
-    function assert(condition) {
-      if (!condition) {
-        throw new Error("Assertion failed.");
-      }
-    }
-    function addCommas(number) {
-      const r = /(\d+)(\d{3})/;
-      while (r.test(number)) {
-        number = number.replace(r, "$1,$2");
-      }
-      return number;
-    }
-    function spanLeadingZeroes4(n) {
-      n = n.replace(/^(0{1,})([1-9]+)$/, '<span class="parse-error">$1</span>$2');
-      n = n.replace(/^(0{1,})(0)$/, '<span class="parse-error">$1</span>$2');
-      return n;
-    }
-    function compact(address, slice) {
-      const s1 = [];
-      const s2 = [];
-      let i;
-      for (i = 0; i < address.length; i++) {
-        if (i < slice[0]) {
-          s1.push(address[i]);
-        } else if (i > slice[1]) {
-          s2.push(address[i]);
-        }
-      }
-      return s1.concat(["compact"]).concat(s2);
-    }
-    function paddedHex(octet) {
-      return parseInt(octet, 16).toString(16).padStart(4, "0");
-    }
-    function unsignByte(b) {
-      return b & 255;
-    }
-    var Address62 = class _Address6 {
-      constructor(address, optionalGroups) {
-        this.addressMinusSuffix = "";
-        this.parsedSubnet = "";
-        this.subnet = "/128";
-        this.subnetMask = 128;
-        this.v4 = false;
-        this.zone = "";
-        this.isInSubnet = common.isInSubnet;
-        this.isCorrect = common.isCorrect(constants6.BITS);
-        if (optionalGroups === void 0) {
-          this.groups = constants6.GROUPS;
-        } else {
-          this.groups = optionalGroups;
-        }
-        this.address = address;
-        const subnet = constants6.RE_SUBNET_STRING.exec(address);
-        if (subnet) {
-          this.parsedSubnet = subnet[0].replace("/", "");
-          this.subnetMask = parseInt(this.parsedSubnet, 10);
-          this.subnet = `/${this.subnetMask}`;
-          if (Number.isNaN(this.subnetMask) || this.subnetMask < 0 || this.subnetMask > constants6.BITS) {
-            throw new address_error_1.AddressError("Invalid subnet mask.");
-          }
-          address = address.replace(constants6.RE_SUBNET_STRING, "");
-        } else if (/\//.test(address)) {
-          throw new address_error_1.AddressError("Invalid subnet mask.");
-        }
-        const zone = constants6.RE_ZONE_STRING.exec(address);
-        if (zone) {
-          this.zone = zone[0];
-          address = address.replace(constants6.RE_ZONE_STRING, "");
-        }
-        this.addressMinusSuffix = address;
-        this.parsedAddress = this.parse(this.addressMinusSuffix);
-      }
-      static isValid(address) {
-        try {
-          new _Address6(address);
-          return true;
-        } catch (e) {
-          return false;
-        }
-      }
-      /**
-       * Convert a BigInt to a v6 address object
-       * @memberof Address6
-       * @static
-       * @param {bigint} bigInt - a BigInt to convert
-       * @returns {Address6}
-       * @example
-       * var bigInt = BigInt('1000000000000');
-       * var address = Address6.fromBigInt(bigInt);
-       * address.correctForm(); // '::e8:d4a5:1000'
-       */
-      static fromBigInt(bigInt) {
-        const hex = bigInt.toString(16).padStart(32, "0");
-        const groups = [];
-        let i;
-        for (i = 0; i < constants6.GROUPS; i++) {
-          groups.push(hex.slice(i * 4, (i + 1) * 4));
-        }
-        return new _Address6(groups.join(":"));
-      }
-      /**
-       * Convert a URL (with optional port number) to an address object
-       * @memberof Address6
-       * @static
-       * @param {string} url - a URL with optional port number
-       * @example
-       * var addressAndPort = Address6.fromURL('http://[ffff::]:8080/foo/');
-       * addressAndPort.address.correctForm(); // 'ffff::'
-       * addressAndPort.port; // 8080
-       */
-      static fromURL(url) {
-        let host;
-        let port = null;
-        let result;
-        if (url.indexOf("[") !== -1 && url.indexOf("]:") !== -1) {
-          result = constants6.RE_URL_WITH_PORT.exec(url);
-          if (result === null) {
-            return {
-              error: "failed to parse address with port",
-              address: null,
-              port: null
-            };
-          }
-          host = result[1];
-          port = result[2];
-        } else if (url.indexOf("/") !== -1) {
-          url = url.replace(/^[a-z0-9]+:\/\//, "");
-          result = constants6.RE_URL.exec(url);
-          if (result === null) {
-            return {
-              error: "failed to parse address from URL",
-              address: null,
-              port: null
-            };
-          }
-          host = result[1];
-        } else {
-          host = url;
-        }
-        if (port) {
-          port = parseInt(port, 10);
-          if (port < 0 || port > 65536) {
-            port = null;
-          }
-        } else {
-          port = null;
-        }
-        return {
-          address: new _Address6(host),
-          port
-        };
-      }
-      /**
-       * Create an IPv6-mapped address given an IPv4 address
-       * @memberof Address6
-       * @static
-       * @param {string} address - An IPv4 address string
-       * @returns {Address6}
-       * @example
-       * var address = Address6.fromAddress4('192.168.0.1');
-       * address.correctForm(); // '::ffff:c0a8:1'
-       * address.to4in6(); // '::ffff:192.168.0.1'
-       */
-      static fromAddress4(address) {
-        const address4 = new ipv4_1.Address4(address);
-        const mask6 = constants6.BITS - (constants4.BITS - address4.subnetMask);
-        return new _Address6(`::ffff:${address4.correctForm()}/${mask6}`);
-      }
-      /**
-       * Return an address from ip6.arpa form
-       * @memberof Address6
-       * @static
-       * @param {string} arpaFormAddress - an 'ip6.arpa' form address
-       * @returns {Adress6}
-       * @example
-       * var address = Address6.fromArpa(e.f.f.f.3.c.2.6.f.f.f.e.6.6.8.e.1.0.6.7.9.4.e.c.0.0.0.0.1.0.0.2.ip6.arpa.)
-       * address.correctForm(); // '2001:0:ce49:7601:e866:efff:62c3:fffe'
-       */
-      static fromArpa(arpaFormAddress) {
-        let address = arpaFormAddress.replace(/(\.ip6\.arpa)?\.$/, "");
-        const semicolonAmount = 7;
-        if (address.length !== 63) {
-          throw new address_error_1.AddressError("Invalid 'ip6.arpa' form.");
-        }
-        const parts = address.split(".").reverse();
-        for (let i = semicolonAmount; i > 0; i--) {
-          const insertIndex = i * 4;
-          parts.splice(insertIndex, 0, ":");
-        }
-        address = parts.join("");
-        return new _Address6(address);
-      }
-      /**
-       * Return the Microsoft UNC transcription of the address
-       * @memberof Address6
-       * @instance
-       * @returns {String} the Microsoft UNC transcription of the address
-       */
-      microsoftTranscription() {
-        return `${this.correctForm().replace(/:/g, "-")}.ipv6-literal.net`;
-      }
-      /**
-       * Return the first n bits of the address, defaulting to the subnet mask
-       * @memberof Address6
-       * @instance
-       * @param {number} [mask=subnet] - the number of bits to mask
-       * @returns {String} the first n bits of the address as a string
-       */
-      mask(mask = this.subnetMask) {
-        return this.getBitsBase2(0, mask);
-      }
-      /**
-       * Return the number of possible subnets of a given size in the address
-       * @memberof Address6
-       * @instance
-       * @param {number} [subnetSize=128] - the subnet size
-       * @returns {String}
-       */
-      // TODO: probably useful to have a numeric version of this too
-      possibleSubnets(subnetSize = 128) {
-        const availableBits = constants6.BITS - this.subnetMask;
-        const subnetBits = Math.abs(subnetSize - constants6.BITS);
-        const subnetPowers = availableBits - subnetBits;
-        if (subnetPowers < 0) {
-          return "0";
-        }
-        return addCommas((BigInt("2") ** BigInt(subnetPowers)).toString(10));
-      }
-      /**
-       * Helper function getting start address.
-       * @memberof Address6
-       * @instance
-       * @returns {bigint}
-       */
-      _startAddress() {
-        return BigInt(`0b${this.mask() + "0".repeat(constants6.BITS - this.subnetMask)}`);
-      }
-      /**
-       * The first address in the range given by this address' subnet
-       * Often referred to as the Network Address.
-       * @memberof Address6
-       * @instance
-       * @returns {Address6}
-       */
-      startAddress() {
-        return _Address6.fromBigInt(this._startAddress());
-      }
-      /**
-       * The first host address in the range given by this address's subnet ie
-       * the first address after the Network Address
-       * @memberof Address6
-       * @instance
-       * @returns {Address6}
-       */
-      startAddressExclusive() {
-        const adjust = BigInt("1");
-        return _Address6.fromBigInt(this._startAddress() + adjust);
-      }
-      /**
-       * Helper function getting end address.
-       * @memberof Address6
-       * @instance
-       * @returns {bigint}
-       */
-      _endAddress() {
-        return BigInt(`0b${this.mask() + "1".repeat(constants6.BITS - this.subnetMask)}`);
-      }
-      /**
-       * The last address in the range given by this address' subnet
-       * Often referred to as the Broadcast
-       * @memberof Address6
-       * @instance
-       * @returns {Address6}
-       */
-      endAddress() {
-        return _Address6.fromBigInt(this._endAddress());
-      }
-      /**
-       * The last host address in the range given by this address's subnet ie
-       * the last address prior to the Broadcast Address
-       * @memberof Address6
-       * @instance
-       * @returns {Address6}
-       */
-      endAddressExclusive() {
-        const adjust = BigInt("1");
-        return _Address6.fromBigInt(this._endAddress() - adjust);
-      }
-      /**
-       * Return the scope of the address
-       * @memberof Address6
-       * @instance
-       * @returns {String}
-       */
-      getScope() {
-        let scope = constants6.SCOPES[parseInt(this.getBits(12, 16).toString(10), 10)];
-        if (this.getType() === "Global unicast" && scope !== "Link local") {
-          scope = "Global";
-        }
-        return scope || "Unknown";
-      }
-      /**
-       * Return the type of the address
-       * @memberof Address6
-       * @instance
-       * @returns {String}
-       */
-      getType() {
-        for (const subnet of Object.keys(constants6.TYPES)) {
-          if (this.isInSubnet(new _Address6(subnet))) {
-            return constants6.TYPES[subnet];
-          }
-        }
-        return "Global unicast";
-      }
-      /**
-       * Return the bits in the given range as a BigInt
-       * @memberof Address6
-       * @instance
-       * @returns {bigint}
-       */
-      getBits(start, end) {
-        return BigInt(`0b${this.getBitsBase2(start, end)}`);
-      }
-      /**
-       * Return the bits in the given range as a base-2 string
-       * @memberof Address6
-       * @instance
-       * @returns {String}
-       */
-      getBitsBase2(start, end) {
-        return this.binaryZeroPad().slice(start, end);
-      }
-      /**
-       * Return the bits in the given range as a base-16 string
-       * @memberof Address6
-       * @instance
-       * @returns {String}
-       */
-      getBitsBase16(start, end) {
-        const length = end - start;
-        if (length % 4 !== 0) {
-          throw new Error("Length of bits to retrieve must be divisible by four");
-        }
-        return this.getBits(start, end).toString(16).padStart(length / 4, "0");
-      }
-      /**
-       * Return the bits that are set past the subnet mask length
-       * @memberof Address6
-       * @instance
-       * @returns {String}
-       */
-      getBitsPastSubnet() {
-        return this.getBitsBase2(this.subnetMask, constants6.BITS);
-      }
-      /**
-       * Return the reversed ip6.arpa form of the address
-       * @memberof Address6
-       * @param {Object} options
-       * @param {boolean} options.omitSuffix - omit the "ip6.arpa" suffix
-       * @instance
-       * @returns {String}
-       */
-      reverseForm(options) {
-        if (!options) {
-          options = {};
-        }
-        const characters = Math.floor(this.subnetMask / 4);
-        const reversed = this.canonicalForm().replace(/:/g, "").split("").slice(0, characters).reverse().join(".");
-        if (characters > 0) {
-          if (options.omitSuffix) {
-            return reversed;
-          }
-          return `${reversed}.ip6.arpa.`;
-        }
-        if (options.omitSuffix) {
-          return "";
-        }
-        return "ip6.arpa.";
-      }
-      /**
-       * Return the correct form of the address
-       * @memberof Address6
-       * @instance
-       * @returns {String}
-       */
-      correctForm() {
-        let i;
-        let groups = [];
-        let zeroCounter = 0;
-        const zeroes = [];
-        for (i = 0; i < this.parsedAddress.length; i++) {
-          const value = parseInt(this.parsedAddress[i], 16);
-          if (value === 0) {
-            zeroCounter++;
-          }
-          if (value !== 0 && zeroCounter > 0) {
-            if (zeroCounter > 1) {
-              zeroes.push([i - zeroCounter, i - 1]);
-            }
-            zeroCounter = 0;
-          }
-        }
-        if (zeroCounter > 1) {
-          zeroes.push([this.parsedAddress.length - zeroCounter, this.parsedAddress.length - 1]);
-        }
-        const zeroLengths = zeroes.map((n) => n[1] - n[0] + 1);
-        if (zeroes.length > 0) {
-          const index = zeroLengths.indexOf(Math.max(...zeroLengths));
-          groups = compact(this.parsedAddress, zeroes[index]);
-        } else {
-          groups = this.parsedAddress;
-        }
-        for (i = 0; i < groups.length; i++) {
-          if (groups[i] !== "compact") {
-            groups[i] = parseInt(groups[i], 16).toString(16);
-          }
-        }
-        let correct = groups.join(":");
-        correct = correct.replace(/^compact$/, "::");
-        correct = correct.replace(/(^compact)|(compact$)/, ":");
-        correct = correct.replace(/compact/, "");
-        return correct;
-      }
-      /**
-       * Return a zero-padded base-2 string representation of the address
-       * @memberof Address6
-       * @instance
-       * @returns {String}
-       * @example
-       * var address = new Address6('2001:4860:4001:803::1011');
-       * address.binaryZeroPad();
-       * // '0010000000000001010010000110000001000000000000010000100000000011
-       * //  0000000000000000000000000000000000000000000000000001000000010001'
-       */
-      binaryZeroPad() {
-        return this.bigInt().toString(2).padStart(constants6.BITS, "0");
-      }
-      // TODO: Improve the semantics of this helper function
-      parse4in6(address) {
-        const groups = address.split(":");
-        const lastGroup = groups.slice(-1)[0];
-        const address4 = lastGroup.match(constants4.RE_ADDRESS);
-        if (address4) {
-          this.parsedAddress4 = address4[0];
-          this.address4 = new ipv4_1.Address4(this.parsedAddress4);
-          for (let i = 0; i < this.address4.groups; i++) {
-            if (/^0[0-9]+/.test(this.address4.parsedAddress[i])) {
-              throw new address_error_1.AddressError("IPv4 addresses can't have leading zeroes.", address.replace(constants4.RE_ADDRESS, this.address4.parsedAddress.map(spanLeadingZeroes4).join(".")));
-            }
-          }
-          this.v4 = true;
-          groups[groups.length - 1] = this.address4.toGroup6();
-          address = groups.join(":");
-        }
-        return address;
-      }
-      // TODO: Make private?
-      parse(address) {
-        address = this.parse4in6(address);
-        const badCharacters = address.match(constants6.RE_BAD_CHARACTERS);
-        if (badCharacters) {
-          throw new address_error_1.AddressError(`Bad character${badCharacters.length > 1 ? "s" : ""} detected in address: ${badCharacters.join("")}`, address.replace(constants6.RE_BAD_CHARACTERS, '<span class="parse-error">$1</span>'));
-        }
-        const badAddress = address.match(constants6.RE_BAD_ADDRESS);
-        if (badAddress) {
-          throw new address_error_1.AddressError(`Address failed regex: ${badAddress.join("")}`, address.replace(constants6.RE_BAD_ADDRESS, '<span class="parse-error">$1</span>'));
-        }
-        let groups = [];
-        const halves = address.split("::");
-        if (halves.length === 2) {
-          let first = halves[0].split(":");
-          let last = halves[1].split(":");
-          if (first.length === 1 && first[0] === "") {
-            first = [];
-          }
-          if (last.length === 1 && last[0] === "") {
-            last = [];
-          }
-          const remaining = this.groups - (first.length + last.length);
-          if (!remaining) {
-            throw new address_error_1.AddressError("Error parsing groups");
-          }
-          this.elidedGroups = remaining;
-          this.elisionBegin = first.length;
-          this.elisionEnd = first.length + this.elidedGroups;
-          groups = groups.concat(first);
-          for (let i = 0; i < remaining; i++) {
-            groups.push("0");
-          }
-          groups = groups.concat(last);
-        } else if (halves.length === 1) {
-          groups = address.split(":");
-          this.elidedGroups = 0;
-        } else {
-          throw new address_error_1.AddressError("Too many :: groups found");
-        }
-        groups = groups.map((group) => parseInt(group, 16).toString(16));
-        if (groups.length !== this.groups) {
-          throw new address_error_1.AddressError("Incorrect number of groups found");
-        }
-        return groups;
-      }
-      /**
-       * Return the canonical form of the address
-       * @memberof Address6
-       * @instance
-       * @returns {String}
-       */
-      canonicalForm() {
-        return this.parsedAddress.map(paddedHex).join(":");
-      }
-      /**
-       * Return the decimal form of the address
-       * @memberof Address6
-       * @instance
-       * @returns {String}
-       */
-      decimal() {
-        return this.parsedAddress.map((n) => parseInt(n, 16).toString(10).padStart(5, "0")).join(":");
-      }
-      /**
-       * Return the address as a BigInt
-       * @memberof Address6
-       * @instance
-       * @returns {bigint}
-       */
-      bigInt() {
-        return BigInt(`0x${this.parsedAddress.map(paddedHex).join("")}`);
-      }
-      /**
-       * Return the last two groups of this address as an IPv4 address string
-       * @memberof Address6
-       * @instance
-       * @returns {Address4}
-       * @example
-       * var address = new Address6('2001:4860:4001::1825:bf11');
-       * address.to4().correctForm(); // '24.37.191.17'
-       */
-      to4() {
-        const binary = this.binaryZeroPad().split("");
-        return ipv4_1.Address4.fromHex(BigInt(`0b${binary.slice(96, 128).join("")}`).toString(16));
-      }
-      /**
-       * Return the v4-in-v6 form of the address
-       * @memberof Address6
-       * @instance
-       * @returns {String}
-       */
-      to4in6() {
-        const address4 = this.to4();
-        const address6 = new _Address6(this.parsedAddress.slice(0, 6).join(":"), 6);
-        const correct = address6.correctForm();
-        let infix = "";
-        if (!/:$/.test(correct)) {
-          infix = ":";
-        }
-        return correct + infix + address4.address;
-      }
-      /**
-       * Return an object containing the Teredo properties of the address
-       * @memberof Address6
-       * @instance
-       * @returns {Object}
-       */
-      inspectTeredo() {
-        const prefix = this.getBitsBase16(0, 32);
-        const bitsForUdpPort = this.getBits(80, 96);
-        const udpPort = (bitsForUdpPort ^ BigInt("0xffff")).toString();
-        const server4 = ipv4_1.Address4.fromHex(this.getBitsBase16(32, 64));
-        const bitsForClient4 = this.getBits(96, 128);
-        const client4 = ipv4_1.Address4.fromHex((bitsForClient4 ^ BigInt("0xffffffff")).toString(16));
-        const flagsBase2 = this.getBitsBase2(64, 80);
-        const coneNat = (0, common_1.testBit)(flagsBase2, 15);
-        const reserved = (0, common_1.testBit)(flagsBase2, 14);
-        const groupIndividual = (0, common_1.testBit)(flagsBase2, 8);
-        const universalLocal = (0, common_1.testBit)(flagsBase2, 9);
-        const nonce = BigInt(`0b${flagsBase2.slice(2, 6) + flagsBase2.slice(8, 16)}`).toString(10);
-        return {
-          prefix: `${prefix.slice(0, 4)}:${prefix.slice(4, 8)}`,
-          server4: server4.address,
-          client4: client4.address,
-          flags: flagsBase2,
-          coneNat,
-          microsoft: {
-            reserved,
-            universalLocal,
-            groupIndividual,
-            nonce
-          },
-          udpPort
-        };
-      }
-      /**
-       * Return an object containing the 6to4 properties of the address
-       * @memberof Address6
-       * @instance
-       * @returns {Object}
-       */
-      inspect6to4() {
-        const prefix = this.getBitsBase16(0, 16);
-        const gateway = ipv4_1.Address4.fromHex(this.getBitsBase16(16, 48));
-        return {
-          prefix: prefix.slice(0, 4),
-          gateway: gateway.address
-        };
-      }
-      /**
-       * Return a v6 6to4 address from a v6 v4inv6 address
-       * @memberof Address6
-       * @instance
-       * @returns {Address6}
-       */
-      to6to4() {
-        if (!this.is4()) {
-          return null;
-        }
-        const addr6to4 = [
-          "2002",
-          this.getBitsBase16(96, 112),
-          this.getBitsBase16(112, 128),
-          "",
-          "/16"
-        ].join(":");
-        return new _Address6(addr6to4);
-      }
-      /**
-       * Return a byte array
-       * @memberof Address6
-       * @instance
-       * @returns {Array}
-       */
-      toByteArray() {
-        const valueWithoutPadding = this.bigInt().toString(16);
-        const leadingPad = "0".repeat(valueWithoutPadding.length % 2);
-        const value = `${leadingPad}${valueWithoutPadding}`;
-        const bytes = [];
-        for (let i = 0, length = value.length; i < length; i += 2) {
-          bytes.push(parseInt(value.substring(i, i + 2), 16));
-        }
-        return bytes;
-      }
-      /**
-       * Return an unsigned byte array
-       * @memberof Address6
-       * @instance
-       * @returns {Array}
-       */
-      toUnsignedByteArray() {
-        return this.toByteArray().map(unsignByte);
-      }
-      /**
-       * Convert a byte array to an Address6 object
-       * @memberof Address6
-       * @static
-       * @returns {Address6}
-       */
-      static fromByteArray(bytes) {
-        return this.fromUnsignedByteArray(bytes.map(unsignByte));
-      }
-      /**
-       * Convert an unsigned byte array to an Address6 object
-       * @memberof Address6
-       * @static
-       * @returns {Address6}
-       */
-      static fromUnsignedByteArray(bytes) {
-        const BYTE_MAX = BigInt("256");
-        let result = BigInt("0");
-        let multiplier = BigInt("1");
-        for (let i = bytes.length - 1; i >= 0; i--) {
-          result += multiplier * BigInt(bytes[i].toString(10));
-          multiplier *= BYTE_MAX;
-        }
-        return _Address6.fromBigInt(result);
-      }
-      /**
-       * Returns true if the address is in the canonical form, false otherwise
-       * @memberof Address6
-       * @instance
-       * @returns {boolean}
-       */
-      isCanonical() {
-        return this.addressMinusSuffix === this.canonicalForm();
-      }
-      /**
-       * Returns true if the address is a link local address, false otherwise
-       * @memberof Address6
-       * @instance
-       * @returns {boolean}
-       */
-      isLinkLocal() {
-        if (this.getBitsBase2(0, 64) === "1111111010000000000000000000000000000000000000000000000000000000") {
-          return true;
-        }
-        return false;
-      }
-      /**
-       * Returns true if the address is a multicast address, false otherwise
-       * @memberof Address6
-       * @instance
-       * @returns {boolean}
-       */
-      isMulticast() {
-        return this.getType() === "Multicast";
-      }
-      /**
-       * Returns true if the address is a v4-in-v6 address, false otherwise
-       * @memberof Address6
-       * @instance
-       * @returns {boolean}
-       */
-      is4() {
-        return this.v4;
-      }
-      /**
-       * Returns true if the address is a Teredo address, false otherwise
-       * @memberof Address6
-       * @instance
-       * @returns {boolean}
-       */
-      isTeredo() {
-        return this.isInSubnet(new _Address6("2001::/32"));
-      }
-      /**
-       * Returns true if the address is a 6to4 address, false otherwise
-       * @memberof Address6
-       * @instance
-       * @returns {boolean}
-       */
-      is6to4() {
-        return this.isInSubnet(new _Address6("2002::/16"));
-      }
-      /**
-       * Returns true if the address is a loopback address, false otherwise
-       * @memberof Address6
-       * @instance
-       * @returns {boolean}
-       */
-      isLoopback() {
-        return this.getType() === "Loopback";
-      }
-      // #endregion
-      // #region HTML
-      /**
-       * @returns {String} the address in link form with a default port of 80
-       */
-      href(optionalPort) {
-        if (optionalPort === void 0) {
-          optionalPort = "";
-        } else {
-          optionalPort = `:${optionalPort}`;
-        }
-        return `http://[${this.correctForm()}]${optionalPort}/`;
-      }
-      /**
-       * @returns {String} a link suitable for conveying the address via a URL hash
-       */
-      link(options) {
-        if (!options) {
-          options = {};
-        }
-        if (options.className === void 0) {
-          options.className = "";
-        }
-        if (options.prefix === void 0) {
-          options.prefix = "/#address=";
-        }
-        if (options.v4 === void 0) {
-          options.v4 = false;
-        }
-        let formFunction = this.correctForm;
-        if (options.v4) {
-          formFunction = this.to4in6;
-        }
-        const form = formFunction.call(this);
-        if (options.className) {
-          return `<a href="${options.prefix}${form}" class="${options.className}">${form}</a>`;
-        }
-        return `<a href="${options.prefix}${form}">${form}</a>`;
-      }
-      /**
-       * Groups an address
-       * @returns {String}
-       */
-      group() {
-        if (this.elidedGroups === 0) {
-          return helpers.simpleGroup(this.address).join(":");
-        }
-        assert(typeof this.elidedGroups === "number");
-        assert(typeof this.elisionBegin === "number");
-        const output = [];
-        const [left, right] = this.address.split("::");
-        if (left.length) {
-          output.push(...helpers.simpleGroup(left));
-        } else {
-          output.push("");
-        }
-        const classes = ["hover-group"];
-        for (let i = this.elisionBegin; i < this.elisionBegin + this.elidedGroups; i++) {
-          classes.push(`group-${i}`);
-        }
-        output.push(`<span class="${classes.join(" ")}"></span>`);
-        if (right.length) {
-          output.push(...helpers.simpleGroup(right, this.elisionEnd));
-        } else {
-          output.push("");
-        }
-        if (this.is4()) {
-          assert(this.address4 instanceof ipv4_1.Address4);
-          output.pop();
-          output.push(this.address4.groupForV6());
-        }
-        return output.join(":");
-      }
-      // #endregion
-      // #region Regular expressions
-      /**
-       * Generate a regular expression string that can be used to find or validate
-       * all variations of this address
-       * @memberof Address6
-       * @instance
-       * @param {boolean} substringSearch
-       * @returns {string}
-       */
-      regularExpressionString(substringSearch = false) {
-        let output = [];
-        const address6 = new _Address6(this.correctForm());
-        if (address6.elidedGroups === 0) {
-          output.push((0, regular_expressions_1.simpleRegularExpression)(address6.parsedAddress));
-        } else if (address6.elidedGroups === constants6.GROUPS) {
-          output.push((0, regular_expressions_1.possibleElisions)(constants6.GROUPS));
-        } else {
-          const halves = address6.address.split("::");
-          if (halves[0].length) {
-            output.push((0, regular_expressions_1.simpleRegularExpression)(halves[0].split(":")));
-          }
-          assert(typeof address6.elidedGroups === "number");
-          output.push((0, regular_expressions_1.possibleElisions)(address6.elidedGroups, halves[0].length !== 0, halves[1].length !== 0));
-          if (halves[1].length) {
-            output.push((0, regular_expressions_1.simpleRegularExpression)(halves[1].split(":")));
-          }
-          output = [output.join(":")];
-        }
-        if (!substringSearch) {
-          output = [
-            "(?=^|",
-            regular_expressions_1.ADDRESS_BOUNDARY,
-            "|[^\\w\\:])(",
-            ...output,
-            ")(?=[^\\w\\:]|",
-            regular_expressions_1.ADDRESS_BOUNDARY,
-            "|$)"
-          ];
-        }
-        return output.join("");
-      }
-      /**
-       * Generate a regular expression that can be used to find or validate all
-       * variations of this address.
-       * @memberof Address6
-       * @instance
-       * @param {boolean} substringSearch
-       * @returns {RegExp}
-       */
-      regularExpression(substringSearch = false) {
-        return new RegExp(this.regularExpressionString(substringSearch), "i");
-      }
-    };
-    exports.Address6 = Address62;
-  }
-});
-
-// node_modules/ip-address/dist/ip-address.js
-var require_ip_address = __commonJS({
-  "node_modules/ip-address/dist/ip-address.js"(exports) {
-    "use strict";
-    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      var desc = Object.getOwnPropertyDescriptor(m, k);
-      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-        desc = { enumerable: true, get: function() {
-          return m[k];
-        } };
-      }
-      Object.defineProperty(o, k2, desc);
-    }) : (function(o, m, k, k2) {
-      if (k2 === void 0) k2 = k;
-      o[k2] = m[k];
-    }));
-    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? (function(o, v) {
-      Object.defineProperty(o, "default", { enumerable: true, value: v });
-    }) : function(o, v) {
-      o["default"] = v;
-    });
-    var __importStar = exports && exports.__importStar || function(mod) {
-      if (mod && mod.__esModule) return mod;
-      var result = {};
-      if (mod != null) {
-        for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-      }
-      __setModuleDefault(result, mod);
-      return result;
-    };
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.v6 = exports.AddressError = exports.Address6 = exports.Address4 = void 0;
-    var ipv4_1 = require_ipv4();
-    Object.defineProperty(exports, "Address4", { enumerable: true, get: function() {
-      return ipv4_1.Address4;
-    } });
-    var ipv6_1 = require_ipv6();
-    Object.defineProperty(exports, "Address6", { enumerable: true, get: function() {
-      return ipv6_1.Address6;
-    } });
-    var address_error_1 = require_address_error();
-    Object.defineProperty(exports, "AddressError", { enumerable: true, get: function() {
-      return address_error_1.AddressError;
-    } });
-    var helpers = __importStar(require_helpers());
-    exports.v6 = { helpers };
-  }
-});
+  CRAWLIO_PORT_FILE,
+  PKG_VERSION,
+  TIMEOUTS,
+  WS_HEARTBEAT_INTERVAL,
+  WS_HOST,
+  WS_PORT,
+  WS_RECONNECT_GRACE,
+  WS_STALE_THRESHOLD
+} from "./chunk-JRZS5IP6.js";
 
 // src/mcp-server/index.ts
-import { randomBytes } from "crypto";
+import { randomBytes as randomBytes2 } from "crypto";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
@@ -1542,904 +18,7 @@ import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/
 import { createMcpExpressApp } from "@modelcontextprotocol/sdk/server/express.js";
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { ZodError } from "zod";
-
-// node_modules/express-rate-limit/dist/index.mjs
-var import_ip_address = __toESM(require_ip_address(), 1);
-import { isIPv6 } from "net";
-import { isIPv6 as isIPv62 } from "net";
-import { Buffer } from "buffer";
-import { createHash } from "crypto";
-import { isIP } from "net";
-function ipKeyGenerator(ip, ipv6Subnet = 56) {
-  if (ipv6Subnet && isIPv6(ip)) {
-    return `${new import_ip_address.Address6(`${ip}/${ipv6Subnet}`).startAddress().correctForm()}/${ipv6Subnet}`;
-  }
-  return ip;
-}
-var MemoryStore = class {
-  constructor(validations2) {
-    this.validations = validations2;
-    this.previous = /* @__PURE__ */ new Map();
-    this.current = /* @__PURE__ */ new Map();
-    this.localKeys = true;
-  }
-  /**
-   * Method that initializes the store.
-   *
-   * @param options {Options} - The options used to setup the middleware.
-   */
-  init(options) {
-    this.windowMs = options.windowMs;
-    this.validations?.windowMs(this.windowMs);
-    if (this.interval) clearInterval(this.interval);
-    this.interval = setInterval(() => {
-      this.clearExpired();
-    }, this.windowMs);
-    this.interval.unref?.();
-  }
-  /**
-   * Method to fetch a client's hit count and reset time.
-   *
-   * @param key {string} - The identifier for a client.
-   *
-   * @returns {ClientRateLimitInfo | undefined} - The number of hits and reset time for that client.
-   *
-   * @public
-   */
-  async get(key) {
-    return this.current.get(key) ?? this.previous.get(key);
-  }
-  /**
-   * Method to increment a client's hit counter.
-   *
-   * @param key {string} - The identifier for a client.
-   *
-   * @returns {ClientRateLimitInfo} - The number of hits and reset time for that client.
-   *
-   * @public
-   */
-  async increment(key) {
-    const client = this.getClient(key);
-    const now = Date.now();
-    if (client.resetTime.getTime() <= now) {
-      this.resetClient(client, now);
-    }
-    client.totalHits++;
-    return client;
-  }
-  /**
-   * Method to decrement a client's hit counter.
-   *
-   * @param key {string} - The identifier for a client.
-   *
-   * @public
-   */
-  async decrement(key) {
-    const client = this.getClient(key);
-    if (client.totalHits > 0) client.totalHits--;
-  }
-  /**
-   * Method to reset a client's hit counter.
-   *
-   * @param key {string} - The identifier for a client.
-   *
-   * @public
-   */
-  async resetKey(key) {
-    this.current.delete(key);
-    this.previous.delete(key);
-  }
-  /**
-   * Method to reset everyone's hit counter.
-   *
-   * @public
-   */
-  async resetAll() {
-    this.current.clear();
-    this.previous.clear();
-  }
-  /**
-   * Method to stop the timer (if currently running) and prevent any memory
-   * leaks.
-   *
-   * @public
-   */
-  shutdown() {
-    clearInterval(this.interval);
-    void this.resetAll();
-  }
-  /**
-   * Recycles a client by setting its hit count to zero, and reset time to
-   * `windowMs` milliseconds from now.
-   *
-   * NOT to be confused with `#resetKey()`, which removes a client from both the
-   * `current` and `previous` maps.
-   *
-   * @param client {Client} - The client to recycle.
-   * @param now {number} - The current time, to which the `windowMs` is added to get the `resetTime` for the client.
-   *
-   * @return {Client} - The modified client that was passed in, to allow for chaining.
-   */
-  resetClient(client, now = Date.now()) {
-    client.totalHits = 0;
-    client.resetTime.setTime(now + this.windowMs);
-    return client;
-  }
-  /**
-   * Retrieves or creates a client, given a key. Also ensures that the client being
-   * returned is in the `current` map.
-   *
-   * @param key {string} - The key under which the client is (or is to be) stored.
-   *
-   * @returns {Client} - The requested client.
-   */
-  getClient(key) {
-    if (this.current.has(key)) return this.current.get(key);
-    let client;
-    if (this.previous.has(key)) {
-      client = this.previous.get(key);
-      this.previous.delete(key);
-    } else {
-      client = { totalHits: 0, resetTime: /* @__PURE__ */ new Date() };
-      this.resetClient(client);
-    }
-    this.current.set(key, client);
-    return client;
-  }
-  /**
-   * Move current clients to previous, create a new map for current.
-   *
-   * This function is called every `windowMs`.
-   */
-  clearExpired() {
-    this.previous = this.current;
-    this.current = /* @__PURE__ */ new Map();
-  }
-};
-var SUPPORTED_DRAFT_VERSIONS = [
-  "draft-6",
-  "draft-7",
-  "draft-8"
-];
-var getResetSeconds = (windowMs, resetTime) => {
-  let resetSeconds;
-  if (resetTime) {
-    const deltaSeconds = Math.ceil((resetTime.getTime() - Date.now()) / 1e3);
-    resetSeconds = Math.max(0, deltaSeconds);
-  } else {
-    resetSeconds = Math.ceil(windowMs / 1e3);
-  }
-  return resetSeconds;
-};
-var getPartitionKey = (key) => {
-  const hash = createHash("sha256");
-  hash.update(key);
-  const partitionKey = hash.digest("hex").slice(0, 12);
-  return Buffer.from(partitionKey).toString("base64");
-};
-var setLegacyHeaders = (response, info) => {
-  if (response.headersSent) return;
-  response.setHeader("X-RateLimit-Limit", info.limit.toString());
-  response.setHeader("X-RateLimit-Remaining", info.remaining.toString());
-  if (info.resetTime instanceof Date) {
-    response.setHeader("Date", (/* @__PURE__ */ new Date()).toUTCString());
-    response.setHeader(
-      "X-RateLimit-Reset",
-      Math.ceil(info.resetTime.getTime() / 1e3).toString()
-    );
-  }
-};
-var setDraft6Headers = (response, info, windowMs) => {
-  if (response.headersSent) return;
-  const windowSeconds = Math.ceil(windowMs / 1e3);
-  const resetSeconds = getResetSeconds(windowMs, info.resetTime);
-  response.setHeader("RateLimit-Policy", `${info.limit};w=${windowSeconds}`);
-  response.setHeader("RateLimit-Limit", info.limit.toString());
-  response.setHeader("RateLimit-Remaining", info.remaining.toString());
-  if (typeof resetSeconds === "number")
-    response.setHeader("RateLimit-Reset", resetSeconds.toString());
-};
-var setDraft7Headers = (response, info, windowMs) => {
-  if (response.headersSent) return;
-  const windowSeconds = Math.ceil(windowMs / 1e3);
-  const resetSeconds = getResetSeconds(windowMs, info.resetTime);
-  response.setHeader("RateLimit-Policy", `${info.limit};w=${windowSeconds}`);
-  response.setHeader(
-    "RateLimit",
-    `limit=${info.limit}, remaining=${info.remaining}, reset=${resetSeconds}`
-  );
-};
-var setDraft8Headers = (response, info, windowMs, name, key) => {
-  if (response.headersSent) return;
-  const windowSeconds = Math.ceil(windowMs / 1e3);
-  const resetSeconds = getResetSeconds(windowMs, info.resetTime);
-  const partitionKey = getPartitionKey(key);
-  const header = `r=${info.remaining}; t=${resetSeconds}`;
-  const policy = `q=${info.limit}; w=${windowSeconds}; pk=:${partitionKey}:`;
-  response.append("RateLimit", `"${name}"; ${header}`);
-  response.append("RateLimit-Policy", `"${name}"; ${policy}`);
-};
-var setRetryAfterHeader = (response, info, windowMs) => {
-  if (response.headersSent) return;
-  const resetSeconds = getResetSeconds(windowMs, info.resetTime);
-  response.setHeader("Retry-After", resetSeconds.toString());
-};
-var omitUndefinedProperties = (passedOptions) => {
-  const omittedOptions = {};
-  for (const k of Object.keys(passedOptions)) {
-    const key = k;
-    if (passedOptions[key] !== void 0) {
-      omittedOptions[key] = passedOptions[key];
-    }
-  }
-  return omittedOptions;
-};
-var ValidationError = class extends Error {
-  /**
-   * The code must be a string, in snake case and all capital, that starts with
-   * the substring `ERR_ERL_`.
-   *
-   * The message must be a string, starting with an uppercase character,
-   * describing the issue in detail.
-   */
-  constructor(code, message) {
-    const url = `https://express-rate-limit.github.io/${code}/`;
-    super(`${message} See ${url} for more information.`);
-    this.name = this.constructor.name;
-    this.code = code;
-    this.help = url;
-  }
-};
-var ChangeWarning = class extends ValidationError {
-};
-var usedStores = /* @__PURE__ */ new Set();
-var singleCountKeys = /* @__PURE__ */ new WeakMap();
-var validations = {
-  enabled: {
-    default: true
-  },
-  // Should be EnabledValidations type, but that's a circular reference
-  disable() {
-    for (const k of Object.keys(this.enabled)) this.enabled[k] = false;
-  },
-  /**
-   * Checks whether the IP address is valid, and that it does not have a port
-   * number in it.
-   *
-   * See https://github.com/express-rate-limit/express-rate-limit/wiki/Error-Codes#err_erl_invalid_ip_address.
-   *
-   * @param ip {string | undefined} - The IP address provided by Express as request.ip.
-   *
-   * @returns {void}
-   */
-  ip(ip) {
-    if (ip === void 0) {
-      throw new ValidationError(
-        "ERR_ERL_UNDEFINED_IP_ADDRESS",
-        `An undefined 'request.ip' was detected. This might indicate a misconfiguration or the connection being destroyed prematurely.`
-      );
-    }
-    if (!isIP(ip)) {
-      throw new ValidationError(
-        "ERR_ERL_INVALID_IP_ADDRESS",
-        `An invalid 'request.ip' (${ip}) was detected. Consider passing a custom 'keyGenerator' function to the rate limiter.`
-      );
-    }
-  },
-  /**
-   * Makes sure the trust proxy setting is not set to `true`.
-   *
-   * See https://github.com/express-rate-limit/express-rate-limit/wiki/Error-Codes#err_erl_permissive_trust_proxy.
-   *
-   * @param request {Request} - The Express request object.
-   *
-   * @returns {void}
-   */
-  trustProxy(request) {
-    if (request.app.get("trust proxy") === true) {
-      throw new ValidationError(
-        "ERR_ERL_PERMISSIVE_TRUST_PROXY",
-        `The Express 'trust proxy' setting is true, which allows anyone to trivially bypass IP-based rate limiting.`
-      );
-    }
-  },
-  /**
-   * Makes sure the trust proxy setting is set in case the `X-Forwarded-For`
-   * header is present.
-   *
-   * See https://github.com/express-rate-limit/express-rate-limit/wiki/Error-Codes#err_erl_unset_trust_proxy.
-   *
-   * @param request {Request} - The Express request object.
-   *
-   * @returns {void}
-   */
-  xForwardedForHeader(request) {
-    if (request.headers["x-forwarded-for"] && request.app.get("trust proxy") === false) {
-      throw new ValidationError(
-        "ERR_ERL_UNEXPECTED_X_FORWARDED_FOR",
-        `The 'X-Forwarded-For' header is set but the Express 'trust proxy' setting is false (default). This could indicate a misconfiguration which would prevent express-rate-limit from accurately identifying users.`
-      );
-    }
-  },
-  /**
-   * Alert the user if the Forwarded header is set (standardized version of X-Forwarded-For - not supported by express as of version 5.1.0)
-   *
-   * @param request {Request} - The Express request object.
-   *
-   * @returns {void}
-   */
-  forwardedHeader(request) {
-    if (request.headers.forwarded && request.ip === request.socket?.remoteAddress) {
-      throw new ValidationError(
-        "ERR_ERL_FORWARDED_HEADER",
-        `The 'Forwarded' header (standardized X-Forwarded-For) is set but currently being ignored. Add a custom keyGenerator to use a value from this header.`
-      );
-    }
-  },
-  /**
-   * Ensures totalHits value from store is a positive integer.
-   *
-   * @param hits {any} - The `totalHits` returned by the store.
-   */
-  positiveHits(hits) {
-    if (typeof hits !== "number" || hits < 1 || hits !== Math.round(hits)) {
-      throw new ValidationError(
-        "ERR_ERL_INVALID_HITS",
-        `The totalHits value returned from the store must be a positive integer, got ${hits}`
-      );
-    }
-  },
-  /**
-   * Ensures a single store instance is not used with multiple express-rate-limit instances
-   */
-  unsharedStore(store) {
-    if (usedStores.has(store)) {
-      const maybeUniquePrefix = store?.localKeys ? "" : " (with a unique prefix)";
-      throw new ValidationError(
-        "ERR_ERL_STORE_REUSE",
-        `A Store instance must not be shared across multiple rate limiters. Create a new instance of ${store.constructor.name}${maybeUniquePrefix} for each limiter instead.`
-      );
-    }
-    usedStores.add(store);
-  },
-  /**
-   * Ensures a given key is incremented only once per request.
-   *
-   * @param request {Request} - The Express request object.
-   * @param store {Store} - The store class.
-   * @param key {string} - The key used to store the client's hit count.
-   *
-   * @returns {void}
-   */
-  singleCount(request, store, key) {
-    let storeKeys = singleCountKeys.get(request);
-    if (!storeKeys) {
-      storeKeys = /* @__PURE__ */ new Map();
-      singleCountKeys.set(request, storeKeys);
-    }
-    const storeKey = store.localKeys ? store : store.constructor.name;
-    let keys = storeKeys.get(storeKey);
-    if (!keys) {
-      keys = [];
-      storeKeys.set(storeKey, keys);
-    }
-    const prefixedKey = `${store.prefix ?? ""}${key}`;
-    if (keys.includes(prefixedKey)) {
-      throw new ValidationError(
-        "ERR_ERL_DOUBLE_COUNT",
-        `The hit count for ${key} was incremented more than once for a single request.`
-      );
-    }
-    keys.push(prefixedKey);
-  },
-  /**
-   * Warns the user that the behaviour for `max: 0` / `limit: 0` is
-   * changing in the next major release.
-   *
-   * @param limit {number} - The maximum number of hits per client.
-   *
-   * @returns {void}
-   */
-  limit(limit) {
-    if (limit === 0) {
-      throw new ChangeWarning(
-        "WRN_ERL_MAX_ZERO",
-        "Setting limit or max to 0 disables rate limiting in express-rate-limit v6 and older, but will cause all requests to be blocked in v7"
-      );
-    }
-  },
-  /**
-   * Warns the user that the `draft_polli_ratelimit_headers` option is deprecated
-   * and will be removed in the next major release.
-   *
-   * @param draft_polli_ratelimit_headers {any | undefined} - The now-deprecated setting that was used to enable standard headers.
-   *
-   * @returns {void}
-   */
-  draftPolliHeaders(draft_polli_ratelimit_headers) {
-    if (draft_polli_ratelimit_headers) {
-      throw new ChangeWarning(
-        "WRN_ERL_DEPRECATED_DRAFT_POLLI_HEADERS",
-        `The draft_polli_ratelimit_headers configuration option is deprecated and has been removed in express-rate-limit v7, please set standardHeaders: 'draft-6' instead.`
-      );
-    }
-  },
-  /**
-   * Warns the user that the `onLimitReached` option is deprecated and
-   * will be removed in the next major release.
-   *
-   * @param onLimitReached {any | undefined} - The maximum number of hits per client.
-   *
-   * @returns {void}
-   */
-  onLimitReached(onLimitReached) {
-    if (onLimitReached) {
-      throw new ChangeWarning(
-        "WRN_ERL_DEPRECATED_ON_LIMIT_REACHED",
-        "The onLimitReached configuration option is deprecated and has been removed in express-rate-limit v7."
-      );
-    }
-  },
-  /**
-   * Warns the user when an invalid/unsupported version of the draft spec is passed.
-   *
-   * @param version {any | undefined} - The version passed by the user.
-   *
-   * @returns {void}
-   */
-  headersDraftVersion(version) {
-    if (typeof version !== "string" || // @ts-expect-error This is fine. If version is not in the array, it will just return false.
-    !SUPPORTED_DRAFT_VERSIONS.includes(version)) {
-      const versionString = SUPPORTED_DRAFT_VERSIONS.join(", ");
-      throw new ValidationError(
-        "ERR_ERL_HEADERS_UNSUPPORTED_DRAFT_VERSION",
-        `standardHeaders: only the following versions of the IETF draft specification are supported: ${versionString}.`
-      );
-    }
-  },
-  /**
-   * Warns the user when the selected headers option requires a reset time but
-   * the store does not provide one.
-   *
-   * @param resetTime {Date | undefined} - The timestamp when the client's hit count will be reset.
-   *
-   * @returns {void}
-   */
-  headersResetTime(resetTime) {
-    if (!resetTime) {
-      throw new ValidationError(
-        "ERR_ERL_HEADERS_NO_RESET",
-        `standardHeaders:  'draft-7' requires a 'resetTime', but the store did not provide one. The 'windowMs' value will be used instead, which may cause clients to wait longer than necessary.`
-      );
-    }
-  },
-  knownOptions(passedOptions) {
-    if (!passedOptions) return;
-    const optionsMap = {
-      windowMs: true,
-      limit: true,
-      message: true,
-      statusCode: true,
-      legacyHeaders: true,
-      standardHeaders: true,
-      identifier: true,
-      requestPropertyName: true,
-      skipFailedRequests: true,
-      skipSuccessfulRequests: true,
-      keyGenerator: true,
-      ipv6Subnet: true,
-      handler: true,
-      skip: true,
-      requestWasSuccessful: true,
-      store: true,
-      validate: true,
-      headers: true,
-      max: true,
-      passOnStoreError: true
-    };
-    const validOptions = Object.keys(optionsMap).concat(
-      "draft_polli_ratelimit_headers",
-      // not a valid option anymore, but we have a more specific check for this one, so don't warn for it here
-      // from express-slow-down - https://github.com/express-rate-limit/express-slow-down/blob/main/source/types.ts#L65
-      "delayAfter",
-      "delayMs",
-      "maxDelayMs"
-    );
-    for (const key of Object.keys(passedOptions)) {
-      if (!validOptions.includes(key)) {
-        throw new ValidationError(
-          "ERR_ERL_UNKNOWN_OPTION",
-          `Unexpected configuration option: ${key}`
-          // todo: suggest a valid option with a short levenstein distance?
-        );
-      }
-    }
-  },
-  /**
-   * Checks the options.validate setting to ensure that only recognized
-   * validations are enabled or disabled.
-   *
-   * If any unrecognized values are found, an error is logged that
-   * includes the list of supported validations.
-   */
-  validationsConfig() {
-    const supportedValidations = Object.keys(this).filter(
-      (k) => !["enabled", "disable"].includes(k)
-    );
-    supportedValidations.push("default");
-    for (const key of Object.keys(this.enabled)) {
-      if (!supportedValidations.includes(key)) {
-        throw new ValidationError(
-          "ERR_ERL_UNKNOWN_VALIDATION",
-          `options.validate.${key} is not recognized. Supported validate options are: ${supportedValidations.join(
-            ", "
-          )}.`
-        );
-      }
-    }
-  },
-  /**
-   * Checks to see if the instance was created inside of a request handler,
-   * which would prevent it from working correctly, with the default memory
-   * store (or any other store with localKeys.)
-   */
-  creationStack(store) {
-    const { stack } = new Error(
-      "express-rate-limit validation check (set options.validate.creationStack=false to disable)"
-    );
-    if (stack?.includes("Layer.handle [as handle_request]") || // express v4
-    stack?.includes("Layer.handleRequest")) {
-      if (!store.localKeys) {
-        throw new ValidationError(
-          "ERR_ERL_CREATED_IN_REQUEST_HANDLER",
-          "express-rate-limit instance should *usually* be created at app initialization, not when responding to a request."
-        );
-      }
-      throw new ValidationError(
-        "ERR_ERL_CREATED_IN_REQUEST_HANDLER",
-        "express-rate-limit instance should be created at app initialization, not when responding to a request."
-      );
-    }
-  },
-  ipv6Subnet(ipv6Subnet) {
-    if (ipv6Subnet === false) {
-      return;
-    }
-    if (!Number.isInteger(ipv6Subnet) || ipv6Subnet < 32 || ipv6Subnet > 64) {
-      throw new ValidationError(
-        "ERR_ERL_IPV6_SUBNET",
-        `Unexpected ipv6Subnet value: ${ipv6Subnet}. Expected an integer between 32 and 64 (usually 48-64).`
-      );
-    }
-  },
-  ipv6SubnetOrKeyGenerator(options) {
-    if (options.ipv6Subnet !== void 0 && options.keyGenerator) {
-      throw new ValidationError(
-        "ERR_ERL_IPV6SUBNET_OR_KEYGENERATOR",
-        `Incompatible options: the 'ipv6Subnet' option is ignored when a custom 'keyGenerator' function is also set.`
-      );
-    }
-  },
-  keyGeneratorIpFallback(keyGenerator) {
-    if (!keyGenerator) {
-      return;
-    }
-    const src = keyGenerator.toString();
-    if ((src.includes("req.ip") || src.includes("request.ip")) && !src.includes("ipKeyGenerator")) {
-      throw new ValidationError(
-        "ERR_ERL_KEY_GEN_IPV6",
-        "Custom keyGenerator appears to use request IP without calling the ipKeyGenerator helper function for IPv6 addresses. This could allow IPv6 users to bypass limits."
-      );
-    }
-  },
-  /**
-   * Checks to see if the window duration is greater than 2^32 - 1. This is only
-   * called by the default MemoryStore, since it uses Node's setInterval method.
-   *
-   * See https://nodejs.org/api/timers.html#setintervalcallback-delay-args.
-   */
-  windowMs(windowMs) {
-    const SET_TIMEOUT_MAX = 2 ** 31 - 1;
-    if (typeof windowMs !== "number" || Number.isNaN(windowMs) || windowMs < 1 || windowMs > SET_TIMEOUT_MAX) {
-      throw new ValidationError(
-        "ERR_ERL_WINDOW_MS",
-        `Invalid windowMs value: ${windowMs}${typeof windowMs !== "number" ? ` (${typeof windowMs})` : ""}, must be a number between 1 and ${SET_TIMEOUT_MAX} when using the default MemoryStore`
-      );
-    }
-  }
-};
-var getValidations = (_enabled) => {
-  let enabled;
-  if (typeof _enabled === "boolean") {
-    enabled = {
-      default: _enabled
-    };
-  } else {
-    enabled = {
-      default: true,
-      ..._enabled
-    };
-  }
-  const wrappedValidations = { enabled };
-  for (const [name, validation] of Object.entries(validations)) {
-    if (typeof validation === "function")
-      wrappedValidations[name] = (...args) => {
-        if (!(enabled[name] ?? enabled.default)) {
-          return;
-        }
-        try {
-          ;
-          validation.apply(
-            wrappedValidations,
-            args
-          );
-        } catch (error) {
-          if (error instanceof ChangeWarning) console.warn(error);
-          else console.error(error);
-        }
-      };
-  }
-  return wrappedValidations;
-};
-var isLegacyStore = (store) => (
-  // Check that `incr` exists but `increment` does not - store authors might want
-  // to keep both around for backwards compatibility.
-  typeof store.incr === "function" && typeof store.increment !== "function"
-);
-var promisifyStore = (passedStore) => {
-  if (!isLegacyStore(passedStore)) {
-    return passedStore;
-  }
-  const legacyStore = passedStore;
-  class PromisifiedStore {
-    async increment(key) {
-      return new Promise((resolve2, reject) => {
-        legacyStore.incr(
-          key,
-          (error, totalHits, resetTime) => {
-            if (error) reject(error);
-            resolve2({ totalHits, resetTime });
-          }
-        );
-      });
-    }
-    async decrement(key) {
-      return legacyStore.decrement(key);
-    }
-    async resetKey(key) {
-      return legacyStore.resetKey(key);
-    }
-    /* istanbul ignore next */
-    async resetAll() {
-      if (typeof legacyStore.resetAll === "function")
-        return legacyStore.resetAll();
-    }
-  }
-  return new PromisifiedStore();
-};
-var getOptionsFromConfig = (config) => {
-  const { validations: validations2, ...directlyPassableEntries } = config;
-  return {
-    ...directlyPassableEntries,
-    validate: validations2.enabled
-  };
-};
-var parseOptions = (passedOptions) => {
-  const notUndefinedOptions = omitUndefinedProperties(passedOptions);
-  const validations2 = getValidations(notUndefinedOptions?.validate ?? true);
-  validations2.validationsConfig();
-  validations2.knownOptions(passedOptions);
-  validations2.draftPolliHeaders(
-    // @ts-expect-error see the note above.
-    notUndefinedOptions.draft_polli_ratelimit_headers
-  );
-  validations2.onLimitReached(notUndefinedOptions.onLimitReached);
-  if (notUndefinedOptions.ipv6Subnet !== void 0 && typeof notUndefinedOptions.ipv6Subnet !== "function") {
-    validations2.ipv6Subnet(notUndefinedOptions.ipv6Subnet);
-  }
-  validations2.keyGeneratorIpFallback(notUndefinedOptions.keyGenerator);
-  validations2.ipv6SubnetOrKeyGenerator(notUndefinedOptions);
-  let standardHeaders = notUndefinedOptions.standardHeaders ?? false;
-  if (standardHeaders === true) standardHeaders = "draft-6";
-  const config = {
-    windowMs: 60 * 1e3,
-    limit: passedOptions.max ?? 5,
-    // `max` is deprecated, but support it anyways.
-    message: "Too many requests, please try again later.",
-    statusCode: 429,
-    legacyHeaders: passedOptions.headers ?? true,
-    identifier(request, _response) {
-      let duration = "";
-      const property = config.requestPropertyName;
-      const { limit } = request[property];
-      const seconds = config.windowMs / 1e3;
-      const minutes = config.windowMs / (1e3 * 60);
-      const hours = config.windowMs / (1e3 * 60 * 60);
-      const days = config.windowMs / (1e3 * 60 * 60 * 24);
-      if (seconds < 60) duration = `${seconds}sec`;
-      else if (minutes < 60) duration = `${minutes}min`;
-      else if (hours < 24) duration = `${hours}hr${hours > 1 ? "s" : ""}`;
-      else duration = `${days}day${days > 1 ? "s" : ""}`;
-      return `${limit}-in-${duration}`;
-    },
-    requestPropertyName: "rateLimit",
-    skipFailedRequests: false,
-    skipSuccessfulRequests: false,
-    requestWasSuccessful: (_request, response) => response.statusCode < 400,
-    skip: (_request, _response) => false,
-    async keyGenerator(request, response) {
-      validations2.ip(request.ip);
-      validations2.trustProxy(request);
-      validations2.xForwardedForHeader(request);
-      validations2.forwardedHeader(request);
-      const ip = request.ip;
-      let subnet = 56;
-      if (isIPv62(ip)) {
-        subnet = typeof config.ipv6Subnet === "function" ? await config.ipv6Subnet(request, response) : config.ipv6Subnet;
-        if (typeof config.ipv6Subnet === "function")
-          validations2.ipv6Subnet(subnet);
-      }
-      return ipKeyGenerator(ip, subnet);
-    },
-    ipv6Subnet: 56,
-    async handler(request, response, _next, _optionsUsed) {
-      response.status(config.statusCode);
-      const message = typeof config.message === "function" ? await config.message(
-        request,
-        response
-      ) : config.message;
-      if (!response.writableEnded) response.send(message);
-    },
-    passOnStoreError: false,
-    // Allow the default options to be overridden by the passed options.
-    ...notUndefinedOptions,
-    // `standardHeaders` is resolved into a draft version above, use that.
-    standardHeaders,
-    // Note that this field is declared after the user's options are spread in,
-    // so that this field doesn't get overridden with an un-promisified store!
-    store: promisifyStore(
-      notUndefinedOptions.store ?? new MemoryStore(validations2)
-    ),
-    // Print an error to the console if a few known misconfigurations are detected.
-    validations: validations2
-  };
-  if (typeof config.store.increment !== "function" || typeof config.store.decrement !== "function" || typeof config.store.resetKey !== "function" || config.store.resetAll !== void 0 && typeof config.store.resetAll !== "function" || config.store.init !== void 0 && typeof config.store.init !== "function") {
-    throw new TypeError(
-      "An invalid store was passed. Please ensure that the store is a class that implements the `Store` interface."
-    );
-  }
-  return config;
-};
-var handleAsyncErrors = (fn) => async (request, response, next) => {
-  try {
-    await Promise.resolve(fn(request, response, next)).catch(next);
-  } catch (error) {
-    next(error);
-  }
-};
-var rateLimit = (passedOptions) => {
-  const config = parseOptions(passedOptions ?? {});
-  const options = getOptionsFromConfig(config);
-  config.validations.creationStack(config.store);
-  config.validations.unsharedStore(config.store);
-  if (typeof config.store.init === "function") config.store.init(options);
-  const middleware = handleAsyncErrors(
-    async (request, response, next) => {
-      const skip = await config.skip(request, response);
-      if (skip) {
-        next();
-        return;
-      }
-      const augmentedRequest = request;
-      const key = await config.keyGenerator(request, response);
-      let totalHits = 0;
-      let resetTime;
-      try {
-        const incrementResult = await config.store.increment(key);
-        totalHits = incrementResult.totalHits;
-        resetTime = incrementResult.resetTime;
-      } catch (error) {
-        if (config.passOnStoreError) {
-          console.error(
-            "express-rate-limit: error from store, allowing request without rate-limiting.",
-            error
-          );
-          next();
-          return;
-        }
-        throw error;
-      }
-      config.validations.positiveHits(totalHits);
-      config.validations.singleCount(request, config.store, key);
-      const retrieveLimit = typeof config.limit === "function" ? config.limit(request, response) : config.limit;
-      const limit = await retrieveLimit;
-      config.validations.limit(limit);
-      const info = {
-        limit,
-        used: totalHits,
-        remaining: Math.max(limit - totalHits, 0),
-        resetTime,
-        key
-      };
-      Object.defineProperty(info, "current", {
-        configurable: false,
-        enumerable: false,
-        value: totalHits
-      });
-      augmentedRequest[config.requestPropertyName] = info;
-      if (config.legacyHeaders && !response.headersSent) {
-        setLegacyHeaders(response, info);
-      }
-      if (config.standardHeaders && !response.headersSent) {
-        switch (config.standardHeaders) {
-          case "draft-6": {
-            setDraft6Headers(response, info, config.windowMs);
-            break;
-          }
-          case "draft-7": {
-            config.validations.headersResetTime(info.resetTime);
-            setDraft7Headers(response, info, config.windowMs);
-            break;
-          }
-          case "draft-8": {
-            const retrieveName = typeof config.identifier === "function" ? config.identifier(request, response) : config.identifier;
-            const name = await retrieveName;
-            config.validations.headersResetTime(info.resetTime);
-            setDraft8Headers(response, info, config.windowMs, name, key);
-            break;
-          }
-          default: {
-            config.validations.headersDraftVersion(config.standardHeaders);
-            break;
-          }
-        }
-      }
-      if (config.skipFailedRequests || config.skipSuccessfulRequests) {
-        let decremented = false;
-        const decrementKey = async () => {
-          if (!decremented) {
-            await config.store.decrement(key);
-            decremented = true;
-          }
-        };
-        if (config.skipFailedRequests) {
-          response.on("finish", async () => {
-            if (!await config.requestWasSuccessful(request, response))
-              await decrementKey();
-          });
-          response.on("close", async () => {
-            if (!response.writableEnded) await decrementKey();
-          });
-          response.on("error", async () => {
-            await decrementKey();
-          });
-        }
-        if (config.skipSuccessfulRequests) {
-          response.on("finish", async () => {
-            if (await config.requestWasSuccessful(request, response))
-              await decrementKey();
-          });
-        }
-      }
-      config.validations.disable();
-      if (totalHits > limit) {
-        if (config.legacyHeaders || config.standardHeaders) {
-          setRetryAfterHeader(response, info, config.windowMs);
-        }
-        config.handler(request, response, next, options);
-        return;
-      }
-      next();
-    }
-  );
-  const getThrowFn = () => {
-    throw new Error("The current store does not support the get/getKey method");
-  };
-  middleware.resetKey = config.store.resetKey.bind(config.store);
-  middleware.getKey = typeof config.store.get === "function" ? config.store.get.bind(config.store) : getThrowFn;
-  return middleware;
-};
-var rate_limit_default = rateLimit;
+import rateLimit from "express-rate-limit";
 
 // src/mcp-server/websocket-bridge.ts
 import { WebSocketServer, WebSocket } from "ws";
@@ -2447,33 +26,6 @@ import { createServer } from "http";
 import { randomUUID } from "crypto";
 import { fileURLToPath } from "url";
 import { dirname, resolve } from "path";
-
-// src/shared/constants.ts
-import { homedir } from "os";
-import { join } from "path";
-var WS_PORT = 9333;
-var WS_HOST = "127.0.0.1";
-var CRAWLIO_PORT_FILE = join(
-  homedir(),
-  "Library",
-  "Logs",
-  "Crawlio",
-  "control.port"
-);
-var TIMEOUTS = {
-  WS_COMMAND: 3e4,
-  // 30s for most commands
-  NETWORK_CAPTURE: 12e4,
-  // 2min for network capture
-  SCREENSHOT: 1e4,
-  // 10s
-  RECONNECT: 3e3,
-  // 3s reconnect delay
-  CODE_EXECUTE: 12e4
-  // 2min for code-mode execute()
-};
-
-// src/mcp-server/websocket-bridge.ts
 function resolveIndexPath() {
   if (process.argv[1] && process.argv[1].includes("dist")) {
     return process.argv[1];
@@ -2665,8 +217,8 @@ var MessageQueue = class {
     this.queue = [];
   }
 };
-var HEARTBEAT_INTERVAL = 15e3;
-var STALE_THRESHOLD = 45e3;
+var HEARTBEAT_INTERVAL = WS_HEARTBEAT_INTERVAL;
+var STALE_THRESHOLD = WS_STALE_THRESHOLD;
 var WebSocketBridge = class {
   wss = null;
   httpServer = null;
@@ -2674,6 +226,7 @@ var WebSocketBridge = class {
   pending = /* @__PURE__ */ new Map();
   messageQueue = new MessageQueue();
   heartbeatTimer = null;
+  reconnectGraceTimer = null;
   lastPong = 0;
   lastPingSent = 0;
   latencyMs = 0;
@@ -2689,7 +242,7 @@ var WebSocketBridge = class {
         this.lastPingSent = Date.now();
         this.client.ping();
         if (this.lastPong > 0 && Date.now() - this.lastPong > STALE_THRESHOLD) {
-          console.error("[Bridge] WebSocket stale \u2014 no pong in 45s, closing");
+          console.error(`[Bridge] WebSocket stale \u2014 no pong in ${STALE_THRESHOLD / 1e3}s, closing`);
           this.client.terminate();
         }
       }
@@ -2742,12 +295,48 @@ var WebSocketBridge = class {
         res.end();
         return;
       }
-      res.writeHead(426);
-      res.end("Upgrade Required");
+      res.writeHead(426);
+      res.end("Upgrade Required");
+    });
+    this.wss = new WebSocketServer({
+      server: this.httpServer,
+      maxPayload: 10 * 1024 * 1024,
+      // 10 MB — prevents memory exhaustion
+      verifyClient: (info, callback) => {
+        const origin = info.origin;
+        if (!origin || origin === "null") {
+          callback(true);
+          return;
+        }
+        if (origin.startsWith("chrome-extension://")) {
+          callback(true);
+          return;
+        }
+        try {
+          const url = new URL(origin);
+          if (url.hostname === "127.0.0.1" || url.hostname === "localhost") {
+            callback(true);
+            return;
+          }
+        } catch {
+        }
+        console.error(`[Bridge] WebSocket origin rejected: ${origin}`);
+        callback(false, 403, "Forbidden");
+      }
     });
-    this.wss = new WebSocketServer({ server: this.httpServer });
     this.wss.on("connection", (ws) => {
+      if (this.client && this.client.readyState === WebSocket.OPEN) {
+        console.error("[Bridge] Evicting stale client \u2014 new connection");
+        this.client.close(1e3, "Replaced by new connection");
+      }
       console.error(`[Bridge] Extension connected`);
+      if (this.reconnectGraceTimer) {
+        clearTimeout(this.reconnectGraceTimer);
+        this.reconnectGraceTimer = null;
+        if (this.pending.size > 0) {
+          console.error(`[Bridge] Reconnect within grace period \u2014 ${this.pending.size} pending commands preserved`);
+        }
+      }
       this.client = ws;
       this.reconnectCount++;
       this.connectTime = Date.now();
@@ -2789,6 +378,11 @@ var WebSocketBridge = class {
       }
       ws.on("message", (raw) => {
         try {
+          const len = typeof raw === "string" ? Buffer.byteLength(raw) : raw.length;
+          if (len > 5 * 1024 * 1024) {
+            console.error(`[Bridge] Oversized message dropped: ${(len / 1024 / 1024).toFixed(1)} MB`);
+            return;
+          }
           const msg = JSON.parse(raw.toString());
           if (msg.type === "refresh_port") {
             this.onPortRefreshRequested?.();
@@ -2800,20 +394,36 @@ var WebSocketBridge = class {
         }
       });
       ws.on("error", (err) => {
-        console.error("[Bridge] WebSocket error:", err.message);
+        if (this.client === ws) {
+          console.error("[Bridge] WebSocket error:", err.message);
+        }
       });
       ws.on("close", () => {
+        if (this.client !== ws) {
+          console.error("[Bridge] Stale client closed (already replaced)");
+          return;
+        }
         console.error("[Bridge] Extension disconnected");
         this.stopHeartbeat();
         this.client = null;
         this.connectTime = 0;
-        for (const [id, req] of this.pending) {
-          clearTimeout(req.timer);
-          req.reject(new Error("Extension disconnected"));
-          this.pending.delete(id);
+        if (this.pending.size > 0) {
+          console.error(`[Bridge] ${this.pending.size} pending commands \u2014 waiting ${WS_RECONNECT_GRACE / 1e3}s for reconnect`);
+          this.reconnectGraceTimer = setTimeout(() => {
+            this.reconnectGraceTimer = null;
+            for (const [id, req] of this.pending) {
+              clearTimeout(req.timer);
+              req.reject(new Error("Extension disconnected"));
+              this.pending.delete(id);
+            }
+          }, WS_RECONNECT_GRACE);
         }
       });
     });
+    this.wss.on("wsClientError", (err, socket) => {
+      console.error("[Bridge] WebSocket handshake error:", err.message);
+      socket.destroy();
+    });
     try {
       const probe = await fetch(`http://${WS_HOST}:${WS_PORT}/health`, { signal: AbortSignal.timeout(500) });
       const body = await probe.json();
@@ -2855,7 +465,8 @@ var WebSocketBridge = class {
     const serialized = JSON.stringify(fullCommand);
     if (!this.isConnected) {
       console.error(`[Bridge] Queuing command (offline): ${command.type} (queue depth: ${this.messageQueue.depth + 1})`);
-      return this.messageQueue.enqueue(serialized, timeout);
+      const queueTimeout = Math.max(timeout, 45e3);
+      return this.messageQueue.enqueue(serialized, queueTimeout);
     }
     return new Promise((resolve2, reject) => {
       const timer = setTimeout(() => {
@@ -2874,8 +485,8 @@ var WebSocketBridge = class {
   }
   handleMessage(msg) {
     if (msg.type === "open_crawlio_app") {
-      import("child_process").then(({ execFile }) => {
-        execFile("open", ["-a", "Crawlio"], () => {
+      import("child_process").then(({ execFile: execFile2 }) => {
+        execFile2("open", ["-a", "Crawlio"], () => {
         });
       });
       return;
@@ -2908,6 +519,10 @@ var WebSocketBridge = class {
   }
   async stop() {
     this.stopHeartbeat();
+    if (this.reconnectGraceTimer) {
+      clearTimeout(this.reconnectGraceTimer);
+      this.reconnectGraceTimer = null;
+    }
     this.messageQueue.clear();
     this.client?.close();
     this.wss?.close();
@@ -3083,6 +698,476 @@ var CrawlioClient = class {
 
 // src/mcp-server/tools.ts
 import { z } from "zod";
+import { execFile } from "child_process";
+import { writeFile, unlink } from "fs/promises";
+import { tmpdir } from "os";
+import { join as join2, dirname as dirname3 } from "path";
+import { randomBytes } from "crypto";
+import { fileURLToPath as fileURLToPath3 } from "url";
+import { promisify } from "util";
+
+// src/mcp-server/response-shapers.ts
+function truncateUrl(url, max = 120) {
+  if (url.length <= max) return url;
+  return url.slice(0, max - 3) + "...";
+}
+function shapeListTabs(data) {
+  const raw = Array.isArray(data) ? { tabs: data, connectedTabId: null } : data;
+  return {
+    connectedTabId: raw.connectedTabId ?? null,
+    tabs: raw.tabs.map((t) => ({
+      id: t.tabId,
+      title: t.title,
+      url: truncateUrl(t.url),
+      ...t.active ? { active: true } : {}
+    }))
+  };
+}
+function shapeConnectTab(data) {
+  const shaped = {
+    tabId: data.tabId,
+    url: typeof data.url === "string" ? truncateUrl(data.url) : data.url,
+    title: data.title
+  };
+  const ds = data.domainState;
+  if (ds?.required) {
+    const failed = ds.required.filter((d) => !d.success);
+    if (failed.length > 0) {
+      shaped.ok = false;
+      shaped.failedDomains = failed.map((d) => d.domain);
+    } else {
+      shaped.ok = true;
+    }
+  } else {
+    shaped.ok = true;
+  }
+  return shaped;
+}
+function summarizeDom(node) {
+  const stats = { nodeCount: 0, forms: 0, links: 0, images: 0, inputs: 0 };
+  const walk = (n) => {
+    stats.nodeCount++;
+    const tag = n.tag?.toLowerCase();
+    if (tag === "form") stats.forms++;
+    else if (tag === "a") stats.links++;
+    else if (tag === "img") stats.images++;
+    else if (tag === "input" || tag === "textarea" || tag === "select") stats.inputs++;
+    if (n.children) n.children.forEach(walk);
+  };
+  walk(node);
+  return stats;
+}
+function shapeCapturePage(data) {
+  const shaped = {
+    url: truncateUrl(data.url),
+    title: data.title,
+    capturedAt: data.capturedAt
+  };
+  if (data.framework) {
+    shaped.framework = data.framework;
+  }
+  if (data.networkRequests) {
+    const entries = data.networkRequests;
+    const failed = entries.filter((e) => e.status >= 400 || e.status === 0);
+    const byType = {};
+    for (const e of entries) {
+      const t = e.resourceType || "other";
+      byType[t] = (byType[t] || 0) + 1;
+    }
+    shaped.network = {
+      total: entries.length,
+      failed: failed.length,
+      byType,
+      errors: failed.slice(0, 10).map((e) => ({
+        url: truncateUrl(e.url, 80),
+        status: e.status,
+        method: e.method
+      }))
+    };
+  }
+  if (data.consoleLogs) {
+    const entries = data.consoleLogs;
+    const errors = entries.filter((e) => e.level === "error");
+    const warnings = entries.filter((e) => e.level === "warning");
+    shaped.console = {
+      total: entries.length,
+      errors: errors.slice(0, 10).map((e) => ({ level: e.level, text: e.text.slice(0, 200) })),
+      warnings: warnings.length,
+      info: entries.filter((e) => e.level === "info").length,
+      debug: entries.filter((e) => e.level === "debug").length
+    };
+  }
+  if (data.cookies) {
+    shaped.cookies = {
+      total: data.cookies.length,
+      names: data.cookies.map((c) => c.name)
+    };
+  }
+  if (data.domSnapshot) {
+    shaped.dom = summarizeDom(data.domSnapshot);
+  }
+  return shaped;
+}
+function shapeConsoleLogs(entries) {
+  const errors = entries.filter((e) => e.level === "error");
+  const warnings = entries.filter((e) => e.level === "warning");
+  return {
+    total: entries.length,
+    errors: errors.map((e) => ({
+      text: e.text.slice(0, 300),
+      url: e.url ? truncateUrl(e.url, 80) : void 0,
+      lineNumber: e.lineNumber
+    })),
+    warnings: warnings.slice(0, 10).map((e) => ({
+      text: e.text.slice(0, 200)
+    })),
+    info: entries.filter((e) => e.level === "info").length,
+    debug: entries.filter((e) => e.level === "debug").length
+  };
+}
+function shapeNetworkLog(entries) {
+  const failed = entries.filter((e) => e.status >= 400 || e.status === 0);
+  const byStatus = {};
+  const byType = {};
+  for (const e of entries) {
+    const bucket = e.status === 0 ? "0xx" : `${Math.floor(e.status / 100)}xx`;
+    byStatus[bucket] = (byStatus[bucket] || 0) + 1;
+    const t = e.resourceType || "other";
+    byType[t] = (byType[t] || 0) + 1;
+  }
+  const slowest = [...entries].sort((a, b) => b.durationMs - a.durationMs).slice(0, 5).map((e) => ({
+    url: truncateUrl(e.url, 80),
+    durationMs: e.durationMs,
+    status: e.status
+  }));
+  return {
+    total: entries.length,
+    failed: failed.map((e) => ({
+      url: truncateUrl(e.url, 80),
+      status: e.status,
+      method: e.method
+    })),
+    byStatus,
+    byType,
+    slowest
+  };
+}
+function shapeCookies(data) {
+  return {
+    total: data.cookies.length,
+    fallbackUsed: data.fallbackUsed ?? false,
+    cookies: data.cookies.map((c) => ({
+      name: c.name,
+      domain: c.domain,
+      httpOnly: c.httpOnly,
+      secure: c.secure,
+      sameSite: c.sameSite
+    }))
+  };
+}
+function shapeInteraction(data) {
+  if (!data || typeof data !== "object") return data;
+  const d = data;
+  const shaped = {};
+  const keep = [
+    "action",
+    "selector",
+    "ref",
+    "url",
+    "title",
+    "text",
+    "key",
+    "message",
+    "snapshot",
+    "previousValue",
+    "newValue",
+    "filesCount",
+    "success",
+    "filled",
+    "submitted"
+  ];
+  for (const k of keep) {
+    if (d[k] !== void 0) shaped[k] = d[k];
+  }
+  if (typeof shaped.url === "string") {
+    shaped.url = truncateUrl(shaped.url);
+  }
+  return shaped;
+}
+
+// src/mcp-server/recording-compiler.ts
+function compileRecording(session, options) {
+  const name = sanitizeSkillName(options.name);
+  const totalInteractions = session.pages.reduce((sum, p) => sum + p.interactions.length, 0);
+  const description = options.description ?? `Replay of a recorded browser session (${session.pages.length} pages, ${totalInteractions} interactions).`;
+  const lines = [];
+  lines.push("---");
+  lines.push(`name: ${name}`);
+  lines.push(`description: ${description}`);
+  lines.push("allowed-tools: mcp__crawlio-browser__search, mcp__crawlio-browser__execute, mcp__crawlio-browser__connect_tab");
+  lines.push("---");
+  lines.push("");
+  const title = options.name.trim() || "Unnamed Skill";
+  lines.push(`# ${title}`);
+  lines.push("");
+  lines.push(`Replay of a recorded browser session (${session.pages.length} pages, ${totalInteractions} interactions).`);
+  lines.push("");
+  lines.push("## Prerequisites");
+  lines.push("");
+  lines.push("Connect to a browser tab before running:");
+  lines.push("");
+  lines.push("```");
+  lines.push(`connect_tab({ url: "${escapeString(session.metadata.initialUrl)}" })`);
+  lines.push("```");
+  lines.push("");
+  for (let i = 0; i < session.pages.length; i++) {
+    const page = session.pages[i];
+    const pageLabel = page.title || page.url;
+    lines.push(`## Page ${i + 1}: ${pageLabel}`);
+    lines.push("");
+    lines.push("```js");
+    for (const interaction of page.interactions) {
+      lines.push(compileInteraction(interaction));
+    }
+    lines.push("```");
+    lines.push("");
+    if (i < session.pages.length - 1) {
+      lines.push("```js");
+      lines.push("await sleep(1000)");
+      lines.push("await smart.snapshot()");
+      lines.push("```");
+      lines.push("");
+    }
+  }
+  lines.push("## Session Info");
+  lines.push("");
+  lines.push(`- **Recorded**: ${session.startedAt}`);
+  lines.push(`- **Duration**: ${session.duration}s`);
+  lines.push(`- **Stop reason**: ${session.metadata.stopReason}`);
+  lines.push("");
+  return {
+    skillMarkdown: lines.join("\n"),
+    name,
+    pageCount: session.pages.length,
+    interactionCount: totalInteractions
+  };
+}
+var STRIP_KEYS = /* @__PURE__ */ new Set(["type", "id", "_internal"]);
+function filterArgs(args) {
+  const filtered = {};
+  for (const [k, v] of Object.entries(args)) {
+    if (!STRIP_KEYS.has(k)) filtered[k] = v;
+  }
+  return filtered;
+}
+function resolveSelector(args) {
+  const sel = args.selector ?? args.ref;
+  return typeof sel === "string" ? sel : void 0;
+}
+function compileInteraction(interaction) {
+  const args = filterArgs(interaction.args);
+  const tool = interaction.tool;
+  switch (tool) {
+    case "browser_navigate": {
+      const url = args.url ?? "";
+      return `await smart.navigate(${JSON.stringify(url)})`;
+    }
+    case "browser_click": {
+      const sel = resolveSelector(args) ?? "";
+      return `await smart.click(${JSON.stringify(sel)})`;
+    }
+    case "browser_type": {
+      const sel = resolveSelector(args) ?? "";
+      const text = args.text ?? "";
+      if (args.clearFirst) {
+        return `await smart.type(${JSON.stringify(sel)}, ${JSON.stringify(text)}, { clearFirst: true })`;
+      }
+      return `await smart.type(${JSON.stringify(sel)}, ${JSON.stringify(text)})`;
+    }
+    case "browser_evaluate": {
+      const expr = args.expression ?? "";
+      return `await smart.evaluate(${JSON.stringify(expr)})`;
+    }
+    case "browser_press_key": {
+      const bridgeArgs = { type: "browser_press_key", ...args };
+      return `await bridge.send(${JSON.stringify(bridgeArgs)})`;
+    }
+    case "browser_hover": {
+      const sel = resolveSelector(args);
+      const bridgeArgs = { type: "browser_hover", ...args };
+      if (sel) {
+        return `await smart.waitFor(${JSON.stringify(sel)})
+await bridge.send(${JSON.stringify(bridgeArgs)})`;
+      }
+      return `await bridge.send(${JSON.stringify(bridgeArgs)})`;
+    }
+    case "browser_select_option": {
+      const sel = resolveSelector(args);
+      const bridgeArgs = { type: "browser_select_option", ...args };
+      if (sel) {
+        return `await smart.waitFor(${JSON.stringify(sel)})
+await bridge.send(${JSON.stringify(bridgeArgs)})`;
+      }
+      return `await bridge.send(${JSON.stringify(bridgeArgs)})`;
+    }
+    case "browser_scroll": {
+      const bridgeArgs = { type: "browser_scroll", ...args };
+      return `await bridge.send(${JSON.stringify(bridgeArgs)})`;
+    }
+    case "browser_double_click": {
+      const sel = resolveSelector(args);
+      const bridgeArgs = { type: "browser_double_click", ...args };
+      if (sel) {
+        return `await smart.waitFor(${JSON.stringify(sel)})
+await bridge.send(${JSON.stringify(bridgeArgs)})`;
+      }
+      return `await bridge.send(${JSON.stringify(bridgeArgs)})`;
+    }
+    case "browser_drag": {
+      const bridgeArgs = { type: "browser_drag", ...args };
+      return `await bridge.send(${JSON.stringify(bridgeArgs)})`;
+    }
+    case "browser_fill_form": {
+      const bridgeArgs = { type: "browser_fill_form", ...args };
+      return `await bridge.send(${JSON.stringify(bridgeArgs)})`;
+    }
+    case "browser_file_upload": {
+      const sel = resolveSelector(args);
+      const bridgeArgs = { type: "browser_file_upload", ...args };
+      if (sel) {
+        return `await smart.waitFor(${JSON.stringify(sel)})
+await bridge.send(${JSON.stringify(bridgeArgs)})`;
+      }
+      return `await bridge.send(${JSON.stringify(bridgeArgs)})`;
+    }
+    // User interaction tools (captured from manual browser events)
+    case "user_click": {
+      const sel = args.selector ?? "";
+      return `await smart.click(${JSON.stringify(sel)})`;
+    }
+    case "user_type": {
+      const sel = args.selector ?? "";
+      const text = args.text ?? "";
+      return `await smart.type(${JSON.stringify(sel)}, ${JSON.stringify(text)})`;
+    }
+    case "user_keypress": {
+      const key = args.key ?? "";
+      return `await bridge.send(${JSON.stringify({ type: "browser_press_key", key })})`;
+    }
+    default:
+      return `// Unknown tool: ${tool}`;
+  }
+}
+function sanitizeSkillName(raw) {
+  let name = raw.toLowerCase().replace(/[\s_]+/g, "-").replace(/[^a-z0-9-]/g, "").replace(/-{2,}/g, "-").replace(/^-+|-+$/g, "");
+  if (name.length > 50) name = name.slice(0, 50).replace(/-+$/, "");
+  if (!name) name = "unnamed-skill";
+  return name;
+}
+function escapeString(s) {
+  return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+
+// src/mcp-server/semantic-search.ts
+import { readFileSync } from "fs";
+import { join, dirname as dirname2 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+function cosineSimilarity(a, b) {
+  if (a.length !== b.length || a.length === 0) return 0;
+  let dot = 0;
+  let normA = 0;
+  let normB = 0;
+  for (let i = 0; i < a.length; i++) {
+    dot += a[i] * b[i];
+    normA += a[i] * a[i];
+    normB += b[i] * b[i];
+  }
+  const denom = Math.sqrt(normA) * Math.sqrt(normB);
+  if (denom === 0) return 0;
+  return dot / denom;
+}
+function loadEmbeddings() {
+  const map = /* @__PURE__ */ new Map();
+  try {
+    const thisDir = dirname2(fileURLToPath2(import.meta.url));
+    const assetPath = join(thisDir, "tool-embeddings.json");
+    const raw = readFileSync(assetPath, "utf-8");
+    const asset = JSON.parse(raw);
+    if (!asset.embeddings || typeof asset.embeddings !== "object") return map;
+    for (const [name, vec] of Object.entries(asset.embeddings)) {
+      if (Array.isArray(vec) && vec.length > 0) {
+        map.set(name, new Float32Array(vec));
+      }
+    }
+  } catch {
+  }
+  return map;
+}
+function semanticSearch(queryEmbedding, embeddings, limit) {
+  const results = [];
+  for (const [name, vec] of embeddings) {
+    const score = cosineSimilarity(queryEmbedding, vec);
+    results.push({ name, score });
+  }
+  return results.sort((a, b) => b.score - a.score).slice(0, limit);
+}
+function buildQueryEmbedding(query, catalog, embeddings) {
+  const tokens = query.toLowerCase().split(/\s+/).filter(Boolean);
+  if (tokens.length === 0 || embeddings.size === 0) return null;
+  const matchedVectors = [];
+  for (const token of tokens) {
+    let bestName = "";
+    let bestScore = 0;
+    for (const entry of catalog) {
+      if (!embeddings.has(entry.name)) continue;
+      let score = 0;
+      const nameLower = entry.name.toLowerCase();
+      const descLower = entry.description.toLowerCase();
+      if (nameLower === token) score = 10;
+      else if (nameLower.includes(token)) score = 5;
+      if (descLower.includes(token)) score += 2;
+      if (score > bestScore) {
+        bestScore = score;
+        bestName = entry.name;
+      }
+    }
+    if (bestName && bestScore > 0) {
+      const vec = embeddings.get(bestName);
+      if (vec) matchedVectors.push(vec);
+    }
+  }
+  if (matchedVectors.length === 0) return null;
+  const dim = matchedVectors[0].length;
+  const avg = new Float32Array(dim);
+  for (const vec of matchedVectors) {
+    for (let i = 0; i < dim; i++) {
+      avg[i] += vec[i];
+    }
+  }
+  const count = matchedVectors.length;
+  for (let i = 0; i < dim; i++) {
+    avg[i] /= count;
+  }
+  return avg;
+}
+function normalizeScores(scores) {
+  const normalized = /* @__PURE__ */ new Map();
+  if (scores.size === 0) return normalized;
+  let min = Infinity;
+  let max = -Infinity;
+  for (const s of scores.values()) {
+    if (s < min) min = s;
+    if (s > max) max = s;
+  }
+  const range = max - min;
+  for (const [name, score] of scores) {
+    normalized.set(name, range === 0 ? max > 0 ? 1 : 0 : (score - min) / range);
+  }
+  return normalized;
+}
+
+// src/mcp-server/tools.ts
+var execFileAsync = promisify(execFile);
 var urlSchema = z.string().url().refine(
   (url) => {
     try {
@@ -3110,10 +1195,12 @@ var PERMISSION_EXEMPT_TOOLS = /* @__PURE__ */ new Set([
   "check_permissions",
   "request_permissions",
   "get_connection_status",
+  "get_recording_status",
   "connect_tab",
   "list_tabs",
   "search",
-  "execute"
+  "execute",
+  "compile_recording"
 ]);
 async function ensurePermission(bridge2, toolName) {
   try {
@@ -3189,6 +1276,7 @@ var TOOL_TIMEOUTS = {
   get_dialog: 5e3,
   handle_dialog: 5e3,
   get_response_body: 5e3,
+  replay_request: 3e4,
   set_viewport: 5e3,
   set_user_agent: 5e3,
   emulate_device: 1e4,
@@ -3236,10 +1324,15 @@ var TOOL_TIMEOUTS = {
   take_heap_snapshot: 3e4,
   highlight_element: 1e4,
   show_layout_shifts: 5e3,
-  show_paint_rects: 5e3
+  show_paint_rects: 5e3,
+  start_recording: 1e4,
+  stop_recording: 1e4,
+  get_recording_status: 5e3,
+  compile_recording: 5e3,
+  ocr_screenshot: 3e4
 };
 function toolSuccess(content) {
-  return { content: [{ type: "text", text: JSON.stringify(content ?? {}, null, 2) }], isError: false };
+  return { content: [{ type: "text", text: JSON.stringify(content ?? {}) }], isError: false };
 }
 function toolError(message) {
   return { content: [{ type: "text", text: message }], isError: true };
@@ -3249,6 +1342,7 @@ var smartObjectCache = null;
 async function checkActionability(bridge2, selector) {
   const result = await bridge2.send({
     type: "browser_evaluate",
+    _internal: true,
     expression: `(() => {
       const el = document.querySelector(${JSON.stringify(selector)});
       if (!el) return { actionable: false, reason: 'Element not found' };
@@ -3344,7 +1438,7 @@ function createTools(bridge2, crawlio2) {
         if (parsed.url) params.url = parsed.url;
         if (parsed.tabId) params.tabId = parsed.tabId;
         const data = await bridge2.send(params, TOOL_TIMEOUTS.connect_tab);
-        return toolSuccess(data);
+        return toolSuccess(shapeConnectTab(data));
       }
     },
     {
@@ -3362,7 +1456,7 @@ function createTools(bridge2, crawlio2) {
       inputSchema: { type: "object", properties: {} },
       handler: async () => {
         const data = await bridge2.send({ type: "list_tabs" }, TOOL_TIMEOUTS.list_tabs);
-        return toolSuccess(data);
+        return toolSuccess(shapeListTabs(data));
       }
     },
     {
@@ -3418,7 +1512,7 @@ function createTools(bridge2, crawlio2) {
             console.error("[Tools] Failed to send to Crawlio:", e);
           }
         }
-        return toolSuccess(data);
+        return toolSuccess(shapeCapturePage(data));
       }
     },
     {
@@ -3445,7 +1539,7 @@ function createTools(bridge2, crawlio2) {
       inputSchema: { type: "object", properties: {} },
       handler: async () => {
         const data = await bridge2.send({ type: "stop_network_capture" }, TOOL_TIMEOUTS.stop_network_capture);
-        return toolSuccess(data);
+        return toolSuccess(shapeNetworkLog(data));
       }
     },
     {
@@ -3454,7 +1548,7 @@ function createTools(bridge2, crawlio2) {
       inputSchema: { type: "object", properties: {} },
       handler: async () => {
         const data = await bridge2.send({ type: "get_console_logs" }, TOOL_TIMEOUTS.get_console_logs);
-        return toolSuccess(data);
+        return toolSuccess(shapeConsoleLogs(data));
       }
     },
     {
@@ -3464,7 +1558,7 @@ function createTools(bridge2, crawlio2) {
       handler: async () => {
         try {
           const data = await bridge2.send({ type: "get_cookies" }, TOOL_TIMEOUTS.get_cookies);
-          return toolSuccess(data);
+          return toolSuccess(shapeCookies(data));
         } catch (e) {
           const msg = e instanceof Error ? e.message : String(e);
           return toolError(`get_cookies failed: ${msg}. CDP domain: Network. Suggestion: use reconnect_tab to re-establish the CDP connection.`);
@@ -3538,6 +1632,11 @@ function createTools(bridge2, crawlio2) {
       handler: async (args) => {
         const schema = z.object({ url: urlSchema.optional() });
         const parsed = schema.parse(args);
+        try {
+          const bridgeData = await bridge2.send({ type: "get_enrichment", url: parsed.url }, 5e3);
+          if (bridgeData) return toolSuccess(bridgeData);
+        } catch {
+        }
         const data = await crawlio2.getEnrichment(parsed.url);
         return toolSuccess(data);
       }
@@ -3683,7 +1782,7 @@ function createTools(bridge2, crawlio2) {
             button: parsed.button,
             modifiers: parsed.modifiers
           }, TOOL_TIMEOUTS.browser_click);
-          return toolSuccess(result);
+          return toolSuccess(shapeInteraction(result));
         }
       )
     },
@@ -3736,7 +1835,7 @@ function createTools(bridge2, crawlio2) {
             submit: parsed.submit,
             modifiers: parsed.modifiers
           }, TOOL_TIMEOUTS.browser_type);
-          return toolSuccess(result);
+          return toolSuccess(shapeInteraction(result));
         }
       )
     },
@@ -3771,7 +1870,7 @@ function createTools(bridge2, crawlio2) {
           key: parsed.key,
           modifiers: parsed.modifiers
         }, TOOL_TIMEOUTS.browser_press_key);
-        return toolSuccess(result);
+        return toolSuccess(shapeInteraction(result));
       }
     },
     {
@@ -3807,7 +1906,7 @@ function createTools(bridge2, crawlio2) {
           selector: parsed.selector,
           modifiers: parsed.modifiers
         }, TOOL_TIMEOUTS.browser_hover);
-        return toolSuccess(result);
+        return toolSuccess(shapeInteraction(result));
       }
     },
     {
@@ -3838,7 +1937,7 @@ function createTools(bridge2, crawlio2) {
             selector: parsed.selector,
             value: parsed.value
           }, TOOL_TIMEOUTS.browser_select_option);
-          return toolSuccess(result);
+          return toolSuccess(shapeInteraction(result));
         }
       )
     },
@@ -3894,7 +1993,7 @@ function createTools(bridge2, crawlio2) {
           type: "browser_fill_form",
           fields: parsed.fields
         }, TOOL_TIMEOUTS.browser_fill_form ?? 15e3);
-        return toolSuccess(result);
+        return toolSuccess(shapeInteraction(result));
       }
     },
     {
@@ -4316,6 +2415,41 @@ function createTools(bridge2, crawlio2) {
         return toolSuccess(data);
       }
     },
+    // Network replay (PiecesOS Heist Ph3)
+    {
+      name: "replay_request",
+      description: "Re-fire a previously captured network request with optional modifications. Requires active network capture. Specify the request by URL. Optionally override headers, body, or method. Returns the new response status, headers, and body. Useful for API testing, auth token replay, and form submission testing.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          url: { type: "string", description: "URL of the captured request to replay" },
+          method: { type: "string", enum: ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"], description: "Override HTTP method" },
+          headers: { type: "object", description: "Override or add headers (merged with original captured headers)" },
+          body: { type: "string", description: "Override request body (for POST/PUT)" },
+          followRedirects: { type: "boolean", description: "Follow 3xx redirects (default: true)" }
+        },
+        required: ["url"]
+      },
+      handler: async (args) => {
+        const schema = z.object({
+          url: z.string().url(),
+          method: z.enum(["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]).optional(),
+          headers: z.record(z.string()).optional(),
+          body: z.string().optional(),
+          followRedirects: z.boolean().optional()
+        });
+        const parsed = schema.parse(args);
+        const data = await bridge2.send({
+          type: "replay_request",
+          url: parsed.url,
+          method: parsed.method,
+          headers: parsed.headers,
+          body: parsed.body,
+          followRedirects: parsed.followRedirects
+        }, TOOL_TIMEOUTS.replay_request);
+        return toolSuccess(data);
+      }
+    },
     // AC-8: Viewport & device emulation
     {
       name: "set_viewport",
@@ -4460,7 +2594,7 @@ function createTools(bridge2, crawlio2) {
           type: "browser_scroll",
           ...parsed
         }, TOOL_TIMEOUTS.browser_scroll);
-        return toolSuccess(result);
+        return toolSuccess(shapeInteraction(result));
       }
     },
     {
@@ -4484,7 +2618,7 @@ function createTools(bridge2, crawlio2) {
           ref: parsed.ref,
           selector: parsed.selector
         }, TOOL_TIMEOUTS.browser_double_click);
-        return toolSuccess(result);
+        return toolSuccess(shapeInteraction(result));
       }
     },
     {
@@ -4517,7 +2651,7 @@ function createTools(bridge2, crawlio2) {
           to: parsed.to,
           steps: parsed.steps
         }, TOOL_TIMEOUTS.browser_drag);
-        return toolSuccess(result);
+        return toolSuccess(shapeInteraction(result));
       }
     },
     {
@@ -4546,7 +2680,7 @@ function createTools(bridge2, crawlio2) {
           selector: parsed.selector,
           files: parsed.files
         }, TOOL_TIMEOUTS.browser_file_upload);
-        return toolSuccess(result);
+        return toolSuccess(shapeInteraction(result));
       }
     },
     // AC-13: Accessibility tree
@@ -5306,6 +3440,190 @@ function createTools(bridge2, crawlio2) {
         }, TOOL_TIMEOUTS.show_paint_rects);
         return toolSuccess(data);
       }
+    },
+    // --- Session Recording tools ---
+    {
+      name: "start_recording",
+      description: "Start recording a browser session. Captures all tool interactions, page navigations, network requests, and console logs organized by page. Recording auto-stops after maxDurationSec (default 600s) or maxInteractions (default 500). A tab must be connected first.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          maxDurationSec: { type: "number", description: "Max recording duration in seconds (10-600, default: 600)" },
+          maxInteractions: { type: "number", description: "Max interaction count before auto-stop (1-500, default: 500)" }
+        }
+      },
+      handler: async (args) => {
+        const schema = z.object({
+          maxDurationSec: z.number().min(10).max(600).optional(),
+          maxInteractions: z.number().min(1).max(500).optional()
+        });
+        const parsed = schema.parse(args);
+        try {
+          const data = await bridge2.send({
+            type: "start_recording",
+            maxDurationSec: parsed.maxDurationSec,
+            maxInteractions: parsed.maxInteractions
+          }, TOOL_TIMEOUTS.start_recording);
+          return toolSuccess(data);
+        } catch (e) {
+          const msg = e instanceof Error ? e.message : String(e);
+          return toolError(`start_recording failed: ${msg}. Suggestion: ensure a tab is connected via connect_tab first.`);
+        }
+      }
+    },
+    {
+      name: "stop_recording",
+      description: "Stop the active recording session and return the complete session data. Returns a RecordingSession JSON with all pages, interactions (tool calls with args/results/timing), network requests, and console logs partitioned by page. If the recording was auto-stopped (duration/interaction limit/tab closed), returns that session.",
+      inputSchema: {
+        type: "object",
+        properties: {}
+      },
+      handler: async () => {
+        try {
+          const data = await bridge2.send({ type: "stop_recording" }, TOOL_TIMEOUTS.stop_recording);
+          return toolSuccess(data);
+        } catch (e) {
+          const msg = e instanceof Error ? e.message : String(e);
+          return toolError(`stop_recording failed: ${msg}`);
+        }
+      }
+    },
+    {
+      name: "get_recording_status",
+      description: "Check the current recording status. Returns whether a recording is active, session ID, duration, page count, interaction count, and current page URL.",
+      inputSchema: {
+        type: "object",
+        properties: {}
+      },
+      handler: async () => {
+        try {
+          const data = await bridge2.send({ type: "get_recording_status" }, TOOL_TIMEOUTS.get_recording_status);
+          return toolSuccess(data);
+        } catch (e) {
+          const msg = e instanceof Error ? e.message : String(e);
+          return toolError(`get_recording_status failed: ${msg}`);
+        }
+      }
+    },
+    {
+      name: "compile_recording",
+      description: "Compile a recording session into a replayable SKILL.md markdown file. Takes the session JSON from stop_recording output and produces executable skill markdown with smart.* and bridge.send() calls. Pure computation \u2014 no browser access required.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          session: {
+            type: "object",
+            description: "The RecordingSession object returned by stop_recording"
+          },
+          name: {
+            type: "string",
+            description: "Name for the skill (will be kebab-cased)"
+          },
+          description: {
+            type: "string",
+            description: "Optional description for the skill frontmatter"
+          }
+        },
+        required: ["session", "name"]
+      },
+      handler: async (args) => {
+        const schema = z.object({
+          session: z.object({
+            id: z.string(),
+            startedAt: z.string(),
+            stoppedAt: z.string().optional(),
+            duration: z.number(),
+            pages: z.array(z.object({
+              url: z.string(),
+              title: z.string().optional(),
+              enteredAt: z.string(),
+              interactions: z.array(z.any())
+            }).passthrough()),
+            metadata: z.object({
+              tabId: z.number(),
+              initialUrl: z.string(),
+              stopReason: z.string()
+            }).passthrough()
+          }).passthrough(),
+          name: z.string().min(1),
+          description: z.string().optional()
+        });
+        const parsed = schema.safeParse(args);
+        if (!parsed.success) {
+          return toolError(`Invalid arguments: ${parsed.error.issues.map((i) => i.message).join(", ")}`);
+        }
+        try {
+          const result = compileRecording(
+            parsed.data.session,
+            { name: parsed.data.name, description: parsed.data.description }
+          );
+          return toolSuccess(result);
+        } catch (e) {
+          const msg = e instanceof Error ? e.message : String(e);
+          return toolError(`compile_recording failed: ${msg}`);
+        }
+      }
+    },
+    {
+      name: "ocr_screenshot",
+      description: "Extract text from the current page using macOS Vision.framework OCR. Takes a screenshot via CDP, runs native text recognition (VNRecognizeTextRequest), and returns recognized text with confidence scores and bounding regions. Works on canvas elements, images, anti-scraping sites, and any visual content invisible to DOM extraction.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          fullPage: { type: "boolean", description: "Capture full scrollable page (default: viewport only)" },
+          selector: { type: "string", description: "CSS selector \u2014 screenshot only this element" }
+        }
+      },
+      handler: async (args) => {
+        if (process.platform !== "darwin") {
+          return toolError("ocr_screenshot requires macOS (Vision.framework). On other platforms, use browser_evaluate with a JS OCR library.");
+        }
+        const schema = z.object({
+          fullPage: z.boolean().default(false),
+          selector: selectorSchema.optional()
+        });
+        const parsed = schema.parse(args);
+        const screenshotParams = { type: "take_screenshot" };
+        if (parsed.fullPage) screenshotParams.fullPage = true;
+        if (parsed.selector) screenshotParams.selector = parsed.selector;
+        let tmpPath = "";
+        try {
+          const data = await bridge2.send(screenshotParams, TOOL_TIMEOUTS.ocr_screenshot);
+          if (!data?.data) {
+            return toolError("Screenshot capture failed \u2014 no image data returned");
+          }
+          tmpPath = join2(tmpdir(), `crawlio-ocr-${randomBytes(6).toString("hex")}.png`);
+          await writeFile(tmpPath, Buffer.from(data.data, "base64"));
+          const shimPath = join2(dirname3(fileURLToPath3(import.meta.url)), "..", "..", "bin", "ocr-shim.swift");
+          const { stdout, stderr } = await execFileAsync("swift", [shimPath, tmpPath], { timeout: 25e3 });
+          if (!stdout.trim()) {
+            return toolError(`OCR produced no output${stderr ? `: ${stderr.trim()}` : ""}`);
+          }
+          const result = JSON.parse(stdout.trim());
+          if (result.error) {
+            return toolError(`OCR failed: ${result.error}`);
+          }
+          if (result.regions && result.regions.length > 20) {
+            result.regions = result.regions.sort((a, b) => b.confidence - a.confidence).slice(0, 20);
+            result.regionsLimited = true;
+          }
+          return toolSuccess(result);
+        } catch (e) {
+          const execErr = e;
+          if (execErr?.stderr) {
+            try {
+              const parsed2 = JSON.parse(execErr.stderr.trim());
+              if (parsed2.error) return toolError(`OCR failed: ${parsed2.error}`);
+            } catch {
+            }
+          }
+          const msg = e instanceof Error ? e.message : String(e);
+          return toolError(`OCR failed: ${msg}`);
+        } finally {
+          if (tmpPath) unlink(tmpPath).catch(() => {
+          });
+        }
+      }
     }
   ];
 }
@@ -5514,17 +3832,36 @@ function buildCatalog(tools2) {
   }));
   return [...browserCatalog, ...crawlioHTTPCatalog];
 }
-function searchCatalog(catalog, query, limit) {
+function searchCatalog(catalog, query, limit, embeddings) {
   const tokens = query.toLowerCase().split(/\s+/).filter(Boolean);
   if (tokens.length === 0) return catalog.slice(0, limit);
-  const scored = catalog.map((entry) => {
-    const haystack = `${entry.name} ${entry.description}`.toLowerCase();
+  const keywordScores = /* @__PURE__ */ new Map();
+  for (const entry of catalog) {
     let score = 0;
     for (const token of tokens) {
       if (entry.name.toLowerCase() === token) score += 10;
       else if (entry.name.toLowerCase().includes(token)) score += 5;
       if (entry.description.toLowerCase().includes(token)) score += 2;
     }
+    keywordScores.set(entry.name, score);
+  }
+  const semanticScores = /* @__PURE__ */ new Map();
+  if (embeddings && embeddings.size > 0) {
+    const queryVec = buildQueryEmbedding(query, catalog, embeddings);
+    if (queryVec) {
+      const results = semanticSearch(queryVec, embeddings, embeddings.size);
+      for (const r of results) {
+        semanticScores.set(r.name, r.score);
+      }
+    }
+  }
+  const hasSemanticScores = semanticScores.size > 0;
+  const normalizedKeyword = normalizeScores(keywordScores);
+  const normalizedSemantic = hasSemanticScores ? normalizeScores(semanticScores) : /* @__PURE__ */ new Map();
+  const scored = catalog.map((entry) => {
+    const kw = normalizedKeyword.get(entry.name) ?? 0;
+    const sem = normalizedSemantic.get(entry.name) ?? 0;
+    const score = hasSemanticScores ? 0.6 * sem + 0.4 * kw : kw;
     return { entry, score };
   });
   return scored.filter((s) => s.score > 0).sort((a, b) => b.score - a.score).slice(0, limit).map((s) => s.entry);
@@ -5532,6 +3869,7 @@ function searchCatalog(catalog, query, limit) {
 function createCodeModeTools(bridge2, crawlio2) {
   const allTools = createTools(bridge2, crawlio2);
   const catalog = buildCatalog(allTools);
+  const embeddings = loadEmbeddings();
   const connectTab = allTools.find((t) => t.name === "connect_tab");
   return [
     // --- search: discover available commands ---
@@ -5552,7 +3890,7 @@ function createCodeModeTools(bridge2, crawlio2) {
           limit: z.number().int().min(1).max(50).default(10)
         });
         const parsed = schema.parse(args);
-        const results = searchCatalog(catalog, parsed.query, parsed.limit);
+        const results = searchCatalog(catalog, parsed.query, parsed.limit, embeddings);
         return toolSuccess(results);
       }
     },
@@ -5579,6 +3917,8 @@ function createCodeModeTools(bridge2, crawlio2) {
         "- crawlio.postEnrichment(url, data) \u2014 shortcut for POST /enrichment/bundle",
         "- sleep(ms) \u2014 async wait (max 30s)",
         "- TIMEOUTS \u2014 per-command timeout constants",
+        "- compileRecording(session, { name, description? }) \u2014 compile RecordingSession to SKILL.md",
+        "  Returns { skillMarkdown, name, pageCount, interactionCount }",
         "- smart \u2014 auto-waiting wrappers and framework-specific data accessors:",
         "  smart.evaluate(expr) \u2014 raw JS evaluation via CDP",
         "  smart.click(selector, opts?) \u2014 poll + click + 500ms settle",
@@ -5616,12 +3956,19 @@ function createCodeModeTools(bridge2, crawlio2) {
         "",
         "Example (smart \u2014 framework data):",
         "  const nextData = await smart.nextjs?.getData();",
-        "  return { page: nextData?.page, buildId: nextData?.buildId };"
+        "  return { page: nextData?.page, buildId: nextData?.buildId };",
+        "",
+        "Example (session recording + compile):",
+        "  const s = await bridge.send({ type: 'start_recording', maxDurationSec: 120 });",
+        "  // ... interact with page ...",
+        "  const session = await bridge.send({ type: 'stop_recording' });",
+        "  const skill = compileRecording(session, { name: 'my-flow' });",
+        "  return skill;"
       ].join("\n"),
       inputSchema: {
         type: "object",
         properties: {
-          code: { type: "string", description: "Async JavaScript function body. Has bridge, crawlio, sleep, TIMEOUTS, smart in scope. Must return a value." }
+          code: { type: "string", description: "Async JavaScript function body. Has bridge, crawlio, sleep, TIMEOUTS, smart, compileRecording in scope. Must return a value." }
         },
         required: ["code"]
       },
@@ -5645,7 +3992,7 @@ function createCodeModeTools(bridge2, crawlio2) {
         }
         let fn;
         try {
-          fn = new AsyncFunction("bridge", "crawlio", "sleep", "TIMEOUTS", "smart", code);
+          fn = new AsyncFunction("bridge", "crawlio", "sleep", "TIMEOUTS", "smart", "compileRecording", code);
         } catch (syntaxError) {
           return toolError(`Syntax error in code: ${syntaxError instanceof Error ? syntaxError.message : String(syntaxError)}`);
         }
@@ -5653,7 +4000,7 @@ function createCodeModeTools(bridge2, crawlio2) {
         const timer = setTimeout(() => controller.abort(), 12e4);
         try {
           const result = await Promise.race([
-            fn(bridge2, crawlio2, sleepFn, TOOL_TIMEOUTS, smart),
+            fn(bridge2, crawlio2, sleepFn, TOOL_TIMEOUTS, smart, compileRecording),
             new Promise((_, reject) => {
               controller.signal.addEventListener(
                 "abort",
@@ -5678,7 +4025,7 @@ function createCodeModeTools(bridge2, crawlio2) {
 // src/mcp-server/index.ts
 var initMode = process.argv.includes("init") || process.argv.includes("--setup") || process.argv.includes("setup");
 if (initMode) {
-  const { runInit } = await import("./init-TRQTWLAB.js");
+  const { runInit } = await import("./init-4ITWQXXA.js");
   await runInit(process.argv.slice(2));
   process.exit(0);
 }
@@ -5701,7 +4048,7 @@ if (!codeMode) {
 }
 function createMcpServer() {
   const s = new Server(
-    { name: "crawlio-browser", version: "1.3.0" },
+    { name: "crawlio-browser", version: PKG_VERSION },
     { capabilities: { tools: {} } }
   );
   s.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -5712,7 +4059,7 @@ function createMcpServer() {
     }))
   }));
   s.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const requestId = randomBytes(4).toString("hex");
+    const requestId = randomBytes2(4).toString("hex");
     const toolName = request.params.name;
     const tool = tools.find((t) => t.name === toolName);
     if (!tool) {
@@ -5767,7 +4114,8 @@ async function main() {
       const port = await crawlio.getPort();
       bridge.push({ type: "set_crawlio_port", port });
       console.error(`[MCP] Port refresh: pushed Crawlio port ${port}`);
-    } catch {
+    } catch (e) {
+      console.error("[MCP] Port refresh failed:", e);
     }
   };
   if (portalMode) {
@@ -5808,7 +4156,7 @@ async function startPortalServer(port) {
     }
     next();
   });
-  app.use(rate_limit_default({
+  app.use(rateLimit({
     windowMs: 6e4,
     max: 120,
     standardHeaders: true,
@@ -5850,7 +4198,7 @@ async function startPortalServer(port) {
   app.get("/health", (_req, res) => {
     res.json({
       status: "ok",
-      version: "1.3.0",
+      version: PKG_VERSION,
       mode: codeMode ? "code" : "full",
       transport: "portal",
       bridgeConnected: bridge.isConnected,
@@ -5869,6 +4217,14 @@ main().catch((e) => {
   console.error("[MCP] Fatal:", e);
   process.exit(1);
 });
+process.on("uncaughtException", (err) => {
+  console.error("[MCP] CRASH \u2014 uncaughtException:", err.stack ?? err.message);
+  process.exit(1);
+});
+process.on("unhandledRejection", (reason) => {
+  console.error("[MCP] CRASH \u2014 unhandledRejection:", reason instanceof Error ? reason.stack ?? reason.message : reason);
+  process.exit(1);
+});
 for (const sig of ["SIGTERM", "SIGINT"]) {
   process.on(sig, async () => {
     console.error(`[MCP] ${sig} received, shutting down`);