@praxisui/dynamic-form 8.0.0-beta.2 → 8.0.0-beta.21

package/fesm2022/praxisui-dynamic-form-dynamic-form-agentic-authoring-turn-flow-DuH1ad7h.mjs

@@ -0,0 +1,417 @@
+import { firstValueFrom } from 'rxjs';
+
+class DynamicFormAgenticAuthoringTurnFlow {
+    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-dynamic-form';
+        const componentType = this.adapter.componentType || request.componentType || 'form';
+        const currentState = this.toAiJsonObject(this.adapter.getCurrentConfig());
+        const runtimeState = this.optionalJsonObject(this.adapter.getRuntimeState?.());
+        const contextHints = this.optionalJsonObject(this.adapter.getAuthoringContext?.());
+        if (this.shouldRestrictToInlineHelp(contextHints)) {
+            return this.toInlineHelpOnlyResult(prompt, request, contextHints);
+        }
+        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(currentState, runtimeState),
+            uiContextRef: {
+                componentId,
+                componentType,
+            },
+            ...(runtimeState ? { runtimeState } : {}),
+            ...(contextHints ? { contextHints } : {}),
+        }));
+        return this.toTurnResult(this.compileAdapterResponse(response), request);
+    }
+    async apply(request) {
+        const contextHints = this.optionalJsonObject(this.adapter.getAuthoringContext?.());
+        if (this.shouldRestrictToInlineHelp(contextHints)) {
+            return {
+                state: 'error',
+                phase: 'apply',
+                assistantMessage: 'Este formulario esta em modo de leitura. Posso explicar ou diagnosticar, mas nao aplicar mudancas locais.',
+                errorText: 'Aplicacao bloqueada em view/readonly sem customizacao.',
+                canApply: false,
+                pendingPatch: null,
+            };
+        }
+        const patch = this.toRecord(request.pendingPatch);
+        if (!patch) {
+            return {
+                state: 'error',
+                phase: 'apply',
+                assistantMessage: 'Nao ha alteracao de formulario pronta para aplicar.',
+                errorText: 'Nao ha alteracao de formulario pronta para aplicar.',
+                canApply: false,
+            };
+        }
+        const result = await this.adapter.applyPatch(patch, request.prompt);
+        if (!result.success) {
+            return {
+                state: 'error',
+                phase: 'apply',
+                assistantMessage: result.error || 'Nao foi possivel aplicar as alteracoes no formulario.',
+                errorText: result.error || 'Nao foi possivel aplicar as alteracoes no formulario.',
+                canApply: true,
+                pendingPatch: patch,
+            };
+        }
+        return {
+            state: 'success',
+            phase: 'summarize',
+            assistantMessage: 'Alteracoes aplicadas no formulario.',
+            statusText: 'Alteracoes aplicadas no formulario.',
+            canApply: false,
+            pendingPatch: null,
+            diagnostics: result.warnings?.length ? { warnings: result.warnings } : undefined,
+        };
+    }
+    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') {
+            const questions = this.toClarificationQuestions(response);
+            return {
+                state: 'clarification',
+                phase: 'clarify',
+                sessionId: response.sessionId ?? request.sessionId,
+                assistantMessage: response.message || 'Preciso de mais detalhes para continuar.',
+                clarificationQuestions: questions,
+                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 formulario.';
+            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) {
+            const warnings = response.warnings?.filter(Boolean) ?? [];
+            const suffix = warnings.length ? ` Avisos: ${warnings.join('; ')}` : '';
+            return {
+                state: 'review',
+                phase: 'review',
+                sessionId: response.sessionId ?? request.sessionId,
+                assistantMessage: `${response.explanation || 'Proposta de alteracao pronta para revisar.'}${suffix}`,
+                statusText: 'Revise a proposta antes de aplicar.',
+                canApply: true,
+                pendingPatch: response.patch,
+                preview: {
+                    kind: 'dynamic-form-config-patch',
+                    diff: response.diff ?? [],
+                },
+                diagnostics: warnings.length ? { warnings } : undefined,
+            };
+        }
+        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 && response.patch && Object.keys(response.patch).length > 0) {
+            return {
+                type: 'error',
+                message: 'O formulario exige componentEditPlan validado pelo manifesto antes de gerar patch local.',
+                warnings: [
+                    'free-dynamic-form-patch-rejected',
+                    'Use componentEditPlan validado contra PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST.',
+                ],
+            };
+        }
+        if (!compiled) {
+            return response;
+        }
+        if (compiled.type === 'error') {
+            return {
+                type: 'error',
+                message: compiled.message || 'O componentEditPlan do formulario 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 no formulario?'];
+        const options = this.toQuickReplies(response).map((reply) => ({
+            id: reply.id,
+            label: reply.label,
+            value: reply.prompt,
+        }));
+        return labels.map((label, index) => ({
+            id: `dynamic-form-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(currentState, runtimeState) {
+        const fields = Array.isArray(currentState['fieldMetadata'])
+            ? currentState['fieldMetadata']
+                .map((field) => this.toRecord(field)?.['name'])
+                .filter((field) => typeof field === 'string' && field.length > 0)
+            : undefined;
+        const sections = Array.isArray(currentState['sections']) ? currentState['sections'].length : undefined;
+        return {
+            ...(fields?.length ? { columns: fields } : {}),
+            ...(typeof runtimeState?.['totalFields'] === 'number'
+                ? { rowCount: runtimeState['totalFields'] }
+                : sections !== undefined
+                    ? { rowCount: sections }
+                    : {}),
+        };
+    }
+    shouldRestrictToInlineHelp(contextHints) {
+        const policy = this.toRecord(contextHints?.['runtimeAuthoringPolicy']);
+        return policy?.['canApplyLocalPatch'] === false;
+    }
+    toInlineHelpOnlyResult(prompt, request, contextHints) {
+        const policy = this.toRecord(contextHints?.['runtimeAuthoringPolicy']);
+        const reason = typeof policy?.['reason'] === 'string'
+            ? policy['reason']
+            : 'Formulario em modo de leitura ou readonly.';
+        return {
+            state: 'success',
+            phase: 'summarize',
+            sessionId: request.sessionId,
+            assistantMessage: `Posso ajudar explicando este formulario ou diagnosticando o estado atual, mas nao vou aplicar alteracoes locais aqui. Motivo: ${reason}`,
+            statusText: 'Modo somente assistencia.',
+            canApply: false,
+            pendingPatch: null,
+            quickReplies: [
+                {
+                    id: 'explain-current-form',
+                    label: 'Explicar formulario atual',
+                    prompt: `Explique este formulario considerando: ${prompt}`,
+                    kind: 'inline-help',
+                    icon: 'help',
+                },
+            ],
+        };
+    }
+    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 formulario pode contextualizar campo/secao, 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 regra local no formulario.',
+                    icon: 'rule',
+                    tone: 'warning',
+                    contextHints: {
+                        flowId: 'shared_rule_authoring',
+                        source: 'praxis-dynamic-form',
+                        recommendedAction: 'domain-rules/intake',
+                    },
+                },
+            ],
+            clarificationQuestions: [
+                {
+                    id: 'dynamic-form-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 formulario.',
+                            contextHints: {
+                                flowId: 'shared_rule_authoring',
+                                source: 'praxis-dynamic-form',
+                            },
+                        },
+                    ],
+                },
+            ],
+            diagnostics: {
+                governedDecisionHandoff: {
+                    flowId: 'shared_rule_authoring',
+                    sourcePrompt: prompt,
+                    sourceComponent: 'praxis-dynamic-form',
+                },
+            },
+        };
+    }
+    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;
+    }
+}
+
+export { DynamicFormAgenticAuthoringTurnFlow };