@utilix-tech/sdk 0.16.0 → 0.18.0

package/dist/{code-C4skwg3l.d.ts → code-Cn9uOIAh.d.ts}

@@ -18,6 +18,7 @@
  *   - env-parser       (parseEnv, envToJson, envToExport, validateEnvKey)
  *   - css-minifier     (minifyCss, formatCss, countRules, countProperties)
  *   - mime-lookup      (lookupMime, MIME_TABLE)
+ *   - github-url-parser (parseGithubUrl)
  */
 type RegexFlag = 'g' | 'i' | 'm' | 's' | 'u';
 declare const ALL_FLAGS: RegexFlag[];
@@ -285,6 +286,27 @@ declare const MIME_TABLE: MimeEntry[];
 declare function lookupMime(query: string): MimeLookupResult | {
     error: string;
 };
+type GithubUrlType = 'repo' | 'pull' | 'issue' | 'commit' | 'file' | 'tree' | 'release';
+interface GithubUrlInfo {
+    owner: string;
+    repo: string;
+    type: GithubUrlType;
+    number?: number;
+    ref?: string;
+    path?: string;
+    startLine?: number;
+    endLine?: number;
+}
+/**
+ * Parses a github.com URL (repo, pull request, issue, commit, or a
+ * file/tree with an optional line range) into structured components via
+ * the path segments GitHub's own routing uses. Only covers github.com URLs
+ * over HTTP(S): SSH remotes (git@github.com:owner/repo.git) and other Git
+ * hosts are out of scope.
+ */
+declare function parseGithubUrl(input: string): GithubUrlInfo | {
+    error: string;
+};
 
 declare const code_ALL_FLAGS: typeof ALL_FLAGS;
 type code_ApiEndpoint = ApiEndpoint;
@@ -298,6 +320,8 @@ type code_EnvParseResult = EnvParseResult;
 type code_GitCommandConfig = GitCommandConfig;
 type code_GitCommandResult = GitCommandResult;
 type code_GitOperation = GitOperation;
+type code_GithubUrlInfo = GithubUrlInfo;
+type code_GithubUrlType = GithubUrlType;
 type code_GqlFormatResult = GqlFormatResult;
 type code_HtmlFormatResult = HtmlFormatResult;
 type code_HtmlMinifyOptions = HtmlMinifyOptions;
@@ -351,6 +375,7 @@ declare const code_normalizeRef: typeof normalizeRef;
 declare const code_parseDockerImage: typeof parseDockerImage;
 declare const code_parseEnv: typeof parseEnv;
 declare const code_parseGitCommand: typeof parseGitCommand;
+declare const code_parseGithubUrl: typeof parseGithubUrl;
 declare const code_parseSpec: typeof parseSpec;
 declare const code_removeConsoleCalls: typeof removeConsoleCalls;
 declare const code_removeEmptyAttributes: typeof removeEmptyAttributes;
