🤖 feat: Agent Handoffs (Routing) (#10176)

* feat: Add support for agent handoffs with edges in agent forms and schemas

chore: Mark `agent_ids` field as deprecated in favor of edges across various schemas and types

chore: Update dependencies for @langchain/core and @librechat/agents to latest versions

chore: Update peer dependency for @librechat/agents to version 3.0.0-rc2 in package.json

chore: Update @librechat/agents dependency to version 3.0.0-rc3 in package.json and package-lock.json

feat: first pass, multi-agent handoffs

fix: update output type to ToolMessage in memory handling functions

fix: improve type checking for graphConfig in createRun function

refactor: remove unused content filtering logic in AgentClient

chore: update @librechat/agents dependency to version 3.0.0-rc4 in package.json and package-lock.json

fix: update @langchain/core peer dependency version to ^0.3.72 in package.json and package-lock.json

fix: update @librechat/agents dependency to version 3.0.0-rc6 in package.json and package-lock.json; refactor stream rate handling in various endpoints

feat: Agent handoff UI

chore: update @librechat/agents dependency to version 3.0.0-rc8 in package.json and package-lock.json

fix: improve hasInfo condition and adjust UI element classes in AgentHandoff component

refactor: remove current fixed agent display from AgentHandoffs component due to redundancy

feat: enhance AgentHandoffs UI with localized beta label and improved layout

chore: update @librechat/agents dependency to version 3.0.0-rc10 in package.json and package-lock.json

feat: add `createSequentialChainEdges` function to add back agent chaining via multi-agents

feat: update `createSequentialChainEdges` call to only provide conversation context between agents

feat: deprecate Agent Chain functionality and update related methods for improved clarity

* chore: update @librechat/agents dependency to version 3.0.0-rc11 in package.json and package-lock.json

* refactor: remove unused addCacheControl function and related imports and import from @librechat/agents

* chore: remove unused i18n keys

* refactor: remove unused format export from index.ts

* chore: update @librechat/agents to v3.0.0-rc13

* chore: remove BEDROCK_LEGACY provider from Providers enum

* chore: update @librechat/agents to version 3.0.2 in package.json

packages/api/src/agents/chain.ts

@@ -0,0 +1,47 @@
+import { PromptTemplate } from '@langchain/core/prompts';
+import { BaseMessage, getBufferString } from '@langchain/core/messages';
+import type { GraphEdge } from '@librechat/agents';
+
+const DEFAULT_PROMPT_TEMPLATE = `Based on the following conversation and analysis from previous agents, please provide your insights:\n\n{convo}\n\nPlease add your specific expertise and perspective to this discussion.`;
+
+/**
+ * Helper function to create sequential chain edges with buffer string prompts
+ *
+ * @deprecated Agent Chain helper
+ * @param agentIds - Array of agent IDs in order of execution
+ * @param promptTemplate - Optional prompt template string; defaults to a predefined template if not provided
+ * @returns Array of edges configured for sequential chain with buffer prompts
+ */
+export async function createSequentialChainEdges(
+  agentIds: string[],
+  promptTemplate = DEFAULT_PROMPT_TEMPLATE,
+): Promise<GraphEdge[]> {
+  const edges: GraphEdge[] = [];
+
+  for (let i = 0; i < agentIds.length - 1; i++) {
+    const fromAgent = agentIds[i];
+    const toAgent = agentIds[i + 1];
+
+    edges.push({
+      from: fromAgent,
+      to: toAgent,
+      edgeType: 'direct',
+      // Use a prompt function to create the buffer string from all previous results
+      prompt: async (messages: BaseMessage[], startIndex: number) => {
+        /** Only the messages from this run (after startIndex) are passed in */
+        const runMessages = messages.slice(startIndex);
+        const bufferString = getBufferString(runMessages);
+        const template = PromptTemplate.fromTemplate(promptTemplate);
+        const result = await template.invoke({
+          convo: bufferString,
+        });
+        return result.value;
+      },
+      /** Critical: exclude previous results so only the prompt is passed */
+      excludeResults: true,
+      description: `Sequential chain from ${fromAgent} to ${toAgent}`,
+    });
+  }
+
+  return edges;
+}