@praxisui/stepper 8.0.0-beta.32 → 8.0.0-beta.34

package/fesm2022/praxisui-stepper.mjs

@@ -3113,7 +3113,7 @@ class StepperAgenticAuthoringTurnFlow {
         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);
         }
@@ -3169,6 +3169,7 @@ class StepperAgenticAuthoringTurnFlow {
                 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),
@@ -3185,6 +3186,7 @@ class StepperAgenticAuthoringTurnFlow {
                 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,
@@ -3195,6 +3197,7 @@ class StepperAgenticAuthoringTurnFlow {
                 state: 'error',
                 phase: 'review',
                 sessionId: response.sessionId ?? request.sessionId,
+                observationId: response.observationId ?? request.observationId ?? null,
                 assistantMessage: 'O stepper rejeitou patch livre. Gere um componentEditPlan validado pelo PRAXIS_STEPPER_AUTHORING_MANIFEST antes de propor alteracao local.',
                 errorText: 'Patch livre de stepper rejeitado.',
                 canApply: false,
@@ -3211,6 +3214,7 @@ class StepperAgenticAuthoringTurnFlow {
             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,
@@ -3241,7 +3245,13 @@ class StepperAgenticAuthoringTurnFlow {
         const labels = response.questions?.length
             ? response.questions
             : response.message ? [response.message] : ['Qual ajuste voce quer aplicar no stepper?'];
-        const options = this.toQuickReplies(response).map((reply) => ({ id: reply.id, label: reply.label, value: reply.prompt }));
+        const options = this.toQuickReplies(response).map((reply) => ({
+            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: `stepper-clarification-${index + 1}`,
             type: options.length ? 'single-choice' : 'text',
@@ -3255,8 +3265,15 @@ class StepperAgenticAuthoringTurnFlow {
         if (payloads.length) {
             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;
-                return { id: `option-${index + 1}`, label, prompt, kind: 'clarification-option' };
+                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),
+                };
             });
         }
         return (response.options ?? [])
@@ -3328,6 +3345,16 @@ class StepperAgenticAuthoringTurnFlow {
         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)
@@ -3698,12 +3725,21 @@ class PraxisStepper {
         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,22 +1,22 @@
 {
   "name": "@praxisui/stepper",
-  "version": "8.0.0-beta.32",
+  "version": "8.0.0-beta.34",
   "description": "Stepper workflows for Praxis UI with integrated forms, lists, uploads and page builder support.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/cdk": "^21.0.0",
-    "@praxisui/core": "^8.0.0-beta.32",
-    "@praxisui/dynamic-form": "^8.0.0-beta.32",
-    "@praxisui/rich-content": "^8.0.0-beta.32",
-    "@praxisui/settings-panel": "^8.0.0-beta.32",
-    "@praxisui/list": "^8.0.0-beta.32",
-    "@praxisui/files-upload": "^8.0.0-beta.32",
-    "@praxisui/page-builder": "^8.0.0-beta.32",
+    "@praxisui/core": "^8.0.0-beta.34",
+    "@praxisui/dynamic-form": "^8.0.0-beta.34",
+    "@praxisui/rich-content": "^8.0.0-beta.34",
+    "@praxisui/settings-panel": "^8.0.0-beta.34",
+    "@praxisui/list": "^8.0.0-beta.34",
+    "@praxisui/files-upload": "^8.0.0-beta.34",
+    "@praxisui/page-builder": "^8.0.0-beta.34",
     "@angular/forms": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^8.0.0-beta.32",
+    "@praxisui/ai": "^8.0.0-beta.34",
     "rxjs": "~7.8.0"
   },
   "dependencies": {