@librechat/agents 3.8.1 → 3.8.2

package/dist/esm/tools/toolBatchReplay.mjs

@@ -0,0 +1,176 @@
+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 { isBaseMessage } from "@langchain/core/messages";
+import { Command, MemorySaver, isCommand } from "@langchain/langgraph";
+//#region src/tools/toolBatchReplay.ts
+const TOOL_BATCH_REPLAY_KEY = "__librechat_tool_batch_replay";
+const TOOL_BATCH_PAYLOAD_KEY = "__librechat_tool_batch_payload";
+const TOOL_BATCH_WRAPPER_KEY = "__librechat_tool_batch_wrapper";
+const serializer = new MemorySaver().serde;
+function isRecord(value) {
+	return value != null && typeof value === "object" && !Array.isArray(value);
+}
+function restoreToolReplayConfig(configurable, interruptId, payload) {
+	delete configurable[TOOL_BATCH_REPLAY_KEY];
+	delete configurable[TOOL_APPROVAL_REVIEW_CONFIG_KEY];
+	const state = getToolBatchReplayState(payload);
+	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");
+	if (state != null) configurable[TOOL_BATCH_REPLAY_KEY] = state;
+	if (review != null) configurable[TOOL_APPROVAL_REVIEW_CONFIG_KEY] = review;
+}
+function getToolBatchReplayOwner(config, agentId) {
+	return JSON.stringify([
+		getToolBatchReplayScope(config),
+		config.configurable?.["__librechat_tool_approval_execution_scope"] == null ? config.configurable?.checkpoint_ns ?? "" : "",
+		agentId
+	]);
+}
+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;
+}
+function isChildToolApprovalOwner(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;
+	const pending = manifest.executions.filter((execution) => trustedParentCallIds.has(execution.parentToolCallId));
+	while (pending.length > 0) {
+		const execution = pending.pop();
+		if (execution.approvalExecutionScope === identity[0]) return true;
+		pending.push(...execution.descendant?.executions ?? []);
+	}
+	return false;
+}
+function rebindToolBatchReplayScope(configurable, sourceScope, destinationScope) {
+	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 review = getToolApprovalReviewEvidence({ configurable });
+	if (review?.owner != null) configurable[TOOL_APPROVAL_REVIEW_CONFIG_KEY] = {
+		...review,
+		owner: rebind(review.owner)
+	};
+	const state = getToolBatchReplayState(configurable);
+	if (state != null) configurable[TOOL_BATCH_REPLAY_KEY] = {
+		...state,
+		approvalOwner: state.approvalOwner == null ? void 0 : rebind(state.approvalOwner),
+		records: state.records.map((record) => ({
+			...record,
+			owner: rebind(record.owner),
+			batch: rebind(record.batch)
+		}))
+	};
+}
+function rebindToolBatchReplayPayload(payload, sourceScope, destinationScope) {
+	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);
+	const rebound = {
+		...value,
+		[TOOL_BATCH_REPLAY_KEY]: configurable[TOOL_BATCH_REPLAY_KEY]
+	};
+	const runStepState = getRunStepResumeState(payload);
+	return runStepState == null ? rebound : attachRunStepResumeState(rebound, runStepState);
+}
+function getToolBatchReplayState(payload) {
+	const value = stripRunStepResumeState(payload);
+	if (value == null || typeof value !== "object" || !("__librechat_tool_batch_replay" in value)) return;
+	const candidate = value[TOOL_BATCH_REPLAY_KEY];
+	if (candidate === void 0) return;
+	const state = candidate;
+	if (state?.version !== 1 || state.wrappedPayload != null && typeof state.wrappedPayload !== "boolean" || state.approvalOwner != null && typeof state.approvalOwner !== "string" || !Array.isArray(state.records) || state.records.some((value) => {
+		if (value == null || typeof value !== "object") return true;
+		const record = value;
+		return typeof record.owner !== "string" || typeof record.batch !== "string" || typeof record.encoding !== "string" || typeof record.data !== "string" || record.turnState != null && !isToolNodeResumeState(record.turnState) || record.referenceState != null && !isToolOutputReferenceState(record.referenceState);
+	})) throw new Error("Invalid tool batch replay checkpoint");
+	return structuredClone(state);
+}
+function stripToolBatchReplayState(payload) {
+	if (payload == null || typeof payload !== "object" || !("__librechat_tool_batch_replay" in payload)) return payload;
+	const state = getToolBatchReplayState(payload);
+	const { [TOOL_BATCH_REPLAY_KEY]: _state, ...publicPayload } = payload;
+	if (state?.wrappedPayload === true && TOOL_BATCH_PAYLOAD_KEY in publicPayload) return publicPayload[TOOL_BATCH_PAYLOAD_KEY];
+	return publicPayload;
+}
+function getPublicToolInterruptPayload(payload) {
+	return stripSubagentResumeManifest(stripToolBatchReplayState(stripRunStepResumeState(payload)));
+}
+async function attachToolBatchReplayState(payload, owner, batches, turnState, referenceState) {
+	const publicPayload = stripRunStepResumeState(payload);
+	const previous = getToolBatchReplayState(publicPayload);
+	const records = previous?.records.filter((record) => record.owner !== owner) ?? [];
+	for (const [batch, results] of batches) {
+		const [encoding, bytes] = await serializer.dumpsTyped([...results]);
+		records.push({
+			owner,
+			batch,
+			encoding,
+			data: Buffer.from(bytes).toString("base64"),
+			...turnState == null ? {} : { turnState },
+			...referenceState == null ? {} : { referenceState }
+		});
+	}
+	const approvalOwner = previous?.approvalOwner ?? (isToolApprovalInterrupt(publicPayload) ? owner : void 0);
+	if (records.length === 0 && approvalOwner == null) return payload;
+	const result = {
+		...isRecord(publicPayload) ? publicPayload : {
+			[TOOL_BATCH_WRAPPER_KEY]: 1,
+			[TOOL_BATCH_PAYLOAD_KEY]: publicPayload
+		},
+		[TOOL_BATCH_REPLAY_KEY]: {
+			version: 1,
+			approvalOwner,
+			records,
+			wrappedPayload: previous?.wrappedPayload ?? !isRecord(publicPayload)
+		}
+	};
+	const runStepState = getRunStepResumeState(payload);
+	return runStepState == null ? result : attachRunStepResumeState(result, runStepState);
+}
+async function restoreToolBatchReplayState(config, owner) {
+	const state = getToolBatchReplayState(config.configurable);
+	if (state == null) return [];
+	return Promise.all(state.records.filter((record) => record.owner === owner).map(async (record) => {
+		const values = await serializer.loadsTyped(record.encoding, Buffer.from(record.data, "base64"));
+		if (!Array.isArray(values)) throw new Error("Invalid settled tool batch results");
+		const seen = /* @__PURE__ */ new Set();
+		const results = values.map((entry) => {
+			if (!Array.isArray(entry) || entry.length !== 2 || typeof entry[0] !== "string" || seen.has(entry[0])) throw new Error("Invalid settled tool batch results");
+			const result = entry[1];
+			if (result == null || !isBaseMessage(result.output) && !isCommand(result.output) || !Array.isArray(result.additionalContexts) || result.additionalContexts.some((context) => typeof context !== "string") || result.completionHandled != null && typeof result.completionHandled !== "boolean" || result.referenceContent != null && typeof result.referenceContent !== "string" || result.turn != null && (!Number.isSafeInteger(result.turn) || result.turn < 0) || !isRecord(result.proposal) || typeof result.proposal.name !== "string" || result.proposal.name.length === 0 || !isRecord(result.proposal.args) || result.resolvedArgs != null && !isRecord(result.resolvedArgs)) throw new Error("Invalid settled tool batch results");
+			seen.add(entry[0]);
+			const output = isCommand(result.output) ? new Command({
+				update: result.output.update,
+				goto: result.output.goto,
+				graph: result.output.graph,
+				resume: result.output.resume
+			}) : result.output;
+			return [entry[0], {
+				...result,
+				proposal: result.proposal,
+				output,
+				additionalContexts: result.additionalContexts
+			}];
+		});
+		return {
+			batch: record.batch,
+			results,
+			turnState: record.turnState,
+			referenceState: record.referenceState
+		};
+	}));
+}
+//#endregion
+export { TOOL_BATCH_REPLAY_KEY, attachToolBatchReplayState, getPublicToolInterruptPayload, getToolBatchReplayOwner, getToolBatchReplayScope, getToolBatchReplayState, isChildToolApprovalOwner, rebindToolBatchReplayPayload, rebindToolBatchReplayScope, restoreToolBatchReplayState, restoreToolReplayConfig, stripToolBatchReplayState };
+
+//# sourceMappingURL=toolBatchReplay.mjs.map

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

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

