From cfffd43184d27a565e19bc062fd2cc3ecdddab18 Mon Sep 17 00:00:00 2001
From: Danny Avila <danny@librechat.ai>
Date: Wed, 3 Sep 2025 21:19:24 -0400
Subject: [PATCH] chore: Mark `agent_ids` field as deprecated in favor of edges
 across various schemas and types

---
 client/src/common/agents-types.ts              | 1 +
 packages/api/src/agents/validation.ts          | 1 +
 packages/data-provider/src/types/assistants.ts | 1 +
 packages/data-schemas/src/schema/agent.ts      | 1 +
 packages/data-schemas/src/types/agent.ts       | 1 +
 5 files changed, 5 insertions(+)

diff --git a/client/src/common/agents-types.ts b/client/src/common/agents-types.ts
index dd31189484..43448a478f 100644
--- a/client/src/common/agents-types.ts
+++ b/client/src/common/agents-types.ts
@@ -34,6 +34,7 @@ export type AgentForm = {
   model_parameters: AgentModelParameters;
   tools?: string[];
   provider?: AgentProvider | OptionWithIcon;
+  /** @deprecated Use edges instead */
   agent_ids?: string[];
   edges?: GraphEdge[];
   [AgentCapabilities.artifacts]?: ArtifactModes | string;
diff --git a/packages/api/src/agents/validation.ts b/packages/api/src/agents/validation.ts
index 499b124940..80d5b78ccd 100644
--- a/packages/api/src/agents/validation.ts
+++ b/packages/api/src/agents/validation.ts
@@ -57,6 +57,7 @@ export const agentBaseSchema = z.object({
   avatar: agentAvatarSchema.nullable().optional(),
   model_parameters: z.record(z.unknown()).optional(),
   tools: z.array(z.string()).optional(),
+  /** @deprecated Use edges instead */
   agent_ids: z.array(z.string()).optional(),
   edges: z.array(graphEdgeSchema).optional(),
   end_after_tools: z.boolean().optional(),
diff --git a/packages/data-provider/src/types/assistants.ts b/packages/data-provider/src/types/assistants.ts
index 02e5cddb40..f5ebbf4b81 100644
--- a/packages/data-provider/src/types/assistants.ts
+++ b/packages/data-provider/src/types/assistants.ts
@@ -225,6 +225,7 @@ export type Agent = {
   /** @deprecated Use ACL permissions instead */
   isCollaborative?: boolean;
   tool_resources?: AgentToolResources;
+  /** @deprecated Use edges instead */
   agent_ids?: string[];
   edges?: GraphEdge[];
   end_after_tools?: boolean;
diff --git a/packages/data-schemas/src/schema/agent.ts b/packages/data-schemas/src/schema/agent.ts
index 5c4e5c5e5c..716c105000 100644
--- a/packages/data-schemas/src/schema/agent.ts
+++ b/packages/data-schemas/src/schema/agent.ts
@@ -68,6 +68,7 @@ const agentSchema = new Schema<IAgent>(
     end_after_tools: {
       type: Boolean,
     },
+    /** @deprecated Use edges instead */
     agent_ids: {
       type: [String],
     },
diff --git a/packages/data-schemas/src/types/agent.ts b/packages/data-schemas/src/types/agent.ts
index 9084d7c431..2a60635751 100644
--- a/packages/data-schemas/src/types/agent.ts
+++ b/packages/data-schemas/src/types/agent.ts
@@ -28,6 +28,7 @@ export interface IAgent extends Omit<Document, 'model'> {
   authorName?: string;
   hide_sequential_outputs?: boolean;
   end_after_tools?: boolean;
+  /** @deprecated Use edges instead */
   agent_ids?: string[];
   edges?: GraphEdge[];
   /** @deprecated Use ACL permissions instead */