@praxisui/expansion 8.0.0-beta.20 → 8.0.0-beta.21

package/README.md

@@ -240,6 +240,13 @@ Ele modela edicoes em `ExpansionMetadata` por operacoes atomicas sobre paineis,
 cabecalhos, conteudo lazy, estado expandido/desabilitado e comportamento do
 accordion.
 
+Quando `enableCustomization` esta ativo, o runtime abre o `PraxisAiAssistantShellComponent`
+com contexto semantico dos paineis e registra a sessao no dock global de assistentes.
+O assistente envia estado atual, perfil dos paineis, campos de schema e referencia ao
+manifesto de authoring para a IA. Patches JSON livres nao sao aplicados no runtime:
+mudancas locais devem nascer de um `componentEditPlan` validado pelo manifesto, e
+regras compartilhadas seguem por `domain-rules/intake`.
+
 Cobertura principal:
 
 - `panel.add`, `panel.remove`, `panel.order.set`

package/fesm2022/praxisui-expansion.mjs

@@ -1,7 +1,7 @@
 import * as i1 from '@angular/common';
 import { CommonModule } from '@angular/common';
 import * as i0 from '@angular/core';
-import { EventEmitter, inject, ChangeDetectorRef, DestroyRef, ViewChildren, ViewChild, Output, Input, ChangeDetectionStrategy, Component, Inject, ENVIRONMENT_INITIALIZER } from '@angular/core';
+import { EventEmitter, inject, ChangeDetectorRef, DestroyRef, effect, ViewChildren, ViewChild, Output, Input, ChangeDetectionStrategy, Component, Inject, ENVIRONMENT_INITIALIZER } from '@angular/core';
 import { ActivatedRoute } from '@angular/router';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import * as i2 from '@angular/material/expansion';
@@ -21,9 +21,9 @@ import { MatTooltipModule } from '@angular/material/tooltip';
 import { DynamicFieldLoaderDirective } from '@praxisui/dynamic-fields';
 import { deepMerge, ASYNC_CONFIG_STORAGE, DynamicFormService, ComponentKeyService, DynamicWidgetLoaderDirective, PraxisIconDirective, ComponentMetadataRegistry } from '@praxisui/core';
 import { SettingsPanelService, SETTINGS_PANEL_DATA } from '@praxisui/settings-panel';
-import { BehaviorSubject } from 'rxjs';
+import { firstValueFrom, BehaviorSubject, Subscription } from 'rxjs';
 import { take } from 'rxjs/operators';
