@librechat/agents 3.3.5 → 3.3.7

package/dist/cjs/tools/search/tool.cjs

@@ -2,6 +2,7 @@ require("../../common/enum.cjs");
 require("../../common/index.cjs");
 const require_utils = require("./utils.cjs");
 const require_format = require("./format.cjs");
+const require_intentArg = require("../intentArg.cjs");
 const require_schema = require("./schema.cjs");
 const require_search = require("./search.cjs");
 const require_keenable_scraper = require("./keenable-scraper.cjs");
@@ -14,6 +15,29 @@ const require_rerankers = require("./rerankers.cjs");
 let _langchain_core_tools = require("@langchain/core/tools");
 //#region src/tools/search/tool.ts
 /**
+* Settled label for a `web_search` call's intent (see `intentArg.ts`).
+*
+* Counts the result kinds `formatResultsForLLM` actually renders —
+* `references` only tracks links embedded in extracted highlights, so it
+* undercounts ordinary results and can overcount when one highlight embeds
+* several links.
+*
+* A caught provider or processing failure is reported through `data.error`
+* while the tool still returns NORMALLY, so that case must author its own
+* label: the `ToolMessage` carries success status, so without an authored
+* outcome the in-flight intent ("Searching…") would stand as the settled
+* label and present a failed search as an ordinary one.
+*
+* Returns undefined for a genuine zero-result search, leaving the
+* model-authored intent to stand unchanged as the label.
+*/
+function resolveSearchOutcome(data, query) {
+	if (data.error != null && data.error !== "") return `Search failed for "${query}"`;
+	const count = (data.organic?.length ?? 0) + (data.topStories?.length ?? 0) + (data.news?.length ?? 0) + (data.images?.length ?? 0) + (data.videos?.length ?? 0) + (data.places?.length ?? 0) + (data.peopleAlsoAsk?.length ?? 0) + (data.knowledgeGraph != null ? 1 : 0) + (data.answerBox != null ? 1 : 0);
+	if (count === 0) return;
+	return `Found ${count} result${count === 1 ? "" : "s"} for "${query}"`;
+}
+/**
 * Executes parallel searches and merges the results,
 * deduplicating top stories by link
 */
