@praxisui/page-builder 9.0.0-beta.9 → 9.0.0-rc.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "9.0.0-beta.9",
+  "version": "9.0.0-rc.1",
   "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.9",
-    "@praxisui/core": "^9.0.0-beta.9",
-    "@praxisui/settings-panel": "^9.0.0-beta.9",
+    "@praxisui/ai": "^9.0.0-rc.1",
+    "@praxisui/core": "^9.0.0-rc.1",
+    "@praxisui/settings-panel": "^9.0.0-rc.1",
     "rxjs": "~7.8.0"
   },
   "dependencies": {
@@ -24,6 +24,7 @@
   "keywords": [
     "angular",
     "praxisui",
+    "praxis",
     "page-builder",
     "widgets",
     "dashboard",
@@ -39,7 +40,10 @@
     ".": {
       "types": "./types/praxisui-page-builder.d.ts",
       "default": "./fesm2022/praxisui-page-builder.mjs"
+    },
+    "./ai/component-registry.json": {
+      "default": "./ai/component-registry.json"
     }
   },
   "type": "module"
-}
+}

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

@@ -1,13 +1,12 @@
 import { MatDialogRef, MatDialog } from '@angular/material/dialog';
 import * as _angular_core from '@angular/core';
 import { EventEmitter, OnInit, WritableSignal, InjectionToken, Provider, OnChanges, OnDestroy, Type, SimpleChanges } from '@angular/core';
-import { ComponentDocMeta, ComponentMetadataRegistry, WidgetShellConfig, WidgetShellAction, EndpointRef, ComponentPortPathSegment, LinkIntent, CompositionLink, WidgetPageDefinition, TransformKind, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, WidgetPageGroupingDefinition, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapability, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, DomainKnowledgeChangeSetRequest, DomainKnowledgeChangeSet, DomainKnowledgeChangeSetTimelineResponse, DomainKnowledgeChangeSetFilters, DomainKnowledgeValidationResponse, DomainKnowledgeStatusTransitionRequest, DomainRuleIntakeRequest, DomainRuleIntakeResponse, DomainRuleDefinitionRequest, DomainRuleDefinition, DomainRuleSimulationRequest, DomainRuleSimulationResponse, DomainRuleStatusTransitionRequest, DomainRulePublicationRequest, DomainRulePublicationResponse, DomainRuleMaterializationFilters, DomainRuleMaterialization, DomainRuleTimelineResponse, PraxisRuntimeComponentObservationEnvelope, WidgetPageCanvasLayout, WidgetPageDeviceLayouts, WidgetPageSlotAssignments, WidgetPageStateInput, WidgetInstance, ComponentContextPack, ComponentAuthoringManifest, DynamicWidgetPageComponent, WidgetEventEnvelope, SettingsPanelBridge, RichTimelineItem } from '@praxisui/core';
-export { WidgetShellComponent } from '@praxisui/core';
+import { ComponentDocMeta, ComponentMetadataRegistry, WidgetShellConfig, WidgetShellAction, EndpointRef, ComponentPortPathSegment, LinkIntent, CompositionLink, WidgetPageDefinition, TransformKind, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, WidgetPageGroupingDefinition, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapability, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, DomainKnowledgeChangeSetRequest, DomainKnowledgeChangeSet, DomainKnowledgeChangeSetTimelineResponse, DomainKnowledgeChangeSetFilters, DomainKnowledgeValidationResponse, DomainKnowledgeStatusTransitionRequest, DomainRuleIntakeRequest, DomainRuleIntakeResponse, DomainRuleDefinitionRequest, DomainRuleDefinition, DomainRuleSimulationRequest, DomainRuleSimulationResponse, DomainRuleStatusTransitionRequest, DomainRulePublicationRequest, DomainRulePublicationResponse, DomainRuleMaterializationFilters, DomainRuleMaterialization, DomainRuleTimelineResponse, PraxisRuntimeComponentObservationEnvelope, WidgetPageCanvasLayout, WidgetPageDeviceLayouts, WidgetPageSlotAssignments, WidgetPageStateInput, WidgetInstance, ComponentContextPack, ComponentAuthoringManifest, DynamicWidgetPageComponent, WidgetEventEnvelope, ObservabilityAgenticTurnMetrics, SettingsPanelBridge, ObservabilityAgenticTurnMetricBucket, RichTimelineItem } from '@praxisui/core';
 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, 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, PraxisAssistantVoiceInputMode, PraxisAssistantShellMessage, PraxisAssistantShellQuickReply, PraxisAssistantShellAttachment, PraxisAssistantShellLayout, PraxisAssistantSessionSnapshot, PraxisAssistantShellLabels, PraxisAssistantRecommendedIntent, PraxisAssistantShellAction, PraxisAssistantShellState, PraxisAssistantShellContextItem } from '@praxisui/ai';
 
 declare const PLACEHOLDER = 1;
 
