@praxisui/page-builder 9.0.54 → 9.0.56

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-09-01T03:28:13.726Z",
+  "generatedAt": "2026-09-01T07:07:50.474Z",
   "packageName": "@praxisui/page-builder",
-  "packageVersion": "9.0.54",
+  "packageVersion": "9.0.56",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,

package/fesm2022/praxisui-page-builder.mjs

@@ -18639,7 +18639,7 @@ class PageBuilderAgenticAuthoringTurnFlow {
                 canApply: false,
                 statusText: '',
                 errorText: '',
-                preview: null,
+                preview: this.projectKnowledgeDiagnosticPreview(preview),
                 pendingClarification,
                 diagnostics: streamResultDiagnostics,
             };
@@ -18874,6 +18874,15 @@ class PageBuilderAgenticAuthoringTurnFlow {
             || failureCodes.some((code) => code === 'semantic-decision-required'
                 || code.startsWith('semantic-preview-'));
     }
+    /**
+     * A clarification cannot expose a materializable preview, but Project Knowledge audit is
+     * governed evidence for the turn rather than a page patch. Keep only that diagnostics-bearing
+     * envelope so the cockpit can explain the influence while apply remains disabled.
+     */
+    projectKnowledgeDiagnosticPreview(preview) {
+        const audit = preview?.diagnostics?.projectKnowledgeAudit;
+        return audit && Number(audit.influenceCount ?? 0) > 0 ? preview ?? null : null;
+    }
     hasMaterializablePreview(preview) {
         if (!preview) {
             return false;
@@ -21802,6 +21811,7 @@ class DynamicPageBuilderComponent {
     agenticAuthoringStatus = signal('', ...(ngDevMode ? [{ debugName: "agenticAuthoringStatus" }] : /* istanbul ignore next */ []));
     agenticAuthoringError = signal('', ...(ngDevMode ? [{ debugName: "agenticAuthoringError" }] : /* istanbul ignore next */ []));
     agenticAuthoringPreviewResult = signal(null, ...(ngDevMode ? [{ debugName: "agenticAuthoringPreviewResult" }] : /* istanbul ignore next */ []));
+    agenticAuthoringProjectKnowledgeAuditState = signal(null, ...(ngDevMode ? [{ debugName: "agenticAuthoringProjectKnowledgeAuditState" }] : /* istanbul ignore next */ []));
     agenticAuthoringMaterializationPending = signal(false, ...(ngDevMode ? [{ debugName: "agenticAuthoringMaterializationPending" }] : /* istanbul ignore next */ []));
     agenticAuthoringSemanticDecision = signal(null, ...(ngDevMode ? [{ debugName: "agenticAuthoringSemanticDecision" }] : /* istanbul ignore next */ []));
     agenticAuthoringSemanticResourcePresentationLabel = signal(null, ...(ngDevMode ? [{ debugName: "agenticAuthoringSemanticResourcePresentationLabel" }] : /* istanbul ignore next */ []));
@@ -21881,7 +21891,7 @@ class DynamicPageBuilderComponent {
                 this.cancelActiveAgenticTurn();
                 this.agenticAuthoringBusy.set(false);
                 this.agenticAuthoringOpen.set(false);
-                this.agenticAuthoringPreviewResult.set(null);
+                this.clearAgenticAuthoringPreviewState();
                 this.invalidateAgenticTerminalAuthorization();
             }
         }
@@ -22738,7 +22748,7 @@ class DynamicPageBuilderComponent {
         this.agenticAuthoringPrompt.set('');
         this.agenticAuthoringStatus.set('');
         this.agenticAuthoringError.set('');
-        this.agenticAuthoringPreviewResult.set(null);
+        this.clearAgenticAuthoringPreviewState();
         this.agenticAuthoringMaterializationPending.set(false);
         this.clearAgenticLocalPreviewHistory();
         this.agenticAuthoringSemanticDecision.set(null);
@@ -22806,12 +22816,17 @@ class DynamicPageBuilderComponent {
         return normalized.length > 96 ? `${normalized.slice(0, 93)}...` : normalized;
     }
     agenticAuthoringProjectKnowledgeAudit() {
-        const audit = this.agenticAuthoringPreviewResult()?.diagnostics?.projectKnowledgeAudit ?? null;
+        const audit = this.agenticAuthoringPreviewResult()?.diagnostics?.projectKnowledgeAudit
+            ?? this.agenticAuthoringProjectKnowledgeAuditState();
         if (!audit || !audit.influenceCount || audit.influenceCount <= 0) {
             return null;
         }
         return audit;
     }
+    clearAgenticAuthoringPreviewState() {
+        this.agenticAuthoringPreviewResult.set(null);
+        this.agenticAuthoringProjectKnowledgeAuditState.set(null);
+    }
     canRunProjectKnowledgeChangeSet() {
         return !!this.resolveProjectKnowledgeEvidenceCandidate(this.agenticAuthoringProjectKnowledgeAudit());
     }
@@ -23250,7 +23265,7 @@ class DynamicPageBuilderComponent {
         const turnRunId = this.beginAgenticTurn();
         this.agenticAuthoringBusy.set(true);
         this.agenticAuthoringError.set('');
-        this.agenticAuthoringPreviewResult.set(null);
+        this.clearAgenticAuthoringPreviewState();
         this.invalidateAgenticTerminalAuthorization();
         this.agenticAuthoringSharedRuleHandoffState.set(null);
         this.clearSharedRuleCockpitState();
@@ -23296,7 +23311,7 @@ class DynamicPageBuilderComponent {
         this.agenticAuthoringQuickReplies.set([]);
         this.agenticAuthoringBusy.set(true);
         this.agenticAuthoringError.set('');
-        this.agenticAuthoringPreviewResult.set(null);
+        this.clearAgenticAuthoringPreviewState();
         this.invalidateAgenticTerminalAuthorization();
         this.agenticAuthoringSharedRuleHandoffState.set(null);
         this.clearSharedRuleCockpitState();
@@ -23372,7 +23387,7 @@ class DynamicPageBuilderComponent {
         this.agenticAuthoringQuickReplies.set([]);
         this.agenticAuthoringBusy.set(true);
         this.agenticAuthoringError.set('');
-        this.agenticAuthoringPreviewResult.set(null);
+        this.clearAgenticAuthoringPreviewState();
         this.invalidateAgenticTerminalAuthorization();
         this.agenticAuthoringSharedRuleHandoffState.set(null);
         this.clearSharedRuleCockpitState();
@@ -23617,7 +23632,7 @@ class DynamicPageBuilderComponent {
         this.agenticAuthoringBusy.set(true);
         this.agenticAuthoringStatus.set(this.tx('agentic.status.resolvingIntent', 'Entendendo o pedido...'));
         this.agenticAuthoringError.set('');
-        this.agenticAuthoringPreviewResult.set(null);
+        this.clearAgenticAuthoringPreviewState();
         this.invalidateAgenticTerminalAuthorization();
         this.clearProjectKnowledgeCockpitState();
         try {
@@ -23676,7 +23691,7 @@ class DynamicPageBuilderComponent {
         this.agenticAuthoringBusy.set(false);
         this.agenticAuthoringEditingMessageId.set(null);
         this.agenticAuthoringPrompt.set('');
-        this.agenticAuthoringPreviewResult.set(null);
+        this.clearAgenticAuthoringPreviewState();
         this.agenticAuthoringSemanticDecision.set(null);
         this.agenticAuthoringTurnResultRef.set(null);
         this.agenticAuthoringApplyTarget.set(null);
@@ -23730,7 +23745,7 @@ class DynamicPageBuilderComponent {
                 return;
             this.agenticAuthoringLastEtag.set(result.etag ?? null);
             this.agenticAuthoringApplied.emit(result);
-            this.agenticAuthoringPreviewResult.set(null);
+            this.clearAgenticAuthoringPreviewState();
             this.agenticAuthoringMaterializationPending.set(false);
             this.clearAgenticLocalPreviewHistory();
             // The applied decision remains the active semantic lineage for the next authoring turn.
@@ -24306,7 +24321,7 @@ class DynamicPageBuilderComponent {
         this.agenticAuthoringQuickReplies.set([]);
         this.agenticAuthoringStatus.set(this.tx('agentic.status.sharedRuleTargetSelected', 'Continue this request in the rule review.'));
         this.agenticAuthoringError.set('');
-        this.agenticAuthoringPreviewResult.set(null);
+        this.clearAgenticAuthoringPreviewState();
         this.agenticAuthoringCanApply.set(false);
         this.agenticAuthoringSharedRuleHandoffState.set(next);
         this.agenticAuthoringSharedRuleHandoff.emit(next);
@@ -24827,6 +24842,7 @@ class DynamicPageBuilderComponent {
             : state.statusText);
         this.agenticAuthoringError.set(state.errorText || invalidPreviewError);
         this.agenticAuthoringPreviewResult.set(preview);
+        this.agenticAuthoringProjectKnowledgeAuditState.set(receivedPreview?.diagnostics?.projectKnowledgeAudit ?? null);
         this.agenticAuthoringSemanticDecision.set(this.resolveAgenticSemanticDecision(state.diagnostics));
         this.agenticAuthoringSemanticResourcePresentationLabel.set(this.resolveAgenticSemanticResourcePresentationLabel(state.diagnostics));
         const turnResultRef = this.resolveAgenticTurnResultRef(state.diagnostics);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "9.0.54",
+  "version": "9.0.56",
   "description": "Page and widget builder utilities for Praxis UI (grid, dynamic widgets, editors).",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -8,9 +8,9 @@
     "@angular/forms": "^21.0.0",
     "@angular/cdk": "^21.0.0",
     "@angular/material": "^21.0.0",
-    "@praxisui/ai": "^9.0.54",
-    "@praxisui/core": "^9.0.54",
-    "@praxisui/settings-panel": "^9.0.54",
+    "@praxisui/ai": "^9.0.56",
+    "@praxisui/core": "^9.0.56",
+    "@praxisui/settings-panel": "^9.0.56",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-page-builder.d.ts

@@ -1955,6 +1955,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     readonly agenticAuthoringStatus: _angular_core.WritableSignal<string>;
     readonly agenticAuthoringError: _angular_core.WritableSignal<string>;
     readonly agenticAuthoringPreviewResult: _angular_core.WritableSignal<PageBuilderPreviewResult | null>;
+    private readonly agenticAuthoringProjectKnowledgeAuditState;
     private readonly agenticAuthoringMaterializationPending;
     readonly agenticAuthoringSemanticDecision: _angular_core.WritableSignal<AgenticAuthoringSemanticDecisionContract | null>;
     private readonly agenticAuthoringSemanticResourcePresentationLabel;
@@ -2084,6 +2085,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private pageIdentityFingerprint;
     private truncateAgenticDockText;
     agenticAuthoringProjectKnowledgeAudit(): PageBuilderProjectKnowledgeAudit | null;
+    private clearAgenticAuthoringPreviewState;
     canRunProjectKnowledgeChangeSet(): boolean;
     sharedRuleGovernedContinuationActions(): PageBuilderGovernedContinuationAction[];
     projectKnowledgeGovernedContinuationActions(): PageBuilderGovernedContinuationAction[];