@@ -364,7 +389,7 @@ declare const code_testPattern: typeof testPattern;
 declare const code_testRegex: typeof testRegex;
 declare const code_validateEnvKey: typeof validateEnvKey;
 declare namespace code {
-  export { code_ALL_FLAGS as ALL_FLAGS, type code_ApiEndpoint as ApiEndpoint, type code_ApiInfo as ApiInfo, code_CHEATSHEET as CHEATSHEET, type code_CheatsheetEntry as CheatsheetEntry, type code_CssResult as CssResult, type code_DockerImageRef as DockerImageRef, type code_EnvEntry as EnvEntry, type code_EnvParseResult as EnvParseResult, type code_GitCommandConfig as GitCommandConfig, type code_GitCommandResult as GitCommandResult, type code_GitOperation as GitOperation, type code_GqlFormatResult as GqlFormatResult, type code_HtmlFormatResult as HtmlFormatResult, type code_HtmlMinifyOptions as HtmlMinifyOptions, type code_HtmlMinifyResult as HtmlMinifyResult, type code_JsMinifyOptions as JsMinifyOptions, type code_JsMinifyResult as JsMinifyResult, code_MIME_TABLE as MIME_TABLE, type code_MatchResult as MatchResult, type code_MimeEntry as MimeEntry, type code_MimeLookupResult as MimeLookupResult, code_OPERATIONS as OPERATIONS, type code_ParsedSpec as ParsedSpec, type code_RegexError as RegexError, type code_RegexFlag as RegexFlag, type code_RegexMatch as RegexMatch, type code_RegexResult as RegexResult, type code_RegexSuccess as RegexSuccess, code_SQL_DEFAULT_OPTIONS as SQL_DEFAULT_OPTIONS, type code_Segment as Segment, type code_SpecVersion as SpecVersion, type code_SqlDialect as SqlDialect, type code_SqlFormatOptions as SqlFormatOptions, type code_TestPatternResult as TestPatternResult, code_buildDockerPull as buildDockerPull, code_buildDockerRun as buildDockerRun, code_buildGitCommand as buildGitCommand, code_collapseHtmlWhitespace as collapseHtmlWhitespace, code_collapseJsWhitespace as collapseJsWhitespace, code_countProperties as countProperties, code_countRules as countRules, code_detectDialect as detectDialect, code_detectOperationType as detectOperationType, code_envToExport as envToExport, code_envToJson as envToJson, code_formatCss as formatCss, code_formatGql as formatGql, code_formatHtml as formatHtml, code_formatSql as formatSql, code_getEndpointsByTag as getEndpointsByTag, code_getHtmlStats as getHtmlStats, code_getJsStats as getJsStats, code_getMethodColor as getMethodColor, code_isValidTag as isValidTag, code_lookupMime as lookupMime, code_minifyCss as minifyCss, code_minifyGql as minifyGql, code_minifyHtml as minifyHtml, code_minifyJs as minifyJs, code_minifySql as minifySql, code_normalizeRef as normalizeRef, code_parseDockerImage as parseDockerImage, code_parseEnv as parseEnv, code_parseGitCommand as parseGitCommand, code_parseSpec as parseSpec, code_removeConsoleCalls as removeConsoleCalls, code_removeEmptyAttributes as removeEmptyAttributes, code_removeHtmlComments as removeHtmlComments, code_removeJsComments as removeJsComments, code_removeRedundantAttributes as removeRedundantAttributes, code_searchCheatsheet as searchCheatsheet, code_searchEndpoints as searchEndpoints, code_splitStatements as splitStatements, code_testPattern as testPattern, code_testRegex as testRegex, code_validateEnvKey as validateEnvKey };
+  export { code_ALL_FLAGS as ALL_FLAGS, type code_ApiEndpoint as ApiEndpoint, type code_ApiInfo as ApiInfo, code_CHEATSHEET as CHEATSHEET, type code_CheatsheetEntry as CheatsheetEntry, type code_CssResult as CssResult, type code_DockerImageRef as DockerImageRef, type code_EnvEntry as EnvEntry, type code_EnvParseResult as EnvParseResult, type code_GitCommandConfig as GitCommandConfig, type code_GitCommandResult as GitCommandResult, type code_GitOperation as GitOperation, type code_GithubUrlInfo as GithubUrlInfo, type code_GithubUrlType as GithubUrlType, type code_GqlFormatResult as GqlFormatResult, type code_HtmlFormatResult as HtmlFormatResult, type code_HtmlMinifyOptions as HtmlMinifyOptions, type code_HtmlMinifyResult as HtmlMinifyResult, type code_JsMinifyOptions as JsMinifyOptions, type code_JsMinifyResult as JsMinifyResult, code_MIME_TABLE as MIME_TABLE, type code_MatchResult as MatchResult, type code_MimeEntry as MimeEntry, type code_MimeLookupResult as MimeLookupResult, code_OPERATIONS as OPERATIONS, type code_ParsedSpec as ParsedSpec, type code_RegexError as RegexError, type code_RegexFlag as RegexFlag, type code_RegexMatch as RegexMatch, type code_RegexResult as RegexResult, type code_RegexSuccess as RegexSuccess, code_SQL_DEFAULT_OPTIONS as SQL_DEFAULT_OPTIONS, type code_Segment as Segment, type code_SpecVersion as SpecVersion, type code_SqlDialect as SqlDialect, type code_SqlFormatOptions as SqlFormatOptions, type code_TestPatternResult as TestPatternResult, code_buildDockerPull as buildDockerPull, code_buildDockerRun as buildDockerRun, code_buildGitCommand as buildGitCommand, code_collapseHtmlWhitespace as collapseHtmlWhitespace, code_collapseJsWhitespace as collapseJsWhitespace, code_countProperties as countProperties, code_countRules as countRules, code_detectDialect as detectDialect, code_detectOperationType as detectOperationType, code_envToExport as envToExport, code_envToJson as envToJson, code_formatCss as formatCss, code_formatGql as formatGql, code_formatHtml as formatHtml, code_formatSql as formatSql, code_getEndpointsByTag as getEndpointsByTag, code_getHtmlStats as getHtmlStats, code_getJsStats as getJsStats, code_getMethodColor as getMethodColor, code_isValidTag as isValidTag, code_lookupMime as lookupMime, code_minifyCss as minifyCss, code_minifyGql as minifyGql, code_minifyHtml as minifyHtml, code_minifyJs as minifyJs, code_minifySql as minifySql, code_normalizeRef as normalizeRef, code_parseDockerImage as parseDockerImage, code_parseEnv as parseEnv, code_parseGitCommand as parseGitCommand, code_parseGithubUrl as parseGithubUrl, code_parseSpec as parseSpec, code_removeConsoleCalls as removeConsoleCalls, code_removeEmptyAttributes as removeEmptyAttributes, code_removeHtmlComments as removeHtmlComments, code_removeJsComments as removeJsComments, code_removeRedundantAttributes as removeRedundantAttributes, code_searchCheatsheet as searchCheatsheet, code_searchEndpoints as searchEndpoints, code_splitStatements as splitStatements, code_testPattern as testPattern, code_testRegex as testRegex, code_validateEnvKey as validateEnvKey };
 }
 
-export { getJsStats as $, ALL_FLAGS as A, collapseHtmlWhitespace as B, CHEATSHEET as C, type DockerImageRef as D, type EnvEntry as E, collapseJsWhitespace as F, type GitCommandConfig as G, type HtmlFormatResult as H, countProperties as I, type JsMinifyOptions as J, countRules as K, detectDialect as L, MIME_TABLE as M, detectOperationType as N, OPERATIONS as O, type ParsedSpec as P, envToExport as Q, type RegexError as R, SQL_DEFAULT_OPTIONS as S, type TestPatternResult as T, envToJson as U, formatCss as V, formatGql as W, formatHtml as X, formatSql as Y, getEndpointsByTag as Z, getHtmlStats as _, type ApiEndpoint as a, getMethodColor as a0, isValidTag as a1, lookupMime as a2, minifyCss as a3, minifyGql as a4, minifyHtml as a5, minifyJs as a6, minifySql as a7, normalizeRef as a8, parseDockerImage as a9, parseEnv as aa, parseGitCommand as ab, parseSpec as ac, removeConsoleCalls as ad, removeEmptyAttributes as ae, removeHtmlComments as af, removeJsComments as ag, removeRedundantAttributes as ah, searchCheatsheet as ai, searchEndpoints as aj, splitStatements as ak, testPattern as al, testRegex as am, validateEnvKey as an, type ApiInfo as b, code as c, type CheatsheetEntry as d, type CssResult as e, type EnvParseResult as f, type GitCommandResult as g, type GitOperation as h, type GqlFormatResult as i, type HtmlMinifyOptions as j, type HtmlMinifyResult as k, type JsMinifyResult as l, type MatchResult as m, type MimeEntry as n, type MimeLookupResult as o, type RegexFlag as p, type RegexMatch as q, type RegexResult as r, type RegexSuccess as s, type Segment as t, type SpecVersion as u, type SqlDialect as v, type SqlFormatOptions as w, buildDockerPull as x, buildDockerRun as y, buildGitCommand as z };
+export { getEndpointsByTag as $, ALL_FLAGS as A, buildDockerRun as B, CHEATSHEET as C, type DockerImageRef as D, type EnvEntry as E, buildGitCommand as F, type GitCommandConfig as G, type HtmlFormatResult as H, collapseHtmlWhitespace as I, type JsMinifyOptions as J, collapseJsWhitespace as K, countProperties as L, MIME_TABLE as M, countRules as N, OPERATIONS as O, type ParsedSpec as P, detectDialect as Q, type RegexError as R, SQL_DEFAULT_OPTIONS as S, type TestPatternResult as T, detectOperationType as U, envToExport as V, envToJson as W, formatCss as X, formatGql as Y, formatHtml as Z, formatSql as _, type ApiEndpoint as a, getHtmlStats as a0, getJsStats as a1, getMethodColor as a2, isValidTag as a3, lookupMime as a4, minifyCss as a5, minifyGql as a6, minifyHtml as a7, minifyJs as a8, minifySql as a9, normalizeRef as aa, parseDockerImage as ab, parseEnv as ac, parseGitCommand as ad, parseGithubUrl as ae, parseSpec as af, removeConsoleCalls as ag, removeEmptyAttributes as ah, removeHtmlComments as ai, removeJsComments as aj, removeRedundantAttributes as ak, searchCheatsheet as al, searchEndpoints as am, splitStatements as an, testPattern as ao, testRegex as ap, validateEnvKey as aq, type ApiInfo as b, code as c, type CheatsheetEntry as d, type CssResult as e, type EnvParseResult as f, type GitCommandResult as g, type GitOperation as h, type GithubUrlInfo as i, type GithubUrlType as j, type GqlFormatResult as k, type HtmlMinifyOptions as l, type HtmlMinifyResult as m, type JsMinifyResult as n, type MatchResult as o, type MimeEntry as p, type MimeLookupResult as q, type RegexFlag as r, type RegexMatch as s, type RegexResult as t, type RegexSuccess as u, type Segment as v, type SpecVersion as w, type SqlDialect as x, type SqlFormatOptions as y, buildDockerPull as z };

