@praxisui/ai 8.0.0-beta.2 → 8.0.0-beta.20

package/index.d.ts

@@ -18,8 +18,9 @@ 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: "922e6d48637e64b403562d6d7cb833ed4942ffb0b452ec3573255871f4ec8739";
+declare const AI_CONTRACT_SCHEMA_HASH: "42af43aec91777def176def87d2f41d30c8dbc8abb6c21dc38b5e181a1a51f4f";
 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"];
 type AiJsonPrimitive = string | number | boolean | null;
 type AiJsonArray = AiJsonValue[];
@@ -27,6 +28,41 @@ interface AiJsonObject {
     [key: string]: AiJsonValue;
 }
 type AiJsonValue = AiJsonPrimitive | AiJsonObject | AiJsonArray;
+type AiDomainCatalogContextHintItemType = 'context' | 'node' | 'edge' | 'binding' | 'evidence' | 'governance' | 'vocabulary' | 'relationship';
+type AiDomainCatalogContextHintIntent = 'authoring' | 'explain' | 'validate' | 'ai-access-control';
+type AiDomainCatalogRecommendedAuthoringFlow = 'shared_rule_authoring' | 'component_authoring' | 'ui_composition_authoring';
+type AiDomainCatalogRecommendedRuleType = 'privacy' | 'compliance' | 'validation' | 'selection_eligibility' | 'workflow_action_policy' | 'approval_policy' | string;
+interface AiDomainCatalogRelationshipHintContract {
+    enabled?: boolean;
+    federated?: boolean;
+    serviceKey?: string | null;
+    sourceNodeKey?: string | null;
+    targetNodeKey?: string | null;
+    edgeType?: string | null;
+    query?: string | null;
+    limit?: number;
+}
+interface AiDomainCatalogContextHintContract {
+    schemaVersion?: typeof AI_DOMAIN_CATALOG_CONTEXT_HINT_SCHEMA_VERSION;
+    serviceKey?: string;
+    resourceKey?: string | null;
+    releaseId?: string | null;
+    releaseKey?: string | null;
+    type?: AiDomainCatalogContextHintItemType;
+    itemTypes?: AiDomainCatalogContextHintItemType[];
+    intent?: AiDomainCatalogContextHintIntent | null;
+    query?: string | null;
+    contextKey?: string | null;
+    nodeType?: string | null;
+    recommendedAuthoringFlow?: AiDomainCatalogRecommendedAuthoringFlow | null;
+    recommendedRuleType?: AiDomainCatalogRecommendedRuleType | null;
+    limit?: number;
+    relationships?: AiDomainCatalogRelationshipHintContract | null;
+}
+interface AiContextHintsContract {
+    domainCatalog?: AiDomainCatalogContextHintContract;
+    [key: string]: AiJsonValue | AiDomainCatalogContextHintContract | undefined;
+}
 interface AiSchemaContextContract {
     path?: string | null;
     operation?: string | null;
@@ -64,7 +100,7 @@ interface AiOrchestratorRequestContract {
     schemaFields?: AiJsonObject[] | null;
     runtimeState?: AiJsonObject | null;
     suggestedPatch?: AiJsonObject | null;
-    contextHints?: AiJsonObject | null;
+    contextHints?: AiContextHintsContract | null;
     aiMode?: string;
     requireSchema?: boolean;
     resourcePath?: string;
@@ -86,7 +122,7 @@ interface AiOptionContract {
     value?: string | null;
     label?: string | null;
     example?: string | null;
-    contextHints?: AiJsonObject | null;
+    contextHints?: AiContextHintsContract | null;
 }
 interface AiClarificationUiContract {
     responseType?: 'text' | 'choice' | 'confirm' | 'mixed' | 'context';
@@ -161,6 +197,7 @@ interface AgenticAuthoringIntentResolutionRequestContract extends AgenticAuthori
     provider?: string | null;
     model?: string | null;
     apiKey?: string | null;
+    contextHints?: AiContextHintsContract | null;
 }
 interface AgenticAuthoringCandidateContract {
     resourcePath?: string | null;
@@ -178,7 +215,11 @@ interface AgenticAuthoringQuickReplyContract {
     kind: string;
     label: string;
     prompt: string;
-    [key: string]: AiJsonValue | undefined;
+    description?: string | null;
+    icon?: string | null;
+    tone?: string | null;
+    contextHints?: AiContextHintsContract | null;
+    [key: string]: AiJsonValue | AiContextHintsContract | undefined;
 }
 interface AgenticAuthoringIntentResolutionResultContract {
     valid?: boolean;
@@ -195,8 +236,27 @@ interface AgenticAuthoringIntentResolutionResultContract {
     clarificationQuestions?: string[];
     warnings?: string[];
     failureCodes?: string[];
+    llmDiagnostics?: AiJsonObject | null;
     [key: string]: AiJsonValue | AgenticAuthoringCandidateContract | AgenticAuthoringCandidateContract[] | AgenticAuthoringQuickReplyContract | AgenticAuthoringQuickReplyContract[] | AgenticAuthoringPendingClarificationContract | undefined;
 }
+interface AgenticAuthoringResourceCandidatesRequestContract {
+    retrievalQuery?: string | null;
+    userPrompt?: string | null;
+    artifactKind?: string | null;
+    limit?: number | null;
+    [key: string]: AiJsonValue | undefined;
+}
+interface AgenticAuthoringResourceCandidatesResultContract {
+    valid?: boolean;
+    tool?: string | null;
+    retrievalQuery?: string | null;
+    artifactKind?: string | null;
+    assistantMessage?: string | null;
+    candidates?: AgenticAuthoringCandidateContract[];
+    quickReplies?: AgenticAuthoringQuickReplyContract[];
+    warnings?: string[];
+    [key: string]: AiJsonValue | AgenticAuthoringCandidateContract[] | AgenticAuthoringQuickReplyContract[] | undefined;
+}
 interface AgenticAuthoringPlanRequestContract extends AgenticAuthoringConversationContextContract {
     userPrompt: string;
     provider?: string | null;
@@ -204,6 +264,21 @@ interface AgenticAuthoringPlanRequestContract extends AgenticAuthoringConversati
     apiKey?: string | null;
     currentPage?: AiJsonObject | null;
     intentResolution?: AgenticAuthoringIntentResolutionResultContract | null;
+    contextHints?: AiContextHintsContract | null;
+}
+interface AgenticAuthoringTurnStreamRequestContract extends AgenticAuthoringConversationContextContract {
+    userPrompt: string;
+    targetApp?: string | null;
+    targetComponentId?: string | null;
+    currentRoute?: string | null;
+    currentPage?: AiJsonObject | null;
+    selectedWidgetKey?: string | null;
+    provider?: string | null;
+    model?: string | null;
+    apiKey?: string | null;
+    contextHints?: AiContextHintsContract | null;
+    componentCapabilities?: AgenticAuthoringComponentCapabilitiesResultContract | null;
+    [key: string]: AiJsonValue | AiContextHintsContract | AgenticAuthoringComponentCapabilitiesResultContract | AgenticAuthoringConversationMessageContract[] | AgenticAuthoringPendingClarificationContract | AgenticAuthoringAttachmentSummaryContract[] | undefined;
 }
 interface AgenticAuthoringPreviewResultContract {
     valid?: boolean;
@@ -227,10 +302,68 @@ interface AgenticAuthoringApplyResultContract {
     etag?: string | null;
     [key: string]: AiJsonValue | undefined;
 }
+interface AgenticAuthoringComponentFieldAliasContract {
+    field?: string | null;
+    aliases?: string[];
+    [key: string]: AiJsonValue | undefined;
+}
+interface AgenticAuthoringComponentCapabilityExampleContract {
+    prompt?: string | null;
+    intent?: string | null;
+    configHints?: string[];
+    [key: string]: AiJsonValue | undefined;
+}
+interface AgenticAuthoringComponentCapabilityContract {
+    id?: string | null;
+    changeKind?: string | null;
+    triggerTerms?: string[];
+    fieldAliases?: AgenticAuthoringComponentFieldAliasContract[];
+    examples?: AgenticAuthoringComponentCapabilityExampleContract[];
+    [key: string]: AiJsonValue | AgenticAuthoringComponentFieldAliasContract[] | AgenticAuthoringComponentCapabilityExampleContract[] | undefined;
+}
+interface AgenticAuthoringComponentCapabilityCatalogContract {
+    componentId?: string | null;
+    version?: string | null;
+    capabilities?: AgenticAuthoringComponentCapabilityContract[];
+    [key: string]: AiJsonValue | AgenticAuthoringComponentCapabilityContract[] | undefined;
+}
 interface AgenticAuthoringComponentCapabilitiesResultContract {
     version?: string | null;
-    catalogs?: AiJsonObject[];
-    [key: string]: AiJsonValue | undefined;
+    catalogs?: AgenticAuthoringComponentCapabilityCatalogContract[];
+    [key: string]: AiJsonValue | AgenticAuthoringComponentCapabilityCatalogContract[] | undefined;
+}
+interface AgenticAuthoringManifestEditPlanRequestContract {
+    config?: AiJsonObject | null;
+    plan?: AiJsonObject | null;
+}
+interface AgenticAuthoringResolveTargetRequestContract {
+    config?: AiJsonObject | null;
+    operationId?: string | null;
+    target?: AiJsonValue;
+    input?: AiJsonValue;
+}
+interface AgenticAuthoringResolvedTargetContract {
+    status?: string | null;
+    componentId?: string | null;
+    operationId?: string | null;
+    kind?: string | null;
+    resolver?: string | null;
+    path?: string | null;
+    value?: AiJsonValue;
+    candidates?: string[];
+    failures?: string[];
+}
+interface AgenticAuthoringManifestValidationResultContract {
+    valid?: boolean;
+    failures?: string[];
+    warnings?: string[];
+    normalizedPlan?: AiJsonObject | null;
+}
+interface AgenticAuthoringManifestCompileResultContract {
+    compiled?: boolean;
+    failures?: string[];
+    warnings?: string[];
+    patch?: AiJsonObject | null;
 }
 interface AiPatchStreamStartResponseContract {
     streamId: string;
@@ -242,6 +375,16 @@ interface AiPatchStreamStartResponseContract {
     expiresAt: string;
     fallbackPatchUrl: string;
 }
+interface AgenticAuthoringTurnStreamStartResponseContract {
+    streamId: string;
+    threadId: string;
+    turnId: string;
+    eventSchemaVersion: string;
+    streamAuthMode?: 'cookie' | 'signed_url_token' | null;
+    streamAccessToken?: string | null;
+    expiresAt: string;
+    fallbackAuthoringUrl: string;
+}
 interface AiPatchStreamCancelResponseContract {
     streamId?: string | null;
     threadId?: string | null;
@@ -260,6 +403,8 @@ interface AiPatchStreamEnvelopeContract<TPayload extends AiJsonObject = AiJsonOb
     type: AiPatchStreamEventType$1;
     payload: TPayload;
 }
+interface AgenticAuthoringTurnStreamEnvelopeContract<TPayload extends AiJsonObject = AiJsonObject> extends AiPatchStreamEnvelopeContract<TPayload> {
+}
 interface ProblemResponseContract {
     timestamp?: string | null;
     status?: number | null;
@@ -270,6 +415,7 @@ interface ProblemResponseContract {
     [key: string]: AiJsonValue | undefined;
 }
 type AiPatchStreamEventType$1 = (typeof AI_STREAM_EVENT_TYPES)[number];
+type AiTurnStreamEventType = (typeof AI_STREAM_EVENT_TYPES)[number];
 
 /**
  * Models for Praxis AI (Centralized)
@@ -282,7 +428,7 @@ interface AiRuleResponse {
     /** Descriptive name for the rule */
     ruleName: string;
     /** Type of target (scope) */
-    targetType: 'field' | 'section' | 'action' | 'row' | 'column';
+    targetType: 'field' | 'section' | 'action' | 'row' | 'column' | 'visualBlock';
     /** IDs of the target elements */
     targetIds: string[];
     /** Canonical JSON Logic condition payload or null for always applied */
@@ -408,7 +554,7 @@ interface RulePropertyDefinition {
     }>;
     category?: 'content' | 'appearance' | 'behavior' | 'layout' | 'validation';
 }
-type RulePropertySchema = Record<'field' | 'section' | 'action' | 'row' | 'column', RulePropertyDefinition[]>;
+type RulePropertySchema = Record<'field' | 'section' | 'action' | 'row' | 'column' | 'visualBlock', RulePropertyDefinition[]>;
 
 type PraxisAssistantShellMessageRole = 'user' | 'assistant' | 'system' | 'status' | 'error';
 type PraxisAssistantShellMode = 'config' | 'agentic-authoring' | 'chat' | 'diagnostic' | 'review' | 'inline-help';
@@ -427,6 +573,10 @@ interface PraxisAssistantShellQuickReply {
     label: string;
     prompt: string;
     kind?: string;
+    description?: string | null;
+    icon?: string | null;
+    tone?: string | null;
+    contextHints?: Readonly<Record<string, unknown>> | null;
 }
 interface PraxisAssistantShellMessageAction {
     id: string;
@@ -525,6 +675,13 @@ interface PraxisAssistantPendingClarification {
     clientTurnId?: string;
     diagnostics?: Record<string, unknown>;
 }
+type PraxisAssistantConversationMessageRole = 'user' | 'assistant' | 'system';
+interface PraxisAssistantConversationMessage {
+    id: string;
+    role: PraxisAssistantConversationMessageRole;
+    text: string;
+}
+declare function toPraxisAssistantConversationMessages(messages: readonly PraxisAssistantShellMessage[], limit?: number): PraxisAssistantConversationMessage[];
 interface PraxisAssistantTurnRequest {
     mode: PraxisAssistantShellMode;
     phase?: PraxisAssistantTurnPhase;
@@ -784,8 +941,6 @@ declare class PraxisAiService {
     generateContentStream(prompt: string, modelName?: string): Observable<string>;
     generateJson<T>(prompt: string, modelName?: string, schema?: any): Observable<T | null>;
     isMockMode(): boolean;
-    private extractUserIntent;
-    private getMockPatch;
     listModels(apiKey?: string): Observable<AiModel[]>;
     testConnection(apiKey?: string, model?: string): Observable<boolean>;
     private resolveProvider;
@@ -795,7 +950,7 @@ declare class PraxisAiService {
 }
 
 declare const AI_INTENT_CONTRACT_VERSION: "v1.1";
-declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "922e6d48637e64b403562d6d7cb833ed4942ffb0b452ec3573255871f4ec8739";
+declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "42af43aec91777def176def87d2f41d30c8dbc8abb6c21dc38b5e181a1a51f4f";
 type AiSchemaContext = AiSchemaContextContract;
 interface AiSuggestionsRequest {
     componentId: string;
@@ -828,10 +983,22 @@ type AiPatchStreamEventType = AiPatchStreamEventType$1;
 type AiPatchStreamStartResponse = AiPatchStreamStartResponseContract;
 type AiPatchStreamCancelResponse = AiPatchStreamCancelResponseContract;
 type AiPatchStreamEnvelope<TPayload extends AiJsonObject = AiJsonObject> = AiPatchStreamEnvelopeContract<TPayload>;
+type AgenticAuthoringManifestEditPlanRequest = AgenticAuthoringManifestEditPlanRequestContract;
+type AgenticAuthoringResolveTargetRequest = AgenticAuthoringResolveTargetRequestContract;
+type AgenticAuthoringResolvedTarget = AgenticAuthoringResolvedTargetContract;
+type AgenticAuthoringManifestValidationResult = AgenticAuthoringManifestValidationResultContract;
+type AgenticAuthoringManifestCompileResult = AgenticAuthoringManifestCompileResultContract;
+type AgenticAuthoringTurnStreamRequest = AgenticAuthoringTurnStreamRequestContract;
+type AgenticAuthoringTurnStreamStartResponse = AgenticAuthoringTurnStreamStartResponseContract;
+type AgenticAuthoringTurnStreamEnvelope<TPayload extends AiJsonObject = AiJsonObject> = AgenticAuthoringTurnStreamEnvelopeContract<TPayload>;
 interface AiPatchStreamConnection {
     events$: Observable<AiPatchStreamEnvelope>;
     close: () => void;
 }
+interface AgenticAuthoringTurnStreamConnection {
+    events$: Observable<AgenticAuthoringTurnStreamEnvelope>;
+    close: () => void;
+}
 type AiPatchStreamConnectionErrorKind = 'unsupported' | 'http_status' | 'transport' | 'parse' | 'schema';
 declare class AiPatchStreamConnectionError extends Error {
     readonly kind: AiPatchStreamConnectionErrorKind;
@@ -937,17 +1104,27 @@ declare class AiBackendApiService {
     startPatchStream(request: AiOrchestratorRequest): Observable<AiPatchStreamStartResponse>;
     connectPatchStream(streamId: string, lastEventId?: string, accessToken?: string): AiPatchStreamConnection;
     cancelPatchStream(streamId: string, accessToken?: string): Observable<AiPatchStreamCancelResponse>;
+    startAgenticAuthoringTurnStream(request: AgenticAuthoringTurnStreamRequest): Observable<AgenticAuthoringTurnStreamStartResponse>;
+    connectAgenticAuthoringTurnStream(streamId: string, lastEventId?: string, accessToken?: string): AgenticAuthoringTurnStreamConnection;
+    cancelAgenticAuthoringTurnStream(streamId: string, accessToken?: string): Observable<AiPatchStreamCancelResponse>;
     listModels(request: AiProviderModelsRequest): Observable<AiProviderModelsResponse>;
     listProviderCatalog(): Observable<AiProviderCatalogResponse>;
     testProvider(request: AiProviderTestRequest): Observable<AiProviderTestResponse>;
     getAiStatus(): Observable<AiProviderStatusResponse>;
     getAiContext(componentId: string, componentType: string): Observable<AiContextDTO>;
+    getAgenticAuthoringManifest(componentId: string): Observable<AiJsonObject>;
+    listAgenticAuthoringManifestTargets(componentId: string): Observable<AiJsonObject[]>;
+    listAgenticAuthoringManifestOperations(componentId: string): Observable<AiJsonObject[]>;
+    resolveAgenticAuthoringManifestTarget(componentId: string, request: AgenticAuthoringResolveTargetRequest): Observable<AgenticAuthoringResolvedTarget>;
+    validateAgenticAuthoringManifestPlan(componentId: string, request: AgenticAuthoringManifestEditPlanRequest): Observable<AgenticAuthoringManifestValidationResult>;
+    compileAgenticAuthoringManifestPatch(componentId: string, request: AgenticAuthoringManifestEditPlanRequest): Observable<AgenticAuthoringManifestCompileResult>;
     loadGlobalAiConfig(): Observable<AiGlobalConfigSnapshot | null>;
     saveGlobalAiConfig(aiConfig: AiGlobalConfigSnapshot): Observable<void>;
     getHeaderContext(): AiHeaderContext;
     private buildHeaders;
     private normalizeContractVersion;
     private normalizeContractSchemaHash;
+    private authoringManifestUrl;
     private resolveHeaderMap;
     private parsePatchStreamEnvelope;
     private isPatchStreamEnvelope;
@@ -973,6 +1150,7 @@ declare class AiResponseValidatorService {
     private validateJsonLogicExpression;
     private walkJsonLogicNode;
     private isSupportedJsonLogicOperator;
+    private validateJsonLogicOperatorArity;
     private collectVarPaths;
     private isValidTargetId;
     private findSimilarTargetId;
@@ -1038,6 +1216,54 @@ declare class PraxisAssistantTurnController {
     private toObservable;
 }
 
+type PraxisAssistantSessionVisibility = 'active' | 'minimized';
+interface PraxisAssistantSessionDescriptor {
+    id: string;
+    ownerId: string;
+    ownerType: string;
+    title: string;
+    summary?: string | null;
+    mode?: PraxisAssistantShellMode | null;
+    state?: PraxisAssistantShellState | null;
+    visibility?: PraxisAssistantSessionVisibility | null;
+    contextItems?: readonly PraxisAssistantShellContextItem[] | null;
+    badge?: string | null;
+    icon?: string | null;
+    updatedAt?: string | null;
+}
+interface PraxisAssistantSessionSnapshot {
+    id: string;
+    ownerId: string;
+    ownerType: string;
+    title: string;
+    summary: string;
+    mode: PraxisAssistantShellMode;
+    state: PraxisAssistantShellState;
+    visibility: PraxisAssistantSessionVisibility;
+    contextItems: readonly PraxisAssistantShellContextItem[];
+    badge: string;
+    icon: string;
+    createdAt: string;
+    updatedAt: string;
+}
+declare class PraxisAssistantSessionRegistryService {
+    private readonly sessionsState;
+    readonly sessions: i0.Signal<PraxisAssistantSessionSnapshot[]>;
+    readonly activeSession: i0.Signal<PraxisAssistantSessionSnapshot | null>;
+    readonly minimizedSessions: i0.Signal<PraxisAssistantSessionSnapshot[]>;
+    upsertSession(descriptor: PraxisAssistantSessionDescriptor): PraxisAssistantSessionSnapshot;
+    openSession(sessionId: string): PraxisAssistantSessionSnapshot | null;
+    minimizeSession(sessionId: string): PraxisAssistantSessionSnapshot | null;
+    removeSession(sessionId: string): void;
+    getSession(sessionId: string): PraxisAssistantSessionSnapshot | null;
+    clear(): void;
+    private setVisibility;
+    private normalizeDescriptor;
+    private sortSessions;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisAssistantSessionRegistryService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PraxisAssistantSessionRegistryService>;
+}
+
 type AssistantMessageRole = 'user' | 'assistant' | 'system';
 interface AssistantHistoryMessage {
     id: string;
@@ -1077,7 +1303,7 @@ interface ClarificationOption {
     value: string;
     example?: string;
 }
-type ClarificationContextHints = AiJsonObject;
+type ClarificationContextHints = AiContextHintsContract;
 interface ClarificationRichOption extends ClarificationOption {
     contextHints?: ClarificationContextHints;
 }
@@ -1411,6 +1637,7 @@ declare class PraxisAiAssistantComponent implements OnDestroy {
     private hasBadgeColors;
     private hasBadgeField;
     private mergeContextHints;
+    private enrichDomainCatalogAuthoringHints;
     private setResourcePathHint;
     private clearResourcePathHint;
     private matchClarificationOptionPath;
@@ -1530,6 +1757,8 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     protected onAttachmentFilesSelected(event: Event): void;
     protected onApply(): void;
     protected onQuickReply(reply: PraxisAssistantShellQuickReply): void;
+    protected getQuickReplyAriaLabel(reply: PraxisAssistantShellQuickReply): string;
+    protected getQuickReplyTone(reply: PraxisAssistantShellQuickReply): string;
     protected onRemoveAttachment(attachment: PraxisAssistantShellAttachment): void;
     protected onMessageAction(message: PraxisAssistantShellMessage, action: PraxisAssistantShellMessageAction): void;
     protected getModeLabel(): string;
@@ -1560,13 +1789,56 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisAiAssistantShellComponent, "praxis-ai-assistant-shell", never, { "labels": { "alias": "labels"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "state": { "alias": "state"; "required": false; }; "contextItems": { "alias": "contextItems"; "required": false; }; "attachments": { "alias": "attachments"; "required": false; }; "messages": { "alias": "messages"; "required": false; }; "quickReplies": { "alias": "quickReplies"; "required": false; }; "prompt": { "alias": "prompt"; "required": false; }; "statusText": { "alias": "statusText"; "required": false; }; "errorText": { "alias": "errorText"; "required": false; }; "testIdPrefix": { "alias": "testIdPrefix"; "required": false; }; "panelTestId": { "alias": "panelTestId"; "required": false; }; "submitTestId": { "alias": "submitTestId"; "required": false; }; "applyTestId": { "alias": "applyTestId"; "required": false; }; "busy": { "alias": "busy"; "required": false; }; "canSubmit": { "alias": "canSubmit"; "required": false; }; "canApply": { "alias": "canApply"; "required": false; }; "submitOnEnter": { "alias": "submitOnEnter"; "required": false; }; "enableFileAttachments": { "alias": "enableFileAttachments"; "required": false; }; "attachmentAccept": { "alias": "attachmentAccept"; "required": false; }; "attachmentMultiple": { "alias": "attachmentMultiple"; "required": false; }; "draggable": { "alias": "draggable"; "required": false; }; "resizable": { "alias": "resizable"; "required": false; }; "minWidth": { "alias": "minWidth"; "required": false; }; "minHeight": { "alias": "minHeight"; "required": false; }; "margin": { "alias": "margin"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; }, { "promptChange": "promptChange"; "submitPrompt": "submitPrompt"; "apply": "apply"; "close": "close"; "attach": "attach"; "attachmentsPasted": "attachmentsPasted"; "attachmentsSelected": "attachmentsSelected"; "removeAttachment": "removeAttachment"; "messageAction": "messageAction"; "editMessage": "editMessage"; "resendMessage": "resendMessage"; "quickReply": "quickReply"; "layoutChange": "layoutChange"; }, never, never, true, never>;
 }
 
+type PraxisAssistantDockTone = 'ready' | 'working' | 'review' | 'governed' | 'error';
+declare class PraxisAiAssistantDockComponent {
+    title: string;
+    summary: string;
+    badge: string;
+    icon: string;
+    state: PraxisAssistantShellState | null;
+    tone: PraxisAssistantDockTone | null;
+    ariaLabel: string;
+    openAriaLabel: string;
+    openTooltip: string;
+    testId: string;
+    openTestId: string;
+    open: EventEmitter<void>;
+    resolvedTone(): PraxisAssistantDockTone;
+    resolvedIcon(): string;
+    resolvedBadge(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisAiAssistantDockComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisAiAssistantDockComponent, "praxis-ai-assistant-dock", never, { "title": { "alias": "title"; "required": false; }; "summary": { "alias": "summary"; "required": false; }; "badge": { "alias": "badge"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "state": { "alias": "state"; "required": false; }; "tone": { "alias": "tone"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "openAriaLabel": { "alias": "openAriaLabel"; "required": false; }; "openTooltip": { "alias": "openTooltip"; "required": false; }; "testId": { "alias": "testId"; "required": false; }; "openTestId": { "alias": "openTestId"; "required": false; }; }, { "open": "open"; }, never, never, true, never>;
+}
+
+declare class PraxisAiAssistantSessionHostComponent {
+    private readonly registry;
+    testId: string;
+    dockTestIdPrefix: string;
+    ariaLabel: string;
+    openAriaLabel: string;
+    openTooltip: string;
+    ownerType: string | null;
+    ownerId: string | null;
+    visibility: PraxisAssistantSessionVisibility | 'all';
+    sessionOpen: EventEmitter<PraxisAssistantSessionSnapshot>;
+    visibleSessions(): readonly PraxisAssistantSessionSnapshot[];
+    openSession(sessionId: string): void;
+    sessionAriaLabel(session: PraxisAssistantSessionSnapshot): string;
+    dockTestId(session: PraxisAssistantSessionSnapshot, first: boolean): string;
+    dockOpenTestId(session: PraxisAssistantSessionSnapshot, first: boolean): string;
+    trackSession(_index: number, session: PraxisAssistantSessionSnapshot): string;
+    private safeId;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisAiAssistantSessionHostComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisAiAssistantSessionHostComponent, "praxis-ai-assistant-session-host", never, { "testId": { "alias": "testId"; "required": false; }; "dockTestIdPrefix": { "alias": "dockTestIdPrefix"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "openAriaLabel": { "alias": "openAriaLabel"; "required": false; }; "openTooltip": { "alias": "openTooltip"; "required": false; }; "ownerType": { "alias": "ownerType"; "required": false; }; "ownerId": { "alias": "ownerId"; "required": false; }; "visibility": { "alias": "visibility"; "required": false; }; }, { "sessionOpen": "sessionOpen"; }, never, never, true, never>;
+}
+
 declare class AiContextBuilderService {
     private schemaMinifier;
     constructor(schemaMinifier: SchemaMinifierService);
     /**
      * Builds the complete context for the AI prompt
      */
-    buildPromptContext(fieldSchemas: Record<string, FieldSchemaLike>, targetType: 'field' | 'section' | 'action' | 'row' | 'column', propertySchema: RulePropertySchema): PromptContext;
+    buildPromptContext(fieldSchemas: Record<string, FieldSchemaLike>, targetType: 'field' | 'section' | 'action' | 'row' | 'column' | 'visualBlock', propertySchema: RulePropertySchema): PromptContext;
     buildRulePrompt(userPrompt: string, context: PromptContext): string;
     buildSuggestionPrompt(context: PromptContext): string;
     /**
@@ -1595,7 +1867,7 @@ declare class AiRuleWizardDialogComponent implements OnInit {
     private snackBar;
     private contextBuilder;
     private cdr;
-    selectedTargetType: 'field' | 'section' | 'action' | 'row' | 'column';
+    selectedTargetType: 'field' | 'section' | 'action' | 'row' | 'column' | 'visualBlock';
     userPrompt: string;
     isGenerating: boolean;
     validationError: string | null;
@@ -1631,5 +1903,5 @@ declare class AiRuleWizardDialogComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<AiRuleWizardDialogComponent, "praxis-ai-rule-wizard-dialog", never, {}, {}, never, never, true, never>;
 }
 
-export { AI_BACKEND_CONFIG_STORE, AI_BACKEND_STORAGE_OPTIONS, AI_CONTRACT_SCHEMA_HASH, AI_CONTRACT_VERSION, AI_INTENT_CONTRACT_SCHEMA_HASH, AI_INTENT_CONTRACT_VERSION, AI_STREAM_EVENT_SCHEMA_VERSION, AI_STREAM_EVENT_TYPES, AiBackendApiService, AiPatchStreamConnectionError, AiResponseValidatorService, AiRuleWizardDialogComponent, BaseAiAdapter, PraxisAi, PraxisAiAssistantComponent, PraxisAiAssistantShellComponent, PraxisAiService, PraxisAssistantTurnController, PraxisAssistantTurnOrchestratorService, SchemaMinifierService };
-export type { AgenticAuthoringApplyRequestContract, AgenticAuthoringApplyResultContract, AgenticAuthoringAttachmentSummaryContract, AgenticAuthoringCandidateContract, AgenticAuthoringComponentCapabilitiesResultContract, AgenticAuthoringConversationContextContract, AgenticAuthoringConversationMessageContract, AgenticAuthoringIntentResolutionRequestContract, AgenticAuthoringIntentResolutionResultContract, AgenticAuthoringPendingClarificationContract, AgenticAuthoringPlanRequestContract, AgenticAuthoringPreviewResultContract, AgenticAuthoringQuickReplyContract, AiBackendConfigStore, AiBackendStorageOptions, AiChatMessage, AiChatMessageContract, AiClarificationUiContract, AiConfigAdapter, AiContextDTO, AiContextTemplate, AiContextTemplateMeta, AiCurrentStateDigest, AiCurrentStateDigestContract, AiExamplePair, AiGlobalConfigSnapshot, AiHeaderContext, AiIntegrationConfig, AiJsonArray, AiJsonObject, AiJsonPrimitive, AiJsonValue, AiMemoryInfoContract, AiModel, AiOptionContract, AiOrchestratorRequest, AiOrchestratorRequestContract, AiOrchestratorResponse, AiOrchestratorResponseContract, AiOrchestratorResponseType, AiPatchDiff, AiPatchDiffContract, AiPatchStreamCancelResponse, AiPatchStreamCancelResponseContract, AiPatchStreamConnection, AiPatchStreamConnectionErrorKind, AiPatchStreamEnvelope, AiPatchStreamEnvelopeContract, AiPatchStreamEventType, AiPatchStreamStartResponse, AiPatchStreamStartResponseContract, AiProviderCatalogItem, AiProviderCatalogResponse, AiProviderModelsRequest, AiProviderModelsResponse, AiProviderStatusResponse, AiProviderTestRequest, AiProviderTestResponse, AiResponseCompileResult, AiRuleResponse, AiSchemaContext, AiSchemaContextContract, AiSuggestion, AiSuggestionsRequest, AiSuggestionsResponse, AiUiContextRef, AiUiContextRefContract, AiValidationError, AiValidationResult, AiValidationWarning, AiWizardData, Capability, FieldSchemaLike, MinifiedField, PatchResult, PraxisAssistantClarificationOption, PraxisAssistantClarificationQuestion, PraxisAssistantClarificationQuestionType, PraxisAssistantPendingClarification, PraxisAssistantShellAttachment, PraxisAssistantShellContextItem, PraxisAssistantShellLabels, PraxisAssistantShellLayout, PraxisAssistantShellMessage, PraxisAssistantShellMessageAction, PraxisAssistantShellMessageRole, PraxisAssistantShellMode, PraxisAssistantShellQuickReply, PraxisAssistantShellState, PraxisAssistantTurnAction, PraxisAssistantTurnControllerOptions, PraxisAssistantTurnFlow, PraxisAssistantTurnPhase, PraxisAssistantTurnRequest, PraxisAssistantTurnResult, PraxisAssistantTurnViewState, ProblemResponseContract, PromptContext, RulePropertyDefinition, RulePropertySchema, RulePropertyType, ValidationContext, ValueKind };
+export { AI_BACKEND_CONFIG_STORE, AI_BACKEND_STORAGE_OPTIONS, AI_CONTRACT_SCHEMA_HASH, AI_CONTRACT_VERSION, AI_INTENT_CONTRACT_SCHEMA_HASH, AI_INTENT_CONTRACT_VERSION, AI_STREAM_EVENT_SCHEMA_VERSION, AI_STREAM_EVENT_TYPES, AiBackendApiService, AiPatchStreamConnectionError, AiResponseValidatorService, AiRuleWizardDialogComponent, BaseAiAdapter, PraxisAi, PraxisAiAssistantComponent, PraxisAiAssistantDockComponent, PraxisAiAssistantSessionHostComponent, PraxisAiAssistantShellComponent, PraxisAiService, PraxisAssistantSessionRegistryService, PraxisAssistantTurnController, PraxisAssistantTurnOrchestratorService, SchemaMinifierService, toPraxisAssistantConversationMessages };
+export type { AgenticAuthoringApplyRequestContract, AgenticAuthoringApplyResultContract, AgenticAuthoringAttachmentSummaryContract, AgenticAuthoringCandidateContract, AgenticAuthoringComponentCapabilitiesResultContract, AgenticAuthoringComponentCapabilityCatalogContract, AgenticAuthoringComponentCapabilityContract, AgenticAuthoringComponentCapabilityExampleContract, AgenticAuthoringComponentFieldAliasContract, AgenticAuthoringConversationContextContract, AgenticAuthoringConversationMessageContract, AgenticAuthoringIntentResolutionRequestContract, AgenticAuthoringIntentResolutionResultContract, AgenticAuthoringManifestCompileResult, AgenticAuthoringManifestCompileResultContract, AgenticAuthoringManifestEditPlanRequest, AgenticAuthoringManifestEditPlanRequestContract, AgenticAuthoringManifestValidationResult, AgenticAuthoringManifestValidationResultContract, AgenticAuthoringPendingClarificationContract, AgenticAuthoringPlanRequestContract, AgenticAuthoringPreviewResultContract, AgenticAuthoringQuickReplyContract, AgenticAuthoringResolveTargetRequest, AgenticAuthoringResolveTargetRequestContract, AgenticAuthoringResolvedTarget, AgenticAuthoringResolvedTargetContract, AgenticAuthoringResourceCandidatesRequestContract, AgenticAuthoringResourceCandidatesResultContract, AgenticAuthoringTurnStreamConnection, AgenticAuthoringTurnStreamEnvelope, AgenticAuthoringTurnStreamEnvelopeContract, AgenticAuthoringTurnStreamRequest, AgenticAuthoringTurnStreamRequestContract, AgenticAuthoringTurnStreamStartResponse, AgenticAuthoringTurnStreamStartResponseContract, AiBackendConfigStore, AiBackendStorageOptions, AiChatMessage, AiChatMessageContract, AiClarificationUiContract, AiConfigAdapter, AiContextDTO, AiContextHintsContract, AiContextTemplate, AiContextTemplateMeta, AiCurrentStateDigest, AiCurrentStateDigestContract, AiDomainCatalogContextHintContract, AiDomainCatalogContextHintIntent, AiDomainCatalogContextHintItemType, AiDomainCatalogRelationshipHintContract, AiExamplePair, AiGlobalConfigSnapshot, AiHeaderContext, AiIntegrationConfig, AiJsonArray, AiJsonObject, AiJsonPrimitive, AiJsonValue, AiMemoryInfoContract, AiModel, AiOptionContract, AiOrchestratorRequest, AiOrchestratorRequestContract, AiOrchestratorResponse, AiOrchestratorResponseContract, AiOrchestratorResponseType, AiPatchDiff, AiPatchDiffContract, AiPatchStreamCancelResponse, AiPatchStreamCancelResponseContract, AiPatchStreamConnection, AiPatchStreamConnectionErrorKind, AiPatchStreamEnvelope, AiPatchStreamEnvelopeContract, AiPatchStreamEventType, AiPatchStreamStartResponse, AiPatchStreamStartResponseContract, AiProviderCatalogItem, AiProviderCatalogResponse, AiProviderModelsRequest, AiProviderModelsResponse, AiProviderStatusResponse, AiProviderTestRequest, AiProviderTestResponse, AiResponseCompileResult, AiRuleResponse, AiSchemaContext, AiSchemaContextContract, AiSuggestion, AiSuggestionsRequest, AiSuggestionsResponse, AiTurnStreamEventType, AiUiContextRef, AiUiContextRefContract, AiValidationError, AiValidationResult, AiValidationWarning, AiWizardData, Capability, FieldSchemaLike, MinifiedField, PatchResult, PraxisAssistantClarificationOption, PraxisAssistantClarificationQuestion, PraxisAssistantClarificationQuestionType, PraxisAssistantConversationMessage, PraxisAssistantConversationMessageRole, PraxisAssistantDockTone, PraxisAssistantPendingClarification, PraxisAssistantSessionDescriptor, PraxisAssistantSessionSnapshot, PraxisAssistantSessionVisibility, PraxisAssistantShellAttachment, PraxisAssistantShellContextItem, PraxisAssistantShellLabels, PraxisAssistantShellLayout, PraxisAssistantShellMessage, PraxisAssistantShellMessageAction, PraxisAssistantShellMessageRole, PraxisAssistantShellMode, PraxisAssistantShellQuickReply, PraxisAssistantShellState, PraxisAssistantTurnAction, PraxisAssistantTurnControllerOptions, PraxisAssistantTurnFlow, PraxisAssistantTurnPhase, PraxisAssistantTurnRequest, PraxisAssistantTurnResult, PraxisAssistantTurnViewState, ProblemResponseContract, PromptContext, RulePropertyDefinition, RulePropertySchema, RulePropertyType, ValidationContext, ValueKind };

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "@praxisui/ai",
-  "version": "8.0.0-beta.2",
+  "version": "8.0.0-beta.20",
   "description": "AI building blocks and assistant integration for Praxis UI applications.",
   "peerDependencies": {
     "@angular/common": "^20.3.0",
     "@angular/core": "^20.3.0",
-    "@praxisui/core": "^8.0.0-beta.2"
+    "@praxisui/core": "^8.0.0-beta.20",
+    "@angular/cdk": "^20.3.0",
+    "@angular/forms": "^20.3.0",
+    "@angular/material": "^20.3.0",
+    "@google/generative-ai": "^0.24.1",
+    "rxjs": "~7.8.0"
   },
   "dependencies": {
     "tslib": "^2.3.0"