@librechat/agents 3.8.4 → 3.8.6

package/dist/esm/tools/toolBatchReplay.mjs

@@ -1,8 +1,8 @@
 import { attachRunStepResumeState, getRunStepResumeState, stripRunStepResumeState } from "./runStepResume.mjs";
 import { isToolNodeResumeState, isToolOutputReferenceState, requireValidSubagentResumeManifest, stripSubagentResumeManifest } from "./subagent/SubagentReplay.mjs";
 import { isToolApprovalInterrupt } from "../types/hitl.mjs";
-import { TOOL_APPROVAL_REVIEW_CONFIG_KEY, createToolApprovalReviewEvidence, getToolApprovalReviewEvidence } from "../hitl/approvalReview.mjs";
 import "../hooks/types.mjs";
+import { TOOL_APPROVAL_REVIEW_CONFIG_KEY, createToolApprovalReviewEvidence, getToolApprovalReviewEvidence } from "../hitl/approvalReview.mjs";
 import { isBaseMessage } from "@langchain/core/messages";
 import { Command, MemorySaver, isCommand } from "@langchain/langgraph";
 //#region src/tools/toolBatchReplay.ts
@@ -13,10 +13,35 @@ const serializer = new MemorySaver().serde;
 function isRecord(value) {
 	return value != null && typeof value === "object" && !Array.isArray(value);
 }
+function bindLegacyReplayOwner(owner, configurable) {
+	let identity;
+	try {
+		identity = JSON.parse(owner);
+	} catch {
+		return owner;
+	}
+	if (!Array.isArray(identity) || identity.length !== 3) return owner;
+	return JSON.stringify([
+		...identity,
+		typeof configurable.user_id === "string" ? configurable.user_id : "",
+		typeof configurable.thread_id === "string" ? configurable.thread_id : ""
+	]);
+}
+function bindLegacyReplayState(state, configurable) {
+	if (state == null) return void 0;
+	return {
+		...state,
+		approvalOwner: state.approvalOwner == null ? void 0 : bindLegacyReplayOwner(state.approvalOwner, configurable),
+		records: state.records.map((record) => ({
+			...record,
+			owner: bindLegacyReplayOwner(record.owner, configurable)
+		}))
+	};
+}
 function restoreToolReplayConfig(configurable, interruptId, payload) {
 	delete configurable[TOOL_BATCH_REPLAY_KEY];
 	delete configurable[TOOL_APPROVAL_REVIEW_CONFIG_KEY];
-	const state = getToolBatchReplayState(payload);
+	const state = bindLegacyReplayState(getToolBatchReplayState(payload), configurable);
 	const publicPayload = getPublicToolInterruptPayload(payload);
 	const review = createToolApprovalReviewEvidence(interruptId, publicPayload, state?.approvalOwner);
 	if (isToolApprovalInterrupt(publicPayload) && (review == null || state != null && state.approvalOwner == null)) throw new Error("Invalid tool approval checkpoint");
@@ -26,20 +51,44 @@ function restoreToolReplayConfig(configurable, interruptId, payload) {
 	};
 	if (review != null) configurable[TOOL_APPROVAL_REVIEW_CONFIG_KEY] = review;
 }
