@praxisui/ai 9.0.0-beta.7 → 9.0.0-beta.71

package/README.md

@@ -34,7 +34,7 @@ Peer dependencies:
 - `@angular/forms` `^21.0.0`
 - `@angular/material` `^21.0.0`
 - `@google/generative-ai` `^0.24.1`
-- `@praxisui/core` `^9.0.0-beta.4`
+- `@praxisui/core` `^9.0.0-beta.12`
 - `rxjs` `~7.8.0`
 
 ## When to use
@@ -138,6 +138,8 @@ When a component exposes factual grounding for consultative answers, include a `
 
 Use `createComponentAuthoringContext(...)` from `@praxisui/ai` when returning the adapter context. The helper normalizes the contract into a JSON-safe object, drops `undefined` fields and rejects non-JSON values before they leak into `contextHints`.
 
+Specialized component-authoring flows should also apply `withAuthoringScopePolicy(...)` or `withAuthoringScopePolicyContextHints(...)` before calling the backend turn resolver. These helpers do not classify prompts locally. They add a shared semantic policy that tells the backend/LLM to return `info` with no patch for loose instructions, greetings, meta-prompts or other turns outside the active component authoring context, while still allowing consultative answers and governed component edits when the semantic intent fits the declared contracts.
+
 The shell ships with centralized PT-BR default labels and accepts the `labels` input for a flow-specific override. The override is partial: omitted labels continue to come from the shared defaults.
 
 By default, the prompt composer submits with `Enter` and keeps `Shift+Enter` for multiline prompts. Hosts with custom composer behavior can set `submitOnEnter` to `false`.

package/ai/component-registry.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": "1.0.0",
+  "generatedAt": "2026-07-11T00:12:06.404Z",
+  "packageName": "@praxisui/ai",
+  "packageVersion": "9.0.0-beta.71",
+  "sourceRegistry": "praxis-component-registry-ingestion",
+  "sourceRegistryVersion": "1.0.0",
+  "componentCount": 0,
+  "components": {},
+  "note": "Package-scoped Praxis component registry for source-free agent discovery. Use the canonical ingestion registry for cross-package aggregate analysis."
+}

package/fesm2022/praxisui-ai.mjs

@@ -403,7 +403,7 @@ function toPraxisAssistantConversationMessageRole(role) {
  * 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 = '39e28310b20a9f2bb5e58df32f4f3f98bb1a4236761dfc7d9ee5d18fb588894c';
+const AI_CONTRACT_SCHEMA_HASH = '66579be4b7637d3c8579e299388e45b89a17e164e72886f0895e98be5fa83c16';
 const AI_STREAM_EVENT_SCHEMA_VERSION = 'v1';
 const AI_DOMAIN_CATALOG_CONTEXT_HINT_SCHEMA_VERSION = 'praxis.ai.context-hints.domain-catalog/v0.2';
 const AI_STREAM_EVENT_TYPES = ['status', 'thought.step', 'heartbeat', 'intent.resolved', 'result', 'error', 'cancelled'];
@@ -497,6 +497,73 @@ class BaseAiAdapter {
     }
 }
 
+const PRAXIS_AUTHORING_SCOPE_POLICY_KIND = 'praxis.authoring-scope-policy.v1';
+const PRAXIS_AUTHORING_SCOPE_POLICY_VERSION = '1.0';
+function createAuthoringScopePolicyContext(options = {}) {
+    const componentId = normalizeText(options.componentId);
+    const componentType = normalizeText(options.componentType);
+    const componentLabel = normalizeText(options.componentLabel);
+    return {
+        kind: PRAXIS_AUTHORING_SCOPE_POLICY_KIND,
+        version: PRAXIS_AUTHORING_SCOPE_POLICY_VERSION,
+        scope: 'component-authoring-assistant',
+        componentId,
+        componentType,
+        componentLabel,
+        intentResolution: 'semantic-contract-first',
+        outOfScopeResponseType: 'info',
+        patchRequiresExecutableAuthoringIntent: true,
+        clarificationRequiresComponentAuthoringAmbiguity: true,
+        localKeywordRoutingAllowed: false,
+        friendlyFallback: {
+            tone: 'helpful',
+            includePraxisContext: true,
+            noPatch: true,
+        },
+    };
+}
+function createAuthoringScopePolicySystemMessage(options = {}) {
+    const componentLabel = normalizeText(options.componentLabel)
+        || normalizeText(options.componentType)
+        || 'current component';
+    return {
+        role: 'system',
+        content: [
+            'Praxis component authoring scope policy:',
+            '- Resolve the user intent semantically using the declared Praxis contracts, current component context, conversation, capabilities, and grounding evidence. Do not classify intent by keyword matching.',
+            `- The active assistant is scoped to the ${componentLabel}. Return a patch only when the user semantically asks to create, change, configure, apply, open, export, filter, format, or otherwise materialize an executable operation for this component or a declared governed handoff.`,
+            '- If the prompt is a loose instruction, meta-prompt, greeting, small talk, or asks for a response that is not about the active Praxis authoring context, return type "info", canApply false, no patch, no componentEditPlan, and no runtime operation.',
+            '- For those out-of-scope prompts, answer in the user language with a concise friendly message that acknowledges the request and explains that this Praxis assistant can help inspect, explain, or safely change the current component.',
+            '- If the user asks an answerable factual question about the current component, return type "info" grounded in the declared context instead of inventing an edit plan.',
+            '- Ask a clarification only when there is a real component-authoring ambiguity that blocks a safe semantic decision.',
+        ].join('\n'),
+    };
+}
+function withAuthoringScopePolicy(request, options = {}) {
+    return {
+        ...request,
+        messages: withAuthoringScopePolicyMessage(request.messages ?? [], options),
+        contextHints: withAuthoringScopePolicyContextHints(request.contextHints, options),
+    };
+}
+function withAuthoringScopePolicyMessage(messages, options = {}) {
+    const policy = createAuthoringScopePolicySystemMessage(options);
+    const existing = messages ?? [];
+    const hasPolicy = existing.some((message) => message.role === 'system' && message.content.includes('Praxis component authoring scope policy:'));
+    return hasPolicy ? [...existing] : [policy, ...existing];
+}
+function withAuthoringScopePolicyContextHints(contextHints, options = {}) {
+    const existing = contextHints ?? {};
+    return {
+        ...existing,
+        authoringScopePolicy: createAuthoringScopePolicyContext(options),
+    };
+}
+function normalizeText(value) {
+    const normalized = value?.trim();
+    return normalized ? normalized : null;
+}
+
 /**
  * @deprecated Component assistants must not infer governed authoring from user
  * wording. Route through the backend semantic resolver and use this only for
@@ -1962,7 +2029,19 @@ class AgenticAuthoringTurnClientService {
         if (phase.startsWith('preview.')) {
             return 'preview';
         }
+        if (phase === 'tool.plan'
+            || phase === 'tool.plan.skipped'
+            || phase === 'tool.start'
+            || phase === 'tool.result'
+            || phase === 'tool.error'
+            || phase === 'authoringEvidence.retrieve'
+            || phase === 'authoringEvidence.result'
+            || phase === 'authoringEvidence.error') {
+            return 'plan';
+        }
         if (phase === 'intent.resolve'
+            || phase === 'intent.resolve.llm'
+            || phase === 'intent.resolve.grounding'
             || phase === 'resource.discovery'
             || phase === 'projectKnowledge.retrieve'
             || phase === 'context.bundle') {
@@ -1971,9 +2050,10 @@ class AgenticAuthoringTurnClientService {
         return 'contextualize';
     }
     statusForPayload(payload) {
-        return this.readString(payload, 'statusText')
-            || this.readString(payload, 'summary')
-            || this.readString(payload, 'message')
+        return this.readDisplayString(payload, 'statusText')
+            || this.readDisplayString(payload, 'message')
+            || this.readDisplayString(payload, 'label')
+            || this.readDisplayString(payload, 'summary')
             || '';
     }
     resultDiagnostics(payload, event) {
@@ -2143,6 +2223,14 @@ class AgenticAuthoringTurnClientService {
         const candidate = value?.[key];
         return typeof candidate === 'string' ? candidate.trim() : '';
     }
+    readDisplayString(value, key) {
+        const candidate = this.readString(value, key);
+        return this.isRedactedDisplayText(candidate) ? '' : candidate;
+    }
+    isRedactedDisplayText(value) {
+        const normalized = value.trim().toLowerCase();
+        return normalized === '[redacted]' || normalized === 'redacted';
+    }
     toJsonObject(value) {
         return this.isRecord(value) ? value : null;
     }
@@ -2556,7 +2644,9 @@ class AiResponseValidatorService {
             case 'enum':
                 return schema.enumValues?.some(e => e.value === value) || false;
             case 'object':
-                return typeof value === 'object' && value !== null;
+                return typeof value === 'object' && value !== null && !Array.isArray(value);
+            case 'array':
+                return Array.isArray(value);
             default:
                 return true;
         }
@@ -5173,13 +5263,6 @@ class PraxisAiAssistantComponent {
             await this.submitPrompt(base || selected);
             return;
         }
-        const maskHints = this.buildMaskSelectionHints(selected, base);
-        if (maskHints) {
-            this.activeContextHints = this.mergeContextHints(this.activeContextHints, maskHints);
-            this.skipClarificationAppend = true;
-            await this.submitPrompt(base || selected);
-            return;
-        }
         await this.submitPrompt(selected);
     }
     async confirmPatch() {
@@ -5948,7 +6031,7 @@ class PraxisAiAssistantComponent {
             return null;
         }
         if (event.type === 'thought.step') {
-            const step = Number(payload?.['step']);
+            const step = Number(payload?.['step']) || this.resolveStreamStepFromPhase(typeof payload?.['phase'] === 'string' ? payload['phase'] : '');
             const stepStateRaw = typeof payload?.['state'] === 'string' ? payload['state'].trim().toLowerCase() : '';
             const stepState = stepStateRaw === 'done'
                 ? 'done'
@@ -6074,6 +6157,10 @@ class PraxisAiAssistantComponent {
         if (typeof summary === 'string' && summary.trim()) {
             return summary.trim();
         }
+        const label = payload['label'];
+        if (typeof label === 'string' && label.trim()) {
+            return label.trim();
+        }
         const nested = this.asRecord(payload['error']);
         const nestedMsg = nested?.['message'];
         if (typeof nestedMsg === 'string' && nestedMsg.trim()) {
@@ -6081,6 +6168,38 @@ class PraxisAiAssistantComponent {
         }
         return '';
     }
+    resolveStreamStepFromPhase(phase) {
+        const normalized = (phase || '').trim();
+        if (!normalized)
+            return 0;
+        if (normalized === 'context.bundle'
+            || normalized === 'runtime.context.grounding'
+            || normalized === 'intent.resolve'
+            || normalized === 'intent.resolve.llm'
+            || normalized === 'intent.resolve.grounding'
+            || normalized === 'resource.discovery'
+            || normalized === 'projectKnowledge.retrieve') {
+            return 1;
+        }
+        if (normalized === 'tool.plan'
+            || normalized === 'tool.plan.skipped'
+            || normalized === 'tool.start'
+            || normalized === 'tool.result'
+            || normalized === 'tool.error'
+            || normalized === 'authoringEvidence.retrieve'
+            || normalized === 'authoringEvidence.result'
+            || normalized === 'authoringEvidence.error') {
+            return 2;
+        }
+        if (normalized === 'preview.plan'
+            || normalized === 'preview.compile'
+            || normalized === 'preview.validate'
+            || normalized === 'repair.attempt'
+            || normalized === 'tool.loop') {
+            return 3;
+        }
+        return 0;
+    }
     requestStreamCancel() {
         if (!this.activeStreamId) {
             return;
@@ -7137,43 +7256,6 @@ class PraxisAiAssistantComponent {
         }
         return option;
     }
-    buildMaskSelectionHints(optionText, basePrompt) {
-        const mask = this.extractMaskFromText(optionText);
-        if (!mask)
-            return null;
-        const configRoot = this.resolveConfigRoot(this.adapter?.getCurrentConfig?.());
-        const columns = this.extractColumnNames(configRoot);
-        let targetField = basePrompt ? this.findColumnInPrompt(basePrompt, columns) : null;
-        if (!targetField) {
-            targetField = this.findColumnInPrompt(optionText, columns);
-        }
-        if (!targetField && columns.length) {
-            const lowered = `${basePrompt} ${optionText}`.toLowerCase();
-            if (lowered.includes('cpf') && columns.includes('cpf'))
-                targetField = 'cpf';
-            if (lowered.includes('cnpj') && columns.includes('cnpj'))
-                targetField = 'cnpj';
-            if (lowered.includes('cep') && columns.includes('cep'))
-                targetField = 'cep';
-        }
-        const hints = {
-            optionSelected: {
-                selection: { value: mask, mode: 'mask' },
-            },
-        };
-        if (targetField) {
-            const optionSelected = this.asRecord(hints['optionSelected']);
-            if (optionSelected) {
-                optionSelected['targetField'] = targetField;
-            }
-        }
-        return this.toClarificationContextHints(hints) ?? null;
-    }
-    extractMaskFromText(text) {
-        const pattern = /(0{3}\.0{3}\.0{3}-0{2}|0{2}\.0{3}\.0{3}\/0{4}-0{2}|0{5}-0{3}|\(0{2}\)\s*0{4,5}-0{4}|0{8,14})/;
-        const match = text.match(pattern);
-        return match ? match[1] : null;
-    }
     resolveComponentId() {
         if (this.adapter.componentId)
             return this.adapter.componentId;
@@ -8221,9 +8303,7 @@ class PraxisAiAssistantShellComponent {
         if (this.state === 'processing' || this.state === 'applying') {
             return true;
         }
-        return this.canApply
-            || this.state === 'clarification'
-            || this.state === 'review';
+        return this.state === 'clarification';
     }
     updateProcessingTimer() {
         if (this.state !== 'processing') {
@@ -8258,6 +8338,9 @@ class PraxisAiAssistantShellComponent {
     getProcessingStatusText() {
         if (this.state !== 'processing')
             return '';
+        if (this.statusText.trim()) {
+            return this.statusText;
+        }
         if (this.processingElapsedSeconds >= 30) {
             return 'Ainda preparando a resposta. Você pode cancelar e tentar novamente se precisar.';
         }
@@ -8499,6 +8582,7 @@ class PraxisAiAssistantShellComponent {
             return evidence
                 .filter((item) => !!item.value?.trim())
                 .map((item) => this.presentationEvidenceToChip(item))
+                .filter((item) => !!item)
                 .slice(0, 4);
         }
         if (this.isContextualPreviewActionQuickReply(reply)) {
@@ -8833,10 +8917,16 @@ class PraxisAiAssistantShellComponent {
     }
     presentationEvidenceToChip(item) {
         const value = item.value.trim();
+        if (!this.isPublicDisplayText(value)) {
+            return null;
+        }
+        const ariaLabel = item.ariaLabel?.trim() || value;
         return {
             icon: item.icon?.trim() || 'verified',
             value: this.friendlyTechnicalLabel(value),
-            ariaLabel: this.friendlyTechnicalLabel(item.ariaLabel?.trim() || value),
+            ariaLabel: this.isPublicDisplayText(ariaLabel)
+                ? this.friendlyTechnicalLabel(ariaLabel)
+                : this.friendlyTechnicalLabel(value),
         };
     }
     getContextualActionChips(reply) {
@@ -8845,11 +8935,13 @@ class PraxisAiAssistantShellComponent {
         if (!details)
             return [];
         const chips = [];
-        const targetComponentId = this.quickReplyHint(details, hints, 'targetComponentId')
-            || this.quickReplyHint(details, hints, 'selectedComponentId');
-        const changeKind = this.quickReplyHint(details, hints, 'changeKind');
-        const capabilityId = this.quickReplyHint(details, hints, 'capabilityId');
-        const selectedWidgetKey = this.quickReplyHint(details, hints, 'selectedWidgetKey');
+        const targetComponentId = [
+            this.quickReplyHint(details, hints, 'targetComponentId'),
+            this.quickReplyHint(details, hints, 'selectedComponentId'),
+        ].find((value) => this.isPublicDisplayText(value)) ?? '';
+        const changeKind = this.publicQuickReplyHint(details, hints, 'changeKind');
+        const capabilityId = this.publicQuickReplyHint(details, hints, 'capabilityId');
+        const selectedWidgetKey = this.publicQuickReplyHint(details, hints, 'selectedWidgetKey');
         if (targetComponentId) {
             chips.push({
                 icon: 'widgets',
@@ -8880,6 +8972,10 @@ class PraxisAiAssistantShellComponent {
         }
         return chips.slice(0, 3);
     }
+    publicQuickReplyHint(details, hints, key) {
+        const value = this.quickReplyHint(details, hints, key);
+        return this.isPublicDisplayText(value) ? value : '';
+    }
     isGenericContextualActionDescription(value) {
         const normalized = value
             .normalize('NFD')
@@ -10645,4 +10741,4 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-export { AI_BACKEND_CONFIG_STORE, AI_BACKEND_ENDPOINTS, 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, AgenticAuthoringTurnClientService, AiBackendApiService, AiPatchStreamConnectionError, AiResponseValidatorService, AiRuleWizardDialogComponent, BaseAiAdapter, PRAXIS_ASSISTANT_CONTEXT_ATTACHMENT_LIMIT, PRAXIS_ASSISTANT_CONTEXT_ITEM_LIMIT, PRAXIS_ASSISTANT_CONTEXT_SCHEMA_FIELD_LIMIT, PRAXIS_ASSISTANT_CONTEXT_TEXT_LIMIT, PRAXIS_ASSISTANT_VOICE_INPUT_MODE, PRAXIS_ASSISTANT_VOICE_LANGUAGE, PraxisAi, PraxisAiAssistantComponent, PraxisAiAssistantDockComponent, PraxisAiAssistantSessionHostComponent, PraxisAiAssistantShellComponent, PraxisAiService, PraxisAssistantSessionRegistryService, PraxisAssistantTurnController, PraxisAssistantTurnOrchestratorService, SchemaMinifierService, createComponentAuthoringContext, createPraxisAssistantViewportLayout, normalizeAuthoringPrompt, normalizePraxisAssistantAttachmentSummary, normalizePraxisAssistantContextSnapshot, sanitizePraxisAssistantText, shouldRoutePromptToGovernedDecision, submitPraxisAssistantQuickReply, toAiJsonObject, toPraxisAssistantClarificationOption, toPraxisAssistantConversationMessages };
+export { AI_BACKEND_CONFIG_STORE, AI_BACKEND_ENDPOINTS, 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, AgenticAuthoringTurnClientService, AiBackendApiService, AiPatchStreamConnectionError, AiResponseValidatorService, AiRuleWizardDialogComponent, BaseAiAdapter, PRAXIS_ASSISTANT_CONTEXT_ATTACHMENT_LIMIT, PRAXIS_ASSISTANT_CONTEXT_ITEM_LIMIT, PRAXIS_ASSISTANT_CONTEXT_SCHEMA_FIELD_LIMIT, PRAXIS_ASSISTANT_CONTEXT_TEXT_LIMIT, PRAXIS_ASSISTANT_VOICE_INPUT_MODE, PRAXIS_ASSISTANT_VOICE_LANGUAGE, PRAXIS_AUTHORING_SCOPE_POLICY_KIND, PRAXIS_AUTHORING_SCOPE_POLICY_VERSION, PraxisAi, PraxisAiAssistantComponent, PraxisAiAssistantDockComponent, PraxisAiAssistantSessionHostComponent, PraxisAiAssistantShellComponent, PraxisAiService, PraxisAssistantSessionRegistryService, PraxisAssistantTurnController, PraxisAssistantTurnOrchestratorService, SchemaMinifierService, createAuthoringScopePolicyContext, createAuthoringScopePolicySystemMessage, createComponentAuthoringContext, createPraxisAssistantViewportLayout, normalizeAuthoringPrompt, normalizePraxisAssistantAttachmentSummary, normalizePraxisAssistantContextSnapshot, sanitizePraxisAssistantText, shouldRoutePromptToGovernedDecision, submitPraxisAssistantQuickReply, toAiJsonObject, toPraxisAssistantClarificationOption, toPraxisAssistantConversationMessages, withAuthoringScopePolicy, withAuthoringScopePolicyContextHints, withAuthoringScopePolicyMessage };

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@praxisui/ai",
-  "version": "9.0.0-beta.7",
+  "version": "9.0.0-beta.71",
   "description": "AI building blocks and assistant integration for Praxis UI applications.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
-    "@praxisui/core": "^9.0.0-beta.7",
+    "@praxisui/core": "^9.0.0-beta.71",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
@@ -23,6 +23,7 @@
   "keywords": [
     "angular",
     "praxisui",
+    "praxis",
     "ai",
     "assistant",
     "llm",
@@ -39,7 +40,10 @@
     ".": {
       "types": "./types/praxisui-ai.d.ts",
       "default": "./fesm2022/praxisui-ai.mjs"
+    },
+    "./ai/component-registry.json": {
+      "default": "./ai/component-registry.json"
     }
   },
   "type": "module"
-}
+}

package/types/praxisui-ai.d.ts

@@ -19,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: "39e28310b20a9f2bb5e58df32f4f3f98bb1a4236761dfc7d9ee5d18fb588894c";
+declare const AI_CONTRACT_SCHEMA_HASH: "66579be4b7637d3c8579e299388e45b89a17e164e72886f0895e98be5fa83c16";
 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", "intent.resolved", "result", "error", "cancelled"];
@@ -292,6 +292,7 @@ interface AgenticAuthoringSemanticSelectedResourceContract {
     schemaUrl?: string | null;
     submitUrl?: string | null;
     submitMethod?: string | null;
+    label?: string | null;
     [key: string]: AiJsonValue | undefined;
 }
 interface AgenticAuthoringSemanticRetrievalEvidenceContract {
@@ -716,7 +717,7 @@ interface Capability {
     example?: string;
     safetyNotes?: string;
 }
-type RulePropertyType = 'string' | 'boolean' | 'object' | 'enum' | 'number';
+type RulePropertyType = 'string' | 'boolean' | 'object' | 'array' | 'enum' | 'number';
 interface RulePropertyDefinition {
     name: string;
     type: RulePropertyType;
@@ -1397,6 +1398,27 @@ declare abstract class BaseAiAdapter<TConfig = any> implements AiConfigAdapter<T
     protected getCriticalWarnings(patch: any): string[];
 }
 
+type PraxisAuthoringScopeChatMessage = {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+};
+interface PraxisAuthoringScopePolicyOptions {
+    componentId?: string | null;
+    componentType?: string | null;
+    componentLabel?: string | null;
+}
+interface PraxisAuthoringScopePolicyRequest {
+    messages?: PraxisAuthoringScopeChatMessage[] | null;
+    contextHints?: AiJsonObject | null;
+}
+declare const PRAXIS_AUTHORING_SCOPE_POLICY_KIND = "praxis.authoring-scope-policy.v1";
+declare const PRAXIS_AUTHORING_SCOPE_POLICY_VERSION = "1.0";
+declare function createAuthoringScopePolicyContext(options?: PraxisAuthoringScopePolicyOptions): AiJsonObject;
+declare function createAuthoringScopePolicySystemMessage(options?: PraxisAuthoringScopePolicyOptions): PraxisAuthoringScopeChatMessage;
+declare function withAuthoringScopePolicy<TRequest extends PraxisAuthoringScopePolicyRequest>(request: TRequest, options?: PraxisAuthoringScopePolicyOptions): TRequest;
+declare function withAuthoringScopePolicyMessage(messages: readonly PraxisAuthoringScopeChatMessage[] | null | undefined, options?: PraxisAuthoringScopePolicyOptions): PraxisAuthoringScopeChatMessage[];
+declare function withAuthoringScopePolicyContextHints(contextHints: AiJsonObject | null | undefined, options?: PraxisAuthoringScopePolicyOptions): AiJsonObject;
+
 interface AiGovernedDecisionRoutingOptions {
     localCompositionTerms?: readonly string[];
 }
@@ -1467,7 +1489,7 @@ declare class PraxisAiService {
 }
 
 declare const AI_INTENT_CONTRACT_VERSION: "v1.1";
-declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "39e28310b20a9f2bb5e58df32f4f3f98bb1a4236761dfc7d9ee5d18fb588894c";
+declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "66579be4b7637d3c8579e299388e45b89a17e164e72886f0895e98be5fa83c16";
 type AiSchemaContext = AiSchemaContextContract;
 interface AiSuggestionsRequest {
     componentId: string;
@@ -1765,6 +1787,8 @@ declare class AgenticAuthoringTurnClientService {
     private isQuickReply;
     private toPendingClarificationContract;
     private readString;
+    private readDisplayString;
+    private isRedactedDisplayText;
     private toJsonObject;
     private isRecord;
     static ɵfac: i0.ɵɵFactoryDeclaration<AgenticAuthoringTurnClientService, never>;
@@ -2263,6 +2287,7 @@ declare class PraxisAiAssistantComponent implements OnDestroy {
     private acceptStreamEvent;
     private resolveLastEventIdForStream;
     private extractStreamMessage;
+    private resolveStreamStepFromPhase;
     private requestStreamCancel;
     private closeActiveStreamConnection;
     private resetStreamTracking;
@@ -2336,8 +2361,6 @@ declare class PraxisAiAssistantComponent implements OnDestroy {
     private buildValueColorMap;
     private findColumnInPrompt;
     private extractOptionValue;
-    private buildMaskSelectionHints;
-    private extractMaskFromText;
     private resolveComponentId;
     private resolveComponentType;
     private buildSuggestionsRequest;
@@ -2567,6 +2590,7 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     private quickReplyPresentationKind;
     private presentationEvidenceToChip;
     private getContextualActionChips;
+    private publicQuickReplyHint;
     private isGenericContextualActionDescription;
     private trimSentencePunctuation;
     private shortPathLabel;
@@ -2736,5 +2760,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_ENDPOINTS, 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, AgenticAuthoringTurnClientService, AiBackendApiService, AiPatchStreamConnectionError, AiResponseValidatorService, AiRuleWizardDialogComponent, BaseAiAdapter, PRAXIS_ASSISTANT_CONTEXT_ATTACHMENT_LIMIT, PRAXIS_ASSISTANT_CONTEXT_ITEM_LIMIT, PRAXIS_ASSISTANT_CONTEXT_SCHEMA_FIELD_LIMIT, PRAXIS_ASSISTANT_CONTEXT_TEXT_LIMIT, PRAXIS_ASSISTANT_VOICE_INPUT_MODE, PRAXIS_ASSISTANT_VOICE_LANGUAGE, PraxisAi, PraxisAiAssistantComponent, PraxisAiAssistantDockComponent, PraxisAiAssistantSessionHostComponent, PraxisAiAssistantShellComponent, PraxisAiService, PraxisAssistantSessionRegistryService, PraxisAssistantTurnController, PraxisAssistantTurnOrchestratorService, SchemaMinifierService, createComponentAuthoringContext, createPraxisAssistantViewportLayout, normalizeAuthoringPrompt, normalizePraxisAssistantAttachmentSummary, normalizePraxisAssistantContextSnapshot, sanitizePraxisAssistantText, shouldRoutePromptToGovernedDecision, submitPraxisAssistantQuickReply, toAiJsonObject, toPraxisAssistantClarificationOption, 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, AgenticAuthoringSemanticDecisionContract, AgenticAuthoringTurnClientEvent, AgenticAuthoringTurnClientOptions, AgenticAuthoringTurnLifecycleEvent, AgenticAuthoringTurnStreamConnection, AgenticAuthoringTurnStreamConnectionOptions, AgenticAuthoringTurnStreamEnvelope, AgenticAuthoringTurnStreamEnvelopeContract, AgenticAuthoringTurnStreamEnvelopeEvent, AgenticAuthoringTurnStreamLifecycle, AgenticAuthoringTurnStreamRequest, AgenticAuthoringTurnStreamRequestContract, AgenticAuthoringTurnStreamStartOptions, AgenticAuthoringTurnStreamStartResponse, AgenticAuthoringTurnStreamStartResponseContract, AgenticAuthoringTurnStreamStartedEvent, AiAssistantObservationFeedbackRating, AiAssistantObservationFeedbackRatingValue, AiAssistantObservationFeedbackRequest, AiAssistantObservationFeedbackRequestContract, AiAssistantObservationFeedbackResponse, AiAssistantObservationFeedbackResponseContract, AiAssistantObservationResponseContract, AiAssistantObservationSummaryResponseContract, AiAssistantObservationSummaryRowContract, AiAuthoringResponseMode, AiAuthoringResponseModeKind, AiBackendConfigStore, AiBackendEndpoints, AiBackendStorageOptions, AiChatMessage, AiChatMessageContract, AiClarificationUiContract, AiComponentAuthoringContract, AiConfigAdapter, AiConsultativeAuthoringContext, AiContextDTO, AiContextHintsContract, AiContextTemplate, AiContextTemplateMeta, AiCurrentStateDigest, AiCurrentStateDigestContract, AiDomainCatalogContextHintContract, AiDomainCatalogContextHintIntent, AiDomainCatalogContextHintItemType, AiDomainCatalogRelationshipHintContract, AiExamplePair, AiGlobalConfigSnapshot, AiGovernedDecisionRoutingOptions, 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, PraxisAssistantActionContract, PraxisAssistantActionKind, PraxisAssistantAttachmentKind, PraxisAssistantAttachmentSummary, PraxisAssistantAuthoringManifestRef, PraxisAssistantCapabilityRef, PraxisAssistantClarificationOption, PraxisAssistantClarificationQuestion, PraxisAssistantClarificationQuestionType, PraxisAssistantComponentType, PraxisAssistantContextItem, PraxisAssistantContextMode, PraxisAssistantContextSessionDescriptor, PraxisAssistantContextSnapshot, PraxisAssistantConversationMessage, PraxisAssistantConversationMessageRole, PraxisAssistantDigest, PraxisAssistantDockTone, PraxisAssistantGovernanceHint, PraxisAssistantIdentity, PraxisAssistantOpenRequest, PraxisAssistantOpportunityCandidate, PraxisAssistantOpportunityCandidateStatus, PraxisAssistantOpportunityCatalog, PraxisAssistantOpportunityEvidence, PraxisAssistantOpportunityGroup, PraxisAssistantOpportunityMissingContext, PraxisAssistantOpportunitySafety, PraxisAssistantOpportunityTarget, PraxisAssistantOwnerType, PraxisAssistantPendingClarification, PraxisAssistantRecommendedIntent, PraxisAssistantRecommendedIntentAction, PraxisAssistantRecommendedIntentPresentation, PraxisAssistantRecommendedIntentTone, PraxisAssistantRiskLevel, PraxisAssistantSessionDescriptor, PraxisAssistantSessionIdentityRef, PraxisAssistantSessionPresence, PraxisAssistantSessionSnapshot, PraxisAssistantSessionVisibility, PraxisAssistantShellAction, PraxisAssistantShellActionTone, PraxisAssistantShellAttachment, PraxisAssistantShellContextItem, PraxisAssistantShellLabels, PraxisAssistantShellLayout, PraxisAssistantShellMessage, PraxisAssistantShellMessageAction, PraxisAssistantShellMessageRole, PraxisAssistantShellMode, PraxisAssistantShellQuickReply, PraxisAssistantShellQuickReplyEvidence, PraxisAssistantShellQuickReplyPresentation, PraxisAssistantShellQuickReplyPresentationItem, PraxisAssistantShellQuickReplyPresentationKind, PraxisAssistantShellState, PraxisAssistantTargetKind, PraxisAssistantTargetRef, PraxisAssistantTurnAction, PraxisAssistantTurnControllerOptions, PraxisAssistantTurnFlow, PraxisAssistantTurnPhase, PraxisAssistantTurnRequest, PraxisAssistantTurnResult, PraxisAssistantTurnViewState, PraxisAssistantViewportLayoutOptions, PraxisAssistantVoiceCaptureState, PraxisAssistantVoiceInputMode, ProblemResponseContract, PromptContext, RulePropertyDefinition, RulePropertySchema, RulePropertyType, ValidationContext, ValueKind };
+export { AI_BACKEND_CONFIG_STORE, AI_BACKEND_ENDPOINTS, 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, AgenticAuthoringTurnClientService, AiBackendApiService, AiPatchStreamConnectionError, AiResponseValidatorService, AiRuleWizardDialogComponent, BaseAiAdapter, PRAXIS_ASSISTANT_CONTEXT_ATTACHMENT_LIMIT, PRAXIS_ASSISTANT_CONTEXT_ITEM_LIMIT, PRAXIS_ASSISTANT_CONTEXT_SCHEMA_FIELD_LIMIT, PRAXIS_ASSISTANT_CONTEXT_TEXT_LIMIT, PRAXIS_ASSISTANT_VOICE_INPUT_MODE, PRAXIS_ASSISTANT_VOICE_LANGUAGE, PRAXIS_AUTHORING_SCOPE_POLICY_KIND, PRAXIS_AUTHORING_SCOPE_POLICY_VERSION, PraxisAi, PraxisAiAssistantComponent, PraxisAiAssistantDockComponent, PraxisAiAssistantSessionHostComponent, PraxisAiAssistantShellComponent, PraxisAiService, PraxisAssistantSessionRegistryService, PraxisAssistantTurnController, PraxisAssistantTurnOrchestratorService, SchemaMinifierService, createAuthoringScopePolicyContext, createAuthoringScopePolicySystemMessage, createComponentAuthoringContext, createPraxisAssistantViewportLayout, normalizeAuthoringPrompt, normalizePraxisAssistantAttachmentSummary, normalizePraxisAssistantContextSnapshot, sanitizePraxisAssistantText, shouldRoutePromptToGovernedDecision, submitPraxisAssistantQuickReply, toAiJsonObject, toPraxisAssistantClarificationOption, toPraxisAssistantConversationMessages, withAuthoringScopePolicy, withAuthoringScopePolicyContextHints, withAuthoringScopePolicyMessage };
+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, AgenticAuthoringSemanticDecisionContract, AgenticAuthoringTurnClientEvent, AgenticAuthoringTurnClientOptions, AgenticAuthoringTurnLifecycleEvent, AgenticAuthoringTurnStreamConnection, AgenticAuthoringTurnStreamConnectionOptions, AgenticAuthoringTurnStreamEnvelope, AgenticAuthoringTurnStreamEnvelopeContract, AgenticAuthoringTurnStreamEnvelopeEvent, AgenticAuthoringTurnStreamLifecycle, AgenticAuthoringTurnStreamRequest, AgenticAuthoringTurnStreamRequestContract, AgenticAuthoringTurnStreamStartOptions, AgenticAuthoringTurnStreamStartResponse, AgenticAuthoringTurnStreamStartResponseContract, AgenticAuthoringTurnStreamStartedEvent, AiAssistantObservationFeedbackRating, AiAssistantObservationFeedbackRatingValue, AiAssistantObservationFeedbackRequest, AiAssistantObservationFeedbackRequestContract, AiAssistantObservationFeedbackResponse, AiAssistantObservationFeedbackResponseContract, AiAssistantObservationResponseContract, AiAssistantObservationSummaryResponseContract, AiAssistantObservationSummaryRowContract, AiAuthoringResponseMode, AiAuthoringResponseModeKind, AiBackendConfigStore, AiBackendEndpoints, AiBackendStorageOptions, AiChatMessage, AiChatMessageContract, AiClarificationUiContract, AiComponentAuthoringContract, AiConfigAdapter, AiConsultativeAuthoringContext, AiContextDTO, AiContextHintsContract, AiContextTemplate, AiContextTemplateMeta, AiCurrentStateDigest, AiCurrentStateDigestContract, AiDomainCatalogContextHintContract, AiDomainCatalogContextHintIntent, AiDomainCatalogContextHintItemType, AiDomainCatalogRelationshipHintContract, AiExamplePair, AiGlobalConfigSnapshot, AiGovernedDecisionRoutingOptions, 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, PraxisAssistantActionContract, PraxisAssistantActionKind, PraxisAssistantAttachmentKind, PraxisAssistantAttachmentSummary, PraxisAssistantAuthoringManifestRef, PraxisAssistantCapabilityRef, PraxisAssistantClarificationOption, PraxisAssistantClarificationQuestion, PraxisAssistantClarificationQuestionType, PraxisAssistantComponentType, PraxisAssistantContextItem, PraxisAssistantContextMode, PraxisAssistantContextSessionDescriptor, PraxisAssistantContextSnapshot, PraxisAssistantConversationMessage, PraxisAssistantConversationMessageRole, PraxisAssistantDigest, PraxisAssistantDockTone, PraxisAssistantGovernanceHint, PraxisAssistantIdentity, PraxisAssistantOpenRequest, PraxisAssistantOpportunityCandidate, PraxisAssistantOpportunityCandidateStatus, PraxisAssistantOpportunityCatalog, PraxisAssistantOpportunityEvidence, PraxisAssistantOpportunityGroup, PraxisAssistantOpportunityMissingContext, PraxisAssistantOpportunitySafety, PraxisAssistantOpportunityTarget, PraxisAssistantOwnerType, PraxisAssistantPendingClarification, PraxisAssistantRecommendedIntent, PraxisAssistantRecommendedIntentAction, PraxisAssistantRecommendedIntentPresentation, PraxisAssistantRecommendedIntentTone, PraxisAssistantRiskLevel, PraxisAssistantSessionDescriptor, PraxisAssistantSessionIdentityRef, PraxisAssistantSessionPresence, PraxisAssistantSessionSnapshot, PraxisAssistantSessionVisibility, PraxisAssistantShellAction, PraxisAssistantShellActionTone, PraxisAssistantShellAttachment, PraxisAssistantShellContextItem, PraxisAssistantShellLabels, PraxisAssistantShellLayout, PraxisAssistantShellMessage, PraxisAssistantShellMessageAction, PraxisAssistantShellMessageRole, PraxisAssistantShellMode, PraxisAssistantShellQuickReply, PraxisAssistantShellQuickReplyEvidence, PraxisAssistantShellQuickReplyPresentation, PraxisAssistantShellQuickReplyPresentationItem, PraxisAssistantShellQuickReplyPresentationKind, PraxisAssistantShellState, PraxisAssistantTargetKind, PraxisAssistantTargetRef, PraxisAssistantTurnAction, PraxisAssistantTurnControllerOptions, PraxisAssistantTurnFlow, PraxisAssistantTurnPhase, PraxisAssistantTurnRequest, PraxisAssistantTurnResult, PraxisAssistantTurnViewState, PraxisAssistantViewportLayoutOptions, PraxisAssistantVoiceCaptureState, PraxisAssistantVoiceInputMode, PraxisAuthoringScopeChatMessage, PraxisAuthoringScopePolicyOptions, PraxisAuthoringScopePolicyRequest, ProblemResponseContract, PromptContext, RulePropertyDefinition, RulePropertySchema, RulePropertyType, ValidationContext, ValueKind };