feat: add details field to known exception (#13930)

## What
1. Adds an optional `details` field to `KnownExceptionInfo`
2. Parses validation details from the assist proxy and places them in the details field

## Why
This allows us to show validation errors at the field level for assist

## Recommended reading order
1. `x.kt`
2. `y.kt`

## Can this PR be safely reverted and rolled back?
<!--
* If you know that your be safely rolled back, check YES.*
* If that is not the case (e.g. a database migration), check NO.
* If unsure, leave it blank.*
-->
- [x] YES 💚
- [ ] NO ❌

Author: bnchrch

airbyte-api/server-api/src/main/openapi/config.yaml

@@ -12983,6 +12983,8 @@ components:
           type: array
           items:
             type: string
+        details:
+          type: object
     InvalidInputExceptionInfo:
       type: object
       required:

airbyte-commons-server/src/main/java/io/airbyte/commons/server/errors/KnownException.java

@@ -5,48 +5,78 @@
 package io.airbyte.commons.server.errors;
 
 import io.airbyte.api.model.generated.KnownExceptionInfo;
+import java.util.Map;
 import org.apache.logging.log4j.core.util.Throwables;
 
 /**
  * Exception wrapper to handle formatting API exception outputs nicely.
  */
 public abstract class KnownException extends RuntimeException {
 
+  private final Map<String, Object> details; // Add an optional details field
+
   public KnownException(final String message) {
     super(message);
+    this.details = null;
+  }
+
+  public KnownException(final String message, final Map<String, Object> details) {
+    super(message);
+    this.details = details;
   }
 
   public KnownException(final String message, final Throwable cause) {
     super(message, cause);
+    this.details = null;
+  }
+
+  public KnownException(final String message, final Throwable cause, final Map<String, Object> details) {
+    super(message, cause);
+    this.details = details;
   }
 
   public abstract int getHttpCode();
 
+  public Map<String, Object> getDetails() {
+    return details;
+  }
+
   public KnownExceptionInfo getKnownExceptionInfo() {
-    return KnownException.infoFromThrowable(this);
+    return KnownException.infoFromThrowable(this, details);
+  }
+
+  public static KnownExceptionInfo infoFromThrowableWithMessage(final Throwable t, final String message) {
+    return infoFromThrowableWithMessage(t, message, null); // Call the other static method with null details
   }
 
   /**
    * Static factory for creating a known exception.
    *
    * @param t throwable to wrap
    * @param message error message
+   * @param details additional details
    * @return known exception
    */
-  public static KnownExceptionInfo infoFromThrowableWithMessage(final Throwable t, final String message) {
+  public static KnownExceptionInfo infoFromThrowableWithMessage(final Throwable t, final String message, final Map<String, Object> details) {
     final KnownExceptionInfo exceptionInfo = new KnownExceptionInfo()
         .exceptionClassName(t.getClass().getName())
         .message(message)
         .exceptionStack(Throwables.toStringList(t));
+
     if (t.getCause() != null) {
-      exceptionInfo.rootCauseExceptionClassName(t.getClass().getClass().getName());
+      exceptionInfo.rootCauseExceptionClassName(t.getCause().getClass().getName());
       exceptionInfo.rootCauseExceptionStack(Throwables.toStringList(t.getCause()));
     }
+
+    if (details != null) {
+      exceptionInfo.details(details);
+    }
+
     return exceptionInfo;
   }
 
-  public static KnownExceptionInfo infoFromThrowable(final Throwable t) {
-    return infoFromThrowableWithMessage(t, t.getMessage());
+  public static KnownExceptionInfo infoFromThrowable(final Throwable t, final Map<String, Object> details) {
+    return infoFromThrowableWithMessage(t, t.getMessage(), details);
   }
 
 }

airbyte-connector-builder-server/src/main/kotlin/io/airbyte/connector_builder/exceptions/AssistProxyException.kt

@@ -6,7 +6,7 @@ import com.fasterxml.jackson.databind.JsonNode
 import io.airbyte.commons.server.errors.KnownException
 
 class AssistProxyException(private var responseCode: Int, jsonBody: JsonNode) :
-  KnownException(getStringFromResponse(jsonBody), getThrowableFromResponse(jsonBody)) {
+  KnownException(getStringFromResponse(jsonBody), getThrowableFromResponse(jsonBody), getDetailsFromResponse(jsonBody)) {
   override fun getHttpCode(): Int {
     return responseCode
   }
@@ -19,6 +19,13 @@ fun getStringFromResponse(jsonBody: JsonNode): String {
   return "Unknown AI Assist error"
 }
 
+fun getDetailsFromResponse(jsonBody: JsonNode): Map<String, Any> {
+  if (jsonBody.has("details")) {
+    return jsonBody.get("details").fields().asSequence().associate { it.key to it.value }
+  }
+  return emptyMap()
+}
+
 fun getThrowableFromResponse(jsonBody: JsonNode): Throwable? {
   if (jsonBody.has("exceptionStack")) {
     val message = getStringFromResponse(jsonBody)
@@ -28,6 +35,7 @@ fun getThrowableFromResponse(jsonBody: JsonNode): Throwable? {
 
     val throwable = Throwable(message)
     throwable.stackTrace = stackTrace
+
     return throwable
   }
   return null

airbyte-connector-builder-server/src/main/openapi/openapi.yaml

@@ -452,6 +452,8 @@ components:
           type: array
           items:
             type: string
+        details:
+          type: object
     InvalidInputExceptionInfo:
       type: object
       required: