@librechat/agents 3.2.57 → 3.2.58

package/src/tools/search/types.ts

@@ -3,7 +3,7 @@ import type { Logger as WinstonLogger } from 'winston';
 import type { BaseReranker } from './rerankers';
 import { DATE_RANGE } from './schema';
 
-export type SearchProvider = 'serper' | 'searxng' | 'tavily';
+export type SearchProvider = 'serper' | 'searxng' | 'tavily' | 'keenable';
 export type ScraperProvider = 'firecrawl' | 'serper' | 'tavily';
 export type RerankerType = 'infinity' | 'jina' | 'cohere' | 'none';
 
@@ -115,6 +115,36 @@ export interface SearchConfig {
   tavilySearchUrl?: string;
   tavilyExtractUrl?: string;
   tavilySearchOptions?: TavilySearchOptions;
+  keenableApiKey?: string;
+  keenableApiUrl?: string;
+  keenableSearchOptions?: KeenableSearchOptions;
+}
+
+export interface KeenableSearchOptions {
+  maxResults?: number;
+  /** Restrict results to a single domain, e.g. "github.com". */
+  site?: string;
+  /** Sent as the X-Keenable-Title attribution header. Defaults to "LibreChat". */
+  attributionTitle?: string;
+  timeout?: number;
+}
+
+export interface KeenableSearchPayload {
+  query: string;
+  site?: string;
+  published_after?: string;
+}
+
+export interface KeenableSearchResult {
+  title?: string;
+  url?: string;
+  description?: string;
+  snippet?: string;
+  published_at?: string;
+}
+
+export interface KeenableSearchResponse {
+  results?: KeenableSearchResult[];
 }
 
 export type References = {
@@ -137,6 +167,15 @@ export interface ProcessSourcesConfig {
    * chunker/reranker. Defaults to 50,000; also configurable via the
    * `SEARCH_MAX_CONTENT_LENGTH` env var. */
   maxContentLength?: number;
+  /** Chunk size (chars) for splitting scraped content before reranking.
+   * Defaults to 150; also configurable via the `SEARCH_CHUNK_SIZE` env var.
+   * Larger chunks send fewer documents to the reranker (lower cost/latency);
+   * highlights are expanded ±300-450 chars around each hit either way. */
+  chunkSize?: number;
+  /** Overlap (chars) between adjacent chunks. Defaults to 50; also
+   * configurable via the `SEARCH_CHUNK_OVERLAP` env var. Clamped below
+   * `chunkSize`. */
+  chunkOverlap?: number;
   strategies?: string[];
   filterContent?: boolean;
   reranker?: BaseReranker;
@@ -231,6 +270,8 @@ export interface SearchToolConfig
   jinaApiUrl?: string;
   cohereApiKey?: string;
   rerankerType?: RerankerType;
+  /** Timeout (ms) for rerank API requests. Defaults to 10,000. */
+  rerankerTimeout?: number;
   scraperProvider?: ScraperProvider;
   scraperTimeout?: number;
   serperScraperOptions?: SerperScraperConfig;

package/src/tools/subagent/SubagentExecutor.ts

@@ -1422,6 +1422,17 @@ export function buildChildInputs(
      */
     initialSummary: undefined,
     discoveredTools: undefined,
+    /**
+     * Host-supplied direct tools are scrubbed from INHERITED configs only.
+     * A self-spawn config's `agentInputs` is a shallow spread of the parent's
+     * `_sourceInputs`, so without this a parent-scoped graph tool (e.g. an
+     * interrupt-raising ask_user_question, which needs the parent's
+     * checkpointer — child graphs compile without one) would silently leak
+     * into the child and deterministically throw `No checkpointer set`. An
+     * EXPLICIT child config that lists its own `graphTools` is a deliberate
+     * host choice and keeps them (Codex #289 P2).
+     */
+    graphTools: config.self === true ? undefined : agentInputs.graphTools,
   };
 
   if (config.allowNested === true) {

package/src/types/graph.ts

@@ -610,6 +610,28 @@ export interface AgentInputs {
   subagentConfigs?: SubagentConfig[];
   /** Maximum subagent nesting depth. Default 1 means top-level agents can spawn subagents but subagents cannot nest further. */
   maxSubagentDepth?: number;
+  /**
+   * Host-supplied tool instances that must execute IN-PROCESS inside the graph's
+   * ToolNode even when the run is event-driven (`toolDefinitions` non-empty). Each
+   * instance is bound to the model alongside the schema-only event tools and its
+   * name is marked direct, so calls bypass ON_TOOL_EXECUTE dispatch and run inside
+   * the Pregel task frame. This is the only execution mode where a tool body may
+   * raise a LangGraph `interrupt()` (e.g. a tool built on `askUserQuestion()`) —
+   * the host-side event handler runs outside the graph task, where `interrupt()`
+   * throws. Do NOT also list these tools in `toolDefinitions` (they would be bound
+   * twice). NOT inherited by SELF-SPAWNED subagent children (their config is a
+   * shallow spread of the parent's inputs, and child graphs compile without a
+   * checkpointer, so an interrupt-capable tool could never pause there) —
+   * `buildChildInputs` scrubs the inherited copy; an EXPLICIT child config that
+   * lists its own `graphTools` keeps them.
+   *
+   * Deliberately `GenericTool[]`, not `GraphTools`: the wider union admits
+   * schema-only shapes (OpenAI `BindToolsInput`, Google tool objects) that
+   * `initializeTools` cannot register in the ToolNode direct map — the model
+   * would bind a tool the SDK advertised as in-process but cannot execute.
+   * Every entry must be a real executable tool instance with a `name`.
+   */
+  graphTools?: GenericTool[];
 }
 
 export interface ContextPruningConfig {

package/src/utils/title.ts

@@ -53,7 +53,7 @@ export const createTitleRunnable = async (
 
   const titlePrompt = ChatPromptTemplate.fromTemplate(
     _titlePrompt ?? defaultTitlePrompt
-  ).withConfig({ runName: 'TitlePrompt' });
+  ).withConfig({ runName: 'BuildTitlePrompt' });
 
   const titleOnlyInnerChain = RunnableSequence.from([titlePrompt, titleLLM]);
   const combinedInnerChain = RunnableSequence.from([titlePrompt, combinedLLM]);
@@ -67,7 +67,7 @@ export const createTitleRunnable = async (
       const result = await titleOnlyInnerChain.invoke(input, config);
       return result as { title: string };
     },
-  }).withConfig({ runName: 'TitleOnlyChain' });
+  }).withConfig({ runName: 'GenerateTitleOnly' });
 
   /** Wrap combinedChain in RunnableLambda to create parent span */
   const combinedChain = new RunnableLambda({
@@ -78,7 +78,7 @@ export const createTitleRunnable = async (
       const result = await combinedInnerChain.invoke(input, config);
       return result as { language: string; title: string };
     },
-  }).withConfig({ runName: 'TitleLanguageChain' });
+  }).withConfig({ runName: 'GenerateTitleAndDetectLanguage' });
 
   /** Runnable to add default values if needed */
   const addDefaults = new RunnableLambda({
@@ -88,7 +88,7 @@ export const createTitleRunnable = async (
       language: result?.language ?? 'English',
       title: result?.title ?? '',
     }),
-  }).withConfig({ runName: 'AddDefaults' });
+  }).withConfig({ runName: 'ApplyTitleDefaults' });
 
   const combinedChainInner = RunnableSequence.from([
     combinedChain,
@@ -103,7 +103,7 @@ export const createTitleRunnable = async (
     ): Promise<{ language: string; title: string }> => {
       return await combinedChainInner.invoke(input, config);
     },
-  }).withConfig({ runName: 'CombinedChainWithDefaults' });
+  }).withConfig({ runName: 'GenerateTitleAndDetectLanguageWithDefaults' });
 
   return new RunnableLambda({
     func: async (
@@ -124,7 +124,7 @@ export const createTitleRunnable = async (
 
       return await combinedChainWithDefaults.invoke(invokeInput, config);
     },
-  }).withConfig({ runName: 'TitleGenerator' });
+  }).withConfig({ runName: 'GenerateTitle' });
 };
 
 const defaultCompletionPrompt = `Provide a concise, 5-word-or-less title for the conversation, using title case conventions. Only return the title itself.
@@ -138,7 +138,7 @@ export const createCompletionTitleRunnable = async (
 ): Promise<Runnable> => {
   const completionPrompt = ChatPromptTemplate.fromTemplate(
     titlePrompt ?? defaultCompletionPrompt
-  ).withConfig({ runName: 'CompletionTitlePrompt' });
+  ).withConfig({ runName: 'BuildTitlePrompt' });
 
   /** Runnable to extract content from model response */
   const extractContent = new RunnableLambda({
@@ -157,7 +157,7 @@ export const createCompletionTitleRunnable = async (
       }
       return { title: content.trim() };
     },
-  }).withConfig({ runName: 'ExtractTitle' });
+  }).withConfig({ runName: 'ParseTitleFromResponse' });
 
   const innerChain = RunnableSequence.from([
     completionPrompt,
@@ -173,5 +173,5 @@ export const createCompletionTitleRunnable = async (
     ): Promise<{ title: string }> => {
       return await innerChain.invoke(input, config);
     },
-  }).withConfig({ runName: 'CompletionTitleChain' });
+  }).withConfig({ runName: 'GenerateTitle' });
 };