@@ -173,7 +197,11 @@ function createTool({ schema, search, maxOutputChars, onSearchResults: _onSearch
 			...searchResult,
 			references
 		};
-		return [output, { ["web_search"]: data }];
+		const outcome = resolveSearchOutcome(data, query);
+		return [output, {
+			["web_search"]: data,
+			...outcome != null && { outcome }
+		}];
 	}, {
 		name: require_schema.WebSearchToolName,
 		description: require_schema.WebSearchToolDescription,
@@ -189,6 +217,7 @@ const createSearchTool = (config = {}) => {
 		safeSearch: config.safeSearch !== 0
 	} : tavilySearchOptions;
 	const schemaProperties = {
+		intent: { ...require_intentArg.INTENT_PROPERTY },
 		query: require_schema.querySchema,
 		date: require_schema.dateSchema,
 		images: require_schema.imagesSchema,
@@ -295,5 +324,6 @@ const createSearchTool = (config = {}) => {
 //#endregion
 exports.createSearchTool = createSearchTool;
 exports.executeParallelSearches = executeParallelSearches;
+exports.resolveSearchOutcome = resolveSearchOutcome;
 
 //# sourceMappingURL=tool.cjs.map

package/dist/cjs/tools/search/tool.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"tool.cjs","names":["expandHighlights","params","formatResultsForLLM","WebSearchToolName","WebSearchToolDescription","createDefaultLogger","querySchema","dateSchema","imagesSchema","videosSchema","newsSchema","countrySchema","createSearchAPI","createSerperScraper","createTavilyScraper","createCrwScraper","createKeenableScraper","createFirecrawlScraper","createReranker","createSourceProcessor"],"sources":["../../../../src/tools/search/tool.ts"],"sourcesContent":["import { tool, DynamicStructuredTool } from '@langchain/core/tools';\nimport type { RunnableConfig } from '@langchain/core/runnables';\nimport type * as t from './types';\nimport {\n  WebSearchToolDescription,\n  WebSearchToolName,\n  countrySchema,\n  imagesSchema,\n  videosSchema,\n  querySchema,\n  dateSchema,\n  newsSchema,\n  DATE_RANGE,\n} from './schema';\nimport { createSearchAPI, createSourceProcessor } from './search';\nimport { createKeenableScraper } from './keenable-scraper';\nimport { createSerperScraper } from './serper-scraper';\nimport { createTavilyScraper } from './tavily-scraper';\nimport { createFirecrawlScraper } from './firecrawl';\nimport { createCrwScraper } from './crw-scraper';\nimport { expandHighlights } from './highlights';\nimport { formatResultsForLLM } from './format';\nimport { createDefaultLogger } from './utils';\nimport { createReranker } from './rerankers';\nimport { Constants } from '@/common';\n\n/**\n * Executes parallel searches and merges the results,\n * deduplicating top stories by link\n */\nexport async function executeParallelSearches({\n  searchAPI,\n  query,\n  date,\n  country,\n  safeSearch,\n  images,\n  videos,\n  news,\n  logger,\n}: {\n  searchAPI: ReturnType<typeof createSearchAPI>;\n  query: string;\n  date?: DATE_RANGE;\n  country?: string;\n  safeSearch: t.SearchToolConfig['safeSearch'];\n  images: boolean;\n  videos: boolean;\n  news: boolean;\n  logger: t.Logger;\n}): Promise<t.SearchResult> {\n  // Prepare all search tasks to run in parallel\n  const searchTasks: Promise<t.SearchResult>[] = [\n    // Main search\n    searchAPI.getSources({\n      query,\n      date,\n      country,\n      safeSearch,\n    }),\n  ];\n\n  if (images) {\n    searchTasks.push(\n      searchAPI\n        .getSources({\n          query,\n          date,\n          country,\n          safeSearch,\n          type: 'images',\n        })\n        .catch((error) => {\n          logger.error('Error fetching images:', error);\n          return {\n            success: false,\n            error: `Images search failed: ${error instanceof Error ? error.message : String(error)}`,\n          };\n        })\n    );\n  }\n  if (videos) {\n    searchTasks.push(\n      searchAPI\n        .getSources({\n          query,\n          date,\n          country,\n          safeSearch,\n          type: 'videos',\n        })\n        .catch((error) => {\n          logger.error('Error fetching videos:', error);\n          return {\n            success: false,\n            error: `Videos search failed: ${error instanceof Error ? error.message : String(error)}`,\n          };\n        })\n    );\n  }\n  if (news) {\n    searchTasks.push(\n      searchAPI\n        .getSources({\n          query,\n          date,\n          country,\n          safeSearch,\n          type: 'news',\n        })\n        .catch((error) => {\n          logger.error('Error fetching news:', error);\n          return {\n            success: false,\n            error: `News search failed: ${error instanceof Error ? error.message : String(error)}`,\n          };\n        })\n    );\n  }\n\n  // Run all searches in parallel\n  const results = await Promise.all(searchTasks);\n\n  // Get the main search result (first result)\n  const mainResult = results[0];\n  if (!mainResult.success) {\n    throw new Error(mainResult.error ?? 'Search failed');\n  }\n\n  // Merge additional results with the main results\n  const mergedResults = { ...mainResult.data };\n\n  // Convert existing news to topStories if present\n  if (mergedResults.news !== undefined && mergedResults.news.length > 0) {\n    const existingNewsAsTopStories = mergedResults.news\n      .filter((newsItem) => newsItem.link !== undefined && newsItem.link !== '')\n      .map((newsItem) => ({\n        title: newsItem.title ?? '',\n        link: newsItem.link ?? '',\n        source: newsItem.source ?? '',\n        date: newsItem.date ?? '',\n        imageUrl: newsItem.imageUrl ?? '',\n        processed: false,\n      }));\n    mergedResults.topStories = [\n      ...(mergedResults.topStories ?? []),\n      ...existingNewsAsTopStories,\n    ];\n    delete mergedResults.news;\n  }\n\n  results.slice(1).forEach((result) => {\n    if (result.success && result.data !== undefined) {\n      if (result.data.images !== undefined && result.data.images.length > 0) {\n        mergedResults.images = [\n          ...(mergedResults.images ?? []),\n          ...result.data.images,\n        ];\n      }\n      if (result.data.videos !== undefined && result.data.videos.length > 0) {\n        mergedResults.videos = [\n          ...(mergedResults.videos ?? []),\n          ...result.data.videos,\n        ];\n      }\n      if (result.data.news !== undefined && result.data.news.length > 0) {\n        const newsAsTopStories = result.data.news.map((newsItem) => ({\n          ...newsItem,\n          link: newsItem.link ?? '',\n        }));\n        mergedResults.topStories = [\n          ...(mergedResults.topStories ?? []),\n          ...newsAsTopStories,\n        ];\n      }\n    }\n  });\n\n  if (\n    mergedResults.topStories !== undefined &&\n    mergedResults.topStories.length > 1\n  ) {\n    /** The main search's own news results and the parallel news sub-search\n     * frequently return the same stories — keep the first occurrence of each\n     * link so duplicates aren't scraped, reranked, and formatted repeatedly */\n    const seenLinks = new Set<string>();\n    mergedResults.topStories = mergedResults.topStories.filter((story) => {\n      if (!story.link || seenLinks.has(story.link)) {\n        return false;\n      }\n      seenLinks.add(story.link);\n      return true;\n    });\n  }\n\n  return { success: true, data: mergedResults };\n}\n\nfunction createSearchProcessor({\n  searchAPI,\n  safeSearch,\n  supportsImages,\n  supportsVideos,\n  supportsNews,\n  sourceProcessor,\n  onGetHighlights,\n  mainExpandBy,\n  separatorExpandBy,\n  logger,\n}: {\n  safeSearch: t.SearchToolConfig['safeSearch'];\n  supportsImages: boolean;\n  supportsVideos: boolean;\n  supportsNews: boolean;\n  searchAPI: ReturnType<typeof createSearchAPI>;\n  sourceProcessor: ReturnType<typeof createSourceProcessor>;\n  onGetHighlights: t.SearchToolConfig['onGetHighlights'];\n  mainExpandBy: t.SearchToolConfig['mainExpandBy'];\n  separatorExpandBy: t.SearchToolConfig['separatorExpandBy'];\n  logger: t.Logger;\n}) {\n  return async function ({\n    query,\n    date,\n    country,\n    proMode = true,\n    maxSources = 5,\n    onSearchResults,\n    images = false,\n    videos = false,\n    news = false,\n  }: {\n    query: string;\n    country?: string;\n    date?: DATE_RANGE;\n    proMode?: boolean;\n    maxSources?: number;\n    onSearchResults: t.SearchToolConfig['onSearchResults'];\n    images?: boolean;\n    videos?: boolean;\n    news?: boolean;\n  }): Promise<t.SearchResultData> {\n    try {\n      // Execute parallel searches and merge results\n      const searchResult = await executeParallelSearches({\n        searchAPI,\n        query,\n        date,\n        country,\n        safeSearch,\n        images: supportsImages && images,\n        videos: supportsVideos && videos,\n        news: supportsNews && news,\n        logger,\n      });\n\n      onSearchResults?.(searchResult);\n\n      const processedSources = await sourceProcessor.processSources({\n        query,\n        news,\n        result: searchResult,\n        proMode,\n        onGetHighlights,\n        numElements: maxSources,\n      });\n\n      return expandHighlights(\n        processedSources,\n        mainExpandBy,\n        separatorExpandBy\n      );\n    } catch (error) {\n      logger.error('Error in search:', error);\n      return {\n        organic: [],\n        topStories: [],\n        images: [],\n        videos: [],\n        news: [],\n        relatedSearches: [],\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  };\n}\n\nfunction createOnSearchResults({\n  runnableConfig,\n  onSearchResults,\n}: {\n  runnableConfig: RunnableConfig;\n  onSearchResults: t.SearchToolConfig['onSearchResults'];\n}) {\n  return function (results: t.SearchResult): void {\n    if (!onSearchResults) {\n      return;\n    }\n    onSearchResults(results, runnableConfig);\n  };\n}\n\nfunction createTool({\n  schema,\n  search,\n  maxOutputChars,\n  onSearchResults: _onSearchResults,\n}: {\n  schema: Record<string, unknown>;\n  search: ReturnType<typeof createSearchProcessor>;\n  maxOutputChars?: number;\n  onSearchResults: t.SearchToolConfig['onSearchResults'];\n}): DynamicStructuredTool {\n  return tool(\n    async (rawParams, runnableConfig) => {\n      const params = rawParams as SearchToolParams;\n      const { query, date, country: _c, images, videos, news } = params;\n      const country = typeof _c === 'string' && _c ? _c : undefined;\n      const searchResult = await search({\n        query,\n        date,\n        country,\n        images,\n        videos,\n        news,\n        onSearchResults: createOnSearchResults({\n          runnableConfig,\n          onSearchResults: _onSearchResults,\n        }),\n      });\n      const turn = runnableConfig.toolCall?.turn ?? 0;\n      const { output, references } = formatResultsForLLM(\n        turn,\n        searchResult,\n        maxOutputChars\n      );\n      const data: t.SearchResultData = { turn, ...searchResult, references };\n      return [output, { [Constants.WEB_SEARCH]: data }];\n    },\n    {\n      name: WebSearchToolName,\n      description: WebSearchToolDescription,\n      schema: schema,\n      responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    }\n  );\n}\n\n/**\n * Creates a search tool with configurable search and scraper providers.\n *\n * Search providers: Serper (Google results), SearXNG (self-hosted meta-search), Tavily (AI-optimized), fastCRW (Firecrawl-compatible, self-host or cloud).\n * Scraper providers: Firecrawl (default, full-featured), Serper (lightweight), Tavily (batch extraction), fastCRW (Firecrawl-compatible, self-host or cloud).\n *\n * The country schema field is exposed to the LLM for providers that support localized results.\n */\n/** Input params type for search tool */\ninterface SearchToolParams {\n  query: string;\n  date?: DATE_RANGE;\n  country?: string;\n  images?: boolean;\n  videos?: boolean;\n  news?: boolean;\n}\n\nexport const createSearchTool = (\n  config: t.SearchToolConfig = {}\n): DynamicStructuredTool => {\n  const {\n    searchProvider = 'serper',\n    serperApiKey,\n    searxngInstanceUrl,\n    searxngApiKey,\n    tavilyApiKey,\n    tavilySearchUrl,\n    tavilyExtractUrl,\n    tavilySearchOptions,\n    keenableApiKey,\n    keenableApiUrl,\n    keenableSearchOptions,\n    keenableScraperOptions,\n    rerankerType = 'cohere',\n    rerankerTimeout,\n    topResults = 5,\n    maxContentLength,\n    chunkSize,\n    chunkOverlap,\n    mainExpandBy,\n    separatorExpandBy,\n    maxOutputChars,\n    strategies = ['no_extraction'],\n    filterContent = true,\n    safeSearch = 1,\n    scraperProvider = 'firecrawl',\n    firecrawlApiKey,\n    firecrawlApiUrl,\n    firecrawlVersion,\n    firecrawlOptions,\n    serperScraperOptions,\n    tavilyScraperOptions,\n    crwApiKey,\n    crwApiUrl,\n    crwSearchOptions,\n    crwScraperOptions,\n    scraperTimeout,\n    jinaApiKey,\n    jinaApiUrl,\n    cohereApiKey,\n    onSearchResults: _onSearchResults,\n    onGetHighlights,\n  } = config;\n\n  const logger = config.logger || createDefaultLogger();\n  const effectiveTavilySearchOptions =\n    searchProvider === 'tavily' && config.safeSearch != null\n      ? {\n        ...tavilySearchOptions,\n        safeSearch: config.safeSearch !== 0,\n      }\n      : tavilySearchOptions;\n\n  const schemaProperties: Record<string, unknown> = {\n    query: querySchema,\n    date: dateSchema,\n    images: imagesSchema,\n    videos: videosSchema,\n    news: newsSchema,\n  };\n\n  if (searchProvider === 'serper' || searchProvider === 'tavily') {\n    schemaProperties.country = countrySchema;\n  }\n\n  const toolSchema = {\n    type: 'object',\n    properties: schemaProperties,\n    required: ['query'],\n  };\n\n  const searchAPI = createSearchAPI({\n    searchProvider,\n    serperApiKey,\n    searxngInstanceUrl,\n    searxngApiKey,\n    tavilyApiKey,\n    tavilySearchUrl,\n    tavilySearchOptions: effectiveTavilySearchOptions,\n    keenableApiKey,\n    keenableApiUrl,\n    keenableSearchOptions,\n    crwApiKey,\n    crwApiUrl,\n    crwSearchOptions,\n  });\n\n  /** Create scraper based on scraperProvider */\n  let scraperInstance: t.BaseScraper;\n\n  if (scraperProvider === 'serper') {\n    scraperInstance = createSerperScraper({\n      ...serperScraperOptions,\n      apiKey: serperApiKey,\n      timeout: scraperTimeout ?? serperScraperOptions?.timeout,\n      logger,\n    });\n  } else if (scraperProvider === 'tavily') {\n    scraperInstance = createTavilyScraper({\n      ...tavilyScraperOptions,\n      apiKey:\n        tavilyScraperOptions?.apiKey ??\n        tavilyApiKey ??\n        process.env.TAVILY_API_KEY,\n      apiUrl: tavilyScraperOptions?.apiUrl ?? tavilyExtractUrl,\n      timeout: scraperTimeout ?? tavilyScraperOptions?.timeout,\n      logger,\n    });\n  } else if (scraperProvider === 'crw') {\n    scraperInstance = createCrwScraper({\n      ...crwScraperOptions,\n      apiKey: crwScraperOptions?.apiKey ?? crwApiKey ?? process.env.CRW_API_KEY,\n      apiUrl: crwScraperOptions?.apiUrl ?? crwApiUrl,\n      timeout: scraperTimeout ?? crwScraperOptions?.timeout,\n      formats: crwScraperOptions?.formats ?? ['markdown', 'rawHtml'],\n      logger,\n    });\n  } else if (scraperProvider === 'keenable') {\n    scraperInstance = createKeenableScraper({\n      ...keenableScraperOptions,\n      apiKey: keenableScraperOptions?.apiKey ?? keenableApiKey,\n      timeout: scraperTimeout ?? keenableScraperOptions?.timeout,\n      attributionTitle:\n        keenableScraperOptions?.attributionTitle ??\n        keenableSearchOptions?.attributionTitle,\n      logger,\n    });\n  } else {\n    scraperInstance = createFirecrawlScraper({\n      ...firecrawlOptions,\n      apiKey: firecrawlApiKey ?? process.env.FIRECRAWL_API_KEY,\n      apiUrl: firecrawlApiUrl,\n      version: firecrawlVersion,\n      timeout: scraperTimeout ?? firecrawlOptions?.timeout,\n      formats: firecrawlOptions?.formats ?? ['markdown', 'rawHtml'],\n      logger,\n    });\n  }\n\n  const selectedReranker = createReranker({\n    rerankerType,\n    jinaApiKey,\n    jinaApiUrl,\n    cohereApiKey,\n    rerankerTimeout,\n    logger,\n  });\n\n  if (!selectedReranker) {\n    logger.warn('No reranker selected. Using default ranking.');\n  }\n\n  const sourceProcessor = createSourceProcessor(\n    {\n      reranker: selectedReranker,\n      topResults,\n      maxContentLength,\n      chunkSize,\n      chunkOverlap,\n      strategies,\n      filterContent,\n      logger,\n    },\n    scraperInstance\n  );\n\n  const search = createSearchProcessor({\n    searchAPI,\n    safeSearch,\n    // Keenable is organic-only: its API ignores `type`, so image/news\n    // sub-searches would spend rate limit and merge nothing.\n    supportsImages: searchProvider !== 'keenable',\n    supportsVideos:\n      searchProvider !== 'tavily' &&\n      searchProvider !== 'keenable' &&\n      searchProvider !== 'crw',\n    supportsNews: searchProvider !== 'keenable',\n    sourceProcessor,\n    onGetHighlights,\n    mainExpandBy,\n    separatorExpandBy,\n    logger,\n  });\n\n  return createTool({\n    search,\n    schema: toolSchema,\n    maxOutputChars,\n    onSearchResults: _onSearchResults,\n  });\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA8BA,eAAsB,wBAAwB,EAC5C,WACA,OACA,MACA,SACA,YACA,QACA,QACA,MACA,UAW0B;CAE1B,MAAM,cAAyC,CAE7C,UAAU,WAAW;EACnB;EACA;EACA;EACA;CACF,CAAC,CACH;CAEA,IAAI,QACF,YAAY,KACV,UACG,WAAW;EACV;EACA;EACA;EACA;EACA,MAAM;CACR,CAAC,CAAC,CACD,OAAO,UAAU;EAChB,OAAO,MAAM,0BAA0B,KAAK;EAC5C,OAAO;GACL,SAAS;GACT,OAAO,yBAAyB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EACvF;CACF,CAAC,CACL;CAEF,IAAI,QACF,YAAY,KACV,UACG,WAAW;EACV;EACA;EACA;EACA;EACA,MAAM;CACR,CAAC,CAAC,CACD,OAAO,UAAU;EAChB,OAAO,MAAM,0BAA0B,KAAK;EAC5C,OAAO;GACL,SAAS;GACT,OAAO,yBAAyB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EACvF;CACF,CAAC,CACL;CAEF,IAAI,MACF,YAAY,KACV,UACG,WAAW;EACV;EACA;EACA;EACA;EACA,MAAM;CACR,CAAC,CAAC,CACD,OAAO,UAAU;EAChB,OAAO,MAAM,wBAAwB,KAAK;EAC1C,OAAO;GACL,SAAS;GACT,OAAO,uBAAuB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EACrF;CACF,CAAC,CACL;CAIF,MAAM,UAAU,MAAM,QAAQ,IAAI,WAAW;CAG7C,MAAM,aAAa,QAAQ;CAC3B,IAAI,CAAC,WAAW,SACd,MAAM,IAAI,MAAM,WAAW,SAAS,eAAe;CAIrD,MAAM,gBAAgB,EAAE,GAAG,WAAW,KAAK;CAG3C,IAAI,cAAc,SAAS,KAAA,KAAa,cAAc,KAAK,SAAS,GAAG;EACrE,MAAM,2BAA2B,cAAc,KAC5C,QAAQ,aAAa,SAAS,SAAS,KAAA,KAAa,SAAS,SAAS,EAAE,CAAC,CACzE,KAAK,cAAc;GAClB,OAAO,SAAS,SAAS;GACzB,MAAM,SAAS,QAAQ;GACvB,QAAQ,SAAS,UAAU;GAC3B,MAAM,SAAS,QAAQ;GACvB,UAAU,SAAS,YAAY;GAC/B,WAAW;EACb,EAAE;EACJ,cAAc,aAAa,CACzB,GAAI,cAAc,cAAc,CAAC,GACjC,GAAG,wBACL;EACA,OAAO,cAAc;CACvB;CAEA,QAAQ,MAAM,CAAC,CAAC,CAAC,SAAS,WAAW;EACnC,IAAI,OAAO,WAAW,OAAO,SAAS,KAAA,GAAW;GAC/C,IAAI,OAAO,KAAK,WAAW,KAAA,KAAa,OAAO,KAAK,OAAO,SAAS,GAClE,cAAc,SAAS,CACrB,GAAI,cAAc,UAAU,CAAC,GAC7B,GAAG,OAAO,KAAK,MACjB;GAEF,IAAI,OAAO,KAAK,WAAW,KAAA,KAAa,OAAO,KAAK,OAAO,SAAS,GAClE,cAAc,SAAS,CACrB,GAAI,cAAc,UAAU,CAAC,GAC7B,GAAG,OAAO,KAAK,MACjB;GAEF,IAAI,OAAO,KAAK,SAAS,KAAA,KAAa,OAAO,KAAK,KAAK,SAAS,GAAG;IACjE,MAAM,mBAAmB,OAAO,KAAK,KAAK,KAAK,cAAc;KAC3D,GAAG;KACH,MAAM,SAAS,QAAQ;IACzB,EAAE;IACF,cAAc,aAAa,CACzB,GAAI,cAAc,cAAc,CAAC,GACjC,GAAG,gBACL;GACF;EACF;CACF,CAAC;CAED,IACE,cAAc,eAAe,KAAA,KAC7B,cAAc,WAAW,SAAS,GAClC;;;;EAIA,MAAM,4BAAY,IAAI,IAAY;EAClC,cAAc,aAAa,cAAc,WAAW,QAAQ,UAAU;GACpE,IAAI,CAAC,MAAM,QAAQ,UAAU,IAAI,MAAM,IAAI,GACzC,OAAO;GAET,UAAU,IAAI,MAAM,IAAI;GACxB,OAAO;EACT,CAAC;CACH;CAEA,OAAO;EAAE,SAAS;EAAM,MAAM;CAAc;AAC9C;AAEA,SAAS,sBAAsB,EAC7B,WACA,YACA,gBACA,gBACA,cACA,iBACA,iBACA,cACA,mBACA,UAYC;CACD,OAAO,eAAgB,EACrB,OACA,MACA,SACA,UAAU,MACV,aAAa,GACb,iBACA,SAAS,OACT,SAAS,OACT,OAAO,SAWuB;EAC9B,IAAI;GAEF,MAAM,eAAe,MAAM,wBAAwB;IACjD;IACA;IACA;IACA;IACA;IACA,QAAQ,kBAAkB;IAC1B,QAAQ,kBAAkB;IAC1B,MAAM,gBAAgB;IACtB;GACF,CAAC;GAED,kBAAkB,YAAY;GAW9B,OAAOA,mBAAAA,iBACL,MAV6B,gBAAgB,eAAe;IAC5D;IACA;IACA,QAAQ;IACR;IACA;IACA,aAAa;GACf,CAAC,GAIC,cACA,iBACF;EACF,SAAS,OAAO;GACd,OAAO,MAAM,oBAAoB,KAAK;GACtC,OAAO;IACL,SAAS,CAAC;IACV,YAAY,CAAC;IACb,QAAQ,CAAC;IACT,QAAQ,CAAC;IACT,MAAM,CAAC;IACP,iBAAiB,CAAC;IAClB,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAC9D;EACF;CACF;AACF;AAEA,SAAS,sBAAsB,EAC7B,gBACA,mBAIC;CACD,OAAO,SAAU,SAA+B;EAC9C,IAAI,CAAC,iBACH;EAEF,gBAAgB,SAAS,cAAc;CACzC;AACF;AAEA,SAAS,WAAW,EAClB,QACA,QACA,gBACA,iBAAiB,oBAMO;CACxB,QAAA,GAAA,sBAAA,KAAA,CACE,OAAO,WAAW,mBAAmB;EAEnC,MAAM,EAAE,OAAO,MAAM,SAAS,IAAI,QAAQ,QAAQ,SAASC;EAE3D,MAAM,eAAe,MAAM,OAAO;GAChC;GACA;GACA,SAJc,OAAO,OAAO,YAAY,KAAK,KAAK,KAAA;GAKlD;GACA;GACA;GACA,iBAAiB,sBAAsB;IACrC;IACA,iBAAiB;GACnB,CAAC;EACH,CAAC;EACD,MAAM,OAAO,eAAe,UAAU,QAAQ;EAC9C,MAAM,EAAE,QAAQ,eAAeC,eAAAA,oBAC7B,MACA,cACA,cACF;EACA,MAAM,OAA2B;GAAE;GAAM,GAAG;GAAc;EAAW;EACrE,OAAO,CAAC,QAAQ,GAAA,eAA0B,KAAK,CAAC;CAClD,GACA;EACE,MAAMC,eAAAA;EACN,aAAaC,eAAAA;EACL;EACR,gBAAA;CACF,CACF;AACF;AAoBA,MAAa,oBACX,SAA6B,CAAC,MACJ;CAC1B,MAAM,EACJ,iBAAiB,UACjB,cACA,oBACA,eACA,cACA,iBACA,kBACA,qBACA,gBACA,gBACA,uBACA,wBACA,eAAe,UACf,iBACA,aAAa,GACb,kBACA,WACA,cACA,cACA,mBACA,gBACA,aAAa,CAAC,eAAe,GAC7B,gBAAgB,MAChB,aAAa,GACb,kBAAkB,aAClB,iBACA,iBACA,kBACA,kBACA,sBACA,sBACA,WACA,WACA,kBACA,mBACA,gBACA,YACA,YACA,cACA,iBAAiB,kBACjB,oBACE;CAEJ,MAAM,SAAS,OAAO,UAAUC,cAAAA,oBAAoB;CACpD,MAAM,+BACJ,mBAAmB,YAAY,OAAO,cAAc,OAChD;EACA,GAAG;EACH,YAAY,OAAO,eAAe;CACpC,IACE;CAEN,MAAM,mBAA4C;EAChD,OAAOC,eAAAA;EACP,MAAMC,eAAAA;EACN,QAAQC,eAAAA;EACR,QAAQC,eAAAA;EACR,MAAMC,eAAAA;CACR;CAEA,IAAI,mBAAmB,YAAY,mBAAmB,UACpD,iBAAiB,UAAUC,eAAAA;CAG7B,MAAM,aAAa;EACjB,MAAM;EACN,YAAY;EACZ,UAAU,CAAC,OAAO;CACpB;CAEA,MAAM,YAAYC,eAAAA,gBAAgB;EAChC;EACA;EACA;EACA;EACA;EACA;EACA,qBAAqB;EACrB;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;;CAGD,IAAI;CAEJ,IAAI,oBAAoB,UACtB,kBAAkBC,uBAAAA,oBAAoB;EACpC,GAAG;EACH,QAAQ;EACR,SAAS,kBAAkB,sBAAsB;EACjD;CACF,CAAC;MACI,IAAI,oBAAoB,UAC7B,kBAAkBC,uBAAAA,oBAAoB;EACpC,GAAG;EACH,QACE,sBAAsB,UACtB,gBACA,QAAQ,IAAI;EACd,QAAQ,sBAAsB,UAAU;EACxC,SAAS,kBAAkB,sBAAsB;EACjD;CACF,CAAC;MACI,IAAI,oBAAoB,OAC7B,kBAAkBC,oBAAAA,iBAAiB;EACjC,GAAG;EACH,QAAQ,mBAAmB,UAAU,aAAa,QAAQ,IAAI;EAC9D,QAAQ,mBAAmB,UAAU;EACrC,SAAS,kBAAkB,mBAAmB;EAC9C,SAAS,mBAAmB,WAAW,CAAC,YAAY,SAAS;EAC7D;CACF,CAAC;MACI,IAAI,oBAAoB,YAC7B,kBAAkBC,yBAAAA,sBAAsB;EACtC,GAAG;EACH,QAAQ,wBAAwB,UAAU;EAC1C,SAAS,kBAAkB,wBAAwB;EACnD,kBACE,wBAAwB,oBACxB,uBAAuB;EACzB;CACF,CAAC;MAED,kBAAkBC,kBAAAA,uBAAuB;EACvC,GAAG;EACH,QAAQ,mBAAmB,QAAQ,IAAI;EACvC,QAAQ;EACR,SAAS;EACT,SAAS,kBAAkB,kBAAkB;EAC7C,SAAS,kBAAkB,WAAW,CAAC,YAAY,SAAS;EAC5D;CACF,CAAC;CAGH,MAAM,mBAAmBC,kBAAAA,eAAe;EACtC;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;CAED,IAAI,CAAC,kBACH,OAAO,KAAK,8CAA8C;CAG5D,MAAM,kBAAkBC,eAAAA,sBACtB;EACE,UAAU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;CACF,GACA,eACF;CAoBA,OAAO,WAAW;EAChB,QAnBa,sBAAsB;GACnC;GACA;GAGA,gBAAgB,mBAAmB;GACnC,gBACE,mBAAmB,YACnB,mBAAmB,cACnB,mBAAmB;GACrB,cAAc,mBAAmB;GACjC;GACA;GACA;GACA;GACA;EACF,CAGO;EACL,QAAQ;EACR;EACA,iBAAiB;CACnB,CAAC;AACH"}
+{"version":3,"file":"tool.cjs","names":["expandHighlights","params","formatResultsForLLM","WebSearchToolName","WebSearchToolDescription","createDefaultLogger","INTENT_PROPERTY","querySchema","dateSchema","imagesSchema","videosSchema","newsSchema","countrySchema","createSearchAPI","createSerperScraper","createTavilyScraper","createCrwScraper","createKeenableScraper","createFirecrawlScraper","createReranker","createSourceProcessor"],"sources":["../../../../src/tools/search/tool.ts"],"sourcesContent":["import { tool, DynamicStructuredTool } from '@langchain/core/tools';\nimport type { RunnableConfig } from '@langchain/core/runnables';\nimport type * as t from './types';\nimport {\n  WebSearchToolDescription,\n  WebSearchToolName,\n  countrySchema,\n  imagesSchema,\n  videosSchema,\n  querySchema,\n  dateSchema,\n  newsSchema,\n  DATE_RANGE,\n} from './schema';\nimport { createSearchAPI, createSourceProcessor } from './search';\nimport { createKeenableScraper } from './keenable-scraper';\nimport { createSerperScraper } from './serper-scraper';\nimport { createTavilyScraper } from './tavily-scraper';\nimport { createFirecrawlScraper } from './firecrawl';\nimport { INTENT_PROPERTY } from '@/tools/intentArg';\nimport { createCrwScraper } from './crw-scraper';\nimport { expandHighlights } from './highlights';\nimport { formatResultsForLLM } from './format';\nimport { createDefaultLogger } from './utils';\nimport { createReranker } from './rerankers';\nimport { Constants } from '@/common';\n\n/**\n * Settled label for a `web_search` call's intent (see `intentArg.ts`).\n *\n * Counts the result kinds `formatResultsForLLM` actually renders —\n * `references` only tracks links embedded in extracted highlights, so it\n * undercounts ordinary results and can overcount when one highlight embeds\n * several links.\n *\n * A caught provider or processing failure is reported through `data.error`\n * while the tool still returns NORMALLY, so that case must author its own\n * label: the `ToolMessage` carries success status, so without an authored\n * outcome the in-flight intent (\"Searching…\") would stand as the settled\n * label and present a failed search as an ordinary one.\n *\n * Returns undefined for a genuine zero-result search, leaving the\n * model-authored intent to stand unchanged as the label.\n */\nexport function resolveSearchOutcome(\n  data: t.SearchResultData,\n  query: string\n): string | undefined {\n  if (data.error != null && data.error !== '') {\n    return `Search failed for \"${query}\"`;\n  }\n  const count =\n    (data.organic?.length ?? 0) +\n    (data.topStories?.length ?? 0) +\n    (data.news?.length ?? 0) +\n    (data.images?.length ?? 0) +\n    (data.videos?.length ?? 0) +\n    (data.places?.length ?? 0) +\n    (data.peopleAlsoAsk?.length ?? 0) +\n    (data.knowledgeGraph != null ? 1 : 0) +\n    (data.answerBox != null ? 1 : 0);\n  if (count === 0) {\n    return undefined;\n  }\n  return `Found ${count} result${count === 1 ? '' : 's'} for \"${query}\"`;\n}\n\n/**\n * Executes parallel searches and merges the results,\n * deduplicating top stories by link\n */\nexport async function executeParallelSearches({\n  searchAPI,\n  query,\n  date,\n  country,\n  safeSearch,\n  images,\n  videos,\n  news,\n  logger,\n}: {\n  searchAPI: ReturnType<typeof createSearchAPI>;\n  query: string;\n  date?: DATE_RANGE;\n  country?: string;\n  safeSearch: t.SearchToolConfig['safeSearch'];\n  images: boolean;\n  videos: boolean;\n  news: boolean;\n  logger: t.Logger;\n}): Promise<t.SearchResult> {\n  // Prepare all search tasks to run in parallel\n  const searchTasks: Promise<t.SearchResult>[] = [\n    // Main search\n    searchAPI.getSources({\n      query,\n      date,\n      country,\n      safeSearch,\n    }),\n  ];\n\n  if (images) {\n    searchTasks.push(\n      searchAPI\n        .getSources({\n          query,\n          date,\n          country,\n          safeSearch,\n          type: 'images',\n        })\n        .catch((error) => {\n          logger.error('Error fetching images:', error);\n          return {\n            success: false,\n            error: `Images search failed: ${error instanceof Error ? error.message : String(error)}`,\n          };\n        })\n    );\n  }\n  if (videos) {\n    searchTasks.push(\n      searchAPI\n        .getSources({\n          query,\n          date,\n          country,\n          safeSearch,\n          type: 'videos',\n        })\n        .catch((error) => {\n          logger.error('Error fetching videos:', error);\n          return {\n            success: false,\n            error: `Videos search failed: ${error instanceof Error ? error.message : String(error)}`,\n          };\n        })\n    );\n  }\n  if (news) {\n    searchTasks.push(\n      searchAPI\n        .getSources({\n          query,\n          date,\n          country,\n          safeSearch,\n          type: 'news',\n        })\n        .catch((error) => {\n          logger.error('Error fetching news:', error);\n          return {\n            success: false,\n            error: `News search failed: ${error instanceof Error ? error.message : String(error)}`,\n          };\n        })\n    );\n  }\n\n  // Run all searches in parallel\n  const results = await Promise.all(searchTasks);\n\n  // Get the main search result (first result)\n  const mainResult = results[0];\n  if (!mainResult.success) {\n    throw new Error(mainResult.error ?? 'Search failed');\n  }\n\n  // Merge additional results with the main results\n  const mergedResults = { ...mainResult.data };\n\n  // Convert existing news to topStories if present\n  if (mergedResults.news !== undefined && mergedResults.news.length > 0) {\n    const existingNewsAsTopStories = mergedResults.news\n      .filter((newsItem) => newsItem.link !== undefined && newsItem.link !== '')\n      .map((newsItem) => ({\n        title: newsItem.title ?? '',\n        link: newsItem.link ?? '',\n        source: newsItem.source ?? '',\n        date: newsItem.date ?? '',\n        imageUrl: newsItem.imageUrl ?? '',\n        processed: false,\n      }));\n    mergedResults.topStories = [\n      ...(mergedResults.topStories ?? []),\n      ...existingNewsAsTopStories,\n    ];\n    delete mergedResults.news;\n  }\n\n  results.slice(1).forEach((result) => {\n    if (result.success && result.data !== undefined) {\n      if (result.data.images !== undefined && result.data.images.length > 0) {\n        mergedResults.images = [\n          ...(mergedResults.images ?? []),\n          ...result.data.images,\n        ];\n      }\n      if (result.data.videos !== undefined && result.data.videos.length > 0) {\n        mergedResults.videos = [\n          ...(mergedResults.videos ?? []),\n          ...result.data.videos,\n        ];\n      }\n      if (result.data.news !== undefined && result.data.news.length > 0) {\n        const newsAsTopStories = result.data.news.map((newsItem) => ({\n          ...newsItem,\n          link: newsItem.link ?? '',\n        }));\n        mergedResults.topStories = [\n          ...(mergedResults.topStories ?? []),\n          ...newsAsTopStories,\n        ];\n      }\n    }\n  });\n\n  if (\n    mergedResults.topStories !== undefined &&\n    mergedResults.topStories.length > 1\n  ) {\n    /** The main search's own news results and the parallel news sub-search\n     * frequently return the same stories — keep the first occurrence of each\n     * link so duplicates aren't scraped, reranked, and formatted repeatedly */\n    const seenLinks = new Set<string>();\n    mergedResults.topStories = mergedResults.topStories.filter((story) => {\n      if (!story.link || seenLinks.has(story.link)) {\n        return false;\n      }\n      seenLinks.add(story.link);\n      return true;\n    });\n  }\n\n  return { success: true, data: mergedResults };\n}\n\nfunction createSearchProcessor({\n  searchAPI,\n  safeSearch,\n  supportsImages,\n  supportsVideos,\n  supportsNews,\n  sourceProcessor,\n  onGetHighlights,\n  mainExpandBy,\n  separatorExpandBy,\n  logger,\n}: {\n  safeSearch: t.SearchToolConfig['safeSearch'];\n  supportsImages: boolean;\n  supportsVideos: boolean;\n  supportsNews: boolean;\n  searchAPI: ReturnType<typeof createSearchAPI>;\n  sourceProcessor: ReturnType<typeof createSourceProcessor>;\n  onGetHighlights: t.SearchToolConfig['onGetHighlights'];\n  mainExpandBy: t.SearchToolConfig['mainExpandBy'];\n  separatorExpandBy: t.SearchToolConfig['separatorExpandBy'];\n  logger: t.Logger;\n}) {\n  return async function ({\n    query,\n    date,\n    country,\n    proMode = true,\n    maxSources = 5,\n    onSearchResults,\n    images = false,\n    videos = false,\n    news = false,\n  }: {\n    query: string;\n    country?: string;\n    date?: DATE_RANGE;\n    proMode?: boolean;\n    maxSources?: number;\n    onSearchResults: t.SearchToolConfig['onSearchResults'];\n    images?: boolean;\n    videos?: boolean;\n    news?: boolean;\n  }): Promise<t.SearchResultData> {\n    try {\n      // Execute parallel searches and merge results\n      const searchResult = await executeParallelSearches({\n        searchAPI,\n        query,\n        date,\n        country,\n        safeSearch,\n        images: supportsImages && images,\n        videos: supportsVideos && videos,\n        news: supportsNews && news,\n        logger,\n      });\n\n      onSearchResults?.(searchResult);\n\n      const processedSources = await sourceProcessor.processSources({\n        query,\n        news,\n        result: searchResult,\n        proMode,\n        onGetHighlights,\n        numElements: maxSources,\n      });\n\n      return expandHighlights(\n        processedSources,\n        mainExpandBy,\n        separatorExpandBy\n      );\n    } catch (error) {\n      logger.error('Error in search:', error);\n      return {\n        organic: [],\n        topStories: [],\n        images: [],\n        videos: [],\n        news: [],\n        relatedSearches: [],\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  };\n}\n\nfunction createOnSearchResults({\n  runnableConfig,\n  onSearchResults,\n}: {\n  runnableConfig: RunnableConfig;\n  onSearchResults: t.SearchToolConfig['onSearchResults'];\n}) {\n  return function (results: t.SearchResult): void {\n    if (!onSearchResults) {\n      return;\n    }\n    onSearchResults(results, runnableConfig);\n  };\n}\n\nfunction createTool({\n  schema,\n  search,\n  maxOutputChars,\n  onSearchResults: _onSearchResults,\n}: {\n  schema: Record<string, unknown>;\n  search: ReturnType<typeof createSearchProcessor>;\n  maxOutputChars?: number;\n  onSearchResults: t.SearchToolConfig['onSearchResults'];\n}): DynamicStructuredTool {\n  return tool(\n    async (rawParams, runnableConfig) => {\n      const params = rawParams as SearchToolParams;\n      const { query, date, country: _c, images, videos, news } = params;\n      const country = typeof _c === 'string' && _c ? _c : undefined;\n      const searchResult = await search({\n        query,\n        date,\n        country,\n        images,\n        videos,\n        news,\n        onSearchResults: createOnSearchResults({\n          runnableConfig,\n          onSearchResults: _onSearchResults,\n        }),\n      });\n      const turn = runnableConfig.toolCall?.turn ?? 0;\n      const { output, references } = formatResultsForLLM(\n        turn,\n        searchResult,\n        maxOutputChars\n      );\n      const data: t.SearchResultData = { turn, ...searchResult, references };\n      const outcome = resolveSearchOutcome(data, query);\n      return [\n        output,\n        { [Constants.WEB_SEARCH]: data, ...(outcome != null && { outcome }) },\n      ];\n    },\n    {\n      name: WebSearchToolName,\n      description: WebSearchToolDescription,\n      schema: schema,\n      responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    }\n  );\n}\n\n/**\n * Creates a search tool with configurable search and scraper providers.\n *\n * Search providers: Serper (Google results), SearXNG (self-hosted meta-search), Tavily (AI-optimized), fastCRW (Firecrawl-compatible, self-host or cloud).\n * Scraper providers: Firecrawl (default, full-featured), Serper (lightweight), Tavily (batch extraction), fastCRW (Firecrawl-compatible, self-host or cloud).\n *\n * The country schema field is exposed to the LLM for providers that support localized results.\n */\n/** Input params type for search tool */\ninterface SearchToolParams {\n  query: string;\n  date?: DATE_RANGE;\n  country?: string;\n  images?: boolean;\n  videos?: boolean;\n  news?: boolean;\n}\n\nexport const createSearchTool = (\n  config: t.SearchToolConfig = {}\n): DynamicStructuredTool => {\n  const {\n    searchProvider = 'serper',\n    serperApiKey,\n    searxngInstanceUrl,\n    searxngApiKey,\n    tavilyApiKey,\n    tavilySearchUrl,\n    tavilyExtractUrl,\n    tavilySearchOptions,\n    keenableApiKey,\n    keenableApiUrl,\n    keenableSearchOptions,\n    keenableScraperOptions,\n    rerankerType = 'cohere',\n    rerankerTimeout,\n    topResults = 5,\n    maxContentLength,\n    chunkSize,\n    chunkOverlap,\n    mainExpandBy,\n    separatorExpandBy,\n    maxOutputChars,\n    strategies = ['no_extraction'],\n    filterContent = true,\n    safeSearch = 1,\n    scraperProvider = 'firecrawl',\n    firecrawlApiKey,\n    firecrawlApiUrl,\n    firecrawlVersion,\n    firecrawlOptions,\n    serperScraperOptions,\n    tavilyScraperOptions,\n    crwApiKey,\n    crwApiUrl,\n    crwSearchOptions,\n    crwScraperOptions,\n    scraperTimeout,\n    jinaApiKey,\n    jinaApiUrl,\n    cohereApiKey,\n    onSearchResults: _onSearchResults,\n    onGetHighlights,\n  } = config;\n\n  const logger = config.logger || createDefaultLogger();\n  const effectiveTavilySearchOptions =\n    searchProvider === 'tavily' && config.safeSearch != null\n      ? {\n        ...tavilySearchOptions,\n        safeSearch: config.safeSearch !== 0,\n      }\n      : tavilySearchOptions;\n\n  const schemaProperties: Record<string, unknown> = {\n    intent: { ...INTENT_PROPERTY },\n    query: querySchema,\n    date: dateSchema,\n    images: imagesSchema,\n    videos: videosSchema,\n    news: newsSchema,\n  };\n\n  if (searchProvider === 'serper' || searchProvider === 'tavily') {\n    schemaProperties.country = countrySchema;\n  }\n\n  const toolSchema = {\n    type: 'object',\n    properties: schemaProperties,\n    required: ['query'],\n  };\n\n  const searchAPI = createSearchAPI({\n    searchProvider,\n    serperApiKey,\n    searxngInstanceUrl,\n    searxngApiKey,\n    tavilyApiKey,\n    tavilySearchUrl,\n    tavilySearchOptions: effectiveTavilySearchOptions,\n    keenableApiKey,\n    keenableApiUrl,\n    keenableSearchOptions,\n    crwApiKey,\n    crwApiUrl,\n    crwSearchOptions,\n  });\n\n  /** Create scraper based on scraperProvider */\n  let scraperInstance: t.BaseScraper;\n\n  if (scraperProvider === 'serper') {\n    scraperInstance = createSerperScraper({\n      ...serperScraperOptions,\n      apiKey: serperApiKey,\n      timeout: scraperTimeout ?? serperScraperOptions?.timeout,\n      logger,\n    });\n  } else if (scraperProvider === 'tavily') {\n    scraperInstance = createTavilyScraper({\n      ...tavilyScraperOptions,\n      apiKey:\n        tavilyScraperOptions?.apiKey ??\n        tavilyApiKey ??\n        process.env.TAVILY_API_KEY,\n      apiUrl: tavilyScraperOptions?.apiUrl ?? tavilyExtractUrl,\n      timeout: scraperTimeout ?? tavilyScraperOptions?.timeout,\n      logger,\n    });\n  } else if (scraperProvider === 'crw') {\n    scraperInstance = createCrwScraper({\n      ...crwScraperOptions,\n      apiKey: crwScraperOptions?.apiKey ?? crwApiKey ?? process.env.CRW_API_KEY,\n      apiUrl: crwScraperOptions?.apiUrl ?? crwApiUrl,\n      timeout: scraperTimeout ?? crwScraperOptions?.timeout,\n      formats: crwScraperOptions?.formats ?? ['markdown', 'rawHtml'],\n      logger,\n    });\n  } else if (scraperProvider === 'keenable') {\n    scraperInstance = createKeenableScraper({\n      ...keenableScraperOptions,\n      apiKey: keenableScraperOptions?.apiKey ?? keenableApiKey,\n      timeout: scraperTimeout ?? keenableScraperOptions?.timeout,\n      attributionTitle:\n        keenableScraperOptions?.attributionTitle ??\n        keenableSearchOptions?.attributionTitle,\n      logger,\n    });\n  } else {\n    scraperInstance = createFirecrawlScraper({\n      ...firecrawlOptions,\n      apiKey: firecrawlApiKey ?? process.env.FIRECRAWL_API_KEY,\n      apiUrl: firecrawlApiUrl,\n      version: firecrawlVersion,\n      timeout: scraperTimeout ?? firecrawlOptions?.timeout,\n      formats: firecrawlOptions?.formats ?? ['markdown', 'rawHtml'],\n      logger,\n    });\n  }\n\n  const selectedReranker = createReranker({\n    rerankerType,\n    jinaApiKey,\n    jinaApiUrl,\n    cohereApiKey,\n    rerankerTimeout,\n    logger,\n  });\n\n  if (!selectedReranker) {\n    logger.warn('No reranker selected. Using default ranking.');\n  }\n\n  const sourceProcessor = createSourceProcessor(\n    {\n      reranker: selectedReranker,\n      topResults,\n      maxContentLength,\n      chunkSize,\n      chunkOverlap,\n      strategies,\n      filterContent,\n      logger,\n    },\n    scraperInstance\n  );\n\n  const search = createSearchProcessor({\n    searchAPI,\n    safeSearch,\n    // Keenable is organic-only: its API ignores `type`, so image/news\n    // sub-searches would spend rate limit and merge nothing.\n    supportsImages: searchProvider !== 'keenable',\n    supportsVideos:\n      searchProvider !== 'tavily' &&\n      searchProvider !== 'keenable' &&\n      searchProvider !== 'crw',\n    supportsNews: searchProvider !== 'keenable',\n    sourceProcessor,\n    onGetHighlights,\n    mainExpandBy,\n    separatorExpandBy,\n    logger,\n  });\n\n  return createTool({\n    search,\n    schema: toolSchema,\n    maxOutputChars,\n    onSearchResults: _onSearchResults,\n  });\n};\n"],"mappings":"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"}

package/dist/cjs/tools/subagent/SubagentExecutor.cjs

@@ -652,6 +652,7 @@ function sanitizeProcessedToolCall(toolCall) {
 	assignString(sanitized, "name", call.name);
 	if (call.args !== void 0) sanitized.args = call.args;
 	assignString(sanitized, "output", call.output);
+	assignString(sanitized, "outcome", call.outcome);
 	assignNumber(sanitized, "progress", call.progress);
 	return sanitized;
 }

package/dist/cjs/tools/subagent/SubagentExecutor.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"SubagentExecutor.cjs","names":["executeHooks","HumanMessage","BaseCallbackHandler","event","req","step"],"sources":["../../../../src/tools/subagent/SubagentExecutor.ts"],"sourcesContent":["import { nanoid } from 'nanoid';\nimport { HumanMessage } from '@langchain/core/messages';\nimport { BaseCallbackHandler } from '@langchain/core/callbacks/base';\nimport type { BaseMessage, UsageMetadata } from '@langchain/core/messages';\nimport type { ChatGeneration, LLMResult } from '@langchain/core/outputs';\nimport type { Callbacks } from '@langchain/core/callbacks/manager';\nimport type {\n  AgentInputs,\n  InjectedMessage,\n  MessageDeltaEvent,\n  ProcessedToolCall,\n  ReasoningDeltaEvent,\n  RunStep,\n  RunStepDeltaEvent,\n  StandardGraphInput,\n  ResolvedSubagentConfig,\n  StepCompleted,\n  SubagentConfig,\n  SubagentUpdateEvent,\n  SubagentUpdatePhase,\n  SubagentUsageSink,\n  ToolExecuteBatchRequest,\n  ToolCallDelta,\n  TokenCounter,\n} from '@/types';\nimport type { AggregatedHookResult, HookRegistry } from '@/hooks';\nimport type { AgentContext } from '@/agents/AgentContext';\nimport type { StandardGraph } from '@/graphs/Graph';\nimport type { HandlerRegistry } from '@/events';\nimport { Constants, GraphEvents, Callback, StepTypes } from '@/common';\nimport { executeHooks } from '@/hooks';\n\nconst DEFAULT_MAX_TURNS = 25;\nconst RECURSION_MULTIPLIER = 3;\nconst ERROR_MESSAGE_MAX_CHARS = 200;\nconst MAX_PENDING_SUBAGENT_UPDATES = 64;\n\nconst HOOK_FALLBACK: AggregatedHookResult = Object.freeze({\n  additionalContexts: [] as string[],\n  injectedMessages: [] as InjectedMessage[],\n  errors: [] as string[],\n});\n\ntype SanitizedSubagentToolCall = {\n  id: string;\n  name: string;\n  args?: ToolExecuteBatchRequest['toolCalls'][number]['args'];\n};\n\ntype SanitizedSubagentToolExecuteData = {\n  toolCalls: SanitizedSubagentToolCall[];\n  agentId?: string;\n};\n\ntype SanitizedRunStep = Partial<\n  Pick<\n    RunStep,\n    | 'agentId'\n    | 'groupId'\n    | 'id'\n    | 'index'\n    | 'runId'\n    | 'stepIndex'\n    | 'summary'\n    | 'type'\n    | 'usage'\n  >\n> & {\n  stepDetails?: SanitizedStepDetails;\n};\n\ntype SanitizedStepDetails =\n  | {\n      type: StepTypes.MESSAGE_CREATION;\n      message_creation?: {\n        message_id?: string;\n      };\n    }\n  | {\n      type: StepTypes.TOOL_CALLS;\n      tool_calls?: SanitizedAgentToolCall[];\n    };\n\ntype SanitizedAgentToolCall = {\n  id?: string;\n  name?: string;\n  args?: string | object;\n  type?: string;\n  function?: {\n    name?: string;\n    arguments?: string | object;\n  };\n};\n\ntype SanitizedRunStepDelta = Partial<Pick<RunStepDeltaEvent, 'id'>> & {\n  delta?: SanitizedToolCallDelta;\n};\n\ntype SanitizedToolCallDelta = Partial<\n  Pick<ToolCallDelta, 'auth' | 'expires_at' | 'summary' | 'type'>\n> & {\n  tool_calls?: SanitizedAgentToolCall[];\n};\n\ntype SanitizedStepCompleted =\n  | {\n      id?: string;\n      index?: number;\n      type: 'tool_call';\n      tool_call?: SanitizedProcessedToolCall;\n    }\n  | {\n      type: 'summary';\n      summary?: Extract<StepCompleted, { type: 'summary' }>['summary'];\n    };\n\ntype SanitizedProcessedToolCall = Partial<\n  Pick<ProcessedToolCall, 'args' | 'id' | 'name' | 'output' | 'progress'>\n>;\n\ntype SanitizedRunStepCompleted = {\n  result?: SanitizedStepCompleted;\n};\n\ntype SanitizedMessageDelta = Partial<Pick<MessageDeltaEvent, 'id'>> & {\n  delta?: {\n    content?: MessageDeltaEvent['delta']['content'];\n    tool_call_ids?: MessageDeltaEvent['delta']['tool_call_ids'];\n  };\n};\n\ntype SanitizedReasoningDelta = Partial<Pick<ReasoningDeltaEvent, 'id'>> & {\n  delta?: {\n    content?: ReasoningDeltaEvent['delta']['content'];\n  };\n};\n\ntype QueuedSubagentUpdate = {\n  eventName: string;\n  phase: SubagentUpdatePhase;\n  data: unknown;\n};\n\ntype ForwarderCallback = {\n  handler: BaseCallbackHandler;\n  drain: () => Promise<void>;\n};\n\nconst LANGGRAPH_RUNTIME_CONFIG_PREFIX = '__pregel_';\nconst LANGGRAPH_CHECKPOINT_CONFIG_KEYS = new Set([\n  'checkpoint_id',\n  'checkpoint_map',\n  'checkpoint_ns',\n]);\n\nexport type SubagentExecuteParams = {\n  description: string;\n  subagentType: string;\n  threadId?: string;\n  /**\n   * Parent-side `tool_call_id` of the `subagent` tool invocation that\n   * triggered this execution. Surfaced on {@link SubagentUpdateEvent} so\n   * hosts can correlate child updates back to the originating tool call\n   * without relying on event ordering heuristics.\n   */\n  parentToolCallId?: string;\n  /**\n   * Snapshot of the parent invocation's host `config.configurable` at\n   * the spawn-tool call site. Host-set fields (`requestBody`, `user`,\n   * `userMCPAuthMap`, etc.) propagate into the child workflow's\n   * `configurable` — fixing MCP body-placeholder substitution and\n   * per-user lookups for subagent tool calls. LangGraph runtime keys\n   * (`__pregel_*`, checkpoint bookkeeping) are intentionally not\n   * inherited; the child graph recreates its own runtime config.\n   *\n   * Inheritance details (verified empirically against LangGraph):\n   *   - host-set keys propagate as-is into the child's tool dispatches;\n   *   - `thread_id` propagates (with `childRunId` as a fallback when\n   *     parent did not supply one) — matches the \"subagent is part of\n   *     the same conversation\" mental model and aligns with the\n   *     `sessionId: this.parentRunId` convention this executor already\n   *     uses for `SubagentStart` / `SubagentStop` hooks;\n   *   - `parent_run_id` propagates when the host put it on parent's\n   *     configurable;\n   *   - `run_id` is *overwritten by the LangGraph runtime* at child\n   *     invoke time regardless of what we forward — child's tool\n   *     dispatches see the child graph's runtime runId in\n   *     `configurable.run_id`, not the parent's. Hosts that need\n   *     parent-scoped run identity for downstream consumers should\n   *     plumb it via a host-defined key (e.g. `requestBody.messageId`),\n   *     not `run_id`.\n   *\n   * A future revision will likely make this inheritance configurable\n   * per spawn type — background / async subagents may want isolation\n   * rather than sharing parent's host context.\n   */\n  parentConfigurable?: Record<string, unknown>;\n};\n\nexport type SubagentExecuteResult = {\n  content: string;\n  messages: BaseMessage[];\n};\n\n/**\n * Factory that constructs a child graph for subagent execution. Injected\n * rather than imported so that `SubagentExecutor` does not have a runtime\n * dependency on `StandardGraph` — this avoids a circular dependency between\n * `src/graphs/Graph.ts` and `src/tools/subagent/` that would otherwise break\n * Rollup's chunking under `preserveModules`.\n */\nexport type ChildGraphFactory = (input: StandardGraphInput) => StandardGraph;\n\nexport type SubagentExecutorOptions = {\n  configs: Map<string, ResolvedSubagentConfig>;\n  parentSignal?: AbortSignal;\n  hookRegistry?: HookRegistry;\n  parentRunId: string;\n  parentAgentId?: string;\n  langfuse?: StandardGraphInput['langfuse'];\n  tokenCounter?: TokenCounter;\n  /** Remaining nesting budget. 0 or negative blocks execution. */\n  maxDepth?: number;\n  /**\n   * Factory for constructing the isolated child graph. Callers pass\n   * `(input) => new StandardGraph(input)` — injected to break a circular\n   * module dependency.\n   */\n  createChildGraph: ChildGraphFactory;\n  /**\n   * Parent's event handler registry. When provided, child-graph events are\n   * forwarded through this registry so hosts can:\n   *   (a) execute event-driven tools (`ON_TOOL_EXECUTE` routed to parent's handler),\n   *   (b) surface child activity to a UI via wrapped {@link GraphEvents.ON_SUBAGENT_UPDATE}.\n   * When omitted, the child runs fully isolated (legacy behavior).\n   *\n   * Can be a direct `HandlerRegistry` or a zero-arg getter — use the getter\n   * form when the registry is assigned to the graph AFTER the executor is\n   * constructed (the current `Run.create` flow sets `handlerRegistry`\n   * post-`createWorkflow`, so `createAgentNode` must capture lazily).\n   */\n  parentHandlerRegistry?: HandlerRegistry | (() => HandlerRegistry | undefined);\n  /**\n   * Receives a usage event for every model call the child run makes. The\n   * child workflow executes via `invoke()` with a detached callbacks array,\n   * so its `on_chat_model_end` events never reach the parent's handler\n   * registry — without this sink, child token usage is invisible to the\n   * host (unbilled model calls). Forwarded into the child graph's input so\n   * nested subagents report through the same sink.\n   */\n  usageSink?: SubagentUsageSink;\n};\n\nexport class SubagentExecutor {\n  private readonly configs: Map<string, ResolvedSubagentConfig>;\n  private readonly parentSignal?: AbortSignal;\n  private readonly hookRegistry?: HookRegistry;\n  private readonly parentRunId: string;\n  private readonly parentAgentId?: string;\n  private readonly langfuse?: StandardGraphInput['langfuse'];\n  private readonly tokenCounter?: TokenCounter;\n  private readonly maxDepth: number;\n  private readonly createChildGraph: ChildGraphFactory;\n  private readonly usageSink?: SubagentUsageSink;\n  private readonly resolveParentHandlerRegistry?: () =>\n    | HandlerRegistry\n    | undefined;\n\n  constructor(options: SubagentExecutorOptions) {\n    this.configs = options.configs;\n    this.parentSignal = options.parentSignal;\n    this.hookRegistry = options.hookRegistry;\n    this.parentRunId = options.parentRunId;\n    this.parentAgentId = options.parentAgentId;\n    this.langfuse = options.langfuse;\n    this.tokenCounter = options.tokenCounter;\n    this.maxDepth = options.maxDepth ?? 1;\n    this.createChildGraph = options.createChildGraph;\n    this.usageSink = options.usageSink;\n    const rawRegistry = options.parentHandlerRegistry;\n    if (typeof rawRegistry === 'function') {\n      this.resolveParentHandlerRegistry = rawRegistry;\n    } else if (rawRegistry != null) {\n      this.resolveParentHandlerRegistry = (): HandlerRegistry => rawRegistry;\n    }\n  }\n\n  /** Snapshot of the parent's registry at the moment a subagent is dispatched. */\n  private getParentHandlerRegistry(): HandlerRegistry | undefined {\n    return this.resolveParentHandlerRegistry?.();\n  }\n\n  async execute(params: SubagentExecuteParams): Promise<SubagentExecuteResult> {\n    const { description, subagentType, threadId, parentToolCallId } = params;\n    const config = this.configs.get(subagentType);\n\n    if (!config) {\n      const available = [...this.configs.keys()].join(', ');\n      return {\n        content: `Error: Unknown subagent type \"${subagentType}\". Available types: ${available}`,\n        messages: [],\n      };\n    }\n\n    if (this.maxDepth <= 0) {\n      return {\n        content: 'Error: Maximum subagent nesting depth exceeded.',\n        messages: [],\n      };\n    }\n\n    const childAgentId =\n      config.agentInputs.agentId ||\n      `${this.parentAgentId ?? 'agent'}_sub_${nanoid(8)}`;\n\n    if (\n      this.hookRegistry?.hasHookFor('SubagentStart', this.parentRunId) === true\n    ) {\n      const hookResult = await executeHooks({\n        registry: this.hookRegistry,\n        input: {\n          hook_event_name: 'SubagentStart',\n          runId: this.parentRunId,\n          threadId,\n          parentAgentId: this.parentAgentId,\n          agentId: childAgentId,\n          agentType: subagentType,\n          inputs: [new HumanMessage(description)],\n        },\n        sessionId: this.parentRunId,\n        matchQuery: subagentType,\n      }).catch((): AggregatedHookResult => HOOK_FALLBACK);\n\n      /**\n       * `ask` is treated identically to `deny` in the subagent context:\n       * subagents are non-interactive, so there is no prompt path for `ask`.\n       * Both decisions block execution and return a \"Blocked\" tool result.\n       */\n      if (hookResult.decision === 'deny' || hookResult.decision === 'ask') {\n        return {\n          content: `Blocked: ${hookResult.reason ?? 'Blocked by hook'}`,\n          messages: [],\n        };\n      }\n    }\n\n    const parentRegistry = this.getParentHandlerRegistry();\n    const forwardingEnabled = parentRegistry != null;\n    /**\n     * Keep `toolDefinitions` only when the host has actually wired an\n     * `ON_TOOL_EXECUTE` handler. `Run` always constructs a `HandlerRegistry`,\n     * so treating any registry as \"forwarding enabled\" would leak\n     * `toolDefinitions` into children whose hosts cannot execute them — the\n     * child's `ToolNode` batch promise would hang forever with no handler to\n     * resolve/reject. Gating on the tool-execute handler preserves the\n     * recoverable \"no tools\" path for registry-but-no-handler configs.\n     */\n    const hasToolExecuteHandler =\n      parentRegistry?.getHandler(GraphEvents.ON_TOOL_EXECUTE) != null;\n    const childInputs = buildChildInputs(\n      config,\n      childAgentId,\n      this.maxDepth,\n      /* keepToolDefinitions */ hasToolExecuteHandler\n    );\n    const childRunId = `${this.parentRunId}_sub_${nanoid(8)}`;\n    const maxTurns = config.maxTurns ?? DEFAULT_MAX_TURNS;\n\n    const hostUsageSink = this.usageSink;\n    const childGraph = this.createChildGraph({\n      runId: childRunId,\n      signal: this.parentSignal,\n      agents: [childInputs],\n      langfuse: this.langfuse,\n      tokenCounter: this.tokenCounter,\n      subagentScope: true,\n      /**\n       * Forwarded so the child graph's own `SubagentExecutor` (created in\n       * its `createAgentNode` when `allowNested` keeps subagentConfigs)\n       * reports nested-child usage through the same host sink. Each nesting\n       * level attaches its own capture callback — `workflow.invoke` replaces\n       * the inherited callback chain, so a single top-level handler would\n       * never see grandchild model calls.\n       *\n       * The wrapper rewrites `runId` to THIS executor's parent run: nested\n       * executors emit with their own `parentRunId` (a `*_sub_*` child id),\n       * and each wrapper layer rewrites upward, so by the time an event\n       * reaches the host sink its `runId` is the ROOT run — hosts keying\n       * billing by run id never see intermediate child run ids there\n       * (`subagentRunId` still identifies the emitting child).\n       */\n      subagentUsageSink:\n        hostUsageSink == null\n          ? undefined\n          : /** Returns the host sink's result so async sinks stay awaited\n             *  through every wrapper layer. */\n          (event): void | Promise<void> =>\n            hostUsageSink({ ...event, runId: this.parentRunId }),\n    });\n\n    let forwarding: ForwarderCallback | undefined;\n    if (forwardingEnabled) {\n      forwarding = this.createForwarderCallback({\n        parentRegistry: parentRegistry!,\n        subagentType,\n        subagentAgentId: childAgentId,\n        childRunId,\n        parentToolCallId,\n      });\n    }\n    const forwarder = forwarding?.handler;\n\n    if (forwarder) {\n      await this.emitSubagentUpdate(parentRegistry!, {\n        childRunId,\n        subagentType,\n        subagentAgentId: childAgentId,\n        parentToolCallId,\n        phase: 'start',\n        label: `Subagent \"${subagentType}\" started`,\n      });\n    }\n\n    let result: { messages: BaseMessage[] };\n    try {\n      const workflow = childGraph.createWorkflow();\n      /**\n       * When `parentHandlerRegistry` is provided (forwarding mode), attach a\n       * lightweight callback that intercepts the child's `on_custom_event`\n       * dispatches and routes them to the parent's registry — either as\n       * operational events (ON_TOOL_EXECUTE) or wrapped ON_SUBAGENT_UPDATE\n       * envelopes. Native LangChain streaming events (on_chat_model_stream,\n       * etc.) still do NOT propagate to the parent's outer streamEvents\n       * iterator — the `callbacks` array REPLACES the inherited chain, so\n       * parent handlers won't receive child stream chunks and raise \"No\n       * agent context found\" lookups on the parent's agentContexts map.\n       *\n       * When no registry is provided (legacy isolation), `callbacks: []`\n       * fully detaches the child.\n       *\n       * `runName` gives the child a distinct LangSmith trace root (avoids\n       * nested trace pollution).\n       */\n      const callbackHandlers: BaseCallbackHandler[] = [];\n      if (forwarder) {\n        callbackHandlers.push(forwarder);\n      }\n      /**\n       * Usage capture rides the same detached callbacks array. Because\n       * `callbacks` REPLACES the inherited chain (see above), the host's\n       * `CHAT_MODEL_END` handler never observes the child's model calls —\n       * this handler is the child-side equivalent of `ModelEndHandler`,\n       * reporting per-call usage to the host's sink for billing.\n       */\n      if (this.usageSink) {\n        callbackHandlers.push(\n          createUsageCaptureHandler({\n            sink: this.usageSink,\n            subagentType,\n            subagentRunId: childRunId,\n            subagentAgentId: childAgentId,\n            parentRunId: this.parentRunId,\n            provider: config.agentInputs.provider,\n            fallbackModel: extractConfiguredModel(config.agentInputs),\n          })\n        );\n      }\n      const callbacks: Callbacks = callbackHandlers;\n      /**\n       * Inherit the parent's host `configurable` — host-set fields\n       * (`requestBody`, `user`, `userMCPAuthMap`, etc.) AND the run-\n       * identity fields (`run_id`, `parent_run_id`, `thread_id`) all\n       * propagate. LangGraph's own runtime keys are excluded because the\n       * child graph creates its own scratchpad/checkpoint/abort plumbing.\n       *\n       * Run-identity propagation is intentional and matches the\n       * convention this executor itself already uses for `SubagentStart`\n       * / `SubagentStop` hooks (`sessionId: this.parentRunId`): the\n       * subagent runs under the parent's session scope, not its own.\n       * Forwarding `run_id` / `parent_run_id` / `thread_id` makes\n       * `ToolNode`'s hook lookups (`hasHookFor(eventName, runId)`),\n       * `ToolOutputReferenceRegistry` keying, and trace lineage all\n       * resolve to the parent's session for tools dispatched from the\n       * subagent — so `PreToolUse` / `PostToolUse` hooks the host\n       * registered against the parent's run fire for subagent tool\n       * calls too. \"Same run\" matches the user-perceptual mental model.\n       *\n       * `thread_id` falls back to `childRunId` only when the parent\n       * didn't supply one (legacy behavior preserved for hosts that\n       * never set thread_id).\n       *\n       * NOTE: a future revision will likely make this configurable per\n       * spawn type — e.g. a background / async subagent that runs after\n       * the parent's run completes wants isolation, not inheritance.\n       * For now the inheritance path matches LibreChat's primary use\n       * case (synchronous subagents within a single user turn).\n       */\n      const inheritedConfigurable: Record<string, unknown> =\n        sanitizeChildConfigurable(params.parentConfigurable);\n      result = await workflow.invoke(\n        { messages: [new HumanMessage(description)] },\n        {\n          recursionLimit: maxTurns * RECURSION_MULTIPLIER,\n          signal: this.parentSignal,\n          callbacks,\n          runName: `subagent:${subagentType}`,\n          configurable: {\n            thread_id: childRunId,\n            ...inheritedConfigurable,\n          },\n        }\n      );\n    } catch (error) {\n      const errorMessage = truncateErrorMessage(error);\n      if (forwarding) {\n        await forwarding.drain();\n        await this.emitSubagentUpdate(parentRegistry!, {\n          childRunId,\n          subagentType,\n          subagentAgentId: childAgentId,\n          parentToolCallId,\n          phase: 'error',\n          label: `Subagent \"${subagentType}\" errored: ${errorMessage}`,\n          data: { message: errorMessage },\n        });\n      }\n      childGraph.clearHeavyState();\n      return {\n        content: `Subagent error: ${errorMessage}`,\n        messages: [],\n      };\n    }\n\n    const filteredContent = filterSubagentResult(result.messages);\n\n    if (\n      this.hookRegistry?.hasHookFor('SubagentStop', this.parentRunId) === true\n    ) {\n      /**\n       * Awaited (not fire-and-forget) for deterministic test synchronization\n       * and consistency with PostCompact. The parent is already waiting on the\n       * tool result, so the small extra latency is acceptable. Errors are\n       * swallowed — SubagentStop is observational.\n       */\n      await executeHooks({\n        registry: this.hookRegistry,\n        input: {\n          hook_event_name: 'SubagentStop',\n          runId: this.parentRunId,\n          threadId,\n          agentId: childAgentId,\n          agentType: subagentType,\n          messages: result.messages,\n        },\n        sessionId: this.parentRunId,\n        matchQuery: subagentType,\n      }).catch(() => {\n        /* SubagentStop is observational — swallow errors */\n      });\n    }\n\n    if (forwarding) {\n      await forwarding.drain();\n      await this.emitSubagentUpdate(parentRegistry!, {\n        childRunId,\n        subagentType,\n        subagentAgentId: childAgentId,\n        parentToolCallId,\n        phase: 'stop',\n        label: `Subagent \"${subagentType}\" finished`,\n      });\n    }\n\n    childGraph.clearHeavyState();\n\n    return { content: filteredContent, messages: result.messages };\n  }\n\n  /**\n   * Emits a single {@link GraphEvents.ON_SUBAGENT_UPDATE} envelope through the\n   * parent's handler registry. Silent no-op when no parent registry is set.\n   * Errors are swallowed — update events are observational.\n   */\n  private async emitSubagentUpdate(\n    parentRegistry: HandlerRegistry,\n    args: {\n      childRunId: string;\n      subagentType: string;\n      subagentAgentId: string;\n      parentToolCallId?: string;\n      phase: SubagentUpdatePhase;\n      data?: unknown;\n      label?: string;\n    }\n  ): Promise<void> {\n    const handler = parentRegistry.getHandler(GraphEvents.ON_SUBAGENT_UPDATE);\n    if (!handler) {\n      return;\n    }\n    const event: SubagentUpdateEvent = {\n      runId: this.parentRunId,\n      subagentRunId: args.childRunId,\n      subagentType: args.subagentType,\n      subagentAgentId: args.subagentAgentId,\n      parentAgentId: this.parentAgentId,\n      parentToolCallId: args.parentToolCallId,\n      phase: args.phase,\n      data: args.data,\n      label: args.label,\n      timestamp: new Date().toISOString(),\n    };\n    try {\n      await handler.handle(GraphEvents.ON_SUBAGENT_UPDATE, event);\n    } catch {\n      /* observational — swallow */\n    }\n  }\n\n  /**\n   * Builds a BaseCallbackHandler that intercepts the child graph's custom\n   * events. Routing rules:\n   *   - `ON_TOOL_EXECUTE` → forwarded as-is to the parent's ON_TOOL_EXECUTE\n   *     handler (so event-driven tools work identically for child and parent).\n   *   - `ON_RUN_STEP` / `ON_RUN_STEP_DELTA` / `ON_RUN_STEP_COMPLETED` /\n   *     `ON_MESSAGE_DELTA` / `ON_REASONING_DELTA` → wrapped in a\n   *     {@link GraphEvents.ON_SUBAGENT_UPDATE} envelope with a human-readable\n   *     label, delivered to the parent's subagent-update handler.\n   *   - Everything else → ignored (keeps parent's UI scoped to the events it\n   *     cares about; host apps can extend by registering more phases).\n   */\n  private createForwarderCallback(args: {\n    parentRegistry: HandlerRegistry;\n    subagentType: string;\n    subagentAgentId: string;\n    childRunId: string;\n    parentToolCallId?: string;\n  }): ForwarderCallback {\n    const {\n      parentRegistry,\n      subagentType,\n      subagentAgentId,\n      childRunId,\n      parentToolCallId,\n    } = args;\n    const parentRunId = this.parentRunId;\n    const parentAgentId = this.parentAgentId;\n\n    const wrap = async (\n      eventName: string,\n      phase: SubagentUpdatePhase,\n      data: unknown\n    ): Promise<void> => {\n      const handler = parentRegistry.getHandler(GraphEvents.ON_SUBAGENT_UPDATE);\n      if (!handler) {\n        return;\n      }\n      try {\n        const event: SubagentUpdateEvent = {\n          runId: parentRunId,\n          subagentRunId: childRunId,\n          subagentType,\n          subagentAgentId,\n          parentAgentId,\n          parentToolCallId,\n          phase,\n          data: sanitizeForwardedSubagentUpdateData(eventName, data),\n          label: summarizeEvent(eventName, data),\n          timestamp: new Date().toISOString(),\n        };\n        await handler.handle(GraphEvents.ON_SUBAGENT_UPDATE, event);\n      } catch {\n        /* observational — swallow */\n      }\n    };\n\n    const queuedUpdates: QueuedSubagentUpdate[] = [];\n    let drainPromise: Promise<void> | undefined;\n\n    const enqueue = (update: QueuedSubagentUpdate): void => {\n      if (queuedUpdates.length >= MAX_PENDING_SUBAGENT_UPDATES) {\n        const dropIndex = queuedUpdates.findIndex((queued) =>\n          isDroppableSubagentUpdatePhase(queued.phase)\n        );\n        if (dropIndex >= 0) {\n          queuedUpdates.splice(dropIndex, 1);\n        } else if (isDroppableSubagentUpdatePhase(update.phase)) {\n          return;\n        }\n      }\n      queuedUpdates.push(update);\n    };\n\n    const drain = async (): Promise<void> => {\n      if (drainPromise != null) {\n        await drainPromise;\n        return;\n      }\n      drainPromise = (async (): Promise<void> => {\n        while (queuedUpdates.length > 0) {\n          const update = queuedUpdates.shift();\n          if (update == null) {\n            continue;\n          }\n          await wrap(update.eventName, update.phase, update.data);\n        }\n      })();\n      try {\n        await drainPromise;\n      } finally {\n        drainPromise = undefined;\n        if (queuedUpdates.length > 0) {\n          await drain();\n        }\n      }\n    };\n\n    const scheduleWrap = (\n      eventName: string,\n      phase: SubagentUpdatePhase,\n      data: unknown\n    ): void => {\n      enqueue({ eventName, phase, data });\n      void drain();\n    };\n\n    const handler = BaseCallbackHandler.fromMethods({\n      [Callback.CUSTOM_EVENT]: async (\n        eventName: string,\n        data: unknown\n      ): Promise<void> => {\n        if (eventName === GraphEvents.ON_TOOL_EXECUTE) {\n          const toolHandler = parentRegistry.getHandler(\n            GraphEvents.ON_TOOL_EXECUTE\n          );\n          if (toolHandler) {\n            await toolHandler.handle(\n              GraphEvents.ON_TOOL_EXECUTE,\n              data as ToolExecuteBatchRequest\n            );\n          }\n          /**\n           * We also surface a short notice in the subagent-update stream so\n           * the UI can show \"calling <tool>\" for each tool the child spawns.\n           */\n          scheduleWrap(eventName, 'run_step', data);\n          return;\n        }\n\n        if (eventName === GraphEvents.ON_RUN_STEP) {\n          scheduleWrap(eventName, 'run_step', data);\n          return;\n        }\n        if (eventName === GraphEvents.ON_RUN_STEP_DELTA) {\n          scheduleWrap(eventName, 'run_step_delta', data);\n          return;\n        }\n        if (eventName === GraphEvents.ON_RUN_STEP_COMPLETED) {\n          scheduleWrap(eventName, 'run_step_completed', data);\n          return;\n        }\n        if (eventName === GraphEvents.ON_MESSAGE_DELTA) {\n          scheduleWrap(eventName, 'message_delta', data);\n          return;\n        }\n        if (eventName === GraphEvents.ON_REASONING_DELTA) {\n          scheduleWrap(eventName, 'reasoning_delta', data);\n          return;\n        }\n      },\n    });\n    /**\n     * `awaitHandlers = true` is required so the child's `ToolNode` actually\n     * blocks on the parent's `ON_TOOL_EXECUTE` handler until it resolves\n     * the batch request. Observational `ON_SUBAGENT_UPDATE` calls are queued\n     * behind a bounded sequential dispatcher so host UI publication cannot\n     * backpressure each child emission or run unbounded concurrent publishes.\n     * The executor drains this queue before terminal stop/error envelopes to\n     * preserve phase ordering.\n     */\n    handler.awaitHandlers = true;\n    return { handler, drain };\n  }\n}\n\n/**\n * Builds the child-run equivalent of a host `CHAT_MODEL_END` handler: a\n * callback that joins per-call model identity (captured from\n * `ls_model_name` at chat-model start) with the usage metadata reported at\n * LLM end, and emits a {@link SubagentUsageEvent} through the host's sink.\n *\n * Attached to the child `workflow.invoke` callbacks array, so it observes\n * every model call inside the child graph — the agent loop and any\n * auxiliary calls (e.g. child-side summarization). It does NOT observe\n * deeper subagent levels: each nesting level replaces the callback chain\n * and attaches its own capture handler via the forwarded\n * `subagentUsageSink` on the child graph's input.\n */\nfunction createUsageCaptureHandler(args: {\n  sink: SubagentUsageSink;\n  subagentType: string;\n  subagentRunId: string;\n  subagentAgentId: string;\n  parentRunId: string;\n  /**\n   * Child config's provider enum — the default tag when a call carries no\n   * `INVOKED_PROVIDER` metadata (hosts key pricing/cache semantics off it).\n   */\n  provider?: string;\n  /**\n   * Child config's model, used when a call carries neither `ls_model_name`\n   * nor `INVOKED_MODEL` metadata.\n   */\n  fallbackModel?: string;\n}): BaseCallbackHandler {\n  const {\n    sink,\n    subagentType,\n    subagentRunId,\n    subagentAgentId,\n    parentRunId,\n    provider,\n    fallbackModel,\n  } = args;\n  /**\n   * Per-call attribution keyed by LangChain callback runId. `model` joins\n   * `ls_model_name` (provider-reported) with `INVOKED_MODEL` (stamped by\n   * `tryFallbackProviders` from the fallback's client options); `provider`\n   * is `INVOKED_PROVIDER`, stamped by `attemptInvoke` with the SDK enum of\n   * the provider that ACTUALLY served the call — correct for\n   * fallback-served calls, where the static config provider would mis-tag\n   * pricing/cache semantics.\n   */\n  const callInfoByCallId = new Map<\n    string,\n    { model?: string; provider?: string }\n  >();\n  const handler = BaseCallbackHandler.fromMethods({\n    handleChatModelStart: (\n      _llm: unknown,\n      _messages: unknown,\n      runId: string,\n      _parentRunId?: string,\n      _extraParams?: Record<string, unknown>,\n      _tags?: string[],\n      metadata?: Record<string, unknown>\n    ): void => {\n      const callModel =\n        asNonEmptyString(metadata?.ls_model_name) ??\n        asNonEmptyString(metadata?.[Constants.INVOKED_MODEL]);\n      const callProvider = asNonEmptyString(\n        metadata?.[Constants.INVOKED_PROVIDER]\n      );\n      if (callModel != null || callProvider != null) {\n        callInfoByCallId.set(runId, {\n          model: callModel,\n          provider: callProvider,\n        });\n      }\n    },\n    handleLLMEnd: async (output: LLMResult, runId: string): Promise<void> => {\n      const callInfo = callInfoByCallId.get(runId);\n      callInfoByCallId.delete(runId);\n      const model = callInfo?.model ?? fallbackModel;\n      const callProvider = callInfo?.provider ?? provider;\n      for (const generationGroup of output.generations) {\n        /**\n         * At most ONE event per generation group: each group is one\n         * provider request (the outer array is per-prompt for batched\n         * calls), and with multiple completions (`n > 1`) every choice in\n         * a group repeats the request-level `usage_metadata` — emitting\n         * per choice would multiply billed tokens.\n         */\n        for (const generation of generationGroup) {\n          const message = (generation as ChatGeneration | undefined)?.message;\n          const usage = (\n            message as { usage_metadata?: UsageMetadata } | undefined\n          )?.usage_metadata;\n          if (usage == null) {\n            continue;\n          }\n          /**\n           * Awaited so async host sinks (billing/persistence) complete\n           * before the model call resolves — `awaitHandlers` only waits on\n           * `handleLLMEnd` itself, so a dropped promise here would let the\n           * parent run finish before usage is recorded and would turn sink\n           * rejections into unhandled rejections.\n           */\n          try {\n            await sink({\n              usage,\n              model,\n              provider: callProvider,\n              subagentType,\n              subagentRunId,\n              subagentAgentId,\n              runId: parentRunId,\n            });\n          } catch {\n            /* observational — a throwing/rejecting host sink must not break the child run */\n          }\n          break;\n        }\n      }\n    },\n    handleLLMError: (_err: unknown, runId: string): void => {\n      callInfoByCallId.delete(runId);\n    },\n  });\n  /**\n   * Dispatch usage synchronously with each model call so all entries are\n   * sunk before `workflow.invoke` resolves — hosts read their accumulator\n   * right after the parent run completes.\n   */\n  handler.awaitHandlers = true;\n  return handler;\n}\n\nfunction asNonEmptyString(value: unknown): string | undefined {\n  return typeof value === 'string' && value !== '' ? value : undefined;\n}\n\n/**\n * Best-effort read of the configured model from a subagent's client\n * options. Providers disagree on the key (`model` vs `modelName`), and the\n * value is only a fallback for calls that carry no `ls_model_name`.\n */\nfunction extractConfiguredModel(agentInputs: AgentInputs): string | undefined {\n  const clientOptions = agentInputs.clientOptions as\n    | { model?: unknown; modelName?: unknown }\n    | undefined;\n  if (typeof clientOptions?.model === 'string' && clientOptions.model !== '') {\n    return clientOptions.model;\n  }\n  if (\n    typeof clientOptions?.modelName === 'string' &&\n    clientOptions.modelName !== ''\n  ) {\n    return clientOptions.modelName;\n  }\n  return undefined;\n}\n\nfunction sanitizeChildConfigurable(\n  parentConfigurable: Record<string, unknown> | undefined\n): Record<string, unknown> {\n  if (parentConfigurable == null) {\n    return {};\n  }\n  return Object.fromEntries(\n    Object.entries(parentConfigurable).filter(\n      ([key]) => !isLangGraphRuntimeConfigKey(key)\n    )\n  );\n}\n\nfunction isLangGraphRuntimeConfigKey(key: string): boolean {\n  return (\n    key.startsWith(LANGGRAPH_RUNTIME_CONFIG_PREFIX) ||\n    LANGGRAPH_CHECKPOINT_CONFIG_KEYS.has(key)\n  );\n}\n\nexport function sanitizeForwardedSubagentUpdateData(\n  eventName: string,\n  data: unknown\n): unknown {\n  if (eventName === GraphEvents.ON_TOOL_EXECUTE) {\n    return sanitizeToolExecuteUpdateData(data);\n  }\n  if (eventName === GraphEvents.ON_RUN_STEP) {\n    return sanitizeRunStepUpdateData(data);\n  }\n  if (eventName === GraphEvents.ON_RUN_STEP_DELTA) {\n    return sanitizeRunStepDeltaUpdateData(data);\n  }\n  if (eventName === GraphEvents.ON_RUN_STEP_COMPLETED) {\n    return sanitizeRunStepCompletedUpdateData(data);\n  }\n  if (eventName === GraphEvents.ON_MESSAGE_DELTA) {\n    return sanitizeMessageDeltaUpdateData(data);\n  }\n  if (eventName === GraphEvents.ON_REASONING_DELTA) {\n    return sanitizeReasoningDeltaUpdateData(data);\n  }\n  return undefined;\n}\n\nfunction isDroppableSubagentUpdatePhase(phase: SubagentUpdatePhase): boolean {\n  return (\n    phase === 'message_delta' ||\n    phase === 'reasoning_delta' ||\n    phase === 'run_step_delta'\n  );\n}\n\nfunction sanitizeToolExecuteUpdateData(\n  data: unknown\n): SanitizedSubagentToolExecuteData {\n  const request = data as Partial<ToolExecuteBatchRequest>;\n  const toolCalls = Array.isArray(request.toolCalls)\n    ? request.toolCalls.map(sanitizeToolCallForUpdate)\n    : [];\n  const sanitized: SanitizedSubagentToolExecuteData = { toolCalls };\n  if (typeof request.agentId === 'string') {\n    sanitized.agentId = request.agentId;\n  }\n  return sanitized;\n}\n\nfunction sanitizeToolCallForUpdate(\n  call: ToolExecuteBatchRequest['toolCalls'][number]\n): SanitizedSubagentToolCall {\n  const sanitized: SanitizedSubagentToolCall = {\n    id: call.id,\n    name: call.name,\n    args: call.args,\n  };\n  return sanitized;\n}\n\nfunction sanitizeRunStepUpdateData(\n  data: unknown\n): SanitizedRunStep | undefined {\n  if (!isObjectLike(data)) {\n    return undefined;\n  }\n  const step = data as Partial<RunStep>;\n  const sanitized: SanitizedRunStep = {};\n  assignString(sanitized, 'agentId', step.agentId);\n  assignNumber(sanitized, 'groupId', step.groupId);\n  assignString(sanitized, 'id', step.id);\n  assignNumber(sanitized, 'index', step.index);\n  assignString(sanitized, 'runId', step.runId);\n  assignNumber(sanitized, 'stepIndex', step.stepIndex);\n  assignString(sanitized, 'type', step.type);\n  if (step.summary !== undefined) {\n    sanitized.summary = step.summary;\n  }\n  if (step.usage !== undefined) {\n    sanitized.usage = step.usage;\n  }\n  sanitized.stepDetails = sanitizeStepDetails(step.stepDetails);\n  return sanitized;\n}\n\nfunction sanitizeRunStepDeltaUpdateData(\n  data: unknown\n): SanitizedRunStepDelta | undefined {\n  if (!isObjectLike(data)) {\n    return undefined;\n  }\n  const event = data as Partial<RunStepDeltaEvent>;\n  const sanitized: SanitizedRunStepDelta = {};\n  assignString(sanitized, 'id', event.id);\n  sanitized.delta = sanitizeToolCallDelta(event.delta);\n  return sanitized;\n}\n\nfunction sanitizeRunStepCompletedUpdateData(\n  data: unknown\n): SanitizedRunStepCompleted | undefined {\n  if (!isObjectLike(data)) {\n    return undefined;\n  }\n  const event = data as { result?: unknown };\n  return { result: sanitizeStepCompleted(event.result) };\n}\n\nfunction sanitizeMessageDeltaUpdateData(\n  data: unknown\n): SanitizedMessageDelta | undefined {\n  if (!isObjectLike(data)) {\n    return undefined;\n  }\n  const event = data as Partial<MessageDeltaEvent>;\n  const sanitized: SanitizedMessageDelta = {};\n  assignString(sanitized, 'id', event.id);\n  if (event.delta != null) {\n    sanitized.delta = {};\n    if (event.delta.content !== undefined) {\n      sanitized.delta.content = event.delta.content;\n    }\n    if (event.delta.tool_call_ids !== undefined) {\n      sanitized.delta.tool_call_ids = event.delta.tool_call_ids;\n    }\n  }\n  return sanitized;\n}\n\nfunction sanitizeReasoningDeltaUpdateData(\n  data: unknown\n): SanitizedReasoningDelta | undefined {\n  if (!isObjectLike(data)) {\n    return undefined;\n  }\n  const event = data as Partial<ReasoningDeltaEvent>;\n  const sanitized: SanitizedReasoningDelta = {};\n  assignString(sanitized, 'id', event.id);\n  if (event.delta?.content !== undefined) {\n    sanitized.delta = { content: event.delta.content };\n  }\n  return sanitized;\n}\n\nfunction sanitizeStepDetails(\n  stepDetails: unknown\n): SanitizedStepDetails | undefined {\n  if (!isObjectLike(stepDetails)) {\n    return undefined;\n  }\n  const rawDetails = stepDetails as {\n    message_creation?: { message_id?: unknown };\n    tool_calls?: unknown[];\n    type?: unknown;\n  };\n  if (rawDetails.type === StepTypes.MESSAGE_CREATION) {\n    const sanitized: SanitizedStepDetails = {\n      type: StepTypes.MESSAGE_CREATION,\n    };\n    const messageId = rawDetails.message_creation?.message_id;\n    if (typeof messageId === 'string') {\n      sanitized.message_creation = { message_id: messageId };\n    }\n    return sanitized;\n  }\n  if (rawDetails.type === StepTypes.TOOL_CALLS) {\n    const sanitized: SanitizedStepDetails = {\n      type: StepTypes.TOOL_CALLS,\n    };\n    if (Array.isArray(rawDetails.tool_calls)) {\n      sanitized.tool_calls = rawDetails.tool_calls.map(sanitizeAgentToolCall);\n    }\n    return sanitized;\n  }\n  return undefined;\n}\n\nfunction sanitizeToolCallDelta(\n  delta: ToolCallDelta | undefined\n): SanitizedToolCallDelta | undefined {\n  if (!isObjectLike(delta)) {\n    return undefined;\n  }\n  const sanitized: SanitizedToolCallDelta = {};\n  assignString(sanitized, 'auth', delta.auth);\n  assignNumber(sanitized, 'expires_at', delta.expires_at);\n  assignString(sanitized, 'type', delta.type);\n  if (delta.summary !== undefined) {\n    sanitized.summary = delta.summary;\n  }\n  if (Array.isArray(delta.tool_calls)) {\n    sanitized.tool_calls = delta.tool_calls.map(sanitizeAgentToolCall);\n  }\n  return sanitized;\n}\n\nfunction sanitizeStepCompleted(\n  data: unknown\n): SanitizedStepCompleted | undefined {\n  if (!isObjectLike(data)) {\n    return undefined;\n  }\n  const completed = data as Partial<StepCompleted> & {\n    id?: unknown;\n    index?: unknown;\n    tool_call?: unknown;\n  };\n  if (completed.type === 'summary') {\n    return {\n      type: 'summary',\n      summary: completed.summary,\n    };\n  }\n  if (completed.type !== 'tool_call') {\n    return undefined;\n  }\n  const sanitized: SanitizedStepCompleted = { type: 'tool_call' };\n  assignString(sanitized, 'id', completed.id);\n  assignNumber(sanitized, 'index', completed.index);\n  sanitized.tool_call = sanitizeProcessedToolCall(completed.tool_call);\n  return sanitized;\n}\n\nfunction sanitizeProcessedToolCall(\n  toolCall: unknown\n): SanitizedProcessedToolCall | undefined {\n  if (!isObjectLike(toolCall)) {\n    return undefined;\n  }\n  const call = toolCall as Partial<ProcessedToolCall>;\n  const sanitized: SanitizedProcessedToolCall = {};\n  assignString(sanitized, 'id', call.id);\n  assignString(sanitized, 'name', call.name);\n  if (call.args !== undefined) {\n    sanitized.args = call.args;\n  }\n  assignString(sanitized, 'output', call.output);\n  assignNumber(sanitized, 'progress', call.progress);\n  return sanitized;\n}\n\nfunction sanitizeAgentToolCall(toolCall: unknown): SanitizedAgentToolCall {\n  if (!isObjectLike(toolCall)) {\n    return {};\n  }\n  const call = toolCall as SanitizedAgentToolCall;\n  const sanitized: SanitizedAgentToolCall = {};\n  assignString(sanitized, 'id', call.id);\n  assignString(sanitized, 'name', call.name);\n  assignString(sanitized, 'type', call.type);\n  if (call.args !== undefined) {\n    sanitized.args = call.args;\n  }\n  if (isObjectLike(call.function)) {\n    const fn: SanitizedAgentToolCall['function'] = {};\n    assignString(fn, 'name', call.function.name);\n    if (\n      typeof call.function.arguments === 'string' ||\n      isObjectLike(call.function.arguments)\n    ) {\n      fn.arguments = call.function.arguments;\n    }\n    sanitized.function = fn;\n  }\n  return sanitized;\n}\n\nfunction isObjectLike(value: unknown): value is object {\n  return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction assignString<T extends object, K extends keyof T>(\n  target: T,\n  key: K,\n  value: unknown\n): void {\n  if (typeof value === 'string') {\n    target[key] = value as T[K];\n  }\n}\n\nfunction assignNumber<T extends object, K extends keyof T>(\n  target: T,\n  key: K,\n  value: unknown\n): void {\n  if (typeof value === 'number') {\n    target[key] = value as T[K];\n  }\n}\n\n/**\n * Produces a short single-line label for an arbitrary forwarded child event.\n * Used to populate {@link SubagentUpdateEvent.label} so the host UI can show\n * a compact status ticker without parsing the raw payload.\n */\nexport function summarizeEvent(eventName: string, data: unknown): string {\n  if (eventName === GraphEvents.ON_TOOL_EXECUTE) {\n    const req = data as { toolCalls?: Array<{ name?: string }> };\n    const names = (req.toolCalls ?? [])\n      .map((c) => c.name)\n      .filter((n): n is string => typeof n === 'string');\n    return names.length > 0 ? `Calling ${names.join(', ')}` : 'Calling tool';\n  }\n  if (eventName === GraphEvents.ON_RUN_STEP) {\n    const step = data as {\n      type?: string;\n      stepDetails?: { type?: string; tool_calls?: Array<{ name?: string }> };\n    };\n    const detailType = step.stepDetails?.type ?? step.type ?? 'step';\n    if (detailType === 'tool_calls') {\n      const names = (step.stepDetails?.tool_calls ?? [])\n        .map((c) => c.name)\n        .filter((n): n is string => typeof n === 'string');\n      return names.length > 0\n        ? `Using tool: ${names.join(', ')}`\n        : 'Planning tool call';\n    }\n    if (detailType === 'message_creation') {\n      return 'Thinking…';\n    }\n    return `Step: ${detailType}`;\n  }\n  if (eventName === GraphEvents.ON_RUN_STEP_COMPLETED) {\n    const step = data as {\n      result?: {\n        type?: string;\n        tool_call?: { name?: string; output?: string };\n      };\n    };\n    const tool = step.result?.tool_call;\n    if (tool?.name != null && tool.name !== '') {\n      return `Tool ${tool.name} complete`;\n    }\n    return 'Step complete';\n  }\n  if (eventName === GraphEvents.ON_MESSAGE_DELTA) {\n    return 'Streaming…';\n  }\n  return eventName;\n}\n\n/**\n * Walk messages from last to first, returning the text content of the most\n * recent AIMessage that has any. Non-text blocks (tool_use, thinking,\n * redacted_thinking, tool_result) are stripped. If the last AIMessage is\n * pure tool_use (e.g. the subagent hit `maxTurns` mid-tool-call), the walk\n * continues to earlier AIMessages so partial progress is salvaged — this\n * matches Claude Code's behavior in `agentToolUtils.finalizeAgentTool`.\n * Returns \"Task completed\" only when no AIMessage in the history contains\n * any text.\n */\nexport function filterSubagentResult(messages: BaseMessage[]): string {\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (messages[i]._getType() !== 'ai') {\n      continue;\n    }\n\n    const content = messages[i].content;\n\n    if (typeof content === 'string') {\n      if (content) return content;\n      continue;\n    }\n\n    if (!Array.isArray(content)) {\n      continue;\n    }\n\n    const textParts: string[] = [];\n    for (const block of content) {\n      if (typeof block === 'string') {\n        textParts.push(block);\n      } else if ('type' in block && block.type === 'text' && 'text' in block) {\n        textParts.push(block.text as string);\n      }\n    }\n\n    if (textParts.length > 0) {\n      return textParts.join('\\n');\n    }\n  }\n\n  return 'Task completed';\n}\n\n/**\n * Resolve self-spawn configs by filling in agentInputs from the parent context.\n * Returns configs with agentInputs guaranteed present. Throws on duplicate\n * `type` values to prevent silent config shadowing.\n */\nexport function resolveSubagentConfigs(\n  configs: SubagentConfig[],\n  parentContext: AgentContext\n): ResolvedSubagentConfig[] {\n  const resolved = configs\n    .map((config) => {\n      if (config.agentInputs != null) {\n        return config as ResolvedSubagentConfig;\n      }\n      if (config.self !== true || parentContext._sourceInputs == null) {\n        return null;\n      }\n      return {\n        ...config,\n        agentInputs: { ...parentContext._sourceInputs },\n      } as ResolvedSubagentConfig;\n    })\n    .filter((c): c is ResolvedSubagentConfig => c != null);\n\n  const seenTypes = new Set<string>();\n  for (const config of resolved) {\n    if (seenTypes.has(config.type)) {\n      throw new Error(\n        `Duplicate subagent type \"${config.type}\". Each SubagentConfig must have a unique \"type\" field.`\n      );\n    }\n    seenTypes.add(config.type);\n  }\n\n  return resolved;\n}\n\n/**\n * Build child AgentInputs from a resolved config, stripping nesting and\n * (optionally) event-driven fields. When `allowNested: true`, the child's\n * `maxSubagentDepth` is decremented so that depth is consumed as the call\n * chain deepens across graph boundaries — the parent's executor-level check\n * alone cannot see into the child graph's separate executor.\n *\n * When `keepToolDefinitions` is `true`, the child retains the parent's\n * `toolDefinitions` so event-driven tools remain usable. This is only safe\n * when the caller has wired a forwarder for `ON_TOOL_EXECUTE` to a\n * registered handler — otherwise the child will hang on tool dispatch.\n *\n * @remarks Advanced utility: exported primarily for testing and by\n * {@link SubagentExecutor}. Host applications configuring subagents should\n * not need to call this directly — it is invoked internally when a subagent\n * tool is dispatched. The depth-countdown contract (parent's `maxDepth` in,\n * child's decremented `maxSubagentDepth` on the returned inputs) is the\n * mechanism that bounds nesting across graph boundaries; callers must\n * respect it.\n */\nexport function buildChildInputs(\n  config: ResolvedSubagentConfig,\n  childAgentId: string,\n  parentMaxDepth: number,\n  keepToolDefinitions: boolean = false\n): AgentInputs {\n  const { agentInputs } = config;\n  const childInputs: AgentInputs = {\n    ...agentInputs,\n    agentId: childAgentId,\n    toolDefinitions: keepToolDefinitions\n      ? agentInputs.toolDefinitions\n      : undefined,\n    /**\n     * Subagents run in an isolated context by contract. Parent-run-scoped\n     * fields that would otherwise survive the shallow-spread clone — the\n     * cross-run conversation summary and the prior-turn tool-discovery\n     * set — are cleared here so the child starts fresh. Host applications\n     * that want a subagent to see parent context must thread it in\n     * explicitly (e.g. via the `description` argument to the subagent\n     * tool), not via inherited state.\n     */\n    initialSummary: undefined,\n    discoveredTools: undefined,\n    /**\n     * Host-supplied direct tools are scrubbed from INHERITED configs only.\n     * A self-spawn config's `agentInputs` is a shallow spread of the parent's\n     * `_sourceInputs`, so without this a parent-scoped graph tool (e.g. an\n     * interrupt-raising ask_user_question, which needs the parent's\n     * checkpointer — child graphs compile without one) would silently leak\n     * into the child and deterministically throw `No checkpointer set`. An\n     * EXPLICIT child config that lists its own `graphTools` is a deliberate\n     * host choice and keeps them (Codex #289 P2).\n     */\n    graphTools: config.self === true ? undefined : agentInputs.graphTools,\n  };\n\n  if (config.allowNested === true) {\n    childInputs.maxSubagentDepth = Math.max(0, parentMaxDepth - 1);\n  } else {\n    childInputs.subagentConfigs = undefined;\n    childInputs.maxSubagentDepth = undefined;\n  }\n\n  return childInputs;\n}\n\nfunction truncateErrorMessage(error: unknown): string {\n  const message = error instanceof Error ? error.message : String(error);\n  if (message.length <= ERROR_MESSAGE_MAX_CHARS) {\n    return message;\n  }\n  return `${message.slice(0, ERROR_MESSAGE_MAX_CHARS)}...`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"SubagentExecutor.cjs","names":["executeHooks","HumanMessage","BaseCallbackHandler","event","req","step"],"sources":["../../../../src/tools/subagent/SubagentExecutor.ts"],"sourcesContent":["import { nanoid } from 'nanoid';\nimport { HumanMessage } from '@langchain/core/messages';\nimport { BaseCallbackHandler } from '@langchain/core/callbacks/base';\nimport type { BaseMessage, UsageMetadata } from '@langchain/core/messages';\nimport type { ChatGeneration, LLMResult } from '@langchain/core/outputs';\nimport type { Callbacks } from '@langchain/core/callbacks/manager';\nimport type {\n  AgentInputs,\n  InjectedMessage,\n  MessageDeltaEvent,\n  ProcessedToolCall,\n  ReasoningDeltaEvent,\n  RunStep,\n  RunStepDeltaEvent,\n  StandardGraphInput,\n  ResolvedSubagentConfig,\n  StepCompleted,\n  SubagentConfig,\n  SubagentUpdateEvent,\n  SubagentUpdatePhase,\n  SubagentUsageSink,\n  ToolExecuteBatchRequest,\n  ToolCallDelta,\n  TokenCounter,\n} from '@/types';\nimport type { AggregatedHookResult, HookRegistry } from '@/hooks';\nimport type { AgentContext } from '@/agents/AgentContext';\nimport type { StandardGraph } from '@/graphs/Graph';\nimport type { HandlerRegistry } from '@/events';\nimport { Constants, GraphEvents, Callback, StepTypes } from '@/common';\nimport { executeHooks } from '@/hooks';\n\nconst DEFAULT_MAX_TURNS = 25;\nconst RECURSION_MULTIPLIER = 3;\nconst ERROR_MESSAGE_MAX_CHARS = 200;\nconst MAX_PENDING_SUBAGENT_UPDATES = 64;\n\nconst HOOK_FALLBACK: AggregatedHookResult = Object.freeze({\n  additionalContexts: [] as string[],\n  injectedMessages: [] as InjectedMessage[],\n  errors: [] as string[],\n});\n\ntype SanitizedSubagentToolCall = {\n  id: string;\n  name: string;\n  args?: ToolExecuteBatchRequest['toolCalls'][number]['args'];\n};\n\ntype SanitizedSubagentToolExecuteData = {\n  toolCalls: SanitizedSubagentToolCall[];\n  agentId?: string;\n};\n\ntype SanitizedRunStep = Partial<\n  Pick<\n    RunStep,\n    | 'agentId'\n    | 'groupId'\n    | 'id'\n    | 'index'\n    | 'runId'\n    | 'stepIndex'\n    | 'summary'\n    | 'type'\n    | 'usage'\n  >\n> & {\n  stepDetails?: SanitizedStepDetails;\n};\n\ntype SanitizedStepDetails =\n  | {\n      type: StepTypes.MESSAGE_CREATION;\n      message_creation?: {\n        message_id?: string;\n      };\n    }\n  | {\n      type: StepTypes.TOOL_CALLS;\n      tool_calls?: SanitizedAgentToolCall[];\n    };\n\ntype SanitizedAgentToolCall = {\n  id?: string;\n  name?: string;\n  args?: string | object;\n  type?: string;\n  function?: {\n    name?: string;\n    arguments?: string | object;\n  };\n};\n\ntype SanitizedRunStepDelta = Partial<Pick<RunStepDeltaEvent, 'id'>> & {\n  delta?: SanitizedToolCallDelta;\n};\n\ntype SanitizedToolCallDelta = Partial<\n  Pick<ToolCallDelta, 'auth' | 'expires_at' | 'summary' | 'type'>\n> & {\n  tool_calls?: SanitizedAgentToolCall[];\n};\n\ntype SanitizedStepCompleted =\n  | {\n      id?: string;\n      index?: number;\n      type: 'tool_call';\n      tool_call?: SanitizedProcessedToolCall;\n    }\n  | {\n      type: 'summary';\n      summary?: Extract<StepCompleted, { type: 'summary' }>['summary'];\n    };\n\ntype SanitizedProcessedToolCall = Partial<\n  Pick<ProcessedToolCall, 'args' | 'id' | 'name' | 'output' | 'progress' | 'outcome'>\n>;\n\ntype SanitizedRunStepCompleted = {\n  result?: SanitizedStepCompleted;\n};\n\ntype SanitizedMessageDelta = Partial<Pick<MessageDeltaEvent, 'id'>> & {\n  delta?: {\n    content?: MessageDeltaEvent['delta']['content'];\n    tool_call_ids?: MessageDeltaEvent['delta']['tool_call_ids'];\n  };\n};\n\ntype SanitizedReasoningDelta = Partial<Pick<ReasoningDeltaEvent, 'id'>> & {\n  delta?: {\n    content?: ReasoningDeltaEvent['delta']['content'];\n  };\n};\n\ntype QueuedSubagentUpdate = {\n  eventName: string;\n  phase: SubagentUpdatePhase;\n  data: unknown;\n};\n\ntype ForwarderCallback = {\n  handler: BaseCallbackHandler;\n  drain: () => Promise<void>;\n};\n\nconst LANGGRAPH_RUNTIME_CONFIG_PREFIX = '__pregel_';\nconst LANGGRAPH_CHECKPOINT_CONFIG_KEYS = new Set([\n  'checkpoint_id',\n  'checkpoint_map',\n  'checkpoint_ns',\n]);\n\nexport type SubagentExecuteParams = {\n  description: string;\n  subagentType: string;\n  threadId?: string;\n  /**\n   * Parent-side `tool_call_id` of the `subagent` tool invocation that\n   * triggered this execution. Surfaced on {@link SubagentUpdateEvent} so\n   * hosts can correlate child updates back to the originating tool call\n   * without relying on event ordering heuristics.\n   */\n  parentToolCallId?: string;\n  /**\n   * Snapshot of the parent invocation's host `config.configurable` at\n   * the spawn-tool call site. Host-set fields (`requestBody`, `user`,\n   * `userMCPAuthMap`, etc.) propagate into the child workflow's\n   * `configurable` — fixing MCP body-placeholder substitution and\n   * per-user lookups for subagent tool calls. LangGraph runtime keys\n   * (`__pregel_*`, checkpoint bookkeeping) are intentionally not\n   * inherited; the child graph recreates its own runtime config.\n   *\n   * Inheritance details (verified empirically against LangGraph):\n   *   - host-set keys propagate as-is into the child's tool dispatches;\n   *   - `thread_id` propagates (with `childRunId` as a fallback when\n   *     parent did not supply one) — matches the \"subagent is part of\n   *     the same conversation\" mental model and aligns with the\n   *     `sessionId: this.parentRunId` convention this executor already\n   *     uses for `SubagentStart` / `SubagentStop` hooks;\n   *   - `parent_run_id` propagates when the host put it on parent's\n   *     configurable;\n   *   - `run_id` is *overwritten by the LangGraph runtime* at child\n   *     invoke time regardless of what we forward — child's tool\n   *     dispatches see the child graph's runtime runId in\n   *     `configurable.run_id`, not the parent's. Hosts that need\n   *     parent-scoped run identity for downstream consumers should\n   *     plumb it via a host-defined key (e.g. `requestBody.messageId`),\n   *     not `run_id`.\n   *\n   * A future revision will likely make this inheritance configurable\n   * per spawn type — background / async subagents may want isolation\n   * rather than sharing parent's host context.\n   */\n  parentConfigurable?: Record<string, unknown>;\n};\n\nexport type SubagentExecuteResult = {\n  content: string;\n  messages: BaseMessage[];\n};\n\n/**\n * Factory that constructs a child graph for subagent execution. Injected\n * rather than imported so that `SubagentExecutor` does not have a runtime\n * dependency on `StandardGraph` — this avoids a circular dependency between\n * `src/graphs/Graph.ts` and `src/tools/subagent/` that would otherwise break\n * Rollup's chunking under `preserveModules`.\n */\nexport type ChildGraphFactory = (input: StandardGraphInput) => StandardGraph;\n\nexport type SubagentExecutorOptions = {\n  configs: Map<string, ResolvedSubagentConfig>;\n  parentSignal?: AbortSignal;\n  hookRegistry?: HookRegistry;\n  parentRunId: string;\n  parentAgentId?: string;\n  langfuse?: StandardGraphInput['langfuse'];\n  tokenCounter?: TokenCounter;\n  /** Remaining nesting budget. 0 or negative blocks execution. */\n  maxDepth?: number;\n  /**\n   * Factory for constructing the isolated child graph. Callers pass\n   * `(input) => new StandardGraph(input)` — injected to break a circular\n   * module dependency.\n   */\n  createChildGraph: ChildGraphFactory;\n  /**\n   * Parent's event handler registry. When provided, child-graph events are\n   * forwarded through this registry so hosts can:\n   *   (a) execute event-driven tools (`ON_TOOL_EXECUTE` routed to parent's handler),\n   *   (b) surface child activity to a UI via wrapped {@link GraphEvents.ON_SUBAGENT_UPDATE}.\n   * When omitted, the child runs fully isolated (legacy behavior).\n   *\n   * Can be a direct `HandlerRegistry` or a zero-arg getter — use the getter\n   * form when the registry is assigned to the graph AFTER the executor is\n   * constructed (the current `Run.create` flow sets `handlerRegistry`\n   * post-`createWorkflow`, so `createAgentNode` must capture lazily).\n   */\n  parentHandlerRegistry?: HandlerRegistry | (() => HandlerRegistry | undefined);\n  /**\n   * Receives a usage event for every model call the child run makes. The\n   * child workflow executes via `invoke()` with a detached callbacks array,\n   * so its `on_chat_model_end` events never reach the parent's handler\n   * registry — without this sink, child token usage is invisible to the\n   * host (unbilled model calls). Forwarded into the child graph's input so\n   * nested subagents report through the same sink.\n   */\n  usageSink?: SubagentUsageSink;\n};\n\nexport class SubagentExecutor {\n  private readonly configs: Map<string, ResolvedSubagentConfig>;\n  private readonly parentSignal?: AbortSignal;\n  private readonly hookRegistry?: HookRegistry;\n  private readonly parentRunId: string;\n  private readonly parentAgentId?: string;\n  private readonly langfuse?: StandardGraphInput['langfuse'];\n  private readonly tokenCounter?: TokenCounter;\n  private readonly maxDepth: number;\n  private readonly createChildGraph: ChildGraphFactory;\n  private readonly usageSink?: SubagentUsageSink;\n  private readonly resolveParentHandlerRegistry?: () =>\n    | HandlerRegistry\n    | undefined;\n\n  constructor(options: SubagentExecutorOptions) {\n    this.configs = options.configs;\n    this.parentSignal = options.parentSignal;\n    this.hookRegistry = options.hookRegistry;\n    this.parentRunId = options.parentRunId;\n    this.parentAgentId = options.parentAgentId;\n    this.langfuse = options.langfuse;\n    this.tokenCounter = options.tokenCounter;\n    this.maxDepth = options.maxDepth ?? 1;\n    this.createChildGraph = options.createChildGraph;\n    this.usageSink = options.usageSink;\n    const rawRegistry = options.parentHandlerRegistry;\n    if (typeof rawRegistry === 'function') {\n      this.resolveParentHandlerRegistry = rawRegistry;\n    } else if (rawRegistry != null) {\n      this.resolveParentHandlerRegistry = (): HandlerRegistry => rawRegistry;\n    }\n  }\n\n  /** Snapshot of the parent's registry at the moment a subagent is dispatched. */\n  private getParentHandlerRegistry(): HandlerRegistry | undefined {\n    return this.resolveParentHandlerRegistry?.();\n  }\n\n  async execute(params: SubagentExecuteParams): Promise<SubagentExecuteResult> {\n    const { description, subagentType, threadId, parentToolCallId } = params;\n    const config = this.configs.get(subagentType);\n\n    if (!config) {\n      const available = [...this.configs.keys()].join(', ');\n      return {\n        content: `Error: Unknown subagent type \"${subagentType}\". Available types: ${available}`,\n        messages: [],\n      };\n    }\n\n    if (this.maxDepth <= 0) {\n      return {\n        content: 'Error: Maximum subagent nesting depth exceeded.',\n        messages: [],\n      };\n    }\n\n    const childAgentId =\n      config.agentInputs.agentId ||\n      `${this.parentAgentId ?? 'agent'}_sub_${nanoid(8)}`;\n\n    if (\n      this.hookRegistry?.hasHookFor('SubagentStart', this.parentRunId) === true\n    ) {\n      const hookResult = await executeHooks({\n        registry: this.hookRegistry,\n        input: {\n          hook_event_name: 'SubagentStart',\n          runId: this.parentRunId,\n          threadId,\n          parentAgentId: this.parentAgentId,\n          agentId: childAgentId,\n          agentType: subagentType,\n          inputs: [new HumanMessage(description)],\n        },\n        sessionId: this.parentRunId,\n        matchQuery: subagentType,\n      }).catch((): AggregatedHookResult => HOOK_FALLBACK);\n\n      /**\n       * `ask` is treated identically to `deny` in the subagent context:\n       * subagents are non-interactive, so there is no prompt path for `ask`.\n       * Both decisions block execution and return a \"Blocked\" tool result.\n       */\n      if (hookResult.decision === 'deny' || hookResult.decision === 'ask') {\n        return {\n          content: `Blocked: ${hookResult.reason ?? 'Blocked by hook'}`,\n          messages: [],\n        };\n      }\n    }\n\n    const parentRegistry = this.getParentHandlerRegistry();\n    const forwardingEnabled = parentRegistry != null;\n    /**\n     * Keep `toolDefinitions` only when the host has actually wired an\n     * `ON_TOOL_EXECUTE` handler. `Run` always constructs a `HandlerRegistry`,\n     * so treating any registry as \"forwarding enabled\" would leak\n     * `toolDefinitions` into children whose hosts cannot execute them — the\n     * child's `ToolNode` batch promise would hang forever with no handler to\n     * resolve/reject. Gating on the tool-execute handler preserves the\n     * recoverable \"no tools\" path for registry-but-no-handler configs.\n     */\n    const hasToolExecuteHandler =\n      parentRegistry?.getHandler(GraphEvents.ON_TOOL_EXECUTE) != null;\n    const childInputs = buildChildInputs(\n      config,\n      childAgentId,\n      this.maxDepth,\n      /* keepToolDefinitions */ hasToolExecuteHandler\n    );\n    const childRunId = `${this.parentRunId}_sub_${nanoid(8)}`;\n    const maxTurns = config.maxTurns ?? DEFAULT_MAX_TURNS;\n\n    const hostUsageSink = this.usageSink;\n    const childGraph = this.createChildGraph({\n      runId: childRunId,\n      signal: this.parentSignal,\n      agents: [childInputs],\n      langfuse: this.langfuse,\n      tokenCounter: this.tokenCounter,\n      subagentScope: true,\n      /**\n       * Forwarded so the child graph's own `SubagentExecutor` (created in\n       * its `createAgentNode` when `allowNested` keeps subagentConfigs)\n       * reports nested-child usage through the same host sink. Each nesting\n       * level attaches its own capture callback — `workflow.invoke` replaces\n       * the inherited callback chain, so a single top-level handler would\n       * never see grandchild model calls.\n       *\n       * The wrapper rewrites `runId` to THIS executor's parent run: nested\n       * executors emit with their own `parentRunId` (a `*_sub_*` child id),\n       * and each wrapper layer rewrites upward, so by the time an event\n       * reaches the host sink its `runId` is the ROOT run — hosts keying\n       * billing by run id never see intermediate child run ids there\n       * (`subagentRunId` still identifies the emitting child).\n       */\n      subagentUsageSink:\n        hostUsageSink == null\n          ? undefined\n          : /** Returns the host sink's result so async sinks stay awaited\n             *  through every wrapper layer. */\n          (event): void | Promise<void> =>\n            hostUsageSink({ ...event, runId: this.parentRunId }),\n    });\n\n    let forwarding: ForwarderCallback | undefined;\n    if (forwardingEnabled) {\n      forwarding = this.createForwarderCallback({\n        parentRegistry: parentRegistry!,\n        subagentType,\n        subagentAgentId: childAgentId,\n        childRunId,\n        parentToolCallId,\n      });\n    }\n    const forwarder = forwarding?.handler;\n\n    if (forwarder) {\n      await this.emitSubagentUpdate(parentRegistry!, {\n        childRunId,\n        subagentType,\n        subagentAgentId: childAgentId,\n        parentToolCallId,\n        phase: 'start',\n        label: `Subagent \"${subagentType}\" started`,\n      });\n    }\n\n    let result: { messages: BaseMessage[] };\n    try {\n      const workflow = childGraph.createWorkflow();\n      /**\n       * When `parentHandlerRegistry` is provided (forwarding mode), attach a\n       * lightweight callback that intercepts the child's `on_custom_event`\n       * dispatches and routes them to the parent's registry — either as\n       * operational events (ON_TOOL_EXECUTE) or wrapped ON_SUBAGENT_UPDATE\n       * envelopes. Native LangChain streaming events (on_chat_model_stream,\n       * etc.) still do NOT propagate to the parent's outer streamEvents\n       * iterator — the `callbacks` array REPLACES the inherited chain, so\n       * parent handlers won't receive child stream chunks and raise \"No\n       * agent context found\" lookups on the parent's agentContexts map.\n       *\n       * When no registry is provided (legacy isolation), `callbacks: []`\n       * fully detaches the child.\n       *\n       * `runName` gives the child a distinct LangSmith trace root (avoids\n       * nested trace pollution).\n       */\n      const callbackHandlers: BaseCallbackHandler[] = [];\n      if (forwarder) {\n        callbackHandlers.push(forwarder);\n      }\n      /**\n       * Usage capture rides the same detached callbacks array. Because\n       * `callbacks` REPLACES the inherited chain (see above), the host's\n       * `CHAT_MODEL_END` handler never observes the child's model calls —\n       * this handler is the child-side equivalent of `ModelEndHandler`,\n       * reporting per-call usage to the host's sink for billing.\n       */\n      if (this.usageSink) {\n        callbackHandlers.push(\n          createUsageCaptureHandler({\n            sink: this.usageSink,\n            subagentType,\n            subagentRunId: childRunId,\n            subagentAgentId: childAgentId,\n            parentRunId: this.parentRunId,\n            provider: config.agentInputs.provider,\n            fallbackModel: extractConfiguredModel(config.agentInputs),\n          })\n        );\n      }\n      const callbacks: Callbacks = callbackHandlers;\n      /**\n       * Inherit the parent's host `configurable` — host-set fields\n       * (`requestBody`, `user`, `userMCPAuthMap`, etc.) AND the run-\n       * identity fields (`run_id`, `parent_run_id`, `thread_id`) all\n       * propagate. LangGraph's own runtime keys are excluded because the\n       * child graph creates its own scratchpad/checkpoint/abort plumbing.\n       *\n       * Run-identity propagation is intentional and matches the\n       * convention this executor itself already uses for `SubagentStart`\n       * / `SubagentStop` hooks (`sessionId: this.parentRunId`): the\n       * subagent runs under the parent's session scope, not its own.\n       * Forwarding `run_id` / `parent_run_id` / `thread_id` makes\n       * `ToolNode`'s hook lookups (`hasHookFor(eventName, runId)`),\n       * `ToolOutputReferenceRegistry` keying, and trace lineage all\n       * resolve to the parent's session for tools dispatched from the\n       * subagent — so `PreToolUse` / `PostToolUse` hooks the host\n       * registered against the parent's run fire for subagent tool\n       * calls too. \"Same run\" matches the user-perceptual mental model.\n       *\n       * `thread_id` falls back to `childRunId` only when the parent\n       * didn't supply one (legacy behavior preserved for hosts that\n       * never set thread_id).\n       *\n       * NOTE: a future revision will likely make this configurable per\n       * spawn type — e.g. a background / async subagent that runs after\n       * the parent's run completes wants isolation, not inheritance.\n       * For now the inheritance path matches LibreChat's primary use\n       * case (synchronous subagents within a single user turn).\n       */\n      const inheritedConfigurable: Record<string, unknown> =\n        sanitizeChildConfigurable(params.parentConfigurable);\n      result = await workflow.invoke(\n        { messages: [new HumanMessage(description)] },\n        {\n          recursionLimit: maxTurns * RECURSION_MULTIPLIER,\n          signal: this.parentSignal,\n          callbacks,\n          runName: `subagent:${subagentType}`,\n          configurable: {\n            thread_id: childRunId,\n            ...inheritedConfigurable,\n          },\n        }\n      );\n    } catch (error) {\n      const errorMessage = truncateErrorMessage(error);\n      if (forwarding) {\n        await forwarding.drain();\n        await this.emitSubagentUpdate(parentRegistry!, {\n          childRunId,\n          subagentType,\n          subagentAgentId: childAgentId,\n          parentToolCallId,\n          phase: 'error',\n          label: `Subagent \"${subagentType}\" errored: ${errorMessage}`,\n          data: { message: errorMessage },\n        });\n      }\n      childGraph.clearHeavyState();\n      return {\n        content: `Subagent error: ${errorMessage}`,\n        messages: [],\n      };\n    }\n\n    const filteredContent = filterSubagentResult(result.messages);\n\n    if (\n      this.hookRegistry?.hasHookFor('SubagentStop', this.parentRunId) === true\n    ) {\n      /**\n       * Awaited (not fire-and-forget) for deterministic test synchronization\n       * and consistency with PostCompact. The parent is already waiting on the\n       * tool result, so the small extra latency is acceptable. Errors are\n       * swallowed — SubagentStop is observational.\n       */\n      await executeHooks({\n        registry: this.hookRegistry,\n        input: {\n          hook_event_name: 'SubagentStop',\n          runId: this.parentRunId,\n          threadId,\n          agentId: childAgentId,\n          agentType: subagentType,\n          messages: result.messages,\n        },\n        sessionId: this.parentRunId,\n        matchQuery: subagentType,\n      }).catch(() => {\n        /* SubagentStop is observational — swallow errors */\n      });\n    }\n\n    if (forwarding) {\n      await forwarding.drain();\n      await this.emitSubagentUpdate(parentRegistry!, {\n        childRunId,\n        subagentType,\n        subagentAgentId: childAgentId,\n        parentToolCallId,\n        phase: 'stop',\n        label: `Subagent \"${subagentType}\" finished`,\n      });\n    }\n\n    childGraph.clearHeavyState();\n\n    return { content: filteredContent, messages: result.messages };\n  }\n\n  /**\n   * Emits a single {@link GraphEvents.ON_SUBAGENT_UPDATE} envelope through the\n   * parent's handler registry. Silent no-op when no parent registry is set.\n   * Errors are swallowed — update events are observational.\n   */\n  private async emitSubagentUpdate(\n    parentRegistry: HandlerRegistry,\n    args: {\n      childRunId: string;\n      subagentType: string;\n      subagentAgentId: string;\n      parentToolCallId?: string;\n      phase: SubagentUpdatePhase;\n      data?: unknown;\n      label?: string;\n    }\n  ): Promise<void> {\n    const handler = parentRegistry.getHandler(GraphEvents.ON_SUBAGENT_UPDATE);\n    if (!handler) {\n      return;\n    }\n    const event: SubagentUpdateEvent = {\n      runId: this.parentRunId,\n      subagentRunId: args.childRunId,\n      subagentType: args.subagentType,\n      subagentAgentId: args.subagentAgentId,\n      parentAgentId: this.parentAgentId,\n      parentToolCallId: args.parentToolCallId,\n      phase: args.phase,\n      data: args.data,\n      label: args.label,\n      timestamp: new Date().toISOString(),\n    };\n    try {\n      await handler.handle(GraphEvents.ON_SUBAGENT_UPDATE, event);\n    } catch {\n      /* observational — swallow */\n    }\n  }\n\n  /**\n   * Builds a BaseCallbackHandler that intercepts the child graph's custom\n   * events. Routing rules:\n   *   - `ON_TOOL_EXECUTE` → forwarded as-is to the parent's ON_TOOL_EXECUTE\n   *     handler (so event-driven tools work identically for child and parent).\n   *   - `ON_RUN_STEP` / `ON_RUN_STEP_DELTA` / `ON_RUN_STEP_COMPLETED` /\n   *     `ON_MESSAGE_DELTA` / `ON_REASONING_DELTA` → wrapped in a\n   *     {@link GraphEvents.ON_SUBAGENT_UPDATE} envelope with a human-readable\n   *     label, delivered to the parent's subagent-update handler.\n   *   - Everything else → ignored (keeps parent's UI scoped to the events it\n   *     cares about; host apps can extend by registering more phases).\n   */\n  private createForwarderCallback(args: {\n    parentRegistry: HandlerRegistry;\n    subagentType: string;\n    subagentAgentId: string;\n    childRunId: string;\n    parentToolCallId?: string;\n  }): ForwarderCallback {\n    const {\n      parentRegistry,\n      subagentType,\n      subagentAgentId,\n      childRunId,\n      parentToolCallId,\n    } = args;\n    const parentRunId = this.parentRunId;\n    const parentAgentId = this.parentAgentId;\n\n    const wrap = async (\n      eventName: string,\n      phase: SubagentUpdatePhase,\n      data: unknown\n    ): Promise<void> => {\n      const handler = parentRegistry.getHandler(GraphEvents.ON_SUBAGENT_UPDATE);\n      if (!handler) {\n        return;\n      }\n      try {\n        const event: SubagentUpdateEvent = {\n          runId: parentRunId,\n          subagentRunId: childRunId,\n          subagentType,\n          subagentAgentId,\n          parentAgentId,\n          parentToolCallId,\n          phase,\n          data: sanitizeForwardedSubagentUpdateData(eventName, data),\n          label: summarizeEvent(eventName, data),\n          timestamp: new Date().toISOString(),\n        };\n        await handler.handle(GraphEvents.ON_SUBAGENT_UPDATE, event);\n      } catch {\n        /* observational — swallow */\n      }\n    };\n\n    const queuedUpdates: QueuedSubagentUpdate[] = [];\n    let drainPromise: Promise<void> | undefined;\n\n    const enqueue = (update: QueuedSubagentUpdate): void => {\n      if (queuedUpdates.length >= MAX_PENDING_SUBAGENT_UPDATES) {\n        const dropIndex = queuedUpdates.findIndex((queued) =>\n          isDroppableSubagentUpdatePhase(queued.phase)\n        );\n        if (dropIndex >= 0) {\n          queuedUpdates.splice(dropIndex, 1);\n        } else if (isDroppableSubagentUpdatePhase(update.phase)) {\n          return;\n        }\n      }\n      queuedUpdates.push(update);\n    };\n\n    const drain = async (): Promise<void> => {\n      if (drainPromise != null) {\n        await drainPromise;\n        return;\n      }\n      drainPromise = (async (): Promise<void> => {\n        while (queuedUpdates.length > 0) {\n          const update = queuedUpdates.shift();\n          if (update == null) {\n            continue;\n          }\n          await wrap(update.eventName, update.phase, update.data);\n        }\n      })();\n      try {\n        await drainPromise;\n      } finally {\n        drainPromise = undefined;\n        if (queuedUpdates.length > 0) {\n          await drain();\n        }\n      }\n    };\n\n    const scheduleWrap = (\n      eventName: string,\n      phase: SubagentUpdatePhase,\n      data: unknown\n    ): void => {\n      enqueue({ eventName, phase, data });\n      void drain();\n    };\n\n    const handler = BaseCallbackHandler.fromMethods({\n      [Callback.CUSTOM_EVENT]: async (\n        eventName: string,\n        data: unknown\n      ): Promise<void> => {\n        if (eventName === GraphEvents.ON_TOOL_EXECUTE) {\n          const toolHandler = parentRegistry.getHandler(\n            GraphEvents.ON_TOOL_EXECUTE\n          );\n          if (toolHandler) {\n            await toolHandler.handle(\n              GraphEvents.ON_TOOL_EXECUTE,\n              data as ToolExecuteBatchRequest\n            );\n          }\n          /**\n           * We also surface a short notice in the subagent-update stream so\n           * the UI can show \"calling <tool>\" for each tool the child spawns.\n           */\n          scheduleWrap(eventName, 'run_step', data);\n          return;\n        }\n\n        if (eventName === GraphEvents.ON_RUN_STEP) {\n          scheduleWrap(eventName, 'run_step', data);\n          return;\n        }\n        if (eventName === GraphEvents.ON_RUN_STEP_DELTA) {\n          scheduleWrap(eventName, 'run_step_delta', data);\n          return;\n        }\n        if (eventName === GraphEvents.ON_RUN_STEP_COMPLETED) {\n          scheduleWrap(eventName, 'run_step_completed', data);\n          return;\n        }\n        if (eventName === GraphEvents.ON_MESSAGE_DELTA) {\n          scheduleWrap(eventName, 'message_delta', data);\n          return;\n        }\n        if (eventName === GraphEvents.ON_REASONING_DELTA) {\n          scheduleWrap(eventName, 'reasoning_delta', data);\n          return;\n        }\n      },\n    });\n    /**\n     * `awaitHandlers = true` is required so the child's `ToolNode` actually\n     * blocks on the parent's `ON_TOOL_EXECUTE` handler until it resolves\n     * the batch request. Observational `ON_SUBAGENT_UPDATE` calls are queued\n     * behind a bounded sequential dispatcher so host UI publication cannot\n     * backpressure each child emission or run unbounded concurrent publishes.\n     * The executor drains this queue before terminal stop/error envelopes to\n     * preserve phase ordering.\n     */\n    handler.awaitHandlers = true;\n    return { handler, drain };\n  }\n}\n\n/**\n * Builds the child-run equivalent of a host `CHAT_MODEL_END` handler: a\n * callback that joins per-call model identity (captured from\n * `ls_model_name` at chat-model start) with the usage metadata reported at\n * LLM end, and emits a {@link SubagentUsageEvent} through the host's sink.\n *\n * Attached to the child `workflow.invoke` callbacks array, so it observes\n * every model call inside the child graph — the agent loop and any\n * auxiliary calls (e.g. child-side summarization). It does NOT observe\n * deeper subagent levels: each nesting level replaces the callback chain\n * and attaches its own capture handler via the forwarded\n * `subagentUsageSink` on the child graph's input.\n */\nfunction createUsageCaptureHandler(args: {\n  sink: SubagentUsageSink;\n  subagentType: string;\n  subagentRunId: string;\n  subagentAgentId: string;\n  parentRunId: string;\n  /**\n   * Child config's provider enum — the default tag when a call carries no\n   * `INVOKED_PROVIDER` metadata (hosts key pricing/cache semantics off it).\n   */\n  provider?: string;\n  /**\n   * Child config's model, used when a call carries neither `ls_model_name`\n   * nor `INVOKED_MODEL` metadata.\n   */\n  fallbackModel?: string;\n}): BaseCallbackHandler {\n  const {\n    sink,\n    subagentType,\n    subagentRunId,\n    subagentAgentId,\n    parentRunId,\n    provider,\n    fallbackModel,\n  } = args;\n  /**\n   * Per-call attribution keyed by LangChain callback runId. `model` joins\n   * `ls_model_name` (provider-reported) with `INVOKED_MODEL` (stamped by\n   * `tryFallbackProviders` from the fallback's client options); `provider`\n   * is `INVOKED_PROVIDER`, stamped by `attemptInvoke` with the SDK enum of\n   * the provider that ACTUALLY served the call — correct for\n   * fallback-served calls, where the static config provider would mis-tag\n   * pricing/cache semantics.\n   */\n  const callInfoByCallId = new Map<\n    string,\n    { model?: string; provider?: string }\n  >();\n  const handler = BaseCallbackHandler.fromMethods({\n    handleChatModelStart: (\n      _llm: unknown,\n      _messages: unknown,\n      runId: string,\n      _parentRunId?: string,\n      _extraParams?: Record<string, unknown>,\n      _tags?: string[],\n      metadata?: Record<string, unknown>\n    ): void => {\n      const callModel =\n        asNonEmptyString(metadata?.ls_model_name) ??\n        asNonEmptyString(metadata?.[Constants.INVOKED_MODEL]);\n      const callProvider = asNonEmptyString(\n        metadata?.[Constants.INVOKED_PROVIDER]\n      );\n      if (callModel != null || callProvider != null) {\n        callInfoByCallId.set(runId, {\n          model: callModel,\n          provider: callProvider,\n        });\n      }\n    },\n    handleLLMEnd: async (output: LLMResult, runId: string): Promise<void> => {\n      const callInfo = callInfoByCallId.get(runId);\n      callInfoByCallId.delete(runId);\n      const model = callInfo?.model ?? fallbackModel;\n      const callProvider = callInfo?.provider ?? provider;\n      for (const generationGroup of output.generations) {\n        /**\n         * At most ONE event per generation group: each group is one\n         * provider request (the outer array is per-prompt for batched\n         * calls), and with multiple completions (`n > 1`) every choice in\n         * a group repeats the request-level `usage_metadata` — emitting\n         * per choice would multiply billed tokens.\n         */\n        for (const generation of generationGroup) {\n          const message = (generation as ChatGeneration | undefined)?.message;\n          const usage = (\n            message as { usage_metadata?: UsageMetadata } | undefined\n          )?.usage_metadata;\n          if (usage == null) {\n            continue;\n          }\n          /**\n           * Awaited so async host sinks (billing/persistence) complete\n           * before the model call resolves — `awaitHandlers` only waits on\n           * `handleLLMEnd` itself, so a dropped promise here would let the\n           * parent run finish before usage is recorded and would turn sink\n           * rejections into unhandled rejections.\n           */\n          try {\n            await sink({\n              usage,\n              model,\n              provider: callProvider,\n              subagentType,\n              subagentRunId,\n              subagentAgentId,\n              runId: parentRunId,\n            });\n          } catch {\n            /* observational — a throwing/rejecting host sink must not break the child run */\n          }\n          break;\n        }\n      }\n    },\n    handleLLMError: (_err: unknown, runId: string): void => {\n      callInfoByCallId.delete(runId);\n    },\n  });\n  /**\n   * Dispatch usage synchronously with each model call so all entries are\n   * sunk before `workflow.invoke` resolves — hosts read their accumulator\n   * right after the parent run completes.\n   */\n  handler.awaitHandlers = true;\n  return handler;\n}\n\nfunction asNonEmptyString(value: unknown): string | undefined {\n  return typeof value === 'string' && value !== '' ? value : undefined;\n}\n\n/**\n * Best-effort read of the configured model from a subagent's client\n * options. Providers disagree on the key (`model` vs `modelName`), and the\n * value is only a fallback for calls that carry no `ls_model_name`.\n */\nfunction extractConfiguredModel(agentInputs: AgentInputs): string | undefined {\n  const clientOptions = agentInputs.clientOptions as\n    | { model?: unknown; modelName?: unknown }\n    | undefined;\n  if (typeof clientOptions?.model === 'string' && clientOptions.model !== '') {\n    return clientOptions.model;\n  }\n  if (\n    typeof clientOptions?.modelName === 'string' &&\n    clientOptions.modelName !== ''\n  ) {\n    return clientOptions.modelName;\n  }\n  return undefined;\n}\n\nfunction sanitizeChildConfigurable(\n  parentConfigurable: Record<string, unknown> | undefined\n): Record<string, unknown> {\n  if (parentConfigurable == null) {\n    return {};\n  }\n  return Object.fromEntries(\n    Object.entries(parentConfigurable).filter(\n      ([key]) => !isLangGraphRuntimeConfigKey(key)\n    )\n  );\n}\n\nfunction isLangGraphRuntimeConfigKey(key: string): boolean {\n  return (\n    key.startsWith(LANGGRAPH_RUNTIME_CONFIG_PREFIX) ||\n    LANGGRAPH_CHECKPOINT_CONFIG_KEYS.has(key)\n  );\n}\n\nexport function sanitizeForwardedSubagentUpdateData(\n  eventName: string,\n  data: unknown\n): unknown {\n  if (eventName === GraphEvents.ON_TOOL_EXECUTE) {\n    return sanitizeToolExecuteUpdateData(data);\n  }\n  if (eventName === GraphEvents.ON_RUN_STEP) {\n    return sanitizeRunStepUpdateData(data);\n  }\n  if (eventName === GraphEvents.ON_RUN_STEP_DELTA) {\n    return sanitizeRunStepDeltaUpdateData(data);\n  }\n  if (eventName === GraphEvents.ON_RUN_STEP_COMPLETED) {\n    return sanitizeRunStepCompletedUpdateData(data);\n  }\n  if (eventName === GraphEvents.ON_MESSAGE_DELTA) {\n    return sanitizeMessageDeltaUpdateData(data);\n  }\n  if (eventName === GraphEvents.ON_REASONING_DELTA) {\n    return sanitizeReasoningDeltaUpdateData(data);\n  }\n  return undefined;\n}\n\nfunction isDroppableSubagentUpdatePhase(phase: SubagentUpdatePhase): boolean {\n  return (\n    phase === 'message_delta' ||\n    phase === 'reasoning_delta' ||\n    phase === 'run_step_delta'\n  );\n}\n\nfunction sanitizeToolExecuteUpdateData(\n  data: unknown\n): SanitizedSubagentToolExecuteData {\n  const request = data as Partial<ToolExecuteBatchRequest>;\n  const toolCalls = Array.isArray(request.toolCalls)\n    ? request.toolCalls.map(sanitizeToolCallForUpdate)\n    : [];\n  const sanitized: SanitizedSubagentToolExecuteData = { toolCalls };\n  if (typeof request.agentId === 'string') {\n    sanitized.agentId = request.agentId;\n  }\n  return sanitized;\n}\n\nfunction sanitizeToolCallForUpdate(\n  call: ToolExecuteBatchRequest['toolCalls'][number]\n): SanitizedSubagentToolCall {\n  const sanitized: SanitizedSubagentToolCall = {\n    id: call.id,\n    name: call.name,\n    args: call.args,\n  };\n  return sanitized;\n}\n\nfunction sanitizeRunStepUpdateData(\n  data: unknown\n): SanitizedRunStep | undefined {\n  if (!isObjectLike(data)) {\n    return undefined;\n  }\n  const step = data as Partial<RunStep>;\n  const sanitized: SanitizedRunStep = {};\n  assignString(sanitized, 'agentId', step.agentId);\n  assignNumber(sanitized, 'groupId', step.groupId);\n  assignString(sanitized, 'id', step.id);\n  assignNumber(sanitized, 'index', step.index);\n  assignString(sanitized, 'runId', step.runId);\n  assignNumber(sanitized, 'stepIndex', step.stepIndex);\n  assignString(sanitized, 'type', step.type);\n  if (step.summary !== undefined) {\n    sanitized.summary = step.summary;\n  }\n  if (step.usage !== undefined) {\n    sanitized.usage = step.usage;\n  }\n  sanitized.stepDetails = sanitizeStepDetails(step.stepDetails);\n  return sanitized;\n}\n\nfunction sanitizeRunStepDeltaUpdateData(\n  data: unknown\n): SanitizedRunStepDelta | undefined {\n  if (!isObjectLike(data)) {\n    return undefined;\n  }\n  const event = data as Partial<RunStepDeltaEvent>;\n  const sanitized: SanitizedRunStepDelta = {};\n  assignString(sanitized, 'id', event.id);\n  sanitized.delta = sanitizeToolCallDelta(event.delta);\n  return sanitized;\n}\n\nfunction sanitizeRunStepCompletedUpdateData(\n  data: unknown\n): SanitizedRunStepCompleted | undefined {\n  if (!isObjectLike(data)) {\n    return undefined;\n  }\n  const event = data as { result?: unknown };\n  return { result: sanitizeStepCompleted(event.result) };\n}\n\nfunction sanitizeMessageDeltaUpdateData(\n  data: unknown\n): SanitizedMessageDelta | undefined {\n  if (!isObjectLike(data)) {\n    return undefined;\n  }\n  const event = data as Partial<MessageDeltaEvent>;\n  const sanitized: SanitizedMessageDelta = {};\n  assignString(sanitized, 'id', event.id);\n  if (event.delta != null) {\n    sanitized.delta = {};\n    if (event.delta.content !== undefined) {\n      sanitized.delta.content = event.delta.content;\n    }\n    if (event.delta.tool_call_ids !== undefined) {\n      sanitized.delta.tool_call_ids = event.delta.tool_call_ids;\n    }\n  }\n  return sanitized;\n}\n\nfunction sanitizeReasoningDeltaUpdateData(\n  data: unknown\n): SanitizedReasoningDelta | undefined {\n  if (!isObjectLike(data)) {\n    return undefined;\n  }\n  const event = data as Partial<ReasoningDeltaEvent>;\n  const sanitized: SanitizedReasoningDelta = {};\n  assignString(sanitized, 'id', event.id);\n  if (event.delta?.content !== undefined) {\n    sanitized.delta = { content: event.delta.content };\n  }\n  return sanitized;\n}\n\nfunction sanitizeStepDetails(\n  stepDetails: unknown\n): SanitizedStepDetails | undefined {\n  if (!isObjectLike(stepDetails)) {\n    return undefined;\n  }\n  const rawDetails = stepDetails as {\n    message_creation?: { message_id?: unknown };\n    tool_calls?: unknown[];\n    type?: unknown;\n  };\n  if (rawDetails.type === StepTypes.MESSAGE_CREATION) {\n    const sanitized: SanitizedStepDetails = {\n      type: StepTypes.MESSAGE_CREATION,\n    };\n    const messageId = rawDetails.message_creation?.message_id;\n    if (typeof messageId === 'string') {\n      sanitized.message_creation = { message_id: messageId };\n    }\n    return sanitized;\n  }\n  if (rawDetails.type === StepTypes.TOOL_CALLS) {\n    const sanitized: SanitizedStepDetails = {\n      type: StepTypes.TOOL_CALLS,\n    };\n    if (Array.isArray(rawDetails.tool_calls)) {\n      sanitized.tool_calls = rawDetails.tool_calls.map(sanitizeAgentToolCall);\n    }\n    return sanitized;\n  }\n  return undefined;\n}\n\nfunction sanitizeToolCallDelta(\n  delta: ToolCallDelta | undefined\n): SanitizedToolCallDelta | undefined {\n  if (!isObjectLike(delta)) {\n    return undefined;\n  }\n  const sanitized: SanitizedToolCallDelta = {};\n  assignString(sanitized, 'auth', delta.auth);\n  assignNumber(sanitized, 'expires_at', delta.expires_at);\n  assignString(sanitized, 'type', delta.type);\n  if (delta.summary !== undefined) {\n    sanitized.summary = delta.summary;\n  }\n  if (Array.isArray(delta.tool_calls)) {\n    sanitized.tool_calls = delta.tool_calls.map(sanitizeAgentToolCall);\n  }\n  return sanitized;\n}\n\nfunction sanitizeStepCompleted(\n  data: unknown\n): SanitizedStepCompleted | undefined {\n  if (!isObjectLike(data)) {\n    return undefined;\n  }\n  const completed = data as Partial<StepCompleted> & {\n    id?: unknown;\n    index?: unknown;\n    tool_call?: unknown;\n  };\n  if (completed.type === 'summary') {\n    return {\n      type: 'summary',\n      summary: completed.summary,\n    };\n  }\n  if (completed.type !== 'tool_call') {\n    return undefined;\n  }\n  const sanitized: SanitizedStepCompleted = { type: 'tool_call' };\n  assignString(sanitized, 'id', completed.id);\n  assignNumber(sanitized, 'index', completed.index);\n  sanitized.tool_call = sanitizeProcessedToolCall(completed.tool_call);\n  return sanitized;\n}\n\nfunction sanitizeProcessedToolCall(\n  toolCall: unknown\n): SanitizedProcessedToolCall | undefined {\n  if (!isObjectLike(toolCall)) {\n    return undefined;\n  }\n  const call = toolCall as Partial<ProcessedToolCall>;\n  const sanitized: SanitizedProcessedToolCall = {};\n  assignString(sanitized, 'id', call.id);\n  assignString(sanitized, 'name', call.name);\n  if (call.args !== undefined) {\n    sanitized.args = call.args;\n  }\n  assignString(sanitized, 'output', call.output);\n  assignString(sanitized, 'outcome', call.outcome);\n  assignNumber(sanitized, 'progress', call.progress);\n  return sanitized;\n}\n\nfunction sanitizeAgentToolCall(toolCall: unknown): SanitizedAgentToolCall {\n  if (!isObjectLike(toolCall)) {\n    return {};\n  }\n  const call = toolCall as SanitizedAgentToolCall;\n  const sanitized: SanitizedAgentToolCall = {};\n  assignString(sanitized, 'id', call.id);\n  assignString(sanitized, 'name', call.name);\n  assignString(sanitized, 'type', call.type);\n  if (call.args !== undefined) {\n    sanitized.args = call.args;\n  }\n  if (isObjectLike(call.function)) {\n    const fn: SanitizedAgentToolCall['function'] = {};\n    assignString(fn, 'name', call.function.name);\n    if (\n      typeof call.function.arguments === 'string' ||\n      isObjectLike(call.function.arguments)\n    ) {\n      fn.arguments = call.function.arguments;\n    }\n    sanitized.function = fn;\n  }\n  return sanitized;\n}\n\nfunction isObjectLike(value: unknown): value is object {\n  return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction assignString<T extends object, K extends keyof T>(\n  target: T,\n  key: K,\n  value: unknown\n): void {\n  if (typeof value === 'string') {\n    target[key] = value as T[K];\n  }\n}\n\nfunction assignNumber<T extends object, K extends keyof T>(\n  target: T,\n  key: K,\n  value: unknown\n): void {\n  if (typeof value === 'number') {\n    target[key] = value as T[K];\n  }\n}\n\n/**\n * Produces a short single-line label for an arbitrary forwarded child event.\n * Used to populate {@link SubagentUpdateEvent.label} so the host UI can show\n * a compact status ticker without parsing the raw payload.\n */\nexport function summarizeEvent(eventName: string, data: unknown): string {\n  if (eventName === GraphEvents.ON_TOOL_EXECUTE) {\n    const req = data as { toolCalls?: Array<{ name?: string }> };\n    const names = (req.toolCalls ?? [])\n      .map((c) => c.name)\n      .filter((n): n is string => typeof n === 'string');\n    return names.length > 0 ? `Calling ${names.join(', ')}` : 'Calling tool';\n  }\n  if (eventName === GraphEvents.ON_RUN_STEP) {\n    const step = data as {\n      type?: string;\n      stepDetails?: { type?: string; tool_calls?: Array<{ name?: string }> };\n    };\n    const detailType = step.stepDetails?.type ?? step.type ?? 'step';\n    if (detailType === 'tool_calls') {\n      const names = (step.stepDetails?.tool_calls ?? [])\n        .map((c) => c.name)\n        .filter((n): n is string => typeof n === 'string');\n      return names.length > 0\n        ? `Using tool: ${names.join(', ')}`\n        : 'Planning tool call';\n    }\n    if (detailType === 'message_creation') {\n      return 'Thinking…';\n    }\n    return `Step: ${detailType}`;\n  }\n  if (eventName === GraphEvents.ON_RUN_STEP_COMPLETED) {\n    const step = data as {\n      result?: {\n        type?: string;\n        tool_call?: { name?: string; output?: string };\n      };\n    };\n    const tool = step.result?.tool_call;\n    if (tool?.name != null && tool.name !== '') {\n      return `Tool ${tool.name} complete`;\n    }\n    return 'Step complete';\n  }\n  if (eventName === GraphEvents.ON_MESSAGE_DELTA) {\n    return 'Streaming…';\n  }\n  return eventName;\n}\n\n/**\n * Walk messages from last to first, returning the text content of the most\n * recent AIMessage that has any. Non-text blocks (tool_use, thinking,\n * redacted_thinking, tool_result) are stripped. If the last AIMessage is\n * pure tool_use (e.g. the subagent hit `maxTurns` mid-tool-call), the walk\n * continues to earlier AIMessages so partial progress is salvaged — this\n * matches Claude Code's behavior in `agentToolUtils.finalizeAgentTool`.\n * Returns \"Task completed\" only when no AIMessage in the history contains\n * any text.\n */\nexport function filterSubagentResult(messages: BaseMessage[]): string {\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (messages[i]._getType() !== 'ai') {\n      continue;\n    }\n\n    const content = messages[i].content;\n\n    if (typeof content === 'string') {\n      if (content) return content;\n      continue;\n    }\n\n    if (!Array.isArray(content)) {\n      continue;\n    }\n\n    const textParts: string[] = [];\n    for (const block of content) {\n      if (typeof block === 'string') {\n        textParts.push(block);\n      } else if ('type' in block && block.type === 'text' && 'text' in block) {\n        textParts.push(block.text as string);\n      }\n    }\n\n    if (textParts.length > 0) {\n      return textParts.join('\\n');\n    }\n  }\n\n  return 'Task completed';\n}\n\n/**\n * Resolve self-spawn configs by filling in agentInputs from the parent context.\n * Returns configs with agentInputs guaranteed present. Throws on duplicate\n * `type` values to prevent silent config shadowing.\n */\nexport function resolveSubagentConfigs(\n  configs: SubagentConfig[],\n  parentContext: AgentContext\n): ResolvedSubagentConfig[] {\n  const resolved = configs\n    .map((config) => {\n      if (config.agentInputs != null) {\n        return config as ResolvedSubagentConfig;\n      }\n      if (config.self !== true || parentContext._sourceInputs == null) {\n        return null;\n      }\n      return {\n        ...config,\n        agentInputs: { ...parentContext._sourceInputs },\n      } as ResolvedSubagentConfig;\n    })\n    .filter((c): c is ResolvedSubagentConfig => c != null);\n\n  const seenTypes = new Set<string>();\n  for (const config of resolved) {\n    if (seenTypes.has(config.type)) {\n      throw new Error(\n        `Duplicate subagent type \"${config.type}\". Each SubagentConfig must have a unique \"type\" field.`\n      );\n    }\n    seenTypes.add(config.type);\n  }\n\n  return resolved;\n}\n\n/**\n * Build child AgentInputs from a resolved config, stripping nesting and\n * (optionally) event-driven fields. When `allowNested: true`, the child's\n * `maxSubagentDepth` is decremented so that depth is consumed as the call\n * chain deepens across graph boundaries — the parent's executor-level check\n * alone cannot see into the child graph's separate executor.\n *\n * When `keepToolDefinitions` is `true`, the child retains the parent's\n * `toolDefinitions` so event-driven tools remain usable. This is only safe\n * when the caller has wired a forwarder for `ON_TOOL_EXECUTE` to a\n * registered handler — otherwise the child will hang on tool dispatch.\n *\n * @remarks Advanced utility: exported primarily for testing and by\n * {@link SubagentExecutor}. Host applications configuring subagents should\n * not need to call this directly — it is invoked internally when a subagent\n * tool is dispatched. The depth-countdown contract (parent's `maxDepth` in,\n * child's decremented `maxSubagentDepth` on the returned inputs) is the\n * mechanism that bounds nesting across graph boundaries; callers must\n * respect it.\n */\nexport function buildChildInputs(\n  config: ResolvedSubagentConfig,\n  childAgentId: string,\n  parentMaxDepth: number,\n  keepToolDefinitions: boolean = false\n): AgentInputs {\n  const { agentInputs } = config;\n  const childInputs: AgentInputs = {\n    ...agentInputs,\n    agentId: childAgentId,\n    toolDefinitions: keepToolDefinitions\n      ? agentInputs.toolDefinitions\n      : undefined,\n    /**\n     * Subagents run in an isolated context by contract. Parent-run-scoped\n     * fields that would otherwise survive the shallow-spread clone — the\n     * cross-run conversation summary and the prior-turn tool-discovery\n     * set — are cleared here so the child starts fresh. Host applications\n     * that want a subagent to see parent context must thread it in\n     * explicitly (e.g. via the `description` argument to the subagent\n     * tool), not via inherited state.\n     */\n    initialSummary: undefined,\n    discoveredTools: undefined,\n    /**\n     * Host-supplied direct tools are scrubbed from INHERITED configs only.\n     * A self-spawn config's `agentInputs` is a shallow spread of the parent's\n     * `_sourceInputs`, so without this a parent-scoped graph tool (e.g. an\n     * interrupt-raising ask_user_question, which needs the parent's\n     * checkpointer — child graphs compile without one) would silently leak\n     * into the child and deterministically throw `No checkpointer set`. An\n     * EXPLICIT child config that lists its own `graphTools` is a deliberate\n     * host choice and keeps them (Codex #289 P2).\n     */\n    graphTools: config.self === true ? undefined : agentInputs.graphTools,\n  };\n\n  if (config.allowNested === true) {\n    childInputs.maxSubagentDepth = Math.max(0, parentMaxDepth - 1);\n  } else {\n    childInputs.subagentConfigs = undefined;\n    childInputs.maxSubagentDepth = undefined;\n  }\n\n  return childInputs;\n}\n\nfunction truncateErrorMessage(error: unknown): string {\n  const message = error instanceof Error ? error.message : String(error);\n  if (message.length <= ERROR_MESSAGE_MAX_CHARS) {\n    return message;\n  }\n  return `${message.slice(0, ERROR_MESSAGE_MAX_CHARS)}...`;\n}\n"],"mappings":"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"}

package/dist/cjs/tools/toolOutputReferences.cjs

@@ -1,5 +1,6 @@
 const require_truncation = require("../utils/truncation.cjs");
 const require_toolContent = require("../utils/toolContent.cjs");
+require("./intentArg.cjs");
 let _langchain_core_messages = require("@langchain/core/messages");
 //#region src/tools/toolOutputReferences.ts
 /**
@@ -25,6 +26,16 @@ let _langchain_core_messages = require("@langchain/core/messages");
 * registry pristine means downstream bash/jq piping receives the
 * complete, verbatim output with no injected fields.
 */
+/** Parses a stringified JSON object arg; undefined for anything else. */
+function parseStringifiedArgsObject(value) {
+	if (!value.trim().startsWith("{")) return;
+	try {
+		const parsed = JSON.parse(value);
+		if (parsed != null && typeof parsed === "object" && !Array.isArray(parsed)) return parsed;
+	} catch {
+		return;
+	}
+}
 /**
 * Non-global matcher for a single `{{tool<i>turn<n>}}` placeholder.
 * Exported for consumers that want to detect references (e.g., syntax
@@ -234,13 +245,13 @@ var ToolOutputReferenceRegistry = class ToolOutputReferenceRegistry {
 	* the serialized args, the original input is returned without
 	* walking the tree.
 	*/
-	resolve(runId, args) {
+	resolve(runId, args, options) {
 		if (!hasAnyPlaceholder(args)) return {
 			resolved: args,
 			unresolved: []
 		};
 		const bucket = this.runStates.get(this.keyFor(runId));
-		return this.resolveAgainst(bucket?.entries ?? EMPTY_ENTRIES, args);
+		return this.resolveAgainst(bucket?.entries ?? EMPTY_ENTRIES, args, options);
 	}
 	/**
 	* Captures a frozen snapshot of `runId`'s current entries and
@@ -256,26 +267,49 @@ var ToolOutputReferenceRegistry = class ToolOutputReferenceRegistry {
 	snapshot(runId) {
 		const bucket = this.runStates.get(this.keyFor(runId));
 		const entries = bucket ? new Map(bucket.entries) : EMPTY_ENTRIES;
-		return { resolve: (args) => this.resolveAgainst(entries, args) };
+		return { resolve: (args, options) => this.resolveAgainst(entries, args, options) };
 	}
-	resolveAgainst(entries, args) {
+	resolveAgainst(entries, args, options) {
 		if (!hasAnyPlaceholder(args)) return {
 			resolved: args,
 			unresolved: []
 		};
+		const exemptIntentKey = options?.substituteIntentKey !== true;
 		const unresolved = /* @__PURE__ */ new Set();
+		/**
+		* Providers may deliver the args OBJECT as a JSON string. A plain
+		* string-root transform would expand placeholders inside the `intent`
+		* label too, bypassing the top-level exclusion below — parse, transform
+		* key-aware, and re-serialize so the label stays verbatim while every
+		* other field still substitutes. Only taken when an `intent` key is
+		* actually present; other strings keep the fast raw-string path.
+		*/
+		if (exemptIntentKey && typeof args === "string") {
+			const parsedRoot = parseStringifiedArgsObject(args);
+			if (parsedRoot != null && "intent" in parsedRoot) return {
+				resolved: JSON.stringify(this.transform(entries, parsedRoot, unresolved, true)),
+				unresolved: Array.from(unresolved)
+			};
+		}
 		return {
-			resolved: this.transform(entries, args, unresolved),
+			resolved: this.transform(entries, args, unresolved, exemptIntentKey),
 			unresolved: Array.from(unresolved)
 		};
 	}
-	transform(entries, value, unresolved) {
+	transform(entries, value, unresolved, exemptRootIntent = false) {
 		if (typeof value === "string") return this.replaceInString(entries, value, unresolved);
 		if (Array.isArray(value)) return value.map((item) => this.transform(entries, item, unresolved));
 		if (value !== null && typeof value === "object") {
 			const source = value;
 			const next = {};
-			for (const [key, item] of Object.entries(source)) next[key] = this.transform(entries, item, unresolved);
+			for (const [key, item] of Object.entries(source))
+ /**
+			* The top-level `intent` arg is a display label, never a data
+			* channel: expanding a `{{tool<i>turn<n>}}` placeholder there would
+			* dump a stored output (up to the registry cap) into a single-line
+			* UI label and persist it with the message. Left verbatim instead.
+			*/
+			next[key] = exemptRootIntent && key === "intent" ? item : this.transform(entries, item, unresolved);
 			return next;
 		}
 		return value;