@librechat/agents 3.2.35 → 3.2.37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (98) hide show
  1. package/dist/cjs/agents/AgentContext.cjs +75 -2
  2. package/dist/cjs/agents/AgentContext.cjs.map +1 -1
  3. package/dist/cjs/agents/projection.cjs +25 -0
  4. package/dist/cjs/agents/projection.cjs.map +1 -0
  5. package/dist/cjs/graphs/Graph.cjs +10 -26
  6. package/dist/cjs/graphs/Graph.cjs.map +1 -1
  7. package/dist/cjs/langfuse.cjs +16 -5
  8. package/dist/cjs/langfuse.cjs.map +1 -1
  9. package/dist/cjs/langfuseToolOutputTracing.cjs +7 -0
  10. package/dist/cjs/langfuseToolOutputTracing.cjs.map +1 -1
  11. package/dist/cjs/llm/anthropic/utils/message_inputs.cjs +118 -7
  12. package/dist/cjs/llm/anthropic/utils/message_inputs.cjs.map +1 -1
  13. package/dist/cjs/llm/bedrock/utils/message_inputs.cjs +44 -4
  14. package/dist/cjs/llm/bedrock/utils/message_inputs.cjs.map +1 -1
  15. package/dist/cjs/main.cjs +7 -0
  16. package/dist/cjs/messages/budget.cjs +23 -0
  17. package/dist/cjs/messages/budget.cjs.map +1 -0
  18. package/dist/cjs/messages/cache.cjs +184 -0
  19. package/dist/cjs/messages/cache.cjs.map +1 -1
  20. package/dist/cjs/messages/index.cjs +1 -0
  21. package/dist/cjs/summarization/node.cjs +1 -1
  22. package/dist/cjs/summarization/node.cjs.map +1 -1
  23. package/dist/cjs/tools/search/format.cjs +91 -2
  24. package/dist/cjs/tools/search/format.cjs.map +1 -1
  25. package/dist/cjs/tools/search/tool.cjs +4 -3
  26. package/dist/cjs/tools/search/tool.cjs.map +1 -1
  27. package/dist/cjs/tools/toolOutputReferences.cjs +28 -14
  28. package/dist/cjs/tools/toolOutputReferences.cjs.map +1 -1
  29. package/dist/esm/agents/AgentContext.mjs +76 -3
  30. package/dist/esm/agents/AgentContext.mjs.map +1 -1
  31. package/dist/esm/agents/projection.mjs +25 -0
  32. package/dist/esm/agents/projection.mjs.map +1 -0
  33. package/dist/esm/graphs/Graph.mjs +9 -25
  34. package/dist/esm/graphs/Graph.mjs.map +1 -1
  35. package/dist/esm/langfuse.mjs +16 -5
  36. package/dist/esm/langfuse.mjs.map +1 -1
  37. package/dist/esm/langfuseToolOutputTracing.mjs +7 -0
  38. package/dist/esm/langfuseToolOutputTracing.mjs.map +1 -1
  39. package/dist/esm/llm/anthropic/utils/message_inputs.mjs +118 -7
  40. package/dist/esm/llm/anthropic/utils/message_inputs.mjs.map +1 -1
  41. package/dist/esm/llm/bedrock/utils/message_inputs.mjs +44 -4
  42. package/dist/esm/llm/bedrock/utils/message_inputs.mjs.map +1 -1
  43. package/dist/esm/main.mjs +4 -2
  44. package/dist/esm/messages/budget.mjs +23 -0
  45. package/dist/esm/messages/budget.mjs.map +1 -0
  46. package/dist/esm/messages/cache.mjs +182 -1
  47. package/dist/esm/messages/cache.mjs.map +1 -1
  48. package/dist/esm/messages/index.mjs +1 -0
  49. package/dist/esm/summarization/node.mjs +2 -2
  50. package/dist/esm/summarization/node.mjs.map +1 -1
  51. package/dist/esm/tools/search/format.mjs +91 -2
  52. package/dist/esm/tools/search/format.mjs.map +1 -1
  53. package/dist/esm/tools/search/tool.mjs +4 -3
  54. package/dist/esm/tools/search/tool.mjs.map +1 -1
  55. package/dist/esm/tools/toolOutputReferences.mjs +28 -14
  56. package/dist/esm/tools/toolOutputReferences.mjs.map +1 -1
  57. package/dist/types/agents/AgentContext.d.ts +30 -1
  58. package/dist/types/agents/projection.d.ts +26 -0
  59. package/dist/types/index.d.ts +1 -0
  60. package/dist/types/messages/budget.d.ts +11 -0
  61. package/dist/types/messages/cache.d.ts +47 -0
  62. package/dist/types/messages/index.d.ts +1 -0
  63. package/dist/types/tools/search/format.d.ts +4 -1
  64. package/dist/types/tools/search/types.d.ts +7 -0
  65. package/dist/types/types/graph.d.ts +2 -0
  66. package/package.json +2 -1
  67. package/src/agents/AgentContext.ts +105 -4
  68. package/src/agents/__tests__/AgentContext.test.ts +232 -9
  69. package/src/agents/__tests__/projection.test.ts +73 -0
  70. package/src/agents/projection.ts +46 -0
  71. package/src/graphs/Graph.ts +66 -65
  72. package/src/index.ts +3 -0
  73. package/src/langfuse.ts +38 -4
  74. package/src/langfuseToolOutputTracing.ts +18 -0
  75. package/src/llm/anthropic/utils/cross-provider-reasoning.test.ts +317 -0
  76. package/src/llm/anthropic/utils/message_inputs.ts +209 -19
  77. package/src/llm/anthropic/utils/stripPrefillCache.test.ts +111 -0
  78. package/src/llm/bedrock/utils/cross-provider-reasoning.test.ts +131 -0
  79. package/src/llm/bedrock/utils/message_inputs.test.ts +129 -0
  80. package/src/llm/bedrock/utils/message_inputs.ts +81 -4
  81. package/src/llm/bedrock/utils/toolResultCachePoint.test.ts +103 -0
  82. package/src/messages/budget.ts +32 -0
  83. package/src/messages/cache.tail.test.ts +340 -0
  84. package/src/messages/cache.ts +267 -1
  85. package/src/messages/index.ts +1 -0
  86. package/src/messages/tailCacheConversion.test.ts +161 -0
  87. package/src/scripts/bench-prompt-cache.ts +479 -0
  88. package/src/specs/langfuse-config.test.ts +69 -2
  89. package/src/specs/langfuse-metadata.test.ts +44 -0
  90. package/src/specs/langfuse-tool-output-tracing.test.ts +6 -0
  91. package/src/summarization/node.ts +2 -2
  92. package/src/tools/__tests__/annotateMessagesForLLM.test.ts +50 -0
  93. package/src/tools/search/format.test.ts +242 -0
  94. package/src/tools/search/format.ts +122 -5
  95. package/src/tools/search/tool.ts +5 -1
  96. package/src/tools/search/types.ts +7 -0
  97. package/src/tools/toolOutputReferences.ts +34 -20
  98. package/src/types/graph.ts +2 -0
