@librechat/agents 3.7.6 → 3.7.8

package/dist/cjs/llm/bedrock/toolCache.cjs

@@ -1,5 +1,5 @@
-const require_lazyRequire = require("../../lazyRequire.cjs");
 const require_cache = require("../../messages/cache.cjs");
+const require_lazyRequire = require("../../lazyRequire.cjs");
 //#region src/llm/bedrock/toolCache.ts
 const convertToOpenAITool = (...args) => require_lazyRequire.requireInternalModule("llm/openai/index")._convertToOpenAITool(...args);
 const BEDROCK_TOOL_CACHE_MARKER = "__lc_bedrock_cache_point_after";

package/dist/cjs/llm/fake.cjs

@@ -6,10 +6,11 @@ var FakeChatModel = class extends _langchain_core_utils_testing.FakeListChatMode
 	splitStrategy;
 	toolCalls = [];
 	addedToolCalls = false;
+	finalChunkGenerationInfo;
 	constructor({ responses, sleep, emitCustomEvent, splitStrategy = {
 		type: "regex",
 		value: /(?<=\s+)|(?=\s+)/
-	}, toolCalls = [] }) {
+	}, toolCalls = [], finalChunkGenerationInfo }) {
 		super({
 			responses,
 			sleep,
@@ -17,6 +18,7 @@ var FakeChatModel = class extends _langchain_core_utils_testing.FakeListChatMode
 		});
 		this.splitStrategy = splitStrategy;
 		this.toolCalls = toolCalls;
+		this.finalChunkGenerationInfo = finalChunkGenerationInfo;
 	}
 	splitText(text) {
 		if (this.splitStrategy.type === "regex") return text.split(this.splitStrategy.value);
@@ -27,13 +29,14 @@ var FakeChatModel = class extends _langchain_core_utils_testing.FakeListChatMode
 			return chunks;
 		}
 	}
