From 798ebed89e08d203da39af0421aeb210a5c87626 Mon Sep 17 00:00:00 2001
From: WenjinXie <wenjin272@gmail.com>
Date: Thu, 22 Jan 2026 17:23:14 +0800
Subject: [PATCH 1/3] [example] Fix the missing parameter type modification.

---
 .../flink/agents/examples/agents/ProductSuggestionAgent.java    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/src/main/java/org/apache/flink/agents/examples/agents/ProductSuggestionAgent.java b/examples/src/main/java/org/apache/flink/agents/examples/agents/ProductSuggestionAgent.java
index b7742f207..4daac9adf 100644
--- a/examples/src/main/java/org/apache/flink/agents/examples/agents/ProductSuggestionAgent.java
+++ b/examples/src/main/java/org/apache/flink/agents/examples/agents/ProductSuggestionAgent.java
@@ -60,7 +60,7 @@ public static ResourceDescriptor generateSuggestionModel() {
         return ResourceDescriptor.Builder.newBuilder(OLLAMA_CHAT_MODEL_SETUP)
                 .addInitialArgument("connection", "ollamaChatModelConnection")
                 .addInitialArgument("model", "qwen3:8b")
-                .addInitialArgument("extract_reasoning", "true")
+                .addInitialArgument("extract_reasoning", true)
                 .addInitialArgument("prompt", "productSuggestionPrompt")
                 .build();
     }

From 14cf31d4e16d2b2db85c72861c676f9db8856045 Mon Sep 17 00:00:00 2001
From: WenjinXie <wenjin272@gmail.com>
Date: Fri, 23 Jan 2026 11:35:57 +0800
Subject: [PATCH 2/3] [package] Provide module assembling runtime dependencies
 to help run flink-agents in IDE.

---
 examples/pom.xml    |  33 +++----
 ide-support/pom.xml | 203 ++++++++++++++++++++++++++++++++++++++++++++
 pom.xml             |   1 +
 3 files changed, 216 insertions(+), 21 deletions(-)
 create mode 100644 ide-support/pom.xml

diff --git a/examples/pom.xml b/examples/pom.xml
index 96ee9b717..5e5e8a4e3 100644
--- a/examples/pom.xml
+++ b/examples/pom.xml
@@ -29,44 +29,35 @@ under the License.
     <name>Flink Agents : Examples</name>
 
     <dependencies>
+        <!-- Flink-Agents API -->
         <dependency>
             <groupId>org.apache.flink</groupId>
             <artifactId>flink-agents-api</artifactId>
             <version>${project.version}</version>
+            <scope>provided</scope>
         </dependency>
-
-        <!-- Dependencies required for running agents in minicluster -->
-        <dependency>
-            <groupId>org.apache.flink</groupId>
-            <artifactId>flink-agents-runtime</artifactId>
-            <version>${project.version}</version>
-        </dependency>
-        <dependency>
-            <groupId>org.apache.flink</groupId>
-            <artifactId>flink-connector-files</artifactId>
-            <version>${flink.version}</version>
-        </dependency>
+        <!-- Flink API -->
         <dependency>
             <groupId>org.apache.flink</groupId>
             <artifactId>flink-streaming-java</artifactId>
             <version>${flink.version}</version>
+            <scope>provided</scope>
         </dependency>
+        <!-- Connectors -->
         <dependency>
             <groupId>org.apache.flink</groupId>
-            <artifactId>flink-table-api-java-bridge</artifactId>
-            <version>${flink.version}</version>
-        </dependency>
-        <dependency>
-            <groupId>org.apache.flink</groupId>
-            <artifactId>flink-table-planner_2.12</artifactId>
+            <artifactId>flink-connector-files</artifactId>
             <version>${flink.version}</version>
         </dependency>
+
+        <!-- Dependencies required for running agents in ide. -->
+        <!-- Running in IDE require enable run with provided dependencies. -->
         <dependency>
             <groupId>org.apache.flink</groupId>
-            <artifactId>flink-clients</artifactId>
-            <version>${flink.version}</version>
+            <artifactId>flink-agents-ide-support</artifactId>
+            <version>${project.version}</version>
+            <scope>provided</scope>
         </dependency>
-
     </dependencies>
 
 </project>
