@praxisui/ai 8.0.0-beta.17 → 8.0.0-beta.19

package/fesm2022/praxisui-ai.mjs

@@ -65,7 +65,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
  * Do not edit manually. Run praxis-config-starter/tools/contracts/generate-ai-contract-bindings.js.
  */
 const AI_CONTRACT_VERSION = 'v1.1';
-const AI_CONTRACT_SCHEMA_HASH = 'de47da5e091f33ba0e885ab6d679fd498b0bcee30479aaa98eb35b2166736311';
+const AI_CONTRACT_SCHEMA_HASH = 'af6037b884417c7ec7b3d7e98737699c3972fde5b610f22a6d7c76eb77eb0e0a';
 const AI_STREAM_EVENT_SCHEMA_VERSION = 'v1';
 const AI_DOMAIN_CATALOG_CONTEXT_HINT_SCHEMA_VERSION = 'praxis.ai.context-hints.domain-catalog/v0.1';
 const AI_STREAM_EVENT_TYPES = ['status', 'thought.step', 'heartbeat', 'result', 'error', 'cancelled'];
@@ -2539,7 +2539,7 @@ class PraxisAiAssistantComponent {
                 : undefined;
             const normalizedRuntimeState = runtimeState !== undefined ? this.toAiJsonObject(runtimeState) : undefined;
             const normalizedSuggestedPatch = suggestion?.patch ? this.toAiJsonObject(suggestion.patch) : undefined;
-            const normalizedContextHints = this.toClarificationContextHints(mergedContextHints);
+            const normalizedContextHints = this.enrichDomainCatalogAuthoringHints(mergedContextHints);
             const patchRequest = {
                 componentId,
                 componentType,
@@ -5293,6 +5293,34 @@ class PraxisAiAssistantComponent {
         }
         return this.toClarificationContextHints(merged) ?? null;
     }
+    enrichDomainCatalogAuthoringHints(value) {
+        const normalized = this.toClarificationContextHints(value);
+        if (!normalized)
+            return undefined;
+        const domainCatalog = this.asRecord(normalized['domainCatalog']);
+        const recommendedOperation = domainCatalog?.['recommendedOperation'];
+        if (typeof recommendedOperation !== 'string' || !recommendedOperation.trim()) {
+            return normalized;
+        }
+        const operationId = recommendedOperation.trim();
+        const enriched = this.toAiJsonObject(normalized);
+        enriched['authoringOperation'] = this.toAiJsonObject({
+            operationId,
+            source: 'domainCatalog.recommendedOperation',
+            reviewRequired: true,
+            materializeOnlyAfterReview: true,
+        });
+        if (operationId === 'rule.visualBlockGuidance.add') {
+            enriched['ruleDraftPolicy'] = this.toAiJsonObject({
+                type: 'visualBlockGuidance',
+                targetType: 'visualBlock',
+                reviewStatus: 'pending',
+                writeOnly: 'formRules',
+                forbiddenPaths: ['formRulesState'],
+            });
+        }
+        return this.toClarificationContextHints(enriched);
+    }
     setResourcePathHint(resourcePath) {
         const raw = (resourcePath || '').trim();
         const normalized = this.normalizeResourcePath(raw);

package/index.d.ts

@@ -18,7 +18,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: "de47da5e091f33ba0e885ab6d679fd498b0bcee30479aaa98eb35b2166736311";
+declare const AI_CONTRACT_SCHEMA_HASH: "af6037b884417c7ec7b3d7e98737699c3972fde5b610f22a6d7c76eb77eb0e0a";
 declare const AI_STREAM_EVENT_SCHEMA_VERSION: "v1";
 declare const AI_DOMAIN_CATALOG_CONTEXT_HINT_SCHEMA_VERSION: "praxis.ai.context-hints.domain-catalog/v0.1";
 declare const AI_STREAM_EVENT_TYPES: readonly ["status", "thought.step", "heartbeat", "result", "error", "cancelled"];
@@ -28,15 +28,34 @@ interface AiJsonObject {
     [key: string]: AiJsonValue;
 }
 type AiJsonValue = AiJsonPrimitive | AiJsonObject | AiJsonArray;
-type AiDomainCatalogContextHintItemType = 'context' | 'node' | 'edge' | 'binding' | 'evidence' | 'governance';
+type AiDomainCatalogContextHintItemType = 'context' | 'node' | 'edge' | 'binding' | 'evidence' | 'governance' | 'vocabulary' | 'relationship';
+type AiDomainCatalogContextHintIntent = 'authoring' | 'explain' | 'validate' | 'ai-access-control';
+type AiDomainCatalogRecommendedOperation = 'rule.visibility.add' | 'rule.validation.add' | 'rule.visualBlockGuidance.add' | 'rule.remove';
+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;
+    recommendedOperation?: AiDomainCatalogRecommendedOperation | null;
     limit?: number;
+    relationships?: AiDomainCatalogRelationshipHintContract | null;
 }
 interface AiContextHintsContract {
     domainCatalog?: AiDomainCatalogContextHintContract;
@@ -187,7 +206,7 @@ interface AgenticAuthoringCandidateContract {
     score?: number | null;
     reason?: string | null;
     evidence?: string[] | null;
-    [key: string]: AiJsonValue | AiContextHintsContract | undefined;
+    [key: string]: AiJsonValue | undefined;
 }
 interface AgenticAuthoringQuickReplyContract {
     id: string;
@@ -922,7 +941,7 @@ declare class PraxisAiService {
 }
 
 declare const AI_INTENT_CONTRACT_VERSION: "v1.1";
-declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "de47da5e091f33ba0e885ab6d679fd498b0bcee30479aaa98eb35b2166736311";
+declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "af6037b884417c7ec7b3d7e98737699c3972fde5b610f22a6d7c76eb77eb0e0a";
 type AiSchemaContext = AiSchemaContextContract;
 interface AiSuggestionsRequest {
     componentId: string;
@@ -1561,6 +1580,7 @@ declare class PraxisAiAssistantComponent implements OnDestroy {
     private hasBadgeColors;
     private hasBadgeField;
     private mergeContextHints;
+    private enrichDomainCatalogAuthoringHints;
     private setResourcePathHint;
     private clearResourcePathHint;
     private matchClarificationOptionPath;
@@ -1784,4 +1804,4 @@ declare class AiRuleWizardDialogComponent implements OnInit {
 }
 
 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, 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, 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, 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 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, 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 };

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@praxisui/ai",
-  "version": "8.0.0-beta.17",
+  "version": "8.0.0-beta.19",
   "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.17"
+    "@praxisui/core": "^8.0.0-beta.19"
   },
   "dependencies": {
     "tslib": "^2.3.0"