-	_createResponseChunk(text, tool_call_chunks) {
+	_createResponseChunk(text, tool_call_chunks, responseMetadata) {
 		return new _langchain_core_outputs.ChatGenerationChunk({
 			text,
-			generationInfo: {},
+			generationInfo: responseMetadata ?? {},
 			message: new _langchain_core_messages.AIMessageChunk({
 				content: text,
 				tool_call_chunks,
+				response_metadata: responseMetadata,
 				additional_kwargs: tool_call_chunks ? { tool_calls: tool_call_chunks.map((toolCall) => ({
 					index: toolCall.index ?? 0,
 					id: toolCall.id ?? "",
@@ -51,10 +54,11 @@ var FakeChatModel = class extends _langchain_core_utils_testing.FakeListChatMode
 		this._incrementResponse();
 		if (this.emitCustomEvent) await runManager?.handleCustomEvent("some_test_event", { someval: true });
 		const chunks = this.splitText(response);
-		for await (const chunk of chunks) {
+		for (let i = 0; i < chunks.length; i++) {
+			const chunk = chunks[i];
 			await this._sleepIfRequested();
 			if (options.thrownErrorString != null && options.thrownErrorString) throw new Error(options.thrownErrorString);
-			yield super._createResponseChunk(chunk);
+			yield i === chunks.length - 1 && this.toolCalls.length === 0 && this.finalChunkGenerationInfo != null ? this._createResponseChunk(chunk, void 0, this.finalChunkGenerationInfo) : super._createResponseChunk(chunk);
 			runManager?.handleLLMNewToken(chunk);
 		}
 		await this._sleepIfRequested();

package/dist/cjs/llm/fake.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"fake.cjs","names":["FakeListChatModel","ChatGenerationChunk","AIMessageChunk"],"sources":["../../../src/llm/fake.ts"],"mappings":";;;;AAYA,IAAa,gBAAb,cAAmCA,8BAAAA,kBAAkB;CACnD;CACA,YAAgC,CAAC;CACjC,iBAAkC;CAElC,YAAY,EACV,WACA,OACA,iBACA,gBAAgB;EAAE,MAAM;EAAS,OAAO;CAAmB,GAC3D,YAAY,CAAC,KAOZ;EACD,MAAM;GAAE;GAAW;GAAO;EAAgB,CAAC;EAC3C,KAAK,gBAAgB;EACrB,KAAK,YAAY;CACnB;CAEA,UAAkB,MAAwB;EACxC,IAAI,KAAK,cAAc,SAAS,SAC9B,OAAO,KAAK,MAAM,KAAK,cAAc,KAAe;OAC/C;GACL,MAAM,YAAY,KAAK,cAAc;GACrC,MAAM,SAAmB,CAAC;GAC1B,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,WACpC,OAAO,KAAK,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC;GAE1C,OAAO;EACT;CACF;CACA,qBACE,MACA,kBACqB;EACrB,OAAO,IAAIC,wBAAAA,oBAAoB;GAC7B;GACA,gBAAgB,CAAC;GACjB,SAAS,IAAIC,yBAAAA,eAAe;IAC1B,SAAS;IACT;IACA,mBAAmB,mBACf,EACA,YAAY,iBAAiB,KAAK,cAAc;KAC9C,OAAO,SAAS,SAAS;KACzB,IAAI,SAAS,MAAM;KACnB,MAAM;KACN,UAAU;MACR,MAAM,SAAS,QAAQ;MACvB,WAAW,SAAS,QAAQ;KAC9B;IACF,EAAE,EACJ,IACE,KAAA;GACN,CAAC;EACH,CAAC;CACH;CAEA,OAAO,sBACL,WACA,SACA,YACqC;EACrC,MAAM,WAAW,KAAK,iBAAiB;EACvC,KAAK,mBAAmB;EAExB,IAAI,KAAK,iBACP,MAAM,YAAY,kBAAkB,mBAAmB,EACrD,SAAS,KACX,CAAC;EAGH,MAAM,SAAS,KAAK,UAAU,QAAQ;EACtC,WAAW,MAAM,SAAS,QAAQ;GAChC,MAAM,KAAK,kBAAkB;GAE7B,IAAI,QAAQ,qBAAqB,QAAQ,QAAQ,mBAC/C,MAAM,IAAI,MAAM,QAAQ,iBAAiB;GAI3C,MADsB,MAAM,qBAAqB,KAC/B;GAClB,YAAiB,kBAAkB,KAAK;EAC1C;EAEA,MAAM,KAAK,kBAAkB;EAC7B,IAAI,KAAK,UAAU,SAAS,KAAK,CAAC,KAAK,gBAAgB;GACrD,KAAK,iBAAiB;GACtB,MAAM,iBAAiB,KAAK,UAAU,KAAK,aAAa;IACtD,OAAO;KACL,MAAM,SAAS;KACf,MAAM,KAAK,UAAU,SAAS,IAAI;KAClC,IAAI,SAAS;KACb,MAAM;IACR;GACF,CAAC;GAED,MADsB,KAAK,qBAAqB,IAAI,cAClC;GAClB,YAAiB,kBAAkB,EAAE;EACvC;CACF;AACF;AAEA,SAAgB,uBAAuB,EACrC,WACA,OACA,eACA,aAMgB;CAChB,OAAO,IAAI,cAAc;EACvB;EACA;EACA,iBAAiB;EACjB;EACA;CACF,CAAC;AACH"}
+{"version":3,"file":"fake.cjs","names":["FakeListChatModel","ChatGenerationChunk","AIMessageChunk"],"sources":["../../../src/llm/fake.ts"],"mappings":";;;;AAYA,IAAa,gBAAb,cAAmCA,8BAAAA,kBAAkB;CACnD;CACA,YAAgC,CAAC;CACjC,iBAAkC;CASlC;CAEA,YAAY,EACV,WACA,OACA,iBACA,gBAAgB;EAAE,MAAM;EAAS,OAAO;CAAmB,GAC3D,YAAY,CAAC,GACb,4BAQC;EACD,MAAM;GAAE;GAAW;GAAO;EAAgB,CAAC;EAC3C,KAAK,gBAAgB;EACrB,KAAK,YAAY;EACjB,KAAK,2BAA2B;CAClC;CAEA,UAAkB,MAAwB;EACxC,IAAI,KAAK,cAAc,SAAS,SAC9B,OAAO,KAAK,MAAM,KAAK,cAAc,KAAe;OAC/C;GACL,MAAM,YAAY,KAAK,cAAc;GACrC,MAAM,SAAmB,CAAC;GAC1B,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,WACpC,OAAO,KAAK,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC;GAE1C,OAAO;EACT;CACF;CACA,qBACE,MACA,kBACA,kBACqB;EACrB,OAAO,IAAIC,wBAAAA,oBAAoB;GAC7B;GACA,gBAAgB,oBAAoB,CAAC;GACrC,SAAS,IAAIC,yBAAAA,eAAe;IAC1B,SAAS;IACT;IACA,mBAAmB;IACnB,mBAAmB,mBACf,EACA,YAAY,iBAAiB,KAAK,cAAc;KAC9C,OAAO,SAAS,SAAS;KACzB,IAAI,SAAS,MAAM;KACnB,MAAM;KACN,UAAU;MACR,MAAM,SAAS,QAAQ;MACvB,WAAW,SAAS,QAAQ;KAC9B;IACF,EAAE,EACJ,IACE,KAAA;GACN,CAAC;EACH,CAAC;CACH;CAEA,OAAO,sBACL,WACA,SACA,YACqC;EACrC,MAAM,WAAW,KAAK,iBAAiB;EACvC,KAAK,mBAAmB;EAExB,IAAI,KAAK,iBACP,MAAM,YAAY,kBAAkB,mBAAmB,EACrD,SAAS,KACX,CAAC;EAGH,MAAM,SAAS,KAAK,UAAU,QAAQ;EACtC,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;GACtC,MAAM,QAAQ,OAAO;GACrB,MAAM,KAAK,kBAAkB;GAE7B,IAAI,QAAQ,qBAAqB,QAAQ,QAAQ,mBAC/C,MAAM,IAAI,MAAM,QAAQ,iBAAiB;GAoB3C,MATE,MAAM,OAAO,SAAS,KAAK,KAAK,UAAU,WAAW,KAElC,KAAK,4BAA4B,OAChD,KAAK,qBACL,OACA,KAAA,GACA,KAAK,wBACP,IACE,MAAM,qBAAqB,KAAK;GAEtC,YAAiB,kBAAkB,KAAK;EAC1C;EAEA,MAAM,KAAK,kBAAkB;EAC7B,IAAI,KAAK,UAAU,SAAS,KAAK,CAAC,KAAK,gBAAgB;GACrD,KAAK,iBAAiB;GACtB,MAAM,iBAAiB,KAAK,UAAU,KAAK,aAAa;IACtD,OAAO;KACL,MAAM,SAAS;KACf,MAAM,KAAK,UAAU,SAAS,IAAI;KAClC,IAAI,SAAS;KACb,MAAM;IACR;GACF,CAAC;GAED,MADsB,KAAK,qBAAqB,IAAI,cAClC;GAClB,YAAiB,kBAAkB,EAAE;EACvC;CACF;AACF;AAEA,SAAgB,uBAAuB,EACrC,WACA,OACA,eACA,aAMgB;CAChB,OAAO,IAAI,cAAc;EACvB;EACA;EACA,iBAAiB;EACjB;EACA;CACF,CAAC;AACH"}

package/dist/cjs/llm/invoke.cjs

@@ -1,8 +1,8 @@
 require("../common/enum.cjs");
 require("../common/index.cjs");
 const require_callbacks = require("../utils/callbacks.cjs");
-const require_core = require("../messages/core.cjs");
 const require_providerRegistry = require("./providerRegistry.cjs");
+const require_core = require("../messages/core.cjs");
 const require_events = require("../utils/events.cjs");
 const require_projectionInvariant = require("../messages/projectionInvariant.cjs");
 require("../messages/index.cjs");

package/dist/cjs/llm/openrouter/toolCache.cjs

@@ -1,5 +1,5 @@
-const require_lazyRequire = require("../../lazyRequire.cjs");
 const require_cache = require("../../messages/cache.cjs");
+const require_lazyRequire = require("../../lazyRequire.cjs");
 //#region src/llm/openrouter/toolCache.ts
 const convertToOpenAITool = (tool) => require_lazyRequire.requireInternalModule("llm/openai/index")._convertToOpenAITool(tool);
 function getToolName(tool) {

package/dist/cjs/llm/prepareProviderRequest.cjs

@@ -1,12 +1,12 @@
 require("../common/enum.cjs");
 require("../common/index.cjs");
+const require_providerRegistry = require("./providerRegistry.cjs");
+const require_llm = require("../utils/llm.cjs");
 const require_cache = require("../messages/cache.cjs");
 const require_core = require("../messages/core.cjs");
-const require_providerRegistry = require("./providerRegistry.cjs");
 const require_alternation = require("../messages/alternation.cjs");
 const require_handoffCue = require("../messages/handoffCue.cjs");
 require("../messages/index.cjs");
-const require_llm = require("../utils/llm.cjs");
 const require_toolOutputReferences = require("../tools/toolOutputReferences.cjs");
 require("./providers.cjs");
 //#region src/llm/prepareProviderRequest.ts

package/dist/cjs/llm/providers.cjs

@@ -1,7 +1,7 @@
 require("../common/enum.cjs");
 require("../common/index.cjs");
-const require_lazyRequire = require("../lazyRequire.cjs");
 const require_providerRegistry = require("./providerRegistry.cjs");
+const require_lazyRequire = require("../lazyRequire.cjs");
 //#region src/llm/providers.ts
 function initializeBuiltInProvider(provider, loadModel, traits) {
 	require_providerRegistry.registerBuiltInProviderLoader({

package/dist/cjs/llm/truncation.cjs

@@ -71,5 +71,6 @@ function assertNotTruncatedToolCall(message, provider) {
 }
 //#endregion
 exports.assertNotTruncatedToolCall = assertNotTruncatedToolCall;
+exports.getTruncationStopReason = getTruncationStopReason;
 
 //# sourceMappingURL=truncation.cjs.map

package/dist/cjs/main.cjs

@@ -7,11 +7,12 @@ const require_truncation = require("./utils/truncation.cjs");
 const require_tokenCounterCacheCompatibility = require("./llm/tokenCounterCacheCompatibility.cjs");
 const require_tokens = require("./utils/tokens.cjs");
 const require_provenance = require("./messages/provenance.cjs");
+const require_providerRegistry = require("./llm/providerRegistry.cjs");
+const require_llm = require("./utils/llm.cjs");
 const require_cache = require("./messages/cache.cjs");
 const require_core = require("./messages/core.cjs");
 const require_ids = require("./messages/ids.cjs");
 const require_contextPruningSettings = require("./messages/contextPruningSettings.cjs");
-const require_providerRegistry = require("./llm/providerRegistry.cjs");
 const require_contextPruning = require("./messages/contextPruning.cjs");
 const require_prune = require("./messages/prune.cjs");
 const require_budget = require("./messages/budget.cjs");
@@ -28,7 +29,6 @@ const require_assistantPhase = require("./messages/assistantPhase.cjs");
 const require_projectionInvariant = require("./messages/projectionInvariant.cjs");
 require("./messages/index.cjs");
 const require_graph = require("./utils/graph.cjs");
-const require_llm = require("./utils/llm.cjs");
 const require_proxy = require("./utils/proxy.cjs");
 const require_streamLimits = require("./llm/streamLimits.cjs");
 const require_handlers = require("./tools/handlers.cjs");
@@ -178,6 +178,7 @@ exports.CODE_API_RATE_LIMITED_ERROR_MESSAGE = require_CodeExecutor.CODE_API_RATE
 exports.CODE_API_UNAVAILABLE_ERROR_MESSAGE = require_CodeExecutor.CODE_API_UNAVAILABLE_ERROR_MESSAGE;
 exports.CODE_ARTIFACT_PATH_GUIDANCE = require_CodeExecutor.CODE_ARTIFACT_PATH_GUIDANCE;
 exports.CODE_EXECUTION_TOOLS = require_enum.CODE_EXECUTION_TOOLS;
+exports.COMPACTION_SEMANTIC_INDEX_LIMITS = require_constants.COMPACTION_SEMANTIC_INDEX_LIMITS;
 exports.Calculator = require_Calculator.Calculator;
 exports.CalculatorSchema = require_Calculator.CalculatorSchema;
 exports.CalculatorToolDefinition = require_Calculator.CalculatorToolDefinition;

package/dist/cjs/messages/format.cjs

@@ -1,3 +1,4 @@
+const require_constants = require("../common/constants.cjs");
 require("../common/enum.cjs");
 require("../common/index.cjs");
 const require_truncation = require("../utils/truncation.cjs");
@@ -5,6 +6,7 @@ const require_toolContent = require("../utils/toolContent.cjs");
 const require_provenance = require("./provenance.cjs");
 const require_langchain = require("./langchain.cjs");
 const require_toolResultTypes = require("./toolResultTypes.cjs");
+const require_semanticIndex = require("../summarization/semanticIndex.cjs");
 const require_message_inputs = require("../llm/anthropic/utils/message_inputs.cjs");
 const require_content = require("./content.cjs");
 const require_events = require("../utils/events.cjs");
@@ -140,6 +142,281 @@ function getToolUseId(part) {
 	if (!("tool_use_id" in part) || typeof part.tool_use_id !== "string") return;
 	return part.tool_use_id;
 }
+const DERIVED_SEMANTIC_HEAD_LIMIT = require_constants.COMPACTION_SEMANTIC_INDEX_LIMITS.maxInputEntries / 4;
+const DERIVED_SEMANTIC_TAIL_LIMIT = require_constants.COMPACTION_SEMANTIC_INDEX_LIMITS.maxInputEntries / 2;
+const DERIVED_SEMANTIC_TYPE_EDGE_LIMIT = require_constants.COMPACTION_SEMANTIC_INDEX_LIMITS.maxInputEntries / 32;
+const DERIVED_SEMANTIC_TYPE_HASH = Object.freeze({
+	tool_intent: 1,
+	tool_outcome: 2,
+	activity_phase: 3,
+	reasoning_label: 4
+});
+function createDerivedCompactionSemanticIndexCollector() {
+	return {
+		entries: [],
+		entryCount: 0
+	};
+}
+function createCompactionSemanticCoverageState() {
+	return {
+		head: [],
+		tail: {
+			entries: [],
+			cursor: 0
+		},
+		latestByIdentityHash: /* @__PURE__ */ new Map(),
+		typeCoverage: /* @__PURE__ */ new Map()
+	};
+}
+function getDerivedCompactionSemanticLocalId(entry) {
+	if (entry.type === "reasoning_label") return entry.reasoningStepId.trim();
+	if (entry.type !== "activity_phase") return entry.toolCallId.trim();
+	return "";
+}
+function hashDerivedCompactionSemanticIdentityString(initialHash, value) {
+	let hash = initialHash;
+	for (let index = 0; index < value.length; index++) {
+		hash ^= value.charCodeAt(index);
+		hash = Math.imul(hash, 16777619);
+	}
+	return hash;
+}
+function hashDerivedCompactionSemanticIdentity(entry) {
+	let hash = 2166136261 ^ DERIVED_SEMANTIC_TYPE_HASH[entry.type];
+	hash = Math.imul(hash, 16777619);
+	hash = hashDerivedCompactionSemanticIdentityString(hash, entry.sourceMessageId.trim());
+	hash ^= entry.sourceContentIndex;
+	hash = Math.imul(hash, 16777619);
+	hash = hashDerivedCompactionSemanticIdentityString(hash, getDerivedCompactionSemanticLocalId(entry));
+	return hash >>> 0;
+}
+function entriesShareDerivedCompactionSemanticIdentity(left, right) {
+	return left.type === right.type && left.sourceMessageId.trim() === right.sourceMessageId.trim() && left.sourceContentIndex === right.sourceContentIndex && getDerivedCompactionSemanticLocalId(left) === getDerivedCompactionSemanticLocalId(right);
+}
+function entriesHaveConflictingSemanticState(left, right) {
+	return left.status !== right.status || left.redacted === true !== (right.redacted === true) || left.text.replace(/\s+/g, " ").trim() !== right.text.replace(/\s+/g, " ").trim();
+}
+function retainCompactionSemanticEntry(entry) {
+	entry.retentionCount++;
+}
+function releaseCompactionSemanticEntry(coverage, entry) {
+	entry.retentionCount--;
+	if (entry.retentionCount === 0 && coverage.latestByIdentityHash.has(entry.identityHash)) {
+		const bucket = coverage.latestByIdentityHash.get(entry.identityHash);
+		if (bucket == null) return;
+		const entryIndex = bucket.indexOf(entry);
+		if (entryIndex >= 0) bucket.splice(entryIndex, 1);
+		if (bucket.length === 0) coverage.latestByIdentityHash.delete(entry.identityHash);
+	}
+}
+function appendCompactionSemanticEntryRing(coverage, ring, entry, limit) {
+	if (ring.entries.length < limit) {
+		ring.entries.push(entry);
+		retainCompactionSemanticEntry(entry);
+		return;
+	}
+	releaseCompactionSemanticEntry(coverage, ring.entries[ring.cursor]);
+	ring.entries[ring.cursor] = entry;
+	retainCompactionSemanticEntry(entry);
+	ring.cursor = (ring.cursor + 1) % limit;
+}
+function renewCompactionSemanticEntryRing(coverage, ring, entry, limit) {
+	const existingIndex = ring.entries.indexOf(entry);
+	if (existingIndex < 0) {
+		appendCompactionSemanticEntryRing(coverage, ring, entry, limit);
+		return;
+	}
+	if (ring.entries.length < limit) {
+		ring.entries.splice(existingIndex, 1);
+		ring.entries.push(entry);
+		return;
+	}
+	const newestIndex = (ring.cursor + ring.entries.length - 1) % ring.entries.length;
+	let currentIndex = existingIndex;
+	for (let offset = 0; currentIndex !== newestIndex && offset < ring.entries.length; offset++) {
+		const nextIndex = (currentIndex + 1) % ring.entries.length;
+		ring.entries[currentIndex] = ring.entries[nextIndex];
+		currentIndex = nextIndex;
+	}
+	ring.entries[newestIndex] = entry;
+}
+function renewCoverageBalancedCompactionSemanticEntry(coverage, entry) {
+	renewCompactionSemanticEntryRing(coverage, coverage.tail, entry, DERIVED_SEMANTIC_TAIL_LIMIT);
+	const typeCoverage = coverage.typeCoverage.get(entry.entry.type);
+	if (typeCoverage == null) return;
+	renewCompactionSemanticEntryRing(coverage, typeCoverage.tail, entry, DERIVED_SEMANTIC_TYPE_EDGE_LIMIT);
+}
+function appendDerivedCompactionSemanticEntry(collector, entry) {
+	let boundedEntry = entry;
+	if (entry.status === "pending") boundedEntry = {
+		...entry,
+		text: ""
+	};
+	else if (entry.text.length > require_constants.COMPACTION_SEMANTIC_INDEX_LIMITS.maxInputTextChars) boundedEntry = {
+		...entry,
+		text: "",
+		redacted: true
+	};
+	const order = collector.entryCount;
+	collector.entryCount++;
+	if (collector.coverage == null && collector.entries.length < require_constants.COMPACTION_SEMANTIC_INDEX_LIMITS.maxInputEntries) {
+		collector.entries.push(boundedEntry);
+		return;
+	}
+	const orderedEntry = {
+		entry: boundedEntry,
+		identityHash: hashDerivedCompactionSemanticIdentity(boundedEntry),
+		order,
+		retentionCount: 0
+	};
+	if (collector.coverage == null) {
+		collector.coverage = createCompactionSemanticCoverageState();
+		for (let order = 0; order < collector.entries.length; order++) appendCoverageBalancedCompactionSemanticEntry(collector.coverage, {
+			entry: collector.entries[order],
+			identityHash: hashDerivedCompactionSemanticIdentity(collector.entries[order]),
+			order,
+			retentionCount: 0
+		});
+		collector.entries = [];
+	}
+	appendCoverageBalancedCompactionSemanticEntry(collector.coverage, orderedEntry);
+}
+function appendCoverageBalancedCompactionSemanticEntry(coverage, orderedEntry) {
+	const identityHash = orderedEntry.identityHash;
+	const identityBucket = coverage.latestByIdentityHash.get(identityHash);
+	const current = identityBucket?.find(({ entry }) => entriesShareDerivedCompactionSemanticIdentity(entry, orderedEntry.entry));
+	if (current != null) {
+		if (orderedEntry.entry.revision < current.entry.revision) return;
+		if (orderedEntry.entry.revision === current.entry.revision) {
+			if (entriesHaveConflictingSemanticState(current.entry, orderedEntry.entry)) {
+				current.entry = {
+					...current.entry,
+					text: "",
+					redacted: true
+				};
+				current.order = orderedEntry.order;
+				renewCoverageBalancedCompactionSemanticEntry(coverage, current);
+			}
+			return;
+		}
+		current.entry = orderedEntry.entry;
+		current.order = orderedEntry.order;
+		renewCoverageBalancedCompactionSemanticEntry(coverage, current);
+		return;
+	}
+	if (identityBucket == null) coverage.latestByIdentityHash.set(identityHash, [orderedEntry]);
+	else identityBucket.push(orderedEntry);
+	if (coverage.head.length < DERIVED_SEMANTIC_HEAD_LIMIT) {
+		coverage.head.push(orderedEntry);
+		retainCompactionSemanticEntry(orderedEntry);
+	}
+	appendCompactionSemanticEntryRing(coverage, coverage.tail, orderedEntry, DERIVED_SEMANTIC_TAIL_LIMIT);
+	let typeCoverage = coverage.typeCoverage.get(orderedEntry.entry.type);
+	if (typeCoverage == null) {
+		typeCoverage = {
+			head: [],
+			tail: {
+				entries: [],
+				cursor: 0
+			}
+		};
+		coverage.typeCoverage.set(orderedEntry.entry.type, typeCoverage);
+	}
+	if (typeCoverage.head.length < DERIVED_SEMANTIC_TYPE_EDGE_LIMIT) {
+		typeCoverage.head.push(orderedEntry);
+		retainCompactionSemanticEntry(orderedEntry);
+	}
+	appendCompactionSemanticEntryRing(coverage, typeCoverage.tail, orderedEntry, DERIVED_SEMANTIC_TYPE_EDGE_LIMIT);
+}
+function finalizeDerivedCompactionSemanticIndex(collector) {
+	if (collector == null || collector.entryCount === 0) return;
+	if (collector.coverage == null) {
+		require_semanticIndex.setCompactionSemanticIndexProvidedEntryCount(collector.entries, collector.entryCount);
+		return collector.entries;
+	}
+	const retained = /* @__PURE__ */ new Map();
+	const retain = (entries) => {
+		for (const { entry, order } of entries) retained.set(order, entry);
+	};
+	retain(collector.coverage.head);
+	retain(collector.coverage.tail.entries);
+	for (const typeCoverage of collector.coverage.typeCoverage.values()) {
+		retain(typeCoverage.head);
+		retain(typeCoverage.tail.entries);
+	}
+	const result = [...retained.entries()].sort(([left], [right]) => left - right).map(([, entry]) => entry);
+	require_semanticIndex.setCompactionSemanticIndexProvidedEntryCount(result, collector.entryCount);
+	return result;
+}
+function collectCompactionSemanticEntriesFromPart(collector, part, sourceMessageId, sourceContentIndex, retainedSourceContentStart, retainedSourceContentEnd, intentToolNames, parsedToolInput) {
+	if (sourceMessageId.length > require_constants.COMPACTION_SEMANTIC_INDEX_LIMITS.maxIdentityChars) return;
+	if (part.type === "tool_call") {
+		if (sourceContentIndex < 0 || sourceContentIndex > require_constants.COMPACTION_SEMANTIC_INDEX_LIMITS.maxSourceContentIndex) return;
+		const toolCall = part.tool_call;
+		const toolCallId = toolCall?.id;
+		if (typeof toolCallId !== "string" || toolCallId === "" || toolCallId.length > require_constants.COMPACTION_SEMANTIC_INDEX_LIMITS.maxIdentityChars) return;
+		if (typeof toolCall.name === "string" && intentToolNames?.has(toolCall.name) === true) {
+			const intent = parsedToolInput != null && typeof parsedToolInput === "object" && !Array.isArray(parsedToolInput) ? parsedToolInput.intent : void 0;
+			if (typeof intent === "string" && intent !== "") appendDerivedCompactionSemanticEntry(collector, {
+				type: "tool_intent",
+				sourceMessageId,
+				sourceContentIndex,
+				revision: 0,
+				status: "committed",
+				text: intent,
+				toolCallId
+			});
+		}
+		if (typeof toolCall.outcome === "string" && toolCall.outcome !== "") appendDerivedCompactionSemanticEntry(collector, {
+			type: "tool_outcome",
+			sourceMessageId,
+			sourceContentIndex,
+			revision: 0,
+			status: "committed",
+			text: toolCall.outcome,
+			toolCallId
+		});
+		return;
+	}
+	if (part.type === "think") {
+		if (sourceContentIndex < 0 || sourceContentIndex > require_constants.COMPACTION_SEMANTIC_INDEX_LIMITS.maxSourceContentIndex) return;
+		const reasoningStepId = part.reasoning_label_step_id;
+		const revision = part.reasoning_label_revision;
+		const status = part.reasoning_label_status;
+		const text = part.reasoning_label;
+		if (typeof reasoningStepId !== "string" || reasoningStepId === "" || reasoningStepId.length > require_constants.COMPACTION_SEMANTIC_INDEX_LIMITS.maxIdentityChars || typeof revision !== "number" || !Number.isSafeInteger(revision) || revision < 0) return;
+		const malformedState = status !== "complete" && status !== "streaming" || typeof text !== "string";
+		appendDerivedCompactionSemanticEntry(collector, {
+			type: "reasoning_label",
+			sourceMessageId,
+			sourceContentIndex,
+			revision,
+			status: status === "streaming" || malformedState ? "pending" : "committed",
+			text: typeof text === "string" ? text : "",
+			reasoningStepId,
+			...malformedState ? { redacted: true } : {}
+		});
+		return;
+	}
+	if (part.type !== "activity_label" || part.activity_label_type !== "phase") return;
+	const activitySourceContentIndex = part.activity_start_index;
+	if (typeof activitySourceContentIndex !== "number" || !Number.isSafeInteger(activitySourceContentIndex) || activitySourceContentIndex < retainedSourceContentStart || activitySourceContentIndex >= retainedSourceContentEnd || activitySourceContentIndex > require_constants.COMPACTION_SEMANTIC_INDEX_LIMITS.maxSourceContentIndex) return;
+	const revision = part.activity_label_revision;
+	if (revision !== void 0 && (typeof revision !== "number" || !Number.isSafeInteger(revision) || revision < 0)) return;
+	const malformedPending = part.pending !== void 0 && typeof part.pending !== "boolean";
+	const malformedText = typeof part.activity_label !== "string";
+	const malformedState = malformedPending || malformedText;
+	const text = typeof part.activity_label === "string" ? part.activity_label : "";
+	appendDerivedCompactionSemanticEntry(collector, {
+		type: "activity_phase",
+		sourceMessageId,
+		sourceContentIndex: activitySourceContentIndex,
+		revision: revision ?? 0,
+		status: part.pending === true || malformedPending ? "pending" : "committed",
+		text,
+		...malformedState ? { redacted: true } : {}
+	});
+}
 function collectTrustedToolResultSourceContentPartIndices(content, sourceContentPartOffset) {
 	if (content == null) return;
 	let calls;
@@ -295,6 +572,10 @@ function formatAssistantMessage(message, options) {
 	const emittedServerToolUseIds = /* @__PURE__ */ new Set();
 	const pendingServerToolUses = /* @__PURE__ */ new Map();
 	const shouldPreserveReasoningContent = options?.preserveReasoningContent === true;
+	const compactionSemanticIndex = options?.compactionSemanticIndex;
+	const semanticSourceMessageId = compactionSemanticIndex != null && options?.sourceMessageId != null && options.sourceMessageId.length <= require_constants.COMPACTION_SEMANTIC_INDEX_LIMITS.maxIdentityChars ? options.sourceMessageId : void 0;
+	const retainedSourceContentStart = options?.sourceContentPartOffset ?? 0;
+	const retainedSourceContentEnd = options?.retainedSourceContentEnd ?? retainedSourceContentStart;
 	const serverToolResultIds = /* @__PURE__ */ new Set();
 	const preferredToolCallParts = /* @__PURE__ */ new Map();
 	const takePendingReasoningContent = () => {
@@ -353,6 +634,7 @@ function formatAssistantMessage(message, options) {
 		for (let partIndex = 0; partIndex < contentParts.length; partIndex++) {
 			const part = contentParts[partIndex];
 			if (part == null) continue;
+			if (part.type === "activity_label") continue;
 			const isTrustedResult = isTrustedServerToolResult(part, getSourcePartIndices(partIndex), options?.toolSourceContentPartIndices);
 			if (isTrustedResult) {
 				trustedServerToolResultPartIndices ??= /* @__PURE__ */ new Set();
@@ -374,6 +656,10 @@ function formatAssistantMessage(message, options) {
 			const part = contentParts[partIndex];
 			if (part == null) continue;
 			const sourcePartIndices = getSourcePartIndices(partIndex);
+			if (part.type === "activity_label") {
+				if (compactionSemanticIndex != null && semanticSourceMessageId != null && typeof sourcePartIndices === "number") collectCompactionSemanticEntriesFromPart(compactionSemanticIndex, part, semanticSourceMessageId, sourcePartIndices, retainedSourceContentStart, retainedSourceContentEnd, options?.intentToolNames);
+				continue;
+			}
 			const toolUseId = getToolUseId(part);
 			if (toolUseId != null) {
 				const isServerToolResult = trustedServerToolResultPartIndices?.has(partIndex) === true;
@@ -418,12 +704,14 @@ function formatAssistantMessage(message, options) {
 				if (options?.provider === "anthropic" && typeof _tool_call.id === "string" && _tool_call.id.startsWith("srvtoolu_")) {
 					if (!serverToolResultIds.has(_tool_call.id) && options.preserveUnpairedServerToolUses !== true) continue;
 					if (emittedServerToolUseIds.has(_tool_call.id) || pendingServerToolUses.has(_tool_call.id)) continue;
+					const serverToolInput = parseServerToolInput(_args);
+					if (compactionSemanticIndex != null && semanticSourceMessageId != null && typeof sourcePartIndices === "number") collectCompactionSemanticEntriesFromPart(compactionSemanticIndex, part, semanticSourceMessageId, sourcePartIndices, retainedSourceContentStart, retainedSourceContentEnd, options.intentToolNames, serverToolInput);
 					pendingServerToolUses.set(_tool_call.id, {
 						content: {
 							type: "server_tool_use",
 							id: _tool_call.id,
 							name: _tool_call.name,
-							input: parseServerToolInput(_args)
+							input: serverToolInput
 						},
 						sourceContentPartIndices: sourcePartIndices
 					});
@@ -442,6 +730,7 @@ function formatAssistantMessage(message, options) {
 					if (typeof _args === "string") args = { input: _args };
 				}
 				tool_call.args = args;
+				if (compactionSemanticIndex != null && semanticSourceMessageId != null && typeof sourcePartIndices === "number") collectCompactionSemanticEntriesFromPart(compactionSemanticIndex, part, semanticSourceMessageId, sourcePartIndices, retainedSourceContentStart, retainedSourceContentEnd, options?.intentToolNames, args);
 				if (options?.provider === "anthropic" && Array.isArray(lastAIMessage.content)) {
 					const content = lastAIMessage.content;
 					content.push({
@@ -461,6 +750,7 @@ function formatAssistantMessage(message, options) {
 					content: formatToolCallOutput(output)
 				}), "tool"), "tool", sourcePartIndices);
 			} else if (part.type === "think" || part.type === "thinking" || part.type === "reasoning" || part.type === "reasoning_content" || part.type === "redacted_thinking") {
+				if (part.type === "think" && compactionSemanticIndex != null && semanticSourceMessageId != null && typeof sourcePartIndices === "number") collectCompactionSemanticEntriesFromPart(compactionSemanticIndex, part, semanticSourceMessageId, sourcePartIndices, retainedSourceContentStart, retainedSourceContentEnd, options?.intentToolNames);
 				hasReasoning = true;
 				pendingReasoningContent += extractReasoningContent(part);
 				appendSourceContentPartIndices(pendingReasoningSourcePartIndices, sourcePartIndices);
@@ -487,7 +777,7 @@ function formatAssistantMessage(message, options) {
 				hasReasoning = false;
 				pendingReasoningContent = "";
 				pendingReasoningSourcePartIndices = [];
-			} else if (part.type === "error" || part.type === "agent_update" || part.type === "summary" || part.type === "activity_label") continue;
+			} else if (part.type === "error" || part.type === "agent_update" || part.type === "summary") continue;
 			else {
 				if (part.type === "text" && !getTextContent(part).trim()) continue;
 				currentContent.push(part);
@@ -764,6 +1054,7 @@ function extractSkillName(args) {
 const formatAgentMessages = (payload, indexTokenCountMap, tools, skills, options) => {
 	const messages = [];
 	const legacyContentEnabled = options?.legacyContent === true;
+	const compactionSemanticIndexCollector = options?.compactionSemanticIndex != null ? createDerivedCompactionSemanticIndexCollector() : void 0;
 	const emitFormattedMessage = (message) => {
 		if (legacyContentEnabled && require_content.isLegacyConvertible(message)) {
 			const flattened = require_content.flattenLegacyContent(message.content);
@@ -914,9 +1205,12 @@ const formatAgentMessages = (payload, indexTokenCountMap, tools, skills, options
 			}
 		}
 		const formattedMessages = formatAssistantMessage(processedMessage, {
+			compactionSemanticIndex: compactionSemanticIndexCollector,
+			intentToolNames: options?.compactionSemanticIndex?.intentToolNames,
 			preserveUnpairedServerToolUses: i === payload.length - 1,
 			preserveReasoningContent: options?.preserveReasoningContent ?? options?.provider === "deepseek",
 			provider: options?.provider,
+			retainedSourceContentEnd: sourceContentPartOffset + (Array.isArray(message.content) ? message.content.length : 0),
 			sourceMessageId,
 			sourceContentPartOffset,
 			sourceContentPartIndices: processedSourceContentPartIndices,
@@ -1043,7 +1337,8 @@ const formatAgentMessages = (payload, indexTokenCountMap, tools, skills, options
 			text: summaryBoundary.text,
 			tokenCount: summaryBoundary.tokenCount
 		} : void 0,
-		boundaryTokenAdjustment
+		boundaryTokenAdjustment,
+		compactionSemanticIndex: finalizeDerivedCompactionSemanticIndex(compactionSemanticIndexCollector)
 	};
 };
 function shiftIndexTokenCountMap(indexTokenCountMap, instructionsTokenCount) {