@praxisui/table 8.0.0-beta.81 → 8.0.0-beta.84

package/fesm2022/{praxisui-table-table-agentic-authoring-turn-flow-CyJJHpMr.mjs → praxisui-table-table-agentic-authoring-turn-flow-DMglW7f1.mjs}

@@ -266,8 +266,7 @@ class TableAgenticAuthoringTurnFlow {
                 || this.shouldUseSelectedRecordSurfaceSnapshotFallback(contextHints));
     }
     shouldUseSelectedRecordSurfaceSnapshotFallback(contextHints) {
-        return this.selectedRecordsCountForTurn > 0
-            && this.selectedRecordSurfaces(contextHints).length > 0;
+        return this.selectedRecordSurfaces(contextHints).length > 0;
     }
     selectedRecordSurfaces(contextHints) {
         const authoringContract = this.toRecord(contextHints?.['authoringContract']);
@@ -561,13 +560,14 @@ class TableAgenticAuthoringTurnFlow {
                 ? this.adapter.compileAiResponse?.(response)
                 : null;
             if (compiledExecutable?.patch && Object.keys(compiledExecutable.patch).length > 0) {
+                const normalizedExecutable = this.normalizeBulkRouteSelectionPayload(compiledExecutable, request);
                 const warnings = [
                     ...(response.warnings ?? []),
-                    ...(compiledExecutable.warnings ?? []),
+                    ...(normalizedExecutable.warnings ?? []),
                 ];
                 const executableResponse = {
                     ...response,
-                    patch: compiledExecutable.patch,
+                    patch: normalizedExecutable.patch,
                     warnings: warnings.length ? warnings : undefined,
                 };
                 delete executableResponse.type;
@@ -578,22 +578,42 @@ class TableAgenticAuthoringTurnFlow {
                 if (continuedInvalidExecutable) {
                     return continuedInvalidExecutable;
                 }
+                const continuedBulkRouteAction = this.bulkRouteActionPlanForInvalidExecutable(response, request, compiledExecutable.warnings);
+                if (continuedBulkRouteAction) {
+                    return this.compileAdapterResponse(continuedBulkRouteAction, request);
+                }
                 return {
                     type: 'error',
                     message: compiledExecutable.message || 'O componentEditPlan da tabela nao passou na validacao de capacidades.',
                     warnings: compiledExecutable.warnings,
                 };
             }
+            const continuedSurfaceRowActionFromInfo = this.selectedRecordSurfaceRowActionPlanForInfo(response, request);
+            if (continuedSurfaceRowActionFromInfo) {
+                return this.compileAdapterResponse(continuedSurfaceRowActionFromInfo, request);
+            }
             const continuedSurfaceRuntimeOperation = this.selectedRecordSurfaceRuntimeOperationForInfo(response, request);
             if (continuedSurfaceRuntimeOperation) {
                 return continuedSurfaceRuntimeOperation;
             }
+            const continuedBulkRouteNarrative = this.bulkRouteActionPlanForNonExecutableNarrative(response, request);
+            if (continuedBulkRouteNarrative) {
+                return this.compileAdapterResponse(continuedBulkRouteNarrative, request);
+            }
+            const continuedBulkRouteAction = this.bulkRouteActionPlanForClarification(response, request);
+            if (continuedBulkRouteAction) {
+                return this.compileAdapterResponse(continuedBulkRouteAction, request);
+            }
             const continuedSurfaceRowAction = this.selectedRecordSurfaceRowActionPlanForClarification(response, request);
             if (continuedSurfaceRowAction) {
                 return this.compileAdapterResponse(continuedSurfaceRowAction, request);
             }
             return response;
         }
+        const rowActionGuidance = this.recordSurfaceRowActionGuidanceForConsult(response, request);
+        if (rowActionGuidance) {
+            return rowActionGuidance;
+        }
         const compiled = this.adapter.compileAiResponse?.(response);
         if (!compiled && response.patch && Object.keys(response.patch).length > 0) {
             return {
@@ -606,12 +626,22 @@ class TableAgenticAuthoringTurnFlow {
             };
         }
         if (!compiled) {
+            const continuedBulkRouteNarrative = this.bulkRouteActionPlanForNonExecutableNarrative(response, request);
+            if (continuedBulkRouteNarrative) {
+                return this.compileAdapterResponse(continuedBulkRouteNarrative, request);
+            }
             return response;
         }
         if (compiled.type === 'error') {
+            const continuedBulkRouteAction = this.bulkRouteActionPlanForInvalidExecutable(response, request, compiled.warnings);
+            if (continuedBulkRouteAction) {
+                return this.compileAdapterResponse(continuedBulkRouteAction, request);
+            }
             const continuedInvalidExecutable = this.selectedRecordSurfaceRuntimeOperationForInvalidExecutable(response, request, compiled.warnings);
             if (continuedInvalidExecutable) {
-                return continuedInvalidExecutable;
+                return continuedInvalidExecutable.componentEditPlan
+                    ? this.compileAdapterResponse(continuedInvalidExecutable, request)
+                    : continuedInvalidExecutable;
             }
             return {
                 type: 'error',
@@ -639,17 +669,253 @@ class TableAgenticAuthoringTurnFlow {
         if (implicitSelectedFilterClarification) {
             return implicitSelectedFilterClarification;
         }
+        const normalizedCompiled = this.normalizeBulkRouteSelectionPayload(compiled, request);
         const warnings = [
             ...(response.warnings ?? []),
-            ...(compiled.warnings ?? []),
+            ...(normalizedCompiled.warnings ?? []),
         ];
         return {
             ...response,
-            ...compiled,
-            patch: compiled.patch,
+            ...normalizedCompiled,
+            patch: normalizedCompiled.patch,
             warnings: warnings.length ? warnings : undefined,
         };
     }
+    normalizeBulkRouteSelectionPayload(compiled, request) {
+        if (!compiled?.patch || !request)
+            return compiled;
+        const text = this.normalizeLabel([
+            ...(request.messages ?? [])
+                .filter((message) => message?.role === 'user')
+                .slice(-2)
+                .map((message) => message?.text ?? ''),
+            request.prompt ?? '',
+        ].join(' '));
+        if (!this.textMentionsBulkActionRequest(text))
+            return compiled;
+        const routePath = this.extractRoutePath(text);
+        const patch = this.cloneJson(compiled.patch);
+        const componentEditPlan = compiled.componentEditPlan
+            ? this.cloneJson(compiled.componentEditPlan)
+            : undefined;
+        const bulkActions = patch?.actions?.bulk?.actions;
+        let changed = false;
+        if (Array.isArray(bulkActions)) {
+            for (const action of bulkActions) {
+                if (!action || typeof action !== 'object')
+                    continue;
+                if (this.ensureBulkRouteActionSelectionQuery(action, routePath)) {
+                    changed = true;
+                }
+            }
+        }
+        if (componentEditPlan && this.ensureBulkRouteActionSelectionQueryOnPlan(componentEditPlan, routePath)) {
+            changed = true;
+        }
+        if (!Array.isArray(bulkActions) && !componentEditPlan)
+            return compiled;
+        if (!changed)
+            return compiled;
+        return {
+            ...compiled,
+            ...(componentEditPlan ? { componentEditPlan } : {}),
+            patch,
+            warnings: [
+                ...(compiled.warnings ?? []),
+                'bulk-route-action-selection-query-normalized',
+            ],
+        };
+    }
+    ensureBulkRouteActionSelectionQueryOnPlan(plan, routePath) {
+        if (!plan || typeof plan !== 'object')
+            return false;
+        let changed = false;
+        for (const key of ['input', 'value']) {
+            if (this.ensureBulkRouteActionSelectionQuery(plan[key], routePath)) {
+                changed = true;
+            }
+        }
+        if (Array.isArray(plan.operations)) {
+            for (const operation of plan.operations) {
+                if (!operation || typeof operation !== 'object')
+                    continue;
+                for (const key of ['input', 'value']) {
+                    if (this.ensureBulkRouteActionSelectionQuery(operation[key], routePath)) {
+                        changed = true;
+                    }
+                }
+            }
+        }
+        return changed;
+    }
+    ensureBulkRouteActionSelectionQuery(action, routePath) {
+        if (!action || typeof action !== 'object')
+            return false;
+        let changed = false;
+        if (this.ensureBulkRouteActionGlobalRouteRef(action, routePath)) {
+            changed = true;
+        }
+        if (this.ensureGlobalRouteActionSelectionQuery(action.globalAction)) {
+            changed = true;
+        }
+        if (Array.isArray(action.effects)) {
+            for (const effect of action.effects) {
+                if (effect?.kind === 'global-action' && this.ensureGlobalRouteActionSelectionQuery(effect.globalAction)) {
+                    changed = true;
+                }
+            }
+        }
+        return changed;
+    }
+    ensureBulkRouteActionGlobalRouteRef(action, routePath) {
+        if (!routePath)
+            return false;
+        if (this.hasGlobalRouteActionRef(action))
+            return false;
+        const configuredAction = this.stringValue(action.action);
+        const looksLikeRouteAction = configuredAction === 'navigation.openRoute'
+            || configuredAction === 'navigation.open route'
+            || this.stringValue(action.globalAction?.actionId) === 'navigation.openRoute';
+        const hasRoutePayload = this.stringValue(action.payload?.path)
+            || this.stringValue(action.globalAction?.payload?.path)
+            || routePath;
+        if (!looksLikeRouteAction && !hasRoutePayload)
+            return false;
+        const globalAction = {
+            actionId: 'navigation.openRoute',
+            payload: {
+                path: this.stringValue(action.payload?.path)
+                    || this.stringValue(action.globalAction?.payload?.path)
+                    || routePath,
+                query: { ids: '${runtime.selectedIds}' },
+            },
+        };
+        action.globalAction = globalAction;
+        action.effects = [{ kind: 'global-action', globalAction }];
+        if (!this.stringValue(action.action)) {
+            action.action = 'navigation.openRoute';
+        }
+        return true;
+    }
+    hasGlobalRouteActionRef(action) {
+        if (this.stringValue(action?.globalAction?.actionId) === 'navigation.openRoute') {
+            return true;
+        }
+        if (!Array.isArray(action?.effects))
+            return false;
+        return action.effects.some((effect) => effect?.kind === 'global-action'
+            && this.stringValue(effect.globalAction?.actionId) === 'navigation.openRoute');
+    }
+    ensureGlobalRouteActionSelectionQuery(globalAction) {
+        if (!globalAction || typeof globalAction !== 'object')
+            return false;
+        if (globalAction.actionId !== 'navigation.openRoute')
+            return false;
+        const payload = globalAction.payload;
+        if (!payload || typeof payload !== 'object')
+            return false;
+        if (!this.stringValue(payload.path))
+            return false;
+        if (!payload.query || typeof payload.query !== 'object' || Array.isArray(payload.query)) {
+            payload.query = {};
+        }
+        if (payload.query.ids !== undefined && payload.query.ids !== null && payload.query.ids !== '') {
+            return false;
+        }
+        payload.query.ids = '${runtime.selectedIds}';
+        return true;
+    }
+    recordSurfaceRowActionGuidanceForConsult(response, request) {
+        if (!request || !this.promptAsksRowActionCapabilities(request))
+            return null;
+        if (!this.responseCarriesRowActionAddPlan(response))
+            return null;
+        const surfaces = this.selectedRecordSurfaces(this.contextHintsFor(request));
+        if (!surfaces.length)
+            return null;
+        const labels = [...new Set(surfaces
+                .map((surface) => {
+                const resourceSurface = this.toRecord(surface['resourceSurface']);
+                return this.stringValue(surface['label'])
+                    || this.stringValue(resourceSurface?.['title'])
+                    || this.stringValue(surface['id']);
+            })
+                .filter((label) => !!label))];
+        if (!labels.length)
+            return null;
+        return {
+            type: 'info',
+            message: [
+                'Você pode adicionar botões de linha para superfícies relacionadas declaradas para este recurso.',
+                `Opções disponíveis agora: ${labels.map((label) => `**${label}**`).join(', ')}.`,
+                'Quando quiser materializar uma delas, peça algo como "adicione um botão na linha para abrir Histórico de folha".',
+            ].join(' '),
+            warnings: [
+                'row-action-capability-question-preserved-as-consult',
+                'Residual consult guard acted only after the LLM proposed rowAction.add for a row-action capability-discovery question while declared recordSurfaces were available.',
+            ],
+        };
+    }
+    promptAsksRowActionCapabilities(request) {
+        const currentPrompt = this.normalizeLabel(request.prompt ?? '');
+        const recentUserContext = this.normalizeLabel((request.messages ?? [])
+            .filter((message) => message?.role === 'user')
+            .slice(-2)
+            .map((message) => message?.text ?? '')
+            .join(' '));
+        const text = [recentUserContext, currentPrompt].filter(Boolean).join(' ');
+        if (!this.textMentionsRowActionRequest(text))
+            return false;
+        const asksAvailability = [
+            'quais',
+            'qual',
+            'o que',
+            'que botoes',
+            'que botões',
+            'botoes posso',
+            'botões posso',
+            'acoes disponiveis',
+            'ações disponíveis',
+            'acoes estao disponiveis',
+            'ações estão disponíveis',
+            'posso adicionar',
+            'can i add',
+            'available',
+            'what actions',
+            'which actions',
+            'which buttons',
+        ].some((needle) => text.includes(this.normalizeLabel(needle)));
+        if (!asksAvailability)
+            return false;
+        const explicitMaterialization = [
+            'adicione',
+            'adicionar agora',
+            'crie',
+            'criar agora',
+            'coloque',
+            'aplique',
+            'materialize',
+            'create a',
+            'add a',
+        ].some((needle) => currentPrompt.includes(this.normalizeLabel(needle)));
+        return !explicitMaterialization;
+    }
+    responseCarriesRowActionAddPlan(response) {
+        const record = response;
+        return [
+            this.toRecord(record['componentEditPlan']),
+            this.toRecord(this.toRecord(record['patch'])?.['componentEditPlan']),
+            this.toRecord(record['tableEditPlan']),
+            this.toRecord(record['editPlan']),
+        ].some((plan) => {
+            if (!plan)
+                return false;
+            if (this.stringValue(plan['operationId']) === 'rowAction.add')
+                return true;
+            const operations = Array.isArray(plan['operations']) ? plan['operations'] : [];
+            return operations.some((operation) => this.stringValue(this.toRecord(operation)?.['operationId']) === 'rowAction.add');
+        });
+    }
     responseCarriesClarificationChoices(response) {
         if (response.type !== 'clarification')
             return false;
@@ -930,7 +1196,7 @@ class TableAgenticAuthoringTurnFlow {
             ...(request.messages ?? []).slice(-8).map((message) => message?.text ?? ''),
             request.prompt ?? '',
         ].join(' '));
-        if (!this.textMentionsRowActionRequest(normalizedPrompt || normalizedConversation)) {
+        if (!this.textMentionsRowActionRequest(`${normalizedPrompt} ${normalizedConversation}`)) {
             return null;
         }
         const clarificationKind = this.selectedRecordSurfaceRowActionClarificationKind(response);
@@ -950,52 +1216,65 @@ class TableAgenticAuthoringTurnFlow {
         if (!ranked.length || (ranked.length > 1 && ranked[0].score === ranked[1].score)) {
             return null;
         }
-        const surface = ranked[0].surface;
-        const resourceSurface = this.toRecord(surface['resourceSurface']);
-        if (!this.isResourceSurfaceCatalogDigest(resourceSurface)) {
-            return null;
-        }
-        const surfaceId = this.stringValue(surface['id']) || this.stringValue(resourceSurface['id']);
-        if (!surfaceId)
+        const hasSelectedRecords = this.selectedRecordsCountForTurn > 0;
+        const source = hasSelectedRecords
+            ? 'selected-record-surface-row-action-continued-from-clarification'
+            : 'record-surface-row-action-continued-from-clarification';
+        const warning = hasSelectedRecords
+            ? (clarificationKind === 'technical'
+                ? 'selected-record-surface-row-action-continued-from-technical-clarification'
+                : 'selected-record-surface-row-action-continued-from-generic-clarification')
+            : 'record-surface-row-action-continued-from-clarification';
+        const warningDetail = clarificationKind === 'technical'
+            ? `Residual continuity guard acted only after LLM asked for technical row-action details while declared recordSurfaces${hasSelectedRecords ? ' and conversation history' : ''} already grounded the target surface.`
+            : 'Residual continuity guard acted only after LLM asked a generic dataset/listing clarification while declared recordSurfaces and a row-action request already grounded the target surface.';
+        const rowActionResponse = this.buildSelectedRecordSurfaceRowActionResponse(ranked[0].surface, source, warning, warningDetail);
+        if (!rowActionResponse)
             return null;
-        const surfaceLabel = this.stringValue(surface['label'])
-            || this.stringValue(resourceSurface['title'])
-            || this.humanizeField(surfaceId);
-        const actionId = `open-${this.slugifyActionId(surfaceId)}`;
-        const rowAction = {
-            id: actionId,
-            label: surfaceLabel,
-            action: 'surface.open',
-            icon: 'open_in_new',
-            recordSurface: this.toAiJsonObject(resourceSurface),
-        };
         // Residual continuity guard: this runs only after the LLM returned a
         // clarification/info response for a row-button request. The target surface
         // is ranked from declared canonical recordSurfaces and recent conversation
         // context, so the guard repairs materialization without becoming primary
         // intent routing by local command text.
-        return {
-            type: 'patch',
-            componentEditPlan: {
-                kind: 'praxis.table.component-edit-plan',
-                version: '1.0',
-                componentId: 'praxis-table',
-                operationId: 'rowAction.add',
-                changeKind: 'add_row_action',
-                capabilityPath: 'actions.row.actions[]',
-                input: rowAction,
-                value: rowAction,
-            },
-            explanation: `Vou criar um botão em cada linha para abrir ${surfaceLabel}.`,
-            warnings: [
-                clarificationKind === 'technical'
-                    ? 'selected-record-surface-row-action-continued-from-technical-clarification'
-                    : 'selected-record-surface-row-action-continued-from-generic-clarification',
-                clarificationKind === 'technical'
-                    ? 'Residual continuity guard acted only after LLM asked for technical row-action details while declared recordSurfaces and conversation history already grounded the target surface.'
-                    : 'Residual continuity guard acted only after LLM asked a generic dataset/listing clarification while declared recordSurfaces and a row-action request already grounded the target surface.',
-            ],
-        };
+        return rowActionResponse;
+    }
+    selectedRecordSurfaceRowActionPlanForInfo(response, request) {
+        if (response.type !== 'info' || !request)
+            return null;
+        const normalizedPrompt = this.normalizeLabel(request.prompt ?? '');
+        const normalizedConversation = this.normalizeLabel([
+            ...(request.messages ?? []).slice(-8).map((message) => message?.text ?? ''),
+            request.prompt ?? '',
+        ].join(' '));
+        if (!this.textMentionsRowActionRequest(`${normalizedPrompt} ${normalizedConversation}`)) {
+            return null;
+        }
+        const responseText = this.normalizeLabel([
+            response.message ?? '',
+            response.explanation ?? '',
+        ].join(' '));
+        if (!this.textMentionsSurfaceOpenCommitment(responseText) && !this.textMentionsRowActionRequest(responseText)) {
+            return null;
+        }
+        const contextHints = this.contextHintsFor(request);
+        const surfaces = this.selectedRecordSurfaces(contextHints);
+        if (!surfaces.length)
+            return null;
+        const ranked = surfaces
+            .map((surface) => ({
+            surface,
+            score: this.selectedRecordSurfacePromptScore(`${normalizedConversation || normalizedPrompt} ${responseText}`, surface),
+        }))
+            .filter((entry) => entry.score >= 2)
+            .sort((left, right) => right.score - left.score);
+        if (!ranked.length || (ranked.length > 1 && ranked[0].score === ranked[1].score)) {
+            return null;
+        }
+        // Residual continuity guard: this runs only after the LLM has already
+        // answered an info turn for a row-button request but failed to emit the
+        // manifest-backed rowAction.add envelope. The target is ranked from the
+        // governed recordSurfaces catalog plus LLM-authored evidence.
+        return this.buildSelectedRecordSurfaceRowActionResponse(ranked[0].surface, 'selected-record-surface-row-action-info-continuity-guard', 'selected-record-surface-row-action-continued-from-info', 'Residual continuity guard acted only after LLM resolved a declared recordSurface in an info answer for a row-action request without emitting rowAction.add.');
     }
     selectedRecordSurfaceRuntimeOperationForInfo(response, request) {
         if (response.type !== 'info' || !request)
@@ -1062,9 +1341,14 @@ class TableAgenticAuthoringTurnFlow {
         if (!request || !this.responseMayContainExecutableEnvelope(response))
             return null;
         const normalizedPrompt = this.normalizeLabel(request.prompt ?? '');
-        if (!this.textMentionsRecordSurfaceOpenRequest(normalizedPrompt))
+        const normalizedConversation = this.normalizeLabel([
+            ...(request.messages ?? []).slice(-8).map((message) => message?.text ?? ''),
+            request.prompt ?? '',
+        ].join(' '));
+        const requestText = `${normalizedPrompt} ${normalizedConversation}`;
+        if (!this.textMentionsRecordSurfaceOpenRequest(requestText))
             return null;
-        if (this.promptRequestsSimilarRecords(normalizedPrompt))
+        if (this.promptRequestsSimilarRecords(requestText))
             return null;
         const contextHints = this.contextHintsFor(request);
         const surfaces = this.selectedRecordSurfaces(contextHints);
@@ -1080,13 +1364,18 @@ class TableAgenticAuthoringTurnFlow {
         const ranked = surfaces
             .map((surface) => ({
             surface,
-            score: this.selectedRecordSurfacePromptScore(`${normalizedPrompt} ${responseEvidence}`, surface),
+            score: this.selectedRecordSurfacePromptScore(`${requestText} ${responseEvidence}`, surface),
         }))
             .filter((entry) => entry.score >= 2)
             .sort((left, right) => right.score - left.score);
         if (!ranked.length || (ranked.length > 1 && ranked[0].score === ranked[1].score)) {
             return null;
         }
+        if (this.textMentionsRowActionRequest(requestText)) {
+            const rowActionResponse = this.buildSelectedRecordSurfaceRowActionResponse(ranked[0].surface, 'selected-record-surface-row-action-invalid-executable-continuity-guard', 'selected-record-surface-row-action-continued-from-invalid-executable', 'Residual continuity guard acted only after LLM emitted an executable envelope that failed table component capability validation for a row-action request while a declared recordSurface uniquely matched the selected-record request.');
+            if (rowActionResponse)
+                return rowActionResponse;
+        }
         const surface = ranked[0].surface;
         const surfaceId = this.stringValue(surface['id']);
         if (!surfaceId)
@@ -1121,6 +1410,152 @@ class TableAgenticAuthoringTurnFlow {
             ],
         };
     }
+    buildSelectedRecordSurfaceRowActionResponse(surface, source, warning, warningDetail) {
+        const resourceSurface = this.toRecord(surface['resourceSurface']);
+        if (!this.isResourceSurfaceCatalogDigest(resourceSurface)) {
+            return null;
+        }
+        const surfaceId = this.stringValue(surface['id']) || this.stringValue(resourceSurface['id']);
+        if (!surfaceId)
+            return null;
+        const surfaceLabel = this.stringValue(surface['label'])
+            || this.stringValue(resourceSurface['title'])
+            || this.humanizeField(surfaceId);
+        const actionId = `open-${this.slugifyActionId(surfaceId)}`;
+        const rowAction = {
+            id: actionId,
+            label: surfaceLabel,
+            action: 'surface.open',
+            icon: 'open_in_new',
+            recordSurface: this.toAiJsonObject(resourceSurface),
+        };
+        return {
+            type: 'patch',
+            componentEditPlan: {
+                kind: 'praxis.table.component-edit-plan',
+                version: '1.0',
+                componentId: 'praxis-table',
+                operationId: 'rowAction.add',
+                changeKind: 'add_row_action',
+                capabilityPath: 'actions.row.actions[]',
+                input: rowAction,
+                value: rowAction,
+                source,
+            },
+            explanation: `Vou criar um botão em cada linha para abrir ${surfaceLabel}.`,
+            warnings: [warning, warningDetail],
+        };
+    }
+    bulkRouteActionPlanForClarification(response, request) {
+        if (response.type !== 'clarification' || !request)
+            return null;
+        const normalizedPrompt = this.normalizeLabel(request.prompt ?? '');
+        if (!this.textMentionsBulkActionRequest(normalizedPrompt))
+            return null;
+        if (!this.textMentionsRecordSurfaceOpenRequest(normalizedPrompt))
+            return null;
+        const routePath = this.extractRoutePath(request.prompt ?? '');
+        if (!routePath)
+            return null;
+        const clarificationKind = this.globalActionClarificationKind(response);
+        if (!clarificationKind)
+            return null;
+        return this.buildBulkRouteActionPlan(routePath, 'bulk-route-action-continued-from-clarification', [
+            'bulk-route-action-continued-from-technical-clarification',
+            'Residual continuity guard acted only after LLM asked for technical bulk route details while a route path and selected-record bulk action intent were already grounded.',
+        ]);
+    }
+    bulkRouteActionPlanForInvalidExecutable(response, request, validationWarnings = []) {
+        if (!request)
+            return null;
+        if (!response.componentEditPlan && !response.patch)
+            return null;
+        const normalizedPrompt = this.normalizeLabel(request.prompt ?? '');
+        if (!this.textMentionsBulkActionRequest(normalizedPrompt))
+            return null;
+        if (!this.textMentionsRecordSurfaceOpenRequest(normalizedPrompt))
+            return null;
+        const routePath = this.extractRoutePath(request.prompt ?? '');
+        if (!routePath)
+            return null;
+        return this.buildBulkRouteActionPlan(routePath, 'bulk-route-action-continued-from-invalid-executable', [
+            ...validationWarnings,
+            'bulk-route-action-continued-from-invalid-executable',
+            'Residual continuity guard acted only after LLM proposed an invalid executable table plan while route path and selected-record bulk action intent were already grounded.',
+        ]);
+    }
+    bulkRouteActionPlanForNonExecutableNarrative(response, request) {
+        if (!request)
+            return null;
+        const normalizedPrompt = this.normalizeLabel(request.prompt ?? '');
+        if (!this.textMentionsBulkActionRequest(normalizedPrompt))
+            return null;
+        if (!this.textMentionsRecordSurfaceOpenRequest(normalizedPrompt))
+            return null;
+        const routePath = this.extractRoutePath(request.prompt ?? '');
+        if (!routePath)
+            return null;
+        const narrative = this.normalizeLabel([
+            response.message ?? '',
+            response.explanation ?? '',
+            ...(response.warnings ?? []),
+        ].join(' '));
+        const hasCanonicalDecision = this.normalizedTextIncludesAny(narrative, ['componentEditPlan', 'component edit plan'])
+            && this.normalizedTextIncludesAny(narrative, ['bulkAction.add', 'bulk action.add'])
+            && this.normalizedTextIncludesAny(narrative, ['navigation.openRoute', 'navigation.open route'])
+            && this.normalizedTextIncludesAny(narrative, ['selectedIds', 'selected ids', 'runtime.selectedIds']);
+        if (!hasCanonicalDecision)
+            return null;
+        return this.buildBulkRouteActionPlan(routePath, 'bulk-route-action-continued-from-non-executable-narrative', [
+            'bulk-route-action-continued-from-non-executable-narrative',
+            'Residual continuity guard acted only after LLM described the canonical bulkAction.add/navigation.openRoute decision without returning an executable componentEditPlan envelope.',
+        ]);
+    }
+    buildBulkRouteActionPlan(routePath, source, warnings) {
+        const actionId = `open-${this.slugifyActionId(routePath)}-selected`;
+        const label = this.humanizeBulkRouteActionLabel(routePath);
+        const globalAction = {
+            actionId: 'navigation.openRoute',
+            payload: {
+                path: routePath,
+                query: { ids: '${runtime.selectedIds}' },
+            },
+        };
+        const bulkAction = {
+            id: actionId,
+            label,
+            action: 'navigation.openRoute',
+            icon: 'route',
+            globalAction,
+            effects: [
+                {
+                    kind: 'global-action',
+                    globalAction,
+                },
+            ],
+        };
+        // Residual continuity guard: this executes only after the LLM already
+        // resolved the turn as a clarification, while the user-provided route path
+        // and the declared bulkAction.add/globalAction contract are sufficient to
+        // materialize the operation. It grounds payload details in canonical runtime
+        // selection templates instead of using local text as primary intent routing.
+        return {
+            type: 'patch',
+            componentEditPlan: {
+                kind: 'praxis.table.component-edit-plan',
+                version: '1.0',
+                componentId: 'praxis-table',
+                operationId: 'bulkAction.add',
+                changeKind: 'add_bulk_action',
+                capabilityPath: 'actions.bulk.actions[]',
+                input: bulkAction,
+                value: bulkAction,
+                source,
+            },
+            explanation: `Vou adicionar a ação ${label} para os registros selecionados.`,
+            warnings,
+        };
+    }
     selectedRecordSurfaceRowActionClarificationKind(response) {
         const text = this.normalizeLabel([
             response.message ?? '',
@@ -1134,6 +1569,30 @@ class TableAgenticAuthoringTurnFlow {
             'mais detalhes sobre surface',
             'mais detalhes sobre button',
             'mais detalhes sobre placement',
+            'mais detalhes sobre openmode',
+            'mais detalhes sobre open mode',
+            'mais detalhes sobre iconorstyle',
+            'mais detalhes sobre appliesto',
+            'mais detalhes sobre actionlabel',
+            'mais detalhes sobre openbehavior',
+            'mais detalhes sobre actionbehavior',
+            'mais detalhes sobre destinationsurface',
+            'mais detalhes sobre iconlabel',
+            'qual condicao deve ser usada',
+            'qual condição deve ser usada',
+            'mais detalhes sobre action behavior',
+            'o alvo do ajuste',
+            'nome que voce prefere',
+            'nome que você prefere',
+            'openmode',
+            'open mode',
+            'iconorstyle',
+            'appliesto',
+            'actionlabel',
+            'openbehavior',
+            'actionbehavior',
+            'destinationsurface',
+            'iconlabel',
         ].some((needle) => text.includes(needle))) {
             return 'technical';
         }
@@ -1150,16 +1609,68 @@ class TableAgenticAuthoringTurnFlow {
         }
         return null;
     }
+    globalActionClarificationKind(response) {
+        const text = this.normalizeLabel([
+            response.message ?? '',
+            response.explanation ?? '',
+            ...(response.questions ?? []),
+        ].join(' '));
+        if ([
+            'recordidparamname',
+            'record id param name',
+            'o alvo do ajuste',
+            'qual formato aplicar',
+            'mais detalhes sobre target',
+            'mais detalhes sobre payload',
+            'mais detalhes sobre route',
+            'mais detalhes sobre openmode',
+            'mais detalhes sobre open mode',
+        ].some((needle) => text.includes(this.normalizeLabel(needle)))) {
+            return 'technical';
+        }
+        return null;
+    }
     textMentionsRowActionRequest(normalizedText) {
         return [
             'botao',
             'acao de linha',
             'acoes de linha',
+            'acao por registro',
+            'acoes por registro',
             'nas linhas',
             'por linha',
             'em cada linha',
         ].some((needle) => normalizedText.includes(needle));
     }
+    textMentionsBulkActionRequest(normalizedText) {
+        return [
+            'acao em lote',
+            'acoes em lote',
+            'registros selecionados',
+            'linhas selecionadas',
+            'selecionados',
+            'bulk action',
+        ].some((needle) => normalizedText.includes(this.normalizeLabel(needle)));
+    }
+    normalizedTextIncludesAny(normalizedText, needles) {
+        return needles.some((needle) => normalizedText.includes(this.normalizeLabel(needle)));
+    }
+    extractRoutePath(text) {
+        const match = String(text || '').match(/(?:^|\s)(\/[A-Za-z0-9._~:/?#[\]@!$&'()*+,;=%-]+)(?=$|\s|[,.])/u);
+        return match?.[1]?.replace(/[,.]$/u, '') ?? '';
+    }
+    humanizeBulkRouteActionLabel(path) {
+        const segments = path
+            .split(/[?#]/u)[0]
+            .split('/')
+            .map((segment) => segment.trim())
+            .filter(Boolean);
+        const lastSegments = segments.slice(-2);
+        const label = lastSegments
+            .map((segment) => this.humanizeField(segment))
+            .join(' - ');
+        return label ? `Abrir ${label}` : 'Abrir rota dos selecionados';
+    }
     textMentionsRecordSurfaceOpenRequest(normalizedText) {
         return [
             'abrir',
@@ -1979,6 +2490,9 @@ class TableAgenticAuthoringTurnFlow {
             case 'rowAction.add':
             case 'add_row_action':
                 return `Vou criar um botao em cada linha para abrir **${this.stringValue(input['label']) || this.stringValue(input['id']) || 'a opcao solicitada'}**.`;
+            case 'bulkAction.add':
+            case 'add_bulk_action':
+                return `Vou adicionar a acao **${this.stringValue(input['label']) || this.stringValue(input['id']) || 'solicitada'}** para os registros selecionados.`;
             case 'export.configure':
                 return this.describeExportConfigure(input);
             case 'appearance.density.set':
@@ -3004,6 +3518,14 @@ class TableAgenticAuthoringTurnFlow {
             return {};
         }
     }
+    cloneJson(value) {
+        try {
+            return JSON.parse(JSON.stringify(value));
+        }
+        catch {
+            return value;
+        }
+    }
     toRecord(value) {
         return value && typeof value === 'object' && !Array.isArray(value)
             ? value