@praxisui/page-builder 9.0.0-beta.75 → 9.0.0-beta.77

package/README.md

@@ -204,6 +204,8 @@ providers: [
 
 The package exports `PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST` for governed operation discovery. The persisted runtime page is still `WidgetPageDefinition`; intermediate AI plans such as `UiCompositionPlan` must compile before preview, apply, or save.
 
+Streaming apply is fail-closed. A preview is persistable only when it is the unchanged payload of an applicable terminal `result` event and its diagnostics carry the matching `streamId`, `threadId`, `turnId`, and `resultEventId`. A locally regenerated or normalized preview remains available for review, but it cannot reuse an older terminal reference or call `page-apply`; the backend must issue a new terminal result for the new patch.
+
 ## Public API
 
 Main exports:

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-16T21:37:28.607Z",
+  "generatedAt": "2026-07-17T21:08:00.571Z",
   "packageName": "@praxisui/page-builder",
-  "packageVersion": "9.0.0-beta.75",
+  "packageVersion": "9.0.0-beta.77",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,

package/fesm2022/praxisui-page-builder.mjs

@@ -15312,7 +15312,8 @@ class PageBuilderAgenticAuthoringTurnFlow {
                 };
             }
             const status = this.decorateDashboardReviewStatus(this.context.describePreviewStatus(preview), intentResolution, preview);
-            const reviewCanApply = this.reviewCanApply(intentResolution, preview);
+            const reviewCanApply = false;
+            const localReviewDiagnostics = this.buildLocalReviewDiagnostics(intentResolution, preview);
             return {
                 state: 'review',
                 phase: 'review',
@@ -15324,7 +15325,7 @@ class PageBuilderAgenticAuthoringTurnFlow {
                 statusText: this.reviewStatusText(status, reviewCanApply),
                 errorText: '',
                 preview,
-                diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
+                diagnostics: localReviewDiagnostics,
             };
         }
         catch (error) {
@@ -15476,7 +15477,8 @@ class PageBuilderAgenticAuthoringTurnFlow {
             };
         }
         const status = this.decorateDashboardReviewStatus(this.context.describePreviewStatus(preview), intentResolution, preview);
