@praxisui/ai 8.0.0-beta.103 → 8.0.0-beta.105

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@praxisui/ai",
-  "version": "8.0.0-beta.103",
+  "version": "8.0.0-beta.105",
   "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.103",
+    "@praxisui/core": "^8.0.0-beta.105",
     "@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;
@@ -845,6 +851,7 @@ interface PraxisAssistantShellMessage {
     id: string;
     role: PraxisAssistantShellMessageRole;
     text: string;
+    assistantContent?: Readonly<Record<string, unknown>> | null;
     status?: 'pending' | 'done' | 'error';
     editable?: boolean;
     resendable?: boolean;
@@ -1103,6 +1110,7 @@ interface PraxisAssistantClarificationOption {
     id: string;
     label: string;
     value: string;
+    rawValue?: unknown;
     description?: string;
     displayPrompt?: string;
     example?: string;
@@ -1125,6 +1133,7 @@ interface PraxisAssistantTurnAction {
     value?: unknown;
     displayPrompt?: string;
     contextHints?: Record<string, unknown>;
+    activeSemanticDecision?: Record<string, unknown>;
 }
 interface PraxisAssistantPendingClarification {
     sourcePrompt: string;
@@ -1158,16 +1167,19 @@ 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;
     phase?: PraxisAssistantTurnPhase;
     assistantMessage?: string;
+    assistantContent?: Readonly<Record<string, unknown>> | null;
     messages?: readonly PraxisAssistantShellMessage[];
     quickReplies?: readonly PraxisAssistantShellQuickReply[];
     clarificationQuestions?: readonly PraxisAssistantClarificationQuestion[];
@@ -1455,7 +1467,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 +1505,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 {
@@ -1514,6 +1532,7 @@ interface AgenticAuthoringTurnStreamLifecycle {
 }
 interface AgenticAuthoringTurnStreamConnectionOptions {
     baseUrl?: string;
+    headers?: Record<string, string | undefined>;
     onLifecycle?: (event: AgenticAuthoringTurnStreamLifecycle) => void;
 }
 interface AgenticAuthoringTurnStreamStartOptions {
@@ -1687,6 +1706,8 @@ declare class AiBackendApiService {
     private consumeBufferedSseFrames;
     private findSseFrameBoundary;
     private probePatchStreamEndpoint;
+    private buildFetchHeaders;
+    private hasExplicitHeaders;
     static ɵfac: i0.ɵɵFactoryDeclaration<AiBackendApiService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AiBackendApiService>;
 }
@@ -1717,15 +1738,24 @@ 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>;
-    toTurnResult(event: AgenticAuthoringTurnStreamEnvelopeContract): PraxisAssistantTurnResult;
+    private readonly runtimeObservationRegistry;
+    streamEvents(request: AgenticAuthoringTurnStreamRequest, options?: AgenticAuthoringTurnClientOptions): Observable<AgenticAuthoringTurnClientEvent>;
+    streamTurn(request: AgenticAuthoringTurnStreamRequest, options?: AgenticAuthoringTurnClientOptions): Observable<PraxisAssistantTurnResult>;
+    toTurnResult(event: AgenticAuthoringTurnStreamEnvelopeContract, clientTurnId?: string | null): PraxisAssistantTurnResult;
+    private withRuntimeObservationTrustBoundary;
+    private collectRuntimeComponentObservations;
+    private isRuntimeComponentObservationEnvelopeLike;
+    private startAuthoringTurnStream;
+    private isPromiseLike;
     private toResultTurn;
+    private isConsultativeCatalogAnswer;
     private toShellQuickReplies;
     private toPendingClarification;
     private phaseForPayload;
     private statusForPayload;
     private resultDiagnostics;
+    private runtimeRelatedSurfaceDisambiguationContext;
+    private runtimeRelatedSurfaceDisambiguationPageId;
     private toLifecycleEvent;
     private silenceStatusEvent;
     private resultTimeoutEvent;
@@ -1781,6 +1811,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 +1819,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 +1841,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;
@@ -2345,6 +2380,21 @@ interface QuickReplyContextChip {
     value: string;
     ariaLabel: string;
 }
+type AssistantContentBlock = Readonly<Record<string, unknown>>;
+interface AssistantContentResourceField {
+    name: string;
+    label: string;
+    description: string;
+}
+interface AssistantContentResource {
+    id: string;
+    label: string;
+    description: string;
+    role: string;
+    resourcePath: string;
+    fields: readonly AssistantContentResourceField[];
+    evidence: readonly string[];
+}
 declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     labels: Partial<PraxisAssistantShellLabels> | null;
     mode: PraxisAssistantShellMode;
@@ -2446,6 +2496,20 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     protected onAttachmentFilesSelected(event: Event): void;
     protected onApply(): void;
     protected renderMessageText(text: string | null | undefined): string;
+    protected hasStructuredAssistantContent(message: PraxisAssistantShellMessage): boolean;
+    protected getAssistantContentBlocks(message: PraxisAssistantShellMessage): readonly AssistantContentBlock[];
+    protected getAssistantContentBlockType(block: AssistantContentBlock): string;
+    protected getAssistantContentBlockTitle(block: AssistantContentBlock, fallback?: string): string;
+    protected getAssistantContentBlockText(block: AssistantContentBlock): string;
+    protected getAssistantContentResources(block: AssistantContentBlock): readonly AssistantContentResource[];
+    protected getAssistantContentResourceFields(resource: Record<string, unknown>): readonly AssistantContentResourceField[];
+    protected getAssistantContentResourceMeta(resource: AssistantContentResource): readonly string[];
+    protected trackAssistantContentBlock(index: number, block: AssistantContentBlock): string;
+    protected trackAssistantContentResource(index: number, resource: AssistantContentResource): string;
+    protected trackAssistantContentField(index: number, field: AssistantContentResourceField): string;
+    protected trackAssistantContentValue(_index: number, value: string): string;
+    private isSupportedAssistantContentBlock;
+    private getStringArray;
     private renderInlineMarkdown;
     private escapeHtml;
     protected shouldShowStatusText(): boolean;
@@ -2476,6 +2540,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;
@@ -2491,9 +2556,12 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     private asRecord;
     private stringHint;
     private quickReplyHint;
+    private quickReplyPublicResourceLabel;
+    private isPublicDisplayText;
     private hasQuickReplyResourceContext;
     private isFieldDiscoveryQuickReply;
     protected isContextualPreviewActionQuickReply(reply: PraxisAssistantShellQuickReply): boolean;
+    protected isSourceReviewQuickReply(reply: PraxisAssistantShellQuickReply): boolean;
     protected isGuidedActionQuickReply(reply: PraxisAssistantShellQuickReply): boolean;
     private quickReplyPresentation;
     private quickReplyPresentationKind;
@@ -2502,8 +2570,12 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     private isGenericContextualActionDescription;
     private trimSentencePunctuation;
     private shortPathLabel;
+    private knownPublicResourceLabel;
     private shortTechnicalLabel;
+    private friendlyTechnicalLabel;
+    private normalizePortugueseDisplayText;
     protected getCloseIcon(): string;
+    protected getContextItemValue(item: PraxisAssistantShellContextItem): string;
     private normalizeShellAction;
     protected onRemoveAttachment(attachment: PraxisAssistantShellAttachment): void;
     protected onMessageAction(message: PraxisAssistantShellMessage, action: PraxisAssistantShellMessageAction): void;