@praxisui/ai 9.0.0-beta.4 → 9.0.0-beta.40

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-06T15:31:28.393Z",
+  "packageName": "@praxisui/ai",
+  "packageVersion": "9.0.0-beta.40",
+  "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,10 +403,10 @@ 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 = 'daab9623a5c4d660105dfe1c85a6bd1ee1ef1b54ef5981e26d27c44aa82ddb4f';
+const AI_CONTRACT_SCHEMA_HASH = '39e28310b20a9f2bb5e58df32f4f3f98bb1a4236761dfc7d9ee5d18fb588894c';
 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', 'result', 'error', 'cancelled'];
+const AI_STREAM_EVENT_TYPES = ['status', 'thought.step', 'heartbeat', 'intent.resolved', 'result', 'error', 'cancelled'];
 
 function createComponentAuthoringContext(authoringContract) {
     return {
@@ -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;
         }
@@ -5948,7 +6038,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 +6164,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 +6175,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;
@@ -8215,18 +8341,13 @@ class PraxisAiAssistantShellComponent {
         return action.id;
     }
     hasRecoverableTurn() {
-        if (this.busy && this.state !== 'processing') {
-            return false;
-        }
         if (this.state === 'idle' || this.state === 'listening') {
             return false;
         }
-        return this.messages.length > 0
-            || this.quickReplies.length > 0
-            || this.canApply
-            || this.state === 'clarification'
-            || this.state === 'review'
-            || this.state === 'error';
+        if (this.state === 'processing' || this.state === 'applying') {
+            return true;
+        }
+        return this.state === 'clarification';
     }
     updateProcessingTimer() {
         if (this.state !== 'processing') {
@@ -8261,6 +8382,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.';
         }
@@ -8335,11 +8459,7 @@ class PraxisAiAssistantShellComponent {
                     tone: 'warning',
                 };
             case 'success':
-                return {
-                    ...base,
-                    label: 'Novo pedido',
-                    icon: 'add_comment',
-                };
+                return base;
             case 'idle':
             case 'listening':
             default:
@@ -8506,6 +8626,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)) {
@@ -8840,10 +8961,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) {
@@ -8852,11 +8979,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',
@@ -8887,6 +9016,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')
@@ -10652,4 +10785,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.4",
+  "version": "9.0.0-beta.40",
   "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.4",
+    "@praxisui/core": "^9.0.0-beta.40",
     "@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,10 +19,10 @@ 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: "daab9623a5c4d660105dfe1c85a6bd1ee1ef1b54ef5981e26d27c44aa82ddb4f";
+declare const AI_CONTRACT_SCHEMA_HASH: "39e28310b20a9f2bb5e58df32f4f3f98bb1a4236761dfc7d9ee5d18fb588894c";
 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"];
+declare const AI_STREAM_EVENT_TYPES: readonly ["status", "thought.step", "heartbeat", "intent.resolved", "result", "error", "cancelled"];
 type AiJsonPrimitive = string | number | boolean | null;
 type AiJsonArray = AiJsonValue[];
 interface AiJsonObject {
@@ -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: "daab9623a5c4d660105dfe1c85a6bd1ee1ef1b54ef5981e26d27c44aa82ddb4f";
+declare const AI_INTENT_CONTRACT_SCHEMA_HASH: "39e28310b20a9f2bb5e58df32f4f3f98bb1a4236761dfc7d9ee5d18fb588894c";
 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;
@@ -2567,6 +2592,7 @@ declare class PraxisAiAssistantShellComponent implements OnChanges, OnDestroy {
     private quickReplyPresentationKind;
     private presentationEvidenceToChip;
     private getContextualActionChips;
+    private publicQuickReplyHint;
     private isGenericContextualActionDescription;
     private trimSentencePunctuation;
     private shortPathLabel;
@@ -2736,5 +2762,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 };