package/dist/esm/tools/toolOutputReferences.mjs

@@ -129,6 +129,18 @@ var ToolOutputReferenceRegistry = class ToolOutputReferenceRegistry {
 			warnedNonStringTools: [...bucket?.warnedNonStringTools ?? []]
 		};
 	}
+	resumeBatch(runId, state) {
+		if (!this.runStates.has(runId)) this.restoreState(runId, state);
+		const bucket = this.getOrCreate(runId);
+		bucket.turnCounter = Math.max(bucket.turnCounter, state.turnCounter + 1);
+		const inputs = new ToolOutputReferenceRegistry({
+			maxOutputSize: this.maxOutputSize,
+			maxTotalSize: this.maxTotalSize,
+			maxActiveRuns: 1
+		});
+		inputs.restoreState(runId, state);
+		return inputs.snapshot(runId);
+	}
 	restoreState(runId, state) {
 		this.releaseRun(runId);
 		const bucket = this.getOrCreate(runId);

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

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

package/dist/esm/types/hitl.mjs

@@ -1,8 +1,11 @@
 //#region src/types/hitl.ts
+function isToolApprovalInterrupt(payload) {
+	return typeof payload === "object" && payload !== null && payload.type === "tool_approval";
+}
 function isAskUserQuestionInterrupt(payload) {
 	return typeof payload === "object" && payload !== null && payload.type === "ask_user_question";
 }
 //#endregion
-export { isAskUserQuestionInterrupt };
+export { isAskUserQuestionInterrupt, isToolApprovalInterrupt };
 
 //# sourceMappingURL=hitl.mjs.map

package/dist/esm/types/hitl.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"hitl.mjs","names":[],"sources":["../../../src/types/hitl.ts"],"mappings":";AAyQA,SAAgB,2BACd,SAC4C;CAC5C,OACE,OAAO,YAAY,YACnB,YAAY,QACX,QAA+B,SAAS;AAE7C"}
+{"version":3,"file":"hitl.mjs","names":[],"sources":["../../../src/types/hitl.ts"],"mappings":";AA0PA,SAAgB,wBACd,SACyC;CACzC,OACE,OAAO,YAAY,YACnB,YAAY,QACX,QAA+B,SAAS;AAE7C;AAOA,SAAgB,2BACd,SAC4C;CAC5C,OACE,OAAO,YAAY,YACnB,YAAY,QACX,QAA+B,SAAS;AAE7C"}