@@ -682,28 +682,42 @@ export function annotateMessagesForLLM(
682
682
  liveRef,
683
683
  unresolved
684
684
  );
685
- } else if (
686
- annotates &&
687
- Array.isArray(tm.content) &&
688
- unresolved.length > 0
689
- ) {
690
- const warningBlock = {
691
- type: 'text' as const,
692
- text: `[unresolved refs: ${unresolved.join(', ')}]`,
693
- };
685
+ } else if (annotates && Array.isArray(tm.content)) {
694
686
  /**
695
- * `as unknown as ToolMessage['content']` is unavoidable here:
696
- * LangChain's content union (`MessageContentComplex[] |
697
- * DataContentBlock[] | string`) does not accept a freshly built
698
- * mixed array literal even though the structural shape is valid
699
- * at runtime. The double-cast is structurally safe we
700
- * preserve every block from `tm.content` and prepend a single
701
- * `{ type: 'text', text }` block that all providers accept.
687
+ * Array tool content. The string annotator can't run this notably
688
+ * includes a tail tool result that prompt caching rewrote from a string
689
+ * into a text-block array to host its `cache_control` / `cachePoint`
690
+ * marker (the `_refKey` survives on `additional_kwargs`). Project the
691
+ * same markers the string path would, as leading text blocks: the live
692
+ * `[ref: …]` prefix and/or the unresolved-refs warning. Without this the
693
+ * common tool-result tail loses its reference marker once cached.
694
+ *
695
+ * `as unknown as ToolMessage['content']` is unavoidable: LangChain's
696
+ * content union does not accept a freshly built mixed array literal even
697
+ * though the structural shape is valid at runtime. The double-cast is
698
+ * structurally safe — every original block is preserved and only
699
+ * `{ type: 'text', text }` blocks (which all providers accept) are
700
+ * prepended.
702
701
  */
703
- nextContent = [
704
- warningBlock,
705
- ...tm.content,
706
- ] as unknown as ToolMessage['content'];
702
+ const prefixBlocks: Array<{ type: 'text'; text: string }> = [];
703
+ if (liveRef != null) {
704
+ prefixBlocks.push({
705
+ type: 'text',
706
+ text: buildReferencePrefix(liveRef),
707
+ });
708
+ }
709
+ if (unresolved.length > 0) {
710
+ prefixBlocks.push({
711
+ type: 'text',
712
+ text: `[unresolved refs: ${unresolved.join(', ')}]`,
713
+ });
714
+ }
715
+ if (prefixBlocks.length > 0) {
716
+ nextContent = [
717
+ ...prefixBlocks,
718
+ ...tm.content,
719
+ ] as unknown as ToolMessage['content'];
720
+ }
707
721
  }
708
722
 
709
723
  /**
@@ -536,6 +536,8 @@ export interface LangfuseConfig {
536
536
  publicKey?: string;
537
537
  secretKey?: string;
538
538
  baseUrl?: string;
539
+ metadata?: Record<string, string | number | boolean | null | undefined>;
540
+ tags?: string[];
539
541
  toolNodeTracing?: LangfuseToolNodeTracingConfig;
540
542
  toolOutputTracing?: LangfuseToolOutputTracingConfig;
541
543
  /**