@praxisui/page-builder 8.0.0-beta.86 → 8.0.0-beta.88

package/fesm2022/praxisui-page-builder.mjs

@@ -25,7 +25,7 @@ import * as i6 from '@angular/material/divider';
 import { MatDividerModule } from '@angular/material/divider';
 import * as i6$1 from '@angular/material/select';
 import { MatSelectModule } from '@angular/material/select';
-import { BehaviorSubject, merge, timeout, map, switchMap, Observable, from, firstValueFrom, concatMap, catchError, of, filter, take } from 'rxjs';
+import { BehaviorSubject, merge, timeout, map, defer, switchMap, concat, of, Observable, from, firstValueFrom, share, concatMap, timer, takeUntil, catchError, filter, take } from 'rxjs';
 import { SETTINGS_PANEL_DATA } from '@praxisui/settings-panel';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import * as i7 from '@angular/material/tabs';
@@ -12056,6 +12056,7 @@ const DEFAULT_AGENTIC_AUTHORING_REQUEST_TIMEOUT_MS = 120000;
 const DEFAULT_TURN_STREAM_START_TIMEOUT_MS = 10000;
 const DEFAULT_TURN_STREAM_TIMEOUT_MS = 240000;
 const DEFAULT_TURN_STREAM_RESULT_FALLBACK_MS = 90000;