-        const reviewCanApply = this.reviewCanApply(intentResolution, preview);
+        const reviewCanApply = false;
+        const localReviewDiagnostics = this.buildLocalReviewDiagnostics(intentResolution, preview);
         return {
             state: 'review',
             phase: 'review',
@@ -15486,7 +15488,7 @@ class PageBuilderAgenticAuthoringTurnFlow {
             statusText: this.reviewStatusText(status, reviewCanApply),
             errorText: '',
             preview,
-            diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
+            diagnostics: localReviewDiagnostics,
         };
     }
     buildLocalDashboardRepairPreview(prompt, contextHints, intentResolution) {
@@ -16711,6 +16713,13 @@ class PageBuilderAgenticAuthoringTurnFlow {
         const runtimeObservationsStartedAt = Date.now();
         const runtimeObservationResult = await this.collectRuntimeComponentObservations(request);
         const runtimeObservationsElapsedMs = Math.max(0, Date.now() - runtimeObservationsStartedAt);
+        const applyTarget = this.context.applyTarget?.() ?? null;
+        const streamContextHints = applyTarget
+            ? {
+                ...(authoringContext.contextHints ?? {}),
+                agenticApplyTarget: applyTarget,
+            }
+            : authoringContext.contextHints ?? undefined;
         const streamRequest = {
             userPrompt: prompt,
             targetApp: this.context.targetApp,
@@ -16722,6 +16731,7 @@ class PageBuilderAgenticAuthoringTurnFlow {
             model: this.context.model(),
             apiKey: this.context.apiKey(),
             ...authoringContext,
+            contextHints: streamContextHints,
             ...(this.runtimeRelatedSurfaceDisambiguationContext
                 ? {
                     diagnostics: {
@@ -16747,7 +16757,7 @@ class PageBuilderAgenticAuthoringTurnFlow {
                 runtimeObservationsElapsedMs,
                 attachmentCount: authoringContext.attachmentSummaries?.length ?? 0,
                 hasPendingClarification: !!authoringContext.pendingClarification,
-                hasContextHints: !!authoringContext.contextHints,
+                hasContextHints: !!streamContextHints,
                 hasSelectedComponentValidationContext: !!this.toJsonObject(authoringContext.contextHints?.['validationContext']),
                 selectedComponentContextDiagnosticCount: Array.isArray(authoringContext.contextHints?.['contextDiagnostics'])
                     ? authoringContext.contextHints['contextDiagnostics'].length
@@ -16867,21 +16877,52 @@ class PageBuilderAgenticAuthoringTurnFlow {
         const assistantContent = this.toJsonObject(payload['assistantContent'])
             ?? this.toJsonObject(intentResolution.assistantContent)
             ?? null;
-        const canApply = payload['canApply'] === true && !!preview?.valid;
+        const backendCanApply = payload['canApply'] === true && !!preview?.valid;
+        const terminalMaterializationIncomplete = backendCanApply
+            && !this.hasCompiledPagePatch(preview);
+        const terminalApplyTarget = this.applyTargetFromTerminalPayload(payload);
+        const terminalApplyTargetIncomplete = backendCanApply && !terminalApplyTarget;
+        const terminalApplyTargetMismatch = backendCanApply
+            && !!terminalApplyTarget
+            && !this.matchesCurrentApplyTarget(terminalApplyTarget);
+        const terminalTurnResultRef = backendCanApply
+            && !terminalMaterializationIncomplete
+            && !terminalApplyTargetIncomplete
+            && !terminalApplyTargetMismatch
+            ? this.turnResultRefFromStreamEvent(event)
+            : null;
+        const terminalReferenceIncomplete = backendCanApply
+            && !terminalMaterializationIncomplete
+            && !terminalApplyTargetIncomplete
+            && !terminalApplyTargetMismatch
+            && !terminalTurnResultRef;
+        const canApply = backendCanApply
+            && !terminalMaterializationIncomplete
+            && !terminalApplyTargetIncomplete
+            && !terminalApplyTargetMismatch
+            && !terminalReferenceIncomplete;
+        const streamResultDiagnostics = this.buildStreamResultDiagnostics(intentResolution, preview, payload, terminalTurnResultRef, terminalApplyTarget, backendCanApply
+            ? terminalMaterializationIncomplete
+                ? 'terminal-materialization-incomplete'
+                : terminalApplyTargetIncomplete
+                    ? 'terminal-apply-target-incomplete'
+                    : terminalApplyTargetMismatch
+                        ? 'terminal-apply-target-mismatch'
+                        : terminalReferenceIncomplete
+                            ? 'terminal-reference-incomplete'
+                            : null
+            : 'backend-not-applicable');
         const contextualExecutableIntent = request
             ? this.toExecutableContextualComponentIntent(intentResolution, request)
             : null;
-        if (!canApply && contextualExecutableIntent && request && prompt) {
+        if (!backendCanApply && contextualExecutableIntent && request && prompt) {
             return this.completeExecutableStreamPreview(request, prompt, contextualExecutableIntent, preview, preparedContextHints);
         }
-        if (canApply
-            && request
-            && prompt
-            && this.shouldRegenerateStreamPreview(intentResolution, preview)) {
-            return this.completeExecutableStreamPreview(request, prompt, intentResolution, undefined, preparedContextHints);
-        }
         if (!canApply) {
-            if (preview && this.hasMaterializablePreview(preview) && this.isGovernedBlockedStreamPreview(payload, preview)) {
+            if (preview
+                && this.hasMaterializablePreview(preview)
+                && !terminalApplyTargetMismatch
+                && ((backendCanApply && !canApply) || this.isGovernedBlockedStreamPreview(payload, preview))) {
                 const applied = await this.context.applyLocalPreview(preview);
                 if (!applied.success) {
                     const message = applied.error || this.context.tx('agentic.errors.applyLocal', 'Preview could not be applied.');
@@ -16893,11 +16934,7 @@ class PageBuilderAgenticAuthoringTurnFlow {
                         statusText: '',
                         errorText: message,
                         preview: null,
-                        diagnostics: {
-                            ...this.buildTurnDiagnostics(intentResolution, preview),
-                            decisionDiagnostics: this.toJsonObject(payload['decisionDiagnostics']),
-                            toolLoopTrace: Array.isArray(payload['toolLoopTrace']) ? payload['toolLoopTrace'] : undefined,
-                        },
+                        diagnostics: streamResultDiagnostics,
                     };
                 }
                 const status = this.decorateDashboardReviewStatus(assistantMessage || this.context.describePreviewStatus(preview), intentResolution, preview);
@@ -16910,11 +16947,21 @@ class PageBuilderAgenticAuthoringTurnFlow {
                     statusText: this.reviewStatusText(status, false),
                     errorText: '',
                     preview,
-                    diagnostics: {
-                        ...this.buildTurnDiagnostics(intentResolution, preview),
-                        decisionDiagnostics: this.toJsonObject(payload['decisionDiagnostics']),
-                        toolLoopTrace: Array.isArray(payload['toolLoopTrace']) ? payload['toolLoopTrace'] : undefined,
-                    },
+                    diagnostics: streamResultDiagnostics,
+                };
+            }
+            if (backendCanApply) {
+                return {
+                    state: 'review',
+                    phase: 'review',
+                    assistantMessage,
+                    assistantContent,
+                    quickReplies: this.governedBlockedReviewQuickReplies(quickReplies, intentResolution, preview),
+                    canApply: false,
+                    statusText: this.reviewStatusText(assistantMessage, false),
+                    errorText: '',
+                    preview: preview ?? null,
+                    diagnostics: streamResultDiagnostics,
                 };
             }
             const pendingClarification = this.toShellPendingClarification(intentResolution?.pendingClarification)
@@ -16939,7 +16986,7 @@ class PageBuilderAgenticAuthoringTurnFlow {
                 errorText: '',
                 preview: null,
                 pendingClarification,
-                diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
+                diagnostics: streamResultDiagnostics,
             };
         }
         const applied = await this.context.applyLocalPreview(preview);
@@ -16953,11 +17000,11 @@ class PageBuilderAgenticAuthoringTurnFlow {
                 statusText: '',
                 errorText: message,
                 preview: null,
-                diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
+                diagnostics: streamResultDiagnostics,
             };
         }
         const status = this.decorateDashboardReviewStatus(this.context.describePreviewStatus(preview), intentResolution, preview);
-        const reviewCanApply = this.reviewCanApply(intentResolution, preview);
+        const reviewCanApply = canApply && this.reviewCanApply(intentResolution, preview);
         return {
             state: 'review',
             phase: 'review',
@@ -16969,7 +17016,7 @@ class PageBuilderAgenticAuthoringTurnFlow {
             statusText: this.reviewStatusText(status, reviewCanApply),
             errorText: '',
             preview,
-            diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
+            diagnostics: streamResultDiagnostics,
         };
     }
     hasBlockingResourceQuickReply(quickReplies) {
@@ -17041,7 +17088,8 @@ class PageBuilderAgenticAuthoringTurnFlow {
                 };
             }
             const status = this.decorateDashboardReviewStatus(this.context.describePreviewStatus(preview), intentResolution, preview);
-            const reviewCanApply = this.reviewCanApply(intentResolution, preview);
+            const reviewCanApply = false;
+            const localReviewDiagnostics = this.buildLocalReviewDiagnostics(intentResolution, preview);
             return {
                 state: 'review',
                 phase: 'review',
@@ -17053,7 +17101,7 @@ class PageBuilderAgenticAuthoringTurnFlow {
                 statusText: this.reviewStatusText(status, reviewCanApply),
                 errorText: '',
                 preview,
-                diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
+                diagnostics: localReviewDiagnostics,
             };
         }
         catch (error) {
@@ -17082,6 +17130,65 @@ class PageBuilderAgenticAuthoringTurnFlow {
         }
         return true;
     }
+    turnResultRefFromStreamEvent(event) {
+        if (!event || event.type !== 'result') {
+            return null;
+        }
+        const streamId = `${event.streamId || ''}`.trim();
+        const threadId = `${event.threadId || ''}`.trim();
+        const turnId = `${event.turnId || ''}`.trim();
+        const resultEventId = `${event.eventId || ''}`.trim();
+        if (!streamId || !threadId || !turnId || !resultEventId) {
+            return null;
+        }
+        return { streamId, threadId, turnId, resultEventId };
+    }
+    buildStreamResultDiagnostics(intentResolution, preview, payload, turnResultRef, applyTarget, blockReason) {
+        return {
+            ...this.buildTurnDiagnostics(intentResolution, preview),
+            decisionDiagnostics: this.toJsonObject(payload['decisionDiagnostics']),
+            toolLoopTrace: Array.isArray(payload['toolLoopTrace']) ? payload['toolLoopTrace'] : undefined,
+            ...(turnResultRef ? { turnResultRef } : {}),
+            ...(applyTarget ? { applyTarget } : {}),
+            applyLineage: {
+                schemaVersion: 'praxis-agentic-authoring-apply-lineage.v1',
+                status: turnResultRef ? 'terminal-result-reference-present' : 'blocked',
+                reason: blockReason,
+                patchAuthority: turnResultRef ? 'backend-terminal-result' : 'review-only',
+            },
+        };
+    }
+    applyTargetFromTerminalPayload(payload) {
+        const candidate = this.toJsonObject(payload['applyTarget']);
+        if (!candidate
+            || this.readString(candidate, 'schemaVersion') !== 'praxis-agentic-authoring-apply-target.v1'
+            || !this.readString(candidate, 'componentType')
+            || !this.readString(candidate, 'componentId')) {
+            return null;
+        }
+        const scopeValue = this.readString(candidate, 'scope');
+        const mode = this.readString(candidate, 'mode');
+        const baseEtag = this.readString(candidate, 'baseEtag');
+        if ((scopeValue !== 'user' && scopeValue !== 'tenant')
+            || (mode !== 'create' && mode !== 'update')
+            || (mode === 'update' && !baseEtag)
+            || (mode === 'create' && !!baseEtag)) {
+            return null;
+        }
+        const scope = scopeValue;
+        const common = {
+            schemaVersion: 'praxis-agentic-authoring-apply-target.v1',
+            componentType: this.readString(candidate, 'componentType'),
+            componentId: this.readString(candidate, 'componentId'),
+            scope,
+            ...(this.readString(candidate, 'environment')
+                ? { environment: this.readString(candidate, 'environment') }
+                : {}),
+        };
+        return mode === 'update'
+            ? { ...common, mode, baseEtag: baseEtag }
+            : { ...common, mode };
+    }
     isGovernedBlockedStreamPreview(payload, preview) {
         const previewDiagnostics = this.toJsonObject(preview.diagnostics);
         const decisionDiagnostics = this.toJsonObject(payload['decisionDiagnostics'])
@@ -17115,7 +17222,10 @@ class PageBuilderAgenticAuthoringTurnFlow {
         if (preview.uiCompositionPlan) {
             return true;
         }
-        const patch = this.toJsonObject(preview.compiledFormPatch)?.['patch'];
+        return this.hasCompiledPagePatch(preview);
+    }
+    hasCompiledPagePatch(preview) {
+        const patch = this.toJsonObject(preview?.compiledFormPatch)?.['patch'];
         const page = this.toJsonObject(patch)?.['page'];
         return !!this.toJsonObject(page);
     }
@@ -17130,6 +17240,17 @@ class PageBuilderAgenticAuthoringTurnFlow {
         }
         return diagnostics;
     }
+    buildLocalReviewDiagnostics(intentResolution, preview) {
+        return {
+            ...this.buildTurnDiagnostics(intentResolution, preview),
+            applyLineage: {
+                schemaVersion: 'praxis-agentic-authoring-apply-lineage.v1',
+                status: 'local-review-only',
+                reason: 'terminal-result-required',
+                patchAuthority: 'local-preview',
+            },
+        };
+    }
     buildDashboardAuthoringDiagnostics(intentResolution, preview) {
         if (!this.isDashboardQualityPreview(intentResolution, preview)) {
             return null;
@@ -19488,7 +19609,7 @@ class PageBuilderAgenticAuthoringTurnFlow {
     buildContextHints(request) {
         const base = this.toJsonObject(request.action?.contextHints)
             ?? this.toJsonObject(request.contextHints);
-        const normalizedBase = this.normalizeAmbientDomainCatalogContextHints(base);
+        const normalizedBase = this.normalizeAmbientDomainCatalogContextHints(this.withoutAgenticApplyTarget(base));
         const scopedBase = withAuthoringScopePolicyContextHints(normalizedBase, {
             componentId: this.context.targetComponentId,
             componentType: 'page-builder',
@@ -19503,6 +19624,28 @@ class PageBuilderAgenticAuthoringTurnFlow {
             includeLlmDiagnostics: true,
         };
     }
+    withoutAgenticApplyTarget(contextHints) {
+        if (!contextHints || !Object.prototype.hasOwnProperty.call(contextHints, 'agenticApplyTarget')) {
+            return contextHints;
+        }
+        const sanitized = { ...contextHints };
+        delete sanitized['agenticApplyTarget'];
+        return sanitized;
+    }
+    matchesCurrentApplyTarget(target) {
+        if (this.context.matchesApplyTarget) {
+            return this.context.matchesApplyTarget(target);
+        }
+        const current = this.context.applyTarget?.();
+        if (!current)
+            return false;
+        return current.schemaVersion === target.schemaVersion
+            && current.componentType === target.componentType
+            && current.componentId === target.componentId
+            && current.scope === target.scope
+            && current.mode === target.mode
+            && (current.baseEtag ?? null) === (target.baseEtag ?? null);
+    }
     async withSelectedComponentAuthoringContext(authoringContext, selectedWidgetKey) {
         const resolver = this.context.resolveSelectedComponentAuthoringContext;
         if (!selectedWidgetKey || !resolver) {
@@ -19829,7 +19972,9 @@ class DynamicPageBuilderComponent {
     agenticAuthoringPreviewResult = signal(null, ...(ngDevMode ? [{ debugName: "agenticAuthoringPreviewResult" }] : /* 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 */ []));
     agenticAuthoringTurnResultRef = signal(null, ...(ngDevMode ? [{ debugName: "agenticAuthoringTurnResultRef" }] : /* istanbul ignore next */ []));
+    agenticAuthoringApplyTarget = signal(null, ...(ngDevMode ? [{ debugName: "agenticAuthoringApplyTarget" }] : /* istanbul ignore next */ []));
     agenticAuthoringCanApply = signal(false, ...(ngDevMode ? [{ debugName: "agenticAuthoringCanApply" }] : /* istanbul ignore next */ []));
     agenticAuthoringLastEtag = signal(null, ...(ngDevMode ? [{ debugName: "agenticAuthoringLastEtag" }] : /* istanbul ignore next */ []));
     agenticAuthoringConversation = signal([], ...(ngDevMode ? [{ debugName: "agenticAuthoringConversation" }] : /* istanbul ignore next */ []));
@@ -19889,19 +20034,35 @@ class DynamicPageBuilderComponent {
         }
         const pageIdentityChange = changes['pageIdentity'];
         const componentInstanceChange = changes['componentInstanceId'];
+        const agenticComponentIdChange = changes['agenticAuthoringComponentId'];
+        const agenticScopeChange = changes['agenticAuthoringScope'];
         const authoringOwnerChanged = (pageIdentityChange
             && !pageIdentityChange.isFirstChange()
             && this.pageIdentityFingerprint(pageIdentityChange.previousValue)
                 !== this.pageIdentityFingerprint(pageIdentityChange.currentValue)) || (componentInstanceChange
             && !componentInstanceChange.isFirstChange()
             && `${componentInstanceChange.previousValue ?? ''}`.trim()
-                !== `${componentInstanceChange.currentValue ?? ''}`.trim());
+                !== `${componentInstanceChange.currentValue ?? ''}`.trim()) || (agenticComponentIdChange
+            && !agenticComponentIdChange.isFirstChange()
+            && `${agenticComponentIdChange.previousValue ?? ''}`.trim()
+                !== `${agenticComponentIdChange.currentValue ?? ''}`.trim()) || (agenticScopeChange
+            && !agenticScopeChange.isFirstChange()
+            && agenticScopeChange.previousValue !== agenticScopeChange.currentValue);
         if (authoringOwnerChanged) {
             this.resetAgenticAuthoringSessionState(this.resolveAgenticAuthoringSessionId(pageIdentityChange?.previousValue ?? this.pageIdentity, componentInstanceChange?.previousValue ?? this.componentInstanceId));
         }
         else if (changes['pageLifecycleResetRevision'] && !changes['pageLifecycleResetRevision'].isFirstChange()) {
             this.resetAgenticAuthoringSessionState();
         }
+        const authoringEtagChange = changes['agenticAuthoringEtag'];
+        if (authoringEtagChange
+            && !authoringEtagChange.isFirstChange()
+            && this.normalizeAgenticEtag(`${authoringEtagChange.previousValue ?? ''}`)
+                !== this.normalizeAgenticEtag(`${authoringEtagChange.currentValue ?? ''}`)) {
+            this.cancelActiveAgenticTurn();
+            this.agenticAuthoringLastEtag.set(null);
+            this.invalidateAgenticTerminalAuthorization();
+        }
     }
     ngOnDestroy() {
         this.cancelActiveAgenticTurn();
@@ -20591,6 +20752,7 @@ class DynamicPageBuilderComponent {
             || this.agenticAuthoringBusy();
     }
     resetAgenticAuthoringSessionState(sessionIdToRemove = this.resolveAgenticAuthoringSessionId()) {
+        this.cancelActiveAgenticTurn();
         this.agenticTurnController = undefined;
         this.sharedRuleHandoffRevision += 1;
         this.agenticAuthoringBusy.set(false);
@@ -20600,8 +20762,11 @@ class DynamicPageBuilderComponent {
         this.agenticAuthoringPreviewResult.set(null);
         this.agenticAuthoringMaterializationPending.set(false);
         this.agenticAuthoringSemanticDecision.set(null);
+        this.agenticAuthoringSemanticResourcePresentationLabel.set(null);
         this.agenticAuthoringTurnResultRef.set(null);
+        this.agenticAuthoringApplyTarget.set(null);
         this.agenticAuthoringCanApply.set(false);
+        this.agenticAuthoringLastEtag.set(null);
         this.agenticAuthoringConversation.set([]);
         this.agenticAuthoringQuickReplies.set([]);
         this.agenticAuthoringAttachments.set([]);
@@ -20970,7 +21135,9 @@ class DynamicPageBuilderComponent {
                 id: 'semantic-decision-resource',
                 kind: 'custom',
                 label: this.tx('agentic.context.semanticDecisionResource', 'Fonte'),
-                value: this.agenticSemanticResourceLabel(selectedResource) ?? this.humanizeAgenticResourcePath(resourcePath),
+                value: this.agenticSemanticResourceLabel(selectedResource)
+                    ?? this.agenticAuthoringSemanticResourcePresentationLabel()
+                    ?? this.humanizeAgenticResourcePath(resourcePath),
                 icon: 'dataset',
             });
         }
@@ -21100,7 +21267,7 @@ class DynamicPageBuilderComponent {
         this.agenticAuthoringBusy.set(true);
         this.agenticAuthoringError.set('');
         this.agenticAuthoringPreviewResult.set(null);
-        this.agenticAuthoringCanApply.set(false);
+        this.invalidateAgenticTerminalAuthorization();
         this.agenticAuthoringSharedRuleHandoffState.set(null);
         this.clearSharedRuleCockpitState();
         this.clearProjectKnowledgeCockpitState();
@@ -21143,7 +21310,7 @@ class DynamicPageBuilderComponent {
         this.agenticAuthoringBusy.set(true);
         this.agenticAuthoringError.set('');
         this.agenticAuthoringPreviewResult.set(null);
-        this.agenticAuthoringCanApply.set(false);
+        this.invalidateAgenticTerminalAuthorization();
         this.agenticAuthoringSharedRuleHandoffState.set(null);
         this.clearSharedRuleCockpitState();
         this.clearProjectKnowledgeCockpitState();
@@ -21183,6 +21350,7 @@ class DynamicPageBuilderComponent {
             return;
         }
         if (replyKind === 'revise') {
+            this.invalidateAgenticTerminalAuthorization();
             this.agenticAuthoringEditingMessageId.set(null);
             this.agenticAuthoringQuickReplies.set([]);
             this.agenticAuthoringStatus.set(this.tx('agentic.status.waitingRevision', 'Ajuste o pedido e crie uma nova prévia.'));
@@ -21201,7 +21369,7 @@ class DynamicPageBuilderComponent {
         this.agenticAuthoringBusy.set(true);
         this.agenticAuthoringError.set('');
         this.agenticAuthoringPreviewResult.set(null);
-        this.agenticAuthoringCanApply.set(false);
+        this.invalidateAgenticTerminalAuthorization();
         this.agenticAuthoringSharedRuleHandoffState.set(null);
         this.clearSharedRuleCockpitState();
         this.clearProjectKnowledgeCockpitState();
@@ -21424,6 +21592,7 @@ class DynamicPageBuilderComponent {
     editAgenticMessage(message) {
         if (message.role !== 'user')
             return;
+        this.invalidateAgenticTerminalAuthorization();
         this.agenticAuthoringEditingMessageId.set(message.id);
         this.agenticAuthoringPrompt.set(message.text);
         this.agenticAuthoringStatus.set(this.tx('agentic.status.waitingRevision', 'Ajuste o pedido e crie uma nova prévia.'));
@@ -21437,7 +21606,7 @@ class DynamicPageBuilderComponent {
         this.agenticAuthoringStatus.set(this.tx('agentic.status.resolvingIntent', 'Entendendo o pedido...'));
         this.agenticAuthoringError.set('');
         this.agenticAuthoringPreviewResult.set(null);
-        this.agenticAuthoringCanApply.set(false);
+        this.invalidateAgenticTerminalAuthorization();
         this.clearProjectKnowledgeCockpitState();
         try {
             await this.consumeAgenticTurn(this.ensureAgenticTurnController().resendMessage(message.id), turnRunId);
@@ -21459,6 +21628,7 @@ class DynamicPageBuilderComponent {
     async retryAgenticAuthoring() {
         if (this.agenticAuthoringBusy())
             return;
+        this.invalidateAgenticTerminalAuthorization();
         const turnRunId = this.beginAgenticTurn();
         this.agenticAuthoringEditingMessageId.set(null);
         this.agenticAuthoringBusy.set(true);
@@ -21481,6 +21651,12 @@ class DynamicPageBuilderComponent {
             }
         }
     }
+    updateAgenticAuthoringPrompt(prompt) {
+        if (prompt !== this.agenticAuthoringPrompt()) {
+            this.invalidateAgenticTerminalAuthorization();
+        }
+        this.agenticAuthoringPrompt.set(prompt);
+    }
     async cancelAgenticAuthoring() {
         this.cancelActiveAgenticTurn();
         this.agenticAuthoringBusy.set(false);
@@ -21489,6 +21665,7 @@ class DynamicPageBuilderComponent {
         this.agenticAuthoringPreviewResult.set(null);
         this.agenticAuthoringSemanticDecision.set(null);
         this.agenticAuthoringTurnResultRef.set(null);
+        this.agenticAuthoringApplyTarget.set(null);
         this.agenticAuthoringCanApply.set(false);
         this.agenticAuthoringSharedRuleHandoffState.set(null);
         this.clearSharedRuleCockpitState();
@@ -21504,6 +21681,12 @@ class DynamicPageBuilderComponent {
             this.agenticAuthoringError.set(this.tx('agentic.errors.componentId', 'Configure a component id before saving.'));
             return;
         }
+        const applyTarget = this.agenticAuthoringApplyTarget();
+        if (!applyTarget || !this.matchesCurrentAgenticApplyTarget(applyTarget)) {
+            this.agenticAuthoringCanApply.set(false);
+            this.agenticAuthoringError.set(this.tx('agentic.errors.applyTargetExpired', 'O destino ou a versão revisada mudou. Gere uma nova prévia antes de salvar.'));
+            return;
+        }
         this.agenticAuthoringBusy.set(true);
         this.agenticAuthoringError.set('');
         this.agenticAuthoringStatus.set(this.tx('agentic.status.saving', 'Salvando tela...'));
@@ -21519,7 +21702,7 @@ class DynamicPageBuilderComponent {
                 streamId: turnResultRef.streamId,
                 resultEventId: turnResultRef.resultEventId,
                 scope: this.agenticAuthoringScope,
-                ifMatch: this.agenticAuthoringEtag || this.agenticAuthoringLastEtag() || undefined,
+                ifMatch: this.currentAgenticAuthoringEtag() || undefined,
                 tags: {
                     source: 'page-builder-agentic-authoring',
                 },
@@ -21531,6 +21714,7 @@ class DynamicPageBuilderComponent {
             this.agenticAuthoringMaterializationPending.set(false);
             this.agenticAuthoringSemanticDecision.set(null);
             this.agenticAuthoringTurnResultRef.set(null);
+            this.agenticAuthoringApplyTarget.set(null);
             this.agenticAuthoringCanApply.set(false);
             this.agenticAuthoringQuickReplies.set([]);
             this.agenticAuthoringPrompt.set('');
@@ -22394,6 +22578,22 @@ class DynamicPageBuilderComponent {
                 provider: () => this.agenticAuthoringProvider,
                 model: () => this.agenticAuthoringModel,
                 apiKey: () => this.agenticAuthoringApiKey,
+                applyTarget: () => {
+                    const componentId = this.resolveAgenticComponentId();
+                    if (!componentId)
+                        return null;
+                    const baseEtag = this.currentAgenticAuthoringEtag();
+                    const common = {
+                        schemaVersion: 'praxis-agentic-authoring-apply-target.v1',
+                        componentType: 'praxis-dynamic-page',
+                        componentId,
+                        scope: this.agenticAuthoringScope,
+                    };
+                    return baseEtag
+                        ? { ...common, mode: 'update', baseEtag: this.normalizeAgenticEtag(baseEtag) }
+                        : { ...common, mode: 'create' };
+                },
+                matchesApplyTarget: (target) => this.matchesCurrentAgenticApplyTarget(target),
                 enableTurnStream: () => this.agenticAuthoringEnableStreaming,
                 includeLlmDiagnostics: () => this.agenticAuthoringIncludeLlmDiagnostics,
                 collectRuntimeComponentObservations: () => this.collectRuntimeComponentObservationsForAgenticTurn(),
@@ -22421,9 +22621,11 @@ class DynamicPageBuilderComponent {
     }
     async applyAgenticPreviewLocally(result) {
         const adapter = new PageBuilderAiAdapter(this.createAdapterHost(), this.componentMetadata);
-        const applied = await (result.uiCompositionPlan
-            ? adapter.applyUiCompositionPlan(result.uiCompositionPlan)
-            : adapter.applyCompiledFormPatch(result.compiledFormPatch));
+        const applied = await (result.compiledFormPatch?.patch?.page
+            ? adapter.applyCompiledFormPatch(result.compiledFormPatch)
+            : result.uiCompositionPlan
+                ? adapter.applyUiCompositionPlan(result.uiCompositionPlan)
+                : adapter.applyCompiledFormPatch(result.compiledFormPatch));
         if (!applied.success && this.isAgenticTableContractError(applied.error)) {
             return {
                 ...applied,
@@ -22480,9 +22682,18 @@ class DynamicPageBuilderComponent {
         this.agenticAuthoringError.set(state.errorText);
         this.agenticAuthoringPreviewResult.set(preview);
         this.agenticAuthoringSemanticDecision.set(this.resolveAgenticSemanticDecision(state.diagnostics));
+        this.agenticAuthoringSemanticResourcePresentationLabel.set(this.resolveAgenticSemanticResourcePresentationLabel(state.diagnostics));
         const turnResultRef = this.resolveAgenticTurnResultRef(state.diagnostics);
-        this.agenticAuthoringTurnResultRef.set(turnResultRef);
-        this.agenticAuthoringCanApply.set(!!preview?.valid && !!state.canApply && !!turnResultRef);
+        const applyTarget = this.resolveAgenticApplyTarget(state.diagnostics);
+        const canApply = (!!preview?.valid
+            && !!preview.compiledFormPatch?.patch?.page
+            && !!state.canApply
+            && !!turnResultRef
+            && !!applyTarget
+            && this.matchesCurrentAgenticApplyTarget(applyTarget));
+        this.agenticAuthoringTurnResultRef.set(canApply ? turnResultRef : null);
+        this.agenticAuthoringApplyTarget.set(canApply ? applyTarget : null);
+        this.agenticAuthoringCanApply.set(canApply);
         this.moveAgenticAuthoringPanelToReviewSidecar(preview);
         this.agenticAuthoringAttachments.set(state.attachments);
         if (!this.sameSharedRuleHandoffIdentity(previousHandoff, handoff)) {
@@ -22704,6 +22915,11 @@ class DynamicPageBuilderComponent {
         this.agenticTurnRunId += 1;
         this.agenticTurnCancel$.next();
     }
+    invalidateAgenticTerminalAuthorization() {
+        this.agenticAuthoringTurnResultRef.set(null);
+        this.agenticAuthoringApplyTarget.set(null);
+        this.agenticAuthoringCanApply.set(false);
+    }
     isCurrentAgenticTurn(turnRunId) {
         return this.agenticTurnRunId === turnRunId;
     }
@@ -22783,6 +22999,12 @@ class DynamicPageBuilderComponent {
         }
         return semanticDecision;
     }
+    resolveAgenticSemanticResourcePresentationLabel(diagnostics) {
+        const intentResolution = this.toRecord(diagnostics?.['intentResolution']);
+        const intentContextHints = this.toRecord(intentResolution?.['contextHints']);
+        return this.trimmedString(intentContextHints?.['resourceLabel'])
+            ?? this.trimmedString(intentContextHints?.['selectedResourceLabel']);
+    }
     resolveAgenticTurnResultRef(diagnostics) {
         const candidate = this.toRecord(diagnostics?.['turnResultRef']);
         const streamId = this.trimmedString(candidate?.['streamId']);
@@ -22794,6 +23016,58 @@ class DynamicPageBuilderComponent {
         }
         return { streamId, threadId, turnId, resultEventId };
     }
+    resolveAgenticApplyTarget(diagnostics) {
+        const candidate = this.toRecord(diagnostics?.['applyTarget']);
+        const schemaVersion = this.trimmedString(candidate?.['schemaVersion']);
+        const componentType = this.trimmedString(candidate?.['componentType']);
+        const componentId = this.trimmedString(candidate?.['componentId']);
+        const scope = this.trimmedString(candidate?.['scope']);
+        const mode = this.trimmedString(candidate?.['mode']);
+        const baseEtag = this.trimmedString(candidate?.['baseEtag']);
+        const environment = this.trimmedString(candidate?.['environment']);
+        if (schemaVersion !== 'praxis-agentic-authoring-apply-target.v1'
+            || !componentType
+            || !componentId
+            || (scope !== 'user' && scope !== 'tenant')
+            || (mode !== 'create' && mode !== 'update')
+            || (mode === 'update' && !baseEtag)
+            || (mode === 'create' && !!baseEtag)) {
+            return null;
+        }
+        const common = {
+            schemaVersion,
+            componentType,
+            componentId,
+            scope,
+            ...(environment ? { environment } : {}),
+        };
+        return mode === 'update'
+            ? { ...common, mode, baseEtag: this.normalizeAgenticEtag(baseEtag) }
+            : { ...common, mode };
+    }
+    matchesCurrentAgenticApplyTarget(target) {
+        const componentId = this.resolveAgenticComponentId();
+        const baseEtag = this.currentAgenticAuthoringEtag();
+        return !!componentId
+            && target.componentType === 'praxis-dynamic-page'
+            && target.componentId === componentId
+            && target.scope === this.agenticAuthoringScope
+            && target.mode === (baseEtag ? 'update' : 'create')
+            && (target.baseEtag ?? null) === (baseEtag ? this.normalizeAgenticEtag(baseEtag) : null);
+    }
+    normalizeAgenticEtag(value) {
+        let normalized = value.trim();
+        if (/^W\//i.test(normalized)) {
+            normalized = normalized.slice(2).trim();
+        }
+        if (normalized.length >= 2 && normalized.startsWith('"') && normalized.endsWith('"')) {
+            normalized = normalized.slice(1, -1);
+        }
+        return normalized.trim();
+    }
+    currentAgenticAuthoringEtag() {
+        return this.agenticAuthoringLastEtag() || this.agenticAuthoringEtag || null;
+    }
     cloneAgenticContextHints(contextHints) {
         if (!contextHints || typeof contextHints !== 'object' || Array.isArray(contextHints)) {
             return undefined;
@@ -22852,7 +23126,10 @@ class DynamicPageBuilderComponent {
         return value;
     }
     resolvePreviewCompiledFormPatch(preview) {
-        if (preview.uiCompositionPlan || preview.compiledFormPatch?.patch?.page) {
+        if (preview.compiledFormPatch?.patch?.page) {
+            return preview.compiledFormPatch;
+        }
+        if (preview.uiCompositionPlan) {
             const planDiagnostics = this.toRecord(this.toRecord(preview.uiCompositionPlan)?.['diagnostics']);
             return {
                 ...preview.compiledFormPatch,
@@ -23220,8 +23497,8 @@ class DynamicPageBuilderComponent {
           [minWidth]="320"
           [minHeight]="280"
           [margin]="8"
-          (promptChange)="agenticAuthoringPrompt.set($event)"
-          (submitPrompt)="agenticAuthoringPrompt.set($event); previewAgenticAuthoring()"
+          (promptChange)="updateAgenticAuthoringPrompt($event)"
+          (submitPrompt)="updateAgenticAuthoringPrompt($event); previewAgenticAuthoring()"
           (apply)="persistAgenticAuthoring()"
           (retryTurn)="retryAgenticAuthoring()"
           (cancelTurn)="cancelAgenticAuthoring()"
@@ -23720,8 +23997,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
           [minWidth]="320"
           [minHeight]="280"
           [margin]="8"
-          (promptChange)="agenticAuthoringPrompt.set($event)"
-          (submitPrompt)="agenticAuthoringPrompt.set($event); previewAgenticAuthoring()"
+          (promptChange)="updateAgenticAuthoringPrompt($event)"
+          (submitPrompt)="updateAgenticAuthoringPrompt($event); previewAgenticAuthoring()"
           (apply)="persistAgenticAuthoring()"
           (retryTurn)="retryAgenticAuthoring()"
           (cancelTurn)="cancelAgenticAuthoring()"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "9.0.0-beta.75",
+  "version": "9.0.0-beta.77",
   "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.0-beta.75",
-    "@praxisui/core": "^9.0.0-beta.75",
-    "@praxisui/settings-panel": "^9.0.0-beta.75",
+    "@praxisui/ai": "^9.0.0-beta.77",
+    "@praxisui/core": "^9.0.0-beta.77",
+    "@praxisui/settings-panel": "^9.0.0-beta.77",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

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

@@ -6,7 +6,7 @@ import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
 import { FormGroup, FormControl, FormArray } from '@angular/forms';
 import { SettingsValueProvider } from '@praxisui/settings-panel';
-import { AgenticAuthoringAttachmentSummaryContract, AgenticAuthoringCandidateContract, AiJsonValue, AgenticAuthoringComponentCapabilitiesResultContract, AgenticAuthoringComponentCapabilityCatalogContract, AgenticAuthoringComponentCapabilityContract, AgenticAuthoringComponentFieldAliasContract, AgenticAuthoringComponentCapabilityExampleContract, AgenticAuthoringConversationMessageContract, AgenticAuthoringIntentResolutionRequestContract, AiJsonObject, AgenticAuthoringQuickReplyContract, AgenticAuthoringPendingClarificationContract, AiContextHintsContract, AgenticAuthoringSemanticDecisionContract, AgenticAuthoringPlanRequestContract, AgenticAuthoringResourceCandidatesRequestContract, AgenticAuthoringResourceCandidatesResultContract, AgenticAuthoringTurnStreamEnvelopeContract, AgenticAuthoringTurnStreamStartResponseContract, PraxisAssistantShellMessage, PraxisAssistantShellQuickReply, PraxisAssistantShellAttachment, PraxisAssistantShellLayout, PraxisAssistantSessionSnapshot, PraxisAssistantShellLabels, PraxisAssistantRecommendedIntent, PraxisAssistantShellAction, PraxisAssistantShellState, PraxisAssistantShellContextItem } from '@praxisui/ai';
+import { AgenticAuthoringAttachmentSummaryContract, AgenticAuthoringCandidateContract, AiJsonValue, AgenticAuthoringComponentCapabilitiesResultContract, AgenticAuthoringComponentCapabilityCatalogContract, AgenticAuthoringComponentCapabilityContract, AgenticAuthoringComponentFieldAliasContract, AgenticAuthoringComponentCapabilityExampleContract, AgenticAuthoringConversationMessageContract, AgenticAuthoringIntentResolutionRequestContract, AiJsonObject, AgenticAuthoringQuickReplyContract, AgenticAuthoringPendingClarificationContract, AiContextHintsContract, AgenticAuthoringSemanticDecisionContract, AgenticAuthoringPlanRequestContract, AgenticAuthoringResourceCandidatesRequestContract, AgenticAuthoringResourceCandidatesResultContract, AgenticAuthoringTurnStreamContextHintsContract, AgenticAuthoringTurnStreamEnvelopeContract, AgenticAuthoringTurnStreamStartResponseContract, PraxisAssistantShellMessage, PraxisAssistantShellQuickReply, PraxisAssistantShellAttachment, PraxisAssistantShellLayout, PraxisAssistantSessionSnapshot, PraxisAssistantShellLabels, PraxisAssistantRecommendedIntent, PraxisAssistantShellAction, PraxisAssistantShellState, PraxisAssistantShellContextItem } from '@praxisui/ai';
 
 declare const PLACEHOLDER = 1;
 
@@ -1276,7 +1276,7 @@ interface PageBuilderAgenticAuthoringTurnStreamRequest {
     pendingClarification?: PageBuilderAgenticAuthoringPendingClarification | null;
     componentCapabilities?: PageBuilderAgenticAuthoringComponentCapabilitiesResult | null;
     attachmentSummaries?: PageBuilderAgenticAuthoringAttachmentSummary[];
-    contextHints?: AiContextHintsContract | null;
+    contextHints?: AgenticAuthoringTurnStreamContextHintsContract | null;
     diagnostics?: AiJsonObject | null;
     runtimeComponentObservations?: readonly PraxisRuntimeComponentObservationEnvelope[];
     runtimeComponentObservationTrustBoundary?: 'untrusted_frontend_observation';
@@ -1773,7 +1773,9 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     readonly agenticAuthoringPreviewResult: _angular_core.WritableSignal<PageBuilderPreviewResult | null>;
     private readonly agenticAuthoringMaterializationPending;
     readonly agenticAuthoringSemanticDecision: _angular_core.WritableSignal<AgenticAuthoringSemanticDecisionContract | null>;
+    private readonly agenticAuthoringSemanticResourcePresentationLabel;
     private readonly agenticAuthoringTurnResultRef;
+    private readonly agenticAuthoringApplyTarget;
     readonly agenticAuthoringCanApply: _angular_core.WritableSignal<boolean>;
     readonly agenticAuthoringLastEtag: _angular_core.WritableSignal<string | null>;
     readonly agenticAuthoringConversation: _angular_core.WritableSignal<PraxisAssistantShellMessage[]>;
@@ -1920,6 +1922,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     editAgenticMessage(message: PraxisAssistantShellMessage): void;
     resendAgenticMessage(message: PraxisAssistantShellMessage): Promise<void>;
     retryAgenticAuthoring(): Promise<void>;
+    updateAgenticAuthoringPrompt(prompt: string): void;
     cancelAgenticAuthoring(): Promise<void>;
     persistAgenticAuthoring(): Promise<void>;
     ensureSharedRuleDefinition(): Promise<DomainRuleDefinition | null>;
@@ -1995,6 +1998,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private consumeAgenticTurn;
     private beginAgenticTurn;
     private cancelActiveAgenticTurn;
+    private invalidateAgenticTerminalAuthorization;
     private isCurrentAgenticTurn;
     private createAgenticTurnTimeoutState;
     private isAgenticTurnTimeoutState;
@@ -2003,7 +2007,12 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     agenticAuthoringLlmDiagnosticsText(): string;
     private resolveAgenticLlmDiagnostics;
     private resolveAgenticSemanticDecision;
+    private resolveAgenticSemanticResourcePresentationLabel;
     private resolveAgenticTurnResultRef;
+    private resolveAgenticApplyTarget;
+    private matchesCurrentAgenticApplyTarget;
+    private normalizeAgenticEtag;
+    private currentAgenticAuthoringEtag;
     private cloneAgenticContextHints;
     private resolveGovernedDomainContextSummary;
     private shouldShowGovernedDomainContext;