package/dist/index.cjs

@@ -6687,6 +6687,7 @@ __export(units_exports, {
   calculateLoan: () => calculateLoan,
   calculateSimpleInterest: () => calculateSimpleInterest,
   calculateTax: () => calculateTax,
+  calculateTimeValue: () => calculateTimeValue,
   calculateTipSplit: () => calculateTipSplit,
   compareSemver: () => compareSemver,
   convert: () => convert,
@@ -7962,6 +7963,45 @@ function calculateSimpleInterest(principal, annualRatePercent, years) {
     totalPayoff: round23(principal + interest)
   };
 }
+function calculateTimeValue(amount, annualRatePercent, years, direction, compoundsPerYear = 1) {
+  if (!Number.isFinite(amount) || amount < 0) return { error: "Amount must be zero or a positive number" };
+  if (!Number.isFinite(annualRatePercent) || annualRatePercent < 0) {
+    return { error: "Annual interest rate must be zero or a positive number" };
+  }
+  if (!Number.isFinite(years) || years <= 0) return { error: "Years must be a positive number" };
+  if (!Number.isInteger(compoundsPerYear) || compoundsPerYear <= 0) {
+    return { error: "Compounding frequency must be a positive whole number of periods per year" };
+  }
+  if (direction !== "future" && direction !== "present") {
+    return { error: 'Direction must be "future" or "present"' };
+  }
+  const round23 = (n) => Math.round(n * 100) / 100;
+  const round6 = (n) => Math.round(n * 1e6) / 1e6;
+  const ratePerPeriod = annualRatePercent / 100 / compoundsPerYear;
+  const totalPeriods = years * compoundsPerYear;
+  const growthFactor = Math.pow(1 + ratePerPeriod, totalPeriods);
+  let presentValue;
+  let futureValue;
+  if (direction === "future") {
+    presentValue = amount;
+    futureValue = amount * growthFactor;
+  } else {
+    futureValue = amount;
+    presentValue = amount / growthFactor;
+  }
+  return {
+    direction,
+    annualRatePercent,
+    years,
+    compoundsPerYear,
+    totalPeriods,
+    ratePerPeriodPercent: round6(ratePerPeriod * 100),
+    growthFactor: round6(growthFactor),
+    presentValue: round23(presentValue),
+    futureValue: round23(futureValue),
+    interest: round23(futureValue - presentValue)
+  };
+}
 
 // src/tools/network.ts
 var network_exports = {};
@@ -7989,6 +8029,7 @@ __export(network_exports, {
   parseDnsResponse: () => parseDnsResponse,
   parseGeoResponse: () => parseGeoResponse,
   parseHar: () => parseHar,
+  parseUserAgent: () => parseUserAgent,
   searchHeaders: () => searchHeaders,
   searchStatusCodes: () => searchStatusCodes,
   statusCodeToText: () => statusCodeToText,
@@ -9578,6 +9619,111 @@ function validateRobotsTxt(text) {
   const valid = !issues.some((i) => i.severity === "error");
   return { groups, sitemaps, issues, valid };
 }
+var UA_BOT_PATTERNS = [
+  [/googlebot/i, "Googlebot"],
+  [/bingbot/i, "Bingbot"],
+  [/slurp/i, "Slurp"],
+  [/duckduckbot/i, "DuckDuckBot"],
+  [/baiduspider/i, "Baiduspider"],
+  [/yandexbot/i, "YandexBot"],
+  [/facebookexternalhit/i, "Facebot"],
+  [/twitterbot/i, "Twitterbot"],
+  [/applebot/i, "Applebot"],
+  [/discordbot/i, "Discordbot"],
+  [/slackbot/i, "Slackbot"],
+  [/telegrambot/i, "TelegramBot"],
+  [/whatsapp/i, "WhatsApp"],
+  [/ahrefsbot/i, "AhrefsBot"],
+  [/semrushbot/i, "SemrushBot"],
+  [/crawler|spider|\bbot\b/i, "Bot"]
+];
+function _detectUaBrowser(s) {
+  let m;
+  if (m = s.match(/Edg(?:A|iOS)?\/([\d.]+)/)) return { name: "Edge", version: m[1] };
+  if (m = s.match(/Edge\/([\d.]+)/)) return { name: "Edge (Legacy)", version: m[1] };
+  if (m = s.match(/OPR\/([\d.]+)/)) return { name: "Opera", version: m[1] };
+  if (m = s.match(/Opera\/([\d.]+)/)) return { name: "Opera", version: m[1] };
+  if (m = s.match(/SamsungBrowser\/([\d.]+)/)) return { name: "Samsung Internet", version: m[1] };
+  if (m = s.match(/FxiOS\/([\d.]+)/)) return { name: "Firefox", version: m[1] };
+  if (m = s.match(/Firefox\/([\d.]+)/)) return { name: "Firefox", version: m[1] };
+  if (m = s.match(/CriOS\/([\d.]+)/)) return { name: "Chrome", version: m[1] };
+  if (m = s.match(/Chrome\/([\d.]+)/)) return { name: "Chrome", version: m[1] };
+  if (m = s.match(/Version\/([\d.]+).*Safari\//)) return { name: "Safari", version: m[1] };
+  if (/Safari\//.test(s)) return { name: "Safari", version: "" };
+  if (m = s.match(/MSIE ([\d.]+)/)) return { name: "Internet Explorer", version: m[1] };
+  if (m = s.match(/Trident\/.*rv:([\d.]+)/)) return { name: "Internet Explorer", version: m[1] };
+  return { name: "Unknown", version: "" };
+}
+function _detectUaEngine(s, browserName) {
+  let m;
+  if (/Chrome\/|CriOS\/|Edg\/|OPR\/|SamsungBrowser\//.test(s)) {
+    m = s.match(/Chrome\/([\d.]+)/) || s.match(/CriOS\/([\d.]+)/);
+    return { name: "Blink", version: m ? m[1] : "" };
+  }
+  if (/Firefox\/|FxiOS\//.test(s)) {
+    m = s.match(/rv:([\d.]+)/);
+    return { name: "Gecko", version: m ? m[1] : "" };
+  }
+  if (m = s.match(/AppleWebKit\/([\d.]+)/)) return { name: "WebKit", version: m[1] };
+  if (m = s.match(/Trident\/([\d.]+)/)) return { name: "Trident", version: m[1] };
+  if (browserName === "Edge (Legacy)") return { name: "EdgeHTML", version: "" };
+  return { name: "Unknown", version: "" };
+}
+var UA_WINDOWS_VERSIONS = {
+  "10.0": "10",
+  "6.3": "8.1",
+  "6.2": "8",
+  "6.1": "7",
+  "6.0": "Vista",
+  "5.1": "XP"
+};
+function _detectUaOs(s) {
+  if (/Windows NT/.test(s)) return "Windows";
+  if (/CrOS/.test(s)) return "ChromeOS";
+  if (/Android/.test(s)) return "Android";
+  if (/iPhone|iPad|iPod/.test(s)) return "iOS";
+  if (/Mac OS X/.test(s)) return "macOS";
+  if (/Linux/.test(s)) return "Linux";
+  return "Unknown";
+}
+function _detectUaOsVersion(s) {
+  let m;
+  if (m = s.match(/Windows NT ([\d.]+)/)) return UA_WINDOWS_VERSIONS[m[1]] ?? m[1];
+  if (/CrOS/.test(s) && (m = s.match(/CrOS \S+ ([\d.]+)/))) return m[1];
+  if (m = s.match(/Android ([\d.]+)/)) return m[1];
+  if (m = s.match(/(?:iPhone|CPU) OS ([\d_]+)/)) return m[1].replace(/_/g, ".");
+  if (m = s.match(/Mac OS X ([\d_]+)/)) return m[1].replace(/_/g, ".");
+  return "";
+}
+function _detectUaDeviceType(s) {
+  if (/iPad/.test(s)) return "tablet";
+  if (/Android/.test(s) && !/Mobile/.test(s)) return "tablet";
+  if (/Mobile|iPhone|iPod|Android/.test(s)) return "mobile";
+  return "desktop";
+}
+function parseUserAgent(ua) {
+  if (!ua || typeof ua !== "string" || ua.trim() === "") {
+    return { error: "Empty user-agent string" };
+  }
+  const s = ua.trim();
+  for (const [re, name] of UA_BOT_PATTERNS) {
+    if (re.test(s)) {
+      const versionMatch = s.match(new RegExp(`${name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\/([\\d.]+)`, "i"));
+      return {
+        browser: { name, version: versionMatch ? versionMatch[1] : "" },
+        engine: { name: "Unknown", version: "" },
+        os: { name: _detectUaOs(s), version: _detectUaOsVersion(s) },
+        device: { type: "bot" },
+        raw: s
+      };
+    }
+  }
+  const browser = _detectUaBrowser(s);
+  const engine = _detectUaEngine(s, browser.name);
+  const os = { name: _detectUaOs(s), version: _detectUaOsVersion(s) };
+  const device = { type: _detectUaDeviceType(s) };
+  return { browser, engine, os, device, raw: s };
+}
 
 // src/tools/api.ts
 var api_exports = {};
@@ -10882,6 +11028,7 @@ __export(code_exports, {
   parseDockerImage: () => parseDockerImage,
   parseEnv: () => parseEnv2,
   parseGitCommand: () => parseGitCommand,
+  parseGithubUrl: () => parseGithubUrl,
   parseSpec: () => parseSpec,
   removeConsoleCalls: () => removeConsoleCalls,
   removeEmptyAttributes: () => removeEmptyAttributes,
@@ -13255,6 +13402,68 @@ function lookupMime(query) {
   if (matches.length === 0) return { error: `No known MIME type for extension ".${ext}"` };
   return { query: trimmed, kind: "extension", matches };
 }
+function _parseGithubLineRange(hash) {
+  const m = hash.match(/^#?L(\d+)(?:-L?(\d+))?$/i);
+  if (!m) return {};
+  const startLine = parseInt(m[1], 10);
+  const endLine = m[2] ? parseInt(m[2], 10) : void 0;
+  return endLine !== void 0 ? { startLine, endLine } : { startLine };
+}
+function parseGithubUrl(input) {
+  if (!input || typeof input !== "string" || input.trim() === "") {
+    return { error: "Empty URL" };
+  }
+  const trimmed = input.trim();
+  const normalized = /^https?:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`;
+  let url;
+  try {
+    url = new URL(normalized);
+  } catch {
+    return { error: "Invalid URL" };
+  }
+  if (!/^(www\.)?github\.com$/i.test(url.hostname)) {
+    return { error: `Not a github.com URL (got host "${url.hostname}")` };
+  }
+  const segments = url.pathname.split("/").filter(Boolean);
+  if (segments.length < 2) {
+    return { error: "URL must include an owner and a repository" };
+  }
+  const [owner, repo, ...rest] = segments;
+  if (rest.length === 0) {
+    return { owner, repo, type: "repo" };
+  }
+  const kind = rest[0];
+  if (kind === "pull" || kind === "issues") {
+    const number = parseInt(rest[1], 10);
+    if (!rest[1] || Number.isNaN(number)) {
+      return { error: `Missing ${kind === "pull" ? "pull request" : "issue"} number` };
+    }
+    return { owner, repo, type: kind === "pull" ? "pull" : "issue", number };
+  }
+  if (kind === "commit") {
+    if (!rest[1]) return { error: "Missing commit SHA" };
+    return { owner, repo, type: "commit", ref: rest[1] };
+  }
+  if (kind === "blob") {
+    const ref = rest[1];
+    const path = rest.slice(2).join("/");
+    if (!ref || !path) return { error: "File URL must include a ref and a file path (/blob/<ref>/<path>)" };
+    return { owner, repo, type: "file", ref, path, ..._parseGithubLineRange(url.hash) };
+  }
+  if (kind === "tree") {
+    const ref = rest[1];
+    if (!ref) return { error: "Missing branch or tag ref (/tree/<ref>)" };
+    const path = rest.slice(2).join("/");
+    return { owner, repo, type: "tree", ref, ...path ? { path } : {} };
+  }
+  if (kind === "releases") {
+    if (rest[1] !== "tag" || !rest[2]) {
+      return { error: "Unsupported releases URL (expected /releases/tag/<name>)" };
+    }
+    return { owner, repo, type: "release", ref: rest[2] };
+  }
+  return { error: `Unsupported GitHub URL path: /${rest.join("/")}` };
+}
 
 // src/tools/color.ts
 var color_exports = {};
@@ -16866,7 +17075,8 @@ __export(ai_agent_exports, {
   summarizeForLlm: () => summarizeForLlm,
   trimToTokens: () => trimToTokens,
   unflattenJson: () => unflattenJson,
-  validateJsonSchema: () => validateJsonSchema
+  validateJsonSchema: () => validateJsonSchema,
+  vectorSimilarity: () => vectorSimilarity
 });
 var MODEL_PRICING = [
   { model: "gpt-4o", label: "GPT-4o", inputPer1M: 5, outputPer1M: 15 },
@@ -17784,6 +17994,35 @@ function summarizeForLlm(text, maxTokens = 200, strategy = "extractive") {
   const st = tok(summary);
   return { summary, originalTokens: ot, summaryTokens: st, compressionRatio: Math.round(st / Math.max(1, ot) * 100) / 100, sentencesKept: picked.length, sentencesTotal: sents.length };
 }
+function vectorSimilarity(a, b) {
+  if (!Array.isArray(a) || !Array.isArray(b)) return { error: "Both inputs must be arrays of numbers" };
+  if (a.length === 0 || b.length === 0) return { error: "Vectors must not be empty" };
+  if (a.length !== b.length) return { error: `Vectors must have the same length (got ${a.length} and ${b.length})` };
+  if (!a.every((n) => typeof n === "number" && Number.isFinite(n)) || !b.every((n) => typeof n === "number" && Number.isFinite(n))) {
+    return { error: "Vectors must contain only finite numbers" };
+  }
+  const round6 = (n) => Math.round(n * 1e6) / 1e6;
+  let dot = 0, sa = 0, sb = 0, sqDist = 0, absDist = 0;
+  for (let i = 0; i < a.length; i++) {
+    dot += a[i] * b[i];
+    sa += a[i] * a[i];
+    sb += b[i] * b[i];
+    const d = a[i] - b[i];
+    sqDist += d * d;
+    absDist += Math.abs(d);
+  }
+  const magA = Math.sqrt(sa), magB = Math.sqrt(sb);
+  const cosine = magA === 0 || magB === 0 ? 0 : dot / (magA * magB);
+  return {
+    dimensions: a.length,
+    dotProduct: round6(dot),
+    cosineSimilarity: round6(cosine),
+    euclideanDistance: round6(Math.sqrt(sqDist)),
+    manhattanDistance: round6(absDist),
+    magnitudeA: round6(magA),
+    magnitudeB: round6(magB)
+  };
+}
 
 // src/tools/media.ts
 var media_exports = {};

package/dist/index.d.cts

@@ -5,14 +5,14 @@ export { t as text } from './text-Bbx-tZ43.cjs';
 export { d as data } from './data-D8XTI7Du.cjs';
 export { g as generators } from './generators-BGtRGpJZ.cjs';
 export { t as time } from './time-DbT8fjaF.cjs';
-export { u as units } from './units-CkV4kAIs.cjs';
-export { n as network } from './network-DaNoZ5ER.cjs';
+export { u as units } from './units-BFTQwpBu.cjs';
+export { n as network } from './network-DZugNyAQ.cjs';
 export { a as api } from './api-Xl7OzIgq.cjs';
-export { c as code } from './code-C4skwg3l.cjs';
+export { c as code } from './code-Cn9uOIAh.cjs';
 export { c as color } from './color-tPwZCr9H.cjs';
 export { c as css } from './css-Cf7AMGM-.cjs';
 export { m as misc } from './misc-CA3N198T.cjs';
-export { a as ai_agent } from './ai_agent-CcpkV2DR.cjs';
+export { a as ai_agent } from './ai_agent-B-c59NXD.cjs';
 export { m as media } from './media-9HEpTPGA.cjs';
 
 declare const version = "0.1.0";

package/dist/index.d.ts

@@ -5,14 +5,14 @@ export { t as text } from './text-Bbx-tZ43.js';
 export { d as data } from './data-D8XTI7Du.js';
 export { g as generators } from './generators-BGtRGpJZ.js';
 export { t as time } from './time-DbT8fjaF.js';
-export { u as units } from './units-CkV4kAIs.js';
-export { n as network } from './network-DaNoZ5ER.js';
+export { u as units } from './units-BFTQwpBu.js';
+export { n as network } from './network-DZugNyAQ.js';
 export { a as api } from './api-Xl7OzIgq.js';
-export { c as code } from './code-C4skwg3l.js';
+export { c as code } from './code-Cn9uOIAh.js';
 export { c as color } from './color-tPwZCr9H.js';
 export { c as css } from './css-Cf7AMGM-.js';
 export { m as misc } from './misc-CA3N198T.js';
-export { a as ai_agent } from './ai_agent-CcpkV2DR.js';
+export { a as ai_agent } from './ai_agent-B-c59NXD.js';
 export { m as media } from './media-9HEpTPGA.js';
 
 declare const version = "0.1.0";

package/dist/index.js

@@ -1,12 +1,12 @@
 export { media_exports as media } from './chunk-XMKJYVKB.js';
-export { units_exports as units } from './chunk-M4MMO6C6.js';
-export { network_exports as network } from './chunk-OB56VNKJ.js';
+export { units_exports as units } from './chunk-U34B5XPK.js';
+export { network_exports as network } from './chunk-3QMUUTBH.js';
 export { api_exports as api } from './chunk-Q3B3YWOA.js';
-export { code_exports as code } from './chunk-Y5X34JAC.js';
+export { code_exports as code } from './chunk-L53LAVAD.js';
 export { color_exports as color } from './chunk-BPVAB4P2.js';
 export { css_exports as css } from './chunk-6YPV2AB5.js';
 export { misc_exports as misc } from './chunk-GX7H6TAX.js';
-export { ai_agent_exports as ai_agent } from './chunk-M35VJETW.js';
+export { ai_agent_exports as ai_agent } from './chunk-265NPGKH.js';
 export { json_exports as json } from './chunk-TSAGO3XP.js';
 export { encoding_exports as encoding } from './chunk-DOWQZUTP.js';
 export { hashing_exports as hashing } from './chunk-GEFVMGZR.js';

package/dist/{network-DaNoZ5ER.d.cts → network-DZugNyAQ.d.cts}

@@ -10,6 +10,7 @@
  *   - har-viewer    : parseHar
  *   - sitemap-validator: validateSitemap
  *   - robots-txt-validator: validateRobotsTxt
+ *   - user-agent-parser: parseUserAgent
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -222,6 +223,35 @@ interface RobotsValidationResult {
 declare function validateRobotsTxt(text: string): RobotsValidationResult | {
     error: string;
 };
+type UaDeviceType = 'desktop' | 'mobile' | 'tablet' | 'bot';
+interface UserAgentInfo {
+    browser: {
+        name: string;
+        version: string;
+    };
+    engine: {
+        name: string;
+        version: string;
+    };
+    os: {
+        name: string;
+        version: string;
+    };
+    device: {
+        type: UaDeviceType;
+    };
+    raw: string;
+}
+/**
+ * Parses a browser User-Agent string into browser, engine, OS, and device
+ * type via pattern matching against well-known UA token formats. Covers the
+ * major desktop/mobile browsers and common search-engine/social crawlers;
+ * it is not an exhaustive UA database and falls back to 'Unknown' fields
+ * for obscure or custom UA strings.
+ */
+declare function parseUserAgent(ua: string): UserAgentInfo | {
+    error: string;
+};
 
 declare const network_DNS_RECORD_TYPES: typeof DNS_RECORD_TYPES;
 type network_DnsRecord = DnsRecord;
@@ -246,6 +276,8 @@ type network_SitemapIssue = SitemapIssue;
 type network_SitemapUrlEntry = SitemapUrlEntry;
 type network_SitemapValidationResult = SitemapValidationResult;
 type network_StatusCode = StatusCode;
+type network_UaDeviceType = UaDeviceType;
+type network_UserAgentInfo = UserAgentInfo;
 declare const network_buildDnsQueryUrl: typeof buildDnsQueryUrl;
 declare const network_buildGeoUrl: typeof buildGeoUrl;
 declare const network_buildMapUrl: typeof buildMapUrl;
@@ -266,6 +298,7 @@ declare const network_isValidIpv6: typeof isValidIpv6;
 declare const network_parseDnsResponse: typeof parseDnsResponse;
 declare const network_parseGeoResponse: typeof parseGeoResponse;
 declare const network_parseHar: typeof parseHar;
+declare const network_parseUserAgent: typeof parseUserAgent;
 declare const network_searchHeaders: typeof searchHeaders;
 declare const network_searchStatusCodes: typeof searchStatusCodes;
 declare const network_statusCodeToText: typeof statusCodeToText;
@@ -276,7 +309,7 @@ declare const network_validateHeaderValue: typeof validateHeaderValue;
 declare const network_validateRobotsTxt: typeof validateRobotsTxt;
 declare const network_validateSitemap: typeof validateSitemap;
 declare namespace network {
-  export { network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
+  export { network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
 }
 
-export { getHeadersByCategory as A, getStatusByCategory as B, getStatusCode as C, DNS_RECORD_TYPES as D, isClientError as E, isServerError as F, type GeoResult as G, HTTP_HEADERS as H, isSuccess as I, isValidIp as J, isValidIpv4 as K, isValidIpv6 as L, parseDnsResponse as M, parseGeoResponse as N, parseHar as O, type ParsedDnsResult as P, searchHeaders as Q, type RobotsGroup as R, STATUS_CODES as S, searchStatusCodes as T, statusCodeToText as U, typeNumberToLabel as V, validateDomain as W, validateHeaderName as X, validateHeaderValue as Y, validateRobotsTxt as Z, validateSitemap as _, type DnsRecord as a, type DnsRecordType as b, type DnsResponse as c, type HarEntry as d, type HarParseResult as e, type HarSummary as f, type HeaderCategory as g, type HttpHeader as h, type ParsedGeoResult as i, type RobotsIssue as j, type RobotsRule as k, type RobotsValidationResult as l, type SitemapIndexEntry as m, network as n, type SitemapIssue as o, type SitemapUrlEntry as p, type SitemapValidationResult as q, type StatusCode as r, buildDnsQueryUrl as s, buildGeoUrl as t, buildMapUrl as u, countryCodeToFlag as v, formatCoordinates as w, formatTtl as x, getByCategory as y, getHeader as z };
+export { validateHeaderValue as $, getHeader as A, getHeadersByCategory as B, getStatusByCategory as C, DNS_RECORD_TYPES as D, getStatusCode as E, isClientError as F, type GeoResult as G, HTTP_HEADERS as H, isServerError as I, isSuccess as J, isValidIp as K, isValidIpv4 as L, isValidIpv6 as M, parseDnsResponse as N, parseGeoResponse as O, type ParsedDnsResult as P, parseHar as Q, type RobotsGroup as R, STATUS_CODES as S, parseUserAgent as T, type UaDeviceType as U, searchHeaders as V, searchStatusCodes as W, statusCodeToText as X, typeNumberToLabel as Y, validateDomain as Z, validateHeaderName as _, type DnsRecord as a, validateRobotsTxt as a0, validateSitemap as a1, type DnsRecordType as b, type DnsResponse as c, type HarEntry as d, type HarParseResult as e, type HarSummary as f, type HeaderCategory as g, type HttpHeader as h, type ParsedGeoResult as i, type RobotsIssue as j, type RobotsRule as k, type RobotsValidationResult as l, type SitemapIndexEntry as m, network as n, type SitemapIssue as o, type SitemapUrlEntry as p, type SitemapValidationResult as q, type StatusCode as r, type UserAgentInfo as s, buildDnsQueryUrl as t, buildGeoUrl as u, buildMapUrl as v, countryCodeToFlag as w, formatCoordinates as x, formatTtl as y, getByCategory as z };

package/dist/{network-DaNoZ5ER.d.ts → network-DZugNyAQ.d.ts}

@@ -10,6 +10,7 @@
  *   - har-viewer    : parseHar
  *   - sitemap-validator: validateSitemap
  *   - robots-txt-validator: validateRobotsTxt
+ *   - user-agent-parser: parseUserAgent
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -222,6 +223,35 @@ interface RobotsValidationResult {
 declare function validateRobotsTxt(text: string): RobotsValidationResult | {
     error: string;
 };
+type UaDeviceType = 'desktop' | 'mobile' | 'tablet' | 'bot';
+interface UserAgentInfo {
+    browser: {
+        name: string;
+        version: string;
+    };
+    engine: {
+        name: string;
+        version: string;
+    };
+    os: {
+        name: string;
+        version: string;
+    };
+    device: {
+        type: UaDeviceType;
+    };
+    raw: string;
+}
+/**
+ * Parses a browser User-Agent string into browser, engine, OS, and device
+ * type via pattern matching against well-known UA token formats. Covers the
+ * major desktop/mobile browsers and common search-engine/social crawlers;
+ * it is not an exhaustive UA database and falls back to 'Unknown' fields
+ * for obscure or custom UA strings.
+ */
+declare function parseUserAgent(ua: string): UserAgentInfo | {
+    error: string;
+};
 
 declare const network_DNS_RECORD_TYPES: typeof DNS_RECORD_TYPES;
 type network_DnsRecord = DnsRecord;
@@ -246,6 +276,8 @@ type network_SitemapIssue = SitemapIssue;
 type network_SitemapUrlEntry = SitemapUrlEntry;
 type network_SitemapValidationResult = SitemapValidationResult;
 type network_StatusCode = StatusCode;
+type network_UaDeviceType = UaDeviceType;
+type network_UserAgentInfo = UserAgentInfo;
 declare const network_buildDnsQueryUrl: typeof buildDnsQueryUrl;
 declare const network_buildGeoUrl: typeof buildGeoUrl;
 declare const network_buildMapUrl: typeof buildMapUrl;
@@ -266,6 +298,7 @@ declare const network_isValidIpv6: typeof isValidIpv6;
 declare const network_parseDnsResponse: typeof parseDnsResponse;
 declare const network_parseGeoResponse: typeof parseGeoResponse;
 declare const network_parseHar: typeof parseHar;
+declare const network_parseUserAgent: typeof parseUserAgent;
 declare const network_searchHeaders: typeof searchHeaders;
 declare const network_searchStatusCodes: typeof searchStatusCodes;
 declare const network_statusCodeToText: typeof statusCodeToText;
@@ -276,7 +309,7 @@ declare const network_validateHeaderValue: typeof validateHeaderValue;
 declare const network_validateRobotsTxt: typeof validateRobotsTxt;
 declare const network_validateSitemap: typeof validateSitemap;
 declare namespace network {
-  export { network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
+  export { network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
 }
 
-export { getHeadersByCategory as A, getStatusByCategory as B, getStatusCode as C, DNS_RECORD_TYPES as D, isClientError as E, isServerError as F, type GeoResult as G, HTTP_HEADERS as H, isSuccess as I, isValidIp as J, isValidIpv4 as K, isValidIpv6 as L, parseDnsResponse as M, parseGeoResponse as N, parseHar as O, type ParsedDnsResult as P, searchHeaders as Q, type RobotsGroup as R, STATUS_CODES as S, searchStatusCodes as T, statusCodeToText as U, typeNumberToLabel as V, validateDomain as W, validateHeaderName as X, validateHeaderValue as Y, validateRobotsTxt as Z, validateSitemap as _, type DnsRecord as a, type DnsRecordType as b, type DnsResponse as c, type HarEntry as d, type HarParseResult as e, type HarSummary as f, type HeaderCategory as g, type HttpHeader as h, type ParsedGeoResult as i, type RobotsIssue as j, type RobotsRule as k, type RobotsValidationResult as l, type SitemapIndexEntry as m, network as n, type SitemapIssue as o, type SitemapUrlEntry as p, type SitemapValidationResult as q, type StatusCode as r, buildDnsQueryUrl as s, buildGeoUrl as t, buildMapUrl as u, countryCodeToFlag as v, formatCoordinates as w, formatTtl as x, getByCategory as y, getHeader as z };
+export { validateHeaderValue as $, getHeader as A, getHeadersByCategory as B, getStatusByCategory as C, DNS_RECORD_TYPES as D, getStatusCode as E, isClientError as F, type GeoResult as G, HTTP_HEADERS as H, isServerError as I, isSuccess as J, isValidIp as K, isValidIpv4 as L, isValidIpv6 as M, parseDnsResponse as N, parseGeoResponse as O, type ParsedDnsResult as P, parseHar as Q, type RobotsGroup as R, STATUS_CODES as S, parseUserAgent as T, type UaDeviceType as U, searchHeaders as V, searchStatusCodes as W, statusCodeToText as X, typeNumberToLabel as Y, validateDomain as Z, validateHeaderName as _, type DnsRecord as a, validateRobotsTxt as a0, validateSitemap as a1, type DnsRecordType as b, type DnsResponse as c, type HarEntry as d, type HarParseResult as e, type HarSummary as f, type HeaderCategory as g, type HttpHeader as h, type ParsedGeoResult as i, type RobotsIssue as j, type RobotsRule as k, type RobotsValidationResult as l, type SitemapIndexEntry as m, network as n, type SitemapIssue as o, type SitemapUrlEntry as p, type SitemapValidationResult as q, type StatusCode as r, type UserAgentInfo as s, buildDnsQueryUrl as t, buildGeoUrl as u, buildMapUrl as v, countryCodeToFlag as w, formatCoordinates as x, formatTtl as y, getByCategory as z };

package/dist/tools/ai_agent.cjs

@@ -917,6 +917,35 @@ function summarizeForLlm(text, maxTokens = 200, strategy = "extractive") {
   const st = tok(summary);
   return { summary, originalTokens: ot, summaryTokens: st, compressionRatio: Math.round(st / Math.max(1, ot) * 100) / 100, sentencesKept: picked.length, sentencesTotal: sents.length };
 }
+function vectorSimilarity(a, b) {
+  if (!Array.isArray(a) || !Array.isArray(b)) return { error: "Both inputs must be arrays of numbers" };
+  if (a.length === 0 || b.length === 0) return { error: "Vectors must not be empty" };
+  if (a.length !== b.length) return { error: `Vectors must have the same length (got ${a.length} and ${b.length})` };
+  if (!a.every((n) => typeof n === "number" && Number.isFinite(n)) || !b.every((n) => typeof n === "number" && Number.isFinite(n))) {
+    return { error: "Vectors must contain only finite numbers" };
+  }
+  const round6 = (n) => Math.round(n * 1e6) / 1e6;
+  let dot = 0, sa = 0, sb = 0, sqDist = 0, absDist = 0;
+  for (let i = 0; i < a.length; i++) {
+    dot += a[i] * b[i];
+    sa += a[i] * a[i];
+    sb += b[i] * b[i];
+    const d = a[i] - b[i];
+    sqDist += d * d;
+    absDist += Math.abs(d);
+  }
+  const magA = Math.sqrt(sa), magB = Math.sqrt(sb);
+  const cosine = magA === 0 || magB === 0 ? 0 : dot / (magA * magB);
+  return {
+    dimensions: a.length,
+    dotProduct: round6(dot),
+    cosineSimilarity: round6(cosine),
+    euclideanDistance: round6(Math.sqrt(sqDist)),
+    manhattanDistance: round6(absDist),
+    magnitudeA: round6(magA),
+    magnitudeB: round6(magB)
+  };
+}
 
 exports.MODEL_PRICING = MODEL_PRICING;
 exports.chunkText = chunkText;
@@ -947,3 +976,4 @@ exports.summarizeForLlm = summarizeForLlm;
 exports.trimToTokens = trimToTokens;
 exports.unflattenJson = unflattenJson;
 exports.validateJsonSchema = validateJsonSchema;
+exports.vectorSimilarity = vectorSimilarity;

package/dist/tools/ai_agent.d.cts

@@ -1 +1 @@
-export { C as ChunkStrategy, b as CompressHtmlResult, c as CompressJsonResult, d as CompressMarkdownResult, e as CostEstimate, D as DedupeResult, f as DedupeStrategy, g as DiffEntry2, h as DiffOp2, i as DiffResult2, E as Entity2, j as EntityType2, k as ExtractJsonResult, l as ExtractKeywordsResult, m as ExtractUrlsResult, I as InjectionDetectResult, n as InjectionFinding, J as JsonBlock, o as JsonRepairResult, K as Keyword, M as MODEL_PRICING, p as MergeResult, q as MergeStrategy, r as ModelPricing, P as PiiDetectResult, s as PiiFinding, t as PiiType, R as RankedChunk, u as RelevanceResult, S as SanitizeResult, v as SecretDetectResult, w as SecretFinding, x as SecretType, y as SummaryResult, T as TableResult2, z as TextChunk, A as TokenEstimate, B as TokenEstimateResult, F as TrimResult, G as TrimStrategy, U as UrlMatch, V as ValidationError, H as ValidationResult, L as chunkText, N as compressHtml, O as compressJson, Q as compressMarkdown, W as deduplicateLines, X as detectPii, Y as detectPromptInjection, Z as detectSecrets, _ as diffJson, $ as estimateCost, a0 as estimateTokens, a1 as expandQuery, a2 as extractEntities, a3 as extractJson, a4 as extractKeywords, a5 as extractTables, a6 as extractUrls, a7 as flattenJson, a8 as mergeJson, a9 as redactPii, aa as repairJson, ab as rerankChunks, ac as sanitizeHtml, ad as scoreRelevance, ae as summarizeForLlm, af as trimToTokens, ag as unflattenJson, ah as validateJsonSchema } from '../ai_agent-CcpkV2DR.cjs';
+export { C as ChunkStrategy, b as CompressHtmlResult, c as CompressJsonResult, d as CompressMarkdownResult, e as CostEstimate, D as DedupeResult, f as DedupeStrategy, g as DiffEntry2, h as DiffOp2, i as DiffResult2, E as Entity2, j as EntityType2, k as ExtractJsonResult, l as ExtractKeywordsResult, m as ExtractUrlsResult, I as InjectionDetectResult, n as InjectionFinding, J as JsonBlock, o as JsonRepairResult, K as Keyword, M as MODEL_PRICING, p as MergeResult, q as MergeStrategy, r as ModelPricing, P as PiiDetectResult, s as PiiFinding, t as PiiType, R as RankedChunk, u as RelevanceResult, S as SanitizeResult, v as SecretDetectResult, w as SecretFinding, x as SecretType, y as SummaryResult, T as TableResult2, z as TextChunk, A as TokenEstimate, B as TokenEstimateResult, F as TrimResult, G as TrimStrategy, U as UrlMatch, V as ValidationError, H as ValidationResult, L as VectorSimilarityResult, N as chunkText, O as compressHtml, Q as compressJson, W as compressMarkdown, X as deduplicateLines, Y as detectPii, Z as detectPromptInjection, _ as detectSecrets, $ as diffJson, a0 as estimateCost, a1 as estimateTokens, a2 as expandQuery, a3 as extractEntities, a4 as extractJson, a5 as extractKeywords, a6 as extractTables, a7 as extractUrls, a8 as flattenJson, a9 as mergeJson, aa as redactPii, ab as repairJson, ac as rerankChunks, ad as sanitizeHtml, ae as scoreRelevance, af as summarizeForLlm, ag as trimToTokens, ah as unflattenJson, ai as validateJsonSchema, aj as vectorSimilarity } from '../ai_agent-B-c59NXD.cjs';