@librechat/agents 3.6.10 → 3.6.12

package/dist/esm/tools/local/resolveLocalExecutionTools.mjs

@@ -3,7 +3,7 @@ import "../../common/index.mjs";
 import { createLocalBashProgrammaticToolCallingTool, createLocalProgrammaticToolCallingTool } from "./LocalProgrammaticToolCalling.mjs";
 import { createLocalBashExecutionTool, createLocalCodeExecutionTool } from "./LocalExecutionTools.mjs";
 import { createLocalCodingToolBundle, createLocalCodingToolDefinitions, createLocalCodingTools } from "./LocalCodingTools.mjs";
-import { createCloudflareCodingToolBundle, createCloudflareCodingTools, createCloudflareExecutionTool } from "../cloudflare/CloudflareSandboxTools.mjs";
+import { CLOUDFLARE_CODING_TOOL_NAMES, createCloudflareCodingToolBundle, createCloudflareCodingTools, createCloudflareExecutionTool } from "../cloudflare/CloudflareSandboxTools.mjs";
 import "../cloudflare/index.mjs";
 import { allowsToolCaller, isToolDefinitionActive } from "../CallerCapabilities.mjs";
 //#region src/tools/local/resolveLocalExecutionTools.ts
@@ -21,12 +21,18 @@ function isProgrammaticRunnerAutoBound(name, config) {
 	if (shouldUseCloudflareSandboxExecution(config)) return getSelectedCloudflareCodingToolNames(getCloudflareConfig(config)).has(name);
 	return shouldUseLocalExecution(config);
 }
+function isProgrammaticRunnerResolvedDirectly(name, config, hasExplicitBinding = false) {
+	if (isProgrammaticRunnerAutoBound(name, config)) return true;
+	if (!hasExplicitBinding || name !== "run_tools_with_code" && name !== "run_tools_with_bash") return false;
+	return (shouldUseLocalExecution(config) || shouldUseCloudflareSandboxExecution(config)) && !shouldIncludeCodingTools(config);
+}
 function getCloudflareConfig(config) {
 	if (config?.cloudflare == null) throw new Error("toolExecution.cloudflare is required when engine is \"cloudflare-sandbox\".");
 	return config.cloudflare;
 }
 function getSelectedCloudflareCodingToolNames(config) {
-	return new Set(config.codingToolNames ?? LOCAL_CODING_BUNDLE_NAMES);
+	const requestedNames = new Set(config.codingToolNames ?? CLOUDFLARE_CODING_TOOL_NAMES);
+	return new Set(CLOUDFLARE_CODING_TOOL_NAMES.filter((name) => requestedNames.has(name)));
 }
 function filterCloudflareCodingToolAllowlist(tools, selectedNames) {
 	const existingTools = tools ?? [];
@@ -124,11 +130,19 @@ function resolveLocalToolRegistry(args) {
 	}
 	return registry;
 }
+function resolveLocalImplementationNames(toolNames, toolExecution) {
+	if (!shouldUseLocalExecution(toolExecution) && !shouldUseCloudflareSandboxExecution(toolExecution)) return /* @__PURE__ */ new Set();
+	if (shouldIncludeCodingTools(toolExecution)) return shouldUseCloudflareSandboxExecution(toolExecution) ? getSelectedCloudflareCodingToolNames(getCloudflareConfig(toolExecution)) : new Set(LOCAL_CODING_BUNDLE_NAMES);
+	const existingNames = new Set(toolNames);
+	return new Set([...CODE_EXECUTION_TOOLS].filter((name) => existingNames.has(name)));
+}
 function resolveLocalExecutionTools(args) {
 	const directToolNames = /* @__PURE__ */ new Set();
+	const localImplementationNames = resolveLocalImplementationNames(args.toolMap.keys(), args.toolExecution);
 	if (!shouldUseLocalExecution(args.toolExecution) && !shouldUseCloudflareSandboxExecution(args.toolExecution)) return {
 		toolMap: args.toolMap,
-		directToolNames
+		directToolNames,
+		localImplementationNames
 	};
 	const toolMap = new Map(args.toolMap);
 	let fileCheckpointer;
@@ -141,10 +155,12 @@ function resolveLocalExecutionTools(args) {
 				fileCheckpointer = bundle.checkpointer;
 				for (const cloudflareTool of bundle.tools) {
 					toolMap.set(cloudflareTool.name, cloudflareTool);
+					localImplementationNames.add(cloudflareTool.name);
 					addDirectToolName(directToolNames, cloudflareTool.name, args.toolRegistry);
 				}
 			} else for (const cloudflareTool of createCloudflareCodingTools(cloudflareConfig)) {
 				toolMap.set(cloudflareTool.name, cloudflareTool);
+				localImplementationNames.add(cloudflareTool.name);
 				addDirectToolName(directToolNames, cloudflareTool.name, args.toolRegistry);
 			}
 		}