@@ -265,11 +264,12 @@ interface ConnectionEditorNode {
     states: ConnectionEditorPort[];
 }
 type ConnectionEditorDiagnosticSeverity = 'error' | 'warning';
-type ConnectionEditorDiagnosticCode = 'endpoint-widget-missing' | 'endpoint-unresolved' | 'endpoint-not-declared' | 'nested-path-terminal-missing' | 'nested-path-not-declared' | 'state-path-not-declared';
+type ConnectionEditorDiagnosticCode = 'endpoint-widget-missing' | 'endpoint-unresolved' | 'endpoint-not-declared' | 'nested-path-terminal-missing' | 'nested-path-not-declared' | 'state-path-not-declared' | 'feedback-cycle-unguarded' | 'feedback-cycle-guarded';
 interface ConnectionEditorDiagnostic {
     code: ConnectionEditorDiagnosticCode;
     severity: ConnectionEditorDiagnosticSeverity;
-    endpoint: 'from' | 'to';
+    endpoint: 'from' | 'to' | 'link';
+    relatedLinkIds?: string[];
 }
 interface ConnectionEditorConnection {
     id: string;
@@ -373,6 +373,7 @@ type ConnectionEditorFlowMode = 'all' | 'data' | 'event' | 'capability' | 'simul
 type ConnectionEditorDockTab = 'json' | 'links' | 'derived' | 'export';
 type ConnectionEditorConditionPreset = 'source-present' | 'source-id-present';
 type ConnectionEditorPolicyPreset = 'stable-delivery' | 'skip-missing';
+type ConnectionEditorVisualDensity = 'guided' | 'full';
 interface DragState {
     port: ConnectionEditorPort;
     source: ConnectionEditorPoint;
@@ -456,6 +457,7 @@ declare class ConnectionEditorComponent {
     readonly selectedWidgetId: _angular_core.WritableSignal<string | null>;
     readonly selectedLinkId: _angular_core.WritableSignal<string | null>;
     readonly recentLinkId: _angular_core.WritableSignal<string | null>;
+    readonly lastCreatedLinkId: _angular_core.WritableSignal<string | null>;
     readonly hoveredLinkId: _angular_core.WritableSignal<string | null>;
     readonly expandedNodeId: _angular_core.WritableSignal<string | null>;
     readonly activeDockTab: _angular_core.WritableSignal<ConnectionEditorDockTab>;
@@ -464,6 +466,8 @@ declare class ConnectionEditorComponent {
     readonly traceStepIndex: _angular_core.WritableSignal<number>;
     readonly traceSourceNodeId: _angular_core.WritableSignal<string | null>;
     readonly selectedPort: _angular_core.WritableSignal<ConnectionEditorPort | null>;
+    readonly hoveredNodeId: _angular_core.WritableSignal<string | null>;
+    readonly visualDensity: _angular_core.WritableSignal<ConnectionEditorVisualDensity>;
     readonly globalActionPayloadError: _angular_core.WritableSignal<string | null>;
     readonly pendingSegmentState: _angular_core.WritableSignal<PendingSegmentState | null>;
     readonly dragState: _angular_core.WritableSignal<DragState | null>;
@@ -543,6 +547,8 @@ declare class ConnectionEditorComponent {
     readonly visibleEdges: _angular_core.Signal<ConnectionsViewerEdge[]>;
     readonly selectedEdge: _angular_core.Signal<ConnectionsViewerEdge | null>;
     readonly editorGraph: _angular_core.Signal<ConnectionEditorGraph>;
+    readonly connectedNodeIds: _angular_core.Signal<Set<string>>;
+    readonly connectedPortIds: _angular_core.Signal<Set<string>>;
     readonly editorNodes: _angular_core.Signal<ConnectionEditorNode[]>;
     readonly navigationBounds: _angular_core.Signal<ConnectionEditorBounds>;
     readonly minimapViewBox: _angular_core.Signal<string>;
@@ -553,6 +559,8 @@ declare class ConnectionEditorComponent {
     readonly modeMatchedNodeIds: _angular_core.Signal<Set<string>>;
     readonly modeMatchedPortIds: _angular_core.Signal<Set<string>>;
     readonly smartSuggestions: _angular_core.Signal<ConnectionEditorSuggestion[]>;
+    readonly recommendedMasterDetailSuggestion: _angular_core.Signal<ConnectionEditorSuggestion | null>;
+    readonly masterDetailReadinessDiagnostic: _angular_core.Signal<string | null>;
     readonly traceSteps: _angular_core.Signal<ConnectionEditorTraceStep[]>;
     readonly activeTraceStepIndex: _angular_core.Signal<number>;
     readonly traceActiveStep: _angular_core.Signal<ConnectionEditorTraceStep>;
@@ -610,6 +618,8 @@ declare class ConnectionEditorComponent {
     handleEditorKeydown(event: KeyboardEvent): void;
     setFilter(filter: ConnectionsEditorFilter): void;
     setMode(mode: ConnectionEditorFlowMode): void;
+    toggleVisualDensity(event: Event): void;
+    visualDensityAriaLabel(): string;
     activeModeStatus(): string;
     setDockTab(tab: ConnectionEditorDockTab): void;
     handleDockTabKeydown(event: KeyboardEvent, tab: ConnectionEditorDockTab): void;
@@ -670,6 +680,9 @@ declare class ConnectionEditorComponent {
     segmentLabelTransform(segment: ConnectionEditorSegmentGeometry, node: ConnectionEditorNode): string;
     nodeRotationHandleTransform(node: ConnectionEditorNode): string;
     segmentDisplayLabel(label: string): string;
+    isNestedPort(port: ConnectionEditorPort): boolean;
+    nestedPortPathText(port: ConnectionEditorPort): string;
+    portDescription(port: ConnectionEditorPort): string;
     segmentKindGlyph(kind: ConnectionEditorPortKind): string;
     nodeIcon(node: ConnectionEditorNode): string;
     dockTabLabel(tab: ConnectionEditorDockTabDefinition): string;
@@ -677,6 +690,9 @@ declare class ConnectionEditorComponent {
     dockPanelId(tab: ConnectionEditorDockTab): string;
     dockToggleLabel(): string;
     segmentKindText(kind: ConnectionEditorPortKind): string;
+    connectionHasNestedEndpoint(connection: ConnectionEditorConnection): boolean;
+    connectionNestedSummary(connection: ConnectionEditorConnection): string;
+    private formatNestedPath;
     connectionHasErrors(connection: ConnectionEditorConnection): boolean;
     connectionHasWarnings(connection: ConnectionEditorConnection): boolean;
     connectionHasPolicy(connection: ConnectionEditorConnection): boolean;
@@ -685,6 +701,12 @@ declare class ConnectionEditorComponent {
     isModeDimmedConnection(connection: ConnectionEditorConnection): boolean;
     isModeDimmedNode(node: ConnectionEditorNode): boolean;
     isModeDimmedPort(port: ConnectionEditorPort): boolean;
+    isGuidedQuietNode(node: ConnectionEditorNode): boolean;
+    areNodePortsVisible(node: ConnectionEditorNode): boolean;
+    isGuidedPortVisible(port: ConnectionEditorPort): boolean;
+    isGuidedSegmentLabelVisible(port: ConnectionEditorPort): boolean;
+    clearHoveredNode(nodeId: string): void;
+    private updateAutoExpandedNode;
     edgeMatchesMode(edge: ConnectionsViewerEdge): boolean;
     isNodeFocusedByConnection(node: ConnectionEditorNode): boolean;
     isPortFocusedByConnection(port: ConnectionEditorPort): boolean;
@@ -696,7 +718,24 @@ declare class ConnectionEditorComponent {
     diagnosticSeverityLabel(diagnostic: ConnectionEditorDiagnostic): string;
     diagnosticText(diagnostic: ConnectionEditorDiagnostic): string;
     suggestionReasonText(reason: ConnectionEditorSuggestionReason): string;
+    connectionSemanticLabel(connection: ConnectionEditorConnection): string;
+    connectionHumanSummary(connection: ConnectionEditorConnection): string;
+    connectionDeliveryPreview(connection: ConnectionEditorConnection): string;
+    suggestionSemanticLabel(suggestion: ConnectionEditorSuggestion): string;
+    suggestionPreviewText(suggestion: ConnectionEditorSuggestion): string;
+    suggestionOutcomeText(suggestion: ConnectionEditorSuggestion): string;
+    suggestionRouteTechnicalText(suggestion: ConnectionEditorSuggestion): string;
+    suggestionActionText(suggestion: ConnectionEditorSuggestion): string;
+    connectionCreatedFeedback(connection: ConnectionEditorConnection): string;
+    portAriaLabel(node: ConnectionEditorNode, port: ConnectionEditorPort, role: 'input' | 'output' | 'state'): string;
     transformKindText(kind: TransformKind): string;
+    private readableEndpointLabel;
+    private isSelectionToDetailConnection;
+    private isSuggestedMasterDetail;
+    private isCanonicalSelectionToDetailConnection;
+    private isTableSelectionOutput;
+    private isFormResourceIdInput;
+    private portComponentType;
     expandedPorts(node: ConnectionEditorNode): ConnectionEditorPort[];
     movePort(node: ConnectionEditorNode, port: ConnectionEditorPort, direction: -1 | 1, event: Event): void;
     toggleSegments(node: ConnectionEditorNode, event: Event): void;
@@ -758,6 +797,7 @@ declare class ConnectionEditorComponent {
     private showInvalidDropFeedback;
     private clearInvalidDropFeedback;
     private markRecentLink;
+    private scrollConnectionSidePanelToTop;
     private clearPreviewConnectionState;
     private shouldIgnoreEditorShortcut;
     private scrollActiveModeIntoView;
@@ -807,20 +847,37 @@ type DeviceVariantForm = FormGroup<{
     groupingOverrides: FormControl<string>;
     widgetOverrides: FormControl<string>;
 }>;
+type LayoutPresetEntry = {
+    id: string;
+    label: string;
+    description: string;
+    category: string;
+    defaultColumns: number;
+    defaultGap: string;
+    slotLabels: string[];
+    requiredSlotLabels: string[];
+    deviceStacking: string;
+    preferTabsOnMobile: boolean;
+    hideSecondaryContentOnMobile: boolean;
+    defaultThemePreset: string;
+};
+type ThemePresetEntry = {
+    id: string;
+    label: string;
+    description: string;
+    density: string;
+    motion: string;
+    shellPreset: string;
+    chartThemePreset: string;
+};
 declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueProvider$1 {
     set page(value: WidgetPageDefinition | string | null | undefined);
     layout?: unknown;
     presets?: unknown;
     pagePreset?: string | null;
     pageChange: EventEmitter<WidgetPageDefinition>;
-    readonly layoutPresetEntries: {
-        id: string;
-        label: string;
-    }[];
-    readonly themePresetEntries: {
-        id: string;
-        label: string;
-    }[];
+    readonly layoutPresetEntries: LayoutPresetEntry[];
+    readonly themePresetEntries: ThemePresetEntry[];
     readonly shellPresetEntries: {
         id: string;
         label: string;
@@ -848,6 +905,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     readonly stateError: WritableSignal<string | null>;
     readonly deviceError: WritableSignal<string | null>;
     private readonly injectedData;
+    private readonly i18n;
     private pageInput;
     private snapshot;
     private hydrating;
@@ -861,13 +919,24 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     get dirtyStateLabel(): string;
     get selectedLayoutPresetLabel(): string;
     get selectedThemePresetLabel(): string;
+    get selectedLayoutPresetEntry(): LayoutPresetEntry | null;
+    get selectedThemePresetEntry(): ThemePresetEntry | null;
+    get recommendedThemePresetEntry(): ThemePresetEntry | null;
     get canvasSummaryLabel(): string;
     onSelectedTabIndexChange(index: number): void;
     getSettingsValue(): WidgetPageDefinition | null;
     onSave(): WidgetPageDefinition | null;
     reset(): void;
+    pinRecommendedThemePreset(): void;
     addGroupingNode(seed?: WidgetPageGroupingDefinition): void;
     removeGroupingNode(index: number): void;
+    layoutPresetSummary(preset: LayoutPresetEntry): string;
+    slotsSummary(preset: LayoutPresetEntry): string;
+    requiredSlotsSummary(preset: LayoutPresetEntry): string;
+    devicePolicySummary(preset: LayoutPresetEntry): string;
+    inheritedThemeHelp(theme: ThemePresetEntry): string;
+    groupLabel(index: number): string;
+    tx(key: string, fallback: string): string;
     private createDeviceVariantForm;
     private createGroupingNodeGroup;
     private hydrate;
@@ -1207,7 +1276,8 @@ interface PageBuilderAgenticAuthoringTurnStreamRequest {
     pendingClarification?: PageBuilderAgenticAuthoringPendingClarification | null;
     componentCapabilities?: PageBuilderAgenticAuthoringComponentCapabilitiesResult | null;
     attachmentSummaries?: PageBuilderAgenticAuthoringAttachmentSummary[];
-    contextHints?: AiContextHintsContract | null;
+    contextHints?: AgenticAuthoringTurnStreamContextHintsContract | null;
+    activeSemanticDecision?: AgenticAuthoringSemanticDecisionContract | null;
     diagnostics?: AiJsonObject | null;
     runtimeComponentObservations?: readonly PraxisRuntimeComponentObservationEnvelope[];
     runtimeComponentObservationTrustBoundary?: 'untrusted_frontend_observation';
@@ -1358,6 +1428,8 @@ type PageBuilderAgenticAuthoringTurnStreamEvent = AgenticAuthoringTurnStreamEnve
 interface PageBuilderApplyRequest {
     compiledFormPatch: PageBuilderCompiledFormPatch;
     componentId: string;
+    streamId: string;
+    resultEventId: string;
     componentType?: string;
     scope?: 'user' | 'tenant';
     tags?: Record<string, unknown>;
@@ -1653,6 +1725,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private readonly agenticAuthoring;
     private readonly agenticTurnOrchestrator;
     private readonly assistantSessions;
+    private readonly observabilityDashboard;
     private readonly runtimeObservationRegistry;
     private readonly agenticAuthoringOptions;
     runtime?: DynamicWidgetPageComponent;
@@ -1677,6 +1750,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     agenticAuthoringEtag?: string;
     agenticAuthoringIncludeLlmDiagnostics: boolean;
     agenticAuthoringEnableStreaming: boolean;
+    agenticAuthoringVoiceInputMode: PraxisAssistantVoiceInputMode;
     agenticAuthoringContextHints?: Record<string, unknown> | null;
     showPageLifecycleActions: boolean;
     canDeleteSavedPage: boolean;
@@ -1691,15 +1765,21 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     savedPageDeleteRequested: EventEmitter<void>;
     readonly currentPage: _angular_core.WritableSignal<WidgetPageDefinition>;
     readonly hasPageWidgets: _angular_core.Signal<boolean>;
+    readonly hasRecommendedConnectionSuggestion: _angular_core.Signal<boolean>;
     readonly premiumReadinessIssues: _angular_core.Signal<PageBuilderPremiumReadinessIssue[]>;
     readonly connectionsViewerOpen: _angular_core.WritableSignal<boolean>;
     readonly agenticAuthoringOpen: _angular_core.WritableSignal<boolean>;
     readonly agenticAuthoringPrompt: _angular_core.WritableSignal<string>;
     readonly agenticAuthoringBusy: _angular_core.WritableSignal<boolean>;
+    private readonly agenticAuthoringTerminalState;
     readonly agenticAuthoringStatus: _angular_core.WritableSignal<string>;
     readonly agenticAuthoringError: _angular_core.WritableSignal<string>;
     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[]>;
@@ -1720,6 +1800,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     readonly projectKnowledgeCockpitValidation: _angular_core.WritableSignal<DomainKnowledgeValidationResponse | null>;
     readonly projectKnowledgeCockpitTimeline: _angular_core.WritableSignal<DomainKnowledgeChangeSetTimelineResponse | null>;
     readonly agenticAuthoringLlmDiagnostics: _angular_core.WritableSignal<Record<string, unknown> | null>;
+    readonly agenticTurnHealth: _angular_core.WritableSignal<ObservabilityAgenticTurnMetrics>;
     readonly agenticAuthoringLlmDiagnosticsCollapsed: _angular_core.WritableSignal<boolean>;
     readonly sharedRuleCockpitCollapsed: _angular_core.WritableSignal<boolean>;
     readonly projectKnowledgeCockpitCollapsed: _angular_core.WritableSignal<boolean>;
@@ -1728,19 +1809,25 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     readonly agenticAuthoringWidgetContextKey: _angular_core.WritableSignal<string | null>;
     readonly agenticAuthoringPanelLayout: _angular_core.WritableSignal<PraxisAssistantShellLayout>;
     private previewMode;
+    private runtimePreviewPageCache?;
+    private runtimeAuthoringPageCache?;
     private agenticComponentCapabilities?;
     private agenticComponentCapabilitiesPromise?;
     private agenticTurnController?;
+    private readonly agenticLocalPreviewHistory;
+    private agenticLocalPreviewHistoryTruncated;
     private readonly agenticTurnCancel$;
     private agenticTurnRunId;
-    private agenticAuthoringTurnTerminalTimeoutMs;
+    private agenticAuthoringTurnInactivityTimeoutMs;
     private sharedRuleHandoffRevision;
     private agenticAuthoringPanelLayoutTouched;
+    private readonly observabilityMetricsSubscription;
     constructor(dialog: MatDialog, settingsPanel: SettingsPanelBridge | null);
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     showSettings(): boolean;
     isPreviewMode(): boolean;
+    runtimePage(): WidgetPageDefinition;
     builderModeLabel(): string;
     onRuntimePageChange(next: WidgetPageDefinition): void;
     onRuntimeWidgetEvent(event: WidgetEventEnvelope): void;
@@ -1748,6 +1835,14 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     onRuntimeWidgetSelectionChange(widgetKey: string | null): void;
     togglePreview(): void;
     toggleAgenticAuthoringLlmDiagnostics(): void;
+    agenticAuthoringDiagnosticsAvailable(): boolean;
+    agenticTurnHealthBuckets(): Array<{
+        dimension: 'provider' | 'model';
+        bucket: ObservabilityAgenticTurnMetricBucket;
+    }>;
+    formatAgenticMetricPercent(rate: number): string;
+    formatAgenticDuration(durationMs: number): string;
+    private emptyAgenticTurnHealth;
     toggleSharedRuleCockpit(): void;
     toggleProjectKnowledgeCockpit(): void;
     toggleConnectionsViewer(): void;
@@ -1774,6 +1869,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     minimizeAgenticAuthoring(): void;
     onAgenticAuthoringLayoutChange(layout: AgenticAuthoringPanelLayout): void;
     agenticAuthoringReviewRailActive(): boolean;
+    showAgenticAuthoringPanel(): boolean;
     showAgenticAuthoringDock(): boolean;
     agenticAuthoringMinimized(): boolean;
     agenticAuthoringToggleLabel(): string;
@@ -1781,10 +1877,11 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     agenticAuthoringHeaderSubtitle(): string;
     agenticAuthoringHeaderModeLabel(): string;
     agenticAuthoringShellLabels(): Partial<PraxisAssistantShellLabels>;
+    agenticAuthoringRecommendedIntents(): readonly PraxisAssistantRecommendedIntent[];
     private agenticAuthoringEmptyConversationMessage;
     private resolveAgenticAuthoredOpeningMessage;
     private isAgenticAuthoringPageBlank;
-    private hasBlockingAgenticReview;
+    private hasPendingAgenticPreview;
     agenticAuthoringSubmitAction(): PraxisAssistantShellAction;
     agenticAuthoringDockIcon(): string;
     agenticAuthoringDockBadge(): string;
@@ -1794,6 +1891,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private resetAgenticAuthoringSessionState;
     private syncAgenticAuthoringSession;
     private resolveAgenticAuthoringSessionId;
+    private pageIdentityFingerprint;
     private truncateAgenticDockText;
     agenticAuthoringProjectKnowledgeAudit(): PageBuilderProjectKnowledgeAudit | null;
     canRunProjectKnowledgeChangeSet(): boolean;
@@ -1811,6 +1909,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private agenticAuthoringSemanticDecisionContextItems;
     private shouldHideSemanticDecisionContextItems;
     private humanizeAgenticResourcePath;
+    private agenticSemanticResourceLabel;
     private humanizeAgenticDecisionSummary;
     private humanizeAgenticOperationKind;
     private humanizeAgenticArtifactKind;
@@ -1818,7 +1917,9 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private humanizeAgenticDecisionEvidence;
     private humanizeAgenticToken;
     previewAgenticAuthoring(): Promise<void>;
+    submitAgenticRecommendedIntent(intent: PraxisAssistantRecommendedIntent): Promise<void>;
     submitAgenticQuickReply(reply: PraxisAssistantShellQuickReply): Promise<void>;
+    private isGovernedReviewRepairQuickReply;
     private agenticQuickReplyVisiblePrompt;
     private agenticQuickReplySubmittedPrompt;
     private agenticQuickReplyClarificationConfirmationPrompt;
@@ -1839,6 +1940,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>;
@@ -1894,8 +1996,21 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private formatSharedRuleTargetLayer;
     private loadAgenticComponentCapabilities;
     private collectRuntimeComponentObservationsForAgenticTurn;
+    private resolveSelectedComponentAuthoringContext;
+    private isComponentConfigEditorContextResult;
     private ensureAgenticTurnController;
     private applyAgenticPreviewLocally;
+    private agenticLocalUndoAction;
+    private executeAgenticClientAction;
+    private canUndoAgenticLocalPreview;
+    private undoAgenticLocalPreview;
+    private recordAgenticLocalPreview;
+    private clearAgenticLocalPreviewHistory;
+    private agenticCurrentPageFingerprint;
+    private enterPreviewMode;
+    private toPresentationRuntimePage;
+    private toAuthoringRuntimePage;
+    private toPresentationRuntimeWidget;
     private applyAgenticTurnState;
     private primeSharedRuleHandoff;
     private moveAgenticAuthoringPanelToReviewSidecar;
@@ -1909,6 +2024,7 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private consumeAgenticTurn;
     private beginAgenticTurn;
     private cancelActiveAgenticTurn;
+    private invalidateAgenticTerminalAuthorization;
     private isCurrentAgenticTurn;
     private createAgenticTurnTimeoutState;
     private isAgenticTurnTimeoutState;
@@ -1917,9 +2033,16 @@ 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;
+    private humanizeGovernedDomainContextResolutionStatus;
     private trimmedString;
     private toRecord;
     private resolvePreviewCompiledFormPatch;
@@ -1949,8 +2072,13 @@ declare class DynamicPageBuilderComponent implements OnChanges, OnDestroy {
     private cloneValue;
     tx(key: string, fallback: string): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DynamicPageBuilderComponent, [null, { optional: true; }]>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicPageBuilderComponent, "praxis-dynamic-page-builder", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "autoPersist": { "alias": "autoPersist"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "showSettingsButton": { "alias": "showSettingsButton"; "required": false; }; "pageIdentity": { "alias": "pageIdentity"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "pageEditorComponent": { "alias": "pageEditorComponent"; "required": false; }; "componentPaletteAllowedWidgetIds": { "alias": "componentPaletteAllowedWidgetIds"; "required": false; }; "componentPaletteAllowedWidgetTags": { "alias": "componentPaletteAllowedWidgetTags"; "required": false; }; "componentPaletteAllowedPresetIds": { "alias": "componentPaletteAllowedPresetIds"; "required": false; }; "enableAgenticAuthoring": { "alias": "enableAgenticAuthoring"; "required": false; }; "agenticAuthoringProvider": { "alias": "agenticAuthoringProvider"; "required": false; }; "agenticAuthoringModel": { "alias": "agenticAuthoringModel"; "required": false; }; "agenticAuthoringApiKey": { "alias": "agenticAuthoringApiKey"; "required": false; }; "agenticAuthoringComponentId": { "alias": "agenticAuthoringComponentId"; "required": false; }; "agenticAuthoringScope": { "alias": "agenticAuthoringScope"; "required": false; }; "agenticAuthoringEtag": { "alias": "agenticAuthoringEtag"; "required": false; }; "agenticAuthoringIncludeLlmDiagnostics": { "alias": "agenticAuthoringIncludeLlmDiagnostics"; "required": false; }; "agenticAuthoringEnableStreaming": { "alias": "agenticAuthoringEnableStreaming"; "required": false; }; "agenticAuthoringContextHints": { "alias": "agenticAuthoringContextHints"; "required": false; }; "showPageLifecycleActions": { "alias": "showPageLifecycleActions"; "required": false; }; "canDeleteSavedPage": { "alias": "canDeleteSavedPage"; "required": false; }; "pageLifecycleBusy": { "alias": "pageLifecycleBusy"; "required": false; }; "pageLifecycleResetRevision": { "alias": "pageLifecycleResetRevision"; "required": false; }; }, { "pageChange": "pageChange"; "widgetEvent": "widgetEvent"; "pageSaveRequested": "pageSaveRequested"; "agenticAuthoringApplied": "agenticAuthoringApplied"; "agenticAuthoringSharedRuleHandoff": "agenticAuthoringSharedRuleHandoff"; "pageRestart": "pageRestart"; "savedPageDeleteRequested": "savedPageDeleteRequested"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicPageBuilderComponent, "praxis-dynamic-page-builder", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "autoPersist": { "alias": "autoPersist"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "showSettingsButton": { "alias": "showSettingsButton"; "required": false; }; "pageIdentity": { "alias": "pageIdentity"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "pageEditorComponent": { "alias": "pageEditorComponent"; "required": false; }; "componentPaletteAllowedWidgetIds": { "alias": "componentPaletteAllowedWidgetIds"; "required": false; }; "componentPaletteAllowedWidgetTags": { "alias": "componentPaletteAllowedWidgetTags"; "required": false; }; "componentPaletteAllowedPresetIds": { "alias": "componentPaletteAllowedPresetIds"; "required": false; }; "enableAgenticAuthoring": { "alias": "enableAgenticAuthoring"; "required": false; }; "agenticAuthoringProvider": { "alias": "agenticAuthoringProvider"; "required": false; }; "agenticAuthoringModel": { "alias": "agenticAuthoringModel"; "required": false; }; "agenticAuthoringApiKey": { "alias": "agenticAuthoringApiKey"; "required": false; }; "agenticAuthoringComponentId": { "alias": "agenticAuthoringComponentId"; "required": false; }; "agenticAuthoringScope": { "alias": "agenticAuthoringScope"; "required": false; }; "agenticAuthoringEtag": { "alias": "agenticAuthoringEtag"; "required": false; }; "agenticAuthoringIncludeLlmDiagnostics": { "alias": "agenticAuthoringIncludeLlmDiagnostics"; "required": false; }; "agenticAuthoringEnableStreaming": { "alias": "agenticAuthoringEnableStreaming"; "required": false; }; "agenticAuthoringVoiceInputMode": { "alias": "agenticAuthoringVoiceInputMode"; "required": false; }; "agenticAuthoringContextHints": { "alias": "agenticAuthoringContextHints"; "required": false; }; "showPageLifecycleActions": { "alias": "showPageLifecycleActions"; "required": false; }; "canDeleteSavedPage": { "alias": "canDeleteSavedPage"; "required": false; }; "pageLifecycleBusy": { "alias": "pageLifecycleBusy"; "required": false; }; "pageLifecycleResetRevision": { "alias": "pageLifecycleResetRevision"; "required": false; }; }, { "pageChange": "pageChange"; "widgetEvent": "widgetEvent"; "pageSaveRequested": "pageSaveRequested"; "agenticAuthoringApplied": "agenticAuthoringApplied"; "agenticAuthoringSharedRuleHandoff": "agenticAuthoringSharedRuleHandoff"; "pageRestart": "pageRestart"; "savedPageDeleteRequested": "savedPageDeleteRequested"; }, never, never, true, never>;
 }
 
-export { ComponentPaletteDialogComponent, ConfirmDialogComponent, ConnectionEditorComponent, DynamicPageBuilderComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS, PAGE_BUILDER_AI_CAPABILITIES, PAGE_BUILDER_COMPONENT_CONTEXT_PACK, PAGE_BUILDER_WIDGET_AI_CATALOGS, PLACEHOLDER, PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, TileToolbarComponent, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, providePageBuilderWidgetAiCatalogs, registerWidgetAiCatalog, registerWidgetAiCatalogs, validateUiCompositionPlan };
+/** Metadata for Praxis Page Builder component */
+declare const PRAXIS_PAGE_BUILDER_COMPONENT_METADATA: ComponentDocMeta;
+/** Provider para auto-registrar metadados do componente Page Builder. */
+declare function providePraxisPageBuilderMetadata(): Provider;
+
+export { ComponentPaletteDialogComponent, ConfirmDialogComponent, ConnectionEditorComponent, DynamicPageBuilderComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS, PAGE_BUILDER_AI_CAPABILITIES, PAGE_BUILDER_COMPONENT_CONTEXT_PACK, PAGE_BUILDER_WIDGET_AI_CATALOGS, PLACEHOLDER, PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST, PRAXIS_PAGE_BUILDER_COMPONENT_METADATA, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, TileToolbarComponent, WidgetShellEditorComponent, clearWidgetAiCatalogs, compileUiCompositionPlan, getPageAiCatalog, getWidgetAiCapabilities, providePageBuilderWidgetAiCatalogs, providePraxisPageBuilderMetadata, registerWidgetAiCatalog, registerWidgetAiCatalogs, validateUiCompositionPlan };
 export type { Capability, CapabilityCatalog, CapabilityCategory, ComponentPaletteData, ComponentPaletteSelection, ConfirmDialogData, PageBuilderAgenticAuthoringAttachmentSummary, PageBuilderAgenticAuthoringCandidate, PageBuilderAgenticAuthoringComponentCapabilitiesResult, PageBuilderAgenticAuthoringComponentCapability, PageBuilderAgenticAuthoringComponentCapabilityCatalog, PageBuilderAgenticAuthoringComponentCapabilityExample, PageBuilderAgenticAuthoringComponentFieldAlias, PageBuilderAgenticAuthoringConversationMessage, PageBuilderAgenticAuthoringGateResult, PageBuilderAgenticAuthoringIntentResolutionRequest, PageBuilderAgenticAuthoringIntentResolutionResult, PageBuilderAgenticAuthoringOptions, PageBuilderAgenticAuthoringPendingClarification, PageBuilderAgenticAuthoringPromptRequest, PageBuilderAgenticAuthoringProvider, PageBuilderAgenticAuthoringQuickReply, PageBuilderAgenticAuthoringResourceCandidatesRequest, PageBuilderAgenticAuthoringResourceCandidatesResult, PageBuilderAgenticAuthoringSharedRuleHandoff, PageBuilderAgenticAuthoringTarget, PageBuilderAgenticAuthoringTurnStreamConnectionError, PageBuilderAgenticAuthoringTurnStreamEvent, PageBuilderAgenticAuthoringTurnStreamRequest, PageBuilderAgenticAuthoringTurnStreamStartResponse, PageBuilderApplyRequest, PageBuilderApplyResult, PageBuilderCompiledFormPatch, PageBuilderMinimalFormPlanResult, PageBuilderPreviewDiagnostics, PageBuilderPreviewResult, PageBuilderProjectKnowledgeAudit, UiCompositionPlan, UiCompositionPlanBinding, UiCompositionPlanCompileResult, UiCompositionPlanComponentPortEndpoint, UiCompositionPlanDiagnostic, UiCompositionPlanEndpoint, UiCompositionPlanGlobalActionEndpoint, UiCompositionPlanInputSource, UiCompositionPlanSourceEndpoint, UiCompositionPlanStateEndpoint, UiCompositionPlanTargetEndpoint, UiCompositionPlanTransform, UiCompositionPlanWidget, ValueKind };