@praxisui/ai 8.0.0-beta.102 → 8.0.0-beta.104

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@praxisui/ai",
-  "version": "8.0.0-beta.102",
+  "version": "8.0.0-beta.104",
   "description": "AI building blocks and assistant integration for Praxis UI applications.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
-    "@praxisui/core": "^8.0.0-beta.102",
+    "@praxisui/core": "^8.0.0-beta.104",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",

package/types/praxisui-ai.d.ts

@@ -2,6 +2,7 @@ import * as i0 from '@angular/core';
 import { InjectionToken, OnDestroy, ElementRef, OnChanges, EventEmitter, SimpleChanges, OnInit, ChangeDetectorRef } from '@angular/core';
 import * as rxjs from 'rxjs';
 import { Observable } from 'rxjs';
+import { PraxisRuntimeComponentObservationEnvelope, PraxisRuntimeComponentObservationRegistryService } from '@praxisui/core';
 import { Schema } from '@google/generative-ai';
 import { ConnectedPosition, CdkOverlayOrigin } from '@angular/cdk/overlay';
 import * as _praxisui_ai from '@praxisui/ai';
@@ -18,7 +19,7 @@ declare class PraxisAi {
  * Do not edit manually. Run praxis-config-starter/tools/contracts/generate-ai-contract-bindings.js.
  */
 declare const AI_CONTRACT_VERSION: "v1.1";
-declare const AI_CONTRACT_SCHEMA_HASH: "41767dafdf6ebea802c083d77187ad6612937d6831188938dc21adce384b57a2";
+declare const AI_CONTRACT_SCHEMA_HASH: "daab9623a5c4d660105dfe1c85a6bd1ee1ef1b54ef5981e26d27c44aa82ddb4f";
 declare const AI_STREAM_EVENT_SCHEMA_VERSION: "v1";
 declare const AI_DOMAIN_CATALOG_CONTEXT_HINT_SCHEMA_VERSION: "praxis.ai.context-hints.domain-catalog/v0.2";
 declare const AI_STREAM_EVENT_TYPES: readonly ["status", "thought.step", "heartbeat", "result", "error", "cancelled"];
@@ -281,7 +282,9 @@ interface AgenticAuthoringQuickReplyContract {
     icon?: string | null;
     tone?: string | null;
     contextHints?: AiContextHintsContract | null;
-    [key: string]: AiJsonValue | AiContextHintsContract | undefined;
+    semanticDecision?: AgenticAuthoringSemanticDecisionContract | null;
+    value?: AiJsonObject | AiJsonValue | null;
+    [key: string]: AiJsonValue | AiContextHintsContract | AgenticAuthoringSemanticDecisionContract | null | undefined;
 }
 interface AgenticAuthoringSemanticSelectedResourceContract {
     resourcePath?: string | null;
@@ -442,7 +445,10 @@ interface AgenticAuthoringTurnStreamRequestContract extends AgenticAuthoringConv
     contextHints?: AiContextHintsContract | null;
     componentCapabilities?: AgenticAuthoringComponentCapabilitiesResultContract | null;
     activeSemanticDecision?: AgenticAuthoringSemanticDecisionContract | null;
-    [key: string]: AiJsonValue | AiContextHintsContract | AgenticAuthoringComponentCapabilitiesResultContract | AgenticAuthoringSemanticDecisionContract | AgenticAuthoringConversationMessageContract[] | AgenticAuthoringPendingClarificationContract | AgenticAuthoringAttachmentSummaryContract[] | undefined;
+    diagnostics?: AiJsonObject | null;
+    runtimeComponentObservations?: unknown[] | null;
+    runtimeComponentObservationTrustBoundary?: 'untrusted_frontend_observation' | null;
+    [key: string]: AiJsonValue | AiContextHintsContract | AgenticAuthoringComponentCapabilitiesResultContract | AgenticAuthoringSemanticDecisionContract | AgenticAuthoringConversationMessageContract[] | AgenticAuthoringPendingClarificationContract | AgenticAuthoringAttachmentSummaryContract[] | unknown[] | undefined;
 }
 interface AgenticAuthoringPreviewResultContract {
     valid?: boolean;
@@ -1103,6 +1109,7 @@ interface PraxisAssistantClarificationOption {
     id: string;
     label: string;
     value: string;
+    rawValue?: unknown;
     description?: string;
     displayPrompt?: string;
     example?: string;
@@ -1125,6 +1132,7 @@ interface PraxisAssistantTurnAction {
     value?: unknown;
     displayPrompt?: string;
     contextHints?: Record<string, unknown>;
+    activeSemanticDecision?: Record<string, unknown>;
 }
 interface PraxisAssistantPendingClarification {
     sourcePrompt: string;
@@ -1158,11 +1166,13 @@ interface PraxisAssistantTurnRequest {
     schemaFields?: unknown;
     dataProfile?: unknown;
     contextHints?: Record<string, unknown>;
+    activeSemanticDecision?: Record<string, unknown>;
     preview?: unknown;
     pendingPatch?: unknown;
     pendingClarification?: PraxisAssistantPendingClarification;
     diagnostics?: Record<string, unknown>;
     observationId?: string | null;
+    runtimeComponentObservations?: readonly PraxisRuntimeComponentObservationEnvelope[];
 }
 interface PraxisAssistantTurnResult {
     state: PraxisAssistantShellState;
@@ -1455,7 +1465,7 @@ declare class PraxisAiService {
 }
 
 declare const AI_INTENT_CONTRACT_VERSION: "v1.1";
-declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "41767dafdf6ebea802c083d77187ad6612937d6831188938dc21adce384b57a2";
+declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "daab9623a5c4d660105dfe1c85a6bd1ee1ef1b54ef5981e26d27c44aa82ddb4f";
 type AiSchemaContext = AiSchemaContextContract;
 interface AiSuggestionsRequest {
     componentId: string;
@@ -1493,7 +1503,13 @@ type AgenticAuthoringResolveTargetRequest = AgenticAuthoringResolveTargetRequest
 type AgenticAuthoringResolvedTarget = AgenticAuthoringResolvedTargetContract;
 type AgenticAuthoringManifestValidationResult = AgenticAuthoringManifestValidationResultContract;
 type AgenticAuthoringManifestCompileResult = AgenticAuthoringManifestCompileResultContract;
-type AgenticAuthoringTurnStreamRequest = AgenticAuthoringTurnStreamRequestContract;
+type WithoutStringIndex<T> = {
+    [K in keyof T as string extends K ? never : K]: T[K];
+};
+type AgenticAuthoringTurnStreamRequest = WithoutStringIndex<AgenticAuthoringTurnStreamRequestContract> & Record<string, unknown> & {
+    runtimeComponentObservations?: readonly PraxisRuntimeComponentObservationEnvelope[] | readonly unknown[] | null;
+    runtimeComponentObservationTrustBoundary?: 'untrusted_frontend_observation' | null;
+};
 type AgenticAuthoringTurnStreamStartResponse = AgenticAuthoringTurnStreamStartResponseContract;
 type AgenticAuthoringTurnStreamEnvelope<TPayload extends AiJsonObject = AiJsonObject> = AgenticAuthoringTurnStreamEnvelopeContract<TPayload>;
 interface AiPatchStreamConnection {
@@ -1717,15 +1733,23 @@ interface AgenticAuthoringTurnLifecycleEvent {
 type AgenticAuthoringTurnClientEvent = AgenticAuthoringTurnStreamStartedEvent | AgenticAuthoringTurnLifecycleEvent | AgenticAuthoringTurnStreamEnvelopeEvent;
 declare class AgenticAuthoringTurnClientService {
     private readonly aiApi;
-    streamEvents(request: AgenticAuthoringTurnStreamRequestContract, options?: AgenticAuthoringTurnClientOptions): Observable<AgenticAuthoringTurnClientEvent>;
-    streamTurn(request: AgenticAuthoringTurnStreamRequestContract, options?: AgenticAuthoringTurnClientOptions): Observable<PraxisAssistantTurnResult>;
+    private readonly runtimeObservationRegistry;
+    streamEvents(request: AgenticAuthoringTurnStreamRequest, options?: AgenticAuthoringTurnClientOptions): Observable<AgenticAuthoringTurnClientEvent>;
+    streamTurn(request: AgenticAuthoringTurnStreamRequest, options?: AgenticAuthoringTurnClientOptions): Observable<PraxisAssistantTurnResult>;
     toTurnResult(event: AgenticAuthoringTurnStreamEnvelopeContract): PraxisAssistantTurnResult;
+    private withRuntimeObservationTrustBoundary;
+    private collectRuntimeComponentObservations;
+    private isRuntimeComponentObservationEnvelopeLike;
+    private startAuthoringTurnStream;
+    private isPromiseLike;
     private toResultTurn;
     private toShellQuickReplies;
     private toPendingClarification;
     private phaseForPayload;
     private statusForPayload;
     private resultDiagnostics;
+    private runtimeRelatedSurfaceDisambiguationContext;
+    private runtimeRelatedSurfaceDisambiguationPageId;
     private toLifecycleEvent;
     private silenceStatusEvent;
     private resultTimeoutEvent;
@@ -1781,6 +1805,7 @@ interface PraxisAssistantTurnControllerOptions {
     contextHints?: Record<string, unknown>;
 }
 declare class PraxisAssistantTurnOrchestratorService {
+    private readonly runtimeObservationRegistry;
     createController(flow: PraxisAssistantTurnFlow, options?: PraxisAssistantTurnControllerOptions): PraxisAssistantTurnController;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisAssistantTurnOrchestratorService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<PraxisAssistantTurnOrchestratorService>;
@@ -1788,10 +1813,11 @@ declare class PraxisAssistantTurnOrchestratorService {
 declare class PraxisAssistantTurnController {
     private readonly flow;
     private readonly options;
+    private readonly runtimeObservationRegistry;
     private readonly stateSubject;
     readonly state$: Observable<PraxisAssistantTurnViewState>;
     private activeFlowClientTurnId;
-    constructor(flow: PraxisAssistantTurnFlow, options: PraxisAssistantTurnControllerOptions);
+    constructor(flow: PraxisAssistantTurnFlow, options: PraxisAssistantTurnControllerOptions, runtimeObservationRegistry: PraxisRuntimeComponentObservationRegistryService | null);
     snapshot(): PraxisAssistantTurnViewState;
     setContextHints(hints: Record<string, unknown> | undefined): void;
     setContextItems(items: readonly PraxisAssistantShellContextItem[]): void;
@@ -1809,7 +1835,10 @@ declare class PraxisAssistantTurnController {
     retry(): Observable<PraxisAssistantTurnViewState>;
     cancel(): Observable<PraxisAssistantTurnViewState>;
     private runFlow;
+    private invokeFlow;
     private buildRequest;
+    private collectRuntimeComponentObservations;
+    private isPromiseLike;
     private submitExistingUserMessage;
     private findUserMessageIndex;
     private resetReplayState;
@@ -2476,6 +2505,7 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     protected getRecommendedIntentTone(intent: PraxisAssistantRecommendedIntent): string;
     protected getRecommendedIntentGroupLabel(intent: PraxisAssistantRecommendedIntent): string;
     protected getQuickReplyAriaLabel(reply: PraxisAssistantShellQuickReply): string;
+    protected getQuickReplyLabel(reply: PraxisAssistantShellQuickReply): string;
     protected getQuickReplyTechnicalDetails(reply: PraxisAssistantShellQuickReply): string;
     protected isRichQuickReply(reply: PraxisAssistantShellQuickReply): boolean;
     protected shouldUseInlineQuickReplies(): boolean;
@@ -2494,6 +2524,7 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     private hasQuickReplyResourceContext;
     private isFieldDiscoveryQuickReply;
     protected isContextualPreviewActionQuickReply(reply: PraxisAssistantShellQuickReply): boolean;
+    protected isSourceReviewQuickReply(reply: PraxisAssistantShellQuickReply): boolean;
     protected isGuidedActionQuickReply(reply: PraxisAssistantShellQuickReply): boolean;
     private quickReplyPresentation;
     private quickReplyPresentationKind;
@@ -2503,7 +2534,9 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     private trimSentencePunctuation;
     private shortPathLabel;
     private shortTechnicalLabel;
+    private friendlyTechnicalLabel;
     protected getCloseIcon(): string;
+    protected getContextItemValue(item: PraxisAssistantShellContextItem): string;
     private normalizeShellAction;
     protected onRemoveAttachment(attachment: PraxisAssistantShellAttachment): void;
     protected onMessageAction(message: PraxisAssistantShellMessage, action: PraxisAssistantShellMessageAction): void;