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

package/index.d.ts

@@ -7,7 +7,7 @@ import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
 import { FormGroup, FormControl, FormArray } from '@angular/forms';
 import { SettingsValueProvider } from '@praxisui/settings-panel';
-import { AgenticAuthoringPlanRequestContract, AgenticAuthoringQuickReplyContract, AgenticAuthoringPendingClarificationContract, AgenticAuthoringAttachmentSummaryContract, AgenticAuthoringIntentResolutionRequestContract, AgenticAuthoringConversationMessageContract, PraxisAssistantShellMessage, PraxisAssistantShellQuickReply, PraxisAssistantShellAttachment, PraxisAssistantShellLayout, PraxisAssistantShellLabels, PraxisAssistantShellState, PraxisAssistantShellContextItem } from '@praxisui/ai';
+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;
 
@@ -545,6 +545,19 @@ 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;
@@ -560,11 +573,29 @@ interface PageBuilderAgenticAuthoringIntentResolutionRequest extends Omit<Agenti
     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 {
+interface PageBuilderAgenticAuthoringCandidate extends AgenticAuthoringCandidateContract {
     resourcePath: string;
     operation: string;
     schemaUrl: string;
@@ -573,6 +604,19 @@ interface PageBuilderAgenticAuthoringCandidate {
     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;
@@ -587,22 +631,28 @@ interface PageBuilderAgenticAuthoringGateResult {
     status: string;
     messages: string[];
 }
-interface PageBuilderAgenticAuthoringComponentFieldAlias {
+interface PageBuilderAgenticAuthoringComponentFieldAlias extends AgenticAuthoringComponentFieldAliasContract {
     field: string;
     aliases: string[];
 }
-interface PageBuilderAgenticAuthoringComponentCapability {
+interface PageBuilderAgenticAuthoringComponentCapability extends Omit<AgenticAuthoringComponentCapabilityContract, 'fieldAliases' | 'examples'> {
     id: string;
     changeKind: string;
     triggerTerms: string[];
     fieldAliases: PageBuilderAgenticAuthoringComponentFieldAlias[];
+    examples?: PageBuilderAgenticAuthoringComponentCapabilityExample[];
 }
-interface PageBuilderAgenticAuthoringComponentCapabilityCatalog {
+interface PageBuilderAgenticAuthoringComponentCapabilityExample extends AgenticAuthoringComponentCapabilityExampleContract {
+    prompt: string;
+    intent: string;
+    configHints: string[];
+}
+interface PageBuilderAgenticAuthoringComponentCapabilityCatalog extends Omit<AgenticAuthoringComponentCapabilityCatalogContract, 'capabilities'> {
     componentId: string;
     version: string;
     capabilities: PageBuilderAgenticAuthoringComponentCapability[];
 }
-interface PageBuilderAgenticAuthoringComponentCapabilitiesResult {
+interface PageBuilderAgenticAuthoringComponentCapabilitiesResult extends Omit<AgenticAuthoringComponentCapabilitiesResultContract, 'catalogs'> {
     version: string;
     catalogs: PageBuilderAgenticAuthoringComponentCapabilityCatalog[];
 }
@@ -626,6 +676,7 @@ interface PageBuilderAgenticAuthoringIntentResolutionResult {
     warnings: string[];
     failureCodes: string[];
     currentPageSummary: unknown;
+    llmDiagnostics?: AiJsonObject | null;
 }
 interface PageBuilderMinimalFormPlanResult {
     valid: boolean;
@@ -657,7 +708,10 @@ interface PageBuilderPreviewResult {
     uiCompositionPlan?: unknown;
     compiledFormPatch: PageBuilderCompiledFormPatch;
     diagnostics?: PageBuilderPreviewDiagnostics | null;
+    assistantMessage?: string | null;
 }
+type PageBuilderAgenticAuthoringTurnStreamStartResponse = AgenticAuthoringTurnStreamStartResponseContract;
+type PageBuilderAgenticAuthoringTurnStreamEvent = AgenticAuthoringTurnStreamEnvelopeContract;
 interface PageBuilderApplyRequest {
     compiledFormPatch: PageBuilderCompiledFormPatch;
     componentId: string;
@@ -687,8 +741,14 @@ declare class PageBuilderAgenticAuthoringService {
     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>;
@@ -753,7 +813,7 @@ declare const PAGE_BUILDER_WIDGET_AI_CATALOGS: InjectionToken<Record<string, AiC
 declare function providePageBuilderWidgetAiCatalogs(): Provider;
 
 interface AgenticAuthoringQuickReply extends PraxisAssistantShellQuickReply {
-    kind: 'confirm' | 'revise' | 'cancel' | 'suggestion';
+    kind: string;
 }
 declare class DynamicPageBuilderComponent implements OnChanges {
     private dialog;
@@ -779,6 +839,8 @@ declare class DynamicPageBuilderComponent implements OnChanges {
     agenticAuthoringComponentId?: string;
     agenticAuthoringScope: 'user' | 'tenant';
     agenticAuthoringEtag?: string;
+    agenticAuthoringIncludeLlmDiagnostics: boolean;
+    agenticAuthoringEnableStreaming: boolean;
     pageChange: EventEmitter<WidgetPageDefinition>;
     agenticAuthoringApplied: EventEmitter<PageBuilderApplyResult>;
     readonly currentPage: _angular_core.WritableSignal<WidgetPageDefinition>;
@@ -793,6 +855,7 @@ declare class DynamicPageBuilderComponent implements OnChanges {
     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;
@@ -817,6 +880,9 @@ declare class DynamicPageBuilderComponent implements OnChanges {
     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;
@@ -827,6 +893,11 @@ declare class DynamicPageBuilderComponent implements OnChanges {
     private ensureAgenticTurnController;
     private applyAgenticPreviewLocally;
     private applyAgenticTurnState;
+    private consumeAgenticTurn;
+    agenticAuthoringDiagnosticsTop(): number;
+    agenticAuthoringLlmDiagnosticsText(): string;
+    private resolveAgenticLlmDiagnostics;
+    private toRecord;
     private resolvePreviewCompiledFormPatch;
     focusCanvasWidget(widgetKey: string): void;
     private parsePage;
@@ -837,13 +908,14 @@ declare class DynamicPageBuilderComponent implements OnChanges {
     private formatAgenticFailures;
     private describeAgenticPreviewFailure;
     private describeAgenticPreviewStatus;
+    private isAgenticTableContractError;
     private appendAgenticMessage;
     private describeAgenticError;
     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; }; "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; }; }, { "pageChange": "pageChange"; "agenticAuthoringApplied": "agenticAuthoringApplied"; }, 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; }; "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_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, PageBuilderAgenticAuthoringComponentFieldAlias, PageBuilderAgenticAuthoringConversationMessage, PageBuilderAgenticAuthoringGateResult, PageBuilderAgenticAuthoringIntentResolutionRequest, PageBuilderAgenticAuthoringIntentResolutionResult, PageBuilderAgenticAuthoringOptions, PageBuilderAgenticAuthoringPendingClarification, PageBuilderAgenticAuthoringPromptRequest, PageBuilderAgenticAuthoringProvider, PageBuilderAgenticAuthoringQuickReply, PageBuilderAgenticAuthoringTarget, PageBuilderApplyRequest, PageBuilderApplyResult, PageBuilderCompiledFormPatch, PageBuilderMinimalFormPlanResult, PageBuilderPreviewDiagnostics, PageBuilderPreviewResult, ValueKind };
+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.1",
+  "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,9 +8,9 @@
     "@angular/forms": "^20.0.0",
     "@angular/cdk": "^20.0.0",
     "@angular/material": "^20.0.0",
-    "@praxisui/ai": "^8.0.0-beta.1",
-    "@praxisui/core": "^8.0.0-beta.1",
-    "@praxisui/settings-panel": "^8.0.0-beta.1"
+    "@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"