@praxisui/page-builder 8.0.0-beta.0 → 8.0.0-beta.11

package/index.d.ts

@@ -1,12 +1,13 @@
 import { MatDialogRef, MatDialog } from '@angular/material/dialog';
-import * as i0 from '@angular/core';
+import * as _angular_core from '@angular/core';
 import { EventEmitter, OnInit, WritableSignal, InjectionToken, Provider, OnChanges, Type, SimpleChanges } from '@angular/core';
 import { ComponentDocMeta, ComponentMetadataRegistry, WidgetShellConfig, WidgetShellAction, SettingsValueProvider as SettingsValueProvider$1, WidgetPageDefinition, WidgetPageGroupingDefinition, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PageIdentity, WidgetStateNode, WidgetDerivedStateNode, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog, WidgetInstance, WidgetPageStateInput, CompositionLink, DynamicWidgetPageComponent, SettingsPanelBridge } from '@praxisui/core';
 export { WidgetShellComponent } from '@praxisui/core';
 import * as rxjs from 'rxjs';
-import { BehaviorSubject } from 'rxjs';
+import { BehaviorSubject, Observable } from 'rxjs';
 import { FormGroup, FormControl, FormArray } from '@angular/forms';
 import { SettingsValueProvider } from '@praxisui/settings-panel';
+import { AgenticAuthoringPlanRequestContract, AgenticAuthoringCandidateContract, AiJsonValue, AgenticAuthoringQuickReplyContract, AgenticAuthoringPendingClarificationContract, AiJsonObject, AgenticAuthoringComponentCapabilitiesResultContract, AgenticAuthoringComponentCapabilityCatalogContract, AgenticAuthoringComponentCapabilityContract, AgenticAuthoringComponentFieldAliasContract, AgenticAuthoringComponentCapabilityExampleContract, AgenticAuthoringAttachmentSummaryContract, AgenticAuthoringIntentResolutionRequestContract, AgenticAuthoringConversationMessageContract, AgenticAuthoringResourceCandidatesRequestContract, AgenticAuthoringResourceCandidatesResultContract, AgenticAuthoringTurnStreamStartResponseContract, AgenticAuthoringTurnStreamEnvelopeContract, PraxisAssistantShellMessage, PraxisAssistantShellQuickReply, PraxisAssistantShellAttachment, PraxisAssistantShellLayout, PraxisAssistantShellLabels, PraxisAssistantShellState, PraxisAssistantShellContextItem } from '@praxisui/ai';
 
 declare const PLACEHOLDER = 1;
 
