@praxisui/table 8.0.0-beta.52 → 8.0.0-beta.54

package/fesm2022/{praxisui-table-praxisui-table-GekTiEGg.mjs → praxisui-table-praxisui-table-KAnwisrq.mjs}

@@ -39528,7 +39528,7 @@ class PraxisTable {
         if (this.aiAdapter || this.aiAdapterLoadStarted)
             return;
         this.aiAdapterLoadStarted = true;
-        import('./praxisui-table-table-ai.adapter-eGo1zPuy.mjs')
+        import('./praxisui-table-table-ai.adapter-B3KQThqg.mjs')
             .then(({ TableAiAdapter }) => {
             this.aiAdapter = new TableAiAdapter(this);
             this.initializeAiAssistantController();
@@ -39678,7 +39678,7 @@ class PraxisTable {
     initializeAiAssistantController() {
         if (!this.aiAdapter || this.aiAssistantController)
             return;
-        import('./praxisui-table-table-agentic-authoring-turn-flow-DtoCwCVX.mjs')
+        import('./praxisui-table-table-agentic-authoring-turn-flow-B075RDUj.mjs')
             .then(({ TableAgenticAuthoringTurnFlow }) => {
             if (this.aiAssistantController || !this.aiAdapter)
                 return;

package/fesm2022/{praxisui-table-table-agentic-authoring-turn-flow-DtoCwCVX.mjs → praxisui-table-table-agentic-authoring-turn-flow-B075RDUj.mjs}

@@ -48,11 +48,9 @@ class TableAgenticAuthoringTurnFlow {
             this.selectedRecordFieldsForTurn = this.extractSelectedRecordFields(contextHints);
             this.selectedRecordsCountForTurn = this.extractSelectedRecordsCount(contextHints);
             this.filterExpressionSupportedForTurn = this.resolveFilterExpressionSupported(contextHints);
-            const localResponse = this.selectedRecordLocalResponse(request, contextHints);
             const messages = this.withCapabilitySystemMessages(this.toChatMessages(request.messages, prompt), contextHints);
             return {
                 contextHints,
-                ...(localResponse ? { localResponse } : {}),
                 patchRequest: {
                     componentId,
                     componentType,
@@ -80,21 +78,8 @@ class TableAgenticAuthoringTurnFlow {
         return this.submitViaSnapshot(request, currentState, run);
     }
     async submitViaSnapshot(request, currentState, buildRequest) {
-        const { patchRequest, contextHints, localResponse } = await buildRequest();
-        if (localResponse) {
-            return this.toTurnResult(this.compileAdapterResponse(localResponse, request), request);
-        }
-        let response;
-        try {
-            response = await firstValueFrom(this.aiApi.getPatch(patchRequest));
-        }
-        catch (error) {
-            const recovery = this.selectedRecordBackendFailureClarification(request, contextHints ?? null, error);
-            if (recovery) {
-                return this.toTurnResult(recovery, request);
-            }
-            throw error;
-        }
+        const { patchRequest } = await buildRequest();
+        const response = await firstValueFrom(this.aiApi.getPatch(patchRequest));
         return this.toTurnResult(this.compileAdapterResponse(this.groundRelativeColumnOrder(response, request, currentState), request), request);
     }
     submitViaStream(request, prompt, currentState, componentId, buildRequest) {
@@ -226,15 +211,8 @@ class TableAgenticAuthoringTurnFlow {
             void (async () => {
                 try {
                     emitProgress(this.buildInitialProgressMessage(prompt, componentId));
-                    const { patchRequest, contextHints, localResponse } = await buildRequest();
+                    const { patchRequest, contextHints } = await buildRequest();
                     streamContextHints = contextHints ?? null;
-                    if (localResponse) {
-                        subscriber.next(this.toTurnResult(this.compileAdapterResponse(localResponse, request), request));
-                        subscriber.complete();
-                        closed = true;
-                        closeConnection();
-                        return;
-                    }
                     if (this.shouldUseSelectedRecordSurfaceSnapshotFallback(streamContextHints)) {
                         const result = await this.submitViaSnapshot(request, currentState, buildRequest);
                         if (!closed) {
@@ -574,26 +552,6 @@ class TableAgenticAuthoringTurnFlow {
     isTurnInProgressResponse(response) {
         return this.normalizeLabel(response.code ?? '') === 'turn in progress';
     }
-    selectedRecordLocalResponse(request, contextHints) {
-        if (this.authoringContractHasResponseModes(contextHints)) {
-            return this.completeSelectedRecordFilterClarification(request, contextHints);
-        }
-        return this.selectedRecordMissingSelectionAnswer(request, contextHints)
-            ?? this.selectedRecordExportOnlyRequest(request, contextHints)
-            ?? this.selectedRecordSingleCandidateQuestionAnswer(request, contextHints)
-            ?? this.selectedRecordFieldQuestionAnswer(request, contextHints)
-            ?? this.selectedRecordMultiFieldQuestionAnswer(request, contextHints)
-            ?? this.completeSelectedRecordFilterApplyRequest(request, contextHints)
-            ?? this.selectedRecordCommonQuestionAnswer(request, contextHints)
-            ?? this.completeSelectedRecordFilterClarification(request, contextHints)
-            ?? this.selectedRecordMultipleFilterFieldClarification(request, contextHints)
-            ?? this.selectedRecordSimilarityClarification(request, contextHints);
-    }
-    authoringContractHasResponseModes(contextHints) {
-        const authoringContract = this.toRecord(contextHints?.['authoringContract']);
-        return Array.isArray(authoringContract?.['responseModes'])
-            && authoringContract['responseModes'].length > 0;
-    }
     compileAdapterResponse(response, request) {
         if (response.type === 'clarification' || response.type === 'info' || response.type === 'error') {
             return response;
@@ -700,851 +658,6 @@ class TableAgenticAuthoringTurnFlow {
             .map((operation) => this.toRecord(operation))
             .some((operation) => this.stringValue(operation?.['operationId']) === 'table.filter.apply');
     }
-    completeSelectedRecordFilterClarification(request, contextHints) {
-        if (request.action?.kind !== 'clarify')
-            return null;
-        const selectedRecordsFilter = this.toRecord(contextHints?.['selectedRecordsFilter']);
-        const field = this.stringValue(selectedRecordsFilter?.['field']);
-        if (!field)
-            return null;
-        const candidate = this.selectedRecordFilterCandidate(contextHints, field);
-        const criteria = this.toRecord(candidate?.['criteria']);
-        if (!criteria || Object.keys(criteria).length === 0)
-            return null;
-        const label = this.stringValue(candidate?.['label'])
-            || this.stringValue(selectedRecordsFilter?.['label'])
-            || this.humanizeFilterField(field);
-        return this.selectedRecordFilterApplyResponse(label, criteria, [
-            'selected-record-filter-clarification-materialized',
-            'Clarification choice carried canonical filter field context; selectedRecordsContext.filterCandidates supplied runtime criteria.',
-        ], request, contextHints);
-    }
-    completeSelectedRecordFilterApplyRequest(request, contextHints) {
-        if (this.selectedRecordsCountForTurn <= 0)
-            return null;
-        const prompt = this.selectedRecordFilterGroundingPrompt(request, contextHints);
-        if (!prompt || !this.selectedRecordFilterApplyRequested(prompt))
-            return null;
-        const availableCandidates = this.selectedRecordFilterCandidates(contextHints)
-            .filter((candidate) => {
-            const field = this.stringValue(candidate['field']);
-            const criteria = this.toRecord(candidate['criteria']);
-            return !!field
-                && !!criteria
-                && Object.keys(criteria).length > 0;
-        });
-        const candidates = availableCandidates
-            .map((candidate) => ({
-            candidate,
-            score: this.selectedRecordFilterPromptGroundingScore(prompt, candidate),
-        }))
-            .filter((entry) => entry.score > 0)
-            .sort((left, right) => right.score - left.score);
-        if (!candidates.length)
-            return null;
-        if (candidates.length > 1 && candidates[0].score === candidates[1].score)
-            return null;
-        const candidate = candidates[0].candidate;
-        const field = this.stringValue(candidate['field']);
-        const criteria = this.toRecord(candidate['criteria']);
-        if (!field || !criteria)
-            return null;
-        const label = this.stringValue(candidate['label']) || this.humanizeFilterField(field);
-        return this.selectedRecordFilterApplyResponse(label, criteria, [
-            'selected-record-filter-request-materialized',
-            'Selected records supplied canonical filterCandidates; user prompt grounded one candidate through the declared filter field catalog.',
-        ], request, contextHints);
-    }
-    selectedRecordFieldQuestionAnswer(request, contextHints) {
-        if (this.selectedRecordsCountForTurn !== 1)
-            return null;
-        const prompt = request.prompt ?? '';
-        const normalizedPrompt = this.normalizeLabel(prompt);
-        if (!this.selectedRecordInformationalQuestionRequested(normalizedPrompt))
-            return null;
-        if (this.selectedRecordFilterApplyRequested(prompt))
-            return null;
-        const row = this.selectedRecordSampleRows(contextHints)[0];
-        if (!row)
-            return null;
-        const candidates = Object.keys(row)
-            .map((field) => ({
-            field,
-            score: this.selectedRecordQuestionFieldScore(normalizedPrompt, field),
-        }))
-            .filter((entry) => entry.score > 0)
-            .sort((left, right) => right.score - left.score);
-        const field = candidates.length
-            ? this.singleTopSelectedRecordQuestionField(candidates)
-            : this.singleTemporalSelectedRecordField(normalizedPrompt, row);
-        if (!field)
-            return null;
-        const value = row[field];
-        if (value === undefined || value === null || value === '')
-            return null;
-        const label = this.selectedRecordFieldLabel(field);
-        return {
-            type: 'info',
-            message: `${label} do registro selecionado: ${this.formatSelectedRecordFilterValue(value)}.`,
-            warnings: [
-                'selected-record-field-question-answered-locally',
-                'Single selected record supplied sampleRows; local answer grounded a field-level informational question before remote authoring.',
-            ],
-        };
-    }
-    selectedRecordSingleCandidateQuestionAnswer(request, contextHints) {
-        if (this.selectedRecordsCountForTurn !== 1)
-            return null;
-        const prompt = request.prompt ?? '';
-        const normalizedPrompt = this.normalizeLabel(prompt);
-        if (!this.selectedRecordInformationalQuestionRequested(normalizedPrompt))
-            return null;
-        if (this.selectedRecordFilterApplyRequested(prompt))
-            return null;
-        const candidates = this.selectedRecordFilterCandidates(contextHints)
-            .map((candidate) => ({
-            candidate,
-            score: this.selectedRecordCandidateQuestionScore(normalizedPrompt, candidate),
-        }))
-            .filter((entry) => entry.score > 0)
-            .sort((left, right) => right.score - left.score);
-        if (!candidates.length)
-            return null;
-        if (candidates.length > 1 && candidates[0].score === candidates[1].score)
-            return null;
-        const candidate = candidates[0].candidate;
-        const values = this.selectedRecordCandidateDisplayValues(candidate);
-        if (values.length !== 1)
-            return null;
-        const label = this.selectedRecordCandidateDisplayLabel(candidate);
-        return {
-            type: 'info',
-            message: `${label} do registro selecionado: ${values[0]}.`,
-            warnings: [
-                'selected-record-candidate-question-answered-locally',
-                'Single selected record supplied canonical filterCandidates; local answer used declared filter catalog metadata instead of materializing a table operation.',
-            ],
-        };
-    }
-    selectedRecordMissingSelectionAnswer(request, contextHints) {
-        if (this.selectedRecordsCountForTurn > 0)
-            return null;
-        const normalizedPrompt = this.normalizeLabel(request.prompt ?? '');
-        if (!this.selectedRecordReferentialRecordsPrompt(normalizedPrompt)
-            && !this.selectedRecordExplicitSelectionPrompt(normalizedPrompt)) {
-            return null;
-        }
-        if (!this.selectedRecordsContextExplicitlyEmpty(contextHints)
-            && !this.selectedRecordMissingSelectionQuestionRequested(normalizedPrompt)) {
-            return null;
-        }
-        return {
-            type: 'info',
-            message: 'Não encontrei registros selecionados na tabela. Selecione um ou mais registros para eu responder usando esse contexto.',
-            warnings: [
-                'selected-record-context-missing',
-                'Prompt referenced selected/current records, but runtime.selectedRecordsContext reported no selected rows.',
-            ],
-        };
-    }
-    selectedRecordReferentialRecordsPrompt(normalizedPrompt) {
-        if (!normalizedPrompt)
-            return false;
-        return [
-            'esses registros',
-            'estes registros',
-            'essas linhas',
-            'estas linhas',
-            'esses aqui',
-            'essas aqui',
-        ].some((token) => this.normalizedTextContainsApproxPhrase(normalizedPrompt, token));
-    }
-    selectedRecordExplicitSelectionPrompt(normalizedPrompt) {
-        if (!normalizedPrompt)
-            return false;
-        return [
-            'selecionado',
-            'selecionados',
-            'selecionada',
-            'selecionadas',
-        ].some((token) => this.normalizedTextContainsApproxPhrase(normalizedPrompt, token));
-    }
-    selectedRecordMissingSelectionQuestionRequested(normalizedPrompt) {
-        return this.selectedRecordInformationalQuestionRequested(normalizedPrompt)
-            && this.selectedRecordPromptGroundsKnownFilterField(normalizedPrompt);
-    }
-    selectedRecordPromptGroundsKnownFilterField(normalizedPrompt) {
-        if (!normalizedPrompt)
-            return false;
-        return this.filterFieldCatalogEntries.some((entry) => [
-            entry.name,
-            entry.label,
-            ...entry.aliases,
-            ...entry.relatedColumnLabels,
-            ...entry.relatedColumnFields,
-        ].some((candidate) => this.promptContainsAnyVariant(normalizedPrompt, candidate)));
-    }
-    selectedRecordsContextExplicitlyEmpty(contextHints) {
-        const authoringContract = this.toRecord(contextHints?.['authoringContract']);
-        const consultativeContext = this.toRecord(authoringContract?.['consultativeContext']);
-        const selectedRecordsContext = this.toRecord(consultativeContext?.['selectedRecordsContext'])
-            ?? this.toRecord(contextHints?.['selectedRecordsContext']);
-        return !!selectedRecordsContext && this.extractSelectedRecordsCount(contextHints) <= 0;
-    }
-    singleTopSelectedRecordQuestionField(candidates) {
-        if (!candidates.length)
-            return null;
-        if (candidates.length > 1 && candidates[0].score === candidates[1].score)
-            return null;
-        return candidates[0].field;
-    }
-    singleTemporalSelectedRecordField(normalizedPrompt, row) {
-        if (!/(^|\s)quando\s/u.test(normalizedPrompt))
-            return null;
-        const temporalFields = Object.keys(row)
-            .filter((field) => this.isDateOnlyValue(row[field]));
-        return temporalFields.length === 1 ? temporalFields[0] : null;
-    }
-    isDateOnlyValue(value) {
-        return typeof value === 'string' && /^\d{4}-\d{2}-\d{2}$/u.test(value.trim());
-    }
-    selectedRecordCommonQuestionAnswer(request, contextHints) {
-        if (this.selectedRecordsCountForTurn < 2)
-            return null;
-        const prompt = request.prompt ?? '';
-        const normalizedPrompt = this.normalizeLabel(prompt);
-        if (!this.selectedRecordCommonQuestionRequested(normalizedPrompt))
-            return null;
-        if (this.selectedRecordCommonQuestionAlsoRequestsFilter(normalizedPrompt))
-            return null;
-        const rows = this.selectedRecordSampleRows(contextHints);
-        if (rows.length < 2)
-            return null;
-        const requestedField = this.selectedRecordRequestedCommonField(normalizedPrompt, rows[0]);
-        if (requestedField) {
-            return this.selectedRecordFieldCommonAnswer(requestedField, rows);
-        }
-        const commonEntries = this.selectedRecordCommonEntries(rows).slice(0, 4);
-        if (!commonEntries.length) {
-            return {
-                type: 'info',
-                message: `Não encontrei um valor comum evidente nos ${rows.length} registros selecionados.`,
-                warnings: [
-                    'selected-record-common-question-answered-locally',
-                    'Selected records supplied sampleRows; local answer summarized common values without materializing table operations.',
-                ],
-            };
-        }
-        const summary = commonEntries
-            .map((entry) => `${entry.label}: ${entry.value}`)
-            .join('; ');
-        return {
-            type: 'info',
-            message: `Em comum nos ${rows.length} registros selecionados: ${summary}.`,
-            warnings: [
-                'selected-record-common-question-answered-locally',
-                'Selected records supplied sampleRows; local answer summarized common values without materializing table operations.',
-            ],
-        };
-    }
-    selectedRecordMultiFieldQuestionAnswer(request, contextHints) {
-        if (this.selectedRecordsCountForTurn < 2)
-            return null;
-        const prompt = request.prompt ?? '';
-        const normalizedPrompt = this.normalizeLabel(prompt);
-        if (!this.selectedRecordMultiFieldQuestionRequested(normalizedPrompt))
-            return null;
-        if (this.selectedRecordCommonQuestionAlsoRequestsFilter(normalizedPrompt))
-            return null;
-        const rows = this.selectedRecordSampleRows(contextHints);
-        if (rows.length < 2)
-            return null;
-        const requestedField = this.selectedRecordRequestedCommonField(normalizedPrompt, rows[0]);
-        if (requestedField) {
-            const numericRangeAnswer = this.selectedRecordNumericMinMaxAnswer(normalizedPrompt, requestedField, rows);
-            if (numericRangeAnswer)
-                return numericRangeAnswer;
-            const candidateAnswer = this.selectedRecordCandidateCommonAnswer(normalizedPrompt, contextHints, rows.length);
-            if (candidateAnswer)
-                return candidateAnswer;
-            return this.selectedRecordFieldCommonAnswer(requestedField, rows);
-        }
-        const candidateAnswer = this.selectedRecordCandidateCommonAnswer(normalizedPrompt, contextHints, rows.length);
-        if (candidateAnswer)
-            return candidateAnswer;
-        return null;
-    }
-    selectedRecordNumericMinMaxAnswer(normalizedPrompt, field, rows) {
-        const asksMinMax = ['menor', 'minimo', 'mínimo', 'maior', 'maximo', 'máximo'].some((token) => (this.normalizedTextContainsApproxToken(normalizedPrompt, token)));
-        if (!asksMinMax)
-            return null;
-        const values = rows
-            .map((row) => row[field])
-            .filter((value) => typeof value === 'number' && Number.isFinite(value));
-        if (!values.length)
-            return null;
-        const min = Math.min(...values);
-        const max = Math.max(...values);
-        const label = this.selectedRecordFieldLabel(field);
-        return {
-            type: 'info',
-            message: `${label} nos ${rows.length} registros selecionados: menor ${this.formatSelectedRecordFilterValue(min)} e maior ${this.formatSelectedRecordFilterValue(max)}.`,
-            warnings: [
-                'selected-record-common-question-answered-locally',
-                'Selected records supplied sampleRows; local answer summarized numeric min/max without materializing table operations.',
-            ],
-        };
-    }
-    selectedRecordCandidateCommonAnswer(normalizedPrompt, contextHints, rowCount) {
-        const candidates = this.selectedRecordFilterCandidates(contextHints)
-            .map((candidate) => ({
-            candidate,
-            score: this.selectedRecordCandidateQuestionScore(normalizedPrompt, candidate),
-        }))
-            .filter((entry) => entry.score > 0)
-            .sort((left, right) => right.score - left.score);
-        if (!candidates.length)
-            return null;
-        if (candidates.length > 1 && candidates[0].score === candidates[1].score)
-            return null;
-        const candidate = candidates[0].candidate;
-        const label = this.stringValue(candidate['label'])
-            || this.humanizeFilterField(this.stringValue(candidate['field']))
-            || 'Campo';
-        const values = this.selectedRecordCandidateDisplayValues(candidate);
-        if (!values.length)
-            return null;
-        const message = values.length === 1
-            ? `${label} em comum nos ${rowCount} registros selecionados: ${values[0]}.`
-            : `${label} nos ${rowCount} registros selecionados: ${values.slice(0, 5).join(', ')}${values.length > 5 ? ', ...' : ''}.`;
-        return {
-            type: 'info',
-            message,
-            warnings: [
-                'selected-record-common-question-answered-locally',
-                'Selected records supplied canonical filterCandidates; local answer summarized candidate values without materializing table operations.',
-            ],
-        };
-    }
-    selectedRecordCandidateQuestionScore(normalizedPrompt, candidate) {
-        let score = 0;
-        const candidateLabel = this.stringValue(candidate['label']);
-        const field = this.stringValue(candidate['field']);
-        const entry = this.filterFieldCatalogEntries.find((candidateEntry) => candidateEntry.name === field);
-        score += candidateLabel && this.promptContainsAnyVariant(normalizedPrompt, candidateLabel) ? 70 : 0;
-        score += field && this.promptContainsAnyVariant(normalizedPrompt, this.humanizeFilterField(field)) ? 50 : 0;
-        for (const value of [
-            ...this.stringArrayValue(candidate['aliases']),
-            ...(entry?.aliases ?? []),
-            ...this.selectedRecordCandidateDisplayValues(candidate),
-            ...this.stringArrayValue(candidate['relatedColumnLabels']),
-            ...(entry?.relatedColumnLabels ?? []),
-            ...this.stringArrayValue(candidate['relatedColumnFields']),
-            ...(entry?.relatedColumnFields ?? []),
-        ]) {
-            score += this.promptContainsAnyVariant(normalizedPrompt, value) ? 80 : 0;
-        }
-        return score;
-    }
-    selectedRecordCandidateDisplayLabel(candidate) {
-        const field = this.stringValue(candidate['field']);
-        const entry = this.filterFieldCatalogEntries.find((candidateEntry) => candidateEntry.name === field);
-        return this.stringArrayValue(candidate['relatedColumnLabels'])[0]
-            || entry?.relatedColumnLabels[0]
-            || this.stringValue(candidate['label'])
-            || entry?.label
-            || this.humanizeFilterField(field)
-            || 'Campo';
-    }
-    selectedRecordCandidateDisplayValues(candidate) {
-        const displayValues = Array.isArray(candidate['displayValues'])
-            ? candidate['displayValues']
-                .map((entry) => this.formatSelectedRecordFilterValue(entry))
-                .filter((entry) => !!entry)
-            : [];
-        if (displayValues.length)
-            return displayValues;
-        const criteria = this.toRecord(candidate['criteria']);
-        const field = this.stringValue(candidate['field']);
-        const value = field ? criteria?.[field] : undefined;
-        if (Array.isArray(value)) {
-            return value
-                .map((entry) => this.formatSelectedRecordFilterValue(entry))
-                .filter((entry, index, values) => !!entry && values.indexOf(entry) === index);
-        }
-        const record = this.toRecord(value);
-        if (record) {
-            const start = record['start'] ?? record['startDate'];
-            const end = record['end'] ?? record['endDate'];
-            if (start !== undefined && end !== undefined) {
-                return [`${this.formatSelectedRecordFilterValue(start)} até ${this.formatSelectedRecordFilterValue(end)}`];
-            }
-        }
-        return value === undefined || value === null
-            ? []
-            : [this.formatSelectedRecordFilterValue(value)];
-    }
-    selectedRecordMultiFieldQuestionRequested(normalizedPrompt) {
-        if (this.selectedRecordInformationalQuestionRequested(normalizedPrompt))
-            return true;
-        return /(^|\s)(eles|elas|esses|essas|estes|estas)\s+(estao|sao|ficam|ficaram|tem|têm)\s/u.test(normalizedPrompt);
-    }
-    selectedRecordCommonQuestionRequested(normalizedPrompt) {
-        if (!normalizedPrompt)
-            return false;
-        return ['comum', 'igual', 'padrao', 'mesma', 'mesmo'].some((token) => (this.normalizedTextContainsApproxToken(normalizedPrompt, token)));
-    }
-    selectedRecordCommonQuestionAlsoRequestsFilter(normalizedPrompt) {
-        if (this.selectedRecordOperationalAudienceRequested(normalizedPrompt))
-            return true;
-        return ['filtro', 'filtrar', 'filtre', 'filtra', 'aplique', 'aplicar', 'buscar', 'busque', 'procure', 'exportar', 'mostra', 'mostre', 'traz', 'traga', 'trazer', 'outro', 'outros', 'pega', 'pegue', 'acha', 'ache', 'encontra', 'encontre'].some((token) => (this.normalizedTextContainsApproxToken(normalizedPrompt, token)));
-    }
-    selectedRecordOperationalAudienceRequested(normalizedPrompt) {
-        if (!normalizedPrompt)
-            return false;
-        // Post-grounding bridge only: this distinguishes "show people/records like these"
-        // from an informational field question. Canonical filterCandidates still decide
-        // which field can be materialized.
-        return /(^|\s)(gente|pessoas|pessoal)\s+com\s+(os\s+|as\s+)?(mesmos|mesmas|mesmo|mesma)\b/u.test(normalizedPrompt);
-    }
-    selectedRecordRequestedCommonField(normalizedPrompt, row) {
-        const candidates = Object.keys(row)
-            .map((field) => ({
-            field,
-            score: this.selectedRecordQuestionFieldScore(normalizedPrompt, field),
-        }))
-            .filter((entry) => entry.score > 0)
-            .sort((left, right) => right.score - left.score);
-        return this.singleTopSelectedRecordQuestionField(candidates)
-            ?? this.selectedRecordRequestedFieldByValue(normalizedPrompt, row);
-    }
-    selectedRecordRequestedFieldByValue(normalizedPrompt, row) {
-        const candidates = Object.keys(row)
-            .filter((field) => {
-            const value = row[field];
-            if (value === undefined || value === null || value === '')
-                return false;
-            const formatted = this.formatSelectedRecordFilterValue(value);
-            return this.filterFieldMentionVariants(formatted)
-                .some((variant) => !!variant && this.normalizedTextContainsApproxPhrase(normalizedPrompt, variant));
-        });
-        return candidates.length === 1 ? candidates[0] : null;
-    }
-    selectedRecordFieldCommonAnswer(field, rows) {
-        const label = this.selectedRecordFieldLabel(field);
-        const values = this.selectedRecordDistinctFormattedValues(rows, field);
-        if (!values.length)
-            return null;
-        const message = values.length === 1
-            ? `${label} em comum nos ${rows.length} registros selecionados: ${values[0]}.`
-            : `${label} não é comum nos ${rows.length} registros selecionados. Valores encontrados: ${values.slice(0, 5).join(', ')}${values.length > 5 ? ', ...' : ''}.`;
-        return {
-            type: 'info',
-            message,
-            warnings: [
-                'selected-record-common-question-answered-locally',
-                'Selected records supplied sampleRows; local answer summarized a requested field without materializing table operations.',
-            ],
-        };
-    }
-    selectedRecordCommonEntries(rows) {
-        return Object.keys(rows[0] ?? {})
-            .map((field) => ({
-            field,
-            values: this.selectedRecordDistinctFormattedValues(rows, field),
-        }))
-            .filter((entry) => entry.values.length === 1)
-            .map((entry) => ({
-            label: this.selectedRecordFieldLabel(entry.field),
-            value: entry.values[0],
-        }));
-    }
-    selectedRecordDistinctFormattedValues(rows, field) {
-        return rows
-            .map((row) => row[field])
-            .filter((value) => value !== undefined && value !== null && value !== '')
-            .map((value) => this.formatSelectedRecordFilterValue(value))
-            .filter((value, index, values) => value && values.indexOf(value) === index);
-    }
-    selectedRecordInformationalQuestionRequested(normalizedPrompt) {
-        if (!normalizedPrompt)
-            return false;
-        return /(^|\s)(qual|quais|quando|quanto|quantos|quantas|quem)\s/u.test(normalizedPrompt);
-    }
-    selectedRecordQuestionFieldScore(normalizedPrompt, field) {
-        const rawCandidates = [
-            field,
-            this.humanizeField(field),
-            this.selectedRecordFieldLabel(field),
-            ...this.filterFieldCatalogEntries
-                .filter((entry) => entry.name === field || entry.relatedColumnFields.includes(field))
-                .flatMap((entry) => [
-                entry.label,
-                ...entry.aliases,
-                ...entry.relatedColumnLabels,
-                ...entry.relatedColumnFields,
-            ]),
-        ];
-        return rawCandidates
-            .flatMap((candidate) => this.filterFieldMentionVariants(candidate ?? ''))
-            .reduce((score, candidate) => (candidate && this.normalizedTextContainsApproxPhrase(normalizedPrompt, candidate)
-            ? Math.max(score, candidate.split(/\s+/u).length > 1 ? 80 : 50)
-            : score), 0);
-    }
-    selectedRecordFieldLabel(field) {
-        const entry = this.filterFieldCatalogEntries
-            .find((candidate) => candidate.name === field || candidate.relatedColumnFields.includes(field));
-        return entry?.relatedColumnLabels[0] || entry?.label || this.humanizeField(field);
-    }
-    selectedRecordSimilarityClarification(request, contextHints) {
-        if (this.selectedRecordsCountForTurn <= 0)
-            return null;
-        const prompt = this.selectedRecordFilterGroundingPrompt(request, contextHints);
-        if (!prompt || !this.selectedRecordSimilarityRequested(prompt))
-            return null;
-        const candidateFields = this.selectedRecordFilterCandidates(contextHints)
-            .map((candidate) => this.stringValue(candidate['field']))
-            .filter((field, index, fields) => !!field && fields.indexOf(field) === index);
-        if (candidateFields.length < 2)
-            return null;
-        const mentionedFields = candidateFields
-            .filter((field) => this.promptMentionsFilterField(prompt, field));
-        if (mentionedFields.length === 1)
-            return null;
-        const options = this.selectedRecordFilterClarificationOptionEntries(candidateFields);
-        if (options.length < 2)
-            return null;
-        return {
-            type: 'clarification',
-            message: [
-                `Encontrei ${this.selectedRecordsCountForTurn} registro${this.selectedRecordsCountForTurn === 1 ? '' : 's'} selecionado${this.selectedRecordsCountForTurn === 1 ? '' : 's'}.`,
-                `Para buscar registros parecidos, escolha qual propriedade deve guiar o filtro: ${this.joinHumanList(options.map((option) => option.label))}.`,
-            ].join(' '),
-            questions: ['Como você quer definir registros parecidos?'],
-            optionPayloads: options.map((entry) => this.selectedRecordFilterClarificationOptionPayload(entry, contextHints)),
-            warnings: [
-                'selected-record-similarity-clarification-materialized',
-                'Selected records supplied multiple canonical filterCandidates; ambiguous similarity was converted into governed clarification without calling the remote LLM.',
-            ],
-        };
-    }
-    selectedRecordMultipleFilterFieldClarification(request, contextHints) {
-        if (this.selectedRecordsCountForTurn <= 0)
-            return null;
-        const prompt = this.selectedRecordFilterGroundingPrompt(request, contextHints);
-        if (!prompt)
-            return null;
-        const candidateFields = this.selectedRecordFilterCandidates(contextHints)
-            .map((candidate) => this.stringValue(candidate['field']))
-            .filter((field, index, fields) => !!field && fields.indexOf(field) === index);
-        const mentionedFields = candidateFields
-            .filter((field) => this.promptMentionsFilterField(prompt, field));
-        if (mentionedFields.length < 2)
-            return null;
-        const options = this.selectedRecordFilterClarificationOptionEntries(mentionedFields);
-        if (options.length < 2)
-            return null;
-        return this.selectedRecordFilterFieldClarificationResponse(options, contextHints, [
-            'selected-record-multiple-filter-fields-clarification',
-            'Selected-record prompt mentioned multiple canonical filter candidates; local response asked for a governed target instead of routing by prose.',
-        ]);
-    }
-    selectedRecordFilterFieldClarificationResponse(options, contextHints, warnings) {
-        return {
-            type: 'clarification',
-            message: [
-                `Encontrei ${this.selectedRecordsCountForTurn} registro${this.selectedRecordsCountForTurn === 1 ? '' : 's'} selecionado${this.selectedRecordsCountForTurn === 1 ? '' : 's'}.`,
-                `Para buscar registros parecidos, escolha qual propriedade deve guiar o filtro: ${this.joinHumanList(options.map((option) => option.label))}.`,
-            ].join(' '),
-            questions: ['Como você quer definir registros parecidos?'],
-            optionPayloads: options.map((entry) => this.selectedRecordFilterClarificationOptionPayload(entry, contextHints)),
-            warnings,
-        };
-    }
-    joinHumanList(values) {
-        const filtered = values
-            .map((value) => value.trim())
-            .filter((value, index, items) => !!value && items.indexOf(value) === index);
-        if (filtered.length <= 1)
-            return filtered[0] ?? '';
-        if (filtered.length === 2)
-            return `${filtered[0]} ou ${filtered[1]}`;
-        return `${filtered.slice(0, -1).join(', ')} ou ${filtered[filtered.length - 1]}`;
-    }
-    selectedRecordFilterApplyResponse(label, criteria, warnings, request, contextHints) {
-        const operations = [
-            {
-                operationId: 'table.filter.apply',
-                input: {
-                    criteria,
-                    source: 'selected-records',
-                },
-            },
-        ];
-        const exportOperation = this.selectedRecordRequestedExportOperation(request, contextHints, 'filtered');
-        if (exportOperation) {
-            operations.push(exportOperation);
-        }
-        return {
-            type: 'patch',
-            tableRuntimeOperations: {
-                kind: 'praxis.table.runtime-operation.batch',
-                operations,
-            },
-            explanation: `Vou aplicar filtros por ${label}.`,
-            warnings,
-        };
-    }
-    selectedRecordExportOnlyRequest(request, contextHints) {
-        if (this.selectedRecordsCountForTurn <= 0)
-            return null;
-        const prompt = this.selectedRecordFilterGroundingPrompt(request, contextHints);
-        if (!this.selectedRecordPureExportRequested(prompt, contextHints))
-            return null;
-        const exportOperation = this.selectedRecordRequestedExportOperation(request, contextHints, 'selected');
-        if (!exportOperation)
-            return null;
-        const format = this.stringValue(this.toRecord(exportOperation['input'])?.['format']).toUpperCase();
-        return {
-            type: 'patch',
-            tableRuntimeOperations: {
-                kind: 'praxis.table.runtime-operation.batch',
-                operations: [exportOperation],
-            },
-            explanation: `Vou exportar as linhas selecionadas${format ? ` em ${format}` : ''}.`,
-            warnings: [
-                'selected-record-export-request-materialized',
-                'Selected records supplied runtime context; prompt requested export with an explicit format and no selected-record filter target.',
-            ],
-        };
-    }
-    selectedRecordRequestedExportOperation(request, contextHints, scope) {
-        if (!request || !this.tableRuntimeOperationAllowed(contextHints, 'table.export.run'))
-            return null;
-        const prompt = this.selectedRecordFilterGroundingPrompt(request, contextHints ?? null);
-        const format = this.resolveRuntimeExportFormat(prompt);
-        if (!format)
-            return null;
-        if (!this.tableRuntimeExportFormatAllowed(contextHints, format))
-            return null;
-        return {
-            operationId: 'table.export.run',
-            input: {
-                format,
-                scope,
-            },
-        };
-    }
-    tableRuntimeOperationAllowed(contextHints, operationId) {
-        const authoringContract = this.toRecord(contextHints?.['authoringContract']);
-        const runtimeOperations = this.toRecord(authoringContract?.['runtimeOperations']);
-        const allowedOperationIds = Array.isArray(runtimeOperations?.['allowedOperationIds'])
-            ? runtimeOperations['allowedOperationIds'].map((value) => this.stringValue(value))
-            : [];
-        if (allowedOperationIds.includes(operationId))
-            return true;
-        const operations = Array.isArray(runtimeOperations?.['operations']) ? runtimeOperations['operations'] : [];
-        return operations
-            .map((operation) => this.toRecord(operation))
-            .some((operation) => this.stringValue(operation?.['operationId']) === operationId);
-    }
-    tableRuntimeExportFormatAllowed(contextHints, format) {
-        const authoringContract = this.toRecord(contextHints?.['authoringContract']);
-        const runtimeOperations = this.toRecord(authoringContract?.['runtimeOperations']);
-        const operations = Array.isArray(runtimeOperations?.['operations']) ? runtimeOperations['operations'] : [];
-        const exportOperation = operations
-            .map((operation) => this.toRecord(operation))
-            .find((operation) => this.stringValue(operation?.['operationId']) === 'table.export.run');
-        const inputSchema = this.toRecord(exportOperation?.['inputSchema']);
-        const formats = Array.isArray(inputSchema?.['format'])
-            ? inputSchema['format'].map((value) => this.stringValue(value).toLowerCase()).filter(Boolean)
-            : [];
-        return !formats.length || formats.includes(format.toLowerCase());
-    }
-    resolveRuntimeExportFormat(prompt) {
-        const normalized = this.normalizeLabel(prompt);
-        if (!normalized)
-            return null;
-        if (normalized.includes('excel') || normalized.includes('xlsx'))
-            return 'excel';
-        if (normalized.includes('csv'))
-            return 'csv';
-        if (normalized.includes('json'))
-            return 'json';
-        if (normalized.includes('pdf'))
-            return 'pdf';
-        if (normalized.includes('print') || normalized.includes('impress') || normalized.includes('imprimir'))
-            return 'print';
-        return null;
-    }
-    selectedRecordPureExportRequested(prompt, contextHints) {
-        const normalized = this.normalizeLabel(prompt);
-        if (!normalized || !this.resolveRuntimeExportFormat(prompt))
-            return false;
-        if (!this.tableRuntimeOperationAllowed(contextHints, 'table.export.run'))
-            return false;
-        const hasExportIntent = [
-            'exportar',
-            'exporte',
-            'exporta',
-            'baixar',
-            'baixe',
-            'baixa',
-            'download',
-            'gerar',
-            'gere',
-            'gera',
-            'mandar',
-            'mande',
-            'manda',
-            'enviar',
-            'envie',
-            'envia',
-        ].some((token) => this.normalizedTextContainsApproxToken(normalized, token));
-        if (!hasExportIntent)
-            return false;
-        const hasFilterIntent = [
-            'filtrar',
-            'filtre',
-            'filtra',
-            'buscar',
-            'busque',
-            'busca',
-            'procurar',
-            'procure',
-            'procura',
-            'mostrar',
-            'mostre',
-            'mostra',
-            'parecido',
-            'parecidos',
-            'semelhante',
-            'semelhantes',
-        ].some((token) => this.normalizedTextContainsApproxToken(normalized, token));
-        if (hasFilterIntent)
-            return false;
-        return !this.selectedRecordFilterCandidates(contextHints)
-            .some((candidate) => this.promptMentionsFilterField(prompt, this.stringValue(candidate['field'])));
-    }
-    selectedRecordFilterGroundingPrompt(request, contextHints) {
-        const pendingClarification = this.toRecord(contextHints?.['pendingClarification'])
-            ?? this.toRecord(request.pendingClarification);
-        return [
-            request.prompt,
-            this.stringValue(pendingClarification?.['sourcePrompt']),
-            this.stringValue(pendingClarification?.['assistantMessage']),
-        ].filter((part) => !!part).join(' ');
-    }
-    selectedRecordFilterApplyRequested(prompt) {
-        const normalized = this.normalizeLabel(prompt);
-        if (!normalized)
-            return false;
-        // This is a post-grounding materialization guard: selectedRecordsContext.filterCandidates
-        // and filterFieldCatalog decide the canonical target; these verbs only distinguish
-        // an operational bridge request from an informational question about the field.
-        return [
-            'aplicar',
-            'aplique',
-            'aplica',
-            'filtrar',
-            'filtre',
-            'filtra',
-            'buscar',
-            'busque',
-            'busca',
-            'procurar',
-            'procure',
-            'procura',
-            'mostrar',
-            'mostre',
-            'mostra',
-            'trazer',
-            'traga',
-            'traz',
-            'pegar',
-            'pegue',
-            'pega',
-            'achar',
-            'ache',
-            'acha',
-            'encontrar',
-            'encontre',
-            'encontra',
-            'parecido',
-            'parecidos',
-            'semelhante',
-            'semelhantes',
-            'outro',
-            'outros',
-        ].some((token) => this.normalizedTextContainsApproxToken(normalized, token))
-            || this.selectedRecordOperationalAudienceRequested(normalized)
-            || this.selectedRecordSameFieldFilterRequested(normalized)
-            || this.selectedRecordPrepositionalFilterRequested(normalized)
-            || this.selectedRecordProximityFilterRequested(normalized);
-    }
-    selectedRecordSameFieldFilterRequested(normalizedPrompt) {
-        if (!normalizedPrompt)
-            return false;
-        if (this.selectedRecordInformationalQuestionRequested(normalizedPrompt))
-            return false;
-        if (!this.selectedRecordReferentialRecordsPrompt(normalizedPrompt)
-            && !this.selectedRecordExplicitSelectionPrompt(normalizedPrompt)) {
-            return false;
-        }
-        const sameValueIntent = ['mesmo', 'mesma', 'mesmos', 'mesmas', 'igual', 'iguais'].some((token) => (this.normalizedTextContainsApproxToken(normalizedPrompt, token)));
-        return sameValueIntent && this.selectedRecordPromptGroundsKnownFilterField(normalizedPrompt);
-    }
-    selectedRecordPrepositionalFilterRequested(normalizedPrompt) {
-        if (/(^|\s)(qual|quais|oque|o que|como|quando|quanto|quantos|quantas)\s/u.test(normalizedPrompt)) {
-            return false;
-        }
-        const hasCriterionPreposition = /(^|\s)(por|pelo|pela|pelos|pelas)\s/u.test(normalizedPrompt);
-        if (!hasCriterionPreposition)
-            return false;
-        return [
-            'faixa',
-            'banda',
-            'periodo',
-            'data',
-            'cargo',
-            'cargos',
-            'departamento',
-            'departamentos',
-            'status',
-        ].some((token) => this.normalizedTextContainsApproxToken(normalizedPrompt, token));
-    }
-    selectedRecordProximityFilterRequested(normalizedPrompt) {
-        if (/(^|\s)(qual|quais|oque|o que|como|quando|quanto|quantos|quantas)\s/u.test(normalizedPrompt)) {
-            return false;
-        }
-        const hasProximityIntent = ['perto', 'proximo', 'proximos', 'parecido', 'parecidos'].some((token) => (this.normalizedTextContainsApproxToken(normalizedPrompt, token)));
-        if (!hasProximityIntent)
-            return false;
-        return [
-            'faixa',
-            'banda',
-            'periodo',
-            'data',
-            'cargo',
-            'cargos',
-            'departamento',
-            'departamentos',
-            'status',
-        ].some((token) => this.normalizedTextContainsApproxToken(normalizedPrompt, token));
-    }
-    selectedRecordSimilarityRequested(prompt) {
-        const normalized = this.normalizeLabel(prompt);
-        if (!normalized)
-            return false;
-        return [
-            'parecido',
-            'parecidos',
-            'semelhante',
-            'semelhantes',
-            'comparavel',
-            'comparaveis',
-        ].some((token) => this.normalizedTextContainsApproxToken(normalized, token));
-    }
     selectedRecordFilterCandidate(contextHints, field) {
         const normalizedField = field.trim();
         if (!normalizedField)
@@ -1681,40 +794,6 @@ class TableAgenticAuthoringTurnFlow {
             ],
         };
     }
-    selectedRecordBackendFailureClarification(request, contextHints, error) {
-        if (this.selectedRecordsCountForTurn <= 0)
-            return null;
-        const candidateFields = this.selectedRecordFilterCandidates(contextHints)
-            .map((candidate) => this.stringValue(candidate['field']))
-            .filter((field, index, fields) => !!field && fields.indexOf(field) === index);
-        if (!candidateFields.length)
-            return null;
-        const options = this.selectedRecordFilterClarificationOptionEntries(candidateFields);
-        if (!options.length)
-            return null;
-        return {
-            type: 'clarification',
-            message: [
-                'Não consegui confirmar automaticamente esse pedido.',
-                `Encontrei ${this.selectedRecordsCountForTurn} registro${this.selectedRecordsCountForTurn === 1 ? '' : 's'} selecionado${this.selectedRecordsCountForTurn === 1 ? '' : 's'} e posso continuar usando uma propriedade derivada dessa seleção.`,
-            ].join(' '),
-            questions: ['Qual propriedade dos registros selecionados deve guiar o filtro?'],
-            optionPayloads: options.map((entry) => this.selectedRecordFilterClarificationOptionPayload(entry, contextHints)),
-            warnings: [
-                'selected-record-backend-failure-clarification-materialized',
-                `Backend failed after selected-record context was prepared; recovered with canonical filterCandidates instead of exposing transport error. ${this.backendErrorSummary(error)}`,
-            ],
-        };
-    }
-    backendErrorSummary(error) {
-        const record = this.toRecord(error);
-        const status = this.stringValue(record?.['status']);
-        const statusText = this.stringValue(record?.['statusText']);
-        if (status || statusText) {
-            return `status=${status || 'unknown'} ${statusText || ''}`.trim();
-        }
-        return this.stringValue(record?.['message']) || 'status=unknown';
-    }
     tableFilterApplyOperations(patch) {
         const envelope = this.toRecord(this.toRecord(patch)?.['tableRuntimeOperations']);
         const operations = Array.isArray(envelope?.['operations']) ? envelope['operations'] : [];

package/fesm2022/{praxisui-table-table-ai.adapter-eGo1zPuy.mjs → praxisui-table-table-ai.adapter-B3KQThqg.mjs}

@@ -1,7 +1,7 @@
 import { firstValueFrom } from 'rxjs';
 import { BaseAiAdapter, createComponentAuthoringContext } from '@praxisui/ai';
 import { deepMerge } from '@praxisui/core';
-import { z as TABLE_COMPONENT_EDIT_PLAN_OPERATION_IDS, k as PRAXIS_TABLE_AUTHORING_MANIFEST, T as TABLE_AI_CAPABILITIES, R as coerceTableComponentEditPlans, W as compileTableComponentEditPlans, G as TASK_PRESETS, $ as getTableComponentEditPlanCapabilities, w as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, u as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, x as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, E as TABLE_COMPONENT_EDIT_PLAN_VERSION, v as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, y as TABLE_COMPONENT_EDIT_PLAN_KIND } from './praxisui-table-praxisui-table-GekTiEGg.mjs';
+import { z as TABLE_COMPONENT_EDIT_PLAN_OPERATION_IDS, k as PRAXIS_TABLE_AUTHORING_MANIFEST, T as TABLE_AI_CAPABILITIES, R as coerceTableComponentEditPlans, W as compileTableComponentEditPlans, G as TASK_PRESETS, $ as getTableComponentEditPlanCapabilities, w as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, u as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, x as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, E as TABLE_COMPONENT_EDIT_PLAN_VERSION, v as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, y as TABLE_COMPONENT_EDIT_PLAN_KIND } from './praxisui-table-praxisui-table-KAnwisrq.mjs';
 
 const TABLE_COMPONENT_CONTEXT_PACK = {
     version: 'v1',
@@ -2023,6 +2023,7 @@ class TableAiAdapter extends BaseAiAdapter {
             'For filterFieldCatalog fields with criterionKind "range" and selectedRecordsContext as the source, derive criteria from the minimum and maximum selected values in relatedColumnFields and emit { start, end }; for criterionKind "date-range", emit { startDate, endDate } from the earliest and latest selected dates.',
             'When the user asks for similar, matching, or comparable records from selected records without naming which property should define similarity, return clarification with options derived from filterFieldCatalog labels instead of info text or a patch.',
             'When recordSurfaces exists and the user asks to open, consult, view, navigate, or inspect information related to the selected record, answer from recordSurfaces before considering selection-derived filters.',
+            'Resolve related-surface requests by the declared recordSurfaces semantic catalog, including label, description, semanticIntent, kind, scope, and tags; do not fall back to selected-record filters when a declared surface semantically satisfies the request.',
             'Use dynamicPage.surface.open only when recordSurfaces declares the requested surface and the user asks to open, show, navigate to, or display that related surface now.',
             'Do not use table.filter.apply for related-surface requests unless the user explicitly asks to find other records.',
             'When runtimeOperations.filterExpression.supported is not true, do not materialize OR, alternative groups, or nested boolean filters; ask which single filter field/value should be applied or explain the limitation.',
@@ -2054,6 +2055,7 @@ class TableAiAdapter extends BaseAiAdapter {
                     'When selectedRecordsContext.selectedCount is greater than zero, do not claim that no record is selected; answer from selectedRecordsContext.sampleRows even when there is only one selected row.',
                     'When selectedRecordsContext.filterCandidates exists, treat those candidates as the canonical selection-derived bridge to advanced filters; prefer their labels and criteria over re-inferring values from prose.',
                     'When recordSurfaces exists and the user asks what can be opened, consulted, navigated, or viewed for selected records, answer or clarify using recordSurfaces before considering selection-derived filters.',
+                    'For record-related surface requests, ground the target in recordSurfaces semantic fields such as label, description, semanticIntent, kind, scope, and tags before considering filters.',
                     'Do not use selection-derived filters for requests about related surfaces, detail panels, timelines, teams, profiles, histories, payroll, or other record-adjacent information unless the user explicitly asks to find other records.',
                     'If the user asks for a related surface that is not declared in recordSurfaces, say that it is not available in the current context and list the declared surfaces in human-facing labels.',
                     'When the user asks how selected records can drive advanced filters or export, bridge the selected records to declared filterFieldCatalog fields and export scopes conceptually; ask for clarification when the shared property or export scope is ambiguous.',
@@ -2201,11 +2203,39 @@ class TableAiAdapter extends BaseAiAdapter {
                 operationId: surface.operationId,
                 ...(surface.description ? { description: surface.description } : {}),
                 ...(surface.statePath ? { statePath: surface.statePath } : {}),
+                ...this.buildRecordSurfaceSemanticDigest(surface),
                 source: surface.source,
                 target: surface.target,
             })),
         };
     }
+    buildRecordSurfaceSemanticDigest(surface) {
+        const resourceSurface = this.toRecord(surface['resourceSurface']);
+        if (!resourceSurface) {
+            return {};
+        }
+        const semanticIntent = this.stringValue(resourceSurface['intent']);
+        const kind = this.stringValue(resourceSurface['kind']);
+        const scope = this.stringValue(resourceSurface['scope']);
+        const title = this.stringValue(resourceSurface['title']);
+        const description = this.stringValue(resourceSurface['description']);
+        const tags = this.compactStringArray(resourceSurface['tags']);
+        const digest = {};
+        if (kind)
+            digest['kind'] = kind;
+        if (scope)
+            digest['scope'] = scope;
+        if (semanticIntent)
+            digest['semanticIntent'] = semanticIntent;
+        if (title && title !== this.stringValue(surface['label']))
+            digest['title'] = title;
+        if (description && description !== this.stringValue(surface['description'])) {
+            digest['semanticDescription'] = description;
+        }
+        if (tags.length)
+            digest['tags'] = tags;
+        return digest;
+    }
     getResourceCapabilityAuthoringContext() {
         const tableWithCapabilities = this.table;
         try {
@@ -2709,6 +2739,14 @@ class TableAiAdapter extends BaseAiAdapter {
     stringValue(value) {
         return typeof value === 'string' ? value.trim() : '';
     }
+    compactStringArray(value) {
+        if (!Array.isArray(value)) {
+            return [];
+        }
+        return value
+            .map((item) => this.stringValue(item))
+            .filter((item, index, items) => !!item && items.indexOf(item) === index);
+    }
     normalizeString(value) {
         if (typeof value !== 'string') {
             return null;

package/fesm2022/praxisui-table.mjs

@@ -1 +1 @@
-export { A as AnalyticsTableConfigAdapterService, a as AnalyticsTableContractService, b as AnalyticsTableStatsApiService, B as BOOLEAN_PRESETS, c as BehaviorConfigEditorComponent, C as CURRENCY_PRESETS, d as ColumnsConfigEditorComponent, D as DATE_PRESETS, e as DataFormatterComponent, f as DataFormattingService, F as FORMULA_TEMPLATES, g as FilterConfigService, h as FilterSettingsComponent, i as FormulaGeneratorService, J as JsonConfigEditorComponent, M as MessagesLocalizationEditorComponent, N as NUMBER_PRESETS, P as PERCENTAGE_PRESETS, j as PRAXIS_FILTER_COMPONENT_METADATA, k as PRAXIS_TABLE_AUTHORING_MANIFEST, l as PRAXIS_TABLE_COMPONENT_METADATA, m as PraxisFilter, n as PraxisFilterWidgetConfigEditor, o as PraxisTable, p as PraxisTableConfigEditor, q as PraxisTableInlineAuthoringEditorComponent, r as PraxisTableToolbar, s as PraxisTableWidgetConfigEditor, S as STRING_PRESETS, T as TABLE_AI_CAPABILITIES, t as TABLE_COMPONENT_AI_CAPABILITIES, u as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, v as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, w as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, x as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, y as TABLE_COMPONENT_EDIT_PLAN_KIND, E as TABLE_COMPONENT_EDIT_PLAN_VERSION, G as TASK_PRESETS, H as TableDefaultsProvider, I as TableRulesEditorComponent, K as ToolbarActionsEditorComponent, V as ValueMappingEditorComponent, L as VisualFormulaBuilderComponent, O as buildTableApplyPlan, Q as coerceTableComponentEditPlan, R as coerceTableComponentEditPlans, U as compileTableComponentEditPlan, W as compileTableComponentEditPlans, X as createTableAuthoringDocument, Y as getActionId, Z as getEnum, _ as getTableCapabilities, $ as getTableComponentEditPlanCapabilities, a0 as isTableRendererSupportedByRichContentP0, a1 as mapTableRendererToRichContentP0, a2 as normalizeTableAuthoringDocument, a3 as parseLegacyOrTableDocument, a4 as providePraxisFilterMetadata, a5 as providePraxisTableMetadata, a6 as serializeTableAuthoringDocument, a7 as toCanonicalTableConfig, a8 as validateTableAuthoringDocument } from './praxisui-table-praxisui-table-GekTiEGg.mjs';
+export { A as AnalyticsTableConfigAdapterService, a as AnalyticsTableContractService, b as AnalyticsTableStatsApiService, B as BOOLEAN_PRESETS, c as BehaviorConfigEditorComponent, C as CURRENCY_PRESETS, d as ColumnsConfigEditorComponent, D as DATE_PRESETS, e as DataFormatterComponent, f as DataFormattingService, F as FORMULA_TEMPLATES, g as FilterConfigService, h as FilterSettingsComponent, i as FormulaGeneratorService, J as JsonConfigEditorComponent, M as MessagesLocalizationEditorComponent, N as NUMBER_PRESETS, P as PERCENTAGE_PRESETS, j as PRAXIS_FILTER_COMPONENT_METADATA, k as PRAXIS_TABLE_AUTHORING_MANIFEST, l as PRAXIS_TABLE_COMPONENT_METADATA, m as PraxisFilter, n as PraxisFilterWidgetConfigEditor, o as PraxisTable, p as PraxisTableConfigEditor, q as PraxisTableInlineAuthoringEditorComponent, r as PraxisTableToolbar, s as PraxisTableWidgetConfigEditor, S as STRING_PRESETS, T as TABLE_AI_CAPABILITIES, t as TABLE_COMPONENT_AI_CAPABILITIES, u as TABLE_COMPONENT_EDIT_PLAN_ALLOWED_CHANGE_KINDS, v as TABLE_COMPONENT_EDIT_PLAN_BATCH_KIND, w as TABLE_COMPONENT_EDIT_PLAN_EXPECTED_PATHS, x as TABLE_COMPONENT_EDIT_PLAN_JSON_SCHEMA, y as TABLE_COMPONENT_EDIT_PLAN_KIND, E as TABLE_COMPONENT_EDIT_PLAN_VERSION, G as TASK_PRESETS, H as TableDefaultsProvider, I as TableRulesEditorComponent, K as ToolbarActionsEditorComponent, V as ValueMappingEditorComponent, L as VisualFormulaBuilderComponent, O as buildTableApplyPlan, Q as coerceTableComponentEditPlan, R as coerceTableComponentEditPlans, U as compileTableComponentEditPlan, W as compileTableComponentEditPlans, X as createTableAuthoringDocument, Y as getActionId, Z as getEnum, _ as getTableCapabilities, $ as getTableComponentEditPlanCapabilities, a0 as isTableRendererSupportedByRichContentP0, a1 as mapTableRendererToRichContentP0, a2 as normalizeTableAuthoringDocument, a3 as parseLegacyOrTableDocument, a4 as providePraxisFilterMetadata, a5 as providePraxisTableMetadata, a6 as serializeTableAuthoringDocument, a7 as toCanonicalTableConfig, a8 as validateTableAuthoringDocument } from './praxisui-table-praxisui-table-KAnwisrq.mjs';

package/package.json

@@ -1,23 +1,23 @@
 {
   "name": "@praxisui/table",
-  "version": "8.0.0-beta.52",
+  "version": "8.0.0-beta.54",
   "description": "Advanced data table for Angular (Praxis UI) with editing, filtering, sorting, virtualization, and settings panel integration.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
-    "@praxisui/ai": "^8.0.0-beta.52",
-    "@praxisui/core": "^8.0.0-beta.52",
-    "@praxisui/dynamic-fields": "^8.0.0-beta.52",
-    "@praxisui/dynamic-form": "^8.0.0-beta.52",
-    "@praxisui/metadata-editor": "^8.0.0-beta.52",
-    "@praxisui/rich-content": "^8.0.0-beta.52",
-    "@praxisui/settings-panel": "^8.0.0-beta.52",
-    "@praxisui/table-rule-builder": "^8.0.0-beta.52",
+    "@praxisui/ai": "^8.0.0-beta.54",
+    "@praxisui/core": "^8.0.0-beta.54",
+    "@praxisui/dynamic-fields": "^8.0.0-beta.54",
+    "@praxisui/dynamic-form": "^8.0.0-beta.54",
+    "@praxisui/metadata-editor": "^8.0.0-beta.54",
+    "@praxisui/rich-content": "^8.0.0-beta.54",
+    "@praxisui/settings-panel": "^8.0.0-beta.54",
+    "@praxisui/table-rule-builder": "^8.0.0-beta.54",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/dialog": "^8.0.0-beta.52",
+    "@praxisui/dialog": "^8.0.0-beta.54",
     "rxjs": "~7.8.0"
   },
   "dependencies": {