package/dist/types/hitl/approvalReview.d.ts

@@ -0,0 +1,32 @@
+import type { RunnableConfig } from '@langchain/core/runnables';
+import type { ToolApprovalInterruptPayload, ToolApprovalRequest, ToolApprovalReviewConfig } from '@/types/hitl';
+/**
+ * Private resume-only config entry populated from the checkpointed interrupt.
+ * Hosts must never need to construct or inspect this value.
+ */
+export declare const TOOL_APPROVAL_REVIEW_CONFIG_KEY = "__librechat_tool_approval_review";
+export interface ToolApprovalReviewEvidence {
+    interruptId: string;
+    payload: ToolApprovalInterruptPayload;
+    owner?: string;
+}
+export interface ReviewedToolApproval {
+    request: ToolApprovalRequest;
+    reviewConfig: ToolApprovalReviewConfig;
+}
+/** Detach approval payloads from host- or transport-owned object graphs. */
+export declare function cloneToolApprovalInterruptPayload<T>(payload: T): T;
+/** Build trusted review evidence from the interrupt restored by `Run`. */
+export declare function createToolApprovalReviewEvidence(interruptId: string | undefined, payload: unknown, owner?: string): ToolApprovalReviewEvidence | undefined;
+/** Read only well-shaped evidence from a ToolNode's runnable config. */
+export declare function getToolApprovalReviewEvidence(config: RunnableConfig, owner?: string): ToolApprovalReviewEvidence | undefined;
+export declare function getReviewedToolApproval(payload: ToolApprovalInterruptPayload | undefined, toolCallId: string | undefined): ReviewedToolApproval | undefined;
+/**
+ * Bind a resume decision to the exact proposal the reviewer saw. Description
+ * text is deliberately excluded: it explains policy but cannot change the
+ * side effect. Tool identity, normalized arguments and available decisions
+ * are execution-authoritative.
+ */
+export declare function toolApprovalProposalMatches(current: ReviewedToolApproval, reviewed: ReviewedToolApproval): boolean;
+/** Preserve batch order as part of the decision-to-request binding. */
+export declare function toolApprovalPayloadMatches(current: ToolApprovalInterruptPayload, reviewed: ToolApprovalInterruptPayload): boolean;

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

