Releasing version

Releasing version

Author: oci-dex-release-bot

CHANGELOG.md

@@ -3,6 +3,11 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/).
 
+## 3.68.2 - 2025-07-15
+### Added 
+- Support for calling Oracle Cloud Infrastructure services in the ap-delhi-1 region 
+- Support for Generative Agent Development Kit (ADK) MCP features
+
 ## 3.68.1 - 2025-07-08
 ### Added 
 - Support for insight of Autonomous Database on Exadata Cloud@Customer (ADB on ExaC@C) in the Operations Insights service 

bmc-accessgovernancecp/pom.xml

@@ -4,7 +4,7 @@
   <parent>
     <groupId>com.oracle.oci.sdk</groupId>
     <artifactId>oci-java-sdk</artifactId>
-    <version>3.68.1</version>
+    <version>3.68.2</version>
     <relativePath>../pom.xml</relativePath>
   </parent>
   <artifactId>oci-java-sdk-accessgovernancecp</artifactId>
@@ -15,7 +15,7 @@
     <dependency>
       <groupId>com.oracle.oci.sdk</groupId>
       <artifactId>oci-java-sdk-common</artifactId>
-      <version>3.68.1</version>
+      <version>3.68.2</version>
     </dependency>
   </dependencies>
 </project>

bmc-addons/bmc-adk/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.oracle.oci.sdk</groupId>
         <artifactId>oci-java-sdk-addons</artifactId>
-        <version>3.68.1</version>
+        <version>3.68.2</version>
     </parent>
 
     <artifactId>oci-java-sdk-addons-adk</artifactId>

bmc-addons/bmc-adk/src/main/java/com/oracle/bmc/adk/agent/Agent.java

@@ -5,7 +5,6 @@
 package com.oracle.bmc.adk.agent;
 
 import com.fasterxml.jackson.core.JsonProcessingException;
-import com.fasterxml.jackson.databind.ObjectMapper;
 import com.fasterxml.jackson.databind.ser.impl.SimpleBeanPropertyFilter;
 import com.fasterxml.jackson.databind.ser.impl.SimpleFilterProvider;
 import com.google.gson.Gson;
@@ -18,6 +17,7 @@
 import com.oracle.bmc.adk.tools.prebuilt.AgenticRagTool;
 import com.oracle.bmc.adk.utils.Console;
 import com.oracle.bmc.adk.utils.Constants;
+import com.oracle.bmc.adk.utils.JsonUtils;
 import com.oracle.bmc.generativeaiagent.model.AgentEndpoint;
 import com.oracle.bmc.generativeaiagent.model.Function;
 import com.oracle.bmc.generativeaiagent.model.FunctionCallingToolConfig;
@@ -62,8 +62,6 @@ public class Agent {
     private final List<FunctionTool> localFunctionTools;
     private final AgenticRagTool localRagTool;
 
-    private static final ObjectMapper objectMapper = new ObjectMapper();
-
     /**
      * Constructor to initialize Agent with basic parameters only. Internal fields (like handler
      * functions, rag tools, and endpoint) are not initialized.
@@ -946,7 +944,7 @@ private FunctionCallingPerformedAction executeFunctionCall(
             String functionArgsObj = functionCall.getArguments();
 
             Map<String, Object> functionArgs =
-                    objectMapper.readValue((String) functionArgsObj, Map.class);
+                    JsonUtils.OBJECT_MAPPER.readValue((String) functionArgsObj, Map.class);
 
             // Find the appropriate function handler
             FunctionTool handler = null;
@@ -975,7 +973,7 @@ private FunctionCallingPerformedAction executeFunctionCall(
             // Return the performed action details
             return FunctionCallingPerformedAction.builder()
                     .actionId(action.getActionId())
-                    .functionCallOutput(objectMapper.writeValueAsString(result))
+                    .functionCallOutput(JsonUtils.OBJECT_MAPPER.writeValueAsString(result))
                     .build();
 
         } catch (JsonProcessingException e) {
@@ -1056,7 +1054,7 @@ private Map<String, Object> responseToMap(ChatResponse response) {
         SimpleFilterProvider filterProvider = new SimpleFilterProvider();
         filterProvider.addFilter("explicitlySetFilter", SimpleBeanPropertyFilter.serializeAll());
 
-        objectMapper.setFilterProvider(filterProvider);
-        return objectMapper.convertValue(response, Map.class);
+        JsonUtils.OBJECT_MAPPER.setFilterProvider(filterProvider);
+        return JsonUtils.OBJECT_MAPPER.convertValue(response, Map.class);
     }
 }

bmc-addons/bmc-adk/src/main/java/com/oracle/bmc/adk/client/mcp/McpClient.java

@@ -0,0 +1,81 @@
+/**
+ * Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+ * This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+ */
+package com.oracle.bmc.adk.client.mcp;
+
+import com.oracle.bmc.adk.error.McpException;
+import com.oracle.bmc.adk.module.McpSchema;
+import com.oracle.bmc.adk.tools.FunctionTool;
+import com.oracle.bmc.adk.tools.Toolkit;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Interface for a Model Context Protocol (MCP) client.
+ *
+ * <p>An MCP client establishes a connection to an MCP server, lists available tools, and invokes
+ * tools on the remote MCP server.
+ */
+public interface McpClient extends AutoCloseable {
+
+    /**
+     * Connects to the MCP server. This method must be called before using any other client
+     * operations.
+     *
+     * @throws McpException if a connection failure occurs
+     */
+    void connect() throws McpException;
+
+    /**
+     * Releases resources and closes the connection to the server. This method is idempotent and
+     * safe to call multiple times.
+     */
+    void close();
+
+    /**
+     * Gets the display name associated with the client or server connection.
+     *
+     * @return the display name or {@code null} if not set
+     */
+    String getName();
+
+    /**
+     * Retrieves the list of tools available on the connected MCP server.
+     *
+     * @return list of {@link McpSchema.Tool} instances
+     * @throws McpException if an error occurs during the request
+     */
+    List<McpSchema.Tool> listTools() throws McpException;
+
+    /**
+     * Invokes a tool on the MCP server with the specified arguments.
+     *
+     * @param toolName the unique name of the tool to invoke
+     * @param args arguments to pass to the tool
+     * @return the result of the tool invocation
+     * @throws McpException if invocation fails or the client is not connected
+     */
+    McpSchema.CallToolResult callTool(String toolName, Map<String, Object> args)
+            throws McpException;
+
+    /**
+     * Returns all registered tools as a list of {@link FunctionTool} wrappers for agent
+     * orchestration.
+     *
+     * @return list of converted {@link FunctionTool} objects
+     */
+    List<FunctionTool> asTools();
+
+    /**
+     * Converts the MCP client into a {@link Toolkit} representation, wrapping the client's tools as
+     * {@link FunctionTool} instances. This allows the MCP client's tools to be used in contexts
+     * that expect a {@link Toolkit}. The resulting {@link Toolkit} is initialized with the provided
+     * {@code toolkitName}.
+     *
+     * @param toolkitName the name to be used for the resulting {@link Toolkit}
+     * @return a {@link Toolkit} representation of the MCP client's tools, with the specified name
+     */
+    Toolkit asToolkit(String toolkitName);
+}