@utilix-tech/sdk 0.82.0 → 0.84.0

package/dist/index.cjs

@@ -8111,6 +8111,7 @@ __export(time_exports, {
   TIMEZONES: () => TIMEZONES,
   convertTime: () => convertTime,
   diffDates: () => diffDates,
+  findCronOverlaps: () => findCronOverlaps,
   formatInTimezone: () => formatInTimezone,
   formatIso8601Duration: () => formatIso8601Duration,
   formatRelative: () => formatRelative,
@@ -8786,6 +8787,42 @@ function getRunInterval(dates) {
   const days = Math.round(diffMins / 1440);
   return `Every ${days} days`;
 }
+var MAX_CRON_OVERLAPS = 200;
+function findCronOverlaps(expressions, windowDays = 30, fromDate) {
+  if (expressions.length < 2) return { error: "Provide at least two cron expressions to check for overlaps" };
+  if (expressions.length > 10) return { error: "Provide 10 or fewer cron expressions" };
+  if (windowDays < 1 || windowDays > 365) return { error: "windowDays must be between 1 and 365" };
+  const parsedList = [];
+  for (let i = 0; i < expressions.length; i++) {
+    const parsed = parseCronExpression(expressions[i]);
+    if (typeof parsed === "object" && "error" in parsed) {
+      return { error: `Expression ${i + 1} ("${expressions[i]}"): ${parsed.error}` };
+    }
+    parsedList.push(parsed);
+  }
+  const start = fromDate ? new Date(fromDate) : /* @__PURE__ */ new Date();
+  const cursor = new Date(start);
+  cursor.setSeconds(0, 0);
+  cursor.setMinutes(cursor.getMinutes() + 1);
+  const endTime = cursor.getTime() + windowDays * 24 * 60 * 60 * 1e3;
+  const overlaps = [];
+  let truncated = false;
+  while (cursor.getTime() < endTime) {
+    const matched = [];
+    for (let i = 0; i < parsedList.length; i++) {
+      if (matchesCron(cursor, parsedList[i])) matched.push(i);
+    }
+    if (matched.length >= 2) {
+      if (overlaps.length >= MAX_CRON_OVERLAPS) {
+        truncated = true;
+        break;
+      }
+      overlaps.push({ date: new Date(cursor), expressionIndexes: matched });
+    }
+    cursor.setMinutes(cursor.getMinutes() + 1);
+  }
+  return { overlaps, windowDays, truncated };
+}
 var DURATION_SECONDS_PER_YEAR = 365 * 86400;
 var DURATION_SECONDS_PER_MONTH = 30 * 86400;
 function humanizeDurationParts(parts) {
@@ -16791,6 +16828,7 @@ __export(code_exports, {
   envToExport: () => envToExport2,
   envToJson: () => envToJson2,
   extractMarkdownFootnotes: () => extractMarkdownFootnotes,
+  extractMarkdownLinkReferences: () => extractMarkdownLinkReferences,
   extractSvgSpriteSymbols: () => extractSvgSpriteSymbols,
   formatCss: () => formatCss,
   formatGql: () => formatGql,
@@ -16802,6 +16840,7 @@ __export(code_exports, {
   getMethodColor: () => getMethodColor,
   isValidTag: () => isValidTag,
   lintConventionalCommit: () => lintConventionalCommit,
+  lintDockerfile: () => lintDockerfile,
   lookupMime: () => lookupMime,
   minifyCss: () => minifyCss,
   minifyGql: () => minifyGql,
@@ -18632,6 +18671,111 @@ function normalizeRef(ref) {
   const tagPart = parsed.digest ? `@${parsed.digest}` : parsed.tag ? `:${parsed.tag}` : "";
   return `${parsed.registry}/${ns}${parsed.repository}${tagPart}`;
 }
+function _parseDockerfileInstructions(content) {
+  const rawLines = content.replace(/\r\n/g, "\n").split("\n");
+  const instructions = [];
+  let buffer = "";
+  let bufferStartLine = 0;
+  for (let i = 0; i < rawLines.length; i++) {
+    const lineNo = i + 1;
+    const line = rawLines[i];
+    const trimmed = line.trim();
+    if (buffer === "") {
+      if (trimmed === "" || trimmed.startsWith("#")) continue;
+      bufferStartLine = lineNo;
+      buffer = line.trimEnd();
+    } else {
+      buffer += "\n" + line.trimEnd();
+    }
+    if (buffer.endsWith("\\")) {
+      buffer = buffer.slice(0, -1);
+      continue;
+    }
+    const match = buffer.trim().match(/^([A-Za-z]+)\s*([\s\S]*)$/);
+    if (match) {
+      instructions.push({ instruction: match[1].toUpperCase(), args: match[2].trim(), line: bufferStartLine });
+    }
+    buffer = "";
+  }
+  return instructions;
+}
+var _DOCKERFILE_TAR_RE = /\.(tar(\.(gz|bz2|xz))?|tgz|tbz2|txz)$/i;
+function lintDockerfile(content) {
+  if (!content || !content.trim()) return { error: "Dockerfile content is required" };
+  const instructions = _parseDockerfileInstructions(content);
+  if (instructions.length === 0) return { error: "No Dockerfile instructions found" };
+  const fromInstructions = instructions.filter((i) => i.instruction === "FROM");
+  if (fromInstructions.length === 0) return { error: "No FROM instruction found; this does not look like a valid Dockerfile" };
+  const stageNames = /* @__PURE__ */ new Set();
+  const stages = fromInstructions.map((inst, idx) => {
+    const asMatch = inst.args.match(/^(\S+)(?:\s+AS\s+(\S+))?/i);
+    const baseImage = asMatch ? asMatch[1] : inst.args.split(/\s+/)[0];
+    const name = asMatch && asMatch[2] ? asMatch[2] : null;
+    if (name) stageNames.add(name.toLowerCase());
+    return { index: idx, name, baseImage, fromLine: inst.line };
+  });
+  const findings = [];
+  for (const stage of stages) {
+    const base = stage.baseImage;
+    if (base.toLowerCase() === "scratch") continue;
+    if (stageNames.has(base.toLowerCase())) continue;
+    const withoutDigest = base.split("@")[0];
+    const hasTag = withoutDigest.includes(":");
+    const tag = hasTag ? withoutDigest.split(":").pop() : null;
+    if (!hasTag) {
+      findings.push({
+        rule: "unpinned-base-image",
+        severity: "warning",
+        line: stage.fromLine,
+        message: `FROM ${base} has no tag, so it resolves to ":latest", which can silently change what gets built on a future run. Pin an explicit version tag instead.`
+      });
+    } else if (tag === "latest") {
+      findings.push({
+        rule: "unpinned-base-image",
+        severity: "warning",
+        line: stage.fromLine,
+        message: `FROM ${base} is explicitly pinned to the "latest" tag, which is a moving target rather than a fixed version. Pin an explicit version tag instead.`
+      });
+    }
+  }
+  const finalStage = stages[stages.length - 1];
+  const finalStageInstructions = instructions.filter((i) => i.line >= finalStage.fromLine);
+  if (!finalStageInstructions.some((i) => i.instruction === "WORKDIR")) {
+    findings.push({
+      rule: "missing-workdir",
+      severity: "warning",
+      line: finalStage.fromLine,
+      message: 'No WORKDIR instruction in the final stage, so RUN/CMD/ENTRYPOINT execute from "/" by default. Set an explicit WORKDIR.'
+    });
+  }
+  if (!finalStageInstructions.some((i) => i.instruction === "USER")) {
+    findings.push({
+      rule: "running-as-root",
+      severity: "warning",
+      line: finalStage.fromLine,
+      message: "No USER instruction in the final stage, so the container runs as root by default. Add a non-root USER unless root is genuinely required."
+    });
+  }
+  for (const inst of instructions) {
+    if (inst.instruction !== "ADD") continue;
+    const parts = inst.args.split(/\s+/).filter(Boolean).filter((p) => !p.startsWith("--"));
+    if (parts.length < 2) continue;
+    const sources = parts.slice(0, -1);
+    for (const src of sources) {
+      const isUrl = /^https?:\/\//i.test(src);
+      const isTar = _DOCKERFILE_TAR_RE.test(src);
+      if (!isUrl && !isTar) {
+        findings.push({
+          rule: "add-vs-copy",
+          severity: "info",
+          line: inst.line,
+          message: `ADD ${src} copies a local file/directory, not a URL or an auto-extracting archive. Use COPY instead, since ADD's extra behavior (remote fetch, tar auto-extract) doesn't apply here.`
+        });
+      }
+    }
+  }
+  return { findings, stages };
+}
 function removeJsComments(code) {
   let result = "";
   let i = 0;
@@ -21032,6 +21176,64 @@ function countSqlPlaceholders(sql) {
     numberedDuplicates
   };
 }
+var LINK_REF_DEFINITION_REGEX = /^ {0,3}\[([^\]]+)\]:\s*(\S+)(?:\s+(?:"([^"]*)"|'([^']*)'|\(([^)]*)\)))?\s*$/;
+var LINK_REF_USAGE_REGEX = /(!?)\[([^[\]\n]*)\]\[([^[\]\n]*)\]/g;
+function normalizeLinkLabel(label) {
+  return label.trim().replace(/\s+/g, " ").toLowerCase();
+}
+function extractMarkdownLinkReferences(markdown) {
+  const trimmed = markdown.trim();
+  if (!trimmed) return { error: "Empty input" };
+  const lines = markdown.replace(/\r\n/g, "\n").split("\n");
+  const definitions = [];
+  const definitionsByLabel = /* @__PURE__ */ new Map();
+  for (const line of lines) {
+    const match = line.match(LINK_REF_DEFINITION_REGEX);
+    if (!match) continue;
+    const label = match[1];
+    const normalized = normalizeLinkLabel(label);
+    if (definitionsByLabel.has(normalized)) continue;
+    const def = {
+      label,
+      url: match[2],
+      title: match[3] ?? match[4] ?? match[5] ?? void 0
+    };
+    definitionsByLabel.set(normalized, def);
+    definitions.push(def);
+  }
+  const usages = [];
+  for (const m of markdown.matchAll(LINK_REF_USAGE_REGEX)) {
+    const image = m[1] === "!";
+    const text = m[2];
+    const rawRef = m[3];
+    const label = rawRef.trim() === "" ? text : rawRef;
+    usages.push({ text, label, image });
+  }
+  if (definitions.length === 0 && usages.length === 0) {
+    return { error: "No reference-style links or definitions found" };
+  }
+  const usedLabels = /* @__PURE__ */ new Set();
+  const resolved = [];
+  const unresolvedReferences = [];
+  for (const usage of usages) {
+    const normalized = normalizeLinkLabel(usage.label);
+    const def = definitionsByLabel.get(normalized);
+    if (def) {
+      usedLabels.add(normalized);
+      resolved.push({ ...usage, url: def.url, title: def.title });
+    } else {
+      unresolvedReferences.push(usage);
+    }
+  }
+  const unusedDefinitions = definitions.filter((d) => !usedLabels.has(normalizeLinkLabel(d.label)));
+  return {
+    referenceCount: usages.length,
+    definitionCount: definitions.length,
+    resolved,
+    unresolvedReferences,
+    unusedDefinitions
+  };
+}
 
 // src/tools/color.ts
 var color_exports = {};
@@ -24632,6 +24834,7 @@ __export(ai_agent_exports, {
   extractEntities: () => extractEntities,
   extractJson: () => extractJson,
   extractKeywords: () => extractKeywords,
+  extractPromptTemplateVariables: () => extractPromptTemplateVariables,
   extractTables: () => extractTables,
   extractUrls: () => extractUrls,
   flattenJson: () => flattenJson,
@@ -25785,6 +25988,45 @@ function calculateRetryBackoffSchedule(input) {
     totalWorstCaseMs: round0(totalWorstCaseMs)
   };
 }
+var PROMPT_TEMPLATE_VARIABLE_REGEX = /\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g;
+function extractPromptTemplateVariables(template, providedVars) {
+  const trimmed = template.trim();
+  if (!trimmed) return { error: "Empty input" };
+  const order = [];
+  const counts = /* @__PURE__ */ new Map();
+  for (const m of template.matchAll(PROMPT_TEMPLATE_VARIABLE_REGEX)) {
+    const name = m[1];
+    if (!counts.has(name)) {
+      counts.set(name, 0);
+      order.push(name);
+    }
+    counts.set(name, (counts.get(name) ?? 0) + 1);
+  }
+  if (order.length === 0) return { error: "No {{variable}} placeholders found" };
+  const variables = order.map((name) => ({ name, count: counts.get(name) ?? 0 }));
+  const duplicates = order.filter((name) => (counts.get(name) ?? 0) > 1);
+  let missing = [];
+  const unused = [];
+  if (providedVars !== void 0) {
+    const providedSet = new Set(providedVars.map((v) => v.trim()).filter(Boolean));
+    const usedSet = new Set(order);
+    missing = order.filter((name) => !providedSet.has(name));
+    const seenProvided = /* @__PURE__ */ new Set();
+    for (const raw of providedVars) {
+      const v = raw.trim();
+      if (!v || usedSet.has(v) || seenProvided.has(v)) continue;
+      seenProvided.add(v);
+      unused.push(v);
+    }
+  }
+  return {
+    variableCount: order.length,
+    variables,
+    duplicates,
+    missing,
+    unused
+  };
+}
 
 // src/tools/media.ts
 var media_exports = {};

package/dist/index.d.cts

@@ -4,15 +4,15 @@ export { h as hashing } from './hashing-CJjlvqS_.cjs';
 export { t as text } from './text-CNn3whZA.cjs';
 export { d as data } from './data-DIyBrJ6l.cjs';
 export { g as generators } from './generators-DAXXrMvG.cjs';
-export { t as time } from './time-KqJjdqII.cjs';
+export { t as time } from './time-VMAy_SrV.cjs';
 export { u as units } from './units-D7YRRwei.cjs';
 export { n as network } from './network-ylRtLPEs.cjs';
 export { a as api } from './api-CQnIUrVB.cjs';
-export { c as code } from './code-B8yHwP3m.cjs';
+export { c as code } from './code-mkKV7BQ4.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-DeCy0oZK.cjs';
+export { a as ai_agent } from './ai_agent-B9wWLBDf.cjs';
 export { m as media } from './media-DF8BS-iA.cjs';
 
 declare const version = "0.1.0";

package/dist/index.d.ts

@@ -4,15 +4,15 @@ export { h as hashing } from './hashing-CJjlvqS_.js';
 export { t as text } from './text-CNn3whZA.js';
 export { d as data } from './data-DIyBrJ6l.js';
 export { g as generators } from './generators-DAXXrMvG.js';
-export { t as time } from './time-KqJjdqII.js';
+export { t as time } from './time-VMAy_SrV.js';
 export { u as units } from './units-D7YRRwei.js';
 export { n as network } from './network-ylRtLPEs.js';
 export { a as api } from './api-CQnIUrVB.js';
-export { c as code } from './code-B8yHwP3m.js';
+export { c as code } from './code-mkKV7BQ4.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-DeCy0oZK.js';
+export { a as ai_agent } from './ai_agent-B9wWLBDf.js';
 export { m as media } from './media-DF8BS-iA.js';
 
 declare const version = "0.1.0";

package/dist/index.js

@@ -2,18 +2,18 @@ export { media_exports as media } from './chunk-ZWFZRDQ4.js';
 export { units_exports as units } from './chunk-OFLNVDNX.js';
 export { network_exports as network } from './chunk-SW3J5CAI.js';
 export { api_exports as api } from './chunk-U2HREMZU.js';
-export { code_exports as code } from './chunk-FPFA4ZHC.js';
+export { code_exports as code } from './chunk-RMXZMYSG.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-HJLGUNSO.js';
+export { ai_agent_exports as ai_agent } from './chunk-5VVC7BHS.js';
 export { json_exports as json } from './chunk-WUOZHCIC.js';
 export { encoding_exports as encoding } from './chunk-DOWQZUTP.js';
 export { hashing_exports as hashing } from './chunk-PET2CGTH.js';
 export { text_exports as text } from './chunk-QVOK3BXM.js';
 export { data_exports as data } from './chunk-XOUS3M5Z.js';
 export { generators_exports as generators } from './chunk-422ICOZX.js';
-export { time_exports as time } from './chunk-IEPWZERQ.js';
+export { time_exports as time } from './chunk-6EJVNQSY.js';
 import './chunk-MLKGABMK.js';
 
 // src/index.ts

package/dist/{time-KqJjdqII.d.cts → time-VMAy_SrV.d.cts}

@@ -6,6 +6,7 @@
  *  - date-diff   : parseDate, humanizeDiff, diffDates, COMMON_DATE_PRESETS
  *  - timezone    : TIMEZONES, getTimezoneOffset, convertTime, formatInTimezone, getAllZonesForTime
  *  - cron-next   : parseCronExpression, getNextRuns, formatRunDate, getRunInterval
+ *  - cron-overlap-detector : findCronOverlaps
  *  - iso8601-duration : parseIso8601Duration, formatIso8601Duration
  */
 interface TimestampResult {
@@ -112,6 +113,22 @@ declare function getNextRuns(expr: string, count?: number, fromDate?: Date): Dat
 };
 declare function formatRunDate(date: Date, timezone?: string): string;
 declare function getRunInterval(dates: Date[]): string;
+interface CronOverlap {
+    date: Date;
+    expressionIndexes: number[];
+}
+interface CronOverlapResult {
+    overlaps: CronOverlap[];
+    windowDays: number;
+    truncated: boolean;
+}
+/**
+ * Walk minute-by-minute over `windowDays` and flag every minute where two or
+ * more of the given 5-field cron expressions fire at once.
+ */
+declare function findCronOverlaps(expressions: string[], windowDays?: number, fromDate?: Date): CronOverlapResult | {
+    error: string;
+};
 interface DurationParseResult {
     input: string;
     years: number;
@@ -158,6 +175,8 @@ declare const time_COMMON_CRONS: typeof COMMON_CRONS;
 declare const time_COMMON_DATE_PRESETS: typeof COMMON_DATE_PRESETS;
 type time_CronField = CronField;
 type time_CronNextField = CronNextField;
+type time_CronOverlap = CronOverlap;
+type time_CronOverlapResult = CronOverlapResult;
 type time_CronResult = CronResult;
 type time_DateDiffResult = DateDiffResult;
 type time_DurationFormatResult = DurationFormatResult;
@@ -168,6 +187,7 @@ type time_TimestampResult = TimestampResult;
 type time_TimezoneEntry = TimezoneEntry;
 declare const time_convertTime: typeof convertTime;
 declare const time_diffDates: typeof diffDates;
+declare const time_findCronOverlaps: typeof findCronOverlaps;
 declare const time_formatInTimezone: typeof formatInTimezone;
 declare const time_formatIso8601Duration: typeof formatIso8601Duration;
 declare const time_formatRelative: typeof formatRelative;
@@ -185,7 +205,7 @@ declare const time_parseCronExpression: typeof parseCronExpression;
 declare const time_parseDate: typeof parseDate;
 declare const time_parseIso8601Duration: typeof parseIso8601Duration;
 declare namespace time {
-  export { time_COMMON_CRONS as COMMON_CRONS, time_COMMON_DATE_PRESETS as COMMON_DATE_PRESETS, type time_CronField as CronField, type time_CronNextField as CronNextField, type time_CronResult as CronResult, type time_DateDiffResult as DateDiffResult, type time_DurationFormatResult as DurationFormatResult, type time_DurationParseResult as DurationParseResult, type time_ParsedCron as ParsedCron, time_TIMEZONES as TIMEZONES, type time_TimestampResult as TimestampResult, type time_TimezoneEntry as TimezoneEntry, time_convertTime as convertTime, time_diffDates as diffDates, time_formatInTimezone as formatInTimezone, time_formatIso8601Duration as formatIso8601Duration, time_formatRelative as formatRelative, time_formatRunDate as formatRunDate, time_fromIsoString as fromIsoString, time_fromUnix as fromUnix, time_getAllZonesForTime as getAllZonesForTime, time_getNextRuns as getNextRuns, time_getNow as getNow, time_getRunInterval as getRunInterval, time_getTimezoneOffset as getTimezoneOffset, time_humanizeDiff as humanizeDiff, time_parseCron as parseCron, time_parseCronExpression as parseCronExpression, time_parseDate as parseDate, time_parseIso8601Duration as parseIso8601Duration };
+  export { time_COMMON_CRONS as COMMON_CRONS, time_COMMON_DATE_PRESETS as COMMON_DATE_PRESETS, type time_CronField as CronField, type time_CronNextField as CronNextField, type time_CronOverlap as CronOverlap, type time_CronOverlapResult as CronOverlapResult, type time_CronResult as CronResult, type time_DateDiffResult as DateDiffResult, type time_DurationFormatResult as DurationFormatResult, type time_DurationParseResult as DurationParseResult, type time_ParsedCron as ParsedCron, time_TIMEZONES as TIMEZONES, type time_TimestampResult as TimestampResult, type time_TimezoneEntry as TimezoneEntry, time_convertTime as convertTime, time_diffDates as diffDates, time_findCronOverlaps as findCronOverlaps, time_formatInTimezone as formatInTimezone, time_formatIso8601Duration as formatIso8601Duration, time_formatRelative as formatRelative, time_formatRunDate as formatRunDate, time_fromIsoString as fromIsoString, time_fromUnix as fromUnix, time_getAllZonesForTime as getAllZonesForTime, time_getNextRuns as getNextRuns, time_getNow as getNow, time_getRunInterval as getRunInterval, time_getTimezoneOffset as getTimezoneOffset, time_humanizeDiff as humanizeDiff, time_parseCron as parseCron, time_parseCronExpression as parseCronExpression, time_parseDate as parseDate, time_parseIso8601Duration as parseIso8601Duration };
 }
 
-export { parseIso8601Duration as A, COMMON_CRONS as C, type DateDiffResult as D, type ParsedCron as P, TIMEZONES as T, COMMON_DATE_PRESETS as a, type CronField as b, type CronNextField as c, type CronResult as d, type DurationFormatResult as e, type DurationParseResult as f, type TimestampResult as g, type TimezoneEntry as h, convertTime as i, diffDates as j, formatInTimezone as k, formatIso8601Duration as l, formatRelative as m, formatRunDate as n, fromIsoString as o, fromUnix as p, getAllZonesForTime as q, getNextRuns as r, getNow as s, time as t, getRunInterval as u, getTimezoneOffset as v, humanizeDiff as w, parseCron as x, parseCronExpression as y, parseDate as z };
+export { parseCron as A, parseCronExpression as B, COMMON_CRONS as C, type DateDiffResult as D, parseDate as E, parseIso8601Duration as F, type ParsedCron as P, TIMEZONES as T, COMMON_DATE_PRESETS as a, type CronField as b, type CronNextField as c, type CronOverlap as d, type CronOverlapResult as e, type CronResult as f, type DurationFormatResult as g, type DurationParseResult as h, type TimestampResult as i, type TimezoneEntry as j, convertTime as k, diffDates as l, findCronOverlaps as m, formatInTimezone as n, formatIso8601Duration as o, formatRelative as p, formatRunDate as q, fromIsoString as r, fromUnix as s, time as t, getAllZonesForTime as u, getNextRuns as v, getNow as w, getRunInterval as x, getTimezoneOffset as y, humanizeDiff as z };

package/dist/{time-KqJjdqII.d.ts → time-VMAy_SrV.d.ts}

@@ -6,6 +6,7 @@
  *  - date-diff   : parseDate, humanizeDiff, diffDates, COMMON_DATE_PRESETS
  *  - timezone    : TIMEZONES, getTimezoneOffset, convertTime, formatInTimezone, getAllZonesForTime
  *  - cron-next   : parseCronExpression, getNextRuns, formatRunDate, getRunInterval
+ *  - cron-overlap-detector : findCronOverlaps
  *  - iso8601-duration : parseIso8601Duration, formatIso8601Duration
  */
 interface TimestampResult {
@@ -112,6 +113,22 @@ declare function getNextRuns(expr: string, count?: number, fromDate?: Date): Dat
 };
 declare function formatRunDate(date: Date, timezone?: string): string;
 declare function getRunInterval(dates: Date[]): string;
+interface CronOverlap {
+    date: Date;
+    expressionIndexes: number[];
+}
+interface CronOverlapResult {
+    overlaps: CronOverlap[];
+    windowDays: number;
+    truncated: boolean;
+}
+/**
+ * Walk minute-by-minute over `windowDays` and flag every minute where two or
+ * more of the given 5-field cron expressions fire at once.
+ */
+declare function findCronOverlaps(expressions: string[], windowDays?: number, fromDate?: Date): CronOverlapResult | {
+    error: string;
+};
 interface DurationParseResult {
     input: string;
     years: number;
@@ -158,6 +175,8 @@ declare const time_COMMON_CRONS: typeof COMMON_CRONS;
 declare const time_COMMON_DATE_PRESETS: typeof COMMON_DATE_PRESETS;
 type time_CronField = CronField;
 type time_CronNextField = CronNextField;
+type time_CronOverlap = CronOverlap;
+type time_CronOverlapResult = CronOverlapResult;
 type time_CronResult = CronResult;
 type time_DateDiffResult = DateDiffResult;
 type time_DurationFormatResult = DurationFormatResult;
@@ -168,6 +187,7 @@ type time_TimestampResult = TimestampResult;
 type time_TimezoneEntry = TimezoneEntry;
 declare const time_convertTime: typeof convertTime;
 declare const time_diffDates: typeof diffDates;
+declare const time_findCronOverlaps: typeof findCronOverlaps;
 declare const time_formatInTimezone: typeof formatInTimezone;
 declare const time_formatIso8601Duration: typeof formatIso8601Duration;
 declare const time_formatRelative: typeof formatRelative;
@@ -185,7 +205,7 @@ declare const time_parseCronExpression: typeof parseCronExpression;
 declare const time_parseDate: typeof parseDate;
 declare const time_parseIso8601Duration: typeof parseIso8601Duration;
 declare namespace time {
-  export { time_COMMON_CRONS as COMMON_CRONS, time_COMMON_DATE_PRESETS as COMMON_DATE_PRESETS, type time_CronField as CronField, type time_CronNextField as CronNextField, type time_CronResult as CronResult, type time_DateDiffResult as DateDiffResult, type time_DurationFormatResult as DurationFormatResult, type time_DurationParseResult as DurationParseResult, type time_ParsedCron as ParsedCron, time_TIMEZONES as TIMEZONES, type time_TimestampResult as TimestampResult, type time_TimezoneEntry as TimezoneEntry, time_convertTime as convertTime, time_diffDates as diffDates, time_formatInTimezone as formatInTimezone, time_formatIso8601Duration as formatIso8601Duration, time_formatRelative as formatRelative, time_formatRunDate as formatRunDate, time_fromIsoString as fromIsoString, time_fromUnix as fromUnix, time_getAllZonesForTime as getAllZonesForTime, time_getNextRuns as getNextRuns, time_getNow as getNow, time_getRunInterval as getRunInterval, time_getTimezoneOffset as getTimezoneOffset, time_humanizeDiff as humanizeDiff, time_parseCron as parseCron, time_parseCronExpression as parseCronExpression, time_parseDate as parseDate, time_parseIso8601Duration as parseIso8601Duration };
+  export { time_COMMON_CRONS as COMMON_CRONS, time_COMMON_DATE_PRESETS as COMMON_DATE_PRESETS, type time_CronField as CronField, type time_CronNextField as CronNextField, type time_CronOverlap as CronOverlap, type time_CronOverlapResult as CronOverlapResult, type time_CronResult as CronResult, type time_DateDiffResult as DateDiffResult, type time_DurationFormatResult as DurationFormatResult, type time_DurationParseResult as DurationParseResult, type time_ParsedCron as ParsedCron, time_TIMEZONES as TIMEZONES, type time_TimestampResult as TimestampResult, type time_TimezoneEntry as TimezoneEntry, time_convertTime as convertTime, time_diffDates as diffDates, time_findCronOverlaps as findCronOverlaps, time_formatInTimezone as formatInTimezone, time_formatIso8601Duration as formatIso8601Duration, time_formatRelative as formatRelative, time_formatRunDate as formatRunDate, time_fromIsoString as fromIsoString, time_fromUnix as fromUnix, time_getAllZonesForTime as getAllZonesForTime, time_getNextRuns as getNextRuns, time_getNow as getNow, time_getRunInterval as getRunInterval, time_getTimezoneOffset as getTimezoneOffset, time_humanizeDiff as humanizeDiff, time_parseCron as parseCron, time_parseCronExpression as parseCronExpression, time_parseDate as parseDate, time_parseIso8601Duration as parseIso8601Duration };
 }
 
-export { parseIso8601Duration as A, COMMON_CRONS as C, type DateDiffResult as D, type ParsedCron as P, TIMEZONES as T, COMMON_DATE_PRESETS as a, type CronField as b, type CronNextField as c, type CronResult as d, type DurationFormatResult as e, type DurationParseResult as f, type TimestampResult as g, type TimezoneEntry as h, convertTime as i, diffDates as j, formatInTimezone as k, formatIso8601Duration as l, formatRelative as m, formatRunDate as n, fromIsoString as o, fromUnix as p, getAllZonesForTime as q, getNextRuns as r, getNow as s, time as t, getRunInterval as u, getTimezoneOffset as v, humanizeDiff as w, parseCron as x, parseCronExpression as y, parseDate as z };
+export { parseCron as A, parseCronExpression as B, COMMON_CRONS as C, type DateDiffResult as D, parseDate as E, parseIso8601Duration as F, type ParsedCron as P, TIMEZONES as T, COMMON_DATE_PRESETS as a, type CronField as b, type CronNextField as c, type CronOverlap as d, type CronOverlapResult as e, type CronResult as f, type DurationFormatResult as g, type DurationParseResult as h, type TimestampResult as i, type TimezoneEntry as j, convertTime as k, diffDates as l, findCronOverlaps as m, formatInTimezone as n, formatIso8601Duration as o, formatRelative as p, formatRunDate as q, fromIsoString as r, fromUnix as s, time as t, getAllZonesForTime as u, getNextRuns as v, getNow as w, getRunInterval as x, getTimezoneOffset as y, humanizeDiff as z };

package/dist/tools/ai_agent.cjs

@@ -1137,6 +1137,45 @@ function calculateRetryBackoffSchedule(input) {
     totalWorstCaseMs: round0(totalWorstCaseMs)
   };
 }
+var PROMPT_TEMPLATE_VARIABLE_REGEX = /\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g;
+function extractPromptTemplateVariables(template, providedVars) {
+  const trimmed = template.trim();
+  if (!trimmed) return { error: "Empty input" };
+  const order = [];
+  const counts = /* @__PURE__ */ new Map();
+  for (const m of template.matchAll(PROMPT_TEMPLATE_VARIABLE_REGEX)) {
+    const name = m[1];
+    if (!counts.has(name)) {
+      counts.set(name, 0);
+      order.push(name);
+    }
+    counts.set(name, (counts.get(name) ?? 0) + 1);
+  }
+  if (order.length === 0) return { error: "No {{variable}} placeholders found" };
+  const variables = order.map((name) => ({ name, count: counts.get(name) ?? 0 }));
+  const duplicates = order.filter((name) => (counts.get(name) ?? 0) > 1);
+  let missing = [];
+  const unused = [];
+  if (providedVars !== void 0) {
+    const providedSet = new Set(providedVars.map((v) => v.trim()).filter(Boolean));
+    const usedSet = new Set(order);
+    missing = order.filter((name) => !providedSet.has(name));
+    const seenProvided = /* @__PURE__ */ new Set();
+    for (const raw of providedVars) {
+      const v = raw.trim();
+      if (!v || usedSet.has(v) || seenProvided.has(v)) continue;
+      seenProvided.add(v);
+      unused.push(v);
+    }
+  }
+  return {
+    variableCount: order.length,
+    variables,
+    duplicates,
+    missing,
+    unused
+  };
+}
 
 exports.MODEL_PRICING = MODEL_PRICING;
 exports.calculateRetryBackoffSchedule = calculateRetryBackoffSchedule;
@@ -1155,6 +1194,7 @@ exports.expandQuery = expandQuery;
 exports.extractEntities = extractEntities;
 exports.extractJson = extractJson;
 exports.extractKeywords = extractKeywords;
+exports.extractPromptTemplateVariables = extractPromptTemplateVariables;
 exports.extractTables = extractTables;
 exports.extractUrls = extractUrls;
 exports.flattenJson = flattenJson;

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, 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, x as RetryBackoffAttempt, y as RetryBackoffInput, z as RetryBackoffResult, A as RetryJitterMode, S as SanitizeResult, B as SecretDetectResult, G as SecretFinding, H as SecretType, L as SummaryResult, T as TableResult2, N as TextChunk, O as TokenEstimate, Q as TokenEstimateResult, U as ToolSchemaIssue, V as ToolSchemaLintResult, W as TrimResult, X as TrimStrategy, Y as UrlMatch, Z as ValidationError, _ as ValidationResult, $ as VectorSimilarityResult, a0 as calculateRetryBackoffSchedule, a1 as chunkText, a2 as compressHtml, a3 as compressJson, a4 as compressMarkdown, a5 as deduplicateLines, a6 as detectPii, a7 as detectPromptInjection, a8 as detectSecrets, a9 as diffJson, aa as estimateCost, ab as estimateTokens, ac as expandQuery, ad as extractEntities, ae as extractJson, af as extractKeywords, ag as extractTables, ah as extractUrls, ai as flattenJson, aj as formatFewShotExamples, ak as lintToolSchema, al as mergeJson, am as redactPii, an as repairJson, ao as rerankChunks, ap as sanitizeHtml, aq as scoreRelevance, ar as summarizeForLlm, as as trimToTokens, at as unflattenJson, au as validateJsonSchema, av as vectorSimilarity } from '../ai_agent-DeCy0oZK.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, w as PromptTemplateVariable, x as PromptTemplateVariableResult, R as RankedChunk, y as RelevanceResult, z as RetryBackoffAttempt, A as RetryBackoffInput, B as RetryBackoffResult, G as RetryJitterMode, S as SanitizeResult, H as SecretDetectResult, L as SecretFinding, N as SecretType, O as SummaryResult, T as TableResult2, Q as TextChunk, U as TokenEstimate, V as TokenEstimateResult, W as ToolSchemaIssue, X as ToolSchemaLintResult, Y as TrimResult, Z as TrimStrategy, _ as UrlMatch, $ as ValidationError, a0 as ValidationResult, a1 as VectorSimilarityResult, a2 as calculateRetryBackoffSchedule, a3 as chunkText, a4 as compressHtml, a5 as compressJson, a6 as compressMarkdown, a7 as deduplicateLines, a8 as detectPii, a9 as detectPromptInjection, aa as detectSecrets, ab as diffJson, ac as estimateCost, ad as estimateTokens, ae as expandQuery, af as extractEntities, ag as extractJson, ah as extractKeywords, ai as extractPromptTemplateVariables, aj as extractTables, ak as extractUrls, al as flattenJson, am as formatFewShotExamples, an as lintToolSchema, ao as mergeJson, ap as redactPii, aq as repairJson, ar as rerankChunks, as as sanitizeHtml, at as scoreRelevance, au as summarizeForLlm, av as trimToTokens, aw as unflattenJson, ax as validateJsonSchema, ay as vectorSimilarity } from '../ai_agent-B9wWLBDf.cjs';

package/dist/tools/ai_agent.d.ts

@@ -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, 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, x as RetryBackoffAttempt, y as RetryBackoffInput, z as RetryBackoffResult, A as RetryJitterMode, S as SanitizeResult, B as SecretDetectResult, G as SecretFinding, H as SecretType, L as SummaryResult, T as TableResult2, N as TextChunk, O as TokenEstimate, Q as TokenEstimateResult, U as ToolSchemaIssue, V as ToolSchemaLintResult, W as TrimResult, X as TrimStrategy, Y as UrlMatch, Z as ValidationError, _ as ValidationResult, $ as VectorSimilarityResult, a0 as calculateRetryBackoffSchedule, a1 as chunkText, a2 as compressHtml, a3 as compressJson, a4 as compressMarkdown, a5 as deduplicateLines, a6 as detectPii, a7 as detectPromptInjection, a8 as detectSecrets, a9 as diffJson, aa as estimateCost, ab as estimateTokens, ac as expandQuery, ad as extractEntities, ae as extractJson, af as extractKeywords, ag as extractTables, ah as extractUrls, ai as flattenJson, aj as formatFewShotExamples, ak as lintToolSchema, al as mergeJson, am as redactPii, an as repairJson, ao as rerankChunks, ap as sanitizeHtml, aq as scoreRelevance, ar as summarizeForLlm, as as trimToTokens, at as unflattenJson, au as validateJsonSchema, av as vectorSimilarity } from '../ai_agent-DeCy0oZK.js';
+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, w as PromptTemplateVariable, x as PromptTemplateVariableResult, R as RankedChunk, y as RelevanceResult, z as RetryBackoffAttempt, A as RetryBackoffInput, B as RetryBackoffResult, G as RetryJitterMode, S as SanitizeResult, H as SecretDetectResult, L as SecretFinding, N as SecretType, O as SummaryResult, T as TableResult2, Q as TextChunk, U as TokenEstimate, V as TokenEstimateResult, W as ToolSchemaIssue, X as ToolSchemaLintResult, Y as TrimResult, Z as TrimStrategy, _ as UrlMatch, $ as ValidationError, a0 as ValidationResult, a1 as VectorSimilarityResult, a2 as calculateRetryBackoffSchedule, a3 as chunkText, a4 as compressHtml, a5 as compressJson, a6 as compressMarkdown, a7 as deduplicateLines, a8 as detectPii, a9 as detectPromptInjection, aa as detectSecrets, ab as diffJson, ac as estimateCost, ad as estimateTokens, ae as expandQuery, af as extractEntities, ag as extractJson, ah as extractKeywords, ai as extractPromptTemplateVariables, aj as extractTables, ak as extractUrls, al as flattenJson, am as formatFewShotExamples, an as lintToolSchema, ao as mergeJson, ap as redactPii, aq as repairJson, ar as rerankChunks, as as sanitizeHtml, at as scoreRelevance, au as summarizeForLlm, av as trimToTokens, aw as unflattenJson, ax as validateJsonSchema, ay as vectorSimilarity } from '../ai_agent-B9wWLBDf.js';

package/dist/tools/ai_agent.js

@@ -1,2 +1,2 @@
-export { MODEL_PRICING, calculateRetryBackoffSchedule, chunkText, compressHtml, compressJson, compressMarkdown, deduplicateLines, detectPii, detectPromptInjection, detectSecrets, diffJson, estimateCost, estimateTokens, expandQuery, extractEntities, extractJson, extractKeywords, extractTables, extractUrls, flattenJson, formatFewShotExamples, lintToolSchema, mergeJson, redactPii, repairJson, rerankChunks, sanitizeHtml, scoreRelevance, summarizeForLlm, trimToTokens, unflattenJson, validateJsonSchema, vectorSimilarity } from '../chunk-HJLGUNSO.js';
+export { MODEL_PRICING, calculateRetryBackoffSchedule, chunkText, compressHtml, compressJson, compressMarkdown, deduplicateLines, detectPii, detectPromptInjection, detectSecrets, diffJson, estimateCost, estimateTokens, expandQuery, extractEntities, extractJson, extractKeywords, extractPromptTemplateVariables, extractTables, extractUrls, flattenJson, formatFewShotExamples, lintToolSchema, mergeJson, redactPii, repairJson, rerankChunks, sanitizeHtml, scoreRelevance, summarizeForLlm, trimToTokens, unflattenJson, validateJsonSchema, vectorSimilarity } from '../chunk-5VVC7BHS.js';
 import '../chunk-MLKGABMK.js';