promptopskit 0.8.1 → 0.8.2

package/dist/index.cjs

@@ -3327,6 +3327,7 @@ var RISKY_UNBOUNDED_INPUT_NAMES = [
   "body",
   "context"
 ];
+var COMPRESS_MODIFIER_RE = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\|\s*compress\s*\}\}/g;
 function validateAsset(asset, frontMatterKeys, filePath) {
   const errors = [];
   const warnings = [];
@@ -3408,6 +3409,26 @@ function validateAsset(asset, frontMatterKeys, filePath) {
       suggestion: "Declare context.inputs to enable input policy validation."
     });
   }
+  if (asset.compression?.heuristic?.enabled === true && asset.compression.heuristic.json_to_toon !== true) {
+    warnings.push({
+      code: "POK055",
+      message: "Prompt-level heuristic compression is enabled for the full prompt template.",
+      filePath,
+      suggestion: "Prefer per-placeholder compression for bulky context values so instructions, output constraints, and safety conditions are not sentence-selected away."
+    });
+  }
+  const systemHeuristicCompressionVariables = findSystemHeuristicCompressionVariables(
+    asset.sections?.system_instructions,
+    declaredInputsByName
+  );
+  if (systemHeuristicCompressionVariables.length > 0) {
+    warnings.push({
+      code: "POK056",
+      message: `System instructions use heuristic compression for ${formatQuotedList(systemHeuristicCompressionVariables)}.`,
+      filePath,
+      suggestion: "Avoid compressing values inside system instructions; move lossy compression to prompt-template context placeholders when possible."
+    });
+  }
   for (const input of contextInputs) {
     const lowerName = input.name.toLowerCase();
     const inputWarningsEnabled = areContextInputWarningsEnabled(input);
@@ -3599,6 +3620,26 @@ function findClosestMatch(input, candidates) {
   }
   return best;
 }
+function findSystemHeuristicCompressionVariables(systemInstructions, declaredInputsByName) {
+  if (!systemInstructions) {
+    return [];
+  }
+  const variables = /* @__PURE__ */ new Set();
+  for (const match of systemInstructions.matchAll(COMPRESS_MODIFIER_RE)) {
+    variables.add(match[1]);
+  }
+  for (const variable of extractVariables(systemInstructions)) {
+    const input = declaredInputsByName.get(variable);
+    const heuristic = input?.compression?.heuristic;
+    if (heuristic?.enabled === true && heuristic.json_to_toon !== true) {
+      variables.add(variable);
+    }
+  }
+  return [...variables].sort();
+}
+function formatQuotedList(values) {
+  return values.map((value) => `"${value}"`).join(", ");
+}
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }