@praxisui/page-builder 8.0.0-beta.12 → 8.0.0-beta.14

package/fesm2022/praxisui-page-builder.mjs

@@ -5081,7 +5081,7 @@ class PageBuilderAgenticAuthoringService {
         return this.http.post(`${this.baseUrl}/resource-candidates`, request, { headers: this.buildHeaders() });
     }
     streamTurn(request) {
-        return this.http.post(`${this.baseUrl}/turn/stream/start`, request, { headers: this.buildHeaders() }).pipe(switchMap((start) => this.connectTurnStream(start)));
+        return this.http.post(`${this.baseUrl}/turn/stream/start`, request, { headers: this.buildHeaders(), withCredentials: true }).pipe(switchMap((start) => this.connectTurnStream(start)));
     }
     applyPage(request) {
         const { ifMatch, ...body } = request;
@@ -5115,17 +5115,14 @@ class PageBuilderAgenticAuthoringService {
     connectTurnStream(start) {
         return new Observable((observer) => {
             const url = this.buildStreamUrl(start);
-            let source;
+            const probeUrl = this.buildStreamProbeUrl(start);
+            let source = null;
             let closed = false;
             let connectionErrorTimer = null;
             const connectionErrorGraceMs = Math.max(0, this.options?.streamConnectionErrorGraceMs ?? 1500);
-            try {
-                source = this.createEventSource(url);
-            }
-            catch (error) {
-                observer.error(this.streamConnectionError(error));
-                return undefined;
-            }
+            let probeAbort = typeof AbortController !== 'undefined'
+                ? new AbortController()
+                : null;
             const clearConnectionErrorTimer = () => {
                 if (connectionErrorTimer) {
                     clearTimeout(connectionErrorTimer);
@@ -5138,7 +5135,7 @@ class PageBuilderAgenticAuthoringService {
                 }
                 closed = true;
                 clearConnectionErrorTimer();
-                source.close();
+                source?.close();
             };
             const failConnection = (event) => {
                 if (closed) {
@@ -5162,23 +5159,58 @@ class PageBuilderAgenticAuthoringService {
                     closeSource();
                 }
             };
-            source.onmessage = handleMessage;
-            if (source.addEventListener) {
-                for (const type of AI_STREAM_EVENT_TYPES) {
-                    source.addEventListener(type, handleMessage);
+            void this.probeTurnStreamEndpoint(probeUrl, probeAbort)
+                .then((status) => {
+                probeAbort = null;
+                if (closed) {
+                    return;
                 }
-            }
-            source.onerror = (event) => {
-                if (closed || connectionErrorTimer) {
+                if (typeof status === 'number' && status >= 400) {
+                    closed = true;
+                    observer.error(this.streamConnectionError({ status }));
+                    return;
+                }
+                try {
+                    source = this.createEventSource(url);
+                }
+                catch (error) {
+                    closed = true;
+                    observer.error(this.streamConnectionError(error));
                     return;
                 }
-                if (connectionErrorGraceMs === 0) {
-                    failConnection(event);
+                source.onmessage = handleMessage;
+                if (source.addEventListener) {
+                    for (const type of AI_STREAM_EVENT_TYPES) {
+                        source.addEventListener(type, handleMessage);
+                    }
+                }
+                source.onerror = (event) => {
+                    if (closed || connectionErrorTimer) {
+                        return;
+                    }
+                    if (connectionErrorGraceMs === 0) {
+                        failConnection(event);
+                        return;
+                    }
+                    connectionErrorTimer = setTimeout(() => failConnection(event), connectionErrorGraceMs);
+                };
+            })
+                .catch((error) => {
+                if (closed) {
                     return;
                 }
-                connectionErrorTimer = setTimeout(() => failConnection(event), connectionErrorGraceMs);
+                closed = true;
+                observer.error(this.streamConnectionError(error));
+            });
+            return () => {
+                probeAbort?.abort();
+                if (source) {
+                    closeSource();
+                    return;
+                }
+                closed = true;
+                clearConnectionErrorTimer();
             };
-            return () => closeSource();
         });
     }
     streamConnectionError(cause) {
@@ -5196,6 +5228,15 @@ class PageBuilderAgenticAuthoringService {
             ? url.toString()
             : url.pathname + url.search;
     }
+    buildStreamProbeUrl(start) {
+        const url = new URL(`${this.baseUrl}/turn/stream/${start.streamId}/probe`, typeof window !== 'undefined' ? window.location.origin : 'http://localhost');
+        if (start.streamAccessToken) {
+            url.searchParams.set('accessToken', start.streamAccessToken);
+        }
+        return /^https?:\/\//i.test(this.baseUrl)
+            ? url.toString()
+            : url.pathname + url.search;
+    }
     createEventSource(url) {
         const factory = this.options?.eventSourceFactory;
         if (factory) {
@@ -5203,6 +5244,18 @@ class PageBuilderAgenticAuthoringService {
         }
         return new EventSource(url);
     }
+    async probeTurnStreamEndpoint(url, abort) {
+        if (typeof fetch === 'undefined') {
+            return null;
+        }
+        const response = await fetch(url, {
+            method: 'GET',
+            credentials: 'include',
+            cache: 'no-store',
+            signal: abort?.signal,
+        });
+        return response.status;
+    }
     formatEtag(etag) {
         const trimmed = etag.trim();
         return trimmed.startsWith('"') ? trimmed : `"${trimmed}"`;
@@ -5310,7 +5363,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
                     } }],
             validators: ['widget-page-definition-valid', 'no-legacy-grid-page-definition', 'page-context-json-valid', 'settings-panel-round-trip-valid'],
             affectedPaths: ['title', 'layoutPreset', 'context', 'metadata'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['page-loaded'],
         },
         {
@@ -5330,7 +5383,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
                     } }],
             validators: ['canvas-columns-integer', 'canvas-row-unit-valid', 'canvas-gap-valid', 'canvas-items-reference-existing-widgets'],
             affectedPaths: ['canvas.columns', 'canvas.rowUnit', 'canvas.gap', 'canvas.items'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['page-loaded'],
         },
         {
@@ -5350,7 +5403,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
                     } }],
             validators: ['widget-key-unique', 'component-registered', 'canvas-item-valid', 'child-inputs-delegated', 'widget-key-not-array-index'],
             affectedPaths: ['widgets[]', 'canvas.items[]'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['page-loaded', 'component-catalog-loaded'],
         },
         {
@@ -5371,7 +5424,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
             requiresConfirmation: true,
             validators: ['widget-exists', 'destructive-removal-confirmed', 'composition-links-cleaned', 'canvas-items-reference-existing-widgets'],
             affectedPaths: ['widgets[]', 'canvas.items[]', 'composition.links[]'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['page-loaded', 'target-widget-exists'],
         },
         {
@@ -5390,7 +5443,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
                     } }],
             validators: ['widget-exists', 'canvas-item-valid', 'canvas-item-targets-existing-widget', 'canvas-overlap-policy-valid'],
             affectedPaths: ['canvas.items[]'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['page-loaded', 'target-widget-exists'],
         },
         {
@@ -5409,7 +5462,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
                     } }],
             validators: ['widget-exists', 'widget-shell-shape-valid', 'settings-panel-bridge-available', 'child-inputs-not-mutated'],
             affectedPaths: ['widgets[].shell'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['page-loaded', 'target-widget-exists'],
         },
         {
@@ -5429,7 +5482,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
                     } }],
             validators: ['composition-link-id-unique', 'composition-endpoints-resolve', 'nested-path-terminal-widget-key-required', 'json-logic-condition-valid', 'no-legacy-connections-write'],
             affectedPaths: ['composition.links[]'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['page-loaded', 'widgets-resolvable'],
         },
         {
@@ -5450,7 +5503,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
             requiresConfirmation: true,
             validators: ['composition-link-exists', 'destructive-removal-confirmed', 'composition-links-still-valid'],
             affectedPaths: ['composition.links[]'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['page-loaded', 'target-link-exists'],
         },
         {
@@ -5469,7 +5522,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
                     } }],
             validators: ['ui-composition-plan-valid', 'compiled-page-valid', 'widget-keys-unique', 'composition-endpoints-resolve', 'canvas-items-reference-existing-widgets'],
             affectedPaths: ['uiCompositionPlan', 'compiledFormPatch.patch.page'],
