@praxisui/ai 8.0.0-beta.18 → 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 = '8ee46bce6fd8445afc9244c0e84ef152141f643ad0b55fc145f0373fa396b654';
+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: "8ee46bce6fd8445afc9244c0e84ef152141f643ad0b55fc145f0373fa396b654";
+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"];
@@ -30,6 +30,7 @@ interface AiJsonObject {
 type AiJsonValue = AiJsonPrimitive | AiJsonObject | AiJsonArray;
 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;
@@ -52,6 +53,7 @@ interface AiDomainCatalogContextHintContract {
     query?: string | null;
     contextKey?: string | null;
     nodeType?: string | null;
+    recommendedOperation?: AiDomainCatalogRecommendedOperation | null;
     limit?: number;
     relationships?: AiDomainCatalogRelationshipHintContract | null;
 }
@@ -939,7 +941,7 @@ declare class PraxisAiService {
 }
 
 declare const AI_INTENT_CONTRACT_VERSION: "v1.1";
-declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "8ee46bce6fd8445afc9244c0e84ef152141f643ad0b55fc145f0373fa396b654";
+declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "af6037b884417c7ec7b3d7e98737699c3972fde5b610f22a6d7c76eb77eb0e0a";
 type AiSchemaContext = AiSchemaContextContract;
 interface AiSuggestionsRequest {
     componentId: string;
@@ -1578,6 +1580,7 @@ declare class PraxisAiAssistantComponent implements OnDestroy {
     private hasBadgeColors;
     private hasBadgeField;
     private mergeContextHints;
+    private enrichDomainCatalogAuthoringHints;
     private setResourcePathHint;
     private clearResourcePathHint;
     private matchClarificationOptionPath;

package/package.json

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