@praxisui/dynamic-form 10.0.0-rc.41 → 10.0.0-rc.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "10.0.0-rc.41",
+  "version": "10.0.0-rc.42",
   "description": "Angular dynamic form engine for Praxis UI: metadata-driven forms, hooks, and services integrating @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -9,13 +9,13 @@
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^10.0.0-rc.41",
-    "@praxisui/dynamic-fields": "^10.0.0-rc.41",
-    "@praxisui/metadata-editor": "^10.0.0-rc.41",
-    "@praxisui/rich-content": "^10.0.0-rc.41",
-    "@praxisui/settings-panel": "^10.0.0-rc.41",
-    "@praxisui/visual-builder": "^10.0.0-rc.41",
-    "@praxisui/core": "^10.0.0-rc.41",
+    "@praxisui/ai": "^10.0.0-rc.42",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.42",
+    "@praxisui/metadata-editor": "^10.0.0-rc.42",
+    "@praxisui/rich-content": "^10.0.0-rc.42",
+    "@praxisui/settings-panel": "^10.0.0-rc.42",
+    "@praxisui/visual-builder": "^10.0.0-rc.42",
+    "@praxisui/core": "^10.0.0-rc.42",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

package/types/praxisui-dynamic-form.d.ts

@@ -7,7 +7,7 @@ import { MatDialog } from '@angular/material/dialog';
 import { MatSnackBar } from '@angular/material/snack-bar';
 import { CdkDragStart, CdkDragMove, CdkDragEnd, CdkDragDrop } from '@angular/cdk/drag-drop';
 import * as _praxisui_core from '@praxisui/core';
-import { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, PraxisJsonLogicService, FormSection, FormRow, FormColumn, FormConfig, FormConfigWithSections, FormLayoutItem, ReactiveDeterminationDefinition, ReactiveDeterminationExecutionEvent, FormActionButton, DynamicFormMode, AiCapability, DynamicFormLayoutScope, BackConfig, FormPresentationConfig, EmptyStateTone, EmptyStateVariant, EmptyStateAlignment, EmptyStateDensity, EmptyStateIconContainer, FormPresentationPreset, RichBlockHostCapabilities, ApiEndpoint, ApiUrlEntry, FormLayoutMode, FormLayoutOptions, DynamicFormLayoutPolicy, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, FormPayloadPreviewEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, FormLayoutTabItem, RichContentDocument, JsonLogicRecord, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, ApiUrlConfig, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, EnterpriseRuntimeContextService, FormLayoutTabsAppearance, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, JsonLogicExpression, FormHelpPresentationConfig, GlobalActionCatalogEntry, PraxisRuntimeConditionalEffectRule, PraxisRuntimeGlobalActionEffect, SurfaceOpenPayload, GlobalActionField, PraxisEffectPolicy, FieldDefinition, ComponentDocMeta, DiscoveredResourceOption, Breakpoint, DomainRuleRequestOptions, DomainRuleService, DomainRuleMaterialization, SchemaIdParams, CompiledDynamicFormSchema, TableConfig, SurfaceOpenActionEditorComponent, IconPickerService, GlobalActionRef, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, ComponentAuthoringManifest, GovernedPagePreviewWidgetAdapter, WidgetInstance } from '@praxisui/core';
+import { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, PraxisJsonLogicService, FormSection, FormRow, FormColumn, FormConfig, FormConfigWithSections, FormLayoutItem, ReactiveDeterminationDefinition, ReactiveDeterminationExecutionEvent, FormActionButton, DynamicFormMode, PraxisRuntimeFormValueTargetIdentity, PraxisRuntimeFormValueEligibility, PraxisRuntimeFormValueProposal, PraxisRuntimeFormValueApplyMode, PraxisRuntimeFormValuePreviewResult, PraxisRuntimeFormValueApplyRequest, PraxisRuntimeFormValueApplyReceipt, PraxisRuntimeFormValueUndoReceipt, AiCapability, DynamicFormLayoutScope, BackConfig, FormPresentationConfig, EmptyStateTone, EmptyStateVariant, EmptyStateAlignment, EmptyStateDensity, EmptyStateIconContainer, FormPresentationPreset, PraxisRuntimeFormValueTargetPort, RichBlockHostCapabilities, ApiEndpoint, ApiUrlEntry, FormLayoutMode, FormLayoutOptions, DynamicFormLayoutPolicy, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, FormPayloadPreviewEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, FormLayoutTabItem, RichContentDocument, JsonLogicRecord, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, ApiUrlConfig, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, EnterpriseRuntimeContextService, FormLayoutTabsAppearance, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, JsonLogicExpression, FormHelpPresentationConfig, GlobalActionCatalogEntry, PraxisRuntimeConditionalEffectRule, PraxisRuntimeGlobalActionEffect, SurfaceOpenPayload, GlobalActionField, PraxisEffectPolicy, FieldDefinition, ComponentDocMeta, DiscoveredResourceOption, Breakpoint, DomainRuleRequestOptions, DomainRuleService, DomainRuleMaterialization, SchemaIdParams, CompiledDynamicFormSchema, TableConfig, SurfaceOpenActionEditorComponent, IconPickerService, GlobalActionRef, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, ComponentAuthoringManifest, GovernedPagePreviewWidgetAdapter, WidgetInstance } from '@praxisui/core';
 export { CompiledDynamicFormSchema, DynamicFormLayoutScope, DynamicFormMode } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { Observable, Subscription, BehaviorSubject } from 'rxjs';
