Adding VoyageAI integration

.github/workflows/close-inactive-issues.yml

@@ -10,7 +10,7 @@ jobs:
  issues: write
  pull-requests: write
  steps:
- - uses: actions/stale@v10
+ - uses: actions/stale@v11
  with:
  days-before-issue-stale: 90
  days-before-issue-close: 14

.github/workflows/codeql-analysis.yml

@@ -30,7 +30,7 @@ jobs:
 
  steps:
  - name: Checkout repository
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Initializes the CodeQL tools for scanning.
  - name: Initialize CodeQL

.github/workflows/java-build.yml

@@ -26,7 +26,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK
@@ -56,7 +56,7 @@ jobs:
  run: ./mvnw -B -Pbug-check -Pcompile-jdk${{ matrix.java-versions }} test --file pom.xml
 
  # Uploads test artifacts for each JDK version
- - uses: actions/upload-artifact@v5
+ - uses: actions/upload-artifact@v7
  if: always()
  with:
  name: test_output_sk_jdk${{ matrix.java-versions }}u

.github/workflows/java-integration-tests.yml

@@ -22,7 +22,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK

.github/workflows/java-publish-package.yml

@@ -17,7 +17,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Sets up the specified JDK version from the matrix
  - uses: actions/setup-java@v5
@@ -30,7 +30,7 @@ jobs:
  run: ./mvnw -B -DskipTests -Pcompile-jdk8 -P-compile-jdk17 clean deploy --file pom.xml -DaltDeploymentRepository=local::file:///tmp/target/staging-deploy
 
  - name: Upload Artifacts
- uses: actions/upload-artifact@v5
+ uses: actions/upload-artifact@v7
  with:
  name: Artifacts
  path: /tmp/target/staging-deploy

.github/workflows/label-issues.yml

@@ -13,7 +13,7 @@ jobs:
  permissions:
  issues: write
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  with:
  github-token: ${{ secrets.GH_ACTIONS_PR_WRITE }}
  script: |

.github/workflows/label-title-prefix.yml

@@ -15,7 +15,7 @@ jobs:
  pull-requests: write
 
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  name: "Issue/PR: update title"
  with:
  github-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/markdown-link-check.yml

@@ -13,7 +13,7 @@ jobs:
  runs-on: ubuntu-latest
  # check out the latest version of the code
  steps:
- - uses: actions/checkout@v5
+ - uses: actions/checkout@v7
 
  # Checks the status of hyperlinks in .md files in verbose mode
  - name: Check links

.github/workflows/typos.yaml

@@ -20,7 +20,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Check out code
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  - name: Use custom config file
  uses: crate-ci/typos@master

PACKAGES.md

@@ -39,6 +39,9 @@ A BOM is provided that can be used to define the versions of all Semantic Kernel
 `semantickernel-aiservices-openai`
 : Provides a connector that can be used to interact with the OpenAI API.
 
+`semantickernel-aiservices-voyageai`
+: Provides connectors for VoyageAI's embedding and reranking services, including text embeddings, contextualized embeddings, multimodal embeddings, and document reranking.
+
 ## Example Configurations
 
 ### Example: OpenAI + SQLite
@@ -72,5 +75,36 @@ POM XML for a simple project that uses OpenAI.
 </project>
 ```
 
+### Example: VoyageAI Embeddings and Reranking
+
+POM XML for a project that uses VoyageAI for embeddings and reranking.
+
+```xml
+
+<project>
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-bom</artifactId>
+ <version>${semantickernel.version}</version>
+ <scope>import</scope>
+ <type>pom</type>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-api</artifactId>
+ </dependency>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-aiservices-voyageai</artifactId>
+ </dependency>
+ </dependencies>
+</project>
+```
+
 
 

agents/semantickernel-agents-core/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/google/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 
@@ -17,7 +17,7 @@
  <dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>libraries-bom</artifactId>
- <version>26.49.0</version>
+ <version>26.80.0</version>
  <type>pom</type>
  <scope>import</scope>
  </dependency>

aiservices/huggingface/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/huggingface/src/main/java/com/microsoft/semantickernel/aiservices/huggingface/services/HuggingFacePromptExecutionSettings.java

@@ -47,7 +47,8 @@ public HuggingFacePromptExecutionSettings(PromptExecutionSettings copy) {
  copy.getUser(),
  copy.getStopSequences(),
  copy.getTokenSelectionBiases(),
- copy.getResponseFormat() == null ? null : copy.getResponseFormat());
+ copy.getResponseFormat() == null ? null : copy.getResponseFormat(),
+ copy.getMaxCompletionTokens() == null ? null : copy.getMaxCompletionTokens().toString());
  this.topK = null;
  this.repetitionPenalty = null;
  this.maxTime = null;
@@ -101,10 +102,12 @@ public HuggingFacePromptExecutionSettings(
  @Nullable Boolean details,
  @Nullable Boolean logProbs,
  @Nullable Integer topLogProbs,
- @Nullable Long seed) {
+ @Nullable Long seed,
+ @Nullable Boolean maxCompletionTokensEnable) {
  super(
  serviceId, modelId, temperature, topP, presencePenalty, frequencyPenalty, maxTokens,
- resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat);
+ resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat,
+ Boolean.toString(Boolean.TRUE.equals(maxCompletionTokensEnable)));
 
  this.topK = topK;
  this.repetitionPenalty = repetitionPenalty;
@@ -151,6 +154,7 @@ public static HuggingFacePromptExecutionSettings fromExecutionSettings(
  null,
  null,
  null,
+ null,
  null);
  }
 

aiservices/openai/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/openai/src/main/java/com/microsoft/semantickernel/aiservices/openai/chatcompletion/OpenAIChatCompletion.java

@@ -65,8 +65,8 @@
 import com.microsoft.semantickernel.orchestration.ToolCallBehavior;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonResponseSchema;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonSchemaResponseFormat;
-import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.semanticfunctions.KernelArguments;
+import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.services.chatcompletion.AuthorRole;
 import com.microsoft.semantickernel.services.chatcompletion.ChatCompletionService;
 import com.microsoft.semantickernel.services.chatcompletion.ChatHistory;
@@ -149,7 +149,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  chatHistoryResult = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(chatHistoryResult.getMessages())));
@@ -183,7 +183,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  result = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(result.getMessages())));
@@ -443,31 +443,31 @@ private Mono<ChatMessages> internalChatMessageContentsAsync(
  .getOptions();
 
  return Mono.deferContextual(contextView -> {
- ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
- SemanticKernelTelemetry.getTelemetry(invocationContext),
- contextView,
- getModelId(),
- SemanticKernelTelemetry.OPEN_AI_PROVIDER,
- options.getMaxTokens(),
- options.getTemperature(),
- options.getTopP());
-
- return getClient()
- .getChatCompletionsWithResponse(getDeploymentName(), options,
- OpenAIRequestSettings.getRequestOptions())
- .contextWrite(span.getReactorContextModifier())
- .flatMap(completionsResult -> {
- if (completionsResult.getStatusCode() >= 400) {
- return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
- "Request failed: " + completionsResult.getStatusCode()));
- }
+ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
+SemanticKernelTelemetry.getTelemetry(invocationContext),
+contextView,
+getModelId(),
+SemanticKernelTelemetry.OPEN_AI_PROVIDER,
+options.getMaxTokens(),
+options.getTemperature(),
+options.getTopP());
+
+return getClient()
+.getChatCompletionsWithResponse(getDeploymentName(), options,
+OpenAIRequestSettings.getRequestOptions())
+.contextWrite(span.getReactorContextModifier())
+.flatMap(completionsResult -> {
+if (completionsResult.getStatusCode() >= 400) {
+return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
+"Request failed: " + completionsResult.getStatusCode()));
+}
 
- return Mono.just(completionsResult.getValue());
- })
- .doOnError(span::endSpanWithError)
- .doOnSuccess(span::endSpanWithUsage)
- .doOnTerminate(span::close);
- })
+return Mono.just(completionsResult.getValue());
+})
+.doOnError(span::endSpanWithError)
+.doOnSuccess(span::endSpanWithUsage)
+.doOnTerminate(span::close);
+})
  .flatMap(completions -> {
  List<ChatResponseMessage> responseMessages = completions
  .getChoices()
@@ -920,7 +920,8 @@ private static ChatCompletionsOptions getCompletionsOptions(
  }
 
  Map<String, Integer> logit = null;
- if (promptExecutionSettings.getTokenSelectionBiases() != null) {
+ if (promptExecutionSettings.getTokenSelectionBiases() != null
+ && !promptExecutionSettings.getTokenSelectionBiases().isEmpty()) {
  logit = promptExecutionSettings
  .getTokenSelectionBiases()
  .entrySet()
@@ -937,12 +938,13 @@ private static ChatCompletionsOptions getCompletionsOptions(
  .setFrequencyPenalty(promptExecutionSettings.getFrequencyPenalty())
  .setPresencePenalty(promptExecutionSettings.getPresencePenalty())
  .setMaxTokens(promptExecutionSettings.getMaxTokens())
+ .setMaxCompletionTokens(promptExecutionSettings.getMaxCompletionTokens())
  .setN(promptExecutionSettings.getResultsPerPrompt())
  // Azure OpenAI WithData API does not allow to send empty array of stop sequences
  // Gives back "Validation error at #/stop/str: Input should be a valid string\nValidation error at #/stop/list[str]: List should have at least 1 item after validation, not 0"
  .setStop(promptExecutionSettings.getStopSequences() == null
  || promptExecutionSettings.getStopSequences().isEmpty() ? null
-: promptExecutionSettings.getStopSequences())
+ : promptExecutionSettings.getStopSequences())
  .setUser(promptExecutionSettings.getUser())
  .setLogitBias(logit);
 
@@ -1147,7 +1149,7 @@ private static OpenAIToolCallConfig getToolCallBehaviorConfig(
  toolChoice,
  toolCallBehavior.isAutoInvokeAllowed()
  && requestIndex < Math.min(MAXIMUM_INFLIGHT_AUTO_INVOKES,
-toolCallBehavior.getMaximumAutoInvokeAttempts()),
+ toolCallBehavior.getMaximumAutoInvokeAttempts()),
  null);
  }
 
@@ -1262,11 +1264,11 @@ private static ChatRequestAssistantMessage formAssistantMessage(
 
  String args = arguments != null && !arguments.isEmpty()
  ? arguments.entrySet().stream()
-.map(entry -> String.format("\"%s\": \"%s\"",
-StringEscapeUtils.escapeJson(entry.getKey()),
-StringEscapeUtils.escapeJson(
-entry.getValue().toPromptString())))
-.collect(Collectors.joining(",", "{", "}"))
+ .map(entry -> String.format("\"%s\": \"%s\"",
+ StringEscapeUtils.escapeJson(entry.getKey()),
+ StringEscapeUtils.escapeJson(
+ entry.getValue().toPromptString())))
+ .collect(Collectors.joining(",", "{", "}"))
  : "{}";
 
  String prefix = "";

.github/workflows/close-inactive-issues.yml

@@ -10,7 +10,7 @@ jobs:
  issues: write
  pull-requests: write
  steps:
- - uses: actions/stale@v10
+ - uses: actions/stale@v11
  with:
  days-before-issue-stale: 90
  days-before-issue-close: 14

.github/workflows/codeql-analysis.yml

@@ -30,7 +30,7 @@ jobs:
 
  steps:
  - name: Checkout repository
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Initializes the CodeQL tools for scanning.
  - name: Initialize CodeQL

.github/workflows/java-build.yml

@@ -26,7 +26,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK
@@ -56,7 +56,7 @@ jobs:
  run: ./mvnw -B -Pbug-check -Pcompile-jdk${{ matrix.java-versions }} test --file pom.xml
 
  # Uploads test artifacts for each JDK version
- - uses: actions/upload-artifact@v5
+ - uses: actions/upload-artifact@v7
  if: always()
  with:
  name: test_output_sk_jdk${{ matrix.java-versions }}u

.github/workflows/java-integration-tests.yml

@@ -22,7 +22,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK

.github/workflows/java-publish-package.yml

@@ -17,7 +17,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Sets up the specified JDK version from the matrix
  - uses: actions/setup-java@v5
@@ -30,7 +30,7 @@ jobs:
  run: ./mvnw -B -DskipTests -Pcompile-jdk8 -P-compile-jdk17 clean deploy --file pom.xml -DaltDeploymentRepository=local::file:///tmp/target/staging-deploy
 
  - name: Upload Artifacts
- uses: actions/upload-artifact@v5
+ uses: actions/upload-artifact@v7
  with:
  name: Artifacts
  path: /tmp/target/staging-deploy

.github/workflows/label-issues.yml

@@ -13,7 +13,7 @@ jobs:
  permissions:
  issues: write
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  with:
  github-token: ${{ secrets.GH_ACTIONS_PR_WRITE }}
  script: |

.github/workflows/label-title-prefix.yml

@@ -15,7 +15,7 @@ jobs:
  pull-requests: write
 
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  name: "Issue/PR: update title"
  with:
  github-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/markdown-link-check.yml

@@ -13,7 +13,7 @@ jobs:
  runs-on: ubuntu-latest
  # check out the latest version of the code
  steps:
- - uses: actions/checkout@v5
+ - uses: actions/checkout@v7
 
  # Checks the status of hyperlinks in .md files in verbose mode
  - name: Check links

.github/workflows/typos.yaml

@@ -20,7 +20,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Check out code
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  - name: Use custom config file
  uses: crate-ci/typos@master

PACKAGES.md

@@ -39,6 +39,9 @@ A BOM is provided that can be used to define the versions of all Semantic Kernel
 `semantickernel-aiservices-openai`
 : Provides a connector that can be used to interact with the OpenAI API.
 
+`semantickernel-aiservices-voyageai`
+: Provides connectors for VoyageAI's embedding and reranking services, including text embeddings, contextualized embeddings, multimodal embeddings, and document reranking.
+
 ## Example Configurations
 
 ### Example: OpenAI + SQLite
@@ -72,5 +75,36 @@ POM XML for a simple project that uses OpenAI.
 </project>
 ```
 
