@librechat/agents 3.7.15 → 3.7.17

package/dist/esm/messages/fading.mjs

@@ -0,0 +1,108 @@
+import { calculateMaxToolCallInputChars, calculateMaxToolResultChars } from "../utils/truncation.mjs";
+//#region src/messages/fading.ts
+const FADING_TIER_VERSION = 1;
+const PRESSURE_THRESHOLD_MASKING = .8;
+const FADING_MIN_BUDGET_TOKENS = 170;
+const MASKED_RESULT_MIN_CHARS = 300;
+const MASKED_RESULT_CAP_RATIO = .1;
+const PRESSURE_BAND_RUNGS = [
+	[.99, 4],
+	[.9, 2],
+	[.85, 1]
+];
+function floorBudgetTokens(window) {
+	return Math.min(170, window);
+}
+function createFadingTier(window) {
+	return {
+		v: 1,
+		budgetTokens: window,
+		masked: false
+	};
+}
+function isFadingTier(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const { v, budgetTokens, masked, latched } = value;
+	return v === 1 && typeof budgetTokens === "number" && Number.isFinite(budgetTokens) && budgetTokens > 0 && typeof masked === "boolean" && (latched === void 0 || latched === true);
+}
+function maxFadingRung(window) {
+	const floor = floorBudgetTokens(window);
+	if (!(floor > 0)) return 0;
+	return Math.max(0, Math.ceil(Math.log2(window / floor)));
+}
+function fadingBudgetTokens(window, rung) {
+	return Math.max(floorBudgetTokens(window), Math.floor(window / 2 ** rung));
+}
+function seedFadingTier(window, seed) {
+	if (!isFadingTier(seed)) return createFadingTier(window);
+	const budgetTokens = Math.max(floorBudgetTokens(window), Math.min(seed.budgetTokens, window));
+	if (!(seed.latched === true || seed.masked || budgetTokens !== seed.budgetTokens || budgetTokens < window)) return createFadingTier(window);
+	return {
+		v: 1,
+		budgetTokens,
+		masked: seed.masked,
+		latched: true
+	};
+}
+function fadingRungForResultChars(window, targetChars, maxToolResultChars) {
+	const deepest = maxFadingRung(window);
+	for (let rung = 0; rung < deepest; rung++) {
+		const windowResultChars = calculateMaxToolResultChars(fadingBudgetTokens(window, rung));
+		if ((maxToolResultChars == null ? windowResultChars : Math.min(windowResultChars, maxToolResultChars)) <= targetChars) return rung;
+	}
+	return deepest;
+}
+function fadingRungForBudget(window, rawTokens, maxToolResultChars, toolExchangeWidth = 1) {
+	if (!(rawTokens > 0)) return 0;
+	const targetChars = Math.floor(rawTokens) * 4;
+	const width = Math.max(1, Math.floor(toolExchangeWidth));
+	const deepest = maxFadingRung(window);
+	for (let rung = 0; rung < deepest; rung++) {
+		const budgetTokens = fadingBudgetTokens(window, rung);
+		const windowResultChars = calculateMaxToolResultChars(budgetTokens);
+		if (width * ((maxToolResultChars == null ? windowResultChars : Math.min(windowResultChars, maxToolResultChars)) + calculateMaxToolCallInputChars(budgetTokens)) <= targetChars) return rung;
+	}
+	return deepest;
+}
+function fadingRungForExchangeChars(window, targetChars, maxToolResultChars) {
+	const deepest = maxFadingRung(window);
+	for (let rung = 0; rung < deepest; rung++) {
+		const budgetTokens = fadingBudgetTokens(window, rung);
+		const windowResultChars = calculateMaxToolResultChars(budgetTokens);
+		if ((maxToolResultChars == null ? windowResultChars : Math.min(windowResultChars, maxToolResultChars)) + calculateMaxToolCallInputChars(budgetTokens) <= targetChars) return rung;
+	}
+	return deepest;
+}
+function resolveFadingCaps(tier, maxToolResultChars) {
+	const { budgetTokens } = tier;
+	const windowResultChars = calculateMaxToolResultChars(budgetTokens);
+	const resultChars = maxToolResultChars != null ? Math.min(windowResultChars, maxToolResultChars) : windowResultChars;
+	return {
+		budgetTokens,
+		resultChars,
+		consumedChars: tier.masked ? Math.min(resultChars, Math.max(300, Math.floor(resultChars * MASKED_RESULT_CAP_RATIO))) : resultChars,
+		inputChars: calculateMaxToolCallInputChars(budgetTokens)
+	};
+}
+function resolveFadingTier(tier, window, signals, maxToolResultChars) {
+	const fitRung = fadingRungForBudget(window, signals.effectiveRawTokens, maxToolResultChars, signals.toolExchangeWidth);
+	const bandRung = signals.summarizationEnabled ? 0 : PRESSURE_BAND_RUNGS.find(([threshold]) => signals.contextPressure >= threshold)?.[1] ?? 0;
+	const rung = Math.min(maxFadingRung(window), Math.max(fitRung + bandRung, signals.minRung ?? 0));
+	const budgetTokens = Math.min(tier.budgetTokens, fadingBudgetTokens(window, rung));
+	const masked = tier.masked || signals.contextPressure >= .8;
+	if (budgetTokens === tier.budgetTokens && masked === tier.masked) return tier;
+	return {
+		v: 1,
+		budgetTokens,
+		masked,
+		latched: true
+	};
+}
+function isInformativeFadingTier(tier, window) {
+	if (tier == null) return false;
+	return tier.latched === true || tier.masked || window != null && window > 0 && tier.budgetTokens < window;
+}
+//#endregion
+export { FADING_MIN_BUDGET_TOKENS, FADING_TIER_VERSION, MASKED_RESULT_MIN_CHARS, PRESSURE_THRESHOLD_MASKING, createFadingTier, fadingBudgetTokens, fadingRungForBudget, fadingRungForExchangeChars, fadingRungForResultChars, isFadingTier, isInformativeFadingTier, maxFadingRung, resolveFadingCaps, resolveFadingTier, seedFadingTier };
+
+//# sourceMappingURL=fading.mjs.map

package/dist/esm/messages/fading.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fading.mjs","names":[],"sources":["../../../src/messages/fading.ts"],"mappings":"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"}

package/dist/esm/messages/format.mjs

@@ -1,7 +1,7 @@
+import { HARD_MAX_TOOL_RESULT_CHARS } from "../utils/truncation.mjs";
 import { COMPACTION_SEMANTIC_INDEX_LIMITS } from "../common/constants.mjs";
 import "../common/enum.mjs";
 import "../common/index.mjs";
-import { HARD_MAX_TOOL_RESULT_CHARS } from "../utils/truncation.mjs";
 import { compactToolContent, getToolContentCharLength, isAtomicToolContentBlock, serializeStructuredValueBounded } from "../utils/toolContent.mjs";
 import { hasBijectiveProviderContentPartMapping, inspectProviderMessageProvenance, inspectProviderSourceMessageIds, setFreshProviderMessageProvenance, setInvalidProviderMessageProvenance, setProviderMessageProvenance } from "./provenance.mjs";
 import { toLangChainContent, toLangChainMessageFields } from "./langchain.mjs";

package/dist/esm/messages/index.mjs

@@ -1,3 +1,4 @@
+import "./fading.mjs";
 import "./provenance.mjs";
 import "./cache.mjs";
 import "./core.mjs";