@@ -514,6 +514,14 @@ interface FormAiHost {
     readonlyModeGlobal?: boolean | null;
     effectiveReadonly?: boolean;
     applyConfigFromAdapter(config: FormConfig): void;
+    getRuntimeValueTargetIdentity?(): PraxisRuntimeFormValueTargetIdentity;
+    getRuntimeValueEligibility?(): PraxisRuntimeFormValueEligibility;
+    previewRuntimeValues?(proposal: PraxisRuntimeFormValueProposal, options?: {
+        readonly selectedFieldPaths?: readonly string[];
+        readonly applyMode?: PraxisRuntimeFormValueApplyMode;
+    }): PraxisRuntimeFormValuePreviewResult;
+    applyRuntimeValues?(request: PraxisRuntimeFormValueApplyRequest): Promise<PraxisRuntimeFormValueApplyReceipt> | PraxisRuntimeFormValueApplyReceipt;
+    undoRuntimeValues?(receiptId?: string): Promise<PraxisRuntimeFormValueUndoReceipt> | PraxisRuntimeFormValueUndoReceipt;
 }
 
 declare class FormAiAdapter extends BaseAiAdapter<FormConfig> {
@@ -529,6 +537,14 @@ declare class FormAiAdapter extends BaseAiAdapter<FormConfig> {
     getDataProfile(): Record<string, any>;
     getSchemaFields(): Record<string, any>[];
     getAuthoringContext(): Record<string, any>;
+    getRuntimeValueTargetIdentity(): PraxisRuntimeFormValueTargetIdentity | null;
+    getRuntimeValueEligibility(): PraxisRuntimeFormValueEligibility | null;
+    previewRuntimeValues(proposal: PraxisRuntimeFormValueProposal, options?: {
+        readonly selectedFieldPaths?: readonly string[];
+        readonly applyMode?: PraxisRuntimeFormValueApplyMode;
+    }): PraxisRuntimeFormValuePreviewResult | null;
+    applyRuntimeValues(request: PraxisRuntimeFormValueApplyRequest): Promise<PraxisRuntimeFormValueApplyReceipt | null>;
+    undoRuntimeValues(receiptId?: string): Promise<PraxisRuntimeFormValueUndoReceipt | null>;
     compileAiResponse(response: Record<string, unknown>): AiResponseCompileResult | null;
     createSnapshot(): FormConfig;
     restoreSnapshot(snapshot: FormConfig): Promise<void>;
@@ -733,7 +749,7 @@ interface FormColumnRichContentRenderItem {
     style?: Record<string, any> | null;
 }
 type FormColumnRenderItem = FormColumnFieldsRenderItem | FormColumnRichContentRenderItem;
-declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
+declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy, PraxisRuntimeFormValueTargetPort {
     private crud;
     private http;
     private fb;
@@ -1073,6 +1089,14 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private readonly entityReadCancel$;
     private isDestroyed;
     private formValueChangesSubscription;
+    private formStatusChangesSubscription;
+    private readonly runtimeValueJournal;
+    private runtimeValueRevision;
+    private runtimeValueTrackedForm;
+    private readonly runtimeValueTrackedControls;
+    private suppressCommandRuleSideEffectsDepth;
+    private pendingSuppressedCommandEvaluation;
+    private consumingSuppressedCommandEvaluation;
     private readonly submitFieldErrorSubscriptions;
     private activeSubmitErrorDetails;
     private reactiveDeterminationSubscription;
@@ -1458,7 +1482,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     closeAiAssistant(): void;
     onAiAssistantPromptChange(prompt: string): void;
     onAiAssistantSubmit(prompt: string): void;
-    onAiAssistantApply(): void;
+    onAiAssistantApply(contextHints?: Record<string, unknown> | void): void;
     onAiAssistantRetry(): void;
     onAiAssistantCancel(): void;
     onAiAssistantQuickReply(reply: PraxisAssistantShellQuickReply): void;
@@ -1655,6 +1679,21 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private logRowGapsSnapshot;
     private applyPresentationVars;
     private applyPresentationConfig;
+    getRuntimeValueTargetIdentity(): PraxisRuntimeFormValueTargetIdentity;
+    getRuntimeValueEligibility(): PraxisRuntimeFormValueEligibility;
+    previewRuntimeValues(proposal: PraxisRuntimeFormValueProposal, options?: {
+        readonly selectedFieldPaths?: readonly string[];
+        readonly applyMode?: PraxisRuntimeFormValueApplyMode;
+    }): PraxisRuntimeFormValuePreviewResult;
+    applyRuntimeValues(request: PraxisRuntimeFormValueApplyRequest): PraxisRuntimeFormValueApplyReceipt;
+    undoRuntimeValues(receiptId?: string): PraxisRuntimeFormValueUndoReceipt;
+    private clearRuntimeValueControlSubscriptions;
+    private collectLeafFormControls;
+    private ensureRuntimeValueTracking;
+    private withSuppressedCommandSideEffects;
+    private createRuntimeFormHostCallbacks;
+    private isConfiguredReactiveDeterminationOutputField;
+    private collectRuntimeValueFieldClassification;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisDynamicForm, [null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisDynamicForm, "praxis-dynamic-form", never, { "resourcePath": { "alias": "resourcePath"; "required": false; }; "resourceId": { "alias": "resourceId"; "required": false; }; "initialValue": { "alias": "initialValue"; "required": false; }; "emptyState": { "alias": "emptyState"; "required": false; }; "editorialContext": { "alias": "editorialContext"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "config": { "alias": "config"; "required": false; }; "actions": { "alias": "actions"; "required": false; }; "schemaSource": { "alias": "schemaSource"; "required": false; }; "actionId": { "alias": "actionId"; "required": false; }; "operationId": { "alias": "operationId"; "required": false; }; "schemaUrl": { "alias": "schemaUrl"; "required": false; }; "readUrl": { "alias": "readUrl"; "required": false; }; "submitUrl": { "alias": "submitUrl"; "required": false; }; "submitMethod": { "alias": "submitMethod"; "required": false; }; "submitIdempotencyKey": { "alias": "submitIdempotencyKey"; "required": false; }; "submitCorrelationId": { "alias": "submitCorrelationId"; "required": false; }; "submitResourceVersion": { "alias": "submitResourceVersion"; "required": false; }; "submitResourceVersionTargetResourceKey": { "alias": "submitResourceVersionTargetResourceKey"; "required": false; }; "submitResourceVersionTargetIdField": { "alias": "submitResourceVersionTargetIdField"; "required": false; }; "responseSchemaUrl": { "alias": "responseSchemaUrl"; "required": false; }; "apiEndpointKey": { "alias": "apiEndpointKey"; "required": false; }; "apiUrlEntry": { "alias": "apiUrlEntry"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "showAiAssistant": { "alias": "showAiAssistant"; "required": false; }; "formId": { "alias": "formId"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "configPersistenceStrategy": { "alias": "configPersistenceStrategy"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "layoutMode": { "alias": "layoutMode"; "required": false; }; "formLayout": { "alias": "formLayout"; "required": false; }; "generatedLayoutPreset": { "alias": "generatedLayoutPreset"; "required": false; }; "layoutPolicy": { "alias": "layoutPolicy"; "required": false; }; "backConfig": { "alias": "backConfig"; "required": false; }; "hooks": { "alias": "hooks"; "required": false; }; "removeEmptyContainersOnSave": { "alias": "removeEmptyContainersOnSave"; "required": false; }; "reactiveValidation": { "alias": "reactiveValidation"; "required": false; }; "reactiveValidationDebounceMs": { "alias": "reactiveValidationDebounceMs"; "required": false; }; "notifyIfOutdated": { "alias": "notifyIfOutdated"; "required": false; }; "snoozeMs": { "alias": "snoozeMs"; "required": false; }; "autoOpenSettingsOnOutdated": { "alias": "autoOpenSettingsOnOutdated"; "required": false; }; "readonlyModeGlobal": { "alias": "readonlyModeGlobal"; "required": false; }; "disabledModeGlobal": { "alias": "disabledModeGlobal"; "required": false; }; "presentationModeGlobal": { "alias": "presentationModeGlobal"; "required": false; }; "presentation": { "alias": "presentation"; "required": false; }; "presentationPreset": { "alias": "presentationPreset"; "required": false; }; "sectionDefaultAppearance": { "alias": "sectionDefaultAppearance"; "required": false; }; "sectionDivider": { "alias": "sectionDivider"; "required": false; }; "visibleGlobal": { "alias": "visibleGlobal"; "required": false; }; "fieldIconPolicy": { "alias": "fieldIconPolicy"; "required": false; }; "domainRules": { "alias": "domainRules"; "required": false; }; "customEndpoints": { "alias": "customEndpoints"; "required": false; }; }, { "formSubmit": "formSubmit"; "formCancel": "formCancel"; "formReset": "formReset"; "configChange": "configChange"; "configPatchChange": "configPatchChange"; "formReady": "formReady"; "valueChange": "valueChange"; "payloadPreviewChange": "payloadPreviewChange"; "syncCompleted": "syncCompleted"; "initializationError": "initializationError"; "loadingStateChange": "loadingStateChange"; "enableCustomizationChange": "enableCustomizationChange"; "customAction": "customAction"; "actionConfirmation": "actionConfirmation"; "schemaStatusChange": "schemaStatusChange"; "fieldRenderError": "fieldRenderError"; "ruleDiagnosticsChange": "ruleDiagnosticsChange"; "reactiveDeterminationExecuted": "reactiveDeterminationExecuted"; "reactiveDeterminationPendingChange": "reactiveDeterminationPendingChange"; "tabChange": "tabChange"; "tabSelected": "tabSelected"; }, never, never, true, never>;
 }

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

@@ -1,539 +0,0 @@
-import { Observable } from 'rxjs';
-import { withAuthoringScopePolicy } from '@praxisui/ai';
-
-class DynamicFormAgenticAuthoringTurnFlow {
-    adapter;
-    turnClient;
-    mode = 'agentic-authoring';
-    constructor(adapter, turnClient) {
-        this.adapter = adapter;
-        this.turnClient = turnClient;
-    }
-    submit(request) {
-        const prompt = (request.prompt ?? '').trim();
-        if (!prompt) {
-            return Promise.resolve({
-                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.mergeJsonObjects(this.optionalJsonObject(this.adapter.getAuthoringContext?.()), this.optionalJsonObject(request.action?.contextHints));
-        if (this.shouldRestrictToInlineHelp(contextHints)) {
-            return Promise.resolve(this.toInlineHelpOnlyResult(prompt, request, contextHints));
-        }
-        const buildRequest = async () => {
-            await this.adapter.prepareAuthoringContext?.();
-            const preparedRuntimeState = this.optionalJsonObject(this.adapter.getRuntimeState?.()) ?? runtimeState;
-            const preparedContextHints = this.mergeJsonObjects(this.optionalJsonObject(this.adapter.getAuthoringContext?.()), this.optionalJsonObject(request.action?.contextHints));
-            const dataProfile = this.optionalJsonObject(this.adapter.getDataProfile?.());
-            const schemaFields = this.adapter.getSchemaFields?.()
-                ?.map((field) => this.toAiJsonObject(field))
-                .filter((field) => Object.keys(field).length > 0);
-            const patchRequest = withAuthoringScopePolicy({
-                componentId,
-                componentType,
-                userPrompt: prompt,
-                sessionId: request.sessionId,
-                clientTurnId: request.clientTurnId,
-                messages: this.toChatMessages(request.messages, prompt),
-                currentState,
-                currentStateDigest: this.buildCurrentStateDigest(currentState, preparedRuntimeState),
-                uiContextRef: {
-                    componentId,
-                    componentType,
-                },
-                ...(dataProfile ? { dataProfile } : {}),
-                ...(preparedRuntimeState ? { runtimeState: preparedRuntimeState } : {}),
-                ...(schemaFields?.length ? { schemaFields } : {}),
-                ...(preparedContextHints ? { contextHints: preparedContextHints } : {}),
-            }, {
-                componentId,
-                componentType,
-                componentLabel: this.adapter.componentName || 'formulário',
-            });
-            return {
-                ...patchRequest,
-                targetApp: 'praxis-ui-angular',
-                targetComponentId: componentId,
-                currentPage: currentState,
-                conversationMessages: this.toConversationMessages(request.messages),
-                pendingClarification: this.toPendingClarification(request),
-                attachmentSummaries: this.toAttachmentSummaries(request),
-                activeSemanticDecision: this.optionalJsonObject(request.activeSemanticDecision ?? request.action?.activeSemanticDecision),
-                contextHints: patchRequest.contextHints ?? null,
-            };
-        };
-        return this.submitViaAgenticStream(request, buildRequest);
-    }
-    submitViaAgenticStream(request, buildRequest) {
-        return new Observable((subscriber) => {
-            let closed = false;
-            let subscription = null;
-            const close = () => {
-                closed = true;
-                subscription?.unsubscribe();
-                subscription = null;
-            };
-            void buildRequest()
-                .then((turnRequest) => {
-                if (closed)
-                    return;
-                subscription = this.turnClient.streamEvents(turnRequest, {
-                    initialStatusText: 'Preparando o contexto seguro do formulário.',
-                    resultTimeoutMs: 90_000,
-                    streamTimeoutMs: 90_000,
-                }).subscribe({
-                    next: (event) => {
-                        if (closed)
-                            return;
-                        const result = this.toAgenticStreamTurnResult(event, request);
-                        subscriber.next(result);
-                        if (result.state !== 'processing') {
-                            subscriber.complete();
-                            close();
-                        }
-                    },
-                    error: (error) => {
-                        if (closed)
-                            return;
-                        subscriber.next(this.toAssistantErrorResult(error));
-                        subscriber.complete();
-                        close();
-                    },
-                });
-            })
-                .catch((error) => {
-                if (closed)
-                    return;
-                subscriber.next(this.toAssistantErrorResult(error));
-                subscriber.complete();
-                close();
-            });
-            return () => close();
-        });
-    }
-    toAgenticStreamTurnResult(event, request) {
-        if (event.kind === 'stream-started') {
-            return {
-                state: 'processing',
-                phase: 'contextualize',
-                statusText: 'Analisando o formulário e suas capacidades.',
-                sessionId: event.start.threadId,
-                clientTurnId: request.clientTurnId ?? event.start.turnId,
-                observationId: event.start.observationId ?? null,
-                canApply: false,
-            };
-        }
-        if (event.kind === 'stream-lifecycle') {
-            return {
-                state: 'processing',
-                phase: 'contextualize',
-                statusText: event.statusText,
-                sessionId: event.start.threadId,
-                clientTurnId: request.clientTurnId ?? event.start.turnId,
-                observationId: event.start.observationId ?? null,
-                canApply: false,
-                diagnostics: event.diagnostics
-                    ? { streamLifecycle: { phase: event.phase, ...event.diagnostics } }
-                    : undefined,
-            };
-        }
-        if (event.event.type === 'result') {
-            const payload = this.toRecord(event.event.payload) ?? {};
-            const rawResponse = this.toRecord(payload['response']) ?? payload;
-            const response = this.normalizeAgenticResponse(rawResponse);
-            return {
-                ...this.toTurnResult(this.compileAdapterResponse(response), request),
-                sessionId: event.event.threadId || request.sessionId,
-                clientTurnId: request.clientTurnId ?? event.event.turnId,
-            };
-        }
-        return this.turnClient.toTurnResult(event.event, request.clientTurnId);
-    }
-    normalizeAgenticResponse(response) {
-        const type = response['type'];
-        const normalizedType = type === 'patch'
-            || type === 'clarification'
-            || type === 'error'
-            || type === 'info'
-            ? type
-            : this.toRecord(response['patch']) || this.toRecord(response['compiledPatch'])
-                ? 'patch'
-                : 'info';
-        const patch = this.toRecord(response['patch']) ?? this.toRecord(response['compiledPatch']) ?? undefined;
-        const message = typeof response['message'] === 'string'
-            ? response['message']
-            : typeof response['assistantMessage'] === 'string'
-                ? response['assistantMessage']
-                : undefined;
-        return {
-            ...response,
-            type: normalizedType,
-            ...(patch ? { patch } : {}),
-            ...(message ? { message } : {}),
-        };
-    }
-    toConversationMessages(messages) {
-        return (messages ?? [])
-            .filter((message) => message.role === 'user' || message.role === 'assistant' || message.role === 'system')
-            .map((message) => ({
-            id: message.id,
-            role: message.role,
-            text: message.text,
-        }))
-            .filter((message) => message.text.trim().length > 0);
-    }
-    toPendingClarification(request) {
-        const pending = request.pendingClarification;
-        if (!pending?.sourcePrompt?.trim())
-            return null;
-        return {
-            sourcePrompt: pending.sourcePrompt,
-            questions: pending.questions.map((question) => question.label).filter(Boolean),
-            assistantMessage: pending.assistantMessage ?? null,
-            clientTurnId: pending.clientTurnId ?? null,
-            diagnostics: this.optionalJsonObject(pending.diagnostics) ?? null,
-        };
-    }
-    toAttachmentSummaries(request) {
-        return (request.attachments ?? []).map((attachment) => ({
-            id: attachment.id,
-            name: attachment.name,
-            kind: attachment.kind,
-            mimeType: attachment.mimeType ?? null,
-            sizeBytes: attachment.sizeBytes ?? null,
-            source: attachment.source ?? null,
-            hasPreview: !!attachment.previewUrl,
-        }));
-    }
-    toAssistantErrorResult(error) {
-        const message = error instanceof Error
-            ? error.message
-            : typeof error === 'string' && error.trim()
-                ? error
-                : 'Não foi possível concluir o pedido do formulário.';
-        return {
-            state: 'error',
-            phase: 'capture',
-            assistantMessage: `Não consegui concluir este pedido. ${message}`,
-            errorText: message,
-            canApply: false,
-            pendingPatch: null,
-        };
-    }
-    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,
-                observationId: response.observationId ?? request.observationId ?? null,
-                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,
-                observationId: response.observationId ?? request.observationId ?? null,
-                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,
-                observationId: response.observationId ?? request.observationId ?? null,
-                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,
-                observationId: response.observationId ?? request.observationId ?? null,
-                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,
-            observationId: response.observationId ?? request.observationId ?? null,
-            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,
-            description: reply.description ?? undefined,
-            contextHints: reply.contextHints ? { ...reply.contextHints } : undefined,
-        }));
-        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.value?.trim() || option.example?.trim() || label;
-                return {
-                    id: `option-${index + 1}`,
-                    label,
-                    prompt,
-                    kind: 'clarification-option',
-                    description: option.example?.trim() || undefined,
-                    contextHints: this.optionalJsonObject(option.contextHints),
-                };
-            });
-        }
-        return (response.options ?? [])
-            .filter((option) => !!option?.trim())
-            .map((option, index) => ({
-            id: `option-${index + 1}`,
-            label: option.trim(),
-            prompt: option.trim(),
-            kind: 'clarification-option',
-            description: undefined,
-            contextHints: undefined,
-        }));
-    }
-    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',
-                },
-            ],
-        };
-    }
-    optionalJsonObject(value) {
-        if (value === undefined || value === null) {
-            return undefined;
-        }
-        const object = this.toAiJsonObject(value);
-        return Object.keys(object).length ? object : undefined;
-    }
-    mergeJsonObjects(base, overlay) {
-        if (!base)
-            return overlay;
-        if (!overlay)
-            return base;
-        return {
-            ...base,
-            ...overlay,
-        };
-    }
-    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 };