@@ -155,11 +171,13 @@ function resolveLocalExecutionTools(args) {
 			const cloudflareTool = createCloudflareExecutionTool(name, cloudflareConfig);
 			if (cloudflareTool == null) continue;
 			toolMap.set(name, cloudflareTool);
+			localImplementationNames.add(name);
 			addDirectToolName(directToolNames, name, args.toolRegistry);
 		}
 		return {
 			toolMap,
 			directToolNames,
+			localImplementationNames,
 			fileCheckpointer
 		};
 	}
@@ -169,10 +187,12 @@ function resolveLocalExecutionTools(args) {
 		fileCheckpointer = bundle.checkpointer;
 		for (const localTool of bundle.tools) {
 			toolMap.set(localTool.name, localTool);
+			localImplementationNames.add(localTool.name);
 			addDirectToolName(directToolNames, localTool.name, args.toolRegistry);
 		}
 	} else for (const localTool of createLocalCodingTools(localConfig)) {
 		toolMap.set(localTool.name, localTool);
+		localImplementationNames.add(localTool.name);
 		addDirectToolName(directToolNames, localTool.name, args.toolRegistry);
 	}
 	const includeCodingTools = shouldIncludeCodingTools(args.toolExecution);
@@ -182,15 +202,17 @@ function resolveLocalExecutionTools(args) {
 		const localTool = createLocalExecutionTool(name, localConfig);
 		if (localTool == null) continue;
 		toolMap.set(name, localTool);
+		localImplementationNames.add(name);
 		addDirectToolName(directToolNames, name, args.toolRegistry);
 	}
 	return {
 		toolMap,
 		directToolNames,
+		localImplementationNames,
 		fileCheckpointer
 	};
 }
 //#endregion
-export { isProgrammaticRunnerAutoBound, resolveLocalExecutionTools, resolveLocalToolRegistry, resolveLocalToolsForBinding };
+export { isProgrammaticRunnerAutoBound, isProgrammaticRunnerResolvedDirectly, resolveLocalExecutionTools, resolveLocalImplementationNames, resolveLocalToolRegistry, resolveLocalToolsForBinding };
 
 //# sourceMappingURL=resolveLocalExecutionTools.mjs.map

package/dist/esm/tools/local/resolveLocalExecutionTools.mjs.map

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

package/dist/types/agents/AgentContext.d.ts

@@ -221,7 +221,12 @@ export declare class AgentContext {
     });
     /** Builds the caller boundary and schemas for programmatic-only tools. */
     private buildProgrammaticOnlyToolsInstructions;
+    private buildProgrammaticToolGroupInstructions;
     private getProgrammaticToolInstructionTargets;
+    /** Whether ToolNode executes this runner in-process instead of via an event. */
+    private isProgrammaticRunnerDirectlyBound;
+    /** Mirrors ToolNode's executable implementation gate for direct runners. */
+    private getDirectProgrammaticCapabilityProjection;
     private hasBoundTool;
     /**
      * Gets the system runnable, creating it lazily if needed.
@@ -297,6 +302,8 @@ export declare class AgentContext {
      * token counts.
      */
     updateTokenMapWithInstructions(baseTokenMap: Record<string, number>): void;