-function isToolReplayResume(config, interruptId, isChildReplay) {
+function getToolReplayResumeStatus(config, interruptId, isChildReplay) {
 	const resumeMap = config.configurable?.__pregel_resume_map;
-	if (interruptId != null && resumeMap != null && !Object.prototype.hasOwnProperty.call(resumeMap, interruptId)) return false;
-	if (isChildReplay && resumeMap != null) return true;
 	const scratchpad = config.configurable?.__pregel_scratchpad;
-	return scratchpad == null || (scratchpad.resume?.length ?? 0) > 0 || scratchpad.nullResume !== void 0;
+	if (!isRecord(scratchpad) || !Array.isArray(scratchpad.resume)) return "unverifiable";
+	if (scratchpad.nullResume !== void 0) return "active";
+	const hasResume = scratchpad.resume.length > 0;
+	if (!isRecord(resumeMap)) return hasResume ? "unverifiable" : "stale";
+	if (interruptId == null) {
+		if (!hasResume) return "stale";
+		return Object.keys(resumeMap).length === 1 ? "active" : "unverifiable";
+	}
+	if (!Object.prototype.hasOwnProperty.call(resumeMap, interruptId)) return hasResume ? "unverifiable" : "stale";
+	if (isChildReplay) return "active";
+	return hasResume ? "active" : "stale";
 }
 function getToolBatchReplayOwner(config, agentId) {
 	return JSON.stringify([
 		getToolBatchReplayScope(config),
 		config.configurable?.["__librechat_tool_approval_execution_scope"] == null ? config.configurable?.checkpoint_ns ?? "" : "",
-		agentId
+		agentId,
+		typeof config.configurable?.user_id === "string" ? config.configurable.user_id : "",
+		typeof config.configurable?.thread_id === "string" ? config.configurable.thread_id : ""
 	]);
 }
+function clearStaleToolApprovalConfig(configurable, owner, batch) {
+	delete configurable[TOOL_APPROVAL_REVIEW_CONFIG_KEY];
+	const state = getToolBatchReplayState(configurable);
+	const records = batch == null ? [] : state?.records.filter((record) => record.owner === owner && record.batch === batch) ?? [];
+	if (state == null || records.length === 0) {
+		delete configurable[TOOL_BATCH_REPLAY_KEY];
+		return;
+	}
+	configurable[TOOL_BATCH_REPLAY_KEY] = {
+		version: 1,
+		records,
+		wrappedPayload: state.wrappedPayload
+	};
+}
 function getToolBatchReplayScope(config) {
 	const scope = config.configurable?.["__librechat_tool_approval_execution_scope"] ?? config.configurable?.thread_id;
 	return typeof scope === "string" && scope.length > 0 ? scope : void 0;
@@ -48,7 +97,7 @@ function isChildToolReplayOwner(config, owner, trustedParentCallIds) {
 	const manifest = requireValidSubagentResumeManifest(config.configurable);
 	if (manifest == null || trustedParentCallIds.size === 0) return false;
 	const identity = JSON.parse(owner);
-	if (!Array.isArray(identity) || identity.length !== 3 || identity[1] !== "") return false;
+	if (!Array.isArray(identity) || identity.length !== 3 && identity.length !== 5 || identity[1] !== "") return false;
 	const pending = manifest.executions.filter((execution) => trustedParentCallIds.has(execution.parentToolCallId));
 	while (pending.length > 0) {
 		const execution = pending.pop();
@@ -57,11 +106,13 @@ function isChildToolReplayOwner(config, owner, trustedParentCallIds) {
 	}
 	return false;
 }
-function rebindToolBatchReplayScope(configurable, sourceScope, destinationScope) {
+function rebindToolBatchReplayScope(configurable, sourceScope, destinationScope, destinationThreadId) {
 	const rebind = (key) => {
 		const parts = JSON.parse(key);
 		if (!Array.isArray(parts) || parts[0] !== sourceScope) return key;
-		return JSON.stringify([destinationScope, ...parts.slice(1)]);
+		const rebound = [destinationScope, ...parts.slice(1)];
+		if (rebound.length === 5 && destinationThreadId != null) rebound[4] = destinationThreadId;
+		return JSON.stringify(rebound);
 	};
 	const review = getToolApprovalReviewEvidence({ configurable });
 	if (review?.owner != null) configurable[TOOL_APPROVAL_REVIEW_CONFIG_KEY] = {
@@ -79,12 +130,12 @@ function rebindToolBatchReplayScope(configurable, sourceScope, destinationScope)
 		}))
 	};
 }
-function rebindToolBatchReplayPayload(payload, sourceScope, destinationScope) {
+function rebindToolBatchReplayPayload(payload, sourceScope, destinationScope, destinationThreadId) {
 	const state = getToolBatchReplayState(payload);
 	const value = stripRunStepResumeState(payload);
 	if (state == null || !isRecord(value)) return payload;
 	const configurable = { [TOOL_BATCH_REPLAY_KEY]: state };
-	rebindToolBatchReplayScope(configurable, sourceScope, destinationScope);
+	rebindToolBatchReplayScope(configurable, sourceScope, destinationScope, destinationThreadId);
 	const rebound = {
 		...value,
 		[TOOL_BATCH_REPLAY_KEY]: configurable[TOOL_BATCH_REPLAY_KEY]
@@ -181,6 +232,6 @@ async function restoreToolBatchReplayState(config, owner) {
 	}));
 }
 //#endregion
-export { TOOL_BATCH_REPLAY_KEY, attachToolBatchReplayState, getPublicToolInterruptPayload, getToolBatchReplayOwner, getToolBatchReplayScope, getToolBatchReplayState, isChildToolReplayOwner, isToolReplayResume, rebindToolBatchReplayPayload, rebindToolBatchReplayScope, restoreToolBatchReplayState, restoreToolReplayConfig, stripToolBatchReplayState };
+export { TOOL_BATCH_REPLAY_KEY, attachToolBatchReplayState, clearStaleToolApprovalConfig, getPublicToolInterruptPayload, getToolBatchReplayOwner, getToolBatchReplayScope, getToolBatchReplayState, getToolReplayResumeStatus, isChildToolReplayOwner, rebindToolBatchReplayPayload, rebindToolBatchReplayScope, restoreToolBatchReplayState, restoreToolReplayConfig, stripToolBatchReplayState };
 
 //# sourceMappingURL=toolBatchReplay.mjs.map

package/dist/esm/tools/toolBatchReplay.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"toolBatchReplay.mjs","names":[],"sources":["../../../src/tools/toolBatchReplay.ts"],"mappings":"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"}
+{"version":3,"file":"toolBatchReplay.mjs","names":[],"sources":["../../../src/tools/toolBatchReplay.ts"],"mappings":";;;;;;;;AAyBA,MAAa,wBAAwB;AACrC,MAAM,yBAAyB;AAC/B,MAAM,yBAAyB;AAiC/B,MAAM,aAAa,IAAI,YAAY,CAAC,CAAC;AAErC,SAAS,SAAS,OAAkD;CAClE,OAAO,SAAS,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC3E;AAEA,SAAS,sBACP,OACA,cACQ;CACR,IAAI;CACJ,IAAI;EACF,WAAW,KAAK,MAAM,KAAK;CAC7B,QAAQ;EACN,OAAO;CACT;CACA,IAAI,CAAC,MAAM,QAAQ,QAAQ,KAAK,SAAS,WAAW,GAClD,OAAO;CAET,OAAO,KAAK,UAAU;EACpB,GAAG;EACH,OAAO,aAAa,YAAY,WAAW,aAAa,UAAU;EAClE,OAAO,aAAa,cAAc,WAAW,aAAa,YAAY;CACxE,CAAC;AACH;AAEA,SAAS,sBACP,OACA,cACkC;CAClC,IAAI,SAAS,MAAM,OAAO,KAAA;CAC1B,OAAO;EACL,GAAG;EACH,eACE,MAAM,iBAAiB,OACnB,KAAA,IACA,sBAAsB,MAAM,eAAe,YAAY;EAC7D,SAAS,MAAM,QAAQ,KAAK,YAAY;GACtC,GAAG;GACH,OAAO,sBAAsB,OAAO,OAAO,YAAY;EACzD,EAAE;CACJ;AACF;AAGA,SAAgB,wBACd,cACA,aACA,SACM;CACN,OAAO,aAAa;CACpB,OAAO,aAAa;CACpB,MAAM,QAAQ,sBACZ,wBAAwB,OAAO,GAC/B,YACF;CACA,MAAM,gBAAgB,8BAA8B,OAAO;CAC3D,MAAM,SAAS,iCACb,aACA,eACA,OAAO,aACT;CACA,IAAI,wBAAwB,aAAa,MACtC,UAAU,QAAS,SAAS,QAAQ,MAAM,iBAAiB,OAC5D,MAAM,IAAI,MAAM,kCAAkC;CAEpD,IAAI,SAAS,MACX,aAAa,yBAAyB;EAAE,GAAG;EAAO;CAAY;CAEhE,IAAI,UAAU,MACZ,aAAa,mCAAmC;AAEpD;AAQA,SAAgB,0BACd,QACA,aACA,eACwB;CACxB,MAAM,YAAqB,OAAO,cAAc;CAChD,MAAM,aAAsB,OAAO,cAAc;CACjD,IAAI,CAAC,SAAS,UAAU,KAAK,CAAC,MAAM,QAAQ,WAAW,MAAM,GAC3D,OAAO;CAOT,IAAI,WAAW,eAAe,KAAA,GAC5B,OAAO;CAET,MAAM,YAAY,WAAW,OAAO,SAAS;CAC7C,IAAI,CAAC,SAAS,SAAS,GACrB,OAAO,YAAY,iBAAiB;CAEtC,IAAI,eAAe,MAAM;EAEvB,IAAI,CAAC,WAAW,OAAO;EACvB,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,WAAW,IAAI,WAAW;CAC1D;CACA,IAAI,CAAC,OAAO,UAAU,eAAe,KAAK,WAAW,WAAW,GAC9D,OAAO,YAAY,iBAAiB;CAEtC,IAAI,eACF,OAAO;CAET,OAAO,YAAY,WAAW;AAChC;AAEA,SAAgB,wBACd,QACA,SACQ;CACR,OAAO,KAAK,UAAU;EACpB,wBAAwB,MAAM;EAC9B,OAAO,eAAA,gDAA4D,OAC9D,OAAO,cAAc,iBAAiB,KACvC;EACJ;EACA,OAAO,OAAO,cAAc,YAAY,WACpC,OAAO,aAAa,UACpB;EACJ,OAAO,OAAO,cAAc,cAAc,WACtC,OAAO,aAAa,YACpB;CACN,CAAC;AACH;AAGA,SAAgB,6BACd,cACA,OACA,OACM;CACN,OAAO,aAAa;CACpB,MAAM,QAAQ,wBAAwB,YAAY;CAClD,MAAM,UAAU,SAAS,OACrB,CAAC,IACA,OAAO,QAAQ,QACf,WAAW,OAAO,UAAU,SAAS,OAAO,UAAU,KACzD,KAAK,CAAC;CACR,IAAI,SAAS,QAAQ,QAAQ,WAAW,GAAG;EACzC,OAAO,aAAa;EACpB;CACF;CACA,aAAa,yBAAyB;EACpC,SAAS;EACT;EACA,gBAAgB,MAAM;CACxB;AACF;AAEA,SAAgB,wBACd,QACoB;CACpB,MAAM,QACJ,OAAO,eAAA,gDACP,OAAO,cAAc;CACvB,OAAO,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ,KAAA;AACjE;AAGA,SAAgB,uBACd,QACA,OACA,sBACS;CACT,MAAM,WAAW,mCAAmC,OAAO,YAAY;CACvE,IAAI,YAAY,QAAQ,qBAAqB,SAAS,GAAG,OAAO;CAChE,MAAM,WAAoB,KAAK,MAAM,KAAK;CAC1C,IAAI,CAAC,MAAM,QAAQ,QAAQ,KACxB,SAAS,WAAW,KAAK,SAAS,WAAW,KAC9C,SAAS,OAAO,IAAI,OAAO;CAC7B,MAAM,UAAU,SAAS,WAAW,QAAQ,cAAc,qBAAqB,IAAI,UAAU,gBAAgB,CAAC;CAC9G,OAAO,QAAQ,SAAS,GAAG;EACzB,MAAM,YAAY,QAAQ,IAAI;EAC9B,IAAI,UAAU,2BAA2B,SAAS,IAAI,OAAO;EAC7D,QAAQ,KAAK,GAAI,UAAU,YAAY,cAAc,CAAC,CAAE;CAC1D;CACA,OAAO;AACT;AAGA,SAAgB,2BACd,cACA,aACA,kBACA,qBACM;CACN,MAAM,UAAU,QAAwB;EACtC,MAAM,QAAiB,KAAK,MAAM,GAAG;EACrC,IAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,MAAM,OAAO,aACxC,OAAO;EAET,MAAM,UAAU,CAAC,kBAAkB,GAAG,MAAM,MAAM,CAAC,CAAC;EACpD,IAAI,QAAQ,WAAW,KAAK,uBAAuB,MACjD,QAAQ,KAAK;EAEf,OAAO,KAAK,UAAU,OAAO;CAC/B;CAEA,MAAM,SAAS,8BAA8B,EAD5B,aACiC,CAAC;CACnD,IAAI,QAAQ,SAAS,MACnB,aAAa,mCAAmC;EAC9C,GAAG;EACH,OAAO,OAAO,OAAO,KAAK;CAC5B;CAEF,MAAM,QAAQ,wBAAwB,YAAY;CAClD,IAAI,SAAS,MACX,aAAa,yBAAyB;EACpC,GAAG;EACH,eACE,MAAM,iBAAiB,OAAO,KAAA,IAAY,OAAO,MAAM,aAAa;EACtE,SAAS,MAAM,QAAQ,KAAK,YAAY;GACtC,GAAG;GACH,OAAO,OAAO,OAAO,KAAK;GAC1B,OAAO,OAAO,OAAO,KAAK;EAC5B,EAAE;CACJ;AAEJ;AAGA,SAAgB,6BACd,SACA,aACA,kBACA,qBACS;CACT,MAAM,QAAQ,wBAAwB,OAAO;CAC7C,MAAM,QAAQ,wBAAwB,OAAO;CAC7C,IAAI,SAAS,QAAQ,CAAC,SAAS,KAAK,GAClC,OAAO;CAET,MAAM,eAAe,GAAG,wBAAwB,MAAM;CACtD,2BACE,cACA,aACA,kBACA,mBACF;CACA,MAAM,UAAU;EACd,GAAG;GACF,wBAAwB,aAAa;CACxC;CACA,MAAM,eAAe,sBAAsB,OAAO;CAClD,OAAO,gBAAgB,OACnB,UACA,yBAAyB,SAAS,YAAY;AACpD;AAEA,SAAgB,wBACd,SACkC;CAClC,MAAM,QAAQ,wBAAwB,OAAO;CAC7C,IACE,SAAS,QACT,OAAO,UAAU,YACjB,EAAA,mCAA2B,QAE3B;CAEF,MAAM,YAAqB,MAAM;CACjC,IAAI,cAAc,KAAA,GAChB;CAEF,MAAM,QAAQ;CACd,IACE,OAAO,YAAY,KAClB,MAAM,kBAAkB,QACvB,OAAO,MAAM,mBAAmB,aACjC,MAAM,iBAAiB,QAAQ,OAAO,MAAM,kBAAkB,YAC9D,MAAM,eAAe,QAAQ,OAAO,MAAM,gBAAgB,YAC3D,CAAC,MAAM,QAAQ,MAAM,OAAO,KAC5B,MAAM,QAAQ,MAAM,UAAmB;EACrC,IAAI,SAAS,QAAQ,OAAO,UAAU,UACpC,OAAO;EAET,MAAM,SAAS;EACf,OACE,OAAO,OAAO,UAAU,YACxB,OAAO,OAAO,UAAU,YACxB,OAAO,OAAO,aAAa,YAC3B,OAAO,OAAO,SAAS,YACtB,OAAO,aAAa,QACnB,CAAC,sBAAsB,OAAO,SAAS,KACxC,OAAO,kBAAkB,QACxB,CAAC,2BAA2B,OAAO,cAAc;CAEvD,CAAC,GAED,MAAM,IAAI,MAAM,sCAAsC;CAExD,OAAO,gBAAgB,KAA6B;AACtD;AAEA,SAAgB,0BAA0B,SAA2B;CACnE,IACE,WAAW,QACX,OAAO,YAAY,YACnB,EAAA,mCAA2B,UAE3B,OAAO;CAET,MAAM,QAAQ,wBAAwB,OAAO;CAC7C,MAAM,GAAG,wBAAwB,QAAQ,GAAG,kBAAkB;CAC9D,IACE,OAAO,mBAAmB,QAC1B,0BAA0B,eAE1B,OAAO,cAAc;CAEvB,OAAO;AACT;AAGA,SAAgB,8BAA8B,SAA2B;CACvE,OAAO,4BACL,0BAA0B,wBAAwB,OAAO,CAAC,CAC5D;AACF;AAEA,eAAsB,2BACpB,SACA,OACA,SACA,WACA,gBACkB;CAClB,MAAM,gBAAgB,wBAAwB,OAAO;CACrD,MAAM,WAAW,wBAAwB,aAAa;CACtD,MAAM,UACJ,UAAU,QAAQ,QAAQ,WAAW,OAAO,UAAU,KAAK,KAAK,CAAC;CACnE,KAAK,MAAM,CAAC,OAAO,YAAY,SAAS;EACtC,MAAM,CAAC,UAAU,SAAS,MAAM,WAAW,WAAW,CAAC,GAAG,OAAO,CAAC;EAClE,QAAQ,KAAK;GACX;GACA;GACA;GACA,MAAM,OAAO,KAAK,KAAK,CAAC,CAAC,SAAS,QAAQ;GAC1C,GAAI,aAAa,OAAO,CAAC,IAAI,EAAE,UAAU;GACzC,GAAI,kBAAkB,OAAO,CAAC,IAAI,EAAE,eAAe;EACrD,CAAC;CACH;CACA,MAAM,gBACJ,UAAU,kBACT,wBAAwB,aAAa,IAAI,QAAQ,KAAA;CACpD,IAAI,QAAQ,WAAW,KAAK,iBAAiB,MAC3C,OAAO;CAET,MAAM,SAAS;EACb,GAAI,SAAS,aAAa,IACtB,gBACA;IACC,yBAAyB;IACzB,yBAAyB;EAC5B;GACD,wBAAwB;GACvB,SAAS;GACT;GACA;GACA,gBAAgB,UAAU,kBAAkB,CAAC,SAAS,aAAa;EACrE;CACF;CACA,MAAM,eAAe,sBAAsB,OAAO;CAClD,OAAO,gBAAgB,OACnB,SACA,yBAAyB,QAAQ,YAAY;AACnD;AAEA,eAAsB,4BACpB,QACA,OAQA;CACA,MAAM,QAAQ,wBAAwB,OAAO,YAAY;CACzD,IAAI,SAAS,MACX,OAAO,CAAC;CAEV,OAAO,QAAQ,IACb,MAAM,QACH,QAAQ,WAAW,OAAO,UAAU,KAAK,CAAC,CAC1C,IAAI,OAAO,WAAW;EACrB,MAAM,SAAkB,MAAM,WAAW,WACvC,OAAO,UACP,OAAO,KAAK,OAAO,MAAM,QAAQ,CACnC;EACA,IAAI,CAAC,MAAM,QAAQ,MAAM,GACvB,MAAM,IAAI,MAAM,oCAAoC;EAEtD,MAAM,uBAAO,IAAI,IAAY;EAC7B,MAAM,UAAU,OAAO,KACpB,UAAqD;GACpD,IACE,CAAC,MAAM,QAAQ,KAAK,KACpB,MAAM,WAAW,KACjB,OAAO,MAAM,OAAO,YACpB,KAAK,IAAI,MAAM,EAAE,GAEjB,MAAM,IAAI,MAAM,oCAAoC;GAEtD,MAAM,SAAS,MAAM;GACrB,IACE,UAAU,QACT,CAAC,cAAc,OAAO,MAAM,KAAK,CAAC,UAAU,OAAO,MAAM,KAC1D,CAAC,MAAM,QAAQ,OAAO,kBAAkB,KACxC,OAAO,mBAAmB,MACvB,YAAY,OAAO,YAAY,QAClC,KACC,OAAO,qBAAqB,QAC3B,OAAO,OAAO,sBAAsB,aACrC,OAAO,oBAAoB,QAC1B,OAAO,OAAO,qBAAqB,YACpC,OAAO,QAAQ,SACb,CAAC,OAAO,cAAc,OAAO,IAAI,KAAK,OAAO,OAAO,MACvD,CAAC,SAAS,OAAO,QAAQ,KACzB,OAAO,OAAO,SAAS,SAAS,YAChC,OAAO,SAAS,KAAK,WAAW,KAChC,CAAC,SAAS,OAAO,SAAS,IAAI,KAC7B,OAAO,gBAAgB,QAAQ,CAAC,SAAS,OAAO,YAAY,GAE7D,MAAM,IAAI,MAAM,oCAAoC;GAEtD,KAAK,IAAI,MAAM,EAAE;GACjB,MAAM,SAAS,UAAU,OAAO,MAAM,IAClC,IAAI,QAAQ;IACZ,QAAQ,OAAO,OAAO;IACtB,MAAM,OAAO,OAAO;IACpB,OAAO,OAAO,OAAO;IACrB,QAAQ,OAAO,OAAO;GACxB,CAAC,IACC,OAAO;GACX,OAAO,CACL,MAAM,IACN;IACE,GAAG;IACH,UAAU,OAAO;IACjB;IACA,oBAAoB,OAAO;GAC7B,CACF;EACF,CACF;EACA,OAAO;GACL,OAAO,OAAO;GACd;GACA,WAAW,OAAO;GAClB,gBAAgB,OAAO;EACzB;CACF,CAAC,CACL;AACF"}