@@ -2,7 +2,7 @@ import { ToolCall } from '@langchain/core/messages/tool';
 import { END, Command, MessagesAnnotation } from '@langchain/langgraph';
 import type { RunnableConfig } from '@langchain/core/runnables';
 import type { BaseMessage } from '@langchain/core/messages';
-import type { ToolOutputResolveView, ResolvedArgsByCallId } from '@/tools/toolOutputReferences';
+import type { ToolOutputResolveView, ToolOutputReferenceState, ResolvedArgsByCallId } from '@/tools/toolOutputReferences';
 import type { SubagentToolNodeResumeState } from '@/tools/subagent/SubagentReplay';
 import type * as t from '@/types';
 import { ToolOutputReferenceRegistry } from '@/tools/toolOutputReferences';
@@ -53,6 +53,10 @@ type RunToolBatchContext<T = unknown> = {
     additionalContextsSink?: string[];
     /** Stable identity of the assistant tool-call batch across HITL replay. */
     replayBatchKey?: string;
+    /** Positions in the original proposal, before completed calls are filtered. */
+    replayCallPositions?: ReadonlyMap<ToolCall, number>;
+    /** Tool-call identities owned by this ToolNode invocation. */
+    approvalScopeCallIds?: ReadonlySet<string>;
     /**
      * Graph state the ToolNode was invoked with, threaded from `run()`
      * so `tool.invoke` can forward it as langgraph 1.4's `runtime.state`
@@ -116,10 +120,10 @@ export declare class ToolNode<T = any> extends RunnableCallable<T, T> {
      * the Run ends.
      */
     private directPathTurns;
-    /** Terminal results from interrupting siblings that must survive a
-     * LangGraph replay of the containing ToolNode. Includes the sidecar data
-     * the fresh batch needs for hook-context injection and completion events. */
-    private settledInterruptingResults;
+    /** Terminal direct results that must survive a LangGraph replay of the
+     * containing ToolNode. Includes the sidecar data the fresh batch needs for
+     * hook-context injection and completion-event deduplication. */
+    private settledDirectResultsByBatch;
     /** Tool registry for filtering (lazy computation of programmatic maps) */
     private toolRegistry?;
     /** Schema-only definitions used when event mode has no runtime registry. */
@@ -527,7 +531,9 @@ 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): Promise<T>;
+    protected run(input: any, config: RunnableConfig, referenceReplay?: {
+        state?: ToolOutputReferenceState;
+    }): Promise<T>;
     private isSendInput;
     private isMessagesState;
 }

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

