@finos/legend-lego 2.0.197 → 2.0.199

package/lib/legend-ai/LegendAIDocEnrichment.js

@@ -0,0 +1,429 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { ClassDocumentationEntry, AssociationDocumentationEntry, PropertyDocumentationEntry, } from '../model-documentation/index.js';
+/**
+ * Builds a lookup map from lowercase property name to its documentation entry.
+ * Used to enrich TDS columns with business descriptions and nullability
+ * from the PURE model's class properties.
+ */
+export function buildPropertyDocIndex(elementDocs) {
+    const index = new Map();
+    for (const entry of elementDocs) {
+        if (entry.elementEntry instanceof ClassDocumentationEntry &&
+            entry.entry instanceof PropertyDocumentationEntry) {
+            if (entry.entry.name) {
+                index.set(entry.entry.name.toLowerCase(), entry.entry);
+            }
+        }
+    }
+    return index;
+}
+/**
+ * Enriches TDS columns with documentation and nullability from model
+ * class property docs. Matches columns to properties case-insensitively.
+ */
+export function enrichColumnsFromElementDocs(columns, propIndex) {
+    for (const col of columns) {
+        const prop = propIndex.get(col.name.toLowerCase());
+        if (prop) {
+            if (!col.documentation && prop.docs.length > 0) {
+                col.documentation = prop.docs.join('; ');
+            }
+            if (col.nullable === undefined && prop.multiplicity) {
+                col.nullable = prop.multiplicity.lowerBound === 0;
+            }
+        }
+    }
+}
+function extractClassNamesFromPattern(pattern) {
+    return pattern
+        .split('/')
+        .filter(Boolean)
+        .flatMap((part) => {
+        const match = /^get(?<name>.+)$/i.exec(part);
+        return match?.groups?.name ? [match.groups.name] : [part];
+    });
+}
+function formatMultiplicity(multiplicity) {
+    if (!multiplicity) {
+        return '*';
+    }
+    const upper = multiplicity.upperBound === undefined ? '*' : `${multiplicity.upperBound}`;
+    return `${multiplicity.lowerBound}..${upper}`;
+}
+function extractUniqueAssociations(elementDocs) {
+    const assocEntries = elementDocs
+        .map((e) => e.elementEntry)
+        .filter((e) => e instanceof AssociationDocumentationEntry);
+    const uniqueAssocs = new Map();
+    for (const a of assocEntries) {
+        if (!uniqueAssocs.has(a.path)) {
+            uniqueAssocs.set(a.path, a);
+        }
+    }
+    return uniqueAssocs;
+}
+function addAdjacencyEdge(adjacency, from, to, multiplicity) {
+    let edges = adjacency.get(from);
+    if (!edges) {
+        edges = [];
+        adjacency.set(from, edges);
+    }
+    edges.push({ target: to, multiplicity });
+}
+function buildAssociationAdjacency(uniqueAssocs) {
+    const adjacency = new Map();
+    for (const assoc of uniqueAssocs.values()) {
+        if (assoc.properties.length === 2) {
+            const [propA, propB] = assoc.properties;
+            if (propA && propB) {
+                const nameA = propA.name.toLowerCase();
+                const nameB = propB.name.toLowerCase();
+                addAdjacencyEdge(adjacency, nameA, nameB, formatMultiplicity(propB.multiplicity));
+                addAdjacencyEdge(adjacency, nameB, nameA, formatMultiplicity(propA.multiplicity));
+            }
+        }
+    }
+    return adjacency;
+}
+function findSharedColumns(svcA, svcB) {
+    const colsA = new Set(svcA.columns.map((c) => c.name.toLowerCase()));
+    return svcB.columns
+        .filter((c) => colsA.has(c.name.toLowerCase()))
+        .map((c) => c.name);
+}
+function findViaConnectionFromClass(clsA, classNamesB, adjacency) {
+    const edgesA = adjacency.get(clsA.toLowerCase());
+    if (!edgesA) {
+        return undefined;
+    }
+    for (const edgeA of edgesA) {
+        const edgesFromVia = adjacency.get(edgeA.target);
+        if (!edgesFromVia) {
+            continue;
+        }
+        for (const clsB of classNamesB) {
+            const edgeB = edgesFromVia.find((e) => e.target === clsB.toLowerCase());
+            if (edgeB) {
+                return {
+                    viaEntity: edgeA.target,
+                    leftMult: edgeA.multiplicity,
+                    rightMult: edgeB.multiplicity,
+                };
+            }
+        }
+    }
+    return undefined;
+}
+function findViaRelationship(svcA, svcB, adjacency) {
+    const classNamesA = extractClassNamesFromPattern(svcA.pattern);
+    const classNamesB = extractClassNamesFromPattern(svcB.pattern);
+    for (const clsA of classNamesA) {
+        const via = findViaConnectionFromClass(clsA, classNamesB, adjacency);
+        if (via) {
+            return {
+                leftService: svcA.title,
+                rightService: svcB.title,
+                joinColumns: findSharedColumns(svcA, svcB),
+                viaEntity: via.viaEntity,
+                leftCardinality: via.leftMult,
+                rightCardinality: via.rightMult,
+            };
+        }
+    }
+    return undefined;
+}
+function findDirectRelationship(svcA, svcB, adjacency) {
+    const classNamesA = extractClassNamesFromPattern(svcA.pattern);
+    const classNamesB = extractClassNamesFromPattern(svcB.pattern);
+    for (const clsA of classNamesA) {
+        const edges = adjacency.get(clsA.toLowerCase());
+        if (!edges) {
+            continue;
+        }
+        for (const clsB of classNamesB) {
+            const edge = edges.find((e) => e.target === clsB.toLowerCase());
+            if (edge) {
+                return {
+                    leftService: svcA.title,
+                    rightService: svcB.title,
+                    joinColumns: findSharedColumns(svcA, svcB),
+                };
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Infers cross-service relationships from association documentation entries.
+ *
+ * Associations in the PURE model define how classes connect (e.g.,
+ * `Trade ──(1:*)──→ Instrument`). By finding associations that link
+ * classes backing different services, we determine:
+ * - Which services share a common parent entity (the via entity)
+ * - The cardinality of each side (1:1, 1:*, etc.)
+ * - Which columns to JOIN on (shared column names)
+ *
+ * Used by both Data Space and Data Product AI integrations.
+ */
+export function inferServiceRelationshipsFromAssociations(services, elementDocs) {
+    const uniqueAssocs = extractUniqueAssociations(elementDocs);
+    const adjacency = buildAssociationAdjacency(uniqueAssocs);
+    const relationships = [];
+    const seen = new Set();
+    for (let i = 0; i < services.length; i++) {
+        for (let j = i + 1; j < services.length; j++) {
+            const svcA = services[i];
+            const svcB = services[j];
+            if (!svcA || !svcB) {
+                continue;
+            }
+            const key = `${svcA.title}|${svcB.title}`;
+            if (seen.has(key)) {
+                continue;
+            }
+            const relationship = findViaRelationship(svcA, svcB, adjacency) ??
+                findDirectRelationship(svcA, svcB, adjacency);
+            if (relationship) {
+                seen.add(key);
+                relationships.push(relationship);
+            }
+        }
+    }
+    return relationships;
+}
+function isLambdaNode(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function collectPropertyPath(node) {
+    if (node._type !== 'property' || !node.property) {
+        return undefined;
+    }
+    const params = node.parameters;
+    if (!params || params.length === 0) {
+        return node.property;
+    }
+    const firstParam = params[0];
+    if (!firstParam) {
+        return node.property;
+    }
+    if (firstParam._type === 'var') {
+        return node.property;
+    }
+    const parentPath = collectPropertyPath(firstParam);
+    if (parentPath) {
+        return `${parentPath}.${node.property}`;
+    }
+    return node.property;
+}
+function extractLiteralValue(node) {
+    if (node._type === 'string' &&
+        (typeof node.value === 'string' || typeof node.value === 'number')) {
+        return node.value;
+    }
+    if (node._type === 'integer' && typeof node.value === 'number') {
+        return node.value;
+    }
+    if (node._type === 'float' && typeof node.value === 'number') {
+        return node.value;
+    }
+    if (node._type === 'boolean' && typeof node.value === 'boolean') {
+        return node.value;
+    }
+    if (node._type === 'strictDate' && typeof node.value === 'string') {
+        return node.value;
+    }
+    return undefined;
+}
+function tryExtractEqualFilter(node) {
+    if (node.parameters?.length !== 2) {
+        return undefined;
+    }
+    const [left, right] = node.parameters;
+    if (!left || !right) {
+        return undefined;
+    }
+    const propPath = collectPropertyPath(left);
+    const literal = extractLiteralValue(right);
+    if (propPath && literal !== undefined) {
+        return { property: propPath, operator: 'equal', value: literal };
+    }
+    return undefined;
+}
+function tryExtractUnaryFilter(node, operator) {
+    if (node.parameters?.length !== 1) {
+        return undefined;
+    }
+    const [arg] = node.parameters;
+    const propPath = arg ? collectPropertyPath(arg) : undefined;
+    if (propPath) {
+        return { property: propPath, operator };
+    }
+    return undefined;
+}
+function extractFiltersFromExpression(node, results) {
+    if (node._type !== 'func' || !node.parameters) {
+        return;
+    }
+    if (node.function === 'equal') {
+        const filter = tryExtractEqualFilter(node);
+        if (filter) {
+            results.push(filter);
+            return;
+        }
+    }
+    if (node.function === 'isEmpty' || node.function === 'isNotEmpty') {
+        const filter = tryExtractUnaryFilter(node, node.function);
+        if (filter) {
+            results.push(filter);
+            return;
+        }
+    }
+    for (const param of node.parameters) {
+        extractFiltersFromExpression(param, results);
+    }
+}
+function extractFiltersFromFilterCall(filterLambda, results) {
+    const body = filterLambda.body;
+    if (!body || !Array.isArray(body)) {
+        return;
+    }
+    for (const expr of body) {
+        extractFiltersFromExpression(expr, results);
+    }
+}
+function processFilterNode(node, results) {
+    const params = node.parameters;
+    if (params?.length === 2) {
+        const filterLambdaParam = params[1];
+        if (filterLambdaParam?._type === 'lambda') {
+            extractFiltersFromFilterCall(filterLambdaParam, results);
+        }
+    }
+    if (params) {
+        walkLambdaBody(params, results);
+    }
+}
+function walkLambdaBody(nodes, results) {
+    for (const rawNode of nodes) {
+        if (!isLambdaNode(rawNode)) {
+            continue;
+        }
+        if (rawNode._type === 'func' && rawNode.function === 'filter') {
+            processFilterNode(rawNode, results);
+        }
+        else if (rawNode._type === 'func' && rawNode.parameters) {
+            walkLambdaBody(rawNode.parameters, results);
+        }
+    }
+}
+function processPostFilterNode(rawNode, results) {
+    if (rawNode.function === 'filter' && rawNode.parameters?.length === 2) {
+        const innerLambda = rawNode.parameters[1];
+        if (innerLambda?._type === 'lambda' && innerLambda.body) {
+            for (const bodyNode of innerLambda.body) {
+                collectIsNotNullChecks(bodyNode, results);
+            }
+        }
+        extractIsNotNullPostFilters(rawNode.parameters, results);
+    }
+    else if (rawNode.parameters) {
+        extractIsNotNullPostFilters(rawNode.parameters, results);
+    }
+}
+function extractIsNotNullPostFilters(nodes, results) {
+    for (const rawNode of nodes) {
+        if (!isLambdaNode(rawNode)) {
+            continue;
+        }
+        if (rawNode._type !== 'func') {
+            continue;
+        }
+        processPostFilterNode(rawNode, results);
+    }
+}
+function collectIsNotNullChecks(node, results) {
+    if (node._type === 'property' && node.property === 'isNotNull') {
+        const colNameNode = node.parameters?.[1];
+        if (colNameNode?._type === 'string' &&
+            typeof colNameNode.value === 'string') {
+            results.push({
+                property: colNameNode.value,
+                operator: 'isNotNull',
+            });
+        }
+        return;
+    }
+    if (node._type === 'func' && node.function === 'and' && node.parameters) {
+        for (const param of node.parameters) {
+            collectIsNotNullChecks(param, results);
+        }
+    }
+}
+/**
+ * Extracts hardcoded pre-filter constraints from a raw lambda body.
+ *
+ * Walks the lambda JSON tree to find:
+ * - `equal` comparisons with literal values (e.g. `fsymId == 'D7HG0X-S'`)
+ * - `isEmpty` checks (e.g. `consEndDate->isEmpty()`)
+ * - `isNotNull` post-projection TDS row checks (e.g. `row.isNotNull('Fe Mean')`)
+ *
+ * The `rawLambdaBody` parameter is `RawLambda.body` — the raw JSON array
+ * from the PURE protocol.
+ */
+export function extractLambdaPreFilters(rawLambdaBody) {
+    if (!rawLambdaBody || !Array.isArray(rawLambdaBody)) {
+        return [];
+    }
+    const results = [];
+    walkLambdaBody(rawLambdaBody, results);
+    extractIsNotNullPostFilters(rawLambdaBody, results);
+    return results;
+}
+/**
+ * Formats pre-filter constraints into a human-readable summary for LLM context.
+ * This generates a concise description of what's hardcoded in the service lambda
+ * so the AI avoids generating contradictory WHERE clauses.
+ */
+export function formatPreFiltersForContext(preFilters) {
+    if (preFilters.length === 0) {
+        return '';
+    }
+    const parts = [];
+    for (const pf of preFilters) {
+        const shortProp = pf.property.includes('.')
+            ? (pf.property.split('.').pop() ?? pf.property)
+            : pf.property;
+        switch (pf.operator) {
+            case 'equal':
+                parts.push(`${shortProp} = '${String(pf.value)}'`);
+                break;
+            case 'isEmpty':
+                parts.push(`${shortProp} IS NULL (always)`);
+                break;
+            case 'isNotEmpty':
+                parts.push(`${shortProp} IS NOT NULL (always)`);
+                break;
+            case 'isNotNull':
+                parts.push(`${shortProp} IS NOT NULL (post-filter)`);
+                break;
+            default:
+                break;
+        }
+    }
+    return `Pre-applied filters: ${parts.join('; ')}`;
+}
+//# sourceMappingURL=LegendAIDocEnrichment.js.map

package/lib/legend-ai/LegendAIDocEnrichment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LegendAIDocEnrichment.js","sourceRoot":"","sources":["../../src/legend-ai/LegendAIDocEnrichment.ts"],"names":[],"mappings":"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"}

package/lib/legend-ai/LegendAITypes.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import type { DataGridColumnDefinition } from '../data-grid/index.js';
-import type { TDSRowDataType, QueryExplicitExecutionContextInfo } from '@finos/legend-graph';
+import { type TDSRowDataType, type QueryExplicitExecutionContextInfo, type AbstractPureGraphManager, type GraphManagerState } from '@finos/legend-graph';
 import type { LegendApplicationPlugin } from '@finos/legend-application';
 import { LegendAI_LegendApplicationPlugin_Extension, type LegendAIOrchestratorDataProductCoordinates } from './LegendAI_LegendApplicationPlugin_Extension.js';
 export declare class TDSColumnSchema {
@@ -22,6 +22,28 @@ export declare class TDSColumnSchema {
     type?: string;
     documentation?: string;
     sampleValues?: string;
+    /** Whether this column is nullable (multiplicity lowerBound === 0). */
+    nullable?: boolean;
+    /** Physical relational type (e.g. 'VARCHAR(100)', 'DECIMAL(18,4)'). */
+    relationalType?: string;
+}
+export declare class TDSParameterSchema {
+    name: string;
+    type?: string;
+    required?: boolean;
+}
+/**
+ * Describes a hardcoded filter constraint baked into a service lambda.
+ * These are equality checks, isEmpty/isNotEmpty checks, or isNotNull
+ * guards that are applied before the TDS result is returned.
+ */
+export interface TDSServicePreFilter {
+    /** Dot-separated property path (e.g. 'FeSecCoveragePublic.SymCoveragePublicEquities.SymSecEntityPublic.fsymId'). */
+    property: string;
+    /** The comparison operator. */
+    operator: 'equal' | 'isEmpty' | 'isNotEmpty' | 'isNotNull';
+    /** The literal value for equality comparisons. */
+    value?: string | number | boolean;
 }
 export declare enum TDSServiceSourceType {
     SERVICE = "service",
@@ -33,6 +55,12 @@ export declare class TDSServiceSchema {
     pattern: string;
     columns: TDSColumnSchema[];
     parameters: string[];
+    /**
+     * Rich parameter metadata including type and multiplicity.
+     * When populated, downstream consumers can use this for richer
+     * prompts and user-facing hints. Falls back to `parameters` names.
+     */
+    parameterSchemas?: TDSParameterSchema[];
     /**
      * Indicates the source of this service schema.
      * - SERVICE: traditional DataSpace service executable (uses `FROM service(...)` SQL syntax)
@@ -41,11 +69,27 @@ export declare class TDSServiceSchema {
     sourceType?: TDSServiceSourceType;
     /** Full data product path (e.g. 'my::package::DataProduct'), used with `p()` syntax for access points. */
     dataProductPath?: string;
+    /**
+     * Set to true when parameter extraction from the service query failed.
+     * Downstream consumers can use this to warn users that required parameters
+     * may not be detected automatically.
+     */
+    parameterExtractionFailed?: boolean;
+    /** Access point group title this AP belongs to. */
+    accessPointGroupTitle?: string;
+    /** Raw DDL script (CREATE VIEW/TABLE) from the access point resource builder. */
+    ddlScript?: string;
+    /**
+     * Hardcoded filter constraints extracted from the service lambda.
+     * These indicate pre-applied conditions the AI must not contradict.
+     */
+    preFilters?: TDSServicePreFilter[];
 }
 export declare class LegendAIConfig {
     enabled: boolean;
     llmServiceUrl: string | undefined;
     llmModelName: string | undefined;
+    llmModelOptions?: string[];
     sqlExecutionUrl: string | undefined;
     orchestratorUrl: string | undefined;
     marketplaceSearchUrl: string | undefined;
@@ -66,6 +110,13 @@ export declare const LAKEHOUSE_ENV_PROD = "prod";
 export declare const COVERAGE_NAME_PROD = "legend-ai";
 /** EngHub coverage app name for non-production (sandbox). */
 export declare const COVERAGE_NAME_SANDBOX = "Legend-AI-Sandbox";
+/**
+ * Delimiter used in TDS column `doc` fields to separate human-readable
+ * documentation from sample values.  Shared across DataProduct and
+ * DataSpace parsers.
+ */
+export declare const TDS_SAMPLE_VALUES_DELIMITER = "-- e.g.";
+export declare function getTodayISO(): string;
 /** Action ID used to offer the Legend AI Orchestrator as a fallback. */
 export declare const LEGEND_AI_ORCHESTRATOR_FALLBACK_ACTION_ID = "orchestrator-fallback";
 export declare function findLegendAIPlugin(plugins: LegendApplicationPlugin[]): LegendAI_LegendApplicationPlugin_Extension | undefined;
@@ -109,6 +160,18 @@ export interface LegendAIFallbackAction {
     label: string;
     actionId: string;
 }
+export declare enum LegendAIMessageFeedbackRating {
+    THUMBS_UP = "thumbs_up",
+    THUMBS_DOWN = "thumbs_down"
+}
+export interface LegendAIMessageFeedback {
+    messageId: string;
+    rating: LegendAIMessageFeedbackRating;
+    question: string;
+    answer?: string;
+    sql?: string;
+    rowCount?: number;
+}
 export declare class LegendAIAssistantMessage {
     id: string;
     role: LegendAIMessageRole.ASSISTANT;
@@ -136,12 +199,19 @@ export declare class LegendAIConversationTurn {
      * to differentiate prior metadata answers from SQL query results.
      */
     intent?: LegendAIQuestionIntent;
+    /** Number of rows returned by the query, when available. */
+    rowCount?: number;
+    /** Brief summary of the result (e.g. column names, first few values). */
+    resultSummary?: string;
 }
 export interface LegendAIChatState {
     questionText: string;
     setQuestionText: (text: string) => void;
     isSending: boolean;
     messages: LegendAIMessage[];
+    selectedModelName: string | undefined;
+    availableModelNames: string[];
+    setSelectedModelName: (modelName: string) => void;
     askQuestion: () => void;
     askQuestionWithIntent: (text: string, intent: LegendAIQuestionIntent) => void;
     runFallbackAction: (messageId: string) => void;
@@ -151,10 +221,21 @@ export interface LegendAIChatState {
     conversationRef: {
         readonly current: HTMLDivElement | null;
     };
+    selectedScopes: LegendAIScopeItem[];
+    toggleScope: (scope: LegendAIScopeItem) => void;
+    removeScope: (scopeId: string) => void;
+    stopGeneration: () => void;
+}
+export interface LegendAIScopeItem {
+    id: string;
+    label: string;
+    description?: string;
 }
 export interface LegendAIServiceSummary {
     title: string;
     description?: string;
+    columnNames?: string[];
+    parameters?: string[];
 }
 export interface LegendAIAccessPointInfo {
     title?: string;
@@ -169,6 +250,30 @@ export declare class LegendAIAccessPointGroupInfo {
     description?: string;
     accessPoints: LegendAIAccessPointInfo[];
 }
+export interface LegendAIAccessPointRelationship {
+    leftAccessPoint: string;
+    rightAccessPoint: string;
+    sharedColumns: string[];
+}
+/**
+ * Describes a relationship between two TDS services in a DataSpace,
+ * derived from model association documentation (elementDocs).
+ * Used to generate accurate JOIN hints in LLM prompts.
+ */
+export interface LegendAIServiceRelationship {
+    /** Title of the first service. */
+    leftService: string;
+    /** Title of the second service. */
+    rightService: string;
+    /** Column names that can serve as JOIN keys between the services. */
+    joinColumns: string[];
+    /** Name of the intermediate entity connecting both services (e.g. "Own2Ownermap"). */
+    viaEntity?: string;
+    /** Cardinality from the connecting entity to the left service (e.g. "1:*"). */
+    leftCardinality?: string;
+    /** Cardinality from the connecting entity to the right service (e.g. "1:*"). */
+    rightCardinality?: string;
+}
 export declare class LegendAIProductMetadata {
     name: string;
     description?: string;
@@ -177,6 +282,12 @@ export declare class LegendAIProductMetadata {
     accessPointGroups?: LegendAIAccessPointGroupInfo[];
     tags?: LegendAITagInfo[];
     supportInfo?: string;
+    /** Inferred cross-access-point relationships based on shared column names. */
+    accessPointRelationships?: LegendAIAccessPointRelationship[];
+    /** Cross-service relationships derived from model associations (elementDocs). */
+    serviceRelationships?: LegendAIServiceRelationship[];
+    /** Per-product domain knowledge for LLM context enrichment. */
+    domainContext?: string;
 }
 export declare enum LegendAIQuestionIntent {
     DATA_QUERY = "data_query",
@@ -207,6 +318,11 @@ export declare function classifyQuestionIntentFast(question: string, hasServices
  * Returns just the intent, discarding ambiguity info.
  */
 export declare function classifyQuestionIntent(question: string, hasServices: boolean): LegendAIQuestionIntent;
+export declare function extractParameterSchemas(query: string, graphManager: AbstractPureGraphManager, graphManagerState: GraphManagerState): Promise<{
+    parameters: string[];
+    parameterSchemas: TDSParameterSchema[];
+    parameterExtractionFailed: boolean;
+}>;
 export interface LegendAIChatProps {
     services: TDSServiceSchema[];
     coordinates: string;
@@ -225,5 +341,15 @@ export interface LegendAIChatProps {
      * returned by the orchestrator. Required for the execute-after-generate flow.
      */
     pureExecutionContext?: QueryExplicitExecutionContextInfo;
+    availableScopes?: LegendAIScopeItem[];
+    /** Called when the user clicks the close button in the chat header. */
+    onClose?: () => void;
+    /** Called when the user clicks the minimize button in the chat header. */
+    onMinimize?: () => void;
+    /**
+     * Optional callback fired when users submit thumbs-up/down feedback
+     * for an assistant response.
+     */
+    onMessageFeedback?: (feedback: LegendAIMessageFeedback) => Promise<void> | void;
 }
 //# sourceMappingURL=LegendAITypes.d.ts.map