\ No newline at end of file
diff --git a/ide-support/pom.xml b/ide-support/pom.xml
new file mode 100644
index 000000000..0bbd554db
--- /dev/null
+++ b/ide-support/pom.xml
@@ -0,0 +1,203 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+  http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.apache.flink</groupId>
+        <artifactId>flink-agents</artifactId>
+        <version>0.2-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>flink-agents-ide-support</artifactId>
+    <name>Flink Agents : IDE Support</name>
+    <description>
+        This module contains no source code, is just for assembling flink-agents and flink dependencies
+        needed when run agent in IDE.
+    </description>
+
+    <dependencies>
+        <!-- Flink-Agents runtime dependencies -->
+        <dependency>
+            <groupId>org.apache.flink</groupId>
+            <artifactId>flink-agents-runtime</artifactId>
+            <version>${project.version}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-agents-api</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <!-- Flink-Agents integration dependencies -->
+        <dependency>
+            <groupId>org.apache.flink</groupId>
+            <artifactId>flink-agents-integrations-chat-models-ollama</artifactId>
+            <version>${project.version}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-agents-api</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.flink</groupId>
+            <artifactId>flink-agents-integrations-chat-models-openai</artifactId>
+            <version>${project.version}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-agents-api</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.flink</groupId>
+            <artifactId>flink-agents-integrations-chat-models-anthropic</artifactId>
+            <version>${project.version}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-agents-api</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.flink</groupId>
+            <artifactId>flink-agents-integrations-chat-models-azureai</artifactId>
+            <version>${project.version}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-agents-api</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.flink</groupId>
+            <artifactId>flink-agents-integrations-embedding-models-ollama</artifactId>
+            <version>${project.version}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-agents-api</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.flink</groupId>
+            <artifactId>flink-agents-integrations-vector-stores-elasticsearch</artifactId>
+            <version>${project.version}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-agents-api</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.flink</groupId>
+            <artifactId>flink-agents-integrations-mcp</artifactId>
+            <version>${project.version}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-agents-api</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <!-- Flink dependencies -->
+        <dependency>
+            <groupId>org.apache.flink</groupId>
+            <artifactId>flink-streaming-java</artifactId>
+            <version>${flink.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.flink</groupId>
+            <artifactId>flink-table-api-java</artifactId>
+            <version>${flink.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.flink</groupId>
+            <artifactId>flink-clients</artifactId>
+            <version>${flink.version}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-streaming-java</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-core</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-runtime</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-core-api</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-annotations</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-metrics-core</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.flink</groupId>
+            <artifactId>flink-table-api-java-bridge</artifactId>
+            <version>${flink.version}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-table-api-java</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-streaming-java</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.flink</groupId>
+            <artifactId>flink-table-planner_2.12</artifactId>
+            <version>${flink.version}</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-core</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-streaming-java</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.apache.flink</groupId>
+                    <artifactId>flink-table-api-java</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+    </dependencies>
+</project>
\ No newline at end of file
diff --git a/pom.xml b/pom.xml
index 97584bc8d..243c6faa5 100644
--- a/pom.xml
+++ b/pom.xml
@@ -63,6 +63,7 @@ under the License.
         <module>e2e-test</module>
         <module>integrations</module>
         <module>dist</module>
+        <module>ide-support</module>
     </modules>
 
     <dependencyManagement>

From 1181279aa7c0879aeddb31bf48e262ed55b0dd3a Mon Sep 17 00:00:00 2001
From: WenjinXie <wenjin272@gmail.com>
Date: Fri, 23 Jan 2026 11:36:08 +0800
Subject: [PATCH 3/3] [doc] Add documents for adding dependencies to
 flink-agents project.

Co-authored-by: Shekharrajak <shekharrajak@live.com>
---
 docs/content/docs/get-started/installation.md | 59 +++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/docs/content/docs/get-started/installation.md b/docs/content/docs/get-started/installation.md
index f6f0154a0..1aa4c1625 100644
--- a/docs/content/docs/get-started/installation.md
+++ b/docs/content/docs/get-started/installation.md
@@ -151,6 +151,65 @@ After building:
 - The Python package is installed and ready to use
 - The distribution JAR is located at: `dist/target/flink-agents-dist-*.jar`
 
+## Maven Dependencies (For Java)
+
+For developing Flink Agents applications in Java, add the following dependencies to your `pom.xml`:
+
+**Required**
+- **`flink-agents-api`** : Flink Agents API
+- **`flink-streaming-java`** and/or **`flink-table-api-java`** : Flink DataStream and/or Table API
+
+**Optional**
+- **`flink-agents-ide-support`** : Runtime execution dependencies (required for local execution/testing).
+  - Unlike running in a Flink cluster, when running in IDE, because the runtime dependencies are absent, user need additional dependencies.
+    To simplify the complexity for adding multiple dependencies in pom, flink-agents provide the above artifact.
+    This way, users only need to add this single dependency in their pom.xml.
+
+{{< hint info >}}
+All the above dependencies should be in provided scope, to avoid potential conflict with the Flink cluster.
+
+For execution in IDE, enable the feature `add dependencies with provided scope to classpath` in your IDE.
+{{< /hint >}}
+
+**Example `pom.xml`**
+
+```xml
+<properties>
+    <flink.version>2.2</flink.version>
+    <flink-agents.version>0.2-SNAPSHOT</flink-agents.version>
+</properties>
+
+<dependencies>
+    <!-- Flink Agents Core API -->
+    <dependency>
+        <groupId>org.apache.flink</groupId>
+        <artifactId>flink-agents-api</artifactId>
+        <version>${flink-agents.version}</version>
+        <scope>provide</scope>
+    </dependency>
+    <!-- Flink Core API -->
+    <dependency>
+        <groupId>org.apache.flink</groupId>
+        <artifactId>flink-streaming-java</artifactId>
+        <version>${flink.version}</version>
+        <scope>provided</scope>
+    </dependency>
+    <dependency>
+        <groupId>org.apache.flink</groupId>
+        <artifactId>flink-table-api-java</artifactId>
+        <version>${flink.version}</version>
+        <scope>provided</scope>
+    </dependency>
+
+    <!-- Dependencies required for running agents in IDE -->
+    <dependency>
+      <groupId>org.apache.flink</groupId>
+      <artifactId>flink-agents-ide-support</artifactId>
+      <version>${project.version}</version>
+      <scope>provided</scope>
+    </dependency>
+</dependencies>
+```
 
 ## Deploy to Flink Cluster