-import { BaseAiAdapter, PraxisAiAssistantComponent } from '@praxisui/ai';
+import { BaseAiAdapter, AiBackendApiService, PraxisAssistantSessionRegistryService, PraxisAssistantTurnOrchestratorService, createPraxisAssistantViewportLayout, PraxisAiAssistantShellComponent } from '@praxisui/ai';
 
 /**
  * Capabilities catalog for Praxis Expansion (ExpansionMetadata).
@@ -105,6 +105,8 @@ const EXPANSION_AI_CAPABILITIES = {
 
 class ExpansionAiAdapter extends BaseAiAdapter {
     expansion;
+    componentId = 'praxis-expansion';
+    componentType = 'expansion';
     componentName = 'Praxis Expansion';
     constructor(expansion) {
         super();
@@ -125,6 +127,43 @@ class ExpansionAiAdapter extends BaseAiAdapter {
             multi: this.expansion.config?.accordion?.multi ?? false,
         };
     }
+    getDataProfile() {
+        const panels = this.getCurrentConfig().panels || [];
+        return {
+            expansionId: this.expansion.expansionId,
+            panelCount: panels.length,
+            contentPanelCount: panels.filter((panel) => Array.isArray(panel.content) && panel.content.length > 0).length,
+            widgetPanelCount: panels.filter((panel) => Array.isArray(panel.widgets) && panel.widgets.length > 0).length,
+            actionPanelCount: panels.filter((panel) => Array.isArray(panel.actionButtons) && panel.actionButtons.length > 0).length,
+            multi: this.expansion.config?.accordion?.multi ?? false,
+            displayMode: this.expansion.config?.accordion?.displayMode || 'default',
+        };
+    }
+    getSchemaFields() {
+        return (this.getCurrentConfig().panels || []).map((panel, index) => ({
+            name: panel.id || panel.title || `panel-${index + 1}`,
+            label: panel.title || panel.id || `Painel ${index + 1}`,
+            disabled: !!panel.disabled,
+            expanded: !!panel.expanded,
+            hasContent: Array.isArray(panel.content) && panel.content.length > 0,
+            hasWidgets: Array.isArray(panel.widgets) && panel.widgets.length > 0,
+            hasActions: Array.isArray(panel.actionButtons) && panel.actionButtons.length > 0,
+        }));
+    }
+    getAuthoringContext() {
+        return {
+            authoringManifestRef: 'PRAXIS_EXPANSION_AUTHORING_MANIFEST',
+            runtimeAuthoringPolicy: {
+                mode: 'agentic-authoring',
+                enableCustomization: !!this.expansion.enableCustomization,
+                canApplyLocalPatch: false,
+                reason: 'praxis-expansion exige componentEditPlan validado pelo manifesto antes de aplicar mudancas runtime.',
+            },
+            domainCatalog: {
+                recommendedAuthoringFlow: 'component_authoring',
+            },
+        };
+    }
     createSnapshot() {
         return this.getCurrentConfig();
     }
@@ -185,6 +224,280 @@ class ExpansionAiAdapter extends BaseAiAdapter {
     }
 }
 
+class ExpansionAgenticAuthoringTurnFlow {
+    adapter;
+    aiApi;
+    mode = 'agentic-authoring';
+    constructor(adapter, aiApi) {
+        this.adapter = adapter;
+        this.aiApi = aiApi;
+    }
+    async submit(request) {
+        const prompt = (request.prompt ?? '').trim();
+        if (!prompt)
+            return { state: 'listening', phase: 'capture', statusText: '' };
+        const componentId = this.adapter.componentId || request.componentId || 'praxis-expansion';
+        const componentType = this.adapter.componentType || request.componentType || 'expansion';
+        const currentState = this.toAiJsonObject(this.adapter.getCurrentConfig());
+        const dataProfile = this.optionalJsonObject(this.adapter.getDataProfile?.());
+        const runtimeState = this.optionalJsonObject(this.adapter.getRuntimeState?.());
+        const schemaFields = this.adapter.getSchemaFields?.()
+            ?.map((field) => this.toAiJsonObject(field))
+            .filter((field) => Object.keys(field).length > 0);
+        const contextHints = this.optionalJsonObject(this.adapter.getAuthoringContext?.());
+        if (this.shouldRouteToGovernedDecision(prompt, contextHints)) {
+            return this.toGovernedDecisionHandoff(prompt, request);
+        }
+        const response = await firstValueFrom(this.aiApi.getPatch({
+            componentId,
+            componentType,
+            userPrompt: prompt,
+            sessionId: request.sessionId,
+            clientTurnId: request.clientTurnId,
+            messages: this.toChatMessages(request.messages, prompt),
+            currentState,
+            currentStateDigest: this.buildCurrentStateDigest(dataProfile),
+            uiContextRef: { componentId, componentType },
+            ...(dataProfile ? { dataProfile } : {}),
+            ...(runtimeState ? { runtimeState } : {}),
+            ...(schemaFields?.length ? { schemaFields } : {}),
+            ...(contextHints ? { contextHints } : {}),
+        }));
+        return this.toTurnResult(this.compileAdapterResponse(response), request);
+    }
+    async apply(_request) {
+        return {
+            state: 'error',
+            phase: 'apply',
+            assistantMessage: 'O expansion ainda exige componentEditPlan validado pelo manifesto antes de aplicar mudancas locais.',
+            errorText: 'Aplicacao local bloqueada ate existir compilacao manifest-backed para praxis-expansion.',
+            canApply: false,
+            pendingPatch: null,
+        };
+    }
+    cancel() {
+        return Promise.resolve({
+            state: 'listening',
+            phase: 'capture',
+            assistantMessage: 'Solicitacao cancelada.',
+            statusText: '',
+            canApply: false,
+            pendingPatch: null,
+            pendingClarification: null,
+        });
+    }
+    retry(request) {
+        const lastPrompt = [...(request.messages ?? [])].reverse()
+            .find((message) => message.role === 'user')?.text;
+        return this.submit({ ...request, prompt: lastPrompt ?? request.prompt, action: { kind: 'retry' } });
+    }
+    toTurnResult(response, request) {
+        if (!response) {
+            return { state: 'error', phase: 'capture', assistantMessage: 'Resposta vazia da IA.', errorText: 'Resposta vazia da IA.' };
+        }
+        if (response.type === 'clarification') {
+            return {
+                state: 'clarification',
+                phase: 'clarify',
+                sessionId: response.sessionId ?? request.sessionId,
+                assistantMessage: response.message || 'Preciso de mais detalhes para continuar.',
+                clarificationQuestions: this.toClarificationQuestions(response),
+                quickReplies: this.toQuickReplies(response),
+                canApply: false,
+            };
+        }
+        if (response.type === 'info') {
+            const message = response.message || response.explanation || 'Informacao gerada.';
+            return { state: 'success', phase: 'summarize', sessionId: response.sessionId ?? request.sessionId, assistantMessage: message, statusText: message, canApply: false };
+        }
+        if (response.type === 'error') {
+            const message = response.message || 'Falha ao gerar alteracao de expansion.';
+            return {
+                state: 'error',
+                phase: 'capture',
+                sessionId: response.sessionId ?? request.sessionId,
+                assistantMessage: message,
+                errorText: message,
+                diagnostics: response.warnings?.length ? { warnings: response.warnings } : undefined,
+            };
+        }
+        if (response.patch && Object.keys(response.patch).length > 0) {
+            return {
+                state: 'error',
+                phase: 'review',
+                sessionId: response.sessionId ?? request.sessionId,
+                assistantMessage: 'O expansion rejeitou patch livre. Gere um componentEditPlan validado pelo PRAXIS_EXPANSION_AUTHORING_MANIFEST antes de propor alteracao local.',
+                errorText: 'Patch livre de expansion rejeitado.',
+                canApply: false,
+                pendingPatch: null,
+                diagnostics: {
+                    warnings: [
+                        'free-expansion-patch-rejected',
+                        'Use componentEditPlan validado contra PRAXIS_EXPANSION_AUTHORING_MANIFEST.',
+                    ],
+                },
+            };
+        }
+        return {
+            state: 'success',
+            phase: 'summarize',
+            sessionId: response.sessionId ?? request.sessionId,
+            assistantMessage: response.message || response.explanation || 'Nenhuma alteracao necessaria.',
+            statusText: response.message || response.explanation || 'Nenhuma alteracao necessaria.',
+            canApply: false,
+        };
+    }
+    compileAdapterResponse(response) {
+        const compiled = this.adapter.compileAiResponse?.(response);
+        if (!compiled)
+            return response;
+        if (compiled.type === 'error') {
+            return {
+                type: 'error',
+                message: compiled.message || 'O componentEditPlan do expansion nao passou na validacao de capacidades.',
+                warnings: compiled.warnings,
+            };
+        }
+        const warnings = [...(response.warnings ?? []), ...(compiled.warnings ?? [])];
+        return { ...response, ...compiled, patch: compiled.patch, warnings: warnings.length ? warnings : undefined };
+    }
+    toChatMessages(messages, prompt) {
+        const supported = (messages ?? [])
+            .filter((message) => message.role === 'user' || message.role === 'assistant' || message.role === 'system')
+            .map((message) => ({ role: message.role, content: message.text }))
+            .filter((message) => message.content.trim().length > 0);
+        return supported.length ? supported : [{ role: 'user', content: prompt }];
+    }
+    toClarificationQuestions(response) {
+        const labels = response.questions?.length
+            ? response.questions
+            : response.message ? [response.message] : ['Qual ajuste voce quer aplicar nos paineis?'];
+        const options = this.toQuickReplies(response).map((reply) => ({ id: reply.id, label: reply.label, value: reply.prompt }));
+        return labels.map((label, index) => ({
+            id: `expansion-clarification-${index + 1}`,
+            type: options.length ? 'single-choice' : 'text',
+            label,
+            allowCustom: true,
+            options,
+        }));
+    }
+    toQuickReplies(response) {
+        const payloads = response.optionPayloads ?? [];
+        if (payloads.length) {
+            return payloads.map((option, index) => {
+                const label = option.label?.trim() || option.value?.trim() || `Opcao ${index + 1}`;
+                const prompt = option.example?.trim() || option.value?.trim() || label;
+                return { id: `option-${index + 1}`, label, prompt, kind: 'clarification-option' };
+            });
+        }
+        return (response.options ?? [])
+            .filter((option) => !!option?.trim())
+            .map((option, index) => ({ id: `option-${index + 1}`, label: option.trim(), prompt: option.trim(), kind: 'clarification-option' }));
+    }
+    buildCurrentStateDigest(dataProfile) {
+        const panelCount = typeof dataProfile?.['panelCount'] === 'number' ? dataProfile['panelCount'] : undefined;
+        return panelCount !== undefined ? { rowCount: panelCount } : {};
+    }
+    shouldRouteToGovernedDecision(prompt, contextHints) {
+        const normalized = prompt.normalize('NFD').replace(/[\u0300-\u036f]/g, '').toLowerCase();
+        const recommendedFlow = this.toRecord(contextHints?.['domainCatalog'])?.['recommendedAuthoringFlow'];
+        if (recommendedFlow === 'shared_rule_authoring')
+            return true;
+        return [
+            'regra',
+            'politica',
+            'policy',
+            'compliance',
+            'lgpd',
+            'privacidade',
+            'aprovacao',
+            'aprovar',
+            'publicar',
+            'materializar',
+            'enforcement',
+            'validacao de negocio',
+            'validar negocio',
+            'elegibilidade',
+            'permissao',
+            'acesso',
+        ].some((term) => normalized.includes(term));
+    }
+    toGovernedDecisionHandoff(prompt, request) {
+        const message = 'Esse pedido parece alterar uma decisao de negocio compartilhada. O expansion pode localizar o painel e a experiencia afetada, mas a regra deve seguir pelo fluxo governado de domain-rules antes de qualquer materializacao runtime.';
+        return {
+            state: 'clarification',
+            phase: 'clarify',
+            sessionId: request.sessionId,
+            assistantMessage: message,
+            statusText: 'Handoff governado necessario.',
+            canApply: false,
+            quickReplies: [
+                {
+                    id: 'shared-rule-handoff',
+                    label: 'Continuar como regra governada',
+                    prompt,
+                    kind: 'shared-rule-handoff',
+                    description: 'Criar intake de domain-rules em vez de aplicar patch local no expansion.',
+                    icon: 'rule',
+                    tone: 'warning',
+                    contextHints: {
+                        flowId: 'shared_rule_authoring',
+                        source: 'praxis-expansion',
+                        recommendedAction: 'domain-rules/intake',
+                    },
+                },
+            ],
+            clarificationQuestions: [
+                {
+                    id: 'expansion-governed-rule-confirmation',
+                    type: 'confirm',
+                    label: 'Deseja continuar pelo fluxo governado de regras compartilhadas?',
+                    description: 'Esse caminho permite intake, simulacao, aprovacao/publicacao, materializacao e validacao de enforcement.',
+                    required: true,
+                    options: [
+                        {
+                            id: 'shared-rule-handoff',
+                            label: 'Sim, continuar governado',
+                            value: prompt,
+                            description: 'Nao aplicar como patch local do expansion.',
+                            contextHints: { flowId: 'shared_rule_authoring', source: 'praxis-expansion' },
+                        },
+                    ],
+                },
+            ],
+            diagnostics: {
+                governedDecisionHandoff: {
+                    flowId: 'shared_rule_authoring',
+                    sourcePrompt: prompt,
+                    sourceComponent: 'praxis-expansion',
+                },
+            },
+        };
+    }
+    optionalJsonObject(value) {
+        if (value === undefined || value === null)
+            return undefined;
+        const object = this.toAiJsonObject(value);
+        return Object.keys(object).length ? object : undefined;
+    }
+    toAiJsonObject(value) {
+        const record = this.toRecord(value);
+        if (!record)
+            return {};
+        try {
+            return JSON.parse(JSON.stringify(record));
+        }
+        catch {
+            return {};
+        }
+    }
+    toRecord(value) {
+        return value && typeof value === 'object' && !Array.isArray(value)
+            ? value
+            : null;
+    }
+}
+
 class PraxisExpansion {
     config;
     expansionId;
@@ -212,9 +525,35 @@ class PraxisExpansion {
     catch {
         return undefined;
     } })();
+    aiApi = inject(AiBackendApiService);
+    assistantSessions = inject(PraxisAssistantSessionRegistryService);
+    aiTurnOrchestrator = inject(PraxisAssistantTurnOrchestratorService);
+    aiAssistantSessionEffect = effect(() => {
+        const session = this.assistantSessions.activeSession();
+        if (!session || session.id !== this.resolveAiAssistantSessionId())
+            return;
+        if (!this.aiAssistantOpen) {
+            this.openAiAssistantFromSession(session);
+        }
+    }, ...(ngDevMode ? [{ debugName: "aiAssistantSessionEffect" }] : []));
     warnedMissingId = false;
     panelForms = new Map();
     aiAdapter = new ExpansionAiAdapter(this);
+    aiAssistantOpen = false;
+    aiAssistantPrompt = '';
+    aiAssistantViewState = null;
+    aiAssistantLayout = createPraxisAssistantViewportLayout();
+    aiAssistantLabels = {
+        title: 'Copiloto semantico Praxis',
+        subtitle: 'Converse, revise e governe ajustes dos paineis.',
+        prompt: 'Mensagem',
+        promptPlaceholder: 'Descreva o ajuste que voce precisa nos paineis.',
+        emptyConversation: 'Diga o que voce quer alterar no expansion.',
+        submit: 'Interpretar pedido',
+        apply: 'Aplicar ajuste',
+    };
+    aiAssistantController = null;
+    aiAssistantStateSubscription = null;
     accordionRef;
     panels;
     injectedDefaults = inject(MAT_EXPANSION_PANEL_DEFAULT_OPTIONS, { optional: true });
@@ -238,6 +577,10 @@ class PraxisExpansion {
             this.persistConfig(this.config);
         }
     }
+    ngOnDestroy() {
+        this.assistantSessions.removeContextSession(this.buildAiAssistantContextSnapshot().identity);
+        this.aiAssistantStateSubscription?.unsubscribe();
+    }
     styleCss() {
         const t = this.config?.appearance?.tokens;
         const appearance = this.config?.appearance;
@@ -477,6 +820,306 @@ class PraxisExpansion {
         }
         this.cdr.markForCheck();
     }
+    openAiAssistant() {
+        this.initializeAiAssistantController();
+        this.aiAssistantOpen = true;
+        this.aiAssistantController?.setContextItems(this.buildAiAssistantContextItems());
+        this.syncAiAssistantSession('active');
+        this.cdr.markForCheck();
+    }
+    openAiAssistantFromSession(session) {
+        if (session.id !== this.resolveAiAssistantSessionId())
+            return;
+        this.initializeAiAssistantController();
+        this.aiAssistantOpen = true;
+        this.aiAssistantController?.setContextItems(this.buildAiAssistantContextItems());
+        this.syncAiAssistantSession('active');
+        this.cdr.markForCheck();
+    }
+    closeAiAssistant() {
+        this.aiAssistantOpen = false;
+        this.syncAiAssistantSession('minimized');
+        this.cdr.markForCheck();
+    }
+    onAiAssistantPromptChange(prompt) {
+        this.aiAssistantPrompt = prompt;
+        this.syncAiAssistantSession();
+    }
+    onAiAssistantSubmit(prompt) {
+        this.aiAssistantController?.submitPrompt(prompt).subscribe((state) => {
+            this.aiAssistantPrompt = '';
+            this.aiAssistantViewState = state;
+            this.syncAiAssistantSession();
+            this.cdr.markForCheck();
+        });
+    }
+    onAiAssistantApply() {
+        this.aiAssistantController?.apply().subscribe((state) => {
+            this.aiAssistantViewState = state;
+            this.syncAiAssistantSession();
+            this.cdr.markForCheck();
+        });
+    }
+    onAiAssistantRetry() {
+        this.aiAssistantController?.retry().subscribe((state) => {
+            this.aiAssistantViewState = state;
+            this.syncAiAssistantSession();
+            this.cdr.markForCheck();
+        });
+    }
+    onAiAssistantCancel() {
+        this.aiAssistantController?.cancel().subscribe((state) => {
+            this.aiAssistantPrompt = '';
+            this.aiAssistantViewState = state;
+            this.syncAiAssistantSession();
+            this.cdr.markForCheck();
+        });
+    }
+    onAiAssistantQuickReply(reply) {
+        const controller = this.aiAssistantController;
+        if (!controller)
+            return;
+        const state = controller.snapshot();
+        const next$ = state.state === 'clarification'
+            ? controller.answerClarification(reply.prompt)
+            : controller.submitPrompt(reply.prompt, {
+                kind: reply.kind || 'quick-reply',
+                id: reply.id,
+                value: reply.prompt,
+            });
+        next$.subscribe((nextState) => {
+            this.aiAssistantPrompt = '';
+            this.aiAssistantViewState = nextState;
+            this.syncAiAssistantSession();
+            this.cdr.markForCheck();
+        });
+    }
+    onAiAssistantEditMessage(message) {
+        this.aiAssistantPrompt = message.text;
+        this.cdr.markForCheck();
+    }
+    onAiAssistantResendMessage(message) {
+        this.aiAssistantController?.resendMessage(message.id).subscribe((state) => {
+            this.aiAssistantPrompt = '';
+            this.aiAssistantViewState = state;
+            this.syncAiAssistantSession();
+            this.cdr.markForCheck();
+        });
+    }
+    onAiAssistantLayoutChange(layout) {
+        this.aiAssistantLayout = layout;
+    }
+    buildAiAssistantContextItems() {
+        const panels = this.config?.panels ?? [];
+        const items = [
+            {
+                id: 'component',
+                label: 'Componente',
+                value: 'Expansion',
+                kind: 'component',
+                icon: 'unfold_more',
+            },
+            {
+                id: 'expansion-id',
+                label: 'Expansion',
+                value: this.safeAiAssistantExpansionId(),
+                kind: 'custom',
+                icon: 'tag',
+            },
+            {
+                id: 'panels',
+                label: 'Paineis',
+                value: String(panels.length),
+                kind: 'custom',
+                icon: 'view_agenda',
+            },
+        ];
+        const expanded = panels.filter((panel) => panel.expanded).length;
+        if (expanded > 0) {
+            items.push({
+                id: 'expanded-panels',
+                label: 'Expandidos',
+                value: String(expanded),
+                kind: 'custom',
+                icon: 'expand_less',
+            });
+        }
+        return items;
+    }
+    initializeAiAssistantController() {
+        if (this.aiAssistantController)
+            return;
+        const flow = new ExpansionAgenticAuthoringTurnFlow(this.aiAdapter, this.aiApi);
+        const controller = this.aiTurnOrchestrator.createController(flow, {
+            componentId: this.aiAdapter.componentId || 'praxis-expansion',
+            componentType: this.aiAdapter.componentType || 'expansion',
+            contextItems: this.buildAiAssistantContextItems(),
+        });
+        this.aiAssistantController = controller;
+        this.aiAssistantViewState = controller.snapshot();
+        this.aiAssistantStateSubscription?.unsubscribe();
+        this.aiAssistantStateSubscription = controller.state$.subscribe((state) => {
+            this.aiAssistantViewState = state;
+            this.syncAiAssistantSession();
+            this.cdr.markForCheck();
+        });
+        this.cdr.markForCheck();
+    }
+    buildAiAssistantContextSnapshot() {
+        const counts = this.collectAiAssistantCounts();
+        const panelNames = this.collectAiAssistantPanelNames();
+        return {
+            identity: {
+                sessionId: this.resolveAiAssistantSessionId(),
+                ownerId: this.resolveAiAssistantOwnerId(),
+                ownerType: 'expansion',
+                componentId: 'praxis-expansion',
+                componentType: 'expansion',
+                routeKey: this.resolveAiAssistantRouteKey(),
+            },
+            target: {
+                kind: 'component',
+                id: this.resolveAiAssistantOwnerId(),
+                label: this.safeAiAssistantExpansionId(),
+                metadata: {
+                    expansionId: this.safeAiAssistantExpansionId(),
+                    hasCustomization: !!this.enableCustomization,
+                },
+            },
+            contextItems: this.buildAiAssistantContextItems().map((item) => ({
+                id: item.id,
+                label: item.label,
+                value: item.value || '',
+                kind: item.kind,
+            })),
+            mode: 'agentic-authoring',
+            authoringManifestRef: {
+                componentId: 'praxis-expansion',
+                source: 'PRAXIS_EXPANSION_AUTHORING_MANIFEST',
+            },
+            schemaFields: panelNames.length ? panelNames : undefined,
+            dataProfileDigest: {
+                summary: `${counts.panelCount} painel(is), ${counts.contentPanelCount} com campo(s), ${counts.widgetPanelCount} com widget(s)`,
+                counts,
+            },
+            runtimeStateDigest: {
+                summary: `Expansion ${this.config?.accordion?.multi ? 'multi' : 'single'}, ${counts.expandedCount} painel(is) expandido(s)`,
+                fields: [
+                    'panels',
+                    'accordion',
+                    'content',
+                    'widgets',
+                ],
+            },
+            capabilityRefs: [
+                {
+                    id: 'expansion.component-edit-plan',
+                    label: 'Plano de edicao de paineis',
+                    source: 'PRAXIS_EXPANSION_AUTHORING_MANIFEST',
+                    risk: 'medium',
+                },
+            ],
+            governanceHints: [
+                {
+                    kind: 'business-rule-boundary',
+                    label: 'Regras compartilhadas exigem governanca',
+                    reason: 'Politicas de acesso, validacoes reutilizaveis e compliance nao devem ser aplicadas como patch local do expansion.',
+                    risk: 'high',
+                },
+            ],
+        };
+    }
+    syncAiAssistantSession(visibility = null) {
+        if (!this.enableCustomization)
+            return;
+        if (!this.aiAssistantOpen && !this.hasAiAssistantSessionState() && visibility !== 'minimized')
+            return;
+        const state = this.aiAssistantViewState;
+        this.assistantSessions.upsertContextSession(this.buildAiAssistantContextSnapshot(), {
+            title: 'Copiloto semantico Praxis',
+            summary: this.resolveAiAssistantSummary(),
+            mode: state?.mode || 'agentic-authoring',
+            state: state?.state || 'idle',
+            visibility: visibility ?? (this.aiAssistantOpen ? 'active' : 'minimized'),
+            badge: this.resolveAiAssistantBadge(),
+            icon: this.resolveAiAssistantIcon(),
+        });
+    }
+    hasAiAssistantSessionState() {
+        return !!this.aiAssistantPrompt.trim()
+            || !!this.aiAssistantViewState?.messages?.length
+            || !!this.aiAssistantViewState?.quickReplies?.length
+            || !!this.aiAssistantViewState?.pendingPatch
+            || !!this.aiAssistantViewState?.statusText?.trim()
+            || !!this.aiAssistantViewState?.errorText?.trim();
+    }
+    resolveAiAssistantSessionId() {
+        return `expansion:${this.resolveAiAssistantRouteKey()}:${this.resolveAiAssistantOwnerId()}`;
+    }
+    resolveAiAssistantOwnerId() {
+        return (this.componentInstanceId || this.safeAiAssistantExpansionId() || 'expansion').trim() || 'expansion';
+    }
+    safeAiAssistantExpansionId() {
+        return String(this.expansionId || '').trim();
+    }
+    resolveAiAssistantRouteKey() {
+        const routePath = this.route?.snapshot?.routeConfig?.path?.trim();
+        return routePath || 'local';
+    }
+    resolveAiAssistantSummary() {
+        const status = this.aiAssistantViewState?.statusText?.trim();
+        if (status)
+            return status;
+        const error = this.aiAssistantViewState?.errorText?.trim();
+        if (error)
+            return error;
+        const prompt = this.aiAssistantPrompt.trim();
+        if (prompt)
+            return prompt.length > 96 ? `${prompt.slice(0, 93)}...` : prompt;
+        const lastMessage = [...(this.aiAssistantViewState?.messages ?? [])].reverse()
+            .find((message) => message.role === 'assistant' || message.role === 'user');
+        if (lastMessage?.text) {
+            return lastMessage.text.length > 96 ? `${lastMessage.text.slice(0, 93)}...` : lastMessage.text;
+        }
+        return 'Assistente contextual dos paineis.';
+    }
+    resolveAiAssistantBadge() {
+        const state = this.aiAssistantViewState?.state;
+        if (state === 'error')
+            return 'erro';
+        if (state === 'clarification')
+            return 'revisar';
+        if (state === 'review')
+            return 'preview';
+        if (state === 'success')
+            return 'ok';
+        return undefined;
+    }
+    resolveAiAssistantIcon() {
+        const state = this.aiAssistantViewState?.state;
+        if (state === 'error')
+            return 'error';
+        if (state === 'clarification')
+            return 'rule';
+        if (state === 'review')
+            return 'rate_review';
+        return 'auto_awesome';
+    }
+    collectAiAssistantPanelNames() {
+        return Array.from(new Set((this.config?.panels ?? [])
+            .map((panel, index) => panel.id || panel.title || `panel-${index + 1}`)
+            .filter((name) => typeof name === 'string' && !!name.trim())));
+    }
+    collectAiAssistantCounts() {
+        const panels = this.config?.panels ?? [];
+        return {
+            panelCount: panels.length,
+            contentPanelCount: panels.filter((panel) => Array.isArray(panel.content) && panel.content.length > 0).length,
+            widgetPanelCount: panels.filter((panel) => Array.isArray(panel.widgets) && panel.widgets.length > 0).length,
+            actionPanelCount: panels.filter((panel) => Array.isArray(panel.actionButtons) && panel.actionButtons.length > 0).length,
+            expandedCount: panels.filter((panel) => !!panel.expanded).length,
+        };
+    }
     openEditor() {
         const key = this.storageKey() || this.expansionId || 'default';
         const ref = this.settings.open({
@@ -574,10 +1217,48 @@ class PraxisExpansion {
 
       @if (enableCustomization) {
         <div class="expansion-ai-assistant">
-          <praxis-ai-assistant [adapter]="aiAdapter"></praxis-ai-assistant>
+          <button
+            mat-mini-fab
+            color="primary"
+            type="button"
+            class="expansion-ai-assistant-trigger"
+            aria-label="Abrir copiloto semantico Praxis dos paineis"
+            data-testid="praxis-expansion-ai-assistant-trigger"
+            (click)="openAiAssistant()"
+          >
+            <mat-icon [praxisIcon]="'auto_awesome'"></mat-icon>
+          </button>
         </div>
       }
 
+      <praxis-ai-assistant-shell
+        *ngIf="aiAssistantOpen && aiAssistantViewState"
+        [labels]="aiAssistantLabels"
+        [mode]="aiAssistantViewState.mode"
+        [state]="aiAssistantViewState.state"
+        [contextItems]="aiAssistantViewState.contextItems"
+        [attachments]="aiAssistantViewState.attachments"
+        [messages]="aiAssistantViewState.messages"
+        [quickReplies]="aiAssistantViewState.quickReplies"
+        [prompt]="aiAssistantPrompt"
+        [statusText]="aiAssistantViewState.statusText"
+        [errorText]="aiAssistantViewState.errorText"
+        [busy]="aiAssistantViewState.state === 'processing' || aiAssistantViewState.state === 'applying'"
+        [canApply]="aiAssistantViewState.canApply"
+        [layout]="aiAssistantLayout"
+        testIdPrefix="praxis-expansion-ai-assistant"
+        (promptChange)="onAiAssistantPromptChange($event)"
+        (submitPrompt)="onAiAssistantSubmit($event)"
+        (apply)="onAiAssistantApply()"
+        (retryTurn)="onAiAssistantRetry()"
+        (cancelTurn)="onAiAssistantCancel()"
+        (quickReply)="onAiAssistantQuickReply($event)"
+        (editMessage)="onAiAssistantEditMessage($event)"
+        (resendMessage)="onAiAssistantResendMessage($event)"
+        (layoutChange)="onAiAssistantLayoutChange($event)"
+        (close)="closeAiAssistant()"
+      ></praxis-ai-assistant-shell>
+
       @if (hasMultiple()) {
         <mat-accordion
           #accordion
@@ -721,7 +1402,7 @@ class PraxisExpansion {
     >
       <mat-icon fontIcon="edit"></mat-icon>
     </button>
-  `, isInline: true, styles: [":host{display:block;position:relative;color:var(--md-sys-color-on-surface)}.praxis-expansion-root{display:block;--p-exp-surface: var(--md-sys-color-surface);--p-exp-surface-container: var(--md-sys-color-surface-container);--p-exp-border: var(--md-sys-color-outline-variant);--p-exp-text: var(--md-sys-color-on-surface);--p-exp-text-muted: var(--md-sys-color-on-surface-variant);--p-exp-focus: var(--md-sys-color-primary);--p-exp-radius: 12px}.mat-expansion-panel{background:var(--p-exp-surface);border:1px solid var(--p-exp-border);border-radius:var(--p-exp-radius);overflow:hidden}.mat-expansion-panel:not(:last-child){margin-bottom:var(--p-exp-panel-gap, 12px)}.mat-expansion-panel-header{background:var(--p-exp-surface-container);color:var(--p-exp-text)}.mat-expansion-panel-header:focus-visible{outline:2px solid var(--p-exp-focus);outline-offset:-2px}.mat-expansion-panel-header-title{font-weight:600}.mat-expansion-panel-header-description{color:var(--p-exp-text-muted)}.mat-expansion-panel-body{padding:12px 16px 16px}.mat-action-row{border-top:1px solid var(--p-exp-border)}.density-compact .mat-expansion-panel-body{padding:8px 12px 12px}.density-compact .mat-expansion-panel-header{min-height:40px;padding:0 12px}.density-comfortable .mat-expansion-panel-body{padding:12px 16px 16px}.density-comfortable .mat-expansion-panel-header{min-height:48px;padding:0 16px}.density-spacious .mat-expansion-panel-body{padding:16px 20px 20px}.density-spacious .mat-expansion-panel-header{min-height:56px;padding:0 20px}.praxis-expansion-empty{display:flex;gap:8px;align-items:center;padding:8px 12px;color:var(--p-exp-text-muted)}.edit-fab{position:absolute;right:12px;bottom:12px;z-index:2}.expansion-ai-assistant{position:absolute;right:12px;bottom:72px;z-index:3}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1.NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "directive", type: i1.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "ngmodule", type: MatExpansionModule }, { kind: "directive", type: i2.MatAccordion, selector: "mat-accordion", inputs: ["hideToggle", "displayMode", "togglePosition"], exportAs: ["matAccordion"] }, { kind: "component", type: i2.MatExpansionPanel, selector: "mat-expansion-panel", inputs: ["hideToggle", "togglePosition"], outputs: ["afterExpand", "afterCollapse"], exportAs: ["matExpansionPanel"] }, { kind: "directive", type: i2.MatExpansionPanelActionRow, selector: "mat-action-row" }, { kind: "component", type: i2.MatExpansionPanelHeader, selector: "mat-expansion-panel-header", inputs: ["expandedHeight", "collapsedHeight", "tabIndex"] }, { kind: "directive", type: i2.MatExpansionPanelTitle, selector: "mat-panel-title" }, { kind: "directive", type: i2.MatExpansionPanelDescription, selector: "mat-panel-description" }, { kind: "directive", type: i2.MatExpansionPanelContent, selector: "ng-template[matExpansionPanelContent]" }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i3.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i4.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "component", type: i4.MatFabButton, selector: "button[mat-fab], a[mat-fab], button[matFab], a[matFab]", inputs: ["extended"], exportAs: ["matButton", "matAnchor"] }, { kind: "directive", type: DynamicFieldLoaderDirective, selector: "[dynamicFieldLoader]", inputs: ["fields", "formGroup", "enableExternalControlBinding", "itemTemplate", "debugTrace", "debugTraceLabel", "readonlyMode", "disabledMode", "presentationMode", "visible", "canvasMode"], outputs: ["componentsCreated", "fieldCreated", "fieldDestroyed", "renderError", "canvasMouseEnter", "canvasMouseLeave", "canvasClick"] }, { kind: "directive", type: DynamicWidgetLoaderDirective, selector: "[dynamicWidgetLoader]", inputs: ["dynamicWidgetLoader", "ownerWidgetKey", "context", "strictValidation", "autoWireOutputs"], outputs: ["widgetEvent", "widgetDiagnostic"], exportAs: ["dynamicWidgetLoader"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "component", type: PraxisAiAssistantComponent, selector: "praxis-ai-assistant", inputs: ["adapter", "riskPolicy", "allowManualPatchEdit"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+  `, isInline: true, styles: [":host{display:block;position:relative;color:var(--md-sys-color-on-surface)}.praxis-expansion-root{display:block;--p-exp-surface: var(--md-sys-color-surface);--p-exp-surface-container: var(--md-sys-color-surface-container);--p-exp-border: var(--md-sys-color-outline-variant);--p-exp-text: var(--md-sys-color-on-surface);--p-exp-text-muted: var(--md-sys-color-on-surface-variant);--p-exp-focus: var(--md-sys-color-primary);--p-exp-radius: 12px}.mat-expansion-panel{background:var(--p-exp-surface);border:1px solid var(--p-exp-border);border-radius:var(--p-exp-radius);overflow:hidden}.mat-expansion-panel:not(:last-child){margin-bottom:var(--p-exp-panel-gap, 12px)}.mat-expansion-panel-header{background:var(--p-exp-surface-container);color:var(--p-exp-text)}.mat-expansion-panel-header:focus-visible{outline:2px solid var(--p-exp-focus);outline-offset:-2px}.mat-expansion-panel-header-title{font-weight:600}.mat-expansion-panel-header-description{color:var(--p-exp-text-muted)}.mat-expansion-panel-body{padding:12px 16px 16px}.mat-action-row{border-top:1px solid var(--p-exp-border)}.density-compact .mat-expansion-panel-body{padding:8px 12px 12px}.density-compact .mat-expansion-panel-header{min-height:40px;padding:0 12px}.density-comfortable .mat-expansion-panel-body{padding:12px 16px 16px}.density-comfortable .mat-expansion-panel-header{min-height:48px;padding:0 16px}.density-spacious .mat-expansion-panel-body{padding:16px 20px 20px}.density-spacious .mat-expansion-panel-header{min-height:56px;padding:0 20px}.praxis-expansion-empty{display:flex;gap:8px;align-items:center;padding:8px 12px;color:var(--p-exp-text-muted)}.edit-fab{position:absolute;right:12px;bottom:12px;z-index:2}.expansion-ai-assistant{position:absolute;right:12px;bottom:72px;z-index:3}.expansion-ai-assistant-trigger{box-shadow:var(--md-sys-elevation-level2, 0 4px 12px rgba(0, 0, 0, .18))}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1.NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "directive", type: i1.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "ngmodule", type: MatExpansionModule }, { kind: "directive", type: i2.MatAccordion, selector: "mat-accordion", inputs: ["hideToggle", "displayMode", "togglePosition"], exportAs: ["matAccordion"] }, { kind: "component", type: i2.MatExpansionPanel, selector: "mat-expansion-panel", inputs: ["hideToggle", "togglePosition"], outputs: ["afterExpand", "afterCollapse"], exportAs: ["matExpansionPanel"] }, { kind: "directive", type: i2.MatExpansionPanelActionRow, selector: "mat-action-row" }, { kind: "component", type: i2.MatExpansionPanelHeader, selector: "mat-expansion-panel-header", inputs: ["expandedHeight", "collapsedHeight", "tabIndex"] }, { kind: "directive", type: i2.MatExpansionPanelTitle, selector: "mat-panel-title" }, { kind: "directive", type: i2.MatExpansionPanelDescription, selector: "mat-panel-description" }, { kind: "directive", type: i2.MatExpansionPanelContent, selector: "ng-template[matExpansionPanelContent]" }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i3.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i4.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "component", type: i4.MatMiniFabButton, selector: "button[mat-mini-fab], a[mat-mini-fab], button[matMiniFab], a[matMiniFab]", exportAs: ["matButton", "matAnchor"] }, { kind: "component", type: i4.MatFabButton, selector: "button[mat-fab], a[mat-fab], button[matFab], a[matFab]", inputs: ["extended"], exportAs: ["matButton", "matAnchor"] }, { kind: "directive", type: DynamicFieldLoaderDirective, selector: "[dynamicFieldLoader]", inputs: ["fields", "formGroup", "enableExternalControlBinding", "itemTemplate", "debugTrace", "debugTraceLabel", "readonlyMode", "disabledMode", "presentationMode", "visible", "canvasMode"], outputs: ["componentsCreated", "fieldCreated", "fieldDestroyed", "renderError", "canvasMouseEnter", "canvasMouseLeave", "canvasClick"] }, { kind: "directive", type: DynamicWidgetLoaderDirective, selector: "[dynamicWidgetLoader]", inputs: ["dynamicWidgetLoader", "ownerWidgetKey", "context", "strictValidation", "autoWireOutputs"], outputs: ["widgetEvent", "widgetDiagnostic"], exportAs: ["dynamicWidgetLoader"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "component", type: PraxisAiAssistantShellComponent, selector: "praxis-ai-assistant-shell", inputs: ["labels", "mode", "state", "contextItems", "attachments", "messages", "quickReplies", "prompt", "statusText", "errorText", "testIdPrefix", "panelTestId", "submitTestId", "applyTestId", "primaryAction", "secondaryActions", "governanceActions", "busy", "canSubmit", "canApply", "submitOnEnter", "showAttachAction", "enablePastedAttachments", "enableFileAttachments", "attachmentAccept", "attachmentMultiple", "draggable", "resizable", "minWidth", "minHeight", "margin", "layout"], outputs: ["promptChange", "submitPrompt", "apply", "retryTurn", "cancelTurn", "shellAction", "close", "attach", "attachmentsPasted", "attachmentsSelected", "removeAttachment", "messageAction", "editMessage", "resendMessage", "quickReply", "layoutChange"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PraxisExpansion, decorators: [{
             type: Component,
@@ -733,7 +1414,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
                         DynamicFieldLoaderDirective,
                         DynamicWidgetLoaderDirective,
                         PraxisIconDirective,
-                        PraxisAiAssistantComponent,
+                        PraxisAiAssistantShellComponent,
                     ], template: `
     <div
       class="praxis-expansion-root"
@@ -748,10 +1429,48 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
 
       @if (enableCustomization) {
         <div class="expansion-ai-assistant">
-          <praxis-ai-assistant [adapter]="aiAdapter"></praxis-ai-assistant>
+          <button
+            mat-mini-fab
+            color="primary"
+            type="button"
+            class="expansion-ai-assistant-trigger"
+            aria-label="Abrir copiloto semantico Praxis dos paineis"
+            data-testid="praxis-expansion-ai-assistant-trigger"
+            (click)="openAiAssistant()"
+          >
+            <mat-icon [praxisIcon]="'auto_awesome'"></mat-icon>
+          </button>
         </div>
       }
 
+      <praxis-ai-assistant-shell
+        *ngIf="aiAssistantOpen && aiAssistantViewState"
+        [labels]="aiAssistantLabels"
+        [mode]="aiAssistantViewState.mode"
+        [state]="aiAssistantViewState.state"
+        [contextItems]="aiAssistantViewState.contextItems"
+        [attachments]="aiAssistantViewState.attachments"
+        [messages]="aiAssistantViewState.messages"
+        [quickReplies]="aiAssistantViewState.quickReplies"
+        [prompt]="aiAssistantPrompt"
+        [statusText]="aiAssistantViewState.statusText"
+        [errorText]="aiAssistantViewState.errorText"
+        [busy]="aiAssistantViewState.state === 'processing' || aiAssistantViewState.state === 'applying'"
+        [canApply]="aiAssistantViewState.canApply"
+        [layout]="aiAssistantLayout"
+        testIdPrefix="praxis-expansion-ai-assistant"
+        (promptChange)="onAiAssistantPromptChange($event)"
+        (submitPrompt)="onAiAssistantSubmit($event)"
+        (apply)="onAiAssistantApply()"
+        (retryTurn)="onAiAssistantRetry()"
+        (cancelTurn)="onAiAssistantCancel()"
+        (quickReply)="onAiAssistantQuickReply($event)"
+        (editMessage)="onAiAssistantEditMessage($event)"
+        (resendMessage)="onAiAssistantResendMessage($event)"
+        (layoutChange)="onAiAssistantLayoutChange($event)"
+        (close)="closeAiAssistant()"
+      ></praxis-ai-assistant-shell>
+
       @if (hasMultiple()) {
         <mat-accordion
           #accordion
@@ -895,7 +1614,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
     >
       <mat-icon fontIcon="edit"></mat-icon>
     </button>
-  `, changeDetection: ChangeDetectionStrategy.OnPush, styles: [":host{display:block;position:relative;color:var(--md-sys-color-on-surface)}.praxis-expansion-root{display:block;--p-exp-surface: var(--md-sys-color-surface);--p-exp-surface-container: var(--md-sys-color-surface-container);--p-exp-border: var(--md-sys-color-outline-variant);--p-exp-text: var(--md-sys-color-on-surface);--p-exp-text-muted: var(--md-sys-color-on-surface-variant);--p-exp-focus: var(--md-sys-color-primary);--p-exp-radius: 12px}.mat-expansion-panel{background:var(--p-exp-surface);border:1px solid var(--p-exp-border);border-radius:var(--p-exp-radius);overflow:hidden}.mat-expansion-panel:not(:last-child){margin-bottom:var(--p-exp-panel-gap, 12px)}.mat-expansion-panel-header{background:var(--p-exp-surface-container);color:var(--p-exp-text)}.mat-expansion-panel-header:focus-visible{outline:2px solid var(--p-exp-focus);outline-offset:-2px}.mat-expansion-panel-header-title{font-weight:600}.mat-expansion-panel-header-description{color:var(--p-exp-text-muted)}.mat-expansion-panel-body{padding:12px 16px 16px}.mat-action-row{border-top:1px solid var(--p-exp-border)}.density-compact .mat-expansion-panel-body{padding:8px 12px 12px}.density-compact .mat-expansion-panel-header{min-height:40px;padding:0 12px}.density-comfortable .mat-expansion-panel-body{padding:12px 16px 16px}.density-comfortable .mat-expansion-panel-header{min-height:48px;padding:0 16px}.density-spacious .mat-expansion-panel-body{padding:16px 20px 20px}.density-spacious .mat-expansion-panel-header{min-height:56px;padding:0 20px}.praxis-expansion-empty{display:flex;gap:8px;align-items:center;padding:8px 12px;color:var(--p-exp-text-muted)}.edit-fab{position:absolute;right:12px;bottom:12px;z-index:2}.expansion-ai-assistant{position:absolute;right:12px;bottom:72px;z-index:3}\n"] }]
+  `, changeDetection: ChangeDetectionStrategy.OnPush, styles: [":host{display:block;position:relative;color:var(--md-sys-color-on-surface)}.praxis-expansion-root{display:block;--p-exp-surface: var(--md-sys-color-surface);--p-exp-surface-container: var(--md-sys-color-surface-container);--p-exp-border: var(--md-sys-color-outline-variant);--p-exp-text: var(--md-sys-color-on-surface);--p-exp-text-muted: var(--md-sys-color-on-surface-variant);--p-exp-focus: var(--md-sys-color-primary);--p-exp-radius: 12px}.mat-expansion-panel{background:var(--p-exp-surface);border:1px solid var(--p-exp-border);border-radius:var(--p-exp-radius);overflow:hidden}.mat-expansion-panel:not(:last-child){margin-bottom:var(--p-exp-panel-gap, 12px)}.mat-expansion-panel-header{background:var(--p-exp-surface-container);color:var(--p-exp-text)}.mat-expansion-panel-header:focus-visible{outline:2px solid var(--p-exp-focus);outline-offset:-2px}.mat-expansion-panel-header-title{font-weight:600}.mat-expansion-panel-header-description{color:var(--p-exp-text-muted)}.mat-expansion-panel-body{padding:12px 16px 16px}.mat-action-row{border-top:1px solid var(--p-exp-border)}.density-compact .mat-expansion-panel-body{padding:8px 12px 12px}.density-compact .mat-expansion-panel-header{min-height:40px;padding:0 12px}.density-comfortable .mat-expansion-panel-body{padding:12px 16px 16px}.density-comfortable .mat-expansion-panel-header{min-height:48px;padding:0 16px}.density-spacious .mat-expansion-panel-body{padding:16px 20px 20px}.density-spacious .mat-expansion-panel-header{min-height:56px;padding:0 20px}.praxis-expansion-empty{display:flex;gap:8px;align-items:center;padding:8px 12px;color:var(--p-exp-text-muted)}.edit-fab{position:absolute;right:12px;bottom:12px;z-index:2}.expansion-ai-assistant{position:absolute;right:12px;bottom:72px;z-index:3}.expansion-ai-assistant-trigger{box-shadow:var(--md-sys-elevation-level2, 0 4px 12px rgba(0, 0, 0, .18))}\n"] }]
         }], propDecorators: { config: [{
                 type: Input
             }], expansionId: [{
@@ -1104,7 +1823,7 @@ class PraxisExpansionConfigEditor {
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PraxisExpansionConfigEditor, deps: [{ token: SETTINGS_PANEL_DATA }], target: i0.ɵɵFactoryTarget.Component });
     static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.17", type: PraxisExpansionConfigEditor, isStandalone: true, selector: "praxis-expansion-config-editor", inputs: { config: "config", expansionId: "expansionId" }, usesOnChanges: true, ngImport: i0, template: `
-    <div class="pdx-expansion-editor">
+    <div class="pdx-expansion-editor" data-testid="expansion-config-editor">
       <section class="sec">
         <h4>Aparência</h4>
         <div class="grid two">
@@ -1357,7 +2076,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
                         MatTooltipModule,
                         PraxisIconDirective,
                     ], changeDetection: ChangeDetectionStrategy.OnPush, template: `
-    <div class="pdx-expansion-editor">
+    <div class="pdx-expansion-editor" data-testid="expansion-config-editor">
       <section class="sec">
         <h4>Aparência</h4>
         <div class="grid two">
@@ -1606,6 +2325,87 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
                 type: Input
             }] } });
 
+class PraxisExpansionWidgetConfigEditor {
+    inputs = null;
+    widgetKey;
+    expansionEditor;
+    isDirty$ = new BehaviorSubject(false);
+    isValid$ = new BehaviorSubject(true);
+    isBusy$ = new BehaviorSubject(false);
+    subscription = new Subscription();
+    emptyConfig = {};
+    get config() {
+        return this.inputs?.config ?? this.emptyConfig;
+    }
+    get expansionId() {
+        return this.inputs?.expansionId ?? this.widgetKey;
+    }
+    ngAfterViewInit() {
+        if (!this.expansionEditor) {
+            return;
+        }
+        this.subscription.add(this.expansionEditor.isDirty$.subscribe((value) => this.isDirty$.next(value)));
+        this.subscription.add(this.expansionEditor.isValid$.subscribe((value) => this.isValid$.next(value)));
+        this.subscription.add(this.expansionEditor.isBusy$.subscribe((value) => this.isBusy$.next(value)));
+    }
+    ngOnDestroy() {
+        this.subscription.unsubscribe();
+    }
+    getSettingsValue() {
+        return this.buildValue(this.expansionEditor?.getSettingsValue());
+    }
+    onSave() {
+        return this.buildValue(this.expansionEditor?.getSettingsValue());
+    }
+    reset() {
+        this.expansionEditor?.reset();
+    }
+    buildValue(config) {
+        return {
+            inputs: {
+                ...(this.inputs ?? {}),
+                config: config ?? this.config,
+                ...(this.expansionId ? { expansionId: this.expansionId } : {}),
+            },
+        };
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PraxisExpansionWidgetConfigEditor, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.17", type: PraxisExpansionWidgetConfigEditor, isStandalone: true, selector: "praxis-expansion-widget-config-editor", inputs: { inputs: "inputs", widgetKey: "widgetKey" }, viewQueries: [{ propertyName: "expansionEditor", first: true, predicate: ["expansionEditor"], descendants: true }], ngImport: i0, template: `
+    <section data-testid="expansion-widget-config-editor">
+      <praxis-expansion-config-editor
+        #expansionEditor
+        [config]="config"
+        [expansionId]="expansionId"
+      />
+    </section>
+  `, isInline: true, dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "component", type: PraxisExpansionConfigEditor, selector: "praxis-expansion-config-editor", inputs: ["config", "expansionId"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PraxisExpansionWidgetConfigEditor, decorators: [{
+            type: Component,
+            args: [{
+                    selector: 'praxis-expansion-widget-config-editor',
+                    standalone: true,
+                    imports: [CommonModule, PraxisExpansionConfigEditor],
+                    template: `
+    <section data-testid="expansion-widget-config-editor">
+      <praxis-expansion-config-editor
+        #expansionEditor
+        [config]="config"
+        [expansionId]="expansionId"
+      />
+    </section>
+  `,
+                    changeDetection: ChangeDetectionStrategy.OnPush,
+                }]
+        }], propDecorators: { inputs: [{
+                type: Input
+            }], widgetKey: [{
+                type: Input
+            }], expansionEditor: [{
+                type: ViewChild,
+                args: ['expansionEditor']
+            }] } });
+
 const PRAXIS_EXPANSION_PORTS = [
     {
         id: 'config',
@@ -1642,6 +2442,14 @@ const PRAXIS_EXPANSION_COMPONENT_METADATA = {
     friendlyName: 'Praxis Expansion Panel',
     description: 'Acordeão/Painéis de expansão configuráveis por metadata, com aparência e tokens M3.',
     icon: 'unfold_more',
+    authoringManifestRef: {
+        componentId: 'praxis-expansion',
+        source: 'PRAXIS_EXPANSION_AUTHORING_MANIFEST',
+    },
+    configEditor: {
+        component: PraxisExpansionWidgetConfigEditor,
+        title: 'Configure expansion',
+    },
     inputs: [
         { name: 'config', type: 'ExpansionMetadata', label: 'Configuração', description: 'Configuração JSON (acordeão, aparência e painéis)' },
         { name: 'expansionId', type: 'string', label: 'ID', description: 'Identificador para persistência (obrigatório)' },
@@ -2049,4 +2857,4 @@ const PRAXIS_EXPANSION_AUTHORING_MANIFEST = {
  * Generated bundle index. Do not edit.
  */
 