+const DEFAULT_TURN_STREAM_SILENCE_STATUS_MS = 20000;
 const PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS = new InjectionToken('PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS');
 class PageBuilderAgenticAuthoringService {
     http = inject(HttpClient);
@@ -12077,7 +12078,15 @@ class PageBuilderAgenticAuthoringService {
         return this.http.post(`${this.baseUrl}/resource-candidates`, request, { headers: this.buildHeaders() }).pipe(timeout({ first: this.requestTimeoutMs() }));
     }
     streamTurn(request) {
-        return this.http.post(`${this.baseUrl}/turn/stream/start`, request, { headers: this.buildHeaders(), withCredentials: true }).pipe(timeout({ first: this.streamStartTimeoutMs() }), switchMap((start) => this.connectTurnStream(start)));
+        return defer(() => {
+            const startRequestedAt = Date.now();
+            return this.http.post(`${this.baseUrl}/turn/stream/start`, request, { headers: this.buildHeaders(), withCredentials: true }).pipe(timeout({ first: this.streamStartTimeoutMs() }), map((start) => ({
+                start,
+                startRequestElapsedMs: Math.max(0, Date.now() - startRequestedAt),
+            })));
+        }).pipe(switchMap(({ start, startRequestElapsedMs }) => concat(of(this.streamLifecycleStatusEvent(start, 'stream.start.accepted', {
+            startRequestElapsedMs,
+        })), this.connectTurnStream(start, { startRequestElapsedMs }))));
     }
     applyPage(request) {
         const { ifMatch, ...body } = request;
@@ -12109,16 +12118,20 @@ class PageBuilderAgenticAuthoringService {
         }
         return new HttpHeaders(merged);
     }
-    connectTurnStream(start) {
+    connectTurnStream(start, telemetry) {
         return new Observable((observer) => {
+            const connectStartedAt = Date.now();
             const url = this.buildStreamUrl(start);
             const probeUrl = this.buildStreamProbeUrl(start);
             let source = null;
             let closed = false;
+            let firstEventReceived = false;
             let streamTimeout = null;
             let resultFallbackTimeout = null;
+            let silenceStatusTimeout = null;
             const streamTimeoutMs = this.streamTurnTimeoutMs();
             const resultFallbackMs = this.streamResultFallbackMs();
+            const silenceStatusMs = this.streamSilenceStatusMs();
             let probeAbort = typeof AbortController !== 'undefined'
                 ? new AbortController()
                 : null;
@@ -12135,6 +12148,12 @@ class PageBuilderAgenticAuthoringService {
                     resultFallbackTimeout = null;
                 }
             };
+            const clearSilenceStatusTimeout = () => {
+                if (silenceStatusTimeout) {
+                    clearTimeout(silenceStatusTimeout);
+                    silenceStatusTimeout = null;
+                }
+            };
             const closeSource = () => {
                 if (closed) {
                     return;
@@ -12142,10 +12161,21 @@ class PageBuilderAgenticAuthoringService {
                 closed = true;
                 clearStreamTimeout();
                 clearResultFallbackTimeout();
+                clearSilenceStatusTimeout();
                 streamAbort?.abort();
                 streamAbort = null;
                 source?.close();
             };
+            const startSilenceStatusTimer = () => {
+                clearSilenceStatusTimeout();
+                if (silenceStatusMs <= 0)
+                    return;
+                silenceStatusTimeout = setTimeout(() => {
+                    if (closed)
+                        return;
+                    observer.next(this.streamSilenceStatusEvent(start, silenceStatusMs, resultFallbackMs));
+                }, silenceStatusMs);
+            };
             const startResultFallbackTimer = () => {
                 clearResultFallbackTimeout();
                 if (resultFallbackMs <= 0)
@@ -12185,6 +12215,16 @@ class PageBuilderAgenticAuthoringService {
                     closeSource();
                     return;
                 }
+                if (!firstEventReceived) {
+                    firstEventReceived = true;
+                    observer.next(this.streamLifecycleStatusEvent(start, 'stream.first-event.received', {
+                        startRequestElapsedMs: telemetry.startRequestElapsedMs,
+                        connectElapsedMs: Math.max(0, Date.now() - connectStartedAt),
+                        firstEventSeq: parsed.seq ?? null,
+                        firstEventType: parsed.type ?? null,
+                    }));
+                }
+                clearSilenceStatusTimeout();
                 observer.next(parsed);
                 if (parsed.type === 'result' || parsed.type === 'error' || parsed.type === 'cancelled') {
                     clearResultFallbackTimeout();
@@ -12203,9 +12243,20 @@ class PageBuilderAgenticAuthoringService {
                     observer.error(this.streamConnectionError({ status }));
                     return;
                 }
+                observer.next(this.streamLifecycleStatusEvent(start, 'stream.probe.ready', {
+                    startRequestElapsedMs: telemetry.startRequestElapsedMs,
+                    connectElapsedMs: Math.max(0, Date.now() - connectStartedAt),
+                    probeStatus: status,
+                }));
                 if (!this.options?.eventSourceFactory && typeof fetch === 'function' && typeof TextDecoder !== 'undefined') {
                     streamAbort = typeof AbortController !== 'undefined' ? new AbortController() : null;
+                    observer.next(this.streamLifecycleStatusEvent(start, 'stream.transport.opening', {
+                        startRequestElapsedMs: telemetry.startRequestElapsedMs,
+                        connectElapsedMs: Math.max(0, Date.now() - connectStartedAt),
+                        transport: 'fetch',
+                    }));
                     startResultFallbackTimer();
+                    startSilenceStatusTimer();
                     void this.consumeFetchTurnStream(url, streamAbort, handleMessage, () => closed).catch((error) => {
                         if (closed) {
                             return;
@@ -12223,7 +12274,13 @@ class PageBuilderAgenticAuthoringService {
                     observer.error(this.streamConnectionError(error));
                     return;
                 }
+                observer.next(this.streamLifecycleStatusEvent(start, 'stream.transport.opening', {
+                    startRequestElapsedMs: telemetry.startRequestElapsedMs,
+                    connectElapsedMs: Math.max(0, Date.now() - connectStartedAt),
+                    transport: 'event-source',
+                }));
                 startResultFallbackTimer();
+                startSilenceStatusTimer();
                 source.onmessage = handleMessage;
                 if (source.addEventListener) {
                     for (const type of AI_STREAM_EVENT_TYPES) {
@@ -12259,6 +12316,7 @@ class PageBuilderAgenticAuthoringService {
                 streamAbort = null;
                 clearStreamTimeout();
                 clearResultFallbackTimeout();
+                clearSilenceStatusTimeout();
             };
         });
     }
@@ -12333,6 +12391,51 @@ class PageBuilderAgenticAuthoringService {
     streamResultFallbackMs() {
         return Math.max(0, this.options?.streamResultFallbackMs ?? DEFAULT_TURN_STREAM_RESULT_FALLBACK_MS);
     }
+    streamSilenceStatusMs() {
+        return Math.max(0, this.options?.streamSilenceStatusMs ?? DEFAULT_TURN_STREAM_SILENCE_STATUS_MS);
+    }
+    streamSilenceStatusEvent(start, elapsedMs, resultFallbackMs) {
+        return {
+            streamId: start.streamId,
+            threadId: start.threadId,
+            turnId: start.turnId,
+            seq: 0,
+            eventSchemaVersion: start.eventSchemaVersion,
+            timestamp: new Date().toISOString(),
+            type: 'status',
+            payload: {
+                phase: 'stream.waiting',
+                summary: 'Still waiting for the backend authoring result...',
+                diagnostics: {
+                    source: 'frontend-stream-silence-watchdog',
+                    elapsedMs,
+                    resultFallbackMs,
+                    fallbackAuthoringUrl: start.fallbackAuthoringUrl ?? null,
+                },
+            },
+        };
+    }
+    streamLifecycleStatusEvent(start, phase, diagnostics) {
+        return {
+            streamId: start.streamId,
+            threadId: start.threadId,
+            turnId: start.turnId,
+            seq: 0,
+            eventSchemaVersion: start.eventSchemaVersion,
+            timestamp: new Date().toISOString(),
+            type: 'status',
+            payload: {
+                phase,
+                summary: 'Frontend authoring stream lifecycle checkpoint.',
+                diagnostics: {
+                    schemaVersion: 'praxis-turn-stream-lifecycle-diagnostics.v1',
+                    source: 'frontend-turn-stream-lifecycle',
+                    fallbackAuthoringUrl: start.fallbackAuthoringUrl ?? null,
+                    ...diagnostics,
+                },
+            },
+        };
+    }
     requestTimeoutMs() {
         return Math.max(1, this.options?.requestTimeoutMs ?? DEFAULT_AGENTIC_AUTHORING_REQUEST_TIMEOUT_MS);
     }
@@ -14036,6 +14139,7 @@ class PageBuilderAiAdapter {
     }
 }
 
+const TURN_STREAM_PREPARATION_WAITING_MS = 20000;
 class PageBuilderAgenticAuthoringTurnFlow {
     service;
     context;
@@ -14185,7 +14289,7 @@ class PageBuilderAgenticAuthoringTurnFlow {
                     statusText: '',
                     errorText: message,
                     preview: null,
-                    diagnostics: { intentResolution, preview },
+                    diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
                 };
             }
             const applied = await this.context.applyLocalPreview(preview);
@@ -14199,20 +14303,20 @@ class PageBuilderAgenticAuthoringTurnFlow {
                     statusText: '',
                     errorText: message,
                     preview: null,
-                    diagnostics: { intentResolution, preview },
+                    diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
                 };
             }
-            const status = this.context.describePreviewStatus(preview);
+            const status = this.decorateDashboardReviewStatus(this.context.describePreviewStatus(preview), intentResolution, preview);
             return {
                 state: 'review',
                 phase: 'review',
                 assistantMessage: status,
-                quickReplies: [],
+                quickReplies: this.dashboardQualityQuickReplies(intentResolution, preview),
                 canApply: true,
                 statusText: this.reviewStatusText(status, true),
                 errorText: '',
                 preview,
-                diagnostics: { intentResolution },
+                diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
             };
         }
         catch (error) {
@@ -14229,7 +14333,9 @@ class PageBuilderAgenticAuthoringTurnFlow {
         }
     }
     submitWithTurnStream(request, prompt) {
-        return from(this.buildTurnStreamRequest(request, prompt)).pipe(concatMap((streamRequest) => this.service.streamTurn(streamRequest)), concatMap((event) => from(this.toTurnResultFromStreamEvent(event, request, prompt))), catchError((error) => {
+        const preparedRequest$ = from(this.buildTurnStreamRequest(request, prompt)).pipe(share());
+        const stream$ = preparedRequest$.pipe(concatMap(({ streamRequest }) => this.service.streamTurn(streamRequest)), concatMap((event) => from(this.toTurnResultFromStreamEvent(event, request, prompt))), share());
+        return merge(of(this.toTurnStreamPreparationStatusResult()), preparedRequest$.pipe(map(({ diagnostics }) => this.toTurnStreamPreparedStatusResult(diagnostics))), timer(TURN_STREAM_PREPARATION_WAITING_MS).pipe(map(() => this.toTurnStreamPreparationWaitingResult()), takeUntil(stream$)), stream$).pipe(catchError((error) => {
             if (this.shouldFailClosedFromTurnStreamError(request, prompt, error)) {
                 return of(this.toGovernedRouteFailClosedResult(request, prompt, error));
             }
@@ -14238,6 +14344,49 @@ class PageBuilderAgenticAuthoringTurnFlow {
                 : of(this.toTurnStreamTransportErrorResult(error));
         }));
     }
+    toTurnStreamPreparationStatusResult() {
+        return {
+            state: 'processing',
+            phase: 'contextualize',
+            assistantMessage: undefined,
+            canApply: false,
+            statusText: this.context.tx('agentic.status.preparingTurnStream', 'Preparing the AI authoring context...'),
+            errorText: '',
+            preview: null,
+        };
+    }
+    toTurnStreamPreparedStatusResult(diagnostics) {
+        return {
+            state: 'processing',
+            phase: 'contextualize',
+            assistantMessage: undefined,
+            canApply: false,
+            statusText: this.context.tx('agentic.status.turnStreamContextReady', 'AI authoring context is ready. Starting backend stream...'),
+            errorText: '',
+            preview: null,
+            diagnostics: {
+                streamPreparation: diagnostics,
+            },
+        };
+    }
+    toTurnStreamPreparationWaitingResult() {
+        return {
+            state: 'processing',
+            phase: 'contextualize',
+            assistantMessage: undefined,
+            canApply: false,
+            statusText: this.context.tx('agentic.status.preparingTurnStreamWaiting', 'Still preparing the AI authoring stream. Checking catalog, context, and backend availability...'),
+            errorText: '',
+            preview: null,
+            diagnostics: {
+                streamPreparationWatchdog: {
+                    schemaVersion: 'praxis-turn-stream-preparation-watchdog.v1',
+                    source: 'page-builder-agentic-authoring-turn-flow',
+                    elapsedMs: TURN_STREAM_PREPARATION_WAITING_MS,
+                },
+            },
+        };
+    }
     async cancel() {
         return {
             state: 'listening',
@@ -14257,12 +14406,13 @@ class PageBuilderAgenticAuthoringTurnFlow {
         const artifactKind = this.readString(contextHints, 'artifactKind')
             || (componentId === 'praxis-table' ? 'table' : componentId === 'praxis-dynamic-form' ? 'form' : 'chart');
         const changeKind = this.readString(contextHints, 'changeKind') || 'contextual_component_action';
+        const authoringProfile = this.readString(contextHints, 'source') || 'component-capability-catalog';
         const intentResolution = {
             valid: true,
             operationKind: 'modify',
             artifactKind,
             changeKind,
-            authoringProfile: 'component-capability-catalog',
+            authoringProfile,
             targetApp: this.context.targetApp,
             targetComponentId: this.context.targetComponentId,
             target: componentId
@@ -14281,7 +14431,7 @@ class PageBuilderAgenticAuthoringTurnFlow {
             selectedCandidate: this.contextualActionCandidate(contextHints),
             candidates: [],
             gate: {
-                gateId: 'component-capability-catalog',
+                gateId: authoringProfile,
                 status: 'eligible',
                 messages: [],
             },
@@ -14298,10 +14448,15 @@ class PageBuilderAgenticAuthoringTurnFlow {
         return this.completeExecutableStreamPreview(request, prompt, intentResolution, undefined);
     }
     async buildTurnStreamRequest(request, prompt) {
+        const startedAt = Date.now();
+        const capabilitiesStartedAt = Date.now();
         const componentCapabilities = await this.context.loadComponentCapabilities();
+        const capabilitiesElapsedMs = Math.max(0, Date.now() - capabilitiesStartedAt);
+        const authoringContextStartedAt = Date.now();
         const selectedWidgetKey = this.context.selectedWidgetKey();
         const authoringContext = this.buildAuthoringContext(request);
-        return {
+        const authoringContextElapsedMs = Math.max(0, Date.now() - authoringContextStartedAt);
+        const streamRequest = {
             userPrompt: prompt,
             targetApp: this.context.targetApp,
             targetComponentId: this.context.targetComponentId,
@@ -14314,6 +14469,22 @@ class PageBuilderAgenticAuthoringTurnFlow {
             componentCapabilities,
             ...authoringContext,
         };
+        return {
+            streamRequest,
+            diagnostics: {
+                schemaVersion: 'praxis-turn-stream-preparation-diagnostics.v1',
+                source: 'page-builder-agentic-authoring-turn-flow',
+                totalElapsedMs: Math.max(0, Date.now() - startedAt),
+                capabilitiesElapsedMs,
+                authoringContextElapsedMs,
+                catalogCount: componentCapabilities.catalogs?.length ?? 0,
+                capabilityCount: componentCapabilities.catalogs
+                    .reduce((count, catalog) => count + (catalog.capabilities?.length ?? 0), 0),
+                attachmentCount: authoringContext.attachmentSummaries?.length ?? 0,
+                hasPendingClarification: !!authoringContext.pendingClarification,
+                hasContextHints: !!authoringContext.contextHints,
+            },
+        };
     }
     async toTurnResultFromStreamEvent(event, request, prompt) {
         const payload = this.toJsonObject(event.payload) ?? {};
@@ -14406,25 +14577,24 @@ class PageBuilderAgenticAuthoringTurnFlow {
                         errorText: message,
                         preview: null,
                         diagnostics: {
-                            intentResolution,
-                            preview,
+                            ...this.buildTurnDiagnostics(intentResolution, preview),
                             decisionDiagnostics: this.toJsonObject(payload['decisionDiagnostics']),
                             toolLoopTrace: Array.isArray(payload['toolLoopTrace']) ? payload['toolLoopTrace'] : undefined,
                         },
                     };
                 }
+                const status = this.decorateDashboardReviewStatus(assistantMessage || this.context.describePreviewStatus(preview), intentResolution, preview);
                 return {
                     state: 'review',
                     phase: 'review',
-                    assistantMessage,
-                    quickReplies,
+                    assistantMessage: status,
+                    quickReplies: this.mergeDashboardQualityQuickReplies(quickReplies, intentResolution, preview),
                     canApply: false,
-                    statusText: this.reviewStatusText(assistantMessage, false),
+                    statusText: this.reviewStatusText(status, false),
                     errorText: '',
                     preview,
                     diagnostics: {
-                        intentResolution,
-                        preview,
+                        ...this.buildTurnDiagnostics(intentResolution, preview),
                         decisionDiagnostics: this.toJsonObject(payload['decisionDiagnostics']),
                         toolLoopTrace: Array.isArray(payload['toolLoopTrace']) ? payload['toolLoopTrace'] : undefined,
                     },
@@ -14451,7 +14621,7 @@ class PageBuilderAgenticAuthoringTurnFlow {
                 errorText: '',
                 preview: null,
                 pendingClarification,
-                diagnostics: { intentResolution, preview },
+                diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
             };
         }
         const applied = await this.context.applyLocalPreview(preview);
@@ -14465,20 +14635,20 @@ class PageBuilderAgenticAuthoringTurnFlow {
                 statusText: '',
                 errorText: message,
                 preview: null,
-                diagnostics: { intentResolution, preview },
+                diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
             };
         }
-        const status = assistantMessage || this.context.describePreviewStatus(preview);
+        const status = this.decorateDashboardReviewStatus(assistantMessage || this.context.describePreviewStatus(preview), intentResolution, preview);
         return {
             state: 'review',
             phase: 'review',
             assistantMessage: status,
-            quickReplies,
+            quickReplies: this.mergeDashboardQualityQuickReplies(quickReplies, intentResolution, preview),
             canApply: true,
             statusText: this.reviewStatusText(status, true),
             errorText: '',
             preview,
-            diagnostics: { intentResolution, preview },
+            diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
         };
     }
     hasBlockingResourceQuickReply(quickReplies) {
@@ -14525,7 +14695,7 @@ class PageBuilderAgenticAuthoringTurnFlow {
                     statusText: '',
                     errorText: message,
                     preview: null,
-                    diagnostics: { intentResolution, preview },
+                    diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
                 };
             }
             const applied = await this.context.applyLocalPreview(preview);
@@ -14539,20 +14709,20 @@ class PageBuilderAgenticAuthoringTurnFlow {
                     statusText: '',
                     errorText: message,
                     preview: null,
-                    diagnostics: { intentResolution, preview },
+                    diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
                 };
             }
-            const status = this.context.describePreviewStatus(preview);
+            const status = this.decorateDashboardReviewStatus(this.context.describePreviewStatus(preview), intentResolution, preview);
             return {
                 state: 'review',
                 phase: 'review',
                 assistantMessage: status,
-                quickReplies: [],
+                quickReplies: this.dashboardQualityQuickReplies(intentResolution, preview),
                 canApply: true,
                 statusText: this.reviewStatusText(status, true),
                 errorText: '',
                 preview,
-                diagnostics: { intentResolution, preview },
+                diagnostics: this.buildTurnDiagnostics(intentResolution, preview),
             };
         }
         catch (error) {
@@ -14618,6 +14788,675 @@ class PageBuilderAgenticAuthoringTurnFlow {
         const page = this.toJsonObject(patch)?.['page'];
         return !!this.toJsonObject(page);
     }
+    buildTurnDiagnostics(intentResolution, preview) {
+        const diagnostics = { intentResolution };
+        if (preview) {
+            diagnostics['preview'] = preview;
+        }
+        const dashboardDiagnostics = this.buildDashboardAuthoringDiagnostics(intentResolution, preview);
+        if (dashboardDiagnostics) {
+            diagnostics['dashboardAuthoringDiagnostics'] = dashboardDiagnostics;
+        }
+        return diagnostics;
+    }
+    buildDashboardAuthoringDiagnostics(intentResolution, preview) {
+        if (intentResolution.artifactKind !== 'dashboard' && !preview?.uiCompositionPlan) {
+            return null;
+        }
+        const plan = this.toJsonObject(preview?.uiCompositionPlan);
+        const patch = this.toJsonObject(preview?.compiledFormPatch)?.['patch'];
+        const page = this.toJsonObject(this.toJsonObject(patch)?.['page']);
+        const selectedCandidate = this.toJsonObject(intentResolution.selectedCandidate);
+        const widgets = this.extractDiagnosticWidgets(plan, page);
+        const connections = this.extractDiagnosticConnections(plan, page);
+        const surfaces = widgets.flatMap((widget) => widget.surfaces);
+        const blueprint = this.extractDashboardBlueprint(intentResolution, preview, plan, page);
+        const validation = this.buildDashboardValidationSummary(widgets, connections, surfaces);
+        const plannerDiagnostics = this.extractDashboardPlannerDiagnostics(plan);
+        return {
+            schemaVersion: 'praxis-dashboard-authoring-diagnostics.v1',
+            generatedAt: new Date().toISOString(),
+            source: 'page-builder-agentic-authoring-turn-flow',
+            intent: {
+                operationKind: intentResolution.operationKind,
+                artifactKind: intentResolution.artifactKind,
+                changeKind: intentResolution.changeKind,
+                authoringProfile: intentResolution.authoringProfile,
+            },
+            dto: {
+                resourcePath: this.readString(selectedCandidate ?? {}, 'resourcePath'),
+                schemaUrl: this.readString(selectedCandidate ?? {}, 'schemaUrl'),
+                operation: this.readString(selectedCandidate ?? {}, 'operation'),
+                submitMethod: this.readString(selectedCandidate ?? {}, 'submitMethod'),
+            },
+            blueprint,
+            preview: {
+                valid: preview?.valid === true,
+                failureCodes: Array.isArray(preview?.failureCodes) ? preview?.failureCodes : [],
+                warnings: Array.isArray(preview?.warnings) ? preview?.warnings : [],
+                hasUiCompositionPlan: !!plan,
+                hasCompiledPagePatch: !!page,
+            },
+            inventory: {
+                widgets: widgets.map(({ surfaces: _surfaces, ...widget }) => widget),
+                connections,
+                surfaces,
+            },
+            ...(plannerDiagnostics ? { plannerDiagnostics } : {}),
+            validation,
+        };
+    }
+    extractDashboardPlannerDiagnostics(plan) {
+        const diagnostics = this.toJsonObject(plan?.['diagnostics']);
+        if (!diagnostics) {
+            return null;
+        }
+        const summary = {};
+        const dashboardQualityRepair = this.toJsonObject(diagnostics['dashboardQualityRepair']);
+        if (dashboardQualityRepair) {
+            summary['dashboardQualityRepair'] = dashboardQualityRepair;
+        }
+        const dashboardBlueprint = this.toJsonObject(diagnostics['dashboardBlueprint']);
+        if (dashboardBlueprint) {
+            summary['dashboardBlueprint'] = dashboardBlueprint;
+        }
+        const semanticAxis = this.toJsonObject(diagnostics['semanticAxis']);
+        if (semanticAxis) {
+            summary['semanticAxis'] = semanticAxis;
+        }
+        return Object.keys(summary).length ? summary : diagnostics;
+    }
+    extractDashboardBlueprint(intentResolution, preview, plan, page) {
+        const diagnostics = this.toJsonObject(preview?.diagnostics);
+        const layoutPresetOptions = this.toJsonObject(plan?.['layoutPresetOptions'])
+            ?? this.toJsonObject(page?.['layoutPresetOptions']);
+        return {
+            name: this.readString(diagnostics ?? {}, 'blueprint')
+                ?? this.readString(layoutPresetOptions ?? {}, 'blueprint')
+                ?? this.readString(layoutPresetOptions ?? {}, 'presetFamily')
+                ?? null,
+            layoutPreset: this.readString(plan ?? {}, 'layoutPreset')
+                ?? this.readString(page ?? {}, 'layoutPreset'),
+            layoutPresetOptions,
+            themePreset: this.readString(plan ?? {}, 'themePreset')
+                ?? this.readString(page ?? {}, 'themePreset'),
+            selectedBy: intentResolution.authoringProfile ?? intentResolution.changeKind ?? null,
+        };
+    }
+    extractDiagnosticWidgets(plan, page) {
+        const sourceWidgets = [
+            ...(Array.isArray(plan?.['widgets']) ? plan?.['widgets'] : []),
+            ...(Array.isArray(page?.['widgets']) ? page?.['widgets'] : []),
+        ];
+        const seen = new Set();
+        return sourceWidgets
+            .filter((widget) => !!this.toJsonObject(widget))
+            .filter((widget) => {
+            const definition = this.toJsonObject(widget['definition']);
+            const key = this.readString(widget, 'key')
+                ?? this.readString(widget, 'id')
+                ?? this.readString(definition ?? {}, 'key')
+                ?? this.readString(definition ?? {}, 'id')
+                ?? '';
+            if (!key) {
+                return true;
+            }
+            if (seen.has(key)) {
+                return false;
+            }
+            seen.add(key);
+            return true;
+        })
+            .map((widget) => {
+            const definition = this.toJsonObject(widget['definition']);
+            const inputs = this.toJsonObject(widget['inputs'])
+                ?? this.toJsonObject(definition?.['inputs'])
+                ?? this.toJsonObject(widget['inputValues'])
+                ?? this.toJsonObject(widget['props'])
+                ?? this.toJsonObject(widget['config'])
+                ?? {};
+            const componentId = this.readString(widget, 'componentId')
+                ?? this.readString(definition ?? {}, 'id')
+                ?? this.readString(widget, 'type')
+                ?? 'unknown';
+            const key = this.readString(widget, 'key') ?? this.readString(widget, 'id') ?? 'unknown';
+            const shell = this.toJsonObject(widget['shell']);
+            const surfaces = this.extractSurfacesFromInputs(key, inputs);
+            return {
+                key,
+                componentId,
+                role: this.readString(widget, 'role'),
+                title: this.readString(inputs, 'title')
+                    ?? this.readString(inputs, 'label')
+                    ?? this.readString(shell ?? {}, 'title'),
+                subtitle: this.readString(inputs, 'subtitle')
+                    ?? this.readString(shell ?? {}, 'subtitle'),
+                resourcePath: this.readString(inputs, 'resourcePath')
+                    ?? this.readString(inputs, 'apiEndpoint')
+                    ?? this.readString(inputs, 'url'),
+                schemaUrl: this.readString(inputs, 'schemaUrl'),
+                kpiLike: this.isDashboardKpiWidget(componentId, widget, inputs, shell),
+                filterLike: this.isDashboardFilterWidget(componentId, widget, inputs, shell),
+                queryContextBound: inputs['queryContext'] !== undefined,
+                kpiPlaceholderValues: this.extractKpiPlaceholderValues(inputs),
+                surfaces,
+            };
+        });
+    }
+    extractDiagnosticConnections(plan, page) {
+        const planBindings = Array.isArray(plan?.['bindings']) ? plan?.['bindings'] : null;
+        const pageComposition = this.toJsonObject(page?.['composition']);
+        const pageLinks = Array.isArray(pageComposition?.['links']) ? pageComposition?.['links'] : null;
+        return (planBindings ?? pageLinks ?? [])
+            .filter((connection) => !!this.toJsonObject(connection))
+            .map((connection) => ({
+            id: this.readString(connection, 'id') ?? 'unknown',
+            intent: this.readString(connection, 'intent'),
+            from: this.summarizeEndpoint(connection['from']),
+            to: this.summarizeEndpoint(connection['to']),
+            transform: this.summarizeTransform(connection['transform']),
+        }));
+    }
+    extractSurfacesFromInputs(widgetKey, inputs) {
+        const surfaces = [];
+        const candidates = [
+            ...this.arrayFromUnknown(inputs['surfaces']),
+            ...this.arrayFromUnknown(this.toJsonObject(inputs['recordSurfaces'])?.['surfaces']),
+            ...this.arrayFromUnknown(inputs['actions']),
+            ...this.arrayFromUnknown(inputs['rowActions']),
+            ...this.arrayFromUnknown(inputs['toolbarActions']),
+        ];
+        for (const candidate of candidates) {
+            const surface = this.toJsonObject(candidate);
+            if (!surface) {
+                continue;
+            }
+            const action = this.readString(surface, 'action')
+                ?? this.readString(surface, 'actionId')
+                ?? this.readString(surface, 'operationId');
+            const resourceSurface = this.toJsonObject(surface['resourceSurface']);
+            const widget = this.toJsonObject(surface['widget']);
+            if (action !== 'surface.open' && action !== 'dynamicPage.surface.open' && !resourceSurface && !widget) {
+                continue;
+            }
+            surfaces.push({
+                widgetKey,
+                id: this.readString(surface, 'id') ?? this.readString(resourceSurface ?? {}, 'id'),
+                action,
+                title: this.readString(surface, 'title') ?? this.readString(resourceSurface ?? {}, 'title'),
+                mode: this.readString(resourceSurface ?? {}, 'mode'),
+                presentation: this.readString(surface, 'presentation')
+                    ?? this.readString(resourceSurface ?? {}, 'presentation'),
+                resourcePath: this.readString(resourceSurface ?? {}, 'resourcePath'),
+                componentId: this.readString(widget ?? {}, 'id')
+                    ?? this.readString(this.toJsonObject(widget?.['definition']) ?? {}, 'id'),
+            });
+        }
+        return surfaces;
+    }
+    isDashboardKpiWidget(componentId, widget, inputs, shell) {
+        const role = this.readString(widget, 'role')?.toLowerCase() ?? '';
+        if (['kpi', 'metric', 'metrics', 'indicator', 'indicators', 'summary'].includes(role)) {
+            return true;
+        }
+        const searchable = [
+            componentId,
+            this.readString(inputs, 'title'),
+            this.readString(inputs, 'subtitle'),
+            this.readString(inputs, 'label'),
+            this.readString(shell ?? {}, 'title'),
+            this.readString(shell ?? {}, 'subtitle'),
+        ]
+            .filter((value) => !!value)
+            .join(' ')
+            .toLowerCase();
+        if (/\b(kpi|metric|metrics|indicator|indicators|indicador|indicadores)\b/.test(searchable)) {
+            return true;
+        }
+        if (componentId === 'praxis-rich-content') {
+            return this.richContentDocumentHasMetrics(this.toJsonObject(inputs['document']));
+        }
+        return false;
+    }
+    richContentDocumentHasMetrics(document) {
+        const nodes = Array.isArray(document?.['nodes']) ? document?.['nodes'] : [];
+        return nodes.some((node) => this.richContentNodeHasMetrics(this.toJsonObject(node)));
+    }
+    richContentNodeHasMetrics(node) {
+        if (!node) {
+            return false;
+        }
+        const type = this.readString(node, 'type')?.toLowerCase();
+        if (type === 'metric' || type === 'statgroup' || type === 'stat-group') {
+            return true;
+        }
+        return ['nodes', 'items', 'children', 'content']
+            .some((key) => this.arrayFromUnknown(node[key])
+            .some((child) => this.richContentNodeHasMetrics(this.toJsonObject(child))));
+    }
+    extractKpiPlaceholderValues(inputs) {
+        const document = this.toJsonObject(inputs['document']);
+        if (!document) {
+            return [];
+        }
+        const placeholders = [];
+        for (const node of this.arrayFromUnknown(document['nodes'])) {
+            this.collectKpiPlaceholderValues(this.toJsonObject(node), placeholders);
+        }
+        return placeholders;
+    }
+    collectKpiPlaceholderValues(node, placeholders) {
+        if (!node) {
+            return;
+        }
+        const type = this.readString(node, 'type')?.toLowerCase();
+        if (type === 'metric' || type === 'stat' || type === 'statitem' || type === 'stat-item') {
+            this.addKpiPlaceholderValue(node, placeholders);
+        }
+        if (type === 'statgroup' || type === 'stat-group') {
+            for (const item of this.arrayFromUnknown(node['items'])) {
+                this.addKpiPlaceholderValue(this.toJsonObject(item), placeholders);
+            }
+        }
+        for (const key of ['nodes', 'items', 'children', 'content']) {
+            for (const child of this.arrayFromUnknown(node[key])) {
+                this.collectKpiPlaceholderValues(this.toJsonObject(child), placeholders);
+            }
+        }
+    }
+    addKpiPlaceholderValue(node, placeholders) {
+        if (!node) {
+            return;
+        }
+        const value = this.readString(node, 'value')?.trim() ?? '';
+        if (!value || value === '-' || value === '--' || value.toLowerCase() === 'n/a') {
+            const label = this.readString(node, 'label') ?? this.readString(node, 'id') ?? 'metric';
+            placeholders.push(label);
+        }
+    }
+    isDashboardFilterWidget(componentId, widget, inputs, shell) {
+        const normalizedComponentId = componentId.toLowerCase();
+        if (normalizedComponentId === 'praxis-filter'
+            || normalizedComponentId === 'praxis-filter-form'
+            || normalizedComponentId.includes('filter')) {
+            return true;
+        }
+        const role = this.readString(widget, 'role')?.toLowerCase() ?? '';
+        if (['filter', 'filters', 'search', 'advanced-filter'].includes(role)) {
+            return true;
+        }
+        const searchable = [
+            this.readString(inputs, 'title'),
+            this.readString(inputs, 'subtitle'),
+            this.readString(inputs, 'label'),
+            this.readString(shell ?? {}, 'title'),
+            this.readString(shell ?? {}, 'subtitle'),
+        ]
+            .filter((value) => !!value)
+            .join(' ')
+            .toLowerCase();
+        if (/\b(filter|filters|filtro|filtros|search|busca|buscar)\b/.test(searchable)) {
+            return true;
+        }
+        return inputs['alwaysVisibleFields'] !== undefined
+            || inputs['selectedFieldIds'] !== undefined
+            || inputs['filterConfig'] !== undefined
+            || inputs['advancedOpenMode'] !== undefined;
+    }
+    buildDashboardValidationSummary(widgets, connections, surfaces) {
+        const componentIds = widgets.map((widget) => `${widget['componentId']}`);
+        const filterWidgets = widgets.filter((widget) => widget['filterLike'] === true);
+        const chartWidgets = widgets.filter((widget) => `${widget['componentId']}`.includes('chart'));
+        const warnings = [];
+        if (!componentIds.some((id) => id.includes('chart'))) {
+            warnings.push('dashboard-without-chart-widget');
+        }
+        if (!widgets.some((widget) => widget['kpiLike'] === true)) {
+            warnings.push('dashboard-without-kpi-widget');
+        }
+        if (widgets.some((widget) => widget['kpiLike'] === true
+            && Array.isArray(widget['kpiPlaceholderValues'])
+            && widget['kpiPlaceholderValues'].length > 0)) {
+            warnings.push('dashboard-kpi-placeholder-values');
+        }
+        if (!widgets.some((widget) => widget['filterLike'] === true)) {
+            warnings.push('dashboard-without-filter-widget');
+        }
+        if (!componentIds.some((id) => id.includes('table') || id.includes('list'))) {
+            warnings.push('dashboard-without-record-detail-widget');
+        }
+        if (!connections.length) {
+            warnings.push('dashboard-without-composition-links');
+        }
+        if (filterWidgets.length
+            && !filterWidgets.some((widget) => this.hasQueryContextConnectionFrom(`${widget['key']}`, connections))) {
+            warnings.push('dashboard-filter-not-connected');
+        }
+        if (chartWidgets.length
+            && !chartWidgets.some((widget) => this.hasQueryContextConnectionFrom(`${widget['key']}`, connections)
+                || surfaces.some((surface) => surface['widgetKey'] === widget['key']))) {
+            warnings.push('dashboard-chart-not-interactive');
+        }
+        if (!surfaces.length) {
+            warnings.push('dashboard-without-surface-actions');
+        }
+        return {
+            status: warnings.length ? 'degraded' : 'ready',
+            warnings,
+            counts: {
+                widgets: widgets.length,
+                kpis: widgets.filter((widget) => widget['kpiLike'] === true).length,
+                kpiPlaceholders: widgets
+                    .filter((widget) => Array.isArray(widget['kpiPlaceholderValues']))
+                    .reduce((count, widget) => count + widget['kpiPlaceholderValues'].length, 0),
+                filters: widgets.filter((widget) => widget['filterLike'] === true).length,
+                connections: connections.length,
+                connectedFilters: filterWidgets
+                    .filter((widget) => this.hasQueryContextConnectionFrom(`${widget['key']}`, connections)).length,
+                interactiveCharts: chartWidgets
+                    .filter((widget) => this.hasQueryContextConnectionFrom(`${widget['key']}`, connections)
+                    || surfaces.some((surface) => surface['widgetKey'] === widget['key'])).length,
+                surfaces: surfaces.length,
+            },
+        };
+    }
+    hasQueryContextConnectionFrom(widgetKey, connections) {
+        return connections.some((connection) => {
+            const from = this.toJsonObject(connection['from']);
+            const to = this.toJsonObject(connection['to']);
+            return this.readString(from ?? {}, 'widget') === widgetKey
+                && this.readString(to ?? {}, 'port') === 'queryContext';
+        });
+    }
+    summarizeEndpoint(value) {
+        const endpoint = this.toJsonObject(value);
+        if (!endpoint) {
+            return null;
+        }
+        const ref = this.toJsonObject(endpoint['ref']);
+        return {
+            kind: this.readString(endpoint, 'kind'),
+            widget: this.readString(endpoint, 'widget') ?? this.readString(ref ?? {}, 'widget'),
+            port: this.readString(endpoint, 'port') ?? this.readString(ref ?? {}, 'port'),
+            direction: this.readString(endpoint, 'direction') ?? this.readString(ref ?? {}, 'direction'),
+            path: this.readString(endpoint, 'path') ?? this.readString(ref ?? {}, 'path'),
+            actionId: this.readString(endpoint, 'actionId') ?? this.readString(ref ?? {}, 'actionId'),
+        };
+    }
+    summarizeTransform(value) {
+        const transform = this.toJsonObject(value);
+        if (!transform) {
+            return null;
+        }
+        const steps = Array.isArray(transform['steps']) ? transform['steps'] : [];
+        return {
+            kind: this.readString(transform, 'kind'),
+            mode: this.readString(transform, 'mode'),
+            stepCount: steps.length,
+            steps: steps
+                .filter((step) => !!this.toJsonObject(step))
+                .map((step) => ({
+                id: this.readString(step, 'id'),
+                kind: this.readString(step, 'kind'),
+            })),
+        };
+    }
+    arrayFromUnknown(value) {
+        return Array.isArray(value) ? value : [];
+    }
+    decorateDashboardReviewStatus(status, intentResolution, preview) {
+        if (!preview.uiCompositionPlan) {
+            return status;
+        }
+        const diagnostics = this.buildDashboardAuthoringDiagnostics(intentResolution, preview);
+        const validation = this.toJsonObject(diagnostics?.['validation']);
+        const warnings = Array.isArray(validation?.['warnings'])
+            ? validation?.['warnings'].map((warning) => `${warning}`)
+            : [];
+        if (!warnings.length) {
+            return status;
+        }
+        const labels = warnings
+            .map((warning) => this.describeDashboardQualityWarning(warning))
+            .filter((label) => !!label);
+        if (!labels.length) {
+            return status;
+        }
+        const suffix = this.context
+            .tx('agentic.dashboardQuality.degraded', 'Dashboard created with quality warnings: {warnings}. Review diagnostics before saving.')
+            .replace('{warnings}', labels.join(', '));
+        const normalized = status.trim();
+        return normalized ? `${normalized} ${suffix}` : suffix;
+    }
+    describeDashboardQualityWarning(code) {
+        switch (code) {
+            case 'dashboard-without-chart-widget':
+                return this.context.tx('agentic.dashboardQuality.warning.chart', 'chart widget missing');
+            case 'dashboard-without-kpi-widget':
+                return this.context.tx('agentic.dashboardQuality.warning.kpi', 'KPI block missing');
+            case 'dashboard-kpi-placeholder-values':
+                return this.context.tx('agentic.dashboardQuality.warning.kpiValues', 'KPI values are placeholders');
+            case 'dashboard-without-filter-widget':
+                return this.context.tx('agentic.dashboardQuality.warning.filter', 'filter widget missing');
+            case 'dashboard-without-record-detail-widget':
+                return this.context.tx('agentic.dashboardQuality.warning.details', 'record detail widget missing');
+            case 'dashboard-without-composition-links':
+                return this.context.tx('agentic.dashboardQuality.warning.links', 'widget interactions missing');
+            case 'dashboard-filter-not-connected':
+                return this.context.tx('agentic.dashboardQuality.warning.filterConnection', 'filter is not connected');
+            case 'dashboard-chart-not-interactive':
+                return this.context.tx('agentic.dashboardQuality.warning.chartInteraction', 'chart interaction missing');
+            case 'dashboard-without-surface-actions':
+                return this.context.tx('agentic.dashboardQuality.warning.surfaces', 'surface actions missing');
+            default:
+                return code;
+        }
+    }
+    mergeDashboardQualityQuickReplies(quickReplies, intentResolution, preview) {
+        const repairReplies = this.dashboardQualityQuickReplies(intentResolution, preview);
+        if (!repairReplies.length) {
+            return [...quickReplies];
+        }
+        const seen = new Set(quickReplies.map((reply) => reply.id));
+        return [
+            ...quickReplies,
+            ...repairReplies.filter((reply) => !seen.has(reply.id)),
+        ];
+    }
+    dashboardQualityQuickReplies(intentResolution, preview) {
+        if (!preview.uiCompositionPlan) {
+            return [];
+        }
+        const diagnostics = this.buildDashboardAuthoringDiagnostics(intentResolution, preview);
+        const validation = this.toJsonObject(diagnostics?.['validation']);
+        const warnings = Array.isArray(validation?.['warnings'])
+            ? validation?.['warnings'].map((warning) => `${warning}`)
+            : [];
+        if (!warnings.length) {
+            return [];
+        }
+        const resourcePath = this.readString(this.toJsonObject(diagnostics?.['dto']) ?? {}, 'resourcePath');
+        const dashboardQuality = this.toDashboardQualityRepairContext(diagnostics);
+        const dashboardSnapshot = this.dashboardRepairSnapshot(preview);
+        const contextHints = {
+            source: 'dashboard-quality-gate',
+            kind: 'dashboard-repair-action',
+            artifactKind: 'dashboard',
+            resourcePath,
+            warnings,
+            ...(dashboardQuality ? { dashboardQuality } : {}),
+            ...dashboardSnapshot,
+        };
+        const replies = [];
+        if (warnings.includes('dashboard-without-kpi-widget')) {
+            replies.push(this.dashboardQualityQuickReply({
+                id: 'dashboard-quality-add-kpis',
+                label: this.context.tx('agentic.dashboardQuality.quickReply.addKpis', 'Add KPIs'),
+                prompt: this.context.tx('agentic.dashboardQuality.prompt.addKpis', 'Add a compact KPI block with the most useful metrics for this dashboard, preferably using praxis-rich-content statGroup or metric nodes.'),
+                icon: 'monitoring',
+                changeKind: 'add_dashboard_kpis',
+                contextHints,
+            }));
+        }
+        if (warnings.includes('dashboard-kpi-placeholder-values')) {
+            replies.push(this.dashboardQualityQuickReply({
+                id: 'dashboard-quality-bind-kpis',
+                label: this.context.tx('agentic.dashboardQuality.quickReply.bindKpis', 'Bind KPI values'),
+                prompt: this.context.tx('agentic.dashboardQuality.prompt.bindKpis', 'Replace placeholder KPI values with real metric bindings from the dashboard DTO/source, keeping labels and formatting human-readable.'),
+                icon: 'data_object',
+                changeKind: 'bind_dashboard_kpis',
+                contextHints,
+            }));
+        }
+        if (warnings.includes('dashboard-without-filter-widget')) {
+            replies.push(this.dashboardQualityQuickReply({
+                id: 'dashboard-quality-add-filters',
+                label: this.context.tx('agentic.dashboardQuality.quickReply.addFilters', 'Add filters'),
+                prompt: this.context.tx('agentic.dashboardQuality.prompt.addFilters', 'Add canonical dashboard filters from the DTO fields and connect their requestSearch output to charts and detail widgets through queryContext.'),
+                icon: 'filter_alt',
+                changeKind: 'add_dashboard_filters',
+                contextHints,
+            }));
+        }
+        if (warnings.includes('dashboard-without-chart-widget')) {
+            replies.push(this.dashboardQualityQuickReply({
+                id: 'dashboard-quality-add-chart',
+                label: this.context.tx('agentic.dashboardQuality.quickReply.addChart', 'Add chart'),
+                prompt: this.context.tx('agentic.dashboardQuality.prompt.addChart', 'Add the most relevant analytical chart to this dashboard, using the same data source and connecting it to the detail widgets.'),
+                icon: 'insert_chart',
+                changeKind: 'add_dashboard_chart',
+                contextHints,
+            }));
+        }
+        if (warnings.includes('dashboard-without-record-detail-widget')) {
+            replies.push(this.dashboardQualityQuickReply({
+                id: 'dashboard-quality-add-details',
+                label: this.context.tx('agentic.dashboardQuality.quickReply.addDetails', 'Add details'),
+                prompt: this.context.tx('agentic.dashboardQuality.prompt.addDetails', 'Add a rich record detail widget, preferably a Praxis list or table, using the same dashboard data source.'),
+                icon: 'view_list',
+                changeKind: 'add_dashboard_detail_widget',
+                contextHints,
+            }));
+        }
+        if (warnings.includes('dashboard-without-composition-links')
+            || warnings.includes('dashboard-filter-not-connected')
+            || warnings.includes('dashboard-chart-not-interactive')) {
+            replies.push(this.dashboardQualityQuickReply({
+                id: 'dashboard-quality-connect-widgets',
+                label: this.context.tx('agentic.dashboardQuality.quickReply.connectWidgets', 'Connect widgets'),
+                prompt: this.context.tx('agentic.dashboardQuality.prompt.connectWidgets', 'Connect the dashboard widgets so filter and chart selections update the detail widgets through queryContext.'),
+                icon: 'hub',
+                changeKind: 'connect_dashboard_widgets',
+                contextHints,
+            }));
+        }
+        if (warnings.includes('dashboard-without-surface-actions')) {
+            replies.push(this.dashboardQualityQuickReply({
+                id: 'dashboard-quality-add-surfaces',
+                label: this.context.tx('agentic.dashboardQuality.quickReply.addSurfaces', 'Add surfaces'),
+                prompt: this.context.tx('agentic.dashboardQuality.prompt.addSurfaces', 'Add surface.open actions so dashboard selections can open richer drill-down details in a modal or drawer.'),
+                icon: 'open_in_new',
+                changeKind: 'add_dashboard_surfaces',
+                contextHints,
+            }));
+        }
+        return replies.slice(0, 4);
+    }
+    dashboardRepairSnapshot(preview) {
+        const patch = this.toJsonObject(preview.compiledFormPatch)?.['patch'];
+        const materializedPage = this.toJsonObject(this.toJsonObject(patch)?.['page']);
+        if (this.hasDashboardSnapshotWidgets(materializedPage)) {
+            return { materializedPage };
+        }
+        const uiCompositionPlan = this.toJsonObject(preview.uiCompositionPlan);
+        return uiCompositionPlan ? { uiCompositionPlan } : {};
+    }
+    hasDashboardSnapshotWidgets(page) {
+        return Array.isArray(page?.['widgets']) && page?.['widgets'].length > 0;
+    }
+    toDashboardQualityRepairContext(diagnostics) {
+        if (!diagnostics) {
+            return null;
+        }
+        const inventory = this.toJsonObject(diagnostics['inventory']);
+        const validation = this.toJsonObject(diagnostics['validation']);
+        const dto = this.toJsonObject(diagnostics['dto']);
+        const widgets = this.arrayFromUnknown(inventory?.['widgets'])
+            .map((widget) => this.toJsonObject(widget))
+            .filter((widget) => !!widget);
+        const connections = this.arrayFromUnknown(inventory?.['connections'])
+            .map((connection) => this.toJsonObject(connection))
+            .filter((connection) => !!connection);
+        const surfaces = this.arrayFromUnknown(inventory?.['surfaces'])
+            .map((surface) => this.toJsonObject(surface))
+            .filter((surface) => !!surface);
+        const warnings = this.arrayFromUnknown(validation?.['warnings']).map((warning) => `${warning}`);
+        return {
+            schemaVersion: 'praxis-dashboard-quality-repair-context.v1',
+            dto: {
+                resourcePath: this.readString(dto ?? {}, 'resourcePath'),
+                schemaUrl: this.readString(dto ?? {}, 'schemaUrl'),
+                operation: this.readString(dto ?? {}, 'operation'),
+            },
+            blueprint: this.toJsonObject(diagnostics['blueprint']) ?? {},
+            validation: {
+                status: this.readString(validation ?? {}, 'status'),
+                warnings,
+                counts: this.toJsonObject(validation?.['counts']) ?? {},
+            },
+            widgets: widgets.slice(0, 12).map((widget) => {
+                const key = this.readString(widget, 'key') ?? 'unknown';
+                return {
+                    key,
+                    componentId: this.readString(widget, 'componentId') ?? 'unknown',
+                    role: this.readString(widget, 'role'),
+                    title: this.readString(widget, 'title'),
+                    kpiLike: widget['kpiLike'] === true,
+                    filterLike: widget['filterLike'] === true,
+                    queryContextBound: widget['queryContextBound'] === true,
+                    outgoingQueryContext: this.hasQueryContextConnectionFrom(key, connections),
+                    surfaceCount: surfaces.filter((surface) => this.readString(surface, 'widgetKey') === key).length,
+                };
+            }),
+            connections: connections.slice(0, 16).map((connection) => ({
+                id: this.readString(connection, 'id') ?? 'unknown',
+                intent: this.readString(connection, 'intent'),
+                from: this.toJsonObject(connection['from']),
+                to: this.toJsonObject(connection['to']),
+            })),
+            surfaces: surfaces.slice(0, 16).map((surface) => ({
+                widgetKey: this.readString(surface, 'widgetKey'),
+                id: this.readString(surface, 'id'),
+                action: this.readString(surface, 'action'),
+                title: this.readString(surface, 'title'),
+                mode: this.readString(surface, 'mode'),
+                presentation: this.readString(surface, 'presentation'),
+                resourcePath: this.readString(surface, 'resourcePath'),
+                componentId: this.readString(surface, 'componentId'),
+            })),
+        };
+    }
+    dashboardQualityQuickReply(params) {
+        return {
+            id: params.id,
+            kind: 'suggestion',
+            label: params.label,
+            prompt: params.prompt,
+            icon: params.icon,
+            contextHints: {
+                ...params.contextHints,
+                changeKind: params.changeKind,
+                presentation: {
+                    kind: 'guided-option',
+                    categoryLabel: this.context.tx('agentic.dashboardQuality.quickReply.category', 'Dashboard quality'),
+                    description: params.prompt,
+                    ctaLabel: params.label,
+                    icon: params.icon,
+                    tone: 'warning',
+                },
+            },
+        };
+    }
     phaseForStreamPayload(payload) {
         const phase = this.readString(payload, 'phase');
         if (phase === 'intent.resolve')
@@ -14634,28 +15473,67 @@ class PageBuilderAgenticAuthoringTurnFlow {
     }
     statusForStreamPayload(payload) {
         const phase = this.readString(payload, 'phase');
+        let status = null;
         switch (phase) {
             case 'context.bundle':
-                return this.context.tx('agentic.status.contextBundle', 'Preparing context...');
+                status = this.context.tx('agentic.status.contextBundle', 'Preparing context...');
+                break;
             case 'intent.resolve':
                 if (this.isSecondPassStreamPayload(payload)) {
-                    return this.context.tx('agentic.status.refinedCandidates', 'Reviewing the retrieved resources with the AI...');
+                    status = this.context.tx('agentic.status.refinedCandidates', 'Reviewing the retrieved resources with the AI...');
+                    break;
                 }
-                return this.context.tx('agentic.status.resolvingIntent', 'Resolving intent...');
+                status = this.context.tx('agentic.status.resolvingIntent', 'Resolving intent...');
+                break;
             case 'resource.discovery':
                 if (this.isBackendResourceDiscoveryPayload(payload)) {
-                    return this.context.tx('agentic.status.resourceDiscoveryBackend', 'Found API resources in the backend catalog.');
+                    status = this.context.tx('agentic.status.resourceDiscoveryBackend', 'Found API resources in the backend catalog.');
+                    break;
                 }
-                return this.context.tx('agentic.status.resourceDiscovery', 'Finding API resources...');
+                status = this.context.tx('agentic.status.resourceDiscovery', 'Finding API resources...');
+                break;
             case 'projectKnowledge.retrieve':
-                return this.projectKnowledgeStatusForStreamPayload(payload);
+                status = this.projectKnowledgeStatusForStreamPayload(payload);
+                break;
             case 'preview.plan':
-                return this.context.tx('agentic.status.previewing', 'Generating preview...');
+                status = this.context.tx('agentic.status.previewing', 'Generating preview...');
+                break;
             case 'preview.compile':
-                return this.context.tx('agentic.status.previewCompile', 'Compiling preview...');
+                status = this.context.tx('agentic.status.previewCompile', 'Compiling preview...');
+                break;
+            case 'stream.waiting':
+                status = this.context.tx('agentic.status.streamWaiting', 'The backend is still working on this dashboard. Keeping the request alive...');
+                break;
+            case 'stream.start.accepted':
+                status = this.context.tx('agentic.status.streamStartAccepted', 'Backend accepted the authoring stream. Opening live progress...');
+                break;
+            case 'stream.probe.ready':
+                status = this.context.tx('agentic.status.streamProbeReady', 'Authoring stream endpoint is reachable.');
+                break;
+            case 'stream.transport.opening':
+                status = this.context.tx('agentic.status.streamTransportOpening', 'Opening the live authoring stream...');
+                break;
+            case 'stream.first-event.received':
+                status = this.context.tx('agentic.status.streamFirstEventReceived', 'Live authoring progress started.');
+                break;
             default:
-                return this.readString(payload, 'summary') || this.readString(payload, 'message');
+                status = this.readString(payload, 'summary') || this.readString(payload, 'message');
+        }
+        return this.decorateBackendProcessingProgressStatus(payload, status ?? '');
+    }
+    decorateBackendProcessingProgressStatus(payload, status) {
+        const diagnostics = this.toJsonObject(payload['diagnostics']);
+        if (diagnostics?.['source'] !== 'backend-processing-progress-watchdog') {
+            return status;
+        }
+        const elapsedSeconds = this.readNumber(diagnostics, 'elapsedSeconds');
+        if (!elapsedSeconds || elapsedSeconds <= 0) {
+            return status;
         }
+        return this.context
+            .tx('agentic.status.backendProgressElapsed', '{status} Backend still working for {seconds}s.')
+            .replace('{status}', status)
+            .replace('{seconds}', `${Math.round(elapsedSeconds)}`);
     }
     projectKnowledgeStatusForStreamPayload(payload) {
         const diagnostics = this.toJsonObject(payload['diagnostics']);
@@ -15180,6 +16058,8 @@ class PageBuilderAgenticAuthoringTurnFlow {
         const hintSource = this.readString(hints, 'source');
         const hintKind = this.readString(hints, 'kind');
         return hintSource === 'component-capability-catalog'
+            || hintSource === 'dashboard-quality-gate'
+            || hintKind === 'dashboard-repair-action'
             || hintKind === 'contextual-preview-action';
     }
     contextualPreviewActionContextFromRequest(request) {
@@ -15714,6 +16594,8 @@ class PageBuilderAgenticAuthoringTurnFlow {
             ? contextHints['kind'].trim()
             : '';
         return hintSource === 'component-capability-catalog'
+            || hintSource === 'dashboard-quality-gate'
+            || hintKind === 'dashboard-repair-action'
             || hintKind === 'contextual-preview-action'
             || (reply.id ?? '').startsWith('chart-')
             || (reply.id ?? '').startsWith('table-export-');
@@ -18178,6 +19060,7 @@ class DynamicPageBuilderComponent {
                 contextHints: this.cloneAgenticContextHints(this.agenticAuthoringContextHints),
             });
         }
+        this.agenticTurnController.setContextHints(this.cloneAgenticContextHints(this.agenticAuthoringContextHints));
         this.agenticTurnController.setContextItems(this.agenticAuthoringContextItems());
         this.agenticTurnController.setMessages(this.agenticAuthoringConversation());
         this.agenticTurnController.setAttachments(this.agenticAuthoringAttachments());
@@ -18430,7 +19313,15 @@ class DynamicPageBuilderComponent {
             return null;
         }
         const intentResolution = this.toRecord(diagnostics?.['intentResolution']);
-        return this.toRecord(intentResolution?.['llmDiagnostics']);
+        const llmDiagnostics = this.toRecord(intentResolution?.['llmDiagnostics']);
+        const dashboardAuthoringDiagnostics = this.toRecord(diagnostics?.['dashboardAuthoringDiagnostics']);
+        if (llmDiagnostics && dashboardAuthoringDiagnostics) {
+            return {
+                llmDiagnostics,
+                dashboardAuthoringDiagnostics,
+            };
+        }
+        return llmDiagnostics ?? dashboardAuthoringDiagnostics;
     }
     resolveAgenticSemanticDecision(diagnostics) {
         const intentResolution = this.toRecord(diagnostics?.['intentResolution']);

package/package.json

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

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

@@ -1165,6 +1165,7 @@ interface PageBuilderAgenticAuthoringOptions {
     streamStartTimeoutMs?: number;
     streamTurnTimeoutMs?: number;
     streamResultFallbackMs?: number;
+    streamSilenceStatusMs?: number;
     streamConnectionErrorGraceMs?: number;
 }
 interface PageBuilderAgenticAuthoringEventSource {
@@ -1397,6 +1398,9 @@ declare class PageBuilderAgenticAuthoringService {
     private streamStartTimeoutMs;
     private streamTurnTimeoutMs;
     private streamResultFallbackMs;
+    private streamSilenceStatusMs;
+    private streamSilenceStatusEvent;
+    private streamLifecycleStatusEvent;
     private requestTimeoutMs;
     private streamConnectionError;
     private buildStreamUrl;