-            submissionImpact: false,
+            submissionImpact: 'none',
             preconditions: ['agentic-preview-loaded', 'component-catalog-loaded'],
         },
         {
@@ -5488,7 +5541,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
                     } }],
             validators: ['state-path-valid', 'state-layer-valid', 'state-json-valid', 'composition-state-links-still-valid'],
             affectedPaths: ['state'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['page-loaded'],
         },
         {
@@ -5507,7 +5560,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
                     } }],
             validators: ['preview-result-valid', 'compiled-page-patch-present', 'no-envelope-runtime-persistence', 'runtime-page-valid'],
             affectedPaths: ['compiledFormPatch.patch.page', 'page'],
-            submissionImpact: false,
+            submissionImpact: 'visual-only',
             preconditions: ['agentic-preview-loaded'],
         },
         {
@@ -5526,7 +5579,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
                     } }],
             validators: ['page-identity-complete', 'etag-policy-valid', 'runtime-page-valid', 'no-envelope-runtime-persistence'],
             affectedPaths: ['page', 'pageIdentity', 'etag'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['page-loaded', 'page-identity-known'],
         },
         {
@@ -5546,7 +5599,7 @@ const PRAXIS_PAGE_BUILDER_AUTHORING_MANIFEST = {
                     } }],
             validators: ['widget-exists', 'child-manifest-available', 'child-operation-known', 'component-config-editor-respected', 'no-local-child-input-write'],
             affectedPaths: ['widgets[].definition.inputs'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['page-loaded', 'target-widget-exists', 'child-authoring-contract-available'],
         },
     ],

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, 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';
+import { AgenticAuthoringPlanRequestContract, AgenticAuthoringCandidateContract, AiJsonValue, AgenticAuthoringQuickReplyContract, AgenticAuthoringPendingClarificationContract, AiJsonObject, AgenticAuthoringComponentCapabilitiesResultContract, AgenticAuthoringComponentCapabilityCatalogContract, AgenticAuthoringComponentCapabilityContract, AgenticAuthoringComponentFieldAliasContract, AgenticAuthoringComponentCapabilityExampleContract, AgenticAuthoringAttachmentSummaryContract, AgenticAuthoringIntentResolutionRequestContract, AgenticAuthoringConversationMessageContract, AiContextHintsContract, AgenticAuthoringResourceCandidatesRequestContract, AgenticAuthoringResourceCandidatesResultContract, AgenticAuthoringTurnStreamStartResponseContract, AgenticAuthoringTurnStreamEnvelopeContract, PraxisAssistantShellMessage, PraxisAssistantShellQuickReply, PraxisAssistantShellAttachment, PraxisAssistantShellLayout, PraxisAssistantShellLabels, PraxisAssistantShellState, PraxisAssistantShellContextItem } from '@praxisui/ai';
 
 declare const PLACEHOLDER = 1;
 