-export { EXPANSION_AI_CAPABILITIES, PRAXIS_EXPANSION_AUTHORING_MANIFEST, PRAXIS_EXPANSION_COMPONENT_METADATA, PraxisExpansion, PraxisExpansionConfigEditor, providePraxisExpansionDefaults, providePraxisExpansionMetadata };
+export { EXPANSION_AI_CAPABILITIES, PRAXIS_EXPANSION_AUTHORING_MANIFEST, PRAXIS_EXPANSION_COMPONENT_METADATA, PraxisExpansion, PraxisExpansionConfigEditor, PraxisExpansionWidgetConfigEditor, providePraxisExpansionDefaults, providePraxisExpansionMetadata };

package/index.d.ts

@@ -1,19 +1,24 @@
 import * as i0 from '@angular/core';
-import { OnChanges, OnInit, EventEmitter, QueryList, SimpleChanges, Provider } from '@angular/core';
+import { OnChanges, OnDestroy, OnInit, EventEmitter, QueryList, SimpleChanges, AfterViewInit, Provider } from '@angular/core';
 import { FormGroup } from '@angular/forms';
 import { MatAccordionDisplayMode, MatAccordionTogglePosition, MatExpansionPanelDefaultOptions, MatAccordion, MatExpansionPanel } from '@angular/material/expansion';
