Merge pull request #1843 from edeandrea/deprecate-auditing

Deprecate existing auditing events.

Author: geoand

core/runtime/src/main/java/io/quarkiverse/langchain4j/audit/AuditSourceInfo.java

@@ -5,7 +5,10 @@
 
 /**
  * Contains information about the source of an audit event
+ *
+ * @deprecated In favor of https://docs.langchain4j.dev/tutorials/observability#ai-service-observability
  */
+@Deprecated(forRemoval = true)
 public interface AuditSourceInfo {
     /**
      * The fully-qualified name of the interface where the llm interaction was initialized

core/runtime/src/main/java/io/quarkiverse/langchain4j/audit/InitialMessagesCreatedEvent.java

@@ -7,7 +7,10 @@
 
 /**
  * Invoked when the original user and system messages have been created
+ *
+ * @deprecated In favor of https://docs.langchain4j.dev/tutorials/observability#ai-service-observability
  */
+@Deprecated(forRemoval = true)
 public interface InitialMessagesCreatedEvent extends LLMInteractionEvent {
 
     /**

core/runtime/src/main/java/io/quarkiverse/langchain4j/audit/LLMInteractionCompleteEvent.java

@@ -2,7 +2,10 @@
 
 /**
  * Invoked when the final result of the AiService method has been computed
+ *
+ * @deprecated In favor of https://docs.langchain4j.dev/tutorials/observability#ai-service-observability
  */
+@Deprecated(forRemoval = true)
 public interface LLMInteractionCompleteEvent extends LLMInteractionEvent {
     /**
      * @return the result of the AiService method

core/runtime/src/main/java/io/quarkiverse/langchain4j/audit/LLMInteractionEvent.java

@@ -1,5 +1,9 @@
 package io.quarkiverse.langchain4j.audit;
 
+/**
+ * @deprecated In favor of https://docs.langchain4j.dev/tutorials/observability#ai-service-observability
+ */
+@Deprecated(forRemoval = true)
 public interface LLMInteractionEvent {
     AuditSourceInfo sourceInfo();
 }

core/runtime/src/main/java/io/quarkiverse/langchain4j/audit/LLMInteractionFailureEvent.java

@@ -2,7 +2,10 @@
 
 /**
  * Invoked when there was an exception computing the result of the AiService method
+ *
+ * @deprecated In favor of https://docs.langchain4j.dev/tutorials/observability#ai-service-observability
  */
+@Deprecated(forRemoval = true)
 public interface LLMInteractionFailureEvent extends LLMInteractionEvent {
     /**
      * @return the error that occurred

core/runtime/src/main/java/io/quarkiverse/langchain4j/audit/ResponseFromLLMReceivedEvent.java

@@ -5,7 +5,10 @@
 /**
  * Invoked with a response from an LLM. It is important to note that this can be invoked multiple times
  * when tools exist.
+ *
+ * @deprecated In favor of https://docs.langchain4j.dev/tutorials/observability#ai-service-observability
  */
+@Deprecated(forRemoval = true)
 public interface ResponseFromLLMReceivedEvent extends LLMInteractionEvent {
     /**
      * @return the chat response

core/runtime/src/main/java/io/quarkiverse/langchain4j/audit/ToolExecutedEvent.java

@@ -5,7 +5,10 @@
 /**
  * Invoked with a tool response from an LLM. It is important to note that this can be invoked multiple times
  * when tools exist.
+ *
+ * @deprecated In favor of https://docs.langchain4j.dev/tutorials/observability#ai-service-observability
  */
+@Deprecated(forRemoval = true)
 public interface ToolExecutedEvent extends LLMInteractionEvent {
 
     /**

core/runtime/src/main/java/io/quarkiverse/langchain4j/audit/guardrails/GuardrailExecutedEvent.java

@@ -12,7 +12,9 @@
  *
  * @param <P> the type of guardrail parameters used in the validation process
  * @param <R> the type of guardrail result produced by the validation process
+ * @deprecated In favor of https://docs.langchain4j.dev/tutorials/observability#ai-service-observability
  */
+@Deprecated(forRemoval = true)
 public interface GuardrailExecutedEvent<P extends GuardrailRequest, R extends GuardrailResult<R>, G extends Guardrail<P, R>>
         extends LLMInteractionEvent {
     /**

core/runtime/src/main/java/io/quarkiverse/langchain4j/audit/guardrails/InputGuardrailExecutedEvent.java

@@ -5,6 +5,10 @@
 import dev.langchain4j.guardrail.InputGuardrailRequest;
 import dev.langchain4j.guardrail.InputGuardrailResult;
 
+/**
+ * @deprecated In favor of https://docs.langchain4j.dev/tutorials/observability#ai-service-observability
+ */
+@Deprecated(forRemoval = true)
 public interface InputGuardrailExecutedEvent
         extends GuardrailExecutedEvent<InputGuardrailRequest, InputGuardrailResult, InputGuardrail> {
     /**

core/runtime/src/main/java/io/quarkiverse/langchain4j/audit/guardrails/OutputGuardrailExecutedEvent.java

@@ -4,6 +4,10 @@
 import dev.langchain4j.guardrail.OutputGuardrailRequest;
 import dev.langchain4j.guardrail.OutputGuardrailResult;
 
+/**
+ * @deprecated In favor of https://docs.langchain4j.dev/tutorials/observability#ai-service-observability
+ */
+@Deprecated(forRemoval = true)
 public interface OutputGuardrailExecutedEvent
         extends GuardrailExecutedEvent<OutputGuardrailRequest, OutputGuardrailResult, OutputGuardrail> {
 }