package/dist/esm/utils/index.mjs

@@ -1,5 +1,5 @@
-import "./truncation.mjs";
 import "./misc.mjs";
+import "./truncation.mjs";
 import "./tokens.mjs";
 import "./llm.mjs";
 import "./graph.mjs";

package/dist/types/common/constants.d.ts

@@ -1,3 +1,5 @@
+/** Host context preparation and trusted subagent execution identity are supported. */
+export declare const SUBAGENT_CONTEXT_VERSION = 1;
 /**
  * Anthropic direct API tool schema overhead multiplier.
  * Empirically calibrated against real MCP tool sets (29 tools).

package/dist/types/graphs/Graph.d.ts

@@ -299,7 +299,8 @@ export declare class StandardGraph extends Graph<t.BaseGraphState, t.GraphNode>
     /** See {@link t.StandardGraphInput.subagentTasks}. */
     subagentTasks: t.SubagentTaskConfig | undefined;
     /** See {@link t.StandardGraphInput.subagentExecutionContext}. */
-    private readonly subagentExecutionContext?;
+    readonly subagentExecutionContext?: t.SubagentExecutionContext;
+    private readonly subagentContext?;
     /** See {@link t.StandardGraphInput.preemption}. */
     preemption?: t.StreamPreemption;
     /**
@@ -436,7 +437,7 @@ export declare class StandardGraph extends Graph<t.BaseGraphState, t.GraphNode>
      * from a discard.
      */
     private preemptRestartPending;