-import { AiCapability, FieldMetadata, WidgetDefinition, WidgetEventEnvelope, ComponentDocMeta, AiCapabilityCategory, AiValueKind, AiCapabilityCatalog, ComponentAuthoringManifest } from '@praxisui/core';
+import { AiCapability, FieldMetadata, WidgetDefinition, WidgetEventEnvelope, SettingsValueProvider as SettingsValueProvider$1, ComponentDocMeta, AiCapabilityCategory, AiValueKind, AiCapabilityCatalog, ComponentAuthoringManifest } from '@praxisui/core';
 import { BehaviorSubject } from 'rxjs';
-import { BaseAiAdapter, PatchResult } from '@praxisui/ai';
+import { BaseAiAdapter, PatchResult, PraxisAssistantTurnViewState, PraxisAssistantShellLayout, PraxisAssistantShellLabels, PraxisAssistantSessionSnapshot, PraxisAssistantShellQuickReply, PraxisAssistantShellMessage, PraxisAssistantShellContextItem } from '@praxisui/ai';
 import { SettingsValueProvider } from '@praxisui/settings-panel';
 
 declare class ExpansionAiAdapter extends BaseAiAdapter<ExpansionMetadata> {
     private expansion;
+    componentId: string;
+    componentType: string;
     componentName: string;
     constructor(expansion: PraxisExpansion);
     getCurrentConfig(): ExpansionMetadata;
     getCapabilities(): AiCapability[];
     getRuntimeState(): Record<string, any>;
+    getDataProfile(): Record<string, any>;
+    getSchemaFields(): Array<Record<string, any>>;
+    getAuthoringContext(): Record<string, any>;
     createSnapshot(): ExpansionMetadata;
     restoreSnapshot(snapshot: ExpansionMetadata): Promise<void>;
     applyPatch(patch: Partial<ExpansionMetadata>): Promise<PatchResult>;
@@ -103,7 +108,7 @@ interface PanelMetadata {
         action?: string;
     }>;
 }
