@librechat/agents 3.8.4 → 3.8.6

package/src/types/graph.ts

@@ -395,6 +395,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`
@@ -669,6 +671,41 @@ export interface SubagentExecutionContext {
   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/src/types/run.ts

@@ -291,6 +291,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/src/types/tools.ts

@@ -11,10 +11,10 @@ import type {
   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 */
@@ -75,6 +75,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
@@ -156,6 +157,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. */
@@ -573,6 +576,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
@@ -596,6 +603,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 */
@@ -1227,6 +1236,7 @@ export type ProgrammaticHookContext = {
   runId: string;
   threadId?: string;
   agentId?: string;
+  executionContext?: SubagentExecutionContext;
   executingAgentId?: string;
 };
 

package/src/utils/llmConfig.ts

@@ -71,7 +71,6 @@ export const llmConfigs: Record<string, t.BuiltInLLMConfig | undefined> = {
   } as or.ChatOpenRouterCallOptions & t.BuiltInLLMConfig,
   [Providers.AZURE]: {
     provider: Providers.AZURE,
-    temperature: 0.7,
     streaming: true,
     streamUsage: true,
     azureOpenAIApiKey: process.env.AZURE_OPENAI_API_KEY,