From 5070881bc02e59e6d6bdfafa9faf493997df3dd1 Mon Sep 17 00:00:00 2001 From: Urmila Unni Date: Fri, 13 Nov 2026 10:06:05 +0530 Subject: [PATCH 1/2] CAMEL-26873: camel-langchain4j-embeddings - deprecate the CamelLangChain4jEmbeddingsFinishReason header The producer no longer sets this header since CAMEL-26514, as the EmbeddingResponse of LangChain4j has no finish reason. Co-authored-by: Claude --- .../camel/catalog/components/langchain4j-embeddings.json | 2 +- .../langchain4j/embeddings/langchain4j-embeddings.json | 2 +- .../langchain4j/embeddings/LangChain4jEmbeddingsHeaders.java | 4 +++- .../dsl/LangChain4jEmbeddingsEndpointBuilderFactory.java | 4 +++- 4 files changed, 8 insertions(+), 4 deletions(-) diff --git a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/langchain4j-embeddings.json b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/langchain4j-embeddings.json index c12e1c4cc334d..db07352dbb1b8 100644 --- a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/langchain4j-embeddings.json +++ b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/langchain4j-embeddings.json @@ -38,7 +38,7 @@ "apiKey": { "index": 11, "kind": "property", "displayName": "Api Key", "group": "security", "label": "model,security", "required": false, "type": "string", "javaType": "java.lang.String", "deprecated": false, "autowired": false, "secret": true, "security": "secret", "configurationClass": "org.apache.camel.component.langchain4j.embeddings.LangChain4jEmbeddingsConfiguration", "configurationField": "configuration", "description": "The API key or access token of the provider, when the model is created from the provider." } }, "headers": { - "CamelLangChain4jEmbeddingsFinishReason": { "index": 0, "kind": "header", "displayName": "", "group": "producer", "label": "", "required": false, "javaType": "dev.langchain4j.model.output.FinishReason", "enum": [ "STOP", "LENGTH", "TOOL_EXECUTION", "CONTENT_FILTER", "OTHER" ], "deprecated": false, "autowired": false, "secret": false, "description": "The Finish Reason.", "constantName": "org.apache.camel.component.langchain4j.embeddings.LangChain4jEmbeddingsHeaders#FINISH_REASON" }, + "CamelLangChain4jEmbeddingsFinishReason": { "index": 0, "kind": "header", "displayName": "", "group": "producer", "label": "", "required": false, "javaType": "dev.langchain4j.model.output.FinishReason", "enum": [ "STOP", "LENGTH", "TOOL_EXECUTION", "CONTENT_FILTER", "OTHER" ], "deprecated": true, "deprecationNote": "The producer no longer sets this header, as the EmbeddingResponse of LangChain4j has no finish reason.", "autowired": false, "secret": false, "description": "The Finish Reason. Deprecation note: The producer no longer sets this header, as the EmbeddingResponse of LangChain4j has no finish reason.", "constantName": "org.apache.camel.component.langchain4j.embeddings.LangChain4jEmbeddingsHeaders#FINISH_REASON" }, "CamelLangChain4jEmbeddingsInputTokenCount": { "index": 1, "kind": "header", "displayName": "", "group": "producer", "label": "", "required": false, "javaType": "int", "deprecated": false, "autowired": false, "secret": false, "description": "The Input Token Count.", "constantName": "org.apache.camel.component.langchain4j.embeddings.LangChain4jEmbeddingsHeaders#INPUT_TOKEN_COUNT" }, "CamelLangChain4jEmbeddingsOutputTokenCount": { "index": 2, "kind": "header", "displayName": "", "group": "producer", "label": "", "required": false, "javaType": "int", "deprecated": false, "autowired": false, "secret": false, "description": "The Output Token Count.", "constantName": "org.apache.camel.component.langchain4j.embeddings.LangChain4jEmbeddingsHeaders#OUTPUT_TOKEN_COUNT" }, "CamelLangChain4jEmbeddingsTotalTokenCount": { "index": 3, "kind": "header", "displayName": "", "group": "producer", "label": "", "required": false, "javaType": "int", "deprecated": false, "autowired": false, "secret": false, "description": "The Total Token Count.", "constantName": "org.apache.camel.component.langchain4j.embeddings.LangChain4jEmbeddingsHeaders#TOTAL_TOKEN_COUNT" }, diff --git a/components/camel-ai/camel-langchain4j-embeddings/src/generated/resources/META-INF/org/apache/camel/component/langchain4j/embeddings/langchain4j-embeddings.json b/components/camel-ai/camel-langchain4j-embeddings/src/generated/resources/META-INF/org/apache/camel/component/langchain4j/embeddings/langchain4j-embeddings.json index c12e1c4cc334d..db07352dbb1b8 100644 --- a/components/camel-ai/camel-langchain4j-embeddings/src/generated/resources/META-INF/org/apache/camel/component/langchain4j/embeddings/langchain4j-embeddings.json +++ b/components/camel-ai/camel-langchain4j-embeddings/src/generated/resources/META-INF/org/apache/camel/component/langchain4j/embeddings/langchain4j-embeddings.json @@ -38,7 +38,7 @@ "apiKey": { "index": 11, "kind": "property", "displayName": "Api Key", "group": "security", "label": "model,security", "required": false, "type": "string", "javaType": "java.lang.String", "deprecated": false, "autowired": false, "secret": true, "security": "secret", "configurationClass": "org.apache.camel.component.langchain4j.embeddings.LangChain4jEmbeddingsConfiguration", "configurationField": "configuration", "description": "The API key or access token of the provider, when the model is created from the provider." } }, "headers": { - "CamelLangChain4jEmbeddingsFinishReason": { "index": 0, "kind": "header", "displayName": "", "group": "producer", "label": "", "required": false, "javaType": "dev.langchain4j.model.output.FinishReason", "enum": [ "STOP", "LENGTH", "TOOL_EXECUTION", "CONTENT_FILTER", "OTHER" ], "deprecated": false, "autowired": false, "secret": false, "description": "The Finish Reason.", "constantName": "org.apache.camel.component.langchain4j.embeddings.LangChain4jEmbeddingsHeaders#FINISH_REASON" }, + "CamelLangChain4jEmbeddingsFinishReason": { "index": 0, "kind": "header", "displayName": "", "group": "producer", "label": "", "required": false, "javaType": "dev.langchain4j.model.output.FinishReason", "enum": [ "STOP", "LENGTH", "TOOL_EXECUTION", "CONTENT_FILTER", "OTHER" ], "deprecated": true, "deprecationNote": "The producer no longer sets this header, as the EmbeddingResponse of LangChain4j has no finish reason.", "autowired": false, "secret": false, "description": "The Finish Reason. Deprecation note: The producer no longer sets this header, as the EmbeddingResponse of LangChain4j has no finish reason.", "constantName": "org.apache.camel.component.langchain4j.embeddings.LangChain4jEmbeddingsHeaders#FINISH_REASON" }, "CamelLangChain4jEmbeddingsInputTokenCount": { "index": 1, "kind": "header", "displayName": "", "group": "producer", "label": "", "required": false, "javaType": "int", "deprecated": false, "autowired": false, "secret": false, "description": "The Input Token Count.", "constantName": "org.apache.camel.component.langchain4j.embeddings.LangChain4jEmbeddingsHeaders#INPUT_TOKEN_COUNT" }, "CamelLangChain4jEmbeddingsOutputTokenCount": { "index": 2, "kind": "header", "displayName": "", "group": "producer", "label": "", "required": false, "javaType": "int", "deprecated": false, "autowired": false, "secret": false, "description": "The Output Token Count.", "constantName": "org.apache.camel.component.langchain4j.embeddings.LangChain4jEmbeddingsHeaders#OUTPUT_TOKEN_COUNT" }, "CamelLangChain4jEmbeddingsTotalTokenCount": { "index": 3, "kind": "header", "displayName": "", "group": "producer", "label": "", "required": false, "javaType": "int", "deprecated": false, "autowired": false, "secret": false, "description": "The Total Token Count.", "constantName": "org.apache.camel.component.langchain4j.embeddings.LangChain4jEmbeddingsHeaders#TOTAL_TOKEN_COUNT" }, diff --git a/components/camel-ai/camel-langchain4j-embeddings/src/main/java/org/apache/camel/component/langchain4j/embeddings/LangChain4jEmbeddingsHeaders.java b/components/camel-ai/camel-langchain4j-embeddings/src/main/java/org/apache/camel/component/langchain4j/embeddings/LangChain4jEmbeddingsHeaders.java index a7de5a1907ac1..21879c204a466 100644 --- a/components/camel-ai/camel-langchain4j-embeddings/src/main/java/org/apache/camel/component/langchain4j/embeddings/LangChain4jEmbeddingsHeaders.java +++ b/components/camel-ai/camel-langchain4j-embeddings/src/main/java/org/apache/camel/component/langchain4j/embeddings/LangChain4jEmbeddingsHeaders.java @@ -20,7 +20,9 @@ import org.apache.camel.spi.Metadata; public class LangChain4jEmbeddingsHeaders { - @Metadata(description = "The Finish Reason.", javaType = "dev.langchain4j.model.output.FinishReason") + @Deprecated + @Metadata(description = "The Finish Reason.", javaType = "dev.langchain4j.model.output.FinishReason", + deprecationNote = "The producer no longer sets this header, as the EmbeddingResponse of LangChain4j has no finish reason.") public static final String FINISH_REASON = "CamelLangChain4jEmbeddingsFinishReason"; @Metadata(description = "The Input Token Count.", javaType = "int") diff --git a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/LangChain4jEmbeddingsEndpointBuilderFactory.java b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/LangChain4jEmbeddingsEndpointBuilderFactory.java index abb8f9ab1de11..f9792c84031a9 100644 --- a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/LangChain4jEmbeddingsEndpointBuilderFactory.java +++ b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/LangChain4jEmbeddingsEndpointBuilderFactory.java @@ -391,7 +391,8 @@ public static class LangChain4jEmbeddingsHeaderNameBuilder { public static final LangChain4jEmbeddingsHeaderNameBuilder INSTANCE = new LangChain4jEmbeddingsHeaderNameBuilder(); /** - * The Finish Reason. + * The Finish Reason. Deprecation note: The producer no longer sets this + * header, as the EmbeddingResponse of LangChain4j has no finish reason. * * The option is a: {@code dev.langchain4j.model.output.FinishReason} * type. @@ -401,6 +402,7 @@ public static class LangChain4jEmbeddingsHeaderNameBuilder { * @return the name of the header {@code * LangChain4jEmbeddingsFinishReason}. */ + @Deprecated public String langChain4jEmbeddingsFinishReason() { return "CamelLangChain4jEmbeddingsFinishReason"; } From 53faff9be75531b7db2a76cd600185d8c3edb3db Mon Sep 17 00:00:00 2001 From: Urmila Unni Date: Fri, 13 Nov 2026 13:10:56 +0530 Subject: [PATCH 2/2] CAMEL-26873: suppress the deprecation warning in removeResultHeaders Co-authored-by: Claude --- .../langchain4j/embeddings/LangChain4jEmbeddingsProducer.java | 2 ++ 1 file changed, 2 insertions(+) diff --git a/components/camel-ai/camel-langchain4j-embeddings/src/main/java/org/apache/camel/component/langchain4j/embeddings/LangChain4jEmbeddingsProducer.java b/components/camel-ai/camel-langchain4j-embeddings/src/main/java/org/apache/camel/component/langchain4j/embeddings/LangChain4jEmbeddingsProducer.java index d224c83494dd1..a27ef413a8141 100644 --- a/components/camel-ai/camel-langchain4j-embeddings/src/main/java/org/apache/camel/component/langchain4j/embeddings/LangChain4jEmbeddingsProducer.java +++ b/components/camel-ai/camel-langchain4j-embeddings/src/main/java/org/apache/camel/component/langchain4j/embeddings/LangChain4jEmbeddingsProducer.java @@ -183,6 +183,8 @@ private static String typeOf(Object value) { * Removes the headers of an earlier call, so a header that this call does not set does not keep a stale value: an * EMBEDDINGS header from an earlier batch would make a later embedding store ADD store the old batch. */ + // FINISH_REASON is deprecated, but a stale value from an earlier call is still removed + @SuppressWarnings("deprecation") private static void removeResultHeaders(Message message) { message.removeHeader(LangChain4jEmbeddingsHeaders.REQUEST_MODEL); message.removeHeader(LangChain4jEmbeddingsHeaders.FINISH_REASON);