@praxisui/manual-form 8.0.0-beta.33 → 8.0.0-beta.34

package/fesm2022/praxisui-manual-form.mjs

@@ -1247,7 +1247,7 @@ class ManualFormAgenticAuthoringTurnFlow {
         const schemaFields = this.adapter.getSchemaFields?.()
             ?.map((field) => this.toAiJsonObject(field))
             .filter((field) => Object.keys(field).length > 0);
-        const contextHints = this.optionalJsonObject(this.adapter.getAuthoringContext?.());
+        const contextHints = this.mergeJsonObjects(this.optionalJsonObject(this.adapter.getAuthoringContext?.()), this.optionalJsonObject(request.action?.contextHints));
         if (this.shouldRouteToGovernedDecision(prompt, contextHints)) {
             return this.toGovernedDecisionHandoff(prompt, request);
         }
@@ -1315,6 +1315,7 @@ class ManualFormAgenticAuthoringTurnFlow {
                 state: 'clarification',
                 phase: 'clarify',
                 sessionId: response.sessionId ?? request.sessionId,
+                observationId: response.observationId ?? request.observationId ?? null,
                 assistantMessage: response.message || 'Preciso de mais detalhes para continuar.',
                 clarificationQuestions: this.toClarificationQuestions(response),
                 quickReplies: this.toQuickReplies(response),
@@ -1327,6 +1328,7 @@ class ManualFormAgenticAuthoringTurnFlow {
                 state: 'success',
                 phase: 'summarize',
                 sessionId: response.sessionId ?? request.sessionId,
+                observationId: response.observationId ?? request.observationId ?? null,
                 assistantMessage: message,
                 statusText: message,
                 canApply: false,
@@ -1338,6 +1340,7 @@ class ManualFormAgenticAuthoringTurnFlow {
                 state: 'error',
                 phase: 'capture',
                 sessionId: response.sessionId ?? request.sessionId,
+                observationId: response.observationId ?? request.observationId ?? null,
                 assistantMessage: message,
                 errorText: message,
                 diagnostics: response.warnings?.length ? { warnings: response.warnings } : undefined,
@@ -1348,6 +1351,7 @@ class ManualFormAgenticAuthoringTurnFlow {
                 state: 'error',
                 phase: 'review',
                 sessionId: response.sessionId ?? request.sessionId,
+                observationId: response.observationId ?? request.observationId ?? null,
                 assistantMessage: 'O formulario manual rejeitou patch livre. Gere um componentEditPlan validado pelo PRAXIS_MANUAL_FORM_AUTHORING_MANIFEST antes de propor alteracao local.',
                 errorText: 'Patch livre de formulario manual rejeitado.',
                 canApply: false,
@@ -1364,6 +1368,7 @@ class ManualFormAgenticAuthoringTurnFlow {
             state: 'success',
             phase: 'summarize',
             sessionId: response.sessionId ?? request.sessionId,
+            observationId: response.observationId ?? request.observationId ?? null,
             assistantMessage: response.message || response.explanation || 'Nenhuma alteracao necessaria.',
             statusText: response.message || response.explanation || 'Nenhuma alteracao necessaria.',
             canApply: false,
@@ -1412,6 +1417,8 @@ class ManualFormAgenticAuthoringTurnFlow {
             id: reply.id,
             label: reply.label,
             value: reply.prompt,
+            description: reply.description ?? undefined,
+            contextHints: reply.contextHints ? { ...reply.contextHints } : undefined,
         }));
         return labels.map((label, index) => ({
             id: `manual-form-clarification-${index + 1}`,
@@ -1427,12 +1434,14 @@ class ManualFormAgenticAuthoringTurnFlow {
             return payloads
                 .map((option, index) => {
                 const label = option.label?.trim() || option.value?.trim() || `Opcao ${index + 1}`;
-                const prompt = option.example?.trim() || option.value?.trim() || label;
+                const prompt = option.value?.trim() || option.example?.trim() || label;
                 return {
                     id: `option-${index + 1}`,
                     label,
                     prompt,
                     kind: 'clarification-option',
+                    description: option.example?.trim() || undefined,
+                    contextHints: this.optionalJsonObject(option.contextHints),
                 };
             });
         }
@@ -1514,6 +1523,16 @@ class ManualFormAgenticAuthoringTurnFlow {
         const object = this.toAiJsonObject(value);
         return Object.keys(object).length ? object : undefined;
     }
+    mergeJsonObjects(base, overlay) {
+        if (!base)
+            return overlay;
+        if (!overlay)
+            return base;
+        return {
+            ...base,
+            ...overlay,
+        };
+    }
     toAiJsonObject(value) {
         const record = this.toRecord(value);
         if (!record) {
@@ -2388,12 +2407,21 @@ class ManualFormComponent {
         if (!controller)
             return;
         const state = controller.snapshot();
+        const contextHints = reply.contextHints ? { ...reply.contextHints } : undefined;
         const next$ = state.state === 'clarification'
-            ? controller.answerClarification(reply.prompt)
+            ? controller.answerClarification({
+                id: reply.id,
+                label: reply.label,
+                value: reply.prompt,
+                description: reply.description ?? undefined,
+                contextHints,
+            })
             : controller.submitPrompt(reply.prompt, {
                 kind: reply.kind || 'quick-reply',
                 id: reply.id,
                 value: reply.prompt,
+                displayPrompt: reply.label,
+                contextHints,
             });
         next$.subscribe((nextState) => {
             this.aiAssistantPrompt = '';

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@praxisui/manual-form",
-  "version": "8.0.0-beta.33",
+  "version": "8.0.0-beta.34",
   "description": "Manual form toolkit for Praxis UI: container, instance factory and editor bridge for @praxisui/* fields.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
-    "@praxisui/core": "^8.0.0-beta.33",
-    "@praxisui/dynamic-fields": "^8.0.0-beta.33",
-    "@praxisui/settings-panel": "^8.0.0-beta.33",
-    "@praxisui/metadata-editor": "^8.0.0-beta.33",
+    "@praxisui/core": "^8.0.0-beta.34",
+    "@praxisui/dynamic-fields": "^8.0.0-beta.34",
+    "@praxisui/settings-panel": "^8.0.0-beta.34",
+    "@praxisui/metadata-editor": "^8.0.0-beta.34",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^8.0.0-beta.33",
+    "@praxisui/ai": "^8.0.0-beta.34",
     "rxjs": "~7.8.0"
   },
   "dependencies": {