@utilix-tech/sdk 0.30.0 → 0.32.0

package/dist/{data-XRb0D7Zn.d.ts → data-C4lCByXw.d.ts}

@@ -13,6 +13,7 @@
  *  - env-diff-checker: diffEnvExample
  *  - ndjson-formatter: validateNdjson, minifyNdjson, formatNdjson, ndjsonToJsonArray, jsonArrayToNdjson
  *  - subtitle-converter: parseSubtitleTimestamp, formatSubtitleTimestamp, detectSubtitleFormat, parseSubtitles, serializeSubtitles, convertSubtitles, shiftSubtitles
+ *  - markdown-front-matter-parser: parseFrontMatter
  */
 interface ValidationResult {
     valid: boolean;
@@ -272,6 +273,24 @@ declare function convertSubtitles(input: string, target: SubtitleFormat, sourceF
 declare function shiftSubtitles(input: string, offsetSeconds: number, target?: SubtitleFormat): ConvertedSubtitles | {
     error: string;
 };
+interface FrontMatterResult {
+    frontMatter: Record<string, unknown>;
+    body: string;
+    hasFrontMatter: boolean;
+    raw: string;
+}
+interface FrontMatterError {
+    error: string;
+}
+/**
+ * Split a Markdown document into its YAML front matter (delimited by --- lines
+ * at the top) and body content. Parses simple scalar values (strings, quoted
+ * strings, booleans, numbers, null), inline arrays (`tags: [a, b]`), and YAML
+ * block lists (`tags:\n  - a\n  - b`). Not a full YAML parser: nested mappings
+ * and multi-line block scalars are not supported. A document with no opening
+ * "---" delimiter is returned as-is with `hasFrontMatter: false`.
+ */
+declare function parseFrontMatter(input: string): FrontMatterResult | FrontMatterError;
 
 type data_ConvertedSubtitles = ConvertedSubtitles;
 type data_CsvParseResult = CsvParseResult;
@@ -279,6 +298,8 @@ type data_EnvDiffError = EnvDiffError;
 type data_EnvDiffResult = EnvDiffResult;
 type data_EnvEntry = EnvEntry;
 type data_EnvParseResult = EnvParseResult;
+type data_FrontMatterError = FrontMatterError;
+type data_FrontMatterResult = FrontMatterResult;
 type data_IniSection = IniSection;
 type data_NdjsonLineResult = NdjsonLineResult;
 type data_NdjsonValidateResult = NdjsonValidateResult;
@@ -318,6 +339,7 @@ declare const data_minifyXml: typeof minifyXml;
 declare const data_ndjsonToJsonArray: typeof ndjsonToJsonArray;
 declare const data_parseCsv: typeof parseCsv;
 declare const data_parseEnv: typeof parseEnv;
+declare const data_parseFrontMatter: typeof parseFrontMatter;
 declare const data_parseIni: typeof parseIni;
 declare const data_parseSubtitleTimestamp: typeof parseSubtitleTimestamp;
 declare const data_parseSubtitles: typeof parseSubtitles;
@@ -335,7 +357,7 @@ declare const data_validateXml: typeof validateXml;
 declare const data_validateYaml: typeof validateYaml;
 declare const data_xmlToJson: typeof xmlToJson;
 declare namespace data {
-  export { type data_ConvertedSubtitles as ConvertedSubtitles, type data_CsvParseResult as CsvParseResult, type data_EnvDiffError as EnvDiffError, type data_EnvDiffResult as EnvDiffResult, type data_EnvEntry as EnvEntry, type data_EnvParseResult as EnvParseResult, type data_IniSection as IniSection, type data_NdjsonLineResult as NdjsonLineResult, type data_NdjsonValidateResult as NdjsonValidateResult, type data_ParseOptions as ParseOptions, type data_ParsedIni as ParsedIni, type data_ParsedSubtitles as ParsedSubtitles, type data_SubtitleCue as SubtitleCue, type data_SubtitleFormat as SubtitleFormat, type data_TomlFormatResult as TomlFormatResult, type data_ValidationResult as ValidationResult, type data_XmlFormatResult as XmlFormatResult, type data_XmlToJsonOptions as XmlToJsonOptions, data_convertSubtitles as convertSubtitles, data_csvToJson as csvToJson, data_detectDelimiter as detectDelimiter, data_detectSubtitleFormat as detectSubtitleFormat, data_diffEnvExample as diffEnvExample, data_envToExport as envToExport, data_envToJson as envToJson, data_formatNdjson as formatNdjson, data_formatSubtitleTimestamp as formatSubtitleTimestamp, data_formatToml as formatToml, data_formatXml as formatXml, data_getSection as getSection, data_getSectionNames as getSectionNames, data_getTomlStats as getTomlStats, data_getXmlStats as getXmlStats, data_getYamlStats as getYamlStats, data_iniToJson as iniToJson, data_jsonArrayToNdjson as jsonArrayToNdjson, data_jsonToIni as jsonToIni, data_jsonToToml as jsonToToml, data_jsonToXml as jsonToXml, data_minifyNdjson as minifyNdjson, data_minifyToml as minifyToml, data_minifyXml as minifyXml, data_ndjsonToJsonArray as ndjsonToJsonArray, data_parseCsv as parseCsv, data_parseEnv as parseEnv, data_parseIni as parseIni, data_parseSubtitleTimestamp as parseSubtitleTimestamp, data_parseSubtitles as parseSubtitles, data_parseXmlToObject as parseXmlToObject, data_serializeSubtitles as serializeSubtitles, data_shiftSubtitles as shiftSubtitles, data_stringifyIni as stringifyIni, data_toCsvString as toCsvString, data_tomlToJson as tomlToJson, data_validateEnvKey as validateEnvKey, data_validateIni as validateIni, data_validateNdjson as validateNdjson, data_validateToml as validateToml, data_validateXml as validateXml, data_validateYaml as validateYaml, data_xmlToJson as xmlToJson };
+  export { type data_ConvertedSubtitles as ConvertedSubtitles, type data_CsvParseResult as CsvParseResult, type data_EnvDiffError as EnvDiffError, type data_EnvDiffResult as EnvDiffResult, type data_EnvEntry as EnvEntry, type data_EnvParseResult as EnvParseResult, type data_FrontMatterError as FrontMatterError, type data_FrontMatterResult as FrontMatterResult, type data_IniSection as IniSection, type data_NdjsonLineResult as NdjsonLineResult, type data_NdjsonValidateResult as NdjsonValidateResult, type data_ParseOptions as ParseOptions, type data_ParsedIni as ParsedIni, type data_ParsedSubtitles as ParsedSubtitles, type data_SubtitleCue as SubtitleCue, type data_SubtitleFormat as SubtitleFormat, type data_TomlFormatResult as TomlFormatResult, type data_ValidationResult as ValidationResult, type data_XmlFormatResult as XmlFormatResult, type data_XmlToJsonOptions as XmlToJsonOptions, data_convertSubtitles as convertSubtitles, data_csvToJson as csvToJson, data_detectDelimiter as detectDelimiter, data_detectSubtitleFormat as detectSubtitleFormat, data_diffEnvExample as diffEnvExample, data_envToExport as envToExport, data_envToJson as envToJson, data_formatNdjson as formatNdjson, data_formatSubtitleTimestamp as formatSubtitleTimestamp, data_formatToml as formatToml, data_formatXml as formatXml, data_getSection as getSection, data_getSectionNames as getSectionNames, data_getTomlStats as getTomlStats, data_getXmlStats as getXmlStats, data_getYamlStats as getYamlStats, data_iniToJson as iniToJson, data_jsonArrayToNdjson as jsonArrayToNdjson, data_jsonToIni as jsonToIni, data_jsonToToml as jsonToToml, data_jsonToXml as jsonToXml, data_minifyNdjson as minifyNdjson, data_minifyToml as minifyToml, data_minifyXml as minifyXml, data_ndjsonToJsonArray as ndjsonToJsonArray, data_parseCsv as parseCsv, data_parseEnv as parseEnv, data_parseFrontMatter as parseFrontMatter, data_parseIni as parseIni, data_parseSubtitleTimestamp as parseSubtitleTimestamp, data_parseSubtitles as parseSubtitles, data_parseXmlToObject as parseXmlToObject, data_serializeSubtitles as serializeSubtitles, data_shiftSubtitles as shiftSubtitles, data_stringifyIni as stringifyIni, data_toCsvString as toCsvString, data_tomlToJson as tomlToJson, data_validateEnvKey as validateEnvKey, data_validateIni as validateIni, data_validateNdjson as validateNdjson, data_validateToml as validateToml, data_validateXml as validateXml, data_validateYaml as validateYaml, data_xmlToJson as xmlToJson };
 }
 
-export { toCsvString as $, iniToJson as A, jsonArrayToNdjson as B, type ConvertedSubtitles as C, jsonToIni as D, type EnvDiffError as E, jsonToToml as F, jsonToXml as G, minifyNdjson as H, type IniSection as I, minifyToml as J, minifyXml as K, ndjsonToJsonArray as L, parseCsv as M, type NdjsonLineResult as N, parseEnv as O, type ParseOptions as P, parseIni as Q, parseSubtitleTimestamp as R, type SubtitleCue as S, type TomlFormatResult as T, parseSubtitles as U, type ValidationResult as V, parseXmlToObject as W, type XmlFormatResult as X, serializeSubtitles as Y, shiftSubtitles as Z, stringifyIni as _, type CsvParseResult as a, tomlToJson as a0, validateEnvKey as a1, validateIni as a2, validateNdjson as a3, validateToml as a4, validateXml as a5, validateYaml as a6, xmlToJson as a7, type EnvDiffResult as b, type EnvEntry as c, data as d, type EnvParseResult as e, type NdjsonValidateResult as f, type ParsedIni as g, type ParsedSubtitles as h, type SubtitleFormat as i, type XmlToJsonOptions as j, convertSubtitles as k, csvToJson as l, detectDelimiter as m, detectSubtitleFormat as n, diffEnvExample as o, envToExport as p, envToJson as q, formatNdjson as r, formatSubtitleTimestamp as s, formatToml as t, formatXml as u, getSection as v, getSectionNames as w, getTomlStats as x, getXmlStats as y, getYamlStats as z };
+export { serializeSubtitles as $, getYamlStats as A, iniToJson as B, type ConvertedSubtitles as C, jsonArrayToNdjson as D, type EnvDiffError as E, type FrontMatterError as F, jsonToIni as G, jsonToToml as H, type IniSection as I, jsonToXml as J, minifyNdjson as K, minifyToml as L, minifyXml as M, type NdjsonLineResult as N, ndjsonToJsonArray as O, type ParseOptions as P, parseCsv as Q, parseEnv as R, type SubtitleCue as S, type TomlFormatResult as T, parseFrontMatter as U, type ValidationResult as V, parseIni as W, type XmlFormatResult as X, parseSubtitleTimestamp as Y, parseSubtitles as Z, parseXmlToObject as _, type CsvParseResult as a, shiftSubtitles as a0, stringifyIni as a1, toCsvString as a2, tomlToJson as a3, validateEnvKey as a4, validateIni as a5, validateNdjson as a6, validateToml as a7, validateXml as a8, validateYaml as a9, xmlToJson as aa, type EnvDiffResult as b, type EnvEntry as c, data as d, type EnvParseResult as e, type FrontMatterResult as f, type NdjsonValidateResult as g, type ParsedIni as h, type ParsedSubtitles as i, type SubtitleFormat as j, type XmlToJsonOptions as k, convertSubtitles as l, csvToJson as m, detectDelimiter as n, detectSubtitleFormat as o, diffEnvExample as p, envToExport as q, envToJson as r, formatNdjson as s, formatSubtitleTimestamp as t, formatToml as u, formatXml as v, getSection as w, getSectionNames as x, getTomlStats as y, getXmlStats as z };

package/dist/index.cjs

@@ -2017,6 +2017,7 @@ __export(text_exports, {
   LINE_OPS: () => LINE_OPS,
   MORSE_CODE: () => MORSE_CODE,
   addBorder: () => addBorder,
+  analyzeSentenceLengths: () => analyzeSentenceLengths,
   analyzeText: () => analyzeText,
   applyOp: () => applyOp,
   applyOps: () => applyOps,
@@ -4605,6 +4606,71 @@ function calculateStringDistance(a, b, options) {
   const similarity = maxLength === 0 ? 1 : Math.round((1 - distance / maxLength) * 1e4) / 1e4;
   return { a, b, distance, similarity, maxLength, mode };
 }
+function splitIntoSentencesForLengthDist(text) {
+  const matches = text.match(/[^.!?]+[.!?]*/g);
+  if (!matches) return [];
+  return matches.map((s) => s.trim()).filter((s) => s.length > 0);
+}
+function countWordsInSentence(sentence) {
+  return (sentence.match(/[a-zA-Z']+/g) ?? []).length;
+}
+function analyzeSentenceLengths(text) {
+  const sentences = splitIntoSentencesForLengthDist(text);
+  const lengths = sentences.map(countWordsInSentence).filter((n) => n > 0);
+  if (lengths.length === 0) {
+    return {
+      sentenceCount: 0,
+      lengths: [],
+      minLength: 0,
+      maxLength: 0,
+      meanLength: 0,
+      medianLength: 0,
+      stdDev: 0,
+      coefficientOfVariation: 0,
+      consistency: "No sentences to analyze",
+      buckets: []
+    };
+  }
+  const sentenceCount2 = lengths.length;
+  const minLength = Math.min(...lengths);
+  const maxLength = Math.max(...lengths);
+  const meanLength = lengths.reduce((a, b) => a + b, 0) / sentenceCount2;
+  const sorted = [...lengths].sort((a, b) => a - b);
+  const mid = Math.floor(sorted.length / 2);
+  const medianLength = sorted.length % 2 === 0 ? (sorted[mid - 1] + sorted[mid]) / 2 : sorted[mid];
+  const variance = lengths.reduce((sum, n) => sum + (n - meanLength) ** 2, 0) / sentenceCount2;
+  const stdDev = Math.sqrt(variance);
+  const coefficientOfVariation = meanLength > 0 ? stdDev / meanLength : 0;
+  let consistency;
+  if (coefficientOfVariation < 0.3) consistency = "Consistent \u2014 sentence lengths vary little";
+  else if (coefficientOfVariation < 0.6) consistency = "Moderate variation in sentence length";
+  else consistency = "Highly variable sentence length";
+  const bucketWidth = 5;
+  const bucketCount = Math.max(1, Math.ceil(maxLength / bucketWidth));
+  const buckets = [];
+  for (let i = 0; i < bucketCount; i++) {
+    const min = i * bucketWidth + 1;
+    const max = (i + 1) * bucketWidth;
+    buckets.push({ label: `${min}-${max}`, min, max, count: 0 });
+  }
+  for (const len of lengths) {
+    const idx = Math.min(Math.floor((len - 1) / bucketWidth), bucketCount - 1);
+    buckets[idx].count++;
+  }
+  const round23 = (n) => Math.round(n * 100) / 100;
+  return {
+    sentenceCount: sentenceCount2,
+    lengths,
+    minLength,
+    maxLength,
+    meanLength: round23(meanLength),
+    medianLength: round23(medianLength),
+    stdDev: round23(stdDev),
+    coefficientOfVariation: round23(coefficientOfVariation),
+    consistency,
+    buckets
+  };
+}
 
 // src/tools/data.ts
 var data_exports = {};
@@ -4636,6 +4702,7 @@ __export(data_exports, {
   ndjsonToJsonArray: () => ndjsonToJsonArray,
   parseCsv: () => parseCsv,
   parseEnv: () => parseEnv,
+  parseFrontMatter: () => parseFrontMatter,
   parseIni: () => parseIni,
   parseSubtitleTimestamp: () => parseSubtitleTimestamp,
   parseSubtitles: () => parseSubtitles,
@@ -5938,6 +6005,70 @@ function shiftSubtitles(input, offsetSeconds, target) {
     warnings
   };
 }
+function parseFrontMatterScalar(value) {
+  if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+    return value.slice(1, -1);
+  }
+  if (value === "true") return true;
+  if (value === "false") return false;
+  if (value === "null" || value === "~") return null;
+  if (value !== "" && !Number.isNaN(Number(value))) return Number(value);
+  return value;
+}
+function parseFrontMatter(input) {
+  if (typeof input !== "string" || input.length === 0) return { error: "input is required" };
+  const normalized = input.replace(/\r\n/g, "\n");
+  if (!normalized.startsWith("---\n") && normalized !== "---") {
+    return { frontMatter: {}, body: input, hasFrontMatter: false, raw: "" };
+  }
+  const closingIdx = normalized.indexOf("\n---", 4);
+  if (closingIdx === -1) {
+    return { error: 'Front matter opening delimiter found but no closing "---" delimiter' };
+  }
+  const raw = normalized.slice(4, closingIdx);
+  let afterClose = normalized.slice(closingIdx + 4);
+  if (afterClose.startsWith("\n")) afterClose = afterClose.slice(1);
+  const frontMatter = {};
+  const rawLines = raw.split("\n");
+  let i = 0;
+  while (i < rawLines.length) {
+    const line = rawLines[i];
+    if (line.trim() === "" || line.trim().startsWith("#")) {
+      i++;
+      continue;
+    }
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) return { error: `Invalid front matter line ${i + 1}: expected "key: value"` };
+    const key = line.slice(0, colonIdx).trim();
+    if (!key) return { error: `Invalid front matter line ${i + 1}: empty key` };
+    const rest = line.slice(colonIdx + 1).trim();
+    if (rest === "") {
+      const listItems = [];
+      let j = i + 1;
+      while (j < rawLines.length && /^\s*-\s+/.test(rawLines[j])) {
+        listItems.push(rawLines[j].replace(/^\s*-\s+/, "").trim());
+        j++;
+      }
+      if (listItems.length > 0) {
+        frontMatter[key] = listItems.map(parseFrontMatterScalar);
+        i = j;
+        continue;
+      }
+      frontMatter[key] = null;
+      i++;
+      continue;
+    }
+    if (rest.startsWith("[") && rest.endsWith("]")) {
+      const inner = rest.slice(1, -1).trim();
+      frontMatter[key] = inner === "" ? [] : inner.split(",").map((s) => parseFrontMatterScalar(s.trim()));
+      i++;
+      continue;
+    }
+    frontMatter[key] = parseFrontMatterScalar(rest);
+    i++;
+  }
+  return { frontMatter, body: afterClose, hasFrontMatter: true, raw };
+}
 
 // src/tools/generators.ts
 var generators_exports = {};
@@ -7357,6 +7488,7 @@ __export(units_exports, {
   calculateBreakEven: () => calculateBreakEven,
   calculateCompoundInterest: () => calculateCompoundInterest,
   calculateDiscount: () => calculateDiscount,
+  calculateEmi: () => calculateEmi,
   calculateLoan: () => calculateLoan,
   calculateMarginMarkup: () => calculateMarginMarkup,
   calculatePercentageChange: () => calculatePercentageChange,
@@ -9011,6 +9143,61 @@ function calculateRuleOf72(value, direction) {
     errorPercent: round4(errorPercent)
   };
 }
+function calculateEmi(principal, annualRatePercent, tenure, tenureUnit = "years") {
+  if (!Number.isFinite(principal) || principal <= 0) return { error: "Principal must be a positive number" };
+  if (!Number.isFinite(annualRatePercent) || annualRatePercent < 0) {
+    return { error: "Annual interest rate must be zero or a positive number" };
+  }
+  if (tenureUnit !== "years" && tenureUnit !== "months") {
+    return { error: 'tenureUnit must be "years" or "months"' };
+  }
+  if (!Number.isFinite(tenure) || tenure <= 0) return { error: "Tenure must be a positive number" };
+  const tenureMonths = Math.round(tenureUnit === "years" ? tenure * 12 : tenure);
+  if (tenureMonths <= 0) return { error: "Tenure must resolve to at least 1 month" };
+  const monthlyRate = annualRatePercent / 100 / 12;
+  let emi;
+  if (monthlyRate === 0) {
+    emi = principal / tenureMonths;
+  } else {
+    const factor = Math.pow(1 + monthlyRate, tenureMonths);
+    emi = principal * monthlyRate * factor / (factor - 1);
+  }
+  const yearlyBreakdown = [];
+  let balance = round2(principal);
+  let totalPayment = 0;
+  let yearPrincipal = 0;
+  let yearInterest = 0;
+  let year = 1;
+  for (let month = 1; month <= tenureMonths; month++) {
+    const interest = monthlyRate === 0 ? 0 : round2(balance * monthlyRate);
+    let principalPortion = round2(emi) - interest;
+    if (month === tenureMonths || principalPortion > balance) principalPortion = balance;
+    const payment = round2(principalPortion + interest);
+    balance = Math.max(round2(balance - principalPortion), 0);
+    totalPayment += payment;
+    yearPrincipal += principalPortion;
+    yearInterest += interest;
+    const isYearEnd = month % 12 === 0 || month === tenureMonths;
+    if (isYearEnd) {
+      yearlyBreakdown.push({
+        year,
+        principalPaid: round2(yearPrincipal),
+        interestPaid: round2(yearInterest),
+        balance
+      });
+      year += 1;
+      yearPrincipal = 0;
+      yearInterest = 0;
+    }
+  }
+  return {
+    emi: round2(emi),
+    totalInterest: round2(totalPayment - principal),
+    totalPayment: round2(totalPayment),
+    tenureMonths,
+    yearlyBreakdown
+  };
+}
 
 // src/tools/network.ts
 var network_exports = {};
@@ -18565,6 +18752,7 @@ __export(ai_agent_exports, {
   extractTables: () => extractTables,
   extractUrls: () => extractUrls,
   flattenJson: () => flattenJson,
+  formatFewShotExamples: () => formatFewShotExamples,
   mergeJson: () => mergeJson,
   redactPii: () => redactPii,
   repairJson: () => repairJson,
@@ -19522,6 +19710,29 @@ function vectorSimilarity(a, b) {
     magnitudeB: round6(magB)
   };
 }
+function formatFewShotExamples(examples, format = "numbered", delimiter = "---") {
+  const valid = (examples ?? []).filter((e) => e?.input?.trim() && e?.output?.trim());
+  if (valid.length === 0) {
+    return { formatted: "", exampleCount: 0, format };
+  }
+  let formatted;
+  if (format === "xml") {
+    formatted = valid.map((e) => `<example>
+  <input>${e.input.trim()}</input>
+  <output>${e.output.trim()}</output>
+</example>`).join("\n\n");
+  } else if (format === "delimiter") {
+    formatted = valid.map((e) => `Input: ${e.input.trim()}
+Output: ${e.output.trim()}`).join(`
+${delimiter}
+`);
+  } else {
+    formatted = valid.map((e, i) => `Example ${i + 1}:
+Input: ${e.input.trim()}
+Output: ${e.output.trim()}`).join("\n\n");
+  }
+  return { formatted, exampleCount: valid.length, format };
+}
 
 // src/tools/media.ts
 var media_exports = {};

package/dist/index.d.cts

@@ -1,18 +1,18 @@
 export { j as json } from './json-Ta9JykSB.cjs';
 export { e as encoding } from './encoding-Dk3wpmb3.cjs';
 export { h as hashing } from './hashing-CnetQFD_.cjs';
-export { t as text } from './text-D1fySkCB.cjs';
-export { d as data } from './data-XRb0D7Zn.cjs';
+export { t as text } from './text-CA-zuD0C.cjs';
+export { d as data } from './data-C4lCByXw.cjs';
 export { g as generators } from './generators-Du8cBesn.cjs';
 export { t as time } from './time-KqJjdqII.cjs';
-export { u as units } from './units-COt5uI20.cjs';
+export { u as units } from './units-DQYLZd1n.cjs';
 export { n as network } from './network-D7Epuerc.cjs';
 export { a as api } from './api-DmTNE4c1.cjs';
 export { c as code } from './code-DaRvff2v.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-B-c59NXD.cjs';
+export { a as ai_agent } from './ai_agent-C1zudGgT.cjs';
 export { m as media } from './media-fD8dJ5qR.cjs';
 
 declare const version = "0.1.0";

package/dist/index.d.ts

@@ -1,18 +1,18 @@
 export { j as json } from './json-Ta9JykSB.js';
 export { e as encoding } from './encoding-Dk3wpmb3.js';
 export { h as hashing } from './hashing-CnetQFD_.js';
-export { t as text } from './text-D1fySkCB.js';
-export { d as data } from './data-XRb0D7Zn.js';
+export { t as text } from './text-CA-zuD0C.js';
+export { d as data } from './data-C4lCByXw.js';
 export { g as generators } from './generators-Du8cBesn.js';
 export { t as time } from './time-KqJjdqII.js';
-export { u as units } from './units-COt5uI20.js';
+export { u as units } from './units-DQYLZd1n.js';
 export { n as network } from './network-D7Epuerc.js';
 export { a as api } from './api-DmTNE4c1.js';
 export { c as code } from './code-DaRvff2v.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-B-c59NXD.js';
+export { a as ai_agent } from './ai_agent-C1zudGgT.js';
 export { m as media } from './media-fD8dJ5qR.js';
 
 declare const version = "0.1.0";

package/dist/index.js

@@ -1,17 +1,17 @@
 export { media_exports as media } from './chunk-L6V4W4SU.js';
-export { units_exports as units } from './chunk-I63BCOAG.js';
+export { units_exports as units } from './chunk-GDIZWDBY.js';
 export { network_exports as network } from './chunk-CSNTHZHF.js';
 export { api_exports as api } from './chunk-52ZDKSIX.js';
 export { code_exports as code } from './chunk-LXKIPPDG.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-265NPGKH.js';
+export { ai_agent_exports as ai_agent } from './chunk-W3J7GZVQ.js';
 export { json_exports as json } from './chunk-WVEKRKGU.js';
 export { encoding_exports as encoding } from './chunk-DOWQZUTP.js';
 export { hashing_exports as hashing } from './chunk-GEFVMGZR.js';
-export { text_exports as text } from './chunk-AFEZ6N4A.js';
-export { data_exports as data } from './chunk-66QHV5KW.js';
+export { text_exports as text } from './chunk-H2USEUHD.js';
+export { data_exports as data } from './chunk-6FIB72KX.js';
 export { generators_exports as generators } from './chunk-3TYWIX3B.js';
 export { time_exports as time } from './chunk-IEPWZERQ.js';
 import './chunk-MLKGABMK.js';

package/dist/{text-D1fySkCB.d.cts → text-CA-zuD0C.d.cts}

@@ -22,6 +22,7 @@
  *   - passive-voice-detector: detectPassiveVoice
  *   - readability-score: scoreReadability
  *   - filler-word-detector: detectFillerWords
+ *   - sentence-length-distribution: analyzeSentenceLengths
  */
 interface WordCountResult {
     words: number;
@@ -327,6 +328,34 @@ declare function calculateStringDistance(a: string, b: string, options?: {
 }): StringDistanceResult | {
     error: string;
 };
+interface SentenceLengthBucket {
+    label: string;
+    min: number;
+    max: number;
+    count: number;
+}
+interface SentenceLengthDistribution {
+    sentenceCount: number;
+    lengths: number[];
+    minLength: number;
+    maxLength: number;
+    meanLength: number;
+    medianLength: number;
+    stdDev: number;
+    coefficientOfVariation: number;
+    consistency: string;
+    buckets: SentenceLengthBucket[];
+}
+/**
+ * Split text into sentences and report a histogram of sentence lengths (in
+ * words), plus mean/median/standard-deviation stats and a coefficient of
+ * variation, which is a distinct signal from the Flesch/Fog readability
+ * scores: two paragraphs can share the same reading grade while one alternates
+ * short and long sentences and the other stays uniform. Sentence splitting
+ * uses simple terminal-punctuation matching, so it can miscount abbreviations
+ * (e.g. "Dr.") as sentence boundaries.
+ */
+declare function analyzeSentenceLengths(text: string): SentenceLengthDistribution;
 
 type text_AsciiFont = AsciiFont;
 type text_AsciiOptions = AsciiOptions;
@@ -359,6 +388,8 @@ type text_PassiveVoiceResult = PassiveVoiceResult;
 type text_PassiveVoiceSentence = PassiveVoiceSentence;
 type text_ReadabilityResult = ReadabilityResult;
 type text_ReadabilityScore = ReadabilityScore;
+type text_SentenceLengthBucket = SentenceLengthBucket;
+type text_SentenceLengthDistribution = SentenceLengthDistribution;
 type text_SlugSeparator = SlugSeparator;
 type text_StringDistanceMode = StringDistanceMode;
 type text_StringDistanceResult = StringDistanceResult;
@@ -366,6 +397,7 @@ type text_TableOptions = TableOptions;
 type text_TextAnalysis = TextAnalysis;
 type text_WordCountResult = WordCountResult;
 declare const text_addBorder: typeof addBorder;
+declare const text_analyzeSentenceLengths: typeof analyzeSentenceLengths;
 declare const text_analyzeText: typeof analyzeText;
 declare const text_applyOp: typeof applyOp;
 declare const text_applyOps: typeof applyOps;
@@ -419,7 +451,7 @@ declare const text_textToMorse: typeof textToMorse;
 declare const text_unescapeString: typeof unescapeString;
 declare const text_wordFrequency: typeof wordFrequency;
 declare namespace text {
-  export { type text_AsciiFont as AsciiFont, type text_AsciiOptions as AsciiOptions, text_CASE_FORMATS as CASE_FORMATS, type text_CaseFormat as CaseFormat, type text_ConvertOptions as ConvertOptions, text_DEFAULT_CONVERT_OPTIONS as DEFAULT_CONVERT_OPTIONS, type text_DiffFile as DiffFile, type text_DiffHunk as DiffHunk, type text_DiffLine as DiffLine, type text_DiffResult as DiffResult, type text_DiffType as DiffType, type text_DiffViewerLine as DiffViewerLine, text_ESCAPE_MODES as ESCAPE_MODES, type text_EscapeMode as EscapeMode, type text_FillerCategory as FillerCategory, type text_FillerMatch as FillerMatch, type text_FillerWordResult as FillerWordResult, text_LINE_OPS as LINE_OPS, type text_LineOp as LineOp, type text_LineType as LineType, type text_LoremUnit as LoremUnit, text_MORSE_CODE as MORSE_CODE, type text_MarkdownResult as MarkdownResult, type text_MorseOptions as MorseOptions, type text_ParsedDiff as ParsedDiff, type text_ParsedTable as ParsedTable, type text_PassiveVoiceMatch as PassiveVoiceMatch, type text_PassiveVoiceResult as PassiveVoiceResult, type text_PassiveVoiceSentence as PassiveVoiceSentence, type text_ReadabilityResult as ReadabilityResult, type text_ReadabilityScore as ReadabilityScore, type text_SlugSeparator as SlugSeparator, type text_StringDistanceMode as StringDistanceMode, type text_StringDistanceResult as StringDistanceResult, type text_TableOptions as TableOptions, type text_TextAnalysis as TextAnalysis, type text_WordCountResult as WordCountResult, text_addBorder as addBorder, text_analyzeText as analyzeText, text_applyOp as applyOp, text_applyOps as applyOps, text_calculateStringDistance as calculateStringDistance, text_centerText as centerText, text_convertAll as convertAll, text_convertCase as convertCase, text_countWords as countWords, text_csvToHtml as csvToHtml, text_csvToMarkdown as csvToMarkdown, text_detectDelimiter as detectDelimiter, text_detectFillerWords as detectFillerWords, text_detectPassiveVoice as detectPassiveVoice, text_diffLines as diffLines, text_diffLinesSimple as diffLinesSimple, text_diffStats as diffStats, text_escapeAll as escapeAll, text_escapeString as escapeString, text_extractHeadings as extractHeadings, text_formatReadingTime as formatReadingTime, text_generate as generate, text_generateDiff as generateDiff, text_generateHtmlTable as generateHtmlTable, text_generateMarkdownTable as generateMarkdownTable, text_generateParagraphs as generateParagraphs, text_generateSentences as generateSentences, text_generateWords as generateWords, text_getAvailableFonts as getAvailableFonts, text_getMorseForChar as getMorseForChar, text_getMorseTiming as getMorseTiming, text_htmlToMarkdown as htmlToMarkdown, text_isValidMorse as isValidMorse, text_markdownToHtml as markdownToHtml, text_morseToText as morseToText, text_numberToOrdinal as numberToOrdinal, text_numberToRoman as numberToRoman, text_numberToWords as numberToWords, text_ordinalWords as ordinalWords, text_parseDiff as parseDiff, text_parseTableData as parseTableData, text_readabilityScore as readabilityScore, text_renderMarkdown as renderMarkdown, text_romanToNumber as romanToNumber, text_scoreReadability as scoreReadability, text_sentenceCount as sentenceCount, text_slugify as slugify, text_slugifyAll as slugifyAll, text_syllableCount as syllableCount, text_textToAscii as textToAscii, text_textToMorse as textToMorse, text_unescapeString as unescapeString, text_wordFrequency as wordFrequency };
+  export { type text_AsciiFont as AsciiFont, type text_AsciiOptions as AsciiOptions, text_CASE_FORMATS as CASE_FORMATS, type text_CaseFormat as CaseFormat, type text_ConvertOptions as ConvertOptions, text_DEFAULT_CONVERT_OPTIONS as DEFAULT_CONVERT_OPTIONS, type text_DiffFile as DiffFile, type text_DiffHunk as DiffHunk, type text_DiffLine as DiffLine, type text_DiffResult as DiffResult, type text_DiffType as DiffType, type text_DiffViewerLine as DiffViewerLine, text_ESCAPE_MODES as ESCAPE_MODES, type text_EscapeMode as EscapeMode, type text_FillerCategory as FillerCategory, type text_FillerMatch as FillerMatch, type text_FillerWordResult as FillerWordResult, text_LINE_OPS as LINE_OPS, type text_LineOp as LineOp, type text_LineType as LineType, type text_LoremUnit as LoremUnit, text_MORSE_CODE as MORSE_CODE, type text_MarkdownResult as MarkdownResult, type text_MorseOptions as MorseOptions, type text_ParsedDiff as ParsedDiff, type text_ParsedTable as ParsedTable, type text_PassiveVoiceMatch as PassiveVoiceMatch, type text_PassiveVoiceResult as PassiveVoiceResult, type text_PassiveVoiceSentence as PassiveVoiceSentence, type text_ReadabilityResult as ReadabilityResult, type text_ReadabilityScore as ReadabilityScore, type text_SentenceLengthBucket as SentenceLengthBucket, type text_SentenceLengthDistribution as SentenceLengthDistribution, type text_SlugSeparator as SlugSeparator, type text_StringDistanceMode as StringDistanceMode, type text_StringDistanceResult as StringDistanceResult, type text_TableOptions as TableOptions, type text_TextAnalysis as TextAnalysis, type text_WordCountResult as WordCountResult, text_addBorder as addBorder, text_analyzeSentenceLengths as analyzeSentenceLengths, text_analyzeText as analyzeText, text_applyOp as applyOp, text_applyOps as applyOps, text_calculateStringDistance as calculateStringDistance, text_centerText as centerText, text_convertAll as convertAll, text_convertCase as convertCase, text_countWords as countWords, text_csvToHtml as csvToHtml, text_csvToMarkdown as csvToMarkdown, text_detectDelimiter as detectDelimiter, text_detectFillerWords as detectFillerWords, text_detectPassiveVoice as detectPassiveVoice, text_diffLines as diffLines, text_diffLinesSimple as diffLinesSimple, text_diffStats as diffStats, text_escapeAll as escapeAll, text_escapeString as escapeString, text_extractHeadings as extractHeadings, text_formatReadingTime as formatReadingTime, text_generate as generate, text_generateDiff as generateDiff, text_generateHtmlTable as generateHtmlTable, text_generateMarkdownTable as generateMarkdownTable, text_generateParagraphs as generateParagraphs, text_generateSentences as generateSentences, text_generateWords as generateWords, text_getAvailableFonts as getAvailableFonts, text_getMorseForChar as getMorseForChar, text_getMorseTiming as getMorseTiming, text_htmlToMarkdown as htmlToMarkdown, text_isValidMorse as isValidMorse, text_markdownToHtml as markdownToHtml, text_morseToText as morseToText, text_numberToOrdinal as numberToOrdinal, text_numberToRoman as numberToRoman, text_numberToWords as numberToWords, text_ordinalWords as ordinalWords, text_parseDiff as parseDiff, text_parseTableData as parseTableData, text_readabilityScore as readabilityScore, text_renderMarkdown as renderMarkdown, text_romanToNumber as romanToNumber, text_scoreReadability as scoreReadability, text_sentenceCount as sentenceCount, text_slugify as slugify, text_slugifyAll as slugifyAll, text_syllableCount as syllableCount, text_textToAscii as textToAscii, text_textToMorse as textToMorse, text_unescapeString as unescapeString, text_wordFrequency as wordFrequency };
 }
 
-export { diffLinesSimple as $, type AsciiFont as A, addBorder as B, CASE_FORMATS as C, DEFAULT_CONVERT_OPTIONS as D, ESCAPE_MODES as E, type FillerCategory as F, analyzeText as G, applyOp as H, applyOps as I, calculateStringDistance as J, centerText as K, LINE_OPS as L, MORSE_CODE as M, convertAll as N, convertCase as O, type ParsedDiff as P, countWords as Q, type ReadabilityResult as R, type SlugSeparator as S, type TableOptions as T, csvToHtml as U, csvToMarkdown as V, type WordCountResult as W, detectDelimiter as X, detectFillerWords as Y, detectPassiveVoice as Z, diffLines as _, type AsciiOptions as a, diffStats as a0, escapeAll as a1, escapeString as a2, extractHeadings as a3, formatReadingTime as a4, generate as a5, generateDiff as a6, generateHtmlTable as a7, generateMarkdownTable as a8, generateParagraphs as a9, wordFrequency as aA, generateSentences as aa, generateWords as ab, getAvailableFonts as ac, getMorseForChar as ad, getMorseTiming as ae, htmlToMarkdown as af, isValidMorse as ag, markdownToHtml as ah, morseToText as ai, numberToOrdinal as aj, numberToRoman as ak, numberToWords as al, ordinalWords as am, parseDiff as an, parseTableData as ao, readabilityScore as ap, renderMarkdown as aq, romanToNumber as ar, scoreReadability as as, sentenceCount as at, slugify as au, slugifyAll as av, syllableCount as aw, textToAscii as ax, textToMorse as ay, unescapeString as az, type CaseFormat as b, type ConvertOptions as c, type DiffFile as d, type DiffHunk as e, type DiffLine as f, type DiffResult as g, type DiffType as h, type DiffViewerLine as i, type EscapeMode as j, type FillerMatch as k, type FillerWordResult as l, type LineOp as m, type LineType as n, type LoremUnit as o, type MarkdownResult as p, type MorseOptions as q, type ParsedTable as r, type PassiveVoiceMatch as s, text as t, type PassiveVoiceResult as u, type PassiveVoiceSentence as v, type ReadabilityScore as w, type StringDistanceMode as x, type StringDistanceResult as y, type TextAnalysis as z };
+export { detectFillerWords as $, type AsciiFont as A, type StringDistanceResult as B, CASE_FORMATS as C, DEFAULT_CONVERT_OPTIONS as D, ESCAPE_MODES as E, type FillerCategory as F, type TextAnalysis as G, addBorder as H, analyzeSentenceLengths as I, analyzeText as J, applyOp as K, LINE_OPS as L, MORSE_CODE as M, applyOps as N, calculateStringDistance as O, type ParsedDiff as P, centerText as Q, type ReadabilityResult as R, type SentenceLengthBucket as S, type TableOptions as T, convertAll as U, convertCase as V, type WordCountResult as W, countWords as X, csvToHtml as Y, csvToMarkdown as Z, detectDelimiter as _, type AsciiOptions as a, detectPassiveVoice as a0, diffLines as a1, diffLinesSimple as a2, diffStats as a3, escapeAll as a4, escapeString as a5, extractHeadings as a6, formatReadingTime as a7, generate as a8, generateDiff as a9, textToAscii as aA, textToMorse as aB, unescapeString as aC, wordFrequency as aD, generateHtmlTable as aa, generateMarkdownTable as ab, generateParagraphs as ac, generateSentences as ad, generateWords as ae, getAvailableFonts as af, getMorseForChar as ag, getMorseTiming as ah, htmlToMarkdown as ai, isValidMorse as aj, markdownToHtml as ak, morseToText as al, numberToOrdinal as am, numberToRoman as an, numberToWords as ao, ordinalWords as ap, parseDiff as aq, parseTableData as ar, readabilityScore as as, renderMarkdown as at, romanToNumber as au, scoreReadability as av, sentenceCount as aw, slugify as ax, slugifyAll as ay, syllableCount as az, type CaseFormat as b, type ConvertOptions as c, type DiffFile as d, type DiffHunk as e, type DiffLine as f, type DiffResult as g, type DiffType as h, type DiffViewerLine as i, type EscapeMode as j, type FillerMatch as k, type FillerWordResult as l, type LineOp as m, type LineType as n, type LoremUnit as o, type MarkdownResult as p, type MorseOptions as q, type ParsedTable as r, type PassiveVoiceMatch as s, text as t, type PassiveVoiceResult as u, type PassiveVoiceSentence as v, type ReadabilityScore as w, type SentenceLengthDistribution as x, type SlugSeparator as y, type StringDistanceMode as z };

package/dist/{text-D1fySkCB.d.ts → text-CA-zuD0C.d.ts}

@@ -22,6 +22,7 @@
  *   - passive-voice-detector: detectPassiveVoice
  *   - readability-score: scoreReadability
  *   - filler-word-detector: detectFillerWords
+ *   - sentence-length-distribution: analyzeSentenceLengths
  */
 interface WordCountResult {
     words: number;
@@ -327,6 +328,34 @@ declare function calculateStringDistance(a: string, b: string, options?: {
 }): StringDistanceResult | {
     error: string;
 };
+interface SentenceLengthBucket {
+    label: string;
+    min: number;
+    max: number;
+    count: number;
+}
+interface SentenceLengthDistribution {
+    sentenceCount: number;
+    lengths: number[];
+    minLength: number;
+    maxLength: number;
+    meanLength: number;
+    medianLength: number;
+    stdDev: number;
+    coefficientOfVariation: number;
+    consistency: string;
+    buckets: SentenceLengthBucket[];
+}
+/**
+ * Split text into sentences and report a histogram of sentence lengths (in
+ * words), plus mean/median/standard-deviation stats and a coefficient of
+ * variation, which is a distinct signal from the Flesch/Fog readability
+ * scores: two paragraphs can share the same reading grade while one alternates
+ * short and long sentences and the other stays uniform. Sentence splitting
+ * uses simple terminal-punctuation matching, so it can miscount abbreviations
+ * (e.g. "Dr.") as sentence boundaries.
+ */
+declare function analyzeSentenceLengths(text: string): SentenceLengthDistribution;
 
 type text_AsciiFont = AsciiFont;
 type text_AsciiOptions = AsciiOptions;
@@ -359,6 +388,8 @@ type text_PassiveVoiceResult = PassiveVoiceResult;
 type text_PassiveVoiceSentence = PassiveVoiceSentence;
 type text_ReadabilityResult = ReadabilityResult;
 type text_ReadabilityScore = ReadabilityScore;
+type text_SentenceLengthBucket = SentenceLengthBucket;
+type text_SentenceLengthDistribution = SentenceLengthDistribution;
 type text_SlugSeparator = SlugSeparator;
 type text_StringDistanceMode = StringDistanceMode;
 type text_StringDistanceResult = StringDistanceResult;
@@ -366,6 +397,7 @@ type text_TableOptions = TableOptions;
 type text_TextAnalysis = TextAnalysis;
 type text_WordCountResult = WordCountResult;
 declare const text_addBorder: typeof addBorder;
+declare const text_analyzeSentenceLengths: typeof analyzeSentenceLengths;
 declare const text_analyzeText: typeof analyzeText;
 declare const text_applyOp: typeof applyOp;
 declare const text_applyOps: typeof applyOps;
@@ -419,7 +451,7 @@ declare const text_textToMorse: typeof textToMorse;
 declare const text_unescapeString: typeof unescapeString;
 declare const text_wordFrequency: typeof wordFrequency;
 declare namespace text {
-  export { type text_AsciiFont as AsciiFont, type text_AsciiOptions as AsciiOptions, text_CASE_FORMATS as CASE_FORMATS, type text_CaseFormat as CaseFormat, type text_ConvertOptions as ConvertOptions, text_DEFAULT_CONVERT_OPTIONS as DEFAULT_CONVERT_OPTIONS, type text_DiffFile as DiffFile, type text_DiffHunk as DiffHunk, type text_DiffLine as DiffLine, type text_DiffResult as DiffResult, type text_DiffType as DiffType, type text_DiffViewerLine as DiffViewerLine, text_ESCAPE_MODES as ESCAPE_MODES, type text_EscapeMode as EscapeMode, type text_FillerCategory as FillerCategory, type text_FillerMatch as FillerMatch, type text_FillerWordResult as FillerWordResult, text_LINE_OPS as LINE_OPS, type text_LineOp as LineOp, type text_LineType as LineType, type text_LoremUnit as LoremUnit, text_MORSE_CODE as MORSE_CODE, type text_MarkdownResult as MarkdownResult, type text_MorseOptions as MorseOptions, type text_ParsedDiff as ParsedDiff, type text_ParsedTable as ParsedTable, type text_PassiveVoiceMatch as PassiveVoiceMatch, type text_PassiveVoiceResult as PassiveVoiceResult, type text_PassiveVoiceSentence as PassiveVoiceSentence, type text_ReadabilityResult as ReadabilityResult, type text_ReadabilityScore as ReadabilityScore, type text_SlugSeparator as SlugSeparator, type text_StringDistanceMode as StringDistanceMode, type text_StringDistanceResult as StringDistanceResult, type text_TableOptions as TableOptions, type text_TextAnalysis as TextAnalysis, type text_WordCountResult as WordCountResult, text_addBorder as addBorder, text_analyzeText as analyzeText, text_applyOp as applyOp, text_applyOps as applyOps, text_calculateStringDistance as calculateStringDistance, text_centerText as centerText, text_convertAll as convertAll, text_convertCase as convertCase, text_countWords as countWords, text_csvToHtml as csvToHtml, text_csvToMarkdown as csvToMarkdown, text_detectDelimiter as detectDelimiter, text_detectFillerWords as detectFillerWords, text_detectPassiveVoice as detectPassiveVoice, text_diffLines as diffLines, text_diffLinesSimple as diffLinesSimple, text_diffStats as diffStats, text_escapeAll as escapeAll, text_escapeString as escapeString, text_extractHeadings as extractHeadings, text_formatReadingTime as formatReadingTime, text_generate as generate, text_generateDiff as generateDiff, text_generateHtmlTable as generateHtmlTable, text_generateMarkdownTable as generateMarkdownTable, text_generateParagraphs as generateParagraphs, text_generateSentences as generateSentences, text_generateWords as generateWords, text_getAvailableFonts as getAvailableFonts, text_getMorseForChar as getMorseForChar, text_getMorseTiming as getMorseTiming, text_htmlToMarkdown as htmlToMarkdown, text_isValidMorse as isValidMorse, text_markdownToHtml as markdownToHtml, text_morseToText as morseToText, text_numberToOrdinal as numberToOrdinal, text_numberToRoman as numberToRoman, text_numberToWords as numberToWords, text_ordinalWords as ordinalWords, text_parseDiff as parseDiff, text_parseTableData as parseTableData, text_readabilityScore as readabilityScore, text_renderMarkdown as renderMarkdown, text_romanToNumber as romanToNumber, text_scoreReadability as scoreReadability, text_sentenceCount as sentenceCount, text_slugify as slugify, text_slugifyAll as slugifyAll, text_syllableCount as syllableCount, text_textToAscii as textToAscii, text_textToMorse as textToMorse, text_unescapeString as unescapeString, text_wordFrequency as wordFrequency };
+  export { type text_AsciiFont as AsciiFont, type text_AsciiOptions as AsciiOptions, text_CASE_FORMATS as CASE_FORMATS, type text_CaseFormat as CaseFormat, type text_ConvertOptions as ConvertOptions, text_DEFAULT_CONVERT_OPTIONS as DEFAULT_CONVERT_OPTIONS, type text_DiffFile as DiffFile, type text_DiffHunk as DiffHunk, type text_DiffLine as DiffLine, type text_DiffResult as DiffResult, type text_DiffType as DiffType, type text_DiffViewerLine as DiffViewerLine, text_ESCAPE_MODES as ESCAPE_MODES, type text_EscapeMode as EscapeMode, type text_FillerCategory as FillerCategory, type text_FillerMatch as FillerMatch, type text_FillerWordResult as FillerWordResult, text_LINE_OPS as LINE_OPS, type text_LineOp as LineOp, type text_LineType as LineType, type text_LoremUnit as LoremUnit, text_MORSE_CODE as MORSE_CODE, type text_MarkdownResult as MarkdownResult, type text_MorseOptions as MorseOptions, type text_ParsedDiff as ParsedDiff, type text_ParsedTable as ParsedTable, type text_PassiveVoiceMatch as PassiveVoiceMatch, type text_PassiveVoiceResult as PassiveVoiceResult, type text_PassiveVoiceSentence as PassiveVoiceSentence, type text_ReadabilityResult as ReadabilityResult, type text_ReadabilityScore as ReadabilityScore, type text_SentenceLengthBucket as SentenceLengthBucket, type text_SentenceLengthDistribution as SentenceLengthDistribution, type text_SlugSeparator as SlugSeparator, type text_StringDistanceMode as StringDistanceMode, type text_StringDistanceResult as StringDistanceResult, type text_TableOptions as TableOptions, type text_TextAnalysis as TextAnalysis, type text_WordCountResult as WordCountResult, text_addBorder as addBorder, text_analyzeSentenceLengths as analyzeSentenceLengths, text_analyzeText as analyzeText, text_applyOp as applyOp, text_applyOps as applyOps, text_calculateStringDistance as calculateStringDistance, text_centerText as centerText, text_convertAll as convertAll, text_convertCase as convertCase, text_countWords as countWords, text_csvToHtml as csvToHtml, text_csvToMarkdown as csvToMarkdown, text_detectDelimiter as detectDelimiter, text_detectFillerWords as detectFillerWords, text_detectPassiveVoice as detectPassiveVoice, text_diffLines as diffLines, text_diffLinesSimple as diffLinesSimple, text_diffStats as diffStats, text_escapeAll as escapeAll, text_escapeString as escapeString, text_extractHeadings as extractHeadings, text_formatReadingTime as formatReadingTime, text_generate as generate, text_generateDiff as generateDiff, text_generateHtmlTable as generateHtmlTable, text_generateMarkdownTable as generateMarkdownTable, text_generateParagraphs as generateParagraphs, text_generateSentences as generateSentences, text_generateWords as generateWords, text_getAvailableFonts as getAvailableFonts, text_getMorseForChar as getMorseForChar, text_getMorseTiming as getMorseTiming, text_htmlToMarkdown as htmlToMarkdown, text_isValidMorse as isValidMorse, text_markdownToHtml as markdownToHtml, text_morseToText as morseToText, text_numberToOrdinal as numberToOrdinal, text_numberToRoman as numberToRoman, text_numberToWords as numberToWords, text_ordinalWords as ordinalWords, text_parseDiff as parseDiff, text_parseTableData as parseTableData, text_readabilityScore as readabilityScore, text_renderMarkdown as renderMarkdown, text_romanToNumber as romanToNumber, text_scoreReadability as scoreReadability, text_sentenceCount as sentenceCount, text_slugify as slugify, text_slugifyAll as slugifyAll, text_syllableCount as syllableCount, text_textToAscii as textToAscii, text_textToMorse as textToMorse, text_unescapeString as unescapeString, text_wordFrequency as wordFrequency };
 }
 
-export { diffLinesSimple as $, type AsciiFont as A, addBorder as B, CASE_FORMATS as C, DEFAULT_CONVERT_OPTIONS as D, ESCAPE_MODES as E, type FillerCategory as F, analyzeText as G, applyOp as H, applyOps as I, calculateStringDistance as J, centerText as K, LINE_OPS as L, MORSE_CODE as M, convertAll as N, convertCase as O, type ParsedDiff as P, countWords as Q, type ReadabilityResult as R, type SlugSeparator as S, type TableOptions as T, csvToHtml as U, csvToMarkdown as V, type WordCountResult as W, detectDelimiter as X, detectFillerWords as Y, detectPassiveVoice as Z, diffLines as _, type AsciiOptions as a, diffStats as a0, escapeAll as a1, escapeString as a2, extractHeadings as a3, formatReadingTime as a4, generate as a5, generateDiff as a6, generateHtmlTable as a7, generateMarkdownTable as a8, generateParagraphs as a9, wordFrequency as aA, generateSentences as aa, generateWords as ab, getAvailableFonts as ac, getMorseForChar as ad, getMorseTiming as ae, htmlToMarkdown as af, isValidMorse as ag, markdownToHtml as ah, morseToText as ai, numberToOrdinal as aj, numberToRoman as ak, numberToWords as al, ordinalWords as am, parseDiff as an, parseTableData as ao, readabilityScore as ap, renderMarkdown as aq, romanToNumber as ar, scoreReadability as as, sentenceCount as at, slugify as au, slugifyAll as av, syllableCount as aw, textToAscii as ax, textToMorse as ay, unescapeString as az, type CaseFormat as b, type ConvertOptions as c, type DiffFile as d, type DiffHunk as e, type DiffLine as f, type DiffResult as g, type DiffType as h, type DiffViewerLine as i, type EscapeMode as j, type FillerMatch as k, type FillerWordResult as l, type LineOp as m, type LineType as n, type LoremUnit as o, type MarkdownResult as p, type MorseOptions as q, type ParsedTable as r, type PassiveVoiceMatch as s, text as t, type PassiveVoiceResult as u, type PassiveVoiceSentence as v, type ReadabilityScore as w, type StringDistanceMode as x, type StringDistanceResult as y, type TextAnalysis as z };
+export { detectFillerWords as $, type AsciiFont as A, type StringDistanceResult as B, CASE_FORMATS as C, DEFAULT_CONVERT_OPTIONS as D, ESCAPE_MODES as E, type FillerCategory as F, type TextAnalysis as G, addBorder as H, analyzeSentenceLengths as I, analyzeText as J, applyOp as K, LINE_OPS as L, MORSE_CODE as M, applyOps as N, calculateStringDistance as O, type ParsedDiff as P, centerText as Q, type ReadabilityResult as R, type SentenceLengthBucket as S, type TableOptions as T, convertAll as U, convertCase as V, type WordCountResult as W, countWords as X, csvToHtml as Y, csvToMarkdown as Z, detectDelimiter as _, type AsciiOptions as a, detectPassiveVoice as a0, diffLines as a1, diffLinesSimple as a2, diffStats as a3, escapeAll as a4, escapeString as a5, extractHeadings as a6, formatReadingTime as a7, generate as a8, generateDiff as a9, textToAscii as aA, textToMorse as aB, unescapeString as aC, wordFrequency as aD, generateHtmlTable as aa, generateMarkdownTable as ab, generateParagraphs as ac, generateSentences as ad, generateWords as ae, getAvailableFonts as af, getMorseForChar as ag, getMorseTiming as ah, htmlToMarkdown as ai, isValidMorse as aj, markdownToHtml as ak, morseToText as al, numberToOrdinal as am, numberToRoman as an, numberToWords as ao, ordinalWords as ap, parseDiff as aq, parseTableData as ar, readabilityScore as as, renderMarkdown as at, romanToNumber as au, scoreReadability as av, sentenceCount as aw, slugify as ax, slugifyAll as ay, syllableCount as az, type CaseFormat as b, type ConvertOptions as c, type DiffFile as d, type DiffHunk as e, type DiffLine as f, type DiffResult as g, type DiffType as h, type DiffViewerLine as i, type EscapeMode as j, type FillerMatch as k, type FillerWordResult as l, type LineOp as m, type LineType as n, type LoremUnit as o, type MarkdownResult as p, type MorseOptions as q, type ParsedTable as r, type PassiveVoiceMatch as s, text as t, type PassiveVoiceResult as u, type PassiveVoiceSentence as v, type ReadabilityScore as w, type SentenceLengthDistribution as x, type SlugSeparator as y, type StringDistanceMode as z };

package/dist/tools/ai_agent.cjs

@@ -946,6 +946,29 @@ function vectorSimilarity(a, b) {
     magnitudeB: round6(magB)
   };
 }
+function formatFewShotExamples(examples, format = "numbered", delimiter = "---") {
+  const valid = (examples ?? []).filter((e) => e?.input?.trim() && e?.output?.trim());
+  if (valid.length === 0) {
+    return { formatted: "", exampleCount: 0, format };
+  }
+  let formatted;
+  if (format === "xml") {
+    formatted = valid.map((e) => `<example>
+  <input>${e.input.trim()}</input>
+  <output>${e.output.trim()}</output>
+</example>`).join("\n\n");
+  } else if (format === "delimiter") {
+    formatted = valid.map((e) => `Input: ${e.input.trim()}
+Output: ${e.output.trim()}`).join(`
+${delimiter}
+`);
+  } else {
+    formatted = valid.map((e, i) => `Example ${i + 1}:
+Input: ${e.input.trim()}
+Output: ${e.output.trim()}`).join("\n\n");
+  }
+  return { formatted, exampleCount: valid.length, format };
+}
 
 exports.MODEL_PRICING = MODEL_PRICING;
 exports.chunkText = chunkText;
@@ -966,6 +989,7 @@ exports.extractKeywords = extractKeywords;
 exports.extractTables = extractTables;
 exports.extractUrls = extractUrls;
 exports.flattenJson = flattenJson;
+exports.formatFewShotExamples = formatFewShotExamples;
 exports.mergeJson = mergeJson;
 exports.redactPii = redactPii;
 exports.repairJson = repairJson;

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 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';
+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, F as FewShotExample, n as FewShotFormat, o as FewShotFormatResult, I as InjectionDetectResult, p as InjectionFinding, J as JsonBlock, q as JsonRepairResult, K as Keyword, M as MODEL_PRICING, r as MergeResult, s as MergeStrategy, t as ModelPricing, P as PiiDetectResult, u as PiiFinding, v as PiiType, R as RankedChunk, w as RelevanceResult, S as SanitizeResult, x as SecretDetectResult, y as SecretFinding, z as SecretType, A as SummaryResult, T as TableResult2, B as TextChunk, G as TokenEstimate, H as TokenEstimateResult, L as TrimResult, N as TrimStrategy, U as UrlMatch, V as ValidationError, O as ValidationResult, Q as VectorSimilarityResult, W as chunkText, X as compressHtml, Y as compressJson, Z as compressMarkdown, _ as deduplicateLines, $ as detectPii, a0 as detectPromptInjection, a1 as detectSecrets, a2 as diffJson, a3 as estimateCost, a4 as estimateTokens, a5 as expandQuery, a6 as extractEntities, a7 as extractJson, a8 as extractKeywords, a9 as extractTables, aa as extractUrls, ab as flattenJson, ac as formatFewShotExamples, ad as mergeJson, ae as redactPii, af as repairJson, ag as rerankChunks, ah as sanitizeHtml, ai as scoreRelevance, aj as summarizeForLlm, ak as trimToTokens, al as unflattenJson, am as validateJsonSchema, an as vectorSimilarity } from '../ai_agent-C1zudGgT.cjs';