+    /** Event definitions with matching runtime caller/defer metadata applied. */
+    getEffectiveToolDefinitions(): t.LCTool[] | undefined;
     /** Active tool definitions for token accounting (excludes deferred-and-undiscovered entries). */
     private getActiveToolDefinitions;
     /**
@@ -451,6 +458,10 @@ export declare class AgentContext {
     markTokensStale(): void;
     /** Returns a snapshot of the deferred tools discovered in this context. */
     getDiscoveredTools(): string[];
+    /** Returns the live projection shared by prompt and event execution. */
+    private getCallerCapabilityProjection;
+    /** Returns the SDK-owned active caller projection for event-driven hosts. */
+    getCallerCapabilityProjectionSnapshot(): t.CallerCapabilityProjectionSnapshot;
     /**
      * Marks tools as discovered via tool search.
      * Discovered tools will be included in the next model binding.

package/dist/types/index.d.ts

@@ -48,6 +48,8 @@ export type { SmoothItem, SmoothPiece } from './llm/stream/smoother';
 export { FakeChatModel, createFakeStreamingLLM } from './llm/fake';
 export { initializeModel } from './llm/init';
 export { attemptInvoke, tryFallbackProviders } from './llm/invoke';
+export { prepareProviderRequest } from './llm/prepareProviderRequest';
+export type { PreparedProviderRequest, PrepareProviderRequestParams, ProviderMessageProjectionMode, ProviderPayloadMeasurement, ProviderRequestContext, } from './llm/prepareProviderRequest';
 export { canSealPreempt } from './llm/preempt';
 export { isThinkingEnabled, getMaxOutputTokensKey } from './llm/request';
 export { DEFAULT_MAX_TOOL_CALL_ARG_BYTES, StreamLimitExceededError, resolveStreamLimits, } from './llm/streamLimits';

package/dist/types/llm/contextPressureMeter.d.ts

@@ -0,0 +1,30 @@
+import type { BaseMessage } from '@langchain/core/messages';
+import type { ProviderPayloadMeasurement } from '@/llm/prepareProviderRequest';
+import type * as t from '@/types';
+interface ContextPressureUsage {
+    contextBudget?: number;
+    effectiveInstructionTokens?: number;
+    remainingContextTokens?: number;
+    calibrationRatio?: number;
+}
+interface ContextPressureMeterParams {
+    tokenCounter?: t.TokenCounter;
+    sourceMessages: BaseMessage[];
+    retainedMessages: BaseMessage[];
+    indexTokenCountMap: Record<string, number | undefined>;
+    contextUsage?: ContextPressureUsage | null;
+    instructionTokens: number;
+    calibrationRatio: number;
+}
+interface ProviderPayloadMeasureOptions {
+    contextBudget?: number;
+    forceRawRecount?: boolean;
+}
+export interface ContextPressureMeter {
+    trackProjection(before: BaseMessage[], after: BaseMessage[]): BaseMessage[];
+    trackClone(source: BaseMessage, clone: BaseMessage): void;
+    measure(messages: BaseMessage[], options?: ProviderPayloadMeasureOptions): ProviderPayloadMeasurement;
+}
+/** Measures repeated provider projections while tokenizing each message object once. */
+export declare function createContextPressureMeter({ tokenCounter, sourceMessages, retainedMessages, indexTokenCountMap, contextUsage, instructionTokens, calibrationRatio, }: ContextPressureMeterParams): ContextPressureMeter;
+export {};

package/dist/types/llm/invoke.d.ts

@@ -2,18 +2,21 @@ import { AIMessageChunk } from '@langchain/core/messages';
 import type { RunnableConfig } from '@langchain/core/runnables';
 import type { BaseMessage } from '@langchain/core/messages';
 import type { ToolOutputReferenceRegistry } from '@/tools/toolOutputReferences';