-declare class PraxisExpansion implements OnChanges, OnInit {
+declare class PraxisExpansion implements OnChanges, OnDestroy, OnInit {
     config?: ExpansionMetadata | null;
     expansionId: string;
     componentInstanceId?: string;
@@ -144,9 +149,20 @@ declare class PraxisExpansion implements OnChanges, OnInit {
     private readonly dynamicForm;
     private readonly componentKeys;
     private readonly route;
+    private readonly aiApi;
+    private readonly assistantSessions;
+    private readonly aiTurnOrchestrator;
+    private readonly aiAssistantSessionEffect;
     private warnedMissingId;
     private readonly panelForms;
     aiAdapter: ExpansionAiAdapter;
+    aiAssistantOpen: boolean;
+    aiAssistantPrompt: string;
+    aiAssistantViewState: PraxisAssistantTurnViewState | null;
+    aiAssistantLayout: PraxisAssistantShellLayout;
+    readonly aiAssistantLabels: Partial<PraxisAssistantShellLabels>;
+    private aiAssistantController;
+    private aiAssistantStateSubscription;
     accordionRef?: MatAccordion;
     panels?: QueryList<MatExpansionPanel>;
     injectedDefaults: MatExpansionPanelDefaultOptions | null;
@@ -154,6 +170,7 @@ declare class PraxisExpansion implements OnChanges, OnInit {
     single: () => PanelMetadata | null;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
     styleCss(): string | null;
     emitOpened(p: PanelMetadata, index: number): void;
     emitClosed(p: PanelMetadata, index: number): void;
@@ -174,6 +191,32 @@ declare class PraxisExpansion implements OnChanges, OnInit {
     panelDomId(p: PanelMetadata | null, index: number): string;
     panelFormFor(panel: PanelMetadata, index: number): FormGroup<Record<string, any>>;
     applyConfigFromAdapter(next: ExpansionMetadata): void;
+    openAiAssistant(): void;
+    openAiAssistantFromSession(session: PraxisAssistantSessionSnapshot): void;
+    closeAiAssistant(): void;
+    onAiAssistantPromptChange(prompt: string): void;
+    onAiAssistantSubmit(prompt: string): void;
+    onAiAssistantApply(): void;
+    onAiAssistantRetry(): void;
+    onAiAssistantCancel(): void;
+    onAiAssistantQuickReply(reply: PraxisAssistantShellQuickReply): void;
+    onAiAssistantEditMessage(message: PraxisAssistantShellMessage): void;
+    onAiAssistantResendMessage(message: PraxisAssistantShellMessage): void;
+    onAiAssistantLayoutChange(layout: PraxisAssistantShellLayout): void;
+    buildAiAssistantContextItems(): PraxisAssistantShellContextItem[];
+    private initializeAiAssistantController;
+    private buildAiAssistantContextSnapshot;
+    private syncAiAssistantSession;
+    private hasAiAssistantSessionState;
+    private resolveAiAssistantSessionId;
+    private resolveAiAssistantOwnerId;
+    private safeAiAssistantExpansionId;
+    private resolveAiAssistantRouteKey;
+    private resolveAiAssistantSummary;
+    private resolveAiAssistantBadge;
+    private resolveAiAssistantIcon;
+    private collectAiAssistantPanelNames;
+    private collectAiAssistantCounts;
     openEditor(): void;
     private storageKey;
     private persistConfig;
@@ -216,6 +259,35 @@ declare class PraxisExpansionConfigEditor implements SettingsValueProvider, OnCh
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisExpansionConfigEditor, "praxis-expansion-config-editor", never, { "config": { "alias": "config"; "required": false; }; "expansionId": { "alias": "expansionId"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+interface PraxisExpansionWidgetEditorInputs {
+    config?: ExpansionMetadata | null;
+    expansionId?: string;
+    [key: string]: unknown;
+}
+interface PraxisExpansionWidgetEditorValue {
+    inputs: PraxisExpansionWidgetEditorInputs;
+}
+declare class PraxisExpansionWidgetConfigEditor implements SettingsValueProvider$1, AfterViewInit, OnDestroy {
+    inputs: PraxisExpansionWidgetEditorInputs | null;
+    widgetKey?: string;
+    expansionEditor?: PraxisExpansionConfigEditor;
+    readonly isDirty$: BehaviorSubject<boolean>;
+    readonly isValid$: BehaviorSubject<boolean>;
+    readonly isBusy$: BehaviorSubject<boolean>;
+    private readonly subscription;
+    private readonly emptyConfig;
+    get config(): ExpansionMetadata;
+    get expansionId(): string | undefined;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    getSettingsValue(): PraxisExpansionWidgetEditorValue;
+    onSave(): PraxisExpansionWidgetEditorValue;
+    reset(): void;
+    private buildValue;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisExpansionWidgetConfigEditor, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisExpansionWidgetConfigEditor, "praxis-expansion-widget-config-editor", never, { "inputs": { "alias": "inputs"; "required": false; }; "widgetKey": { "alias": "widgetKey"; "required": false; }; }, {}, never, never, true, never>;
+}
+
 declare const PRAXIS_EXPANSION_COMPONENT_METADATA: ComponentDocMeta;
 declare function providePraxisExpansionMetadata(): Provider;
 declare function providePraxisExpansionDefaults(opts: MatExpansionPanelDefaultOptions): Provider;
@@ -245,5 +317,5 @@ declare const EXPANSION_AI_CAPABILITIES: CapabilityCatalog;
 
 declare const PRAXIS_EXPANSION_AUTHORING_MANIFEST: ComponentAuthoringManifest;
 
-export { EXPANSION_AI_CAPABILITIES, PRAXIS_EXPANSION_AUTHORING_MANIFEST, PRAXIS_EXPANSION_COMPONENT_METADATA, PraxisExpansion, PraxisExpansionConfigEditor, providePraxisExpansionDefaults, providePraxisExpansionMetadata };
-export type { Capability, CapabilityCatalog, CapabilityCategory, ExpansionAppearanceContainer, ExpansionAppearanceHeader, ExpansionAppearanceStates, ExpansionMetadata, PanelMetadata, ValueKind };
+export { EXPANSION_AI_CAPABILITIES, PRAXIS_EXPANSION_AUTHORING_MANIFEST, PRAXIS_EXPANSION_COMPONENT_METADATA, PraxisExpansion, PraxisExpansionConfigEditor, PraxisExpansionWidgetConfigEditor, providePraxisExpansionDefaults, providePraxisExpansionMetadata };
+export type { Capability, CapabilityCatalog, CapabilityCategory, ExpansionAppearanceContainer, ExpansionAppearanceHeader, ExpansionAppearanceStates, ExpansionMetadata, PanelMetadata, PraxisExpansionWidgetEditorInputs, PraxisExpansionWidgetEditorValue, ValueKind };

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@praxisui/expansion",
-  "version": "8.0.0-beta.20",
+  "version": "8.0.0-beta.21",
   "description": "Expansion panel (accordion) components for Praxis UI with metadata configuration and editor integration.",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0",
     "@angular/material": "^20.0.0",
     "@angular/cdk": "^20.0.0",
-    "@praxisui/core": "^8.0.0-beta.20",
-    "@praxisui/dynamic-fields": "^8.0.0-beta.20",
-    "@praxisui/settings-panel": "^8.0.0-beta.20",
+    "@praxisui/core": "^8.0.0-beta.21",
+    "@praxisui/dynamic-fields": "^8.0.0-beta.21",
+    "@praxisui/settings-panel": "^8.0.0-beta.21",
     "@angular/forms": "^20.0.0",
     "@angular/router": "^20.0.0",
-    "@praxisui/ai": "^8.0.0-beta.20",
+    "@praxisui/ai": "^8.0.0-beta.21",
     "rxjs": "~7.8.0"
   },
   "dependencies": {