+### Example: VoyageAI Embeddings and Reranking
+
+POM XML for a project that uses VoyageAI for embeddings and reranking.
+
+```xml
+
+<project>
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-bom</artifactId>
+ <version>${semantickernel.version}</version>
+ <scope>import</scope>
+ <type>pom</type>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-api</artifactId>
+ </dependency>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-aiservices-voyageai</artifactId>
+ </dependency>
+ </dependencies>
+</project>
+```
+
 
 

agents/semantickernel-agents-core/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/google/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 
@@ -17,7 +17,7 @@
  <dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>libraries-bom</artifactId>
- <version>26.49.0</version>
+ <version>26.80.0</version>
  <type>pom</type>
  <scope>import</scope>
  </dependency>

aiservices/huggingface/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/huggingface/src/main/java/com/microsoft/semantickernel/aiservices/huggingface/services/HuggingFacePromptExecutionSettings.java

@@ -47,7 +47,8 @@ public HuggingFacePromptExecutionSettings(PromptExecutionSettings copy) {
  copy.getUser(),
  copy.getStopSequences(),
  copy.getTokenSelectionBiases(),
- copy.getResponseFormat() == null ? null : copy.getResponseFormat());
+ copy.getResponseFormat() == null ? null : copy.getResponseFormat(),
+ copy.getMaxCompletionTokens() == null ? null : copy.getMaxCompletionTokens().toString());
  this.topK = null;
  this.repetitionPenalty = null;
  this.maxTime = null;
@@ -101,10 +102,12 @@ public HuggingFacePromptExecutionSettings(
  @Nullable Boolean details,
  @Nullable Boolean logProbs,
  @Nullable Integer topLogProbs,
- @Nullable Long seed) {
+ @Nullable Long seed,
+ @Nullable Boolean maxCompletionTokensEnable) {
  super(
  serviceId, modelId, temperature, topP, presencePenalty, frequencyPenalty, maxTokens,
- resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat);
+ resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat,
+ Boolean.toString(Boolean.TRUE.equals(maxCompletionTokensEnable)));
 
  this.topK = topK;
  this.repetitionPenalty = repetitionPenalty;
@@ -151,6 +154,7 @@ public static HuggingFacePromptExecutionSettings fromExecutionSettings(
  null,
  null,
  null,
+ null,
  null);
  }
 

aiservices/openai/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/openai/src/main/java/com/microsoft/semantickernel/aiservices/openai/chatcompletion/OpenAIChatCompletion.java

@@ -65,8 +65,8 @@
 import com.microsoft.semantickernel.orchestration.ToolCallBehavior;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonResponseSchema;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonSchemaResponseFormat;
-import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.semanticfunctions.KernelArguments;
+import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.services.chatcompletion.AuthorRole;
 import com.microsoft.semantickernel.services.chatcompletion.ChatCompletionService;
 import com.microsoft.semantickernel.services.chatcompletion.ChatHistory;