+import type { PreparedProviderRequest } from '@/llm/prepareProviderRequest';
 import type { StreamLimitState } from '@/llm/streamLimits';
 import type { ContextOverflowContext } from '@/utils/errors';
 import type * as t from '@/types';
 import { ChatModelStreamHandler } from '@/stream';
 import { Providers } from '@/common';
+export { projectMessagesForProvider, resolveServingModelId, usesNativeOpenAIResponses, } from '@/llm/prepareProviderRequest';
+export type { PreparedProviderRequest, PrepareProviderRequestParams, ProviderMessageProjectionMode, ProviderPayloadMeasurement, ProviderRequestContext, } from '@/llm/prepareProviderRequest';
 /**
  * Context passed to `attemptInvoke`. Matches the subset of Graph that
  * `ChatModelStreamHandler.handle` needs *plus* the explicit
- * `getOrCreateToolOutputRegistry()` accessor that `attemptInvoke`
- * itself calls to pull the run-scoped tool-output registry off the
- * graph and project each relevant ToolMessage into a transient
- * annotated copy before the provider call.
+ * `getOrCreateToolOutputRegistry()` accessor used while preparing a
+ * provider request. Raw callers prepare inside `attemptInvoke`; Graph
+ * callers prepare before final payload measurement and pass the exact
+ * artifact through.
  *
  * The intersection is intentional: `Parameters<...>[3]` resolves
  * indirectly through the stream handler's signature (which returns
@@ -46,26 +49,6 @@ export type InvokeContext = NonNullable<Parameters<ChatModelStreamHandler['handl
  * limits key each model attempt separately.
  */
 export type OnChunk = (chunk: AIMessageChunk, metadata?: Record<string, unknown>) => void | Promise<void>;
-export declare function usesNativeOpenAIResponses(model: t.ChatModel, provider: Providers, callOptions?: unknown): boolean;
-/**
- * Produces the exact provider-facing message representation before a model
- * adapter serializes it. This is shared by invocation and Graph's final budget
- * guard so structured tool output cannot grow after the payload was measured.
- */
-export declare function projectMessagesForProvider({ model, messages, provider, maxToolResultChars, callOptions, }: {
-    model: t.ChatModel;
-    messages: BaseMessage[];
-    provider: Providers;
-    maxToolResultChars?: number;
-    callOptions?: unknown;
-}): BaseMessage[];
-/**
- * The serving model's id, read through the same wrapper stack
- * `collectModelCallbackSources` walks — `bindTools` returns a
- * `RunnableBinding` and a system runnable pipes a `RunnableSequence`, and
- * neither exposes the chat model's `model` at the top level.
- */
-export declare function resolveServingModelId(model: unknown): string | undefined;
 /**
  * Invokes a chat model with the given messages, handling both streaming and
  * non-streaming paths.
@@ -75,10 +58,7 @@ export declare function resolveServingModelId(model: unknown): string | undefine
  * Pass an `onChunk` callback to override this with custom chunk processing
  * (e.g. summarization delta events).
  */
