feat: add enrichment result in case review DTO (#1100)

* feat(cases): enhance case review schema with KYC analysis and pivot enrichments

- Added `pivot_enrichments` property to `CaseReviewContentDto` to include KYC analysis results.
- Introduced `KycAnalysisDto` and `GroundingCitationDto` types to support the new data structure.
- Updated OpenAPI specification to reflect these changes.

* refacto(ai_agent): Send null if no pivot enrichments

* Update packages/marble-api/openapis/marblecore-api/cases.yml

Co-authored-by: Copilot <[email protected]>

---------

Co-authored-by: Copilot <[email protected]>

Author: OrriMandarin

packages/marble-api/openapis/marblecore-api/cases.yml

@@ -1532,6 +1532,15 @@ components:
                 $ref: '#/components/schemas/CaseReviewProofDto'
             thought:
               type: string
+            pivot_enrichments:
+              type: object
+              description: The enrichments of the pivot objects (null if the feature is disabled)
+              nullable: true
+              properties:
+                results:
+                  type: array
+                  items:
+                    $ref: '#/components/schemas/KYCAnalysisDto'
         - anyOf:
           - $ref: '#/components/schemas/CaseReviewOkDto'
           - $ref: '#/components/schemas/CaseReviewNotOkDto'

packages/marble-api/src/generated/marblecore-api.ts

@@ -392,6 +392,24 @@ export type CaseReviewProofDto = {
     /** The reason why the object was used to justify the review */
     reason: string;
 };
+export type GroundingCitationDto = {
+    /** Title of the source */
+    title: string;
+    /** Domain of the source (not used for now) */
+    domain: string;
+    /** URL of the source */
+    url: string;
+    /** Date of the source */
+    date: string;
+};
+export type KycAnalysisDto = {
+    /** Output of LLM analysis on a pivot object */
+    analysis: string;
+    /** Name of the entity on which the pivot value is found. */
+    entity_name: string;
+    /** List of source used in the analysis. The analysis uses anchors ([1][2]), these anchors are used to justify the analysis and the index follow the list order */
+    citations: GroundingCitationDto[];
+};
 export type CaseReviewOkDto = {
     ok: true;
 };
@@ -404,31 +422,17 @@ export type CaseReviewContentDto = {
     output: string;
     proofs: CaseReviewProofDto[];
     thought?: string;
+    /** The enrichments of the pivot objects (null if the feature is disabled) */
+    pivot_enrichments?: {
+        results?: KycAnalysisDto[];
+    } | null;
 } & (CaseReviewOkDto | CaseReviewNotOkDto);
 export type CaseReviewDto = {
     id: string;
     reaction: CaseReviewFeedbackDto;
     version: string;
     review: CaseReviewContentDto;
 };
-export type GroundingCitationDto = {
-    /** Title of the source */
-    title: string;
-    /** Domain of the source (not used for now) */
-    domain: string;
-    /** URL of the source */
-    url: string;
-    /** Date of the source */
-    date: string;
-};
-export type KycAnalysisDto = {
-    /** Output of LLM analysis on a pivot object */
-    analysis: string;
-    /** Name of the entity on which the pivot value is found. */
-    entity_name: string;
-    /** List of source used in the analysis. The analysis uses anchors ([1][2]), these anchors are used to justify the analysis and the index follow the list order */
-    citations: GroundingCitationDto[];
-};
 export type SuspiciousActivityReportDto = {
     id: string;
     status: "pending" | "completed";