@@ -67,6 +67,8 @@ export interface SubagentResumeManifest {
     version: 1;
     executions: SubagentResumeExecution[];
 }
+export declare function isToolNodeResumeState(value: unknown): value is SubagentToolNodeResumeState;
+export declare function isToolOutputReferenceState(value: unknown): value is ToolOutputReferenceState;
 export declare function getSubagentResumeManifest(payload: unknown): SubagentResumeManifest | undefined;
 export declare function requireValidSubagentResumeManifest(payload: unknown): SubagentResumeManifest | undefined;
 export declare function attachSubagentResumeManifest(payload: unknown, manifest: SubagentResumeManifest): object;

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

@@ -0,0 +1,54 @@
+import { Command } from '@langchain/langgraph';
+import type { BaseMessage } from '@langchain/core/messages';
+import type { RunnableConfig } from '@langchain/core/runnables';
+import type { SubagentToolNodeResumeState } from '@/tools/subagent/SubagentReplay';
+import type { ToolOutputReferenceState } from '@/tools/toolOutputReferences';
+export declare const TOOL_BATCH_REPLAY_KEY = "__librechat_tool_batch_replay";
+export interface SettledToolBatchResult {
+    proposal: {
+        name: string;
+        args: Record<string, unknown>;
+    };
+    output: BaseMessage | Command;
+    additionalContexts: string[];
+    resolvedArgs?: Record<string, unknown>;
+    completionHandled?: boolean;
+    referenceContent?: string;
+    turn?: number;
+}
+export interface ToolBatchReplayRecord {
+    owner: string;
+    batch: string;
+    encoding: string;
+    data: string;
+    turnState?: SubagentToolNodeResumeState;
+    referenceState?: ToolOutputReferenceState;
+}
+interface ToolBatchReplayState {
+    version: 1;
+    approvalOwner?: string;
+    records: ToolBatchReplayRecord[];
+    wrappedPayload?: boolean;
+}
+/** The only host-to-runtime entry point for checkpoint-owned tool replay state. */
+export declare function restoreToolReplayConfig(configurable: Record<string, unknown>, interruptId: string | undefined, payload: unknown): void;
+export declare function getToolBatchReplayOwner(config: RunnableConfig, agentId: string): string;
+export declare function getToolBatchReplayScope(config: RunnableConfig): string | undefined;
+/** Foreign approval evidence may only transit a checkpoint-proven child path. */
+export declare function isChildToolApprovalOwner(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;
+/** 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 getToolBatchReplayState(payload: unknown): ToolBatchReplayState | undefined;
+export declare function stripToolBatchReplayState(payload: unknown): unknown;
+/** Decode outer execution metadata before shape-sensitive child wrappers. */
+export declare function getPublicToolInterruptPayload(payload: unknown): unknown;
+export declare function attachToolBatchReplayState(payload: unknown, owner: string, batches: ReadonlyMap<string, ReadonlyMap<string, object>>, turnState?: SubagentToolNodeResumeState, referenceState?: ToolOutputReferenceState): Promise<unknown>;
+export declare function restoreToolBatchReplayState(config: RunnableConfig, owner: string): Promise<Array<{
+    batch: string;
+    results: Array<[string, SettledToolBatchResult]>;
+    turnState?: SubagentToolNodeResumeState;
+    referenceState?: ToolOutputReferenceState;
+}>>;
+export {};

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

@@ -199,6 +199,8 @@ export declare class ToolOutputReferenceRegistry {
     snapshot(runId: string | undefined): ToolOutputResolveView;
     /** Captures the checkpoint-safe state needed to resume one run bucket. */
     snapshotState(runId: string | undefined): ToolOutputReferenceState;
+    /** Restore batch inputs without rolling back graph-owned concurrent outputs. */
+    resumeBatch(runId: string, state: ToolOutputReferenceState): ToolOutputResolveView;
     /** Restores a checkpointed run bucket under the current resume scope. */
     restoreState(runId: string | undefined, state: ToolOutputReferenceState): void;
     private resolveAgainst;

package/package.json

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

package/src/hitl/approvalReview.ts

@@ -0,0 +1,209 @@
+import type { RunnableConfig } from '@langchain/core/runnables';
+import type {
+  ToolApprovalInterruptPayload,
+  ToolApprovalRequest,
+  ToolApprovalReviewConfig,
+} from '@/types/hitl';
+import { stableStringify } from '@/tools/eagerEventExecution';
+import { isToolApprovalInterrupt } from '@/types/hitl';
+
+/**
+ * Private resume-only config entry populated from the checkpointed interrupt.
+ * Hosts must never need to construct or inspect this value.
+ */
+export const TOOL_APPROVAL_REVIEW_CONFIG_KEY =
+  '__librechat_tool_approval_review';
+
+export interface ToolApprovalReviewEvidence {
+  interruptId: string;
+  payload: ToolApprovalInterruptPayload;
+  owner?: string;
+}
+
+export interface ReviewedToolApproval {
+  request: ToolApprovalRequest;
+  reviewConfig: ToolApprovalReviewConfig;
+}
+
+const APPROVAL_DECISIONS = new Set(['approve', 'reject', 'edit', 'respond']);
+
+/** Detach approval payloads from host- or transport-owned object graphs. */
+export function cloneToolApprovalInterruptPayload<T>(payload: T): T {
+  return isToolApprovalInterrupt(payload) ? structuredClone(payload) : payload;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value != null && typeof value === 'object' && !Array.isArray(value);
+}
+
+function hasValidApprovalShape(payload: ToolApprovalInterruptPayload): boolean {
+  if (
+    !Array.isArray(payload.action_requests) ||
+    !Array.isArray(payload.review_configs) ||
+    payload.action_requests.length !== payload.review_configs.length
+  ) {
+    return false;
+  }
+
+  const toolCallIds = new Set<string>();
+  return payload.action_requests.every((request, index) => {
+    const reviewConfig = payload.review_configs[index];
+    if (!isRecord(request) || !isRecord(reviewConfig)) {
+      return false;
+    }
+    const toolCallId = request.tool_call_id;
+    const toolName = request.name;
+    const allowedDecisions = reviewConfig.allowed_decisions;
+    if (
+      typeof toolCallId !== 'string' ||
+      toolCallId.length === 0 ||
+      toolCallIds.has(toolCallId) ||
+      typeof toolName !== 'string' ||
+      toolName.length === 0 ||
+      !isRecord(request.arguments) ||
+      (request.description != null &&
+        typeof request.description !== 'string') ||
+      reviewConfig.tool_call_id !== toolCallId ||
+      reviewConfig.action_name !== toolName ||
+      !Array.isArray(allowedDecisions) ||
+      !allowedDecisions.every(
+        (decision) =>
+          typeof decision === 'string' && APPROVAL_DECISIONS.has(decision)
+      )
+    ) {
+      return false;
+    }
+    toolCallIds.add(toolCallId);
+    return true;
+  });
+}
+
+/** Build trusted review evidence from the interrupt restored by `Run`. */
+export function createToolApprovalReviewEvidence(
+  interruptId: string | undefined,
+  payload: unknown,
+  owner?: string
+): ToolApprovalReviewEvidence | undefined {
+  if (
+    typeof interruptId !== 'string' ||
+    interruptId.length === 0 ||
+    !isToolApprovalInterrupt(payload) ||
+    !hasValidApprovalShape(payload)
+  ) {
+    return undefined;
+  }
+  return {
+    interruptId,
+    payload: cloneToolApprovalInterruptPayload(payload),
+    ...(owner == null ? {} : { owner }),
+  };
+}
+
+/** Read only well-shaped evidence from a ToolNode's runnable config. */
+export function getToolApprovalReviewEvidence(
+  config: RunnableConfig,
+  owner?: string
+): ToolApprovalReviewEvidence | undefined {
+  const candidate = config.configurable?.[TOOL_APPROVAL_REVIEW_CONFIG_KEY];
+  if (candidate == null || typeof candidate !== 'object') {
+    return undefined;
+  }
+  const {
+    interruptId,
+    payload,
+    owner: evidenceOwner,
+  } = candidate as {
+    interruptId?: unknown;
+    payload?: unknown;
+    owner?: unknown;
+  };
+  if (
+    evidenceOwner != null &&
+    (typeof evidenceOwner !== 'string' ||
+      (owner != null && owner !== evidenceOwner))
+  ) {
+    return undefined;
+  }
+  return createToolApprovalReviewEvidence(
+    typeof interruptId === 'string' ? interruptId : undefined,
+    payload,
+    typeof evidenceOwner === 'string' ? evidenceOwner : undefined
+  );
+}
+
+export function getReviewedToolApproval(
+  payload: ToolApprovalInterruptPayload | undefined,
+  toolCallId: string | undefined
+): ReviewedToolApproval | undefined {
+  if (payload == null || toolCallId == null || toolCallId === '') {
+    return undefined;
+  }
+  const request = payload.action_requests.find(
+    (candidate) => candidate.tool_call_id === toolCallId
+  );
+  const reviewConfig = payload.review_configs.find(
+    (candidate) => candidate.tool_call_id === toolCallId
+  );
+  if (request == null || reviewConfig == null) {
+    return undefined;
+  }
+  return { request, reviewConfig };
+}
+
+function decisionsEqual(
+  left: ReadonlyArray<string>,
+  right: ReadonlyArray<string>
+): boolean {
+  if (left.length !== right.length) {
+    return false;
+  }
+  const sortedLeft = [...left].sort();
+  const sortedRight = [...right].sort();
+  return sortedLeft.every((value, index) => value === sortedRight[index]);
+}
+
+/**
+ * Bind a resume decision to the exact proposal the reviewer saw. Description
+ * text is deliberately excluded: it explains policy but cannot change the
+ * side effect. Tool identity, normalized arguments and available decisions
+ * are execution-authoritative.
+ */
+export function toolApprovalProposalMatches(
+  current: ReviewedToolApproval,
+  reviewed: ReviewedToolApproval
+): boolean {
+  return (
+    current.request.tool_call_id === reviewed.request.tool_call_id &&
+    current.request.name === reviewed.request.name &&
+    current.reviewConfig.tool_call_id === reviewed.reviewConfig.tool_call_id &&
+    current.reviewConfig.action_name === reviewed.reviewConfig.action_name &&
+    stableStringify(current.request.arguments) ===
+      stableStringify(reviewed.request.arguments) &&
+    decisionsEqual(
+      current.reviewConfig.allowed_decisions,
+      reviewed.reviewConfig.allowed_decisions
+    )
+  );
+}
+
+/** Preserve batch order as part of the decision-to-request binding. */
+export function toolApprovalPayloadMatches(
+  current: ToolApprovalInterruptPayload,
+  reviewed: ToolApprovalInterruptPayload
+): boolean {
+  if (
+    current.action_requests.length !== reviewed.action_requests.length ||
+    current.review_configs.length !== reviewed.review_configs.length
+  ) {
+    return false;
+  }
+  return current.action_requests.every((request, index) => {
+    const currentReviewConfig = current.review_configs[index];
+    const reviewedRequest = reviewed.action_requests[index];
+    const reviewedReviewConfig = reviewed.review_configs[index];
+    return toolApprovalProposalMatches(
+      { request, reviewConfig: currentReviewConfig },
+      { request: reviewedRequest, reviewConfig: reviewedReviewConfig }
+    );
+  });
+}