feat: add endpoint for AST description pass through request body

Author: OrriMandarin

packages/marble-api/openapis/marblecore-api.yaml

@@ -219,6 +219,8 @@ paths:
 
   /scenario-iteration-rules:
     $ref: ./marblecore-api/scenario-iteration-rules.yml#/~1scenario-iteration-rules
+  /scenario-iteration-rules/ai-description:
+    $ref: ./marblecore-api/scenario-iteration-rules.yml#/~1scenario-iteration-rules~1ai-description
   /scenario-iteration-rules/{ruleId}:
     $ref: ./marblecore-api/scenario-iteration-rules.yml#/~1scenario-iteration-rules~1{ruleId}
   /scenario-iteration-rules/{ruleId}/ai-description:

packages/marble-api/openapis/marblecore-api/scenario-iteration-rules.yml

@@ -63,6 +63,33 @@
         $ref: 'components.yml#/responses/403'
       '404':
         $ref: 'components.yml#/responses/404'
+/scenario-iteration-rules/ai-description:
+  post:
+    tags:
+      - Scenario Iteration Rules
+    summary: Generate AI description for an AST expression
+    operationId: GenerateAiDescriptionForAstExpression
+    security:
+      - bearerAuth: []
+    requestBody:
+      description: 'AST expression to generate AI description for'
+      required: true
+      content:
+        application/json:
+          schema:
+            type: object
+            required:
+              ast_expression
+            properties:
+              ast_expression:
+                $ref: 'ast.yml#/components/schemas/NodeDto'
+    responses:
+      '200':
+        description: The created scenario iteration rule AI description
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ScenarioIterationRuleAiDescriptionDto'
 /scenario-iteration-rules/{ruleId}:
   get:
     tags:

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

@@ -952,6 +952,10 @@ export type OpenSanctionsDatasetFreshnessDto = {
     version: string;
     up_to_date: boolean;
 };
+export type ScenarioIterationRuleAiDescriptionDto = {
+    /** The AI description for the scenario iteration rule */
+    description: string;
+};
 export type UpdateScenarioIterationRuleBodyDto = {
     display_order?: number;
     name?: string;
@@ -960,10 +964,6 @@ export type UpdateScenarioIterationRuleBodyDto = {
     formula_ast_expression?: (NodeDto) | null;
     score_modifier?: number;
 };
-export type ScenarioIterationRuleAiDescriptionDto = {
-    /** The AI description for the scenario iteration rule */
-    description: string;
-};
 export type PublicationAction = "publish" | "unpublish";
 export type ScenarioPublication = {
     id: string;
@@ -3232,6 +3232,21 @@ export function createScenarioIterationRule(createScenarioIterationRuleBodyDto:
         body: createScenarioIterationRuleBodyDto
     })));
 }
+/**
+ * Generate AI description for an AST expression
+ */
+export function generateAiDescriptionForAstExpression(body: {
+    ast_expression: NodeDto;
+}, opts?: Oazapfts.RequestOpts) {
+    return oazapfts.ok(oazapfts.fetchJson<{
+        status: 200;
+        data: ScenarioIterationRuleAiDescriptionDto;
+    }>("/scenario-iteration-rules/ai-description", oazapfts.json({
+        ...opts,
+        method: "POST",
+        body
+    })));
+}
 /**
  * Get a scenario iteration rule by id
  */