dsh-context-fold 0.1.4 → 0.1.5

package/lib/index.js

@@ -1351,19 +1351,26 @@ function counterfactualOf(folds, steps, options = {}) {
 	const savedTokenRate = cacheReadShare === void 0 ? price.uncachedInput : cacheReadShare * price.cacheRead + (1 - cacheReadShare) * price.uncachedInput;
 	const grossSaving = tokensSavedPerStep * remainingSteps * savedTokenRate;
 	let invalidationCost = 0;
-	if (foldSteps !== void 0) for (const foldStep of foldSteps) {
-		const at = steps.find((step) => step.step >= foldStep);
-		if (at === void 0) continue;
-		const prompt = promptTokensOf(at);
-		invalidationCost += prompt * (price.uncachedInput - price.cacheRead);
+	if (foldSteps !== void 0) {
+		const distinct = [...new Set(foldSteps)];
+		for (const foldStep of distinct) {
+			const at = steps.find((step) => step.step >= foldStep);
+			if (at === void 0) continue;
+			const prompt = promptTokensOf(at);
+			invalidationCost += prompt * (price.uncachedInput - price.cacheRead);
+		}
 	}
 	const counterfactualPromptCost = actualPromptCost + tokensSavedPerStep * remainingSteps * savedTokenRate;
 	const assumptions = [];
 	assumptions.push(hasRealUsage ? `Prices are DeepSeek ratios (cache read ${price.cacheRead}×, write ${price.cacheWrite}×, uncached ${price.uncachedInput}×), applied to this session's observed usage.` : "This session reported no provider usage, so even the \"actual\" figures are heuristic token counts, not billed amounts.");
 	if (cacheReadShare !== void 0) assumptions.push(`Saved tokens are priced at this session's observed cache-read share (${(cacheReadShare * 100).toFixed(1)}%), not at the uncached rate.`);
 	if (foldSteps === void 0 || foldSteps.length === 0) assumptions.push("Fold step numbers were unavailable, so every observed step is credited with the saving. Treat the figure as an upper bound.");
-	else assumptions.push(`Each fold is charged one prefix invalidation: the whole prompt after it re-billed from cache-read to uncached once.`);
+	else {
+		const distinctFoldSteps = new Set(foldSteps).size;
+		assumptions.push(`Each of the ${String(distinctFoldSteps)} distinct fold step(s) is charged one prefix invalidation: the prompt after it re-billed from cache-read to uncached once. Folds sharing a step share that charge, because they invalidate the same prefix.`);
+	}
 	assumptions.push("The counterfactual assumes the same number of steps and the same cache behaviour as the real session — a folded prompt might have hit cache differently.");
+	assumptions.push("\"Saving per step\" is the total prompt reduction on the surface, not a per-fold figure: it is multiplied by the steps that followed each fold.");
 	return {
 		tokensNow,
 		tokensIfUnfolded,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-context-fold",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "dsh-context-fold: stage-boundary folding of completed tool results into a conclusion plus a spill path, deterministic and replay-safe.",
   "type": "module",
   "main": "lib/index.js",