-interface AttemptInvokeParams {
-    model: t.ChatModel;
-    messages: BaseMessage[];
-    provider: Providers;
+interface AttemptInvokeCommonParams {
     context?: InvokeContext;
     onChunk?: OnChunk;
     /** Accounting owner for callers that deliberately pass no `context`
@@ -86,6 +66,17 @@ interface AttemptInvokeParams {
      * for charge claims. */
     streamLimitState?: StreamLimitState;
 }
+type AttemptInvokeParams = AttemptInvokeCommonParams & ({
+    request: PreparedProviderRequest;
+    model?: never;
+    messages?: never;
+    provider?: never;
+} | {
+    request?: never;
+    model: t.ChatModel;
+    messages: BaseMessage[];
+    provider: Providers;
+});
 /**
  * One model attempt. Stamps the attempt identity into callback metadata
  * (see the generation-key notes in `streamLimits.ts`), leases the attempt's
@@ -122,7 +113,7 @@ export declare function getFallbackOverflowCandidates(error: unknown): FallbackO
  * behind a later unrelated error would surface a dead end instead. Ordinary
  * failures still throw last-error-wins.
  */
-export declare function tryFallbackProviders({ fallbacks, tools, messages, config, primaryError, context, onChunk, streamLimitState, overflowContext, prepareProviderMessages, }: {
+export declare function tryFallbackProviders({ fallbacks, tools, messages, config, primaryError, context, onChunk, streamLimitState, overflowContext, prepareProviderRequest: prepareFallbackRequest, prepareProviderMessages, }: {
     fallbacks: t.FallbackConfig[];
     tools?: t.GraphTools;
     messages: BaseMessage[];
@@ -141,10 +132,18 @@ export declare function tryFallbackProviders({ fallbacks, tools, messages, confi
      */
     overflowContext?: ContextOverflowContext;
     /**
-     * Optional final payload guard used by Graph. It receives the initialized,
-     * tool-bound fallback model so Responses-vs-Chat projection is exact before
-     * the fallback request is measured and sent.
+     * Optional exact-payload preparation used by Graph. The returned request is
+     * measured and sent without another provider projection.
      */
+    prepareProviderRequest?: (input: {
+        model: t.ChatModel;
+        messages: BaseMessage[];
+        provider: Providers;
+        clientOptions?: t.ClientOptions;
+        maxContextTokens?: number;
+        config?: RunnableConfig;
+    }) => PreparedProviderRequest | Promise<PreparedProviderRequest>;
+    /** @deprecated Return a `PreparedProviderRequest` instead. */
     prepareProviderMessages?: (input: {
         model: t.ChatModel;
         messages: BaseMessage[];
@@ -154,4 +153,3 @@ export declare function tryFallbackProviders({ fallbacks, tools, messages, confi
         config?: RunnableConfig;
     }) => BaseMessage[] | Promise<BaseMessage[]>;
 }): Promise<Partial<t.BaseGraphState> | undefined>;
-export {};

package/dist/types/llm/prepareProviderRequest.d.ts

@@ -0,0 +1,55 @@
+import type { RunnableConfig } from '@langchain/core/runnables';
+import type { BaseMessage } from '@langchain/core/messages';
+import type { ToolOutputReferenceRegistry } from '@/tools/toolOutputReferences';
+import type * as t from '@/types';
+import { Providers } from '@/common';
+declare const preparedProviderRequestBrand: unique symbol;
+export type ProviderMessageProjectionMode = 'chat-messages' | 'openai-responses';
+export interface ProviderPayloadMeasurement {
+    readonly fits: boolean;
+    readonly projectedMessageTokens?: number;
+    readonly availableMessageTokens?: number;
+    readonly contextBudget?: number;
+    readonly effectiveInstructionTokens?: number;
+}
+export interface PreparedProviderRequest {
+    readonly model: t.ChatModel;
+    readonly modelId?: string;
+    readonly provider: Providers;
+    readonly projectionMode: ProviderMessageProjectionMode;
+    readonly messages: BaseMessage[];
+    readonly measurement?: ProviderPayloadMeasurement;
+    readonly [preparedProviderRequestBrand]: true;
+}
+export interface ProviderRequestContext {
+    getOrCreateToolOutputRegistry?(): ToolOutputReferenceRegistry | undefined;
+    isRunProducedMessage?(message: BaseMessage): boolean;
+}
+export interface PrepareProviderRequestParams {
+    model: t.ChatModel;
+    messages: BaseMessage[];
+    provider: Providers;
+    context?: ProviderRequestContext;
+    config?: RunnableConfig;
+    maxToolResultChars?: number;
+    measure?: (messages: BaseMessage[]) => ProviderPayloadMeasurement;
+}
+export declare function usesNativeOpenAIResponses(model: t.ChatModel, provider: Providers, callOptions?: unknown): boolean;
+interface ProjectMessagesForProviderParams {
+    model: t.ChatModel;
+    messages: BaseMessage[];
+    provider: Providers;
+    maxToolResultChars?: number;
+    callOptions?: unknown;
+}
+/** Produces the provider-facing representation before adapter serialization. */
+export declare function projectMessagesForProvider(params: ProjectMessagesForProviderParams): BaseMessage[];
+/** Reads the serving model id through LangChain binding/sequence wrappers. */
+export declare function resolveServingModelId(model: unknown): string | undefined;
+/**
+ * Finalizes one provider request and measures the exact message array that
+ * will be passed to LangChain. Source messages remain untouched.
+ */
+export declare function prepareProviderRequest({ model, messages, provider, context, config, maxToolResultChars, measure, }: PrepareProviderRequestParams): PreparedProviderRequest;
+export declare function assertPreparedProviderRequestFor(request: PreparedProviderRequest, model: t.ChatModel, provider: Providers, config?: RunnableConfig): void;
+export {};

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

@@ -5,6 +5,19 @@ export type CallerCapabilityProjection = {
     directOnlyTools: t.LCTool[];
     codeExecutionOnlyTools: t.LCTool[];
 };
+/**
+ * Combines event schemas with runtime capability metadata. Matching runtime
+ * entries override caller/defer policy without replacing the event schema;
+ * runtime-only definitions are appended intact.
+ */
+export declare function mergeCallerCapabilityDefinitions(toolDefs: Iterable<t.LCTool> | null | undefined, overrides: Iterable<t.LCTool> | null | undefined): t.LCTool[];
+/**
+ * Applies runtime caller metadata to schema-only event definitions without
+ * adding registry-only tools or replacing their model-facing schemas.
+ */
+export declare function applyCallerCapabilityDefinitionOverrides(toolDefs: Iterable<t.LCTool>, overrides: Iterable<t.LCTool> | null | undefined): t.LCTool[];
+/** Converts the live projection into the versioned event transport shape. */
+export declare function createCallerCapabilityProjectionSnapshot(projection: CallerCapabilityProjection): t.CallerCapabilityProjectionSnapshot;
 export declare function getAllowedCallers(toolDef: t.LCTool): readonly t.AllowedCaller[];
 export declare function allowsToolCaller(toolDef: t.LCTool, caller: t.AllowedCaller): boolean;
 export declare function isProgrammaticControlTool(name: string): boolean;

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

@@ -122,6 +122,10 @@ export declare class ToolNode<T = any> extends RunnableCallable<T, T> {
     private settledInterruptingResults;
     /** Tool registry for filtering (lazy computation of programmatic maps) */
     private toolRegistry?;
+    /** Schema-only definitions used when event mode has no runtime registry. */
+    private toolDefinitions?;
+    /** Tool-map entries created or replaced by the local execution resolver. */
+    private localImplementationNames;
     /** Reads deferred-tool discovery state from the owning agent context. */
     private getDiscoveredToolNames?;
     /** Reference to Graph's sessions map for automatic session injection */
@@ -213,7 +217,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, getDiscoveredToolNames, sessions, codeSessionKey, eventDrivenMode, eagerEventToolExecution, eagerEventToolExecutions, eagerEventToolUsageCount, eagerEventToolSuppressions, agentId, executingAgentId, directToolNames, interruptingToolNames, codeSessionToolNames, maxContextTokens, maxToolResultChars, hookRegistry, humanInTheLoop, toolOutputReferences, toolOutputRegistry, toolExecution, fileCheckpointer, getBreakerSignal, getRunScope, 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, directToolNames, interruptingToolNames, codeSessionToolNames, maxContextTokens, maxToolResultChars, hookRegistry, humanInTheLoop, toolOutputReferences, toolOutputRegistry, toolExecution, fileCheckpointer, getBreakerSignal, getRunScope, restoreRunStepResumeState, createRunStepResumeState, }: t.ToolNodeConstructorParams);
     invoke(input: any, options?: Partial<RunnableConfig>): Promise<any>;
     /**
      * Returns the run-scoped tool output registry, or `undefined` when
@@ -257,6 +261,10 @@ export declare class ToolNode<T = any> extends RunnableCallable<T, T> {
      * they reuse a ToolNode across batches outside of a Graph.
      */
     clearDirectPathTurns(): void;
+    /** Returns the live caller projection used by direct and event execution. */
+    private getCallerCapabilityProjection;
+    /** Serializes the live caller projection for event-driven hosts. */
+    private getCallerCapabilityProjectionSnapshot;
     /** Returns active tools projected by their effective caller capabilities. */
     private getProgrammaticTools;
     /**

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

@@ -2,6 +2,8 @@ import type * as t from '@/types';
 type ResolveLocalToolsResult = {
     toolMap: t.ToolMap;
     directToolNames: Set<string>;
+    /** Names whose toolMap entries were created or replaced by this resolver. */
+    localImplementationNames: Set<string>;
     /**
      * Set when `local.fileCheckpointing === true` AND the auto-bind
      * coding suite is in use. ToolNode stashes this on the node and
@@ -15,6 +17,8 @@ type ResolveLocalToolsResult = {
     fileCheckpointer?: t.LocalFileCheckpointer;
 };
 export declare function isProgrammaticRunnerAutoBound(name: string, config?: t.ToolExecutionConfig): boolean;
+/** Mirrors whether resolver policy creates or replaces this runner locally. */
+export declare function isProgrammaticRunnerResolvedDirectly(name: string, config?: t.ToolExecutionConfig, hasExplicitBinding?: boolean): boolean;
 export declare function resolveLocalToolsForBinding(args: {
     tools?: t.GraphTools;
     toolExecution?: t.ToolExecutionConfig;
@@ -25,6 +29,8 @@ export declare function resolveLocalToolRegistry(args: {
     toolRegistry?: t.LCToolRegistry;
     toolExecution?: t.ToolExecutionConfig;
 }): t.LCToolRegistry | undefined;
+/** Names that this execution config creates or replaces in the local tool map. */
+export declare function resolveLocalImplementationNames(toolNames: Iterable<string>, toolExecution?: t.ToolExecutionConfig): Set<string>;
 export declare function resolveLocalExecutionTools(args: {
     toolMap: t.ToolMap;
     toolExecution?: t.ToolExecutionConfig;

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

@@ -513,6 +513,18 @@ export type ToolCallRequest = {
      */
     runtimeSessionHint?: string;
 };
+/**
+ * Serializable view of the active tools grouped by their effective caller
+ * capabilities. Event-driven hosts use this snapshot to preserve the SDK's
+ * live deferred-tool discovery state without reimplementing its policy.
+ */
+export type CallerCapabilityProjectionSnapshot = {
+    version: 1;
+    directToolNames: string[];
+    codeExecutionToolNames: string[];
+    directOnlyToolNames: string[];
+    codeExecutionOnlyToolNames: string[];
+};
 /** Batch request containing ALL tool calls for a graph step */
 export type ToolExecuteBatchRequest = {
     /** All tool calls from the AIMessage */
@@ -521,6 +533,11 @@ export type ToolExecuteBatchRequest = {
     userId?: string;
     /** Agent ID for context */
     agentId?: string;
+    /**
+     * SDK-owned snapshot of the active caller capability projection. Optional
+     * so older event handlers remain compatible with newer SDKs.
+     */
+    callerCapabilityProjection?: CallerCapabilityProjectionSnapshot;
     /** Runtime configurable from RunnableConfig (includes user, userMCPAuthMap, etc.) */
     configurable?: Record<string, unknown>;
     /** Runtime metadata from RunnableConfig (includes thread_id, run_id, provider, etc.) */

package/package.json

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