@@ -21,8 +22,8 @@ declare class ConfirmDialogComponent {
     data: ConfirmDialogData;
     ref: MatDialogRef<ConfirmDialogComponent, boolean>;
     constructor(data: ConfirmDialogData, ref: MatDialogRef<ConfirmDialogComponent, boolean>);
-    static ɵfac: i0.ɵɵFactoryDeclaration<ConfirmDialogComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ConfirmDialogComponent, "praxis-confirm-dialog", never, {}, {}, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ConfirmDialogComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ConfirmDialogComponent, "praxis-confirm-dialog", never, {}, {}, never, never, true, never>;
 }
 
 declare class TileToolbarComponent {
@@ -31,8 +32,8 @@ declare class TileToolbarComponent {
     remove: EventEmitter<void>;
     settings: EventEmitter<void>;
     shell: EventEmitter<void>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<TileToolbarComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TileToolbarComponent, "praxis-tile-toolbar", never, { "selected": { "alias": "selected"; "required": false; }; "widgetType": { "alias": "widgetType"; "required": false; }; }, { "remove": "remove"; "settings": "settings"; "shell": "shell"; }, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TileToolbarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TileToolbarComponent, "praxis-tile-toolbar", never, { "selected": { "alias": "selected"; "required": false; }; "widgetType": { "alias": "widgetType"; "required": false; }; }, { "remove": "remove"; "settings": "settings"; "shell": "shell"; }, never, never, true, never>;
 }
 
 declare class FloatingToolbarComponent {
@@ -45,8 +46,8 @@ declare class FloatingToolbarComponent {
     settings: EventEmitter<void>;
     preview: EventEmitter<void>;
     save: EventEmitter<void>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FloatingToolbarComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FloatingToolbarComponent, "praxis-floating-toolbar", never, { "visible": { "alias": "visible"; "required": false; }; "canUndo": { "alias": "canUndo"; "required": false; }; "canRedo": { "alias": "canRedo"; "required": false; }; }, { "add": "add"; "undo": "undo"; "redo": "redo"; "settings": "settings"; "preview": "preview"; "save": "save"; }, never, ["[pdx-toolbar-extra]"], true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FloatingToolbarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FloatingToolbarComponent, "praxis-floating-toolbar", never, { "visible": { "alias": "visible"; "required": false; }; "canUndo": { "alias": "canUndo"; "required": false; }; "canRedo": { "alias": "canRedo"; "required": false; }; }, { "add": "add"; "undo": "undo"; "redo": "redo"; "settings": "settings"; "preview": "preview"; "save": "save"; }, never, ["[pdx-toolbar-extra]"], true, never>;
 }
 
 interface ComponentPaletteData {
@@ -61,8 +62,8 @@ declare class ComponentPaletteDialogComponent implements OnInit {
     data?: ComponentPaletteData | undefined;
     query: string;
     private all;
-    filtered: i0.Signal<ComponentDocMeta[]>;
-    density: i0.Signal<"roomy" | "dense" | "normal">;
+    filtered: _angular_core.Signal<ComponentDocMeta[]>;
+    density: _angular_core.Signal<"roomy" | "dense" | "normal">;
     constructor(dialogRef: MatDialogRef<ComponentPaletteDialogComponent, string>, registry: ComponentMetadataRegistry, data?: ComponentPaletteData | undefined);
     ngOnInit(): void;
     select(id: string): void;
@@ -70,8 +71,8 @@ declare class ComponentPaletteDialogComponent implements OnInit {
     getPreview(m: ComponentDocMeta): string;
     private _adjustSizeEffect;
     private applyFilters;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ComponentPaletteDialogComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ComponentPaletteDialogComponent, "praxis-component-palette-dialog", never, {}, {}, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComponentPaletteDialogComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ComponentPaletteDialogComponent, "praxis-component-palette-dialog", never, {}, {}, never, never, true, never>;
 }
 
 type ShellInputs = {
@@ -202,8 +203,8 @@ declare class WidgetShellEditorComponent implements SettingsValueProvider {
     private findActionIndex;
     private previewActions;
     private loadSetInputPresets;
-    static ɵfac: i0.ɵɵFactoryDeclaration<WidgetShellEditorComponent, [{ optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<WidgetShellEditorComponent, "praxis-widget-shell-editor", never, {}, {}, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<WidgetShellEditorComponent, [{ optional: true; }, { optional: true; }]>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<WidgetShellEditorComponent, "praxis-widget-shell-editor", never, {}, {}, never, never, true, never>;
 }
 
 type EditorTabId$1 = 'canvas' | 'grouping' | 'devices' | 'context' | 'state';
@@ -317,8 +318,8 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     private lookupPresetLabel;
     private defaultCanvas;
     private clone;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DynamicPageConfigEditorComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DynamicPageConfigEditorComponent, "praxis-dynamic-page-config-editor", never, { "page": { "alias": "page"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "presets": { "alias": "presets"; "required": false; }; "pagePreset": { "alias": "pagePreset"; "required": false; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DynamicPageConfigEditorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DynamicPageConfigEditorComponent, "praxis-dynamic-page-config-editor", never, { "page": { "alias": "page"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "presets": { "alias": "presets"; "required": false; }; "pagePreset": { "alias": "pagePreset"; "required": false; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
 }
 
 type LegacyGridOptions = {
@@ -372,10 +373,10 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
     protected readonly groupingKinds: readonly ["section", "tabs", "hero", "rail"];
     protected readonly layoutPresetEntries: Array<(typeof BUILTIN_PAGE_LAYOUT_PRESETS)[string]>;
     protected readonly themePresetEntries: Array<(typeof BUILTIN_PAGE_THEME_PRESETS)[string]>;
-    readonly page: i0.InputSignal<string | PageDefinition | null>;
-    readonly identity: i0.InputSignal<PageIdentity | null>;
-    readonly layoutCompatOptions: i0.InputSignal<any>;
-    readonly pageChange: i0.OutputEmitterRef<PageDefinition>;
+    readonly page: _angular_core.InputSignal<string | PageDefinition | null>;
+    readonly identity: _angular_core.InputSignal<PageIdentity | null>;
+    readonly layoutCompatOptions: _angular_core.InputSignal<any>;
+    readonly pageChange: _angular_core.OutputEmitterRef<PageDefinition>;
     readonly form: FormGroup<{
         cols: FormControl<number | null>;
         rowHeight: FormControl<number | null>;
@@ -415,10 +416,10 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
         groupingOverridesJson: FormControl<string>;
         widgetOverridesJson: FormControl<string>;
     }>;
-    readonly contextError: i0.WritableSignal<string | null>;
-    readonly layoutError: i0.WritableSignal<string | null>;
-    readonly stateError: i0.WritableSignal<string | null>;
-    readonly activeTab: i0.WritableSignal<EditorTabId>;
+    readonly contextError: _angular_core.WritableSignal<string | null>;
+    readonly layoutError: _angular_core.WritableSignal<string | null>;
+    readonly stateError: _angular_core.WritableSignal<string | null>;
+    readonly activeTab: _angular_core.WritableSignal<EditorTabId>;
     readonly shellPresetEntries: Array<{
         id: string;
         label: string;
@@ -512,8 +513,8 @@ declare class PageConfigEditorComponent implements SettingsValueProvider$1 {
     private buildOperatorOptions;
     private buildOptions;
     private clone;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PageConfigEditorComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PageConfigEditorComponent, "praxis-page-config-editor", never, { "page": { "alias": "page"; "required": false; "isSignal": true; }; "identity": { "alias": "identity"; "required": false; "isSignal": true; }; "layoutCompatOptions": { "alias": "layoutCompatOptions"; "required": false; "isSignal": true; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PageConfigEditorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageConfigEditorComponent, "praxis-page-config-editor", never, { "page": { "alias": "page"; "required": false; "isSignal": true; }; "identity": { "alias": "identity"; "required": false; "isSignal": true; }; "layoutCompatOptions": { "alias": "layoutCompatOptions"; "required": false; "isSignal": true; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
 }
 
 /**
@@ -539,6 +540,220 @@ interface CapabilityCatalog extends AiCapabilityCatalog {
 }
 declare const PAGE_BUILDER_AI_CAPABILITIES: CapabilityCatalog;
 
+type PageBuilderAgenticAuthoringProvider = 'openai' | 'gemini' | string;
+interface PageBuilderAgenticAuthoringOptions {
+    baseUrl?: string;
+    headersFactory?: () => Record<string, string | undefined>;
+    defaultHeaders?: Record<string, string>;
+    eventSourceFactory?: PageBuilderAgenticAuthoringEventSourceFactory;
+    streamConnectionErrorGraceMs?: number;
+}
+interface PageBuilderAgenticAuthoringEventSource {
+    onmessage: ((event: MessageEvent<string>) => void) | null;
+    onerror: ((event: Event) => void) | null;
+    addEventListener?(type: string, listener: (event: MessageEvent<string>) => void): void;
+    close(): void;
+}
+type PageBuilderAgenticAuthoringEventSourceFactory = (url: string) => PageBuilderAgenticAuthoringEventSource;
+interface PageBuilderAgenticAuthoringTurnStreamConnectionError {
+    readonly praxisAgenticTurnStreamConnectionError: true;
+    readonly cause: unknown;
+}
+interface PageBuilderAgenticAuthoringPromptRequest extends Omit<AgenticAuthoringPlanRequestContract, 'currentPage' | 'intentResolution'> {
+    provider?: PageBuilderAgenticAuthoringProvider | null;
+    currentPage?: unknown;
+    selectedWidgetKey?: string | null;
+    intentResolution?: PageBuilderAgenticAuthoringIntentResolutionResult | null;
+    componentCapabilities?: PageBuilderAgenticAuthoringComponentCapabilitiesResult | null;
+    attachmentSummaries?: PageBuilderAgenticAuthoringAttachmentSummary[];
+}
+interface PageBuilderAgenticAuthoringIntentResolutionRequest extends Omit<AgenticAuthoringIntentResolutionRequestContract, 'currentPage'> {
+    provider?: PageBuilderAgenticAuthoringProvider | null;
+    currentPage?: unknown;
+    componentCapabilities?: PageBuilderAgenticAuthoringComponentCapabilitiesResult | null;
+    attachmentSummaries?: PageBuilderAgenticAuthoringAttachmentSummary[];
+}
+interface PageBuilderAgenticAuthoringTurnStreamRequest {
+    userPrompt: string;
+    targetApp?: string | null;
+    targetComponentId?: string | null;
+    currentRoute?: string | null;
+    provider?: PageBuilderAgenticAuthoringProvider | null;
+    model?: string | null;
+    apiKey?: string | null;
+    currentPage?: unknown;
+    selectedWidgetKey?: string | null;
+    sessionId?: string | null;
+    clientTurnId?: string | null;
+    conversationMessages?: PageBuilderAgenticAuthoringConversationMessage[];
+    pendingClarification?: PageBuilderAgenticAuthoringPendingClarification | null;
+    componentCapabilities?: PageBuilderAgenticAuthoringComponentCapabilitiesResult | null;
+    attachmentSummaries?: PageBuilderAgenticAuthoringAttachmentSummary[];
+    contextHints?: AiJsonObject | null;
+}
+type PageBuilderAgenticAuthoringConversationMessage = AgenticAuthoringConversationMessageContract;
+type PageBuilderAgenticAuthoringPendingClarification = AgenticAuthoringPendingClarificationContract;
+type PageBuilderAgenticAuthoringQuickReply = AgenticAuthoringQuickReplyContract;
+type PageBuilderAgenticAuthoringAttachmentSummary = AgenticAuthoringAttachmentSummaryContract;
+interface PageBuilderAgenticAuthoringCandidate extends AgenticAuthoringCandidateContract {
+    resourcePath: string;
+    operation: string;
+    schemaUrl: string;
+    submitUrl: string;
+    submitMethod: string;
+    score: number;
+    reason: string;
+    evidence: string[];
+    [key: string]: AiJsonValue | undefined;
+}
+interface PageBuilderAgenticAuthoringResourceCandidatesRequest extends AgenticAuthoringResourceCandidatesRequestContract {
+}
+interface PageBuilderAgenticAuthoringResourceCandidatesResult extends Omit<AgenticAuthoringResourceCandidatesResultContract, 'candidates'> {
+    valid: boolean;
+    tool: string;
+    retrievalQuery: string;
+    artifactKind: string;
+    assistantMessage?: string | null;
+    candidates: PageBuilderAgenticAuthoringCandidate[];
+    quickReplies?: PageBuilderAgenticAuthoringQuickReply[];
+    warnings: string[];
+}
+interface PageBuilderAgenticAuthoringTarget {
+    widgetKey: string;
+    componentId: string;
+    resourcePath: string;
+    schemaUrl: string;
+    submitUrl: string;
+    submitMethod: string;
+}
+interface PageBuilderAgenticAuthoringGateResult {
+    gateId: string;
+    status: string;
+    messages: string[];
+}
+interface PageBuilderAgenticAuthoringComponentFieldAlias extends AgenticAuthoringComponentFieldAliasContract {
+    field: string;
+    aliases: string[];
+}
+interface PageBuilderAgenticAuthoringComponentCapability extends Omit<AgenticAuthoringComponentCapabilityContract, 'fieldAliases' | 'examples'> {
+    id: string;
+    changeKind: string;
+    triggerTerms: string[];
+    fieldAliases: PageBuilderAgenticAuthoringComponentFieldAlias[];
+    examples?: PageBuilderAgenticAuthoringComponentCapabilityExample[];
+}
+interface PageBuilderAgenticAuthoringComponentCapabilityExample extends AgenticAuthoringComponentCapabilityExampleContract {
+    prompt: string;
+    intent: string;
+    configHints: string[];
+}
+interface PageBuilderAgenticAuthoringComponentCapabilityCatalog extends Omit<AgenticAuthoringComponentCapabilityCatalogContract, 'capabilities'> {
+    componentId: string;
+    version: string;
+    capabilities: PageBuilderAgenticAuthoringComponentCapability[];
+}
+interface PageBuilderAgenticAuthoringComponentCapabilitiesResult extends Omit<AgenticAuthoringComponentCapabilitiesResultContract, 'catalogs'> {
+    version: string;
+    catalogs: PageBuilderAgenticAuthoringComponentCapabilityCatalog[];
+}
+interface PageBuilderAgenticAuthoringIntentResolutionResult {
+    valid: boolean;
+    operationKind: string;
+    artifactKind: string;
+    changeKind: string;
+    authoringProfile: string;
+    targetApp: string;
+    targetComponentId: string;
+    target: PageBuilderAgenticAuthoringTarget | null;
+    selectedCandidate: PageBuilderAgenticAuthoringCandidate | null;
+    candidates: PageBuilderAgenticAuthoringCandidate[];
+    gate: PageBuilderAgenticAuthoringGateResult;
+    effectivePrompt?: string | null;
+    assistantMessage?: string | null;
+    quickReplies?: PageBuilderAgenticAuthoringQuickReply[];
+    pendingClarification?: PageBuilderAgenticAuthoringPendingClarification | null;
+    clarificationQuestions: string[];
+    warnings: string[];
+    failureCodes: string[];
+    currentPageSummary: unknown;
+    llmDiagnostics?: AiJsonObject | null;
+}
+interface PageBuilderMinimalFormPlanResult {
+    valid: boolean;
+    failureCodes: string[];
+    warnings: string[];
+    minimalFormPlan: unknown;
+}
+interface PageBuilderCompiledFormPatch {
+    profileId?: string;
+    catalogReleaseId?: string;
+    builderVersion?: string;
+    patch?: {
+        page?: BuilderPageDefinition;
+    };
+    [key: string]: unknown;
+}
+interface PageBuilderPreviewDiagnostics {
+    derivedCurrentPageSummary?: boolean;
+    targetWidgetKey?: string;
+    operationKind?: string;
+    changeKind?: string;
+    fieldScopeDecision?: string;
+}
+interface PageBuilderPreviewResult {
+    valid: boolean;
+    failureCodes: string[];
+    warnings: string[];
+    minimalFormPlan: unknown;
+    uiCompositionPlan?: unknown;
+    compiledFormPatch: PageBuilderCompiledFormPatch;
+    diagnostics?: PageBuilderPreviewDiagnostics | null;
+    assistantMessage?: string | null;
+}
+type PageBuilderAgenticAuthoringTurnStreamStartResponse = AgenticAuthoringTurnStreamStartResponseContract;
+type PageBuilderAgenticAuthoringTurnStreamEvent = AgenticAuthoringTurnStreamEnvelopeContract;
+interface PageBuilderApplyRequest {
+    compiledFormPatch: PageBuilderCompiledFormPatch;
+    componentId: string;
+    componentType?: string;
+    scope?: 'user' | 'tenant';
+    tags?: Record<string, unknown>;
+    ifMatch?: string;
+}
+interface PageBuilderApplyResult {
+    applied: boolean;
+    componentType: string;
+    componentId: string;
+    environment?: string;
+    scope: 'user' | 'tenant' | string;
+    version: number;
+    etag?: string;
+    payload: BuilderPageDefinition;
+    tags?: Record<string, unknown>;
+    warnings: string[];
+}
+declare const PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS: InjectionToken<PageBuilderAgenticAuthoringOptions>;
+declare class PageBuilderAgenticAuthoringService {
+    private readonly http;
+    private readonly options;
+    private readonly baseUrl;
+    private readonly headersFactory;
+    getComponentCapabilities(): Observable<PageBuilderAgenticAuthoringComponentCapabilitiesResult>;
+    previewPage(request: PageBuilderAgenticAuthoringPromptRequest): Observable<PageBuilderPreviewResult>;
+    resolveIntent(request: PageBuilderAgenticAuthoringIntentResolutionRequest): Observable<PageBuilderAgenticAuthoringIntentResolutionResult>;
+    searchResourceCandidates(request: PageBuilderAgenticAuthoringResourceCandidatesRequest): Observable<PageBuilderAgenticAuthoringResourceCandidatesResult>;
+    streamTurn(request: PageBuilderAgenticAuthoringTurnStreamRequest): Observable<PageBuilderAgenticAuthoringTurnStreamEvent>;
+    applyPage(request: PageBuilderApplyRequest): Observable<PageBuilderApplyResult>;
+    private buildHeaders;
+    private connectTurnStream;
+    private streamConnectionError;
+    private buildStreamUrl;
+    private createEventSource;
+    private formatEtag;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PageBuilderAgenticAuthoringService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<PageBuilderAgenticAuthoringService>;
+}
+
 type LegacyLayoutOptions = {
     cols?: number;
     rowHeight?: number;
@@ -567,6 +782,7 @@ type BuilderCanvasLayout = {
     rowUnit?: string;
     gap?: string;
     autoRows?: 'fixed' | 'content';
+    collisionPolicy?: 'block' | 'swap';
     items: Record<string, BuilderCanvasItem>;
 };
 type BuilderPageDefinition = Omit<WidgetPageDefinition, 'widgets'> & {
@@ -596,24 +812,56 @@ declare const PAGE_BUILDER_WIDGET_AI_CATALOGS: InjectionToken<Record<string, AiC
 
 declare function providePageBuilderWidgetAiCatalogs(): Provider;
 
+interface AgenticAuthoringQuickReply extends PraxisAssistantShellQuickReply {
+    kind: string;
+}
 declare class DynamicPageBuilderComponent implements OnChanges {
     private dialog;
     private settingsPanel;
     private readonly i18n;
     private readonly componentMetadata;
+    private readonly agenticAuthoring;
+    private readonly agenticTurnOrchestrator;
     runtime?: DynamicWidgetPageComponent;
     page?: WidgetPageDefinition | string;
     context?: Record<string, unknown> | null;
     strictValidation: boolean;
+    autoPersist: boolean;
     enableCustomization: boolean;
     showSettingsButton: boolean;
     pageIdentity?: PageIdentity;
     componentInstanceId?: string;
     pageEditorComponent: Type<any> | undefined;
+    enableAgenticAuthoring: boolean;
+    agenticAuthoringProvider?: string;
+    agenticAuthoringModel?: string;
+    agenticAuthoringApiKey?: string;
+    agenticAuthoringComponentId?: string;
+    agenticAuthoringScope: 'user' | 'tenant';
+    agenticAuthoringEtag?: string;
+    agenticAuthoringIncludeLlmDiagnostics: boolean;
+    agenticAuthoringEnableStreaming: boolean;
     pageChange: EventEmitter<WidgetPageDefinition>;
-    readonly currentPage: i0.WritableSignal<WidgetPageDefinition>;
-    readonly connectionsViewerOpen: i0.WritableSignal<boolean>;
+    agenticAuthoringApplied: EventEmitter<PageBuilderApplyResult>;
+    readonly currentPage: _angular_core.WritableSignal<WidgetPageDefinition>;
+    readonly connectionsViewerOpen: _angular_core.WritableSignal<boolean>;
+    readonly agenticAuthoringOpen: _angular_core.WritableSignal<boolean>;
+    readonly agenticAuthoringPrompt: _angular_core.WritableSignal<string>;
+    readonly agenticAuthoringBusy: _angular_core.WritableSignal<boolean>;
+    readonly agenticAuthoringStatus: _angular_core.WritableSignal<string>;
+    readonly agenticAuthoringError: _angular_core.WritableSignal<string>;
+    readonly agenticAuthoringPreviewResult: _angular_core.WritableSignal<PageBuilderPreviewResult | null>;
+    readonly agenticAuthoringLastEtag: _angular_core.WritableSignal<string | null>;
+    readonly agenticAuthoringConversation: _angular_core.WritableSignal<PraxisAssistantShellMessage[]>;
+    readonly agenticAuthoringQuickReplies: _angular_core.WritableSignal<AgenticAuthoringQuickReply[]>;
+    readonly agenticAuthoringAttachments: _angular_core.WritableSignal<PraxisAssistantShellAttachment[]>;
+    readonly agenticAuthoringLlmDiagnostics: _angular_core.WritableSignal<Record<string, unknown> | null>;
+    readonly agenticAuthoringEditingMessageId: _angular_core.WritableSignal<string | null>;
+    readonly agenticAuthoringPanelLayout: _angular_core.WritableSignal<PraxisAssistantShellLayout>;
     private previewMode;
+    private agenticComponentCapabilities?;
+    private agenticComponentCapabilitiesPromise?;
+    private agenticTurnController?;
     constructor(dialog: MatDialog, settingsPanel: SettingsPanelBridge | null);
     ngOnChanges(changes: SimpleChanges): void;
     showSettings(): boolean;
@@ -624,15 +872,50 @@ declare class DynamicPageBuilderComponent implements OnChanges {
     addWidget(type: string): void;
     openPageSettings(): void;
     saveCurrentPage(): void;
+    applyConfigFromAdapter(config: PageBuilderConfig): void;
+    private createAdapterHost;
+    toggleAgenticAuthoring(): void;
+    agenticAuthoringShellLabels(): Partial<PraxisAssistantShellLabels>;
+    agenticAuthoringShellState(): PraxisAssistantShellState;
+    agenticAuthoringContextItems(): PraxisAssistantShellContextItem[];
+    previewAgenticAuthoring(): Promise<void>;
+    submitAgenticQuickReply(reply: PraxisAssistantShellQuickReply): Promise<void>;
+    private agenticQuickReplyVisiblePrompt;
+    private isResourceQuickReply;
+    private describeResourceContext;
+    attachAgenticContext(): void;
+    addAgenticAttachments(attachments: readonly PraxisAssistantShellAttachment[]): void;
+    removeAgenticAttachment(attachment: PraxisAssistantShellAttachment): void;
+    editAgenticMessage(message: PraxisAssistantShellMessage): void;
+    resendAgenticMessage(message: PraxisAssistantShellMessage): Promise<void>;
+    persistAgenticAuthoring(): Promise<void>;
+    private loadAgenticComponentCapabilities;
+    private ensureAgenticTurnController;
+    private applyAgenticPreviewLocally;
+    private applyAgenticTurnState;
+    private consumeAgenticTurn;
+    agenticAuthoringDiagnosticsTop(): number;
+    agenticAuthoringLlmDiagnosticsText(): string;
+    private resolveAgenticLlmDiagnostics;
+    private toRecord;
+    private resolvePreviewCompiledFormPatch;
     focusCanvasWidget(widgetKey: string): void;
     private parsePage;
     private clonePage;
     private defaultInputsFor;
+    private resolveAgenticComponentId;
+    private resolveSelectedWidgetKey;
+    private formatAgenticFailures;
+    private describeAgenticPreviewFailure;
+    private describeAgenticPreviewStatus;
+    private isAgenticTableContractError;
+    private appendAgenticMessage;
+    private describeAgenticError;
     private cloneValue;
     tx(key: string, fallback: string): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DynamicPageBuilderComponent, [null, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DynamicPageBuilderComponent, "praxis-dynamic-page-builder", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "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; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
+    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; }; "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; }; }, { "pageChange": "pageChange"; "agenticAuthoringApplied": "agenticAuthoringApplied"; }, never, never, true, never>;
 }
 
-export { ComponentPaletteDialogComponent, ConfirmDialogComponent, DynamicPageBuilderComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, PAGE_BUILDER_AI_CAPABILITIES, PAGE_BUILDER_WIDGET_AI_CATALOGS, PLACEHOLDER, PageConfigEditorComponent, TileToolbarComponent, WidgetShellEditorComponent, clearWidgetAiCatalogs, getPageAiCatalog, getWidgetAiCapabilities, providePageBuilderWidgetAiCatalogs, registerWidgetAiCatalog, registerWidgetAiCatalogs };
-export type { Capability, CapabilityCatalog, CapabilityCategory, ComponentPaletteData, ConfirmDialogData, ValueKind };
+export { ComponentPaletteDialogComponent, ConfirmDialogComponent, DynamicPageBuilderComponent, DynamicPageConfigEditorComponent, FloatingToolbarComponent, PAGE_BUILDER_AGENTIC_AUTHORING_OPTIONS, PAGE_BUILDER_AI_CAPABILITIES, PAGE_BUILDER_WIDGET_AI_CATALOGS, PLACEHOLDER, PageBuilderAgenticAuthoringService, PageConfigEditorComponent, TileToolbarComponent, WidgetShellEditorComponent, clearWidgetAiCatalogs, getPageAiCatalog, getWidgetAiCapabilities, providePageBuilderWidgetAiCatalogs, registerWidgetAiCatalog, registerWidgetAiCatalogs };
+export type { Capability, CapabilityCatalog, CapabilityCategory, ComponentPaletteData, ConfirmDialogData, PageBuilderAgenticAuthoringAttachmentSummary, PageBuilderAgenticAuthoringCandidate, PageBuilderAgenticAuthoringComponentCapabilitiesResult, PageBuilderAgenticAuthoringComponentCapability, PageBuilderAgenticAuthoringComponentCapabilityCatalog, PageBuilderAgenticAuthoringComponentCapabilityExample, PageBuilderAgenticAuthoringComponentFieldAlias, PageBuilderAgenticAuthoringConversationMessage, PageBuilderAgenticAuthoringEventSource, PageBuilderAgenticAuthoringEventSourceFactory, PageBuilderAgenticAuthoringGateResult, PageBuilderAgenticAuthoringIntentResolutionRequest, PageBuilderAgenticAuthoringIntentResolutionResult, PageBuilderAgenticAuthoringOptions, PageBuilderAgenticAuthoringPendingClarification, PageBuilderAgenticAuthoringPromptRequest, PageBuilderAgenticAuthoringProvider, PageBuilderAgenticAuthoringQuickReply, PageBuilderAgenticAuthoringResourceCandidatesRequest, PageBuilderAgenticAuthoringResourceCandidatesResult, PageBuilderAgenticAuthoringTarget, PageBuilderAgenticAuthoringTurnStreamConnectionError, PageBuilderAgenticAuthoringTurnStreamEvent, PageBuilderAgenticAuthoringTurnStreamRequest, PageBuilderAgenticAuthoringTurnStreamStartResponse, PageBuilderApplyRequest, PageBuilderApplyResult, PageBuilderCompiledFormPatch, PageBuilderMinimalFormPlanResult, PageBuilderPreviewDiagnostics, PageBuilderPreviewResult, ValueKind };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "8.0.0-beta.0",
+  "version": "8.0.0-beta.11",
   "description": "Page and widget builder utilities for Praxis UI (grid, dynamic widgets, editors).",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
@@ -8,8 +8,9 @@
     "@angular/forms": "^20.0.0",
     "@angular/cdk": "^20.0.0",
     "@angular/material": "^20.0.0",
-    "@praxisui/core": "^8.0.0-beta.0",
-    "@praxisui/settings-panel": "^8.0.0-beta.0"
+    "@praxisui/ai": "^8.0.0-beta.11",
+    "@praxisui/core": "^8.0.0-beta.11",
+    "@praxisui/settings-panel": "^8.0.0-beta.11"
   },
   "dependencies": {
     "tslib": "^2.3.0"