@@ -589,7 +589,7 @@ interface PageBuilderAgenticAuthoringTurnStreamRequest {
     pendingClarification?: PageBuilderAgenticAuthoringPendingClarification | null;
     componentCapabilities?: PageBuilderAgenticAuthoringComponentCapabilitiesResult | null;
     attachmentSummaries?: PageBuilderAgenticAuthoringAttachmentSummary[];
-    contextHints?: AiJsonObject | null;
+    contextHints?: AiContextHintsContract | null;
 }
 type PageBuilderAgenticAuthoringConversationMessage = AgenticAuthoringConversationMessageContract;
 type PageBuilderAgenticAuthoringPendingClarification = AgenticAuthoringPendingClarificationContract;
@@ -748,7 +748,9 @@ declare class PageBuilderAgenticAuthoringService {
     private connectTurnStream;
     private streamConnectionError;
     private buildStreamUrl;
+    private buildStreamProbeUrl;
     private createEventSource;
+    private probeTurnStreamEndpoint;
     private formatEtag;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PageBuilderAgenticAuthoringService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<PageBuilderAgenticAuthoringService>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "8.0.0-beta.12",
+  "version": "8.0.0-beta.14",
   "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.12",
-    "@praxisui/core": "^8.0.0-beta.12",
-    "@praxisui/settings-panel": "^8.0.0-beta.12"
+    "@praxisui/ai": "^8.0.0-beta.14",
+    "@praxisui/core": "^8.0.0-beta.14",
+    "@praxisui/settings-panel": "^8.0.0-beta.14"
   },
   "dependencies": {
     "tslib": "^2.3.0"