@@ -149,7 +149,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  chatHistoryResult = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(chatHistoryResult.getMessages())));
@@ -183,7 +183,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  result = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(result.getMessages())));
@@ -443,31 +443,31 @@ private Mono<ChatMessages> internalChatMessageContentsAsync(
  .getOptions();
 
  return Mono.deferContextual(contextView -> {
- ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
- SemanticKernelTelemetry.getTelemetry(invocationContext),
- contextView,
- getModelId(),
- SemanticKernelTelemetry.OPEN_AI_PROVIDER,
- options.getMaxTokens(),
- options.getTemperature(),
- options.getTopP());
-
- return getClient()
- .getChatCompletionsWithResponse(getDeploymentName(), options,
- OpenAIRequestSettings.getRequestOptions())
- .contextWrite(span.getReactorContextModifier())
- .flatMap(completionsResult -> {
- if (completionsResult.getStatusCode() >= 400) {
- return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
- "Request failed: " + completionsResult.getStatusCode()));
- }
+ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
+SemanticKernelTelemetry.getTelemetry(invocationContext),
+contextView,
+getModelId(),
+SemanticKernelTelemetry.OPEN_AI_PROVIDER,
+options.getMaxTokens(),
+options.getTemperature(),
+options.getTopP());
+
+return getClient()
+.getChatCompletionsWithResponse(getDeploymentName(), options,
+OpenAIRequestSettings.getRequestOptions())
+.contextWrite(span.getReactorContextModifier())
+.flatMap(completionsResult -> {
+if (completionsResult.getStatusCode() >= 400) {
+return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
+"Request failed: " + completionsResult.getStatusCode()));
+}
 
- return Mono.just(completionsResult.getValue());
- })
- .doOnError(span::endSpanWithError)
- .doOnSuccess(span::endSpanWithUsage)
- .doOnTerminate(span::close);
- })
+return Mono.just(completionsResult.getValue());
+})
+.doOnError(span::endSpanWithError)
+.doOnSuccess(span::endSpanWithUsage)
+.doOnTerminate(span::close);
+})
  .flatMap(completions -> {
  List<ChatResponseMessage> responseMessages = completions
  .getChoices()
@@ -920,7 +920,8 @@ private static ChatCompletionsOptions getCompletionsOptions(
  }
 
  Map<String, Integer> logit = null;
- if (promptExecutionSettings.getTokenSelectionBiases() != null) {
+ if (promptExecutionSettings.getTokenSelectionBiases() != null
+ && !promptExecutionSettings.getTokenSelectionBiases().isEmpty()) {
  logit = promptExecutionSettings
  .getTokenSelectionBiases()
  .entrySet()
@@ -937,12 +938,13 @@ private static ChatCompletionsOptions getCompletionsOptions(
  .setFrequencyPenalty(promptExecutionSettings.getFrequencyPenalty())
  .setPresencePenalty(promptExecutionSettings.getPresencePenalty())
  .setMaxTokens(promptExecutionSettings.getMaxTokens())
+ .setMaxCompletionTokens(promptExecutionSettings.getMaxCompletionTokens())
  .setN(promptExecutionSettings.getResultsPerPrompt())
  // Azure OpenAI WithData API does not allow to send empty array of stop sequences
  // Gives back "Validation error at #/stop/str: Input should be a valid string\nValidation error at #/stop/list[str]: List should have at least 1 item after validation, not 0"
  .setStop(promptExecutionSettings.getStopSequences() == null
  || promptExecutionSettings.getStopSequences().isEmpty() ? null
-: promptExecutionSettings.getStopSequences())
+ : promptExecutionSettings.getStopSequences())
  .setUser(promptExecutionSettings.getUser())
  .setLogitBias(logit);
 
@@ -1147,7 +1149,7 @@ private static OpenAIToolCallConfig getToolCallBehaviorConfig(
  toolChoice,
  toolCallBehavior.isAutoInvokeAllowed()
  && requestIndex < Math.min(MAXIMUM_INFLIGHT_AUTO_INVOKES,
-toolCallBehavior.getMaximumAutoInvokeAttempts()),
+ toolCallBehavior.getMaximumAutoInvokeAttempts()),
  null);
  }
 
@@ -1262,11 +1264,11 @@ private static ChatRequestAssistantMessage formAssistantMessage(
 
  String args = arguments != null && !arguments.isEmpty()
  ? arguments.entrySet().stream()
-.map(entry -> String.format("\"%s\": \"%s\"",
-StringEscapeUtils.escapeJson(entry.getKey()),
-StringEscapeUtils.escapeJson(
-entry.getValue().toPromptString())))
-.collect(Collectors.joining(",", "{", "}"))
+ .map(entry -> String.format("\"%s\": \"%s\"",
+ StringEscapeUtils.escapeJson(entry.getKey()),
+ StringEscapeUtils.escapeJson(
+ entry.getValue().toPromptString())))
+ .collect(Collectors.joining(",", "{", "}"))
  : "{}";
 
  String prefix = "";

.github/workflows/close-inactive-issues.yml

@@ -10,7 +10,7 @@ jobs:
  issues: write
  pull-requests: write
  steps:
- - uses: actions/stale@v10
+ - uses: actions/stale@v11
  with:
  days-before-issue-stale: 90
  days-before-issue-close: 14

.github/workflows/codeql-analysis.yml

@@ -30,7 +30,7 @@ jobs:
 
  steps:
  - name: Checkout repository
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Initializes the CodeQL tools for scanning.
  - name: Initialize CodeQL

.github/workflows/java-build.yml

@@ -26,7 +26,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK
@@ -56,7 +56,7 @@ jobs:
  run: ./mvnw -B -Pbug-check -Pcompile-jdk${{ matrix.java-versions }} test --file pom.xml
 
  # Uploads test artifacts for each JDK version
- - uses: actions/upload-artifact@v5
+ - uses: actions/upload-artifact@v7
  if: always()
  with:
  name: test_output_sk_jdk${{ matrix.java-versions }}u

.github/workflows/java-integration-tests.yml

@@ -22,7 +22,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK

.github/workflows/java-publish-package.yml

@@ -17,7 +17,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Sets up the specified JDK version from the matrix
  - uses: actions/setup-java@v5
@@ -30,7 +30,7 @@ jobs:
  run: ./mvnw -B -DskipTests -Pcompile-jdk8 -P-compile-jdk17 clean deploy --file pom.xml -DaltDeploymentRepository=local::file:///tmp/target/staging-deploy
 
  - name: Upload Artifacts
- uses: actions/upload-artifact@v5
+ uses: actions/upload-artifact@v7
  with:
  name: Artifacts
  path: /tmp/target/staging-deploy

.github/workflows/label-issues.yml

@@ -13,7 +13,7 @@ jobs:
  permissions:
  issues: write
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  with:
  github-token: ${{ secrets.GH_ACTIONS_PR_WRITE }}
  script: |

.github/workflows/label-title-prefix.yml

@@ -15,7 +15,7 @@ jobs:
  pull-requests: write
 
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  name: "Issue/PR: update title"
  with:
  github-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/markdown-link-check.yml

@@ -13,7 +13,7 @@ jobs:
  runs-on: ubuntu-latest
  # check out the latest version of the code
  steps:
- - uses: actions/checkout@v5
+ - uses: actions/checkout@v7
 
  # Checks the status of hyperlinks in .md files in verbose mode
  - name: Check links

.github/workflows/typos.yaml

@@ -20,7 +20,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Check out code
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  - name: Use custom config file
  uses: crate-ci/typos@master

PACKAGES.md

@@ -39,6 +39,9 @@ A BOM is provided that can be used to define the versions of all Semantic Kernel
 `semantickernel-aiservices-openai`
 : Provides a connector that can be used to interact with the OpenAI API.
 
+`semantickernel-aiservices-voyageai`
+: Provides connectors for VoyageAI's embedding and reranking services, including text embeddings, contextualized embeddings, multimodal embeddings, and document reranking.
+
 ## Example Configurations
 
 ### Example: OpenAI + SQLite
@@ -72,5 +75,36 @@ POM XML for a simple project that uses OpenAI.
 </project>
 ```
 
+### Example: VoyageAI Embeddings and Reranking
+
+POM XML for a project that uses VoyageAI for embeddings and reranking.
+
+```xml
+
+<project>
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-bom</artifactId>
+ <version>${semantickernel.version}</version>
+ <scope>import</scope>
+ <type>pom</type>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-api</artifactId>
+ </dependency>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-aiservices-voyageai</artifactId>
+ </dependency>
+ </dependencies>
+</project>
+```
+
 
 

agents/semantickernel-agents-core/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/google/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 
@@ -17,7 +17,7 @@
  <dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>libraries-bom</artifactId>
- <version>26.49.0</version>
+ <version>26.80.0</version>
  <type>pom</type>
  <scope>import</scope>
  </dependency>

aiservices/huggingface/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/huggingface/src/main/java/com/microsoft/semantickernel/aiservices/huggingface/services/HuggingFacePromptExecutionSettings.java

@@ -47,7 +47,8 @@ public HuggingFacePromptExecutionSettings(PromptExecutionSettings copy) {
  copy.getUser(),
  copy.getStopSequences(),
  copy.getTokenSelectionBiases(),
- copy.getResponseFormat() == null ? null : copy.getResponseFormat());
+ copy.getResponseFormat() == null ? null : copy.getResponseFormat(),
+ copy.getMaxCompletionTokens() == null ? null : copy.getMaxCompletionTokens().toString());
  this.topK = null;
  this.repetitionPenalty = null;
  this.maxTime = null;
@@ -101,10 +102,12 @@ public HuggingFacePromptExecutionSettings(
  @Nullable Boolean details,
  @Nullable Boolean logProbs,
  @Nullable Integer topLogProbs,
- @Nullable Long seed) {
+ @Nullable Long seed,
+ @Nullable Boolean maxCompletionTokensEnable) {
  super(
  serviceId, modelId, temperature, topP, presencePenalty, frequencyPenalty, maxTokens,
- resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat);
+ resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat,
+ Boolean.toString(Boolean.TRUE.equals(maxCompletionTokensEnable)));
 
  this.topK = topK;
  this.repetitionPenalty = repetitionPenalty;
@@ -151,6 +154,7 @@ public static HuggingFacePromptExecutionSettings fromExecutionSettings(
  null,
  null,
  null,
+ null,
  null);
  }
 

aiservices/openai/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/openai/src/main/java/com/microsoft/semantickernel/aiservices/openai/chatcompletion/OpenAIChatCompletion.java

@@ -65,8 +65,8 @@
 import com.microsoft.semantickernel.orchestration.ToolCallBehavior;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonResponseSchema;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonSchemaResponseFormat;
-import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.semanticfunctions.KernelArguments;
+import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.services.chatcompletion.AuthorRole;
 import com.microsoft.semantickernel.services.chatcompletion.ChatCompletionService;
 import com.microsoft.semantickernel.services.chatcompletion.ChatHistory;
@@ -149,7 +149,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  chatHistoryResult = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(chatHistoryResult.getMessages())));
@@ -183,7 +183,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  result = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(result.getMessages())));
@@ -443,31 +443,31 @@ private Mono<ChatMessages> internalChatMessageContentsAsync(
  .getOptions();
 
  return Mono.deferContextual(contextView -> {
- ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
- SemanticKernelTelemetry.getTelemetry(invocationContext),
- contextView,
- getModelId(),
- SemanticKernelTelemetry.OPEN_AI_PROVIDER,
- options.getMaxTokens(),
- options.getTemperature(),
- options.getTopP());
-
- return getClient()
- .getChatCompletionsWithResponse(getDeploymentName(), options,
- OpenAIRequestSettings.getRequestOptions())
- .contextWrite(span.getReactorContextModifier())
- .flatMap(completionsResult -> {
- if (completionsResult.getStatusCode() >= 400) {
- return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
- "Request failed: " + completionsResult.getStatusCode()));
- }
+ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
+SemanticKernelTelemetry.getTelemetry(invocationContext),
+contextView,
+getModelId(),
+SemanticKernelTelemetry.OPEN_AI_PROVIDER,
+options.getMaxTokens(),
+options.getTemperature(),
+options.getTopP());
+
+return getClient()
+.getChatCompletionsWithResponse(getDeploymentName(), options,
+OpenAIRequestSettings.getRequestOptions())
+.contextWrite(span.getReactorContextModifier())
+.flatMap(completionsResult -> {
+if (completionsResult.getStatusCode() >= 400) {
+return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
+"Request failed: " + completionsResult.getStatusCode()));
+}
 
- return Mono.just(completionsResult.getValue());
- })
- .doOnError(span::endSpanWithError)
- .doOnSuccess(span::endSpanWithUsage)
- .doOnTerminate(span::close);
- })
+return Mono.just(completionsResult.getValue());
+})
+.doOnError(span::endSpanWithError)
+.doOnSuccess(span::endSpanWithUsage)
+.doOnTerminate(span::close);
+})
  .flatMap(completions -> {
  List<ChatResponseMessage> responseMessages = completions
  .getChoices()
@@ -920,7 +920,8 @@ private static ChatCompletionsOptions getCompletionsOptions(
  }
 
  Map<String, Integer> logit = null;
- if (promptExecutionSettings.getTokenSelectionBiases() != null) {
+ if (promptExecutionSettings.getTokenSelectionBiases() != null
+ && !promptExecutionSettings.getTokenSelectionBiases().isEmpty()) {
  logit = promptExecutionSettings
  .getTokenSelectionBiases()
  .entrySet()
@@ -937,12 +938,13 @@ private static ChatCompletionsOptions getCompletionsOptions(
  .setFrequencyPenalty(promptExecutionSettings.getFrequencyPenalty())
  .setPresencePenalty(promptExecutionSettings.getPresencePenalty())
  .setMaxTokens(promptExecutionSettings.getMaxTokens())
+ .setMaxCompletionTokens(promptExecutionSettings.getMaxCompletionTokens())
  .setN(promptExecutionSettings.getResultsPerPrompt())
  // Azure OpenAI WithData API does not allow to send empty array of stop sequences
  // Gives back "Validation error at #/stop/str: Input should be a valid string\nValidation error at #/stop/list[str]: List should have at least 1 item after validation, not 0"
  .setStop(promptExecutionSettings.getStopSequences() == null
  || promptExecutionSettings.getStopSequences().isEmpty() ? null
-: promptExecutionSettings.getStopSequences())
+ : promptExecutionSettings.getStopSequences())
  .setUser(promptExecutionSettings.getUser())
  .setLogitBias(logit);
 
@@ -1147,7 +1149,7 @@ private static OpenAIToolCallConfig getToolCallBehaviorConfig(
  toolChoice,
  toolCallBehavior.isAutoInvokeAllowed()
  && requestIndex < Math.min(MAXIMUM_INFLIGHT_AUTO_INVOKES,
-toolCallBehavior.getMaximumAutoInvokeAttempts()),
+ toolCallBehavior.getMaximumAutoInvokeAttempts()),
  null);
  }
 
@@ -1262,11 +1264,11 @@ private static ChatRequestAssistantMessage formAssistantMessage(
 
  String args = arguments != null && !arguments.isEmpty()
  ? arguments.entrySet().stream()
-.map(entry -> String.format("\"%s\": \"%s\"",
-StringEscapeUtils.escapeJson(entry.getKey()),
-StringEscapeUtils.escapeJson(
-entry.getValue().toPromptString())))
-.collect(Collectors.joining(",", "{", "}"))
+ .map(entry -> String.format("\"%s\": \"%s\"",
+ StringEscapeUtils.escapeJson(entry.getKey()),
+ StringEscapeUtils.escapeJson(
+ entry.getValue().toPromptString())))
+ .collect(Collectors.joining(",", "{", "}"))
  : "{}";
 
  String prefix = "";

.github/workflows/close-inactive-issues.yml

@@ -10,7 +10,7 @@ jobs:
  issues: write
  pull-requests: write
  steps:
- - uses: actions/stale@v10
+ - uses: actions/stale@v11
  with:
  days-before-issue-stale: 90
  days-before-issue-close: 14

.github/workflows/codeql-analysis.yml

@@ -30,7 +30,7 @@ jobs:
 
  steps:
  - name: Checkout repository
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Initializes the CodeQL tools for scanning.
  - name: Initialize CodeQL

.github/workflows/java-build.yml

@@ -26,7 +26,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK
@@ -56,7 +56,7 @@ jobs:
  run: ./mvnw -B -Pbug-check -Pcompile-jdk${{ matrix.java-versions }} test --file pom.xml
 
  # Uploads test artifacts for each JDK version
- - uses: actions/upload-artifact@v5
+ - uses: actions/upload-artifact@v7
  if: always()
  with:
  name: test_output_sk_jdk${{ matrix.java-versions }}u

.github/workflows/java-integration-tests.yml

@@ -22,7 +22,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK

.github/workflows/java-publish-package.yml

@@ -17,7 +17,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Sets up the specified JDK version from the matrix
  - uses: actions/setup-java@v5
@@ -30,7 +30,7 @@ jobs:
  run: ./mvnw -B -DskipTests -Pcompile-jdk8 -P-compile-jdk17 clean deploy --file pom.xml -DaltDeploymentRepository=local::file:///tmp/target/staging-deploy
 
  - name: Upload Artifacts
- uses: actions/upload-artifact@v5
+ uses: actions/upload-artifact@v7
  with:
  name: Artifacts
  path: /tmp/target/staging-deploy

.github/workflows/label-issues.yml

@@ -13,7 +13,7 @@ jobs:
  permissions:
  issues: write
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  with:
  github-token: ${{ secrets.GH_ACTIONS_PR_WRITE }}
  script: |

.github/workflows/label-title-prefix.yml

@@ -15,7 +15,7 @@ jobs:
  pull-requests: write
 
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  name: "Issue/PR: update title"
  with:
  github-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/markdown-link-check.yml

@@ -13,7 +13,7 @@ jobs:
  runs-on: ubuntu-latest
  # check out the latest version of the code
  steps:
- - uses: actions/checkout@v5
+ - uses: actions/checkout@v7
 
  # Checks the status of hyperlinks in .md files in verbose mode
  - name: Check links

.github/workflows/typos.yaml

@@ -20,7 +20,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Check out code
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  - name: Use custom config file
  uses: crate-ci/typos@master

PACKAGES.md

@@ -39,6 +39,9 @@ A BOM is provided that can be used to define the versions of all Semantic Kernel
 `semantickernel-aiservices-openai`
 : Provides a connector that can be used to interact with the OpenAI API.
 
+`semantickernel-aiservices-voyageai`
+: Provides connectors for VoyageAI's embedding and reranking services, including text embeddings, contextualized embeddings, multimodal embeddings, and document reranking.
+
 ## Example Configurations
 
 ### Example: OpenAI + SQLite
@@ -72,5 +75,36 @@ POM XML for a simple project that uses OpenAI.
 </project>
 ```
 
+### Example: VoyageAI Embeddings and Reranking
+
+POM XML for a project that uses VoyageAI for embeddings and reranking.
+
+```xml
+
+<project>
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-bom</artifactId>
+ <version>${semantickernel.version}</version>
+ <scope>import</scope>
+ <type>pom</type>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-api</artifactId>
+ </dependency>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-aiservices-voyageai</artifactId>
+ </dependency>
+ </dependencies>
+</project>
+```
+
 
 

agents/semantickernel-agents-core/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/google/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 
@@ -17,7 +17,7 @@
  <dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>libraries-bom</artifactId>
- <version>26.49.0</version>
+ <version>26.80.0</version>
  <type>pom</type>
  <scope>import</scope>
  </dependency>

aiservices/huggingface/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/huggingface/src/main/java/com/microsoft/semantickernel/aiservices/huggingface/services/HuggingFacePromptExecutionSettings.java

@@ -47,7 +47,8 @@ public HuggingFacePromptExecutionSettings(PromptExecutionSettings copy) {
  copy.getUser(),
  copy.getStopSequences(),
  copy.getTokenSelectionBiases(),
- copy.getResponseFormat() == null ? null : copy.getResponseFormat());
+ copy.getResponseFormat() == null ? null : copy.getResponseFormat(),
+ copy.getMaxCompletionTokens() == null ? null : copy.getMaxCompletionTokens().toString());
  this.topK = null;
  this.repetitionPenalty = null;
  this.maxTime = null;
@@ -101,10 +102,12 @@ public HuggingFacePromptExecutionSettings(
  @Nullable Boolean details,
  @Nullable Boolean logProbs,
  @Nullable Integer topLogProbs,
- @Nullable Long seed) {
+ @Nullable Long seed,
+ @Nullable Boolean maxCompletionTokensEnable) {
  super(
  serviceId, modelId, temperature, topP, presencePenalty, frequencyPenalty, maxTokens,
- resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat);
+ resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat,
+ Boolean.toString(Boolean.TRUE.equals(maxCompletionTokensEnable)));
 
  this.topK = topK;
  this.repetitionPenalty = repetitionPenalty;
@@ -151,6 +154,7 @@ public static HuggingFacePromptExecutionSettings fromExecutionSettings(
  null,
  null,
  null,
+ null,
  null);
  }
 

aiservices/openai/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/openai/src/main/java/com/microsoft/semantickernel/aiservices/openai/chatcompletion/OpenAIChatCompletion.java

@@ -65,8 +65,8 @@
 import com.microsoft.semantickernel.orchestration.ToolCallBehavior;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonResponseSchema;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonSchemaResponseFormat;
-import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.semanticfunctions.KernelArguments;
+import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.services.chatcompletion.AuthorRole;
 import com.microsoft.semantickernel.services.chatcompletion.ChatCompletionService;
 import com.microsoft.semantickernel.services.chatcompletion.ChatHistory;
@@ -149,7 +149,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  chatHistoryResult = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(chatHistoryResult.getMessages())));
@@ -183,7 +183,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  result = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(result.getMessages())));
@@ -443,31 +443,31 @@ private Mono<ChatMessages> internalChatMessageContentsAsync(
  .getOptions();
 
  return Mono.deferContextual(contextView -> {
- ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
- SemanticKernelTelemetry.getTelemetry(invocationContext),
- contextView,
- getModelId(),
- SemanticKernelTelemetry.OPEN_AI_PROVIDER,
- options.getMaxTokens(),
- options.getTemperature(),
- options.getTopP());
-
- return getClient()
- .getChatCompletionsWithResponse(getDeploymentName(), options,
- OpenAIRequestSettings.getRequestOptions())
- .contextWrite(span.getReactorContextModifier())
- .flatMap(completionsResult -> {
- if (completionsResult.getStatusCode() >= 400) {
- return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
- "Request failed: " + completionsResult.getStatusCode()));
- }
+ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
+SemanticKernelTelemetry.getTelemetry(invocationContext),
+contextView,
+getModelId(),
+SemanticKernelTelemetry.OPEN_AI_PROVIDER,
+options.getMaxTokens(),
+options.getTemperature(),
+options.getTopP());
+
+return getClient()
+.getChatCompletionsWithResponse(getDeploymentName(), options,
+OpenAIRequestSettings.getRequestOptions())
+.contextWrite(span.getReactorContextModifier())
+.flatMap(completionsResult -> {
+if (completionsResult.getStatusCode() >= 400) {
+return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
+"Request failed: " + completionsResult.getStatusCode()));
+}
 
- return Mono.just(completionsResult.getValue());
- })
- .doOnError(span::endSpanWithError)
- .doOnSuccess(span::endSpanWithUsage)
- .doOnTerminate(span::close);
- })
+return Mono.just(completionsResult.getValue());
+})
+.doOnError(span::endSpanWithError)
+.doOnSuccess(span::endSpanWithUsage)
+.doOnTerminate(span::close);
+})
  .flatMap(completions -> {
  List<ChatResponseMessage> responseMessages = completions
  .getChoices()
@@ -920,7 +920,8 @@ private static ChatCompletionsOptions getCompletionsOptions(
  }
 
  Map<String, Integer> logit = null;
- if (promptExecutionSettings.getTokenSelectionBiases() != null) {
+ if (promptExecutionSettings.getTokenSelectionBiases() != null
+ && !promptExecutionSettings.getTokenSelectionBiases().isEmpty()) {
  logit = promptExecutionSettings
  .getTokenSelectionBiases()
  .entrySet()
@@ -937,12 +938,13 @@ private static ChatCompletionsOptions getCompletionsOptions(
  .setFrequencyPenalty(promptExecutionSettings.getFrequencyPenalty())
  .setPresencePenalty(promptExecutionSettings.getPresencePenalty())
  .setMaxTokens(promptExecutionSettings.getMaxTokens())
+ .setMaxCompletionTokens(promptExecutionSettings.getMaxCompletionTokens())
  .setN(promptExecutionSettings.getResultsPerPrompt())
  // Azure OpenAI WithData API does not allow to send empty array of stop sequences
  // Gives back "Validation error at #/stop/str: Input should be a valid string\nValidation error at #/stop/list[str]: List should have at least 1 item after validation, not 0"
  .setStop(promptExecutionSettings.getStopSequences() == null
  || promptExecutionSettings.getStopSequences().isEmpty() ? null
-: promptExecutionSettings.getStopSequences())
+ : promptExecutionSettings.getStopSequences())
  .setUser(promptExecutionSettings.getUser())
  .setLogitBias(logit);
 
@@ -1147,7 +1149,7 @@ private static OpenAIToolCallConfig getToolCallBehaviorConfig(
  toolChoice,
  toolCallBehavior.isAutoInvokeAllowed()
  && requestIndex < Math.min(MAXIMUM_INFLIGHT_AUTO_INVOKES,
-toolCallBehavior.getMaximumAutoInvokeAttempts()),
+ toolCallBehavior.getMaximumAutoInvokeAttempts()),
  null);
  }
 
@@ -1262,11 +1264,11 @@ private static ChatRequestAssistantMessage formAssistantMessage(
 
  String args = arguments != null && !arguments.isEmpty()
  ? arguments.entrySet().stream()
-.map(entry -> String.format("\"%s\": \"%s\"",
-StringEscapeUtils.escapeJson(entry.getKey()),
-StringEscapeUtils.escapeJson(
-entry.getValue().toPromptString())))
-.collect(Collectors.joining(",", "{", "}"))
+ .map(entry -> String.format("\"%s\": \"%s\"",
+ StringEscapeUtils.escapeJson(entry.getKey()),
+ StringEscapeUtils.escapeJson(
+ entry.getValue().toPromptString())))
+ .collect(Collectors.joining(",", "{", "}"))
  : "{}";
 
  String prefix = "";

.github/workflows/close-inactive-issues.yml

@@ -10,7 +10,7 @@ jobs:
  issues: write
  pull-requests: write
  steps:
- - uses: actions/stale@v10
+ - uses: actions/stale@v11
  with:
  days-before-issue-stale: 90
  days-before-issue-close: 14

.github/workflows/codeql-analysis.yml

@@ -30,7 +30,7 @@ jobs:
 
  steps:
  - name: Checkout repository
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Initializes the CodeQL tools for scanning.
  - name: Initialize CodeQL

.github/workflows/java-build.yml

@@ -26,7 +26,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK
@@ -56,7 +56,7 @@ jobs:
  run: ./mvnw -B -Pbug-check -Pcompile-jdk${{ matrix.java-versions }} test --file pom.xml
 
  # Uploads test artifacts for each JDK version
- - uses: actions/upload-artifact@v5
+ - uses: actions/upload-artifact@v7
  if: always()
  with:
  name: test_output_sk_jdk${{ matrix.java-versions }}u

.github/workflows/java-integration-tests.yml

@@ -22,7 +22,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK

.github/workflows/java-publish-package.yml

@@ -17,7 +17,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Sets up the specified JDK version from the matrix
  - uses: actions/setup-java@v5
@@ -30,7 +30,7 @@ jobs:
  run: ./mvnw -B -DskipTests -Pcompile-jdk8 -P-compile-jdk17 clean deploy --file pom.xml -DaltDeploymentRepository=local::file:///tmp/target/staging-deploy
 
  - name: Upload Artifacts
- uses: actions/upload-artifact@v5
+ uses: actions/upload-artifact@v7
  with:
  name: Artifacts
  path: /tmp/target/staging-deploy

.github/workflows/label-issues.yml

@@ -13,7 +13,7 @@ jobs:
  permissions:
  issues: write
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  with:
  github-token: ${{ secrets.GH_ACTIONS_PR_WRITE }}
  script: |

.github/workflows/label-title-prefix.yml

@@ -15,7 +15,7 @@ jobs:
  pull-requests: write
 
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  name: "Issue/PR: update title"
  with:
  github-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/markdown-link-check.yml

@@ -13,7 +13,7 @@ jobs:
  runs-on: ubuntu-latest
  # check out the latest version of the code
  steps:
- - uses: actions/checkout@v5
+ - uses: actions/checkout@v7
 
  # Checks the status of hyperlinks in .md files in verbose mode
  - name: Check links

.github/workflows/typos.yaml

@@ -20,7 +20,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Check out code
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  - name: Use custom config file
  uses: crate-ci/typos@master

PACKAGES.md

@@ -39,6 +39,9 @@ A BOM is provided that can be used to define the versions of all Semantic Kernel
 `semantickernel-aiservices-openai`
 : Provides a connector that can be used to interact with the OpenAI API.
 
+`semantickernel-aiservices-voyageai`
+: Provides connectors for VoyageAI's embedding and reranking services, including text embeddings, contextualized embeddings, multimodal embeddings, and document reranking.
+
 ## Example Configurations
 
 ### Example: OpenAI + SQLite
@@ -72,5 +75,36 @@ POM XML for a simple project that uses OpenAI.
 </project>
 ```
 
+### Example: VoyageAI Embeddings and Reranking
+
+POM XML for a project that uses VoyageAI for embeddings and reranking.
+
+```xml
+
+<project>
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-bom</artifactId>
+ <version>${semantickernel.version}</version>
+ <scope>import</scope>
+ <type>pom</type>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-api</artifactId>
+ </dependency>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-aiservices-voyageai</artifactId>
+ </dependency>
+ </dependencies>
+</project>
+```
+
 
 

agents/semantickernel-agents-core/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/google/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 
@@ -17,7 +17,7 @@
  <dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>libraries-bom</artifactId>
- <version>26.49.0</version>
+ <version>26.80.0</version>
  <type>pom</type>
  <scope>import</scope>
  </dependency>

aiservices/huggingface/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/huggingface/src/main/java/com/microsoft/semantickernel/aiservices/huggingface/services/HuggingFacePromptExecutionSettings.java

@@ -47,7 +47,8 @@ public HuggingFacePromptExecutionSettings(PromptExecutionSettings copy) {
  copy.getUser(),
  copy.getStopSequences(),
  copy.getTokenSelectionBiases(),
- copy.getResponseFormat() == null ? null : copy.getResponseFormat());
+ copy.getResponseFormat() == null ? null : copy.getResponseFormat(),
+ copy.getMaxCompletionTokens() == null ? null : copy.getMaxCompletionTokens().toString());
  this.topK = null;
  this.repetitionPenalty = null;
  this.maxTime = null;
@@ -101,10 +102,12 @@ public HuggingFacePromptExecutionSettings(
  @Nullable Boolean details,
  @Nullable Boolean logProbs,
  @Nullable Integer topLogProbs,
- @Nullable Long seed) {
+ @Nullable Long seed,
+ @Nullable Boolean maxCompletionTokensEnable) {
  super(
  serviceId, modelId, temperature, topP, presencePenalty, frequencyPenalty, maxTokens,
- resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat);
+ resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat,
+ Boolean.toString(Boolean.TRUE.equals(maxCompletionTokensEnable)));
 
  this.topK = topK;
  this.repetitionPenalty = repetitionPenalty;
@@ -151,6 +154,7 @@ public static HuggingFacePromptExecutionSettings fromExecutionSettings(
  null,
  null,
  null,
+ null,
  null);
  }
 

aiservices/openai/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/openai/src/main/java/com/microsoft/semantickernel/aiservices/openai/chatcompletion/OpenAIChatCompletion.java

@@ -65,8 +65,8 @@
 import com.microsoft.semantickernel.orchestration.ToolCallBehavior;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonResponseSchema;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonSchemaResponseFormat;
-import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.semanticfunctions.KernelArguments;
+import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.services.chatcompletion.AuthorRole;
 import com.microsoft.semantickernel.services.chatcompletion.ChatCompletionService;
 import com.microsoft.semantickernel.services.chatcompletion.ChatHistory;
@@ -149,7 +149,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  chatHistoryResult = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(chatHistoryResult.getMessages())));
@@ -183,7 +183,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  result = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(result.getMessages())));
@@ -443,31 +443,31 @@ private Mono<ChatMessages> internalChatMessageContentsAsync(
  .getOptions();
 
  return Mono.deferContextual(contextView -> {
- ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
- SemanticKernelTelemetry.getTelemetry(invocationContext),
- contextView,
- getModelId(),
- SemanticKernelTelemetry.OPEN_AI_PROVIDER,
- options.getMaxTokens(),
- options.getTemperature(),
- options.getTopP());
-
- return getClient()
- .getChatCompletionsWithResponse(getDeploymentName(), options,
- OpenAIRequestSettings.getRequestOptions())
- .contextWrite(span.getReactorContextModifier())
- .flatMap(completionsResult -> {
- if (completionsResult.getStatusCode() >= 400) {
- return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
- "Request failed: " + completionsResult.getStatusCode()));
- }
+ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
+SemanticKernelTelemetry.getTelemetry(invocationContext),
+contextView,
+getModelId(),
+SemanticKernelTelemetry.OPEN_AI_PROVIDER,
+options.getMaxTokens(),
+options.getTemperature(),
+options.getTopP());
+
+return getClient()
+.getChatCompletionsWithResponse(getDeploymentName(), options,
+OpenAIRequestSettings.getRequestOptions())
+.contextWrite(span.getReactorContextModifier())
+.flatMap(completionsResult -> {
+if (completionsResult.getStatusCode() >= 400) {
+return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
+"Request failed: " + completionsResult.getStatusCode()));
+}
 
- return Mono.just(completionsResult.getValue());
- })
- .doOnError(span::endSpanWithError)
- .doOnSuccess(span::endSpanWithUsage)
- .doOnTerminate(span::close);
- })
+return Mono.just(completionsResult.getValue());
+})
+.doOnError(span::endSpanWithError)
+.doOnSuccess(span::endSpanWithUsage)
+.doOnTerminate(span::close);
+})
  .flatMap(completions -> {
  List<ChatResponseMessage> responseMessages = completions
  .getChoices()
@@ -920,7 +920,8 @@ private static ChatCompletionsOptions getCompletionsOptions(
  }
 
  Map<String, Integer> logit = null;
- if (promptExecutionSettings.getTokenSelectionBiases() != null) {
+ if (promptExecutionSettings.getTokenSelectionBiases() != null
+ && !promptExecutionSettings.getTokenSelectionBiases().isEmpty()) {
  logit = promptExecutionSettings
  .getTokenSelectionBiases()
  .entrySet()
@@ -937,12 +938,13 @@ private static ChatCompletionsOptions getCompletionsOptions(
  .setFrequencyPenalty(promptExecutionSettings.getFrequencyPenalty())
  .setPresencePenalty(promptExecutionSettings.getPresencePenalty())
  .setMaxTokens(promptExecutionSettings.getMaxTokens())
+ .setMaxCompletionTokens(promptExecutionSettings.getMaxCompletionTokens())
  .setN(promptExecutionSettings.getResultsPerPrompt())
  // Azure OpenAI WithData API does not allow to send empty array of stop sequences
  // Gives back "Validation error at #/stop/str: Input should be a valid string\nValidation error at #/stop/list[str]: List should have at least 1 item after validation, not 0"
  .setStop(promptExecutionSettings.getStopSequences() == null
  || promptExecutionSettings.getStopSequences().isEmpty() ? null
-: promptExecutionSettings.getStopSequences())
+ : promptExecutionSettings.getStopSequences())
  .setUser(promptExecutionSettings.getUser())
  .setLogitBias(logit);
 
@@ -1147,7 +1149,7 @@ private static OpenAIToolCallConfig getToolCallBehaviorConfig(
  toolChoice,
  toolCallBehavior.isAutoInvokeAllowed()
  && requestIndex < Math.min(MAXIMUM_INFLIGHT_AUTO_INVOKES,
-toolCallBehavior.getMaximumAutoInvokeAttempts()),
+ toolCallBehavior.getMaximumAutoInvokeAttempts()),
  null);
  }
 
@@ -1262,11 +1264,11 @@ private static ChatRequestAssistantMessage formAssistantMessage(
 
  String args = arguments != null && !arguments.isEmpty()
  ? arguments.entrySet().stream()
-.map(entry -> String.format("\"%s\": \"%s\"",
-StringEscapeUtils.escapeJson(entry.getKey()),
-StringEscapeUtils.escapeJson(
-entry.getValue().toPromptString())))
-.collect(Collectors.joining(",", "{", "}"))
+ .map(entry -> String.format("\"%s\": \"%s\"",
+ StringEscapeUtils.escapeJson(entry.getKey()),
+ StringEscapeUtils.escapeJson(
+ entry.getValue().toPromptString())))
+ .collect(Collectors.joining(",", "{", "}"))
  : "{}";
 
  String prefix = "";

.github/workflows/close-inactive-issues.yml

@@ -10,7 +10,7 @@ jobs:
  issues: write
  pull-requests: write
  steps:
- - uses: actions/stale@v10
+ - uses: actions/stale@v11
  with:
  days-before-issue-stale: 90
  days-before-issue-close: 14

.github/workflows/codeql-analysis.yml

@@ -30,7 +30,7 @@ jobs:
 
  steps:
  - name: Checkout repository
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Initializes the CodeQL tools for scanning.
  - name: Initialize CodeQL

.github/workflows/java-build.yml

@@ -26,7 +26,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK
@@ -56,7 +56,7 @@ jobs:
  run: ./mvnw -B -Pbug-check -Pcompile-jdk${{ matrix.java-versions }} test --file pom.xml
 
  # Uploads test artifacts for each JDK version
- - uses: actions/upload-artifact@v5
+ - uses: actions/upload-artifact@v7
  if: always()
  with:
  name: test_output_sk_jdk${{ matrix.java-versions }}u

.github/workflows/java-integration-tests.yml

@@ -22,7 +22,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK

.github/workflows/java-publish-package.yml

@@ -17,7 +17,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Sets up the specified JDK version from the matrix
  - uses: actions/setup-java@v5
@@ -30,7 +30,7 @@ jobs:
  run: ./mvnw -B -DskipTests -Pcompile-jdk8 -P-compile-jdk17 clean deploy --file pom.xml -DaltDeploymentRepository=local::file:///tmp/target/staging-deploy
 
  - name: Upload Artifacts
- uses: actions/upload-artifact@v5
+ uses: actions/upload-artifact@v7
  with:
  name: Artifacts
  path: /tmp/target/staging-deploy

.github/workflows/label-issues.yml

@@ -13,7 +13,7 @@ jobs:
  permissions:
  issues: write
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  with:
  github-token: ${{ secrets.GH_ACTIONS_PR_WRITE }}
  script: |

.github/workflows/label-title-prefix.yml

@@ -15,7 +15,7 @@ jobs:
  pull-requests: write
 
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  name: "Issue/PR: update title"
  with:
  github-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/markdown-link-check.yml

@@ -13,7 +13,7 @@ jobs:
  runs-on: ubuntu-latest
  # check out the latest version of the code
  steps:
- - uses: actions/checkout@v5
+ - uses: actions/checkout@v7
 
  # Checks the status of hyperlinks in .md files in verbose mode
  - name: Check links

.github/workflows/typos.yaml

@@ -20,7 +20,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Check out code
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  - name: Use custom config file
  uses: crate-ci/typos@master

PACKAGES.md

@@ -39,6 +39,9 @@ A BOM is provided that can be used to define the versions of all Semantic Kernel
 `semantickernel-aiservices-openai`
 : Provides a connector that can be used to interact with the OpenAI API.
 
+`semantickernel-aiservices-voyageai`
+: Provides connectors for VoyageAI's embedding and reranking services, including text embeddings, contextualized embeddings, multimodal embeddings, and document reranking.
+
 ## Example Configurations
 
 ### Example: OpenAI + SQLite
@@ -72,5 +75,36 @@ POM XML for a simple project that uses OpenAI.
 </project>
 ```
 
+### Example: VoyageAI Embeddings and Reranking
+
+POM XML for a project that uses VoyageAI for embeddings and reranking.
+
+```xml
+
+<project>
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-bom</artifactId>
+ <version>${semantickernel.version}</version>
+ <scope>import</scope>
+ <type>pom</type>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-api</artifactId>
+ </dependency>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-aiservices-voyageai</artifactId>
+ </dependency>
+ </dependencies>
+</project>
+```
+
 
 

agents/semantickernel-agents-core/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/google/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 
@@ -17,7 +17,7 @@
  <dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>libraries-bom</artifactId>
- <version>26.49.0</version>
+ <version>26.80.0</version>
  <type>pom</type>
  <scope>import</scope>
  </dependency>

aiservices/huggingface/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/huggingface/src/main/java/com/microsoft/semantickernel/aiservices/huggingface/services/HuggingFacePromptExecutionSettings.java

@@ -47,7 +47,8 @@ public HuggingFacePromptExecutionSettings(PromptExecutionSettings copy) {
  copy.getUser(),
  copy.getStopSequences(),
  copy.getTokenSelectionBiases(),
- copy.getResponseFormat() == null ? null : copy.getResponseFormat());
+ copy.getResponseFormat() == null ? null : copy.getResponseFormat(),
+ copy.getMaxCompletionTokens() == null ? null : copy.getMaxCompletionTokens().toString());
  this.topK = null;
  this.repetitionPenalty = null;
  this.maxTime = null;
@@ -101,10 +102,12 @@ public HuggingFacePromptExecutionSettings(
  @Nullable Boolean details,
  @Nullable Boolean logProbs,
  @Nullable Integer topLogProbs,
- @Nullable Long seed) {
+ @Nullable Long seed,
+ @Nullable Boolean maxCompletionTokensEnable) {
  super(
  serviceId, modelId, temperature, topP, presencePenalty, frequencyPenalty, maxTokens,
- resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat);
+ resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat,
+ Boolean.toString(Boolean.TRUE.equals(maxCompletionTokensEnable)));
 
  this.topK = topK;
  this.repetitionPenalty = repetitionPenalty;
@@ -151,6 +154,7 @@ public static HuggingFacePromptExecutionSettings fromExecutionSettings(
  null,
  null,
  null,
+ null,
  null);
  }
 

aiservices/openai/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/openai/src/main/java/com/microsoft/semantickernel/aiservices/openai/chatcompletion/OpenAIChatCompletion.java

@@ -65,8 +65,8 @@
 import com.microsoft.semantickernel.orchestration.ToolCallBehavior;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonResponseSchema;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonSchemaResponseFormat;
-import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.semanticfunctions.KernelArguments;
+import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.services.chatcompletion.AuthorRole;
 import com.microsoft.semantickernel.services.chatcompletion.ChatCompletionService;
 import com.microsoft.semantickernel.services.chatcompletion.ChatHistory;
@@ -149,7 +149,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  chatHistoryResult = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(chatHistoryResult.getMessages())));
@@ -183,7 +183,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  result = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(result.getMessages())));
@@ -443,31 +443,31 @@ private Mono<ChatMessages> internalChatMessageContentsAsync(
  .getOptions();
 
  return Mono.deferContextual(contextView -> {
- ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
- SemanticKernelTelemetry.getTelemetry(invocationContext),
- contextView,
- getModelId(),
- SemanticKernelTelemetry.OPEN_AI_PROVIDER,
- options.getMaxTokens(),
- options.getTemperature(),
- options.getTopP());
-
- return getClient()
- .getChatCompletionsWithResponse(getDeploymentName(), options,
- OpenAIRequestSettings.getRequestOptions())
- .contextWrite(span.getReactorContextModifier())
- .flatMap(completionsResult -> {
- if (completionsResult.getStatusCode() >= 400) {
- return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
- "Request failed: " + completionsResult.getStatusCode()));
- }
+ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
+SemanticKernelTelemetry.getTelemetry(invocationContext),
+contextView,
+getModelId(),
+SemanticKernelTelemetry.OPEN_AI_PROVIDER,
+options.getMaxTokens(),
+options.getTemperature(),
+options.getTopP());
+
+return getClient()
+.getChatCompletionsWithResponse(getDeploymentName(), options,
+OpenAIRequestSettings.getRequestOptions())
+.contextWrite(span.getReactorContextModifier())
+.flatMap(completionsResult -> {
+if (completionsResult.getStatusCode() >= 400) {
+return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
+"Request failed: " + completionsResult.getStatusCode()));
+}
 
- return Mono.just(completionsResult.getValue());
- })
- .doOnError(span::endSpanWithError)
- .doOnSuccess(span::endSpanWithUsage)
- .doOnTerminate(span::close);
- })
+return Mono.just(completionsResult.getValue());
+})
+.doOnError(span::endSpanWithError)
+.doOnSuccess(span::endSpanWithUsage)
+.doOnTerminate(span::close);
+})
  .flatMap(completions -> {
  List<ChatResponseMessage> responseMessages = completions
  .getChoices()
@@ -920,7 +920,8 @@ private static ChatCompletionsOptions getCompletionsOptions(
  }
 
  Map<String, Integer> logit = null;
- if (promptExecutionSettings.getTokenSelectionBiases() != null) {
+ if (promptExecutionSettings.getTokenSelectionBiases() != null
+ && !promptExecutionSettings.getTokenSelectionBiases().isEmpty()) {
  logit = promptExecutionSettings
  .getTokenSelectionBiases()
  .entrySet()
@@ -937,12 +938,13 @@ private static ChatCompletionsOptions getCompletionsOptions(
  .setFrequencyPenalty(promptExecutionSettings.getFrequencyPenalty())
  .setPresencePenalty(promptExecutionSettings.getPresencePenalty())
  .setMaxTokens(promptExecutionSettings.getMaxTokens())
+ .setMaxCompletionTokens(promptExecutionSettings.getMaxCompletionTokens())
  .setN(promptExecutionSettings.getResultsPerPrompt())
  // Azure OpenAI WithData API does not allow to send empty array of stop sequences
  // Gives back "Validation error at #/stop/str: Input should be a valid string\nValidation error at #/stop/list[str]: List should have at least 1 item after validation, not 0"
  .setStop(promptExecutionSettings.getStopSequences() == null
  || promptExecutionSettings.getStopSequences().isEmpty() ? null
-: promptExecutionSettings.getStopSequences())
+ : promptExecutionSettings.getStopSequences())
  .setUser(promptExecutionSettings.getUser())
  .setLogitBias(logit);
 
@@ -1147,7 +1149,7 @@ private static OpenAIToolCallConfig getToolCallBehaviorConfig(
  toolChoice,
  toolCallBehavior.isAutoInvokeAllowed()
  && requestIndex < Math.min(MAXIMUM_INFLIGHT_AUTO_INVOKES,
-toolCallBehavior.getMaximumAutoInvokeAttempts()),
+ toolCallBehavior.getMaximumAutoInvokeAttempts()),
  null);
  }
 
@@ -1262,11 +1264,11 @@ private static ChatRequestAssistantMessage formAssistantMessage(
 
  String args = arguments != null && !arguments.isEmpty()
  ? arguments.entrySet().stream()
-.map(entry -> String.format("\"%s\": \"%s\"",
-StringEscapeUtils.escapeJson(entry.getKey()),
-StringEscapeUtils.escapeJson(
-entry.getValue().toPromptString())))
-.collect(Collectors.joining(",", "{", "}"))
+ .map(entry -> String.format("\"%s\": \"%s\"",
+ StringEscapeUtils.escapeJson(entry.getKey()),
+ StringEscapeUtils.escapeJson(
+ entry.getValue().toPromptString())))
+ .collect(Collectors.joining(",", "{", "}"))
  : "{}";
 
  String prefix = "";

.github/workflows/close-inactive-issues.yml

@@ -10,7 +10,7 @@ jobs:
  issues: write
  pull-requests: write
  steps:
- - uses: actions/stale@v10
+ - uses: actions/stale@v11
  with:
  days-before-issue-stale: 90
  days-before-issue-close: 14

.github/workflows/codeql-analysis.yml

@@ -30,7 +30,7 @@ jobs:
 
  steps:
  - name: Checkout repository
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Initializes the CodeQL tools for scanning.
  - name: Initialize CodeQL

.github/workflows/java-build.yml

@@ -26,7 +26,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK
@@ -56,7 +56,7 @@ jobs:
  run: ./mvnw -B -Pbug-check -Pcompile-jdk${{ matrix.java-versions }} test --file pom.xml
 
  # Uploads test artifacts for each JDK version
- - uses: actions/upload-artifact@v5
+ - uses: actions/upload-artifact@v7
  if: always()
  with:
  name: test_output_sk_jdk${{ matrix.java-versions }}u

.github/workflows/java-integration-tests.yml

@@ -22,7 +22,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK

.github/workflows/java-publish-package.yml

@@ -17,7 +17,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Sets up the specified JDK version from the matrix
  - uses: actions/setup-java@v5
@@ -30,7 +30,7 @@ jobs:
  run: ./mvnw -B -DskipTests -Pcompile-jdk8 -P-compile-jdk17 clean deploy --file pom.xml -DaltDeploymentRepository=local::file:///tmp/target/staging-deploy
 
  - name: Upload Artifacts
- uses: actions/upload-artifact@v5
+ uses: actions/upload-artifact@v7
  with:
  name: Artifacts
  path: /tmp/target/staging-deploy

.github/workflows/label-issues.yml

@@ -13,7 +13,7 @@ jobs:
  permissions:
  issues: write
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  with:
  github-token: ${{ secrets.GH_ACTIONS_PR_WRITE }}
  script: |

.github/workflows/label-title-prefix.yml

@@ -15,7 +15,7 @@ jobs:
  pull-requests: write
 
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  name: "Issue/PR: update title"
  with:
  github-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/markdown-link-check.yml

@@ -13,7 +13,7 @@ jobs:
  runs-on: ubuntu-latest
  # check out the latest version of the code
  steps:
- - uses: actions/checkout@v5
+ - uses: actions/checkout@v7
 
  # Checks the status of hyperlinks in .md files in verbose mode
  - name: Check links

.github/workflows/typos.yaml

@@ -20,7 +20,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Check out code
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  - name: Use custom config file
  uses: crate-ci/typos@master

PACKAGES.md

@@ -39,6 +39,9 @@ A BOM is provided that can be used to define the versions of all Semantic Kernel
 `semantickernel-aiservices-openai`
 : Provides a connector that can be used to interact with the OpenAI API.
 
+`semantickernel-aiservices-voyageai`
+: Provides connectors for VoyageAI's embedding and reranking services, including text embeddings, contextualized embeddings, multimodal embeddings, and document reranking.
+
 ## Example Configurations
 
 ### Example: OpenAI + SQLite
@@ -72,5 +75,36 @@ POM XML for a simple project that uses OpenAI.
 </project>
 ```
 
+### Example: VoyageAI Embeddings and Reranking
+
+POM XML for a project that uses VoyageAI for embeddings and reranking.
+
+```xml
+
+<project>
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-bom</artifactId>
+ <version>${semantickernel.version}</version>
+ <scope>import</scope>
+ <type>pom</type>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-api</artifactId>
+ </dependency>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-aiservices-voyageai</artifactId>
+ </dependency>
+ </dependencies>
+</project>
+```
+
 
 

agents/semantickernel-agents-core/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/google/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 
@@ -17,7 +17,7 @@
  <dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>libraries-bom</artifactId>
- <version>26.49.0</version>
+ <version>26.80.0</version>
  <type>pom</type>
  <scope>import</scope>
  </dependency>

aiservices/huggingface/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/huggingface/src/main/java/com/microsoft/semantickernel/aiservices/huggingface/services/HuggingFacePromptExecutionSettings.java

@@ -47,7 +47,8 @@ public HuggingFacePromptExecutionSettings(PromptExecutionSettings copy) {
  copy.getUser(),
  copy.getStopSequences(),
  copy.getTokenSelectionBiases(),
- copy.getResponseFormat() == null ? null : copy.getResponseFormat());
+ copy.getResponseFormat() == null ? null : copy.getResponseFormat(),
+ copy.getMaxCompletionTokens() == null ? null : copy.getMaxCompletionTokens().toString());
  this.topK = null;
  this.repetitionPenalty = null;
  this.maxTime = null;
@@ -101,10 +102,12 @@ public HuggingFacePromptExecutionSettings(
  @Nullable Boolean details,
  @Nullable Boolean logProbs,
  @Nullable Integer topLogProbs,
- @Nullable Long seed) {
+ @Nullable Long seed,
+ @Nullable Boolean maxCompletionTokensEnable) {
  super(
  serviceId, modelId, temperature, topP, presencePenalty, frequencyPenalty, maxTokens,
- resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat);
+ resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat,
+ Boolean.toString(Boolean.TRUE.equals(maxCompletionTokensEnable)));
 
  this.topK = topK;
  this.repetitionPenalty = repetitionPenalty;
@@ -151,6 +154,7 @@ public static HuggingFacePromptExecutionSettings fromExecutionSettings(
  null,
  null,
  null,
+ null,
  null);
  }
 

aiservices/openai/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/openai/src/main/java/com/microsoft/semantickernel/aiservices/openai/chatcompletion/OpenAIChatCompletion.java

@@ -65,8 +65,8 @@
 import com.microsoft.semantickernel.orchestration.ToolCallBehavior;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonResponseSchema;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonSchemaResponseFormat;
-import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.semanticfunctions.KernelArguments;
+import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.services.chatcompletion.AuthorRole;
 import com.microsoft.semantickernel.services.chatcompletion.ChatCompletionService;
 import com.microsoft.semantickernel.services.chatcompletion.ChatHistory;
@@ -149,7 +149,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  chatHistoryResult = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(chatHistoryResult.getMessages())));
@@ -183,7 +183,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  result = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(result.getMessages())));
@@ -443,31 +443,31 @@ private Mono<ChatMessages> internalChatMessageContentsAsync(
  .getOptions();
 
  return Mono.deferContextual(contextView -> {
- ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
- SemanticKernelTelemetry.getTelemetry(invocationContext),
- contextView,
- getModelId(),
- SemanticKernelTelemetry.OPEN_AI_PROVIDER,
- options.getMaxTokens(),
- options.getTemperature(),
- options.getTopP());
-
- return getClient()
- .getChatCompletionsWithResponse(getDeploymentName(), options,
- OpenAIRequestSettings.getRequestOptions())
- .contextWrite(span.getReactorContextModifier())
- .flatMap(completionsResult -> {
- if (completionsResult.getStatusCode() >= 400) {
- return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
- "Request failed: " + completionsResult.getStatusCode()));
- }
+ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
+SemanticKernelTelemetry.getTelemetry(invocationContext),
+contextView,
+getModelId(),
+SemanticKernelTelemetry.OPEN_AI_PROVIDER,
+options.getMaxTokens(),
+options.getTemperature(),
+options.getTopP());
+
+return getClient()
+.getChatCompletionsWithResponse(getDeploymentName(), options,
+OpenAIRequestSettings.getRequestOptions())
+.contextWrite(span.getReactorContextModifier())
+.flatMap(completionsResult -> {
+if (completionsResult.getStatusCode() >= 400) {
+return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
+"Request failed: " + completionsResult.getStatusCode()));
+}
 
- return Mono.just(completionsResult.getValue());
- })
- .doOnError(span::endSpanWithError)
- .doOnSuccess(span::endSpanWithUsage)
- .doOnTerminate(span::close);
- })
+return Mono.just(completionsResult.getValue());
+})
+.doOnError(span::endSpanWithError)
+.doOnSuccess(span::endSpanWithUsage)
+.doOnTerminate(span::close);
+})
  .flatMap(completions -> {
  List<ChatResponseMessage> responseMessages = completions
  .getChoices()
@@ -920,7 +920,8 @@ private static ChatCompletionsOptions getCompletionsOptions(
  }
 
  Map<String, Integer> logit = null;
- if (promptExecutionSettings.getTokenSelectionBiases() != null) {
+ if (promptExecutionSettings.getTokenSelectionBiases() != null
+ && !promptExecutionSettings.getTokenSelectionBiases().isEmpty()) {
  logit = promptExecutionSettings
  .getTokenSelectionBiases()
  .entrySet()
@@ -937,12 +938,13 @@ private static ChatCompletionsOptions getCompletionsOptions(
  .setFrequencyPenalty(promptExecutionSettings.getFrequencyPenalty())
  .setPresencePenalty(promptExecutionSettings.getPresencePenalty())
  .setMaxTokens(promptExecutionSettings.getMaxTokens())
+ .setMaxCompletionTokens(promptExecutionSettings.getMaxCompletionTokens())
  .setN(promptExecutionSettings.getResultsPerPrompt())
  // Azure OpenAI WithData API does not allow to send empty array of stop sequences
  // Gives back "Validation error at #/stop/str: Input should be a valid string\nValidation error at #/stop/list[str]: List should have at least 1 item after validation, not 0"
  .setStop(promptExecutionSettings.getStopSequences() == null
  || promptExecutionSettings.getStopSequences().isEmpty() ? null
-: promptExecutionSettings.getStopSequences())
+ : promptExecutionSettings.getStopSequences())
  .setUser(promptExecutionSettings.getUser())
  .setLogitBias(logit);
 
@@ -1147,7 +1149,7 @@ private static OpenAIToolCallConfig getToolCallBehaviorConfig(
  toolChoice,
  toolCallBehavior.isAutoInvokeAllowed()
  && requestIndex < Math.min(MAXIMUM_INFLIGHT_AUTO_INVOKES,
-toolCallBehavior.getMaximumAutoInvokeAttempts()),
+ toolCallBehavior.getMaximumAutoInvokeAttempts()),
  null);
  }
 
@@ -1262,11 +1264,11 @@ private static ChatRequestAssistantMessage formAssistantMessage(
 
  String args = arguments != null && !arguments.isEmpty()
  ? arguments.entrySet().stream()
-.map(entry -> String.format("\"%s\": \"%s\"",
-StringEscapeUtils.escapeJson(entry.getKey()),
-StringEscapeUtils.escapeJson(
-entry.getValue().toPromptString())))
-.collect(Collectors.joining(",", "{", "}"))
+ .map(entry -> String.format("\"%s\": \"%s\"",
+ StringEscapeUtils.escapeJson(entry.getKey()),
+ StringEscapeUtils.escapeJson(
+ entry.getValue().toPromptString())))
+ .collect(Collectors.joining(",", "{", "}"))
  : "{}";
 
  String prefix = "";

.github/workflows/close-inactive-issues.yml

@@ -10,7 +10,7 @@ jobs:
  issues: write
  pull-requests: write
  steps:
- - uses: actions/stale@v10
+ - uses: actions/stale@v11
  with:
  days-before-issue-stale: 90
  days-before-issue-close: 14

.github/workflows/codeql-analysis.yml

@@ -30,7 +30,7 @@ jobs:
 
  steps:
  - name: Checkout repository
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Initializes the CodeQL tools for scanning.
  - name: Initialize CodeQL

.github/workflows/java-build.yml

@@ -26,7 +26,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK
@@ -56,7 +56,7 @@ jobs:
  run: ./mvnw -B -Pbug-check -Pcompile-jdk${{ matrix.java-versions }} test --file pom.xml
 
  # Uploads test artifacts for each JDK version
- - uses: actions/upload-artifact@v5
+ - uses: actions/upload-artifact@v7
  if: always()
  with:
  name: test_output_sk_jdk${{ matrix.java-versions }}u

.github/workflows/java-integration-tests.yml

@@ -22,7 +22,7 @@ jobs:
 
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Need to use JDK 11 to build for JDK 8
  - name: Set JDK

.github/workflows/java-publish-package.yml

@@ -17,7 +17,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Checkout
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  # Sets up the specified JDK version from the matrix
  - uses: actions/setup-java@v5
@@ -30,7 +30,7 @@ jobs:
  run: ./mvnw -B -DskipTests -Pcompile-jdk8 -P-compile-jdk17 clean deploy --file pom.xml -DaltDeploymentRepository=local::file:///tmp/target/staging-deploy
 
  - name: Upload Artifacts
- uses: actions/upload-artifact@v5
+ uses: actions/upload-artifact@v7
  with:
  name: Artifacts
  path: /tmp/target/staging-deploy

.github/workflows/label-issues.yml

@@ -13,7 +13,7 @@ jobs:
  permissions:
  issues: write
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  with:
  github-token: ${{ secrets.GH_ACTIONS_PR_WRITE }}
  script: |

.github/workflows/label-title-prefix.yml

@@ -15,7 +15,7 @@ jobs:
  pull-requests: write
 
  steps:
- - uses: actions/github-script@v8
+ - uses: actions/github-script@v9
  name: "Issue/PR: update title"
  with:
  github-token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/markdown-link-check.yml

@@ -13,7 +13,7 @@ jobs:
  runs-on: ubuntu-latest
  # check out the latest version of the code
  steps:
- - uses: actions/checkout@v5
+ - uses: actions/checkout@v7
 
  # Checks the status of hyperlinks in .md files in verbose mode
  - name: Check links

.github/workflows/typos.yaml

@@ -20,7 +20,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - name: Check out code
- uses: actions/checkout@v5
+ uses: actions/checkout@v7
 
  - name: Use custom config file
  uses: crate-ci/typos@master

PACKAGES.md

@@ -39,6 +39,9 @@ A BOM is provided that can be used to define the versions of all Semantic Kernel
 `semantickernel-aiservices-openai`
 : Provides a connector that can be used to interact with the OpenAI API.
 
+`semantickernel-aiservices-voyageai`
+: Provides connectors for VoyageAI's embedding and reranking services, including text embeddings, contextualized embeddings, multimodal embeddings, and document reranking.
+
 ## Example Configurations
 
 ### Example: OpenAI + SQLite
@@ -72,5 +75,36 @@ POM XML for a simple project that uses OpenAI.
 </project>
 ```
 
+### Example: VoyageAI Embeddings and Reranking
+
+POM XML for a project that uses VoyageAI for embeddings and reranking.
+
+```xml
+
+<project>
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-bom</artifactId>
+ <version>${semantickernel.version}</version>
+ <scope>import</scope>
+ <type>pom</type>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-api</artifactId>
+ </dependency>
+ <dependency>
+ <groupId>com.microsoft.semantic-kernel</groupId>
+ <artifactId>semantickernel-aiservices-voyageai</artifactId>
+ </dependency>
+ </dependencies>
+</project>
+```
+
 
 

agents/semantickernel-agents-core/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/google/pom.xml

@@ -4,7 +4,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 
@@ -17,7 +17,7 @@
  <dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>libraries-bom</artifactId>
- <version>26.49.0</version>
+ <version>26.80.0</version>
  <type>pom</type>
  <scope>import</scope>
  </dependency>

aiservices/huggingface/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/huggingface/src/main/java/com/microsoft/semantickernel/aiservices/huggingface/services/HuggingFacePromptExecutionSettings.java

@@ -47,7 +47,8 @@ public HuggingFacePromptExecutionSettings(PromptExecutionSettings copy) {
  copy.getUser(),
  copy.getStopSequences(),
  copy.getTokenSelectionBiases(),
- copy.getResponseFormat() == null ? null : copy.getResponseFormat());
+ copy.getResponseFormat() == null ? null : copy.getResponseFormat(),
+ copy.getMaxCompletionTokens() == null ? null : copy.getMaxCompletionTokens().toString());
  this.topK = null;
  this.repetitionPenalty = null;
  this.maxTime = null;
@@ -101,10 +102,12 @@ public HuggingFacePromptExecutionSettings(
  @Nullable Boolean details,
  @Nullable Boolean logProbs,
  @Nullable Integer topLogProbs,
- @Nullable Long seed) {
+ @Nullable Long seed,
+ @Nullable Boolean maxCompletionTokensEnable) {
  super(
  serviceId, modelId, temperature, topP, presencePenalty, frequencyPenalty, maxTokens,
- resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat);
+ resultsPerPrompt, bestOf, user, stopSequences, tokenSelectionBiases, responseFormat,
+ Boolean.toString(Boolean.TRUE.equals(maxCompletionTokensEnable)));
 
  this.topK = topK;
  this.repetitionPenalty = repetitionPenalty;
@@ -151,6 +154,7 @@ public static HuggingFacePromptExecutionSettings fromExecutionSettings(
  null,
  null,
  null,
+ null,
  null);
  }
 

aiservices/openai/pom.xml

@@ -6,7 +6,7 @@
  <parent>
  <groupId>com.microsoft.semantic-kernel</groupId>
  <artifactId>semantickernel-parent</artifactId>
- <version>1.4.4-RC3-SNAPSHOT</version>
+ <version>1.5.1-SNAPSHOT</version>
  <relativePath>../../pom.xml</relativePath>
  </parent>
 

aiservices/openai/src/main/java/com/microsoft/semantickernel/aiservices/openai/chatcompletion/OpenAIChatCompletion.java

@@ -65,8 +65,8 @@
 import com.microsoft.semantickernel.orchestration.ToolCallBehavior;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonResponseSchema;
 import com.microsoft.semantickernel.orchestration.responseformat.JsonSchemaResponseFormat;
-import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.semanticfunctions.KernelArguments;
+import com.microsoft.semantickernel.semanticfunctions.KernelFunction;
 import com.microsoft.semantickernel.services.chatcompletion.AuthorRole;
 import com.microsoft.semantickernel.services.chatcompletion.ChatCompletionService;
 import com.microsoft.semantickernel.services.chatcompletion.ChatHistory;
@@ -149,7 +149,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  chatHistoryResult = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(chatHistoryResult.getMessages())));
@@ -183,7 +183,7 @@ public Mono<List<ChatMessageContent<?>>> getChatMessageContentsAsync(
 
  if (invocationContext != null
  && invocationContext
-.returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
+ .returnMode() == InvocationReturnMode.LAST_MESSAGE_ONLY) {
  result = new ChatHistory(
  Collections.singletonList(
  CollectionUtil.getLastOrNull(result.getMessages())));
@@ -443,31 +443,31 @@ private Mono<ChatMessages> internalChatMessageContentsAsync(
  .getOptions();
 
  return Mono.deferContextual(contextView -> {
- ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
- SemanticKernelTelemetry.getTelemetry(invocationContext),
- contextView,
- getModelId(),
- SemanticKernelTelemetry.OPEN_AI_PROVIDER,
- options.getMaxTokens(),
- options.getTemperature(),
- options.getTopP());
-
- return getClient()
- .getChatCompletionsWithResponse(getDeploymentName(), options,
- OpenAIRequestSettings.getRequestOptions())
- .contextWrite(span.getReactorContextModifier())
- .flatMap(completionsResult -> {
- if (completionsResult.getStatusCode() >= 400) {
- return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
- "Request failed: " + completionsResult.getStatusCode()));
- }
+ChatCompletionSpan span = ChatCompletionSpan.startChatCompletionSpan(
+SemanticKernelTelemetry.getTelemetry(invocationContext),
+contextView,
+getModelId(),
+SemanticKernelTelemetry.OPEN_AI_PROVIDER,
+options.getMaxTokens(),
+options.getTemperature(),
+options.getTopP());
+
+return getClient()
+.getChatCompletionsWithResponse(getDeploymentName(), options,
+OpenAIRequestSettings.getRequestOptions())
+.contextWrite(span.getReactorContextModifier())
+.flatMap(completionsResult -> {
+if (completionsResult.getStatusCode() >= 400) {
+return Mono.error(new AIException(ErrorCodes.SERVICE_ERROR,
+"Request failed: " + completionsResult.getStatusCode()));
+}
 
- return Mono.just(completionsResult.getValue());
- })
- .doOnError(span::endSpanWithError)
- .doOnSuccess(span::endSpanWithUsage)
- .doOnTerminate(span::close);
- })
+return Mono.just(completionsResult.getValue());
+})
+.doOnError(span::endSpanWithError)
+.doOnSuccess(span::endSpanWithUsage)
+.doOnTerminate(span::close);
+})
  .flatMap(completions -> {
  List<ChatResponseMessage> responseMessages = completions
  .getChoices()
@@ -920,7 +920,8 @@ private static ChatCompletionsOptions getCompletionsOptions(
  }
 
  Map<String, Integer> logit = null;
- if (promptExecutionSettings.getTokenSelectionBiases() != null) {
+ if (promptExecutionSettings.getTokenSelectionBiases() != null
+ && !promptExecutionSettings.getTokenSelectionBiases().isEmpty()) {
  logit = promptExecutionSettings
  .getTokenSelectionBiases()
  .entrySet()
@@ -937,12 +938,13 @@ private static ChatCompletionsOptions getCompletionsOptions(
  .setFrequencyPenalty(promptExecutionSettings.getFrequencyPenalty())
  .setPresencePenalty(promptExecutionSettings.getPresencePenalty())
  .setMaxTokens(promptExecutionSettings.getMaxTokens())
+ .setMaxCompletionTokens(promptExecutionSettings.getMaxCompletionTokens())
  .setN(promptExecutionSettings.getResultsPerPrompt())
  // Azure OpenAI WithData API does not allow to send empty array of stop sequences
  // Gives back "Validation error at #/stop/str: Input should be a valid string\nValidation error at #/stop/list[str]: List should have at least 1 item after validation, not 0"
  .setStop(promptExecutionSettings.getStopSequences() == null
  || promptExecutionSettings.getStopSequences().isEmpty() ? null
-: promptExecutionSettings.getStopSequences())
+ : promptExecutionSettings.getStopSequences())
  .setUser(promptExecutionSettings.getUser())
  .setLogitBias(logit);
 
@@ -1147,7 +1149,7 @@ private static OpenAIToolCallConfig getToolCallBehaviorConfig(
  toolChoice,
  toolCallBehavior.isAutoInvokeAllowed()
  && requestIndex < Math.min(MAXIMUM_INFLIGHT_AUTO_INVOKES,
-toolCallBehavior.getMaximumAutoInvokeAttempts()),
+ toolCallBehavior.getMaximumAutoInvokeAttempts()),
  null);
  }
 
@@ -1262,11 +1264,11 @@ private static ChatRequestAssistantMessage formAssistantMessage(
 
  String args = arguments != null && !arguments.isEmpty()
  ? arguments.entrySet().stream()
-.map(entry -> String.format("\"%s\": \"%s\"",
-StringEscapeUtils.escapeJson(entry.getKey()),
-StringEscapeUtils.escapeJson(
-entry.getValue().toPromptString())))
-.collect(Collectors.joining(",", "{", "}"))
+ .map(entry -> String.format("\"%s\": \"%s\"",
+ StringEscapeUtils.escapeJson(entry.getKey()),
+ StringEscapeUtils.escapeJson(
+ entry.getValue().toPromptString())))
+ .collect(Collectors.joining(",", "{", "}"))
  : "{}";
 
  String prefix = "";