-    constructor({ runId, signal, agents, langfuse, tokenCounter, indexTokenCountMap, calibrationRatio, fadingTier, fadingTiers, subagentUsageSink, subagentTasks, subagentScope, subagentExecutionContext, preemption, streamLimits, toolExecution, }: t.StandardGraphInput, dependencies?: GraphFactoryDependencies);
+    constructor({ runId, signal, agents, langfuse, tokenCounter, indexTokenCountMap, calibrationRatio, fadingTier, fadingTiers, subagentUsageSink, subagentTasks, subagentScope, subagentExecutionContext, subagentContext, preemption, streamLimits, toolExecution, }: t.StandardGraphInput, dependencies?: GraphFactoryDependencies);
     /**
      * A compaction applies its remove-all inside the agent subgraph, so the
      * subgraph's result carries only the retained tail, and an outer reducer

package/dist/types/hooks/types.d.ts

@@ -1,4 +1,5 @@
 import type { BaseMessage } from '@langchain/core/messages';
+import type { SubagentExecutionContext } from '@/types/graph';
 import type { InjectedMessage } from '@/types/tools';
 /**
  * Closed set of hook lifecycle events supported by the hooks system.
@@ -33,6 +34,8 @@ export type StopDecision = 'continue' | 'block';
  *   hook to a specific agent regardless of subagent scope.
  */
 export interface BaseHookInput {
+    /** SDK-owned child lineage, including distinct identities for concurrent self-spawns. */
+    executionContext?: SubagentExecutionContext;
     runId: string;
     threadId?: string;
     agentId?: string;

package/dist/types/run.d.ts

@@ -22,6 +22,7 @@ export declare class Run<_T extends t.BaseGraphState> {
     private maxStopContinuations;
     private streamLimits?;
     private subagentTasks?;
+    private subagentContext?;
     private indexTokenCountMap?;
     calibrationRatio: number;
     fadingTier?: t.FadingTier;

package/dist/types/summarization/node.d.ts

@@ -14,6 +14,7 @@ interface CreateSummarizeNodeParams {
         config?: RunnableConfig;
         runId?: string;
         isMultiAgent: boolean;
+        getSubagentExecutionContext?: () => t.SubagentExecutionContext | undefined;
         hookRegistry?: HookRegistry;
         getToolsForBinding?: (provider: t.ProviderName, clientOptions: t.ClientOptions | undefined) => t.GraphTools | undefined;
         dispatchRunStep: (runStep: t.RunStep, config?: RunnableConfig) => Promise<void>;

package/dist/types/tools/ToolNode.d.ts

@@ -161,6 +161,7 @@ export declare class ToolNode<T = any> extends RunnableCallable<T, T> {
      * even where `agentId` (the subagent-scope marker) is undefined.
      */
     private executingAgentId?;
+    private readonly executionContext?;
     private executingAgentName?;
     private rootAgentId?;
     private rootAgentName?;
@@ -225,7 +226,7 @@ export declare class ToolNode<T = any> extends RunnableCallable<T, T> {
      * other's in-flight state.
      */
     private anonBatchCounter;
-    constructor({ tools, toolMap, name, tags, trace, runLangfuse, agentLangfuse, errorHandler, toolCallStepIds, handleToolErrors, loadRuntimeTools, toolRegistry, toolDefinitions, getDiscoveredToolNames, sessions, codeSessionKey, eventDrivenMode, eagerEventToolExecution, eagerEventToolExecutions, eagerEventToolUsageCount, eagerEventToolSuppressions, agentId, executingAgentId, executingAgentName, rootAgentId, rootAgentName, directToolNames, interruptingToolNames, codeSessionToolNames, maxContextTokens, maxToolResultChars, hookRegistry, humanInTheLoop, toolOutputReferences, toolOutputRegistry, toolExecution, fileCheckpointer, getBreakerSignal, getRunScope, preparedSubagents, restoreRunStepResumeState, createRunStepResumeState, }: t.ToolNodeConstructorParams);
+    constructor({ tools, toolMap, name, tags, trace, runLangfuse, agentLangfuse, errorHandler, toolCallStepIds, handleToolErrors, loadRuntimeTools, toolRegistry, toolDefinitions, getDiscoveredToolNames, sessions, codeSessionKey, eventDrivenMode, eagerEventToolExecution, eagerEventToolExecutions, eagerEventToolUsageCount, eagerEventToolSuppressions, agentId, executingAgentId, executionContext, executingAgentName, rootAgentId, rootAgentName, directToolNames, interruptingToolNames, codeSessionToolNames, maxContextTokens, maxToolResultChars, hookRegistry, humanInTheLoop, toolOutputReferences, toolOutputRegistry, toolExecution, fileCheckpointer, getBreakerSignal, getRunScope, preparedSubagents, restoreRunStepResumeState, createRunStepResumeState, }: t.ToolNodeConstructorParams);
     invoke(input: any, options?: Partial<RunnableConfig>): Promise<any>;
     private withToolScope;
     /**
@@ -411,6 +412,7 @@ export declare class ToolNode<T = any> extends RunnableCallable<T, T> {
      *  paths derive the runtime session hint identically. */
     private resolveRuntimeSessionHint;
     private storeCodeSessionFromResults;
+    private retainCodeSessionInputsFromRequests;
     /**
      * Post-processes standard runTool outputs: dispatches ON_RUN_STEP_COMPLETED
      * and stores code session context. Mirrors the completion handling in
@@ -531,7 +533,7 @@ export declare class ToolNode<T = any> extends RunnableCallable<T, T> {
      * invocations cannot race on shared mutable state.
      */
     private executeViaEvent;
-    protected run(input: any, config: RunnableConfig, referenceReplay?: {
+    protected run(input: T, config: RunnableConfig, referenceReplay?: {
         state?: ToolOutputReferenceState;
     }): Promise<T>;
     private isSendInput;

package/dist/types/tools/subagent/SubagentExecutor.d.ts

@@ -1,7 +1,7 @@
 import { BaseMessage } from '@langchain/core/messages';
 import type { RunnableConfig } from '@langchain/core/runnables';
 import type { ToolCall } from '@langchain/core/messages/tool';
-import type { MultiAgentGraphState, HumanInTheLoopConfig, StandardGraphInput, ExecutableSubagentConfigEntry, SubagentExecutionContext, SubagentTaskConfig, SubagentTaskRuntime, SubagentUsageSink, TokenCounter } from '@/types';
+import type { MultiAgentGraphState, HumanInTheLoopConfig, StandardGraphInput, ExecutableSubagentConfigEntry, SubagentExecutionContext, SubagentContextAdapter, SubagentContextResult, SubagentTaskConfig, SubagentTaskRuntime, SubagentUsageSink, TokenCounter } from '@/types';
 import type { SubagentResumeManifest, SettledSubagentToolOutput } from './SubagentReplay';
 import type { GraphFactory } from '@/graphs/graphFactory';
 import type { StandardGraph } from '@/graphs/Graph';
@@ -71,11 +71,11 @@ export type SubagentExecuteParams = {
     /** Host-restored child transcript for a fresh continuation run. @internal */
     initialMessages?: BaseMessage[];
 };
-export type SubagentExecuteResult = {
-    content: string;
-    messages: BaseMessage[];
+export type SubagentExecuteResult = SubagentContextResult & {
     /** Tagged internal failure; foreground callers retain the legacy content. */
     error?: string;
+    /** Completed child work whose host projection must be retried without re-execution. */
+    retryableDelivery?: true;
 };
 /**
  * Factory that constructs a child graph for subagent execution. Injected
@@ -160,6 +160,7 @@ export type SubagentExecutorOptions = {
     usageSink?: SubagentUsageSink;
     /** Host-owned process-local task namespace for detached execution. */
     taskConfig?: SubagentTaskConfig;
+    subagentContext?: SubagentContextAdapter;
 };
 export declare class SubagentExecutor {
     private readonly configs;
@@ -187,6 +188,7 @@ export declare class SubagentExecutor {
     private readonly createDetachedChildGraphFactory?;
     private readonly usageSink?;
     private readonly taskConfig?;
+    private readonly subagentContext?;
     private readonly executions;
     private replayCheckpointWorkflow?;
     private readonly resolveParentHandlerRegistry?;
@@ -266,6 +268,7 @@ export declare class SubagentExecutor {
     private persistChildCheckpointMarker;
     execute(params: SubagentExecuteParams): Promise<SubagentExecuteResult>;
     private executeOnce;
+    private completeHostContext;
     /**
      * Emits a single {@link GraphEvents.ON_SUBAGENT_UPDATE} envelope through the
      * parent's handler registry. Silent no-op when no parent registry is set.

package/dist/types/tools/toolBatchReplay.d.ts

@@ -24,6 +24,7 @@ export interface ToolBatchReplayRecord {
     turnState?: SubagentToolNodeResumeState;
     referenceState?: ToolOutputReferenceState;
 }
+export type ToolReplayResumeStatus = 'active' | 'stale' | 'unverifiable';
 interface ToolBatchReplayState {
     version: 1;
     approvalOwner?: string;
@@ -40,15 +41,17 @@ export declare function restoreToolReplayConfig(configurable: Record<string, unk
  * steps, so the presence of replay evidence alone does not imply a resume.
  * A parent replaying a checkpointed child has no local resume value.
  */
-export declare function isToolReplayResume(config: RunnableConfig, interruptId: string | undefined, isChildReplay: boolean): boolean;
+export declare function getToolReplayResumeStatus(config: RunnableConfig, interruptId: string | undefined, isChildReplay: boolean): ToolReplayResumeStatus;
 export declare function getToolBatchReplayOwner(config: RunnableConfig, agentId: string): string;
+/** Remove stale authorization while retaining only settled results for this batch. */
+export declare function clearStaleToolApprovalConfig(configurable: Record<string, unknown>, owner: string, batch: string | undefined): void;
 export declare function getToolBatchReplayScope(config: RunnableConfig): string | undefined;
 /** Foreign replay evidence may only transit a checkpoint-proven child path. */
 export declare function isChildToolReplayOwner(config: RunnableConfig, owner: string, trustedParentCallIds: ReadonlySet<string>): boolean;
 /** Rebind only the checkpoint-proven source execution when a child fork is created. */
-export declare function rebindToolBatchReplayScope(configurable: Record<string, unknown>, sourceScope: string, destinationScope: string): void;
+export declare function rebindToolBatchReplayScope(configurable: Record<string, unknown>, sourceScope: string, destinationScope: string, destinationThreadId?: string): void;
 /** A fork may be paused again before it consumes its pending interrupt. */
-export declare function rebindToolBatchReplayPayload(payload: unknown, sourceScope: string, destinationScope: string): unknown;
+export declare function rebindToolBatchReplayPayload(payload: unknown, sourceScope: string, destinationScope: string, destinationThreadId?: string): unknown;
 export declare function getToolBatchReplayState(payload: unknown): ToolBatchReplayState | undefined;
 export declare function stripToolBatchReplayState(payload: unknown): unknown;
 /** Decode outer execution metadata before shape-sensitive child wrappers. */

package/dist/types/types/graph.d.ts

@@ -278,6 +278,8 @@ export type StandardGraphInput = {
      * do not inherit it, keeping background nesting disabled for the MVP.
      */
     subagentTasks?: SubagentTaskConfig;
+    /** Host-owned context and result projection for each isolated child execution. */
+    subagentContext?: SubagentContextAdapter;
     /**
      * True when this graph IS a subagent child run (set by `SubagentExecutor`
      * when it constructs the child graph). Drives the hook-input `agentId`
@@ -499,6 +501,32 @@ export interface SubagentExecutionContext {
     readonly depth: number;
     readonly ancestry: readonly SubagentAncestryEntry[];
 }
+/** Trusted identity supplied before a child can access host-owned resources. */
+export interface SubagentContextInput {
+    executionContext: SubagentExecutionContext;
+    parentThreadId?: string;
+    memberAgentIds: readonly string[];
+    signal: AbortSignal;
+    resumed: boolean;
+}
+export interface PreparedSubagentContext {
+    /** Added to the initial child input; checkpoint recovery does not add them again. */
+    messages?: BaseMessage[];
+    /** Host configuration; SDK execution and checkpoint identities remain authoritative. */
+    configurable?: RunnableConfig['configurable'];
+    /** Each entry replaces that member's inherited code partition and initial sessions. */
+    agentSessions?: Readonly<Record<string, Pick<AgentInputs, 'codeSessionKey' | 'initialSessions'>>>;
+}
+export interface SubagentContextResult {
+    content: string;
+    messages: BaseMessage[];
+}
+export interface SubagentContextAdapter {
+    /** Reauthorizes reconstructed executions; durable work must be idempotent by child run ID. */
+    prepare(input: SubagentContextInput): Promise<PreparedSubagentContext>;
+    /** Projects durable references into the result returned to the parent. */
+    complete?(input: SubagentContextInput, result: SubagentContextResult): Promise<Pick<SubagentContextResult, 'content'>>;
+}
 /**
  * Wrapper event emitted when a subagent's child graph dispatches activity.
  * Lets hosts show subagent progress in a UI surface separate from the parent

package/dist/types/types/run.d.ts

@@ -272,6 +272,8 @@ export type RunConfig = {
      * Omit to preserve foreground-only subagent behavior.
      */
     subagentTasks?: SubagentTaskConfig;
+    /** Authorizes and supplies host-owned context to isolated child runs. */
+    subagentContext?: g.SubagentContextAdapter;
     /**
      * Pre-constructed hook registry for this run. Hooks fire at lifecycle
      * points in `processStream` (RunStart, UserPromptSubmit, Stop,

package/dist/types/types/tools.d.ts

@@ -3,10 +3,10 @@ import type { StructuredToolInterface } from '@langchain/core/tools';
 import type { ToolCall } from '@langchain/core/messages/tool';
 import type { MessageContentComplex, RunStepResumeState, ToolErrorData } from './stream';
 import type { ToolOutputReferenceRegistry } from '@/tools/toolOutputReferences';
+import type { LangfuseConfig, SubagentExecutionContext } from './graph';
 import type { PreparedSubagents } from '@/tools/preparedSubagents';
 import type { RunBreakerScope } from '@/llm/streamLimits';
 import type { HumanInTheLoopConfig } from './hitl';
-import type { LangfuseConfig } from './graph';
 import type { HookRegistry } from '@/hooks';
 /** Replacement type for `import type { ToolCall } from '@langchain/core/messages/tool'` in order to have stringified args typed */
 export type CustomToolCall = {
@@ -63,6 +63,7 @@ export type EagerEventToolExecution = {
     toolName: string;
     args: Record<string, unknown>;
     request: ToolCallRequest;
+    codeSessionBaselineByName?: ReadonlyMap<string, string>;
     promise: Promise<EagerEventToolExecutionOutcome>;
     /**
      * True when the streaming eager path already emitted the user-visible
@@ -139,6 +140,8 @@ export type ToolNodeOptions = {
     /** ID of the agent that owns this tool node, surfaced to hooks as `executingAgentId`
      * so a batch can be attributed to a specific agent even where `agentId` is undefined. */
     executingAgentId?: string;
+    /** SDK-owned identity of the child execution, independent of reusable agent IDs. */
+    executionContext?: SubagentExecutionContext;
     /** Name of the agent that owns this tool node, used for active Langfuse attribution. */
     executingAgentName?: string;
     /** Root graph-agent identity retained alongside the currently executing tool owner. */
@@ -529,6 +532,10 @@ export type ToolCallRequest = {
         session_id: string;
         files?: CodeEnvFile[];
     };
+    /** Request-time execution session used to detect host session refreshes. */
+    codeSessionBaselineId?: string;
+    /** Preserve request-provisioned code inputs after an eager identity mismatch. */
+    retainCodeSessionInputs?: true;
     /**
      * Stable runtime session hint for stateful sandbox sessions. Orthogonal to
      * `codeSessionContext` (which threads the transient exec-session for file
@@ -550,6 +557,8 @@ export type CallerCapabilityProjectionSnapshot = {
 };
 /** Batch request containing ALL tool calls for a graph step */
 export type ToolExecuteBatchRequest = {
+    /** SDK-owned child lineage. Unset for tools in the root graph. */
+    executionContext?: SubagentExecutionContext;
     /** All tool calls from the AIMessage */
     toolCalls: ToolCallRequest[];
     /** User ID for context */
@@ -1134,6 +1143,7 @@ export type ProgrammaticHookContext = {
     runId: string;
     threadId?: string;
     agentId?: string;
+    executionContext?: SubagentExecutionContext;
     executingAgentId?: string;
 };
 /** Search mode: code_interpreter uses external sandbox, local uses safe substring matching */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@librechat/agents",
-  "version": "3.8.4",
+  "version": "3.8.6",
   "reova": {
     "enabled": true,
     "endpoint": "https://telemetry.reo.dev/data"

package/src/common/constants.ts

@@ -1,3 +1,6 @@
+/** Host context preparation and trusted subagent execution identity are supported. */
+export const SUBAGENT_CONTEXT_VERSION = 1;
+
 /**
  * Anthropic direct API tool schema overhead multiplier.
  * Empirically calibrated against real MCP tool sets (29 tools).