@duckcodeailabs/dql-agent 1.7.1 → 1.8.0

package/dist/metadata/grain-gate.js

@@ -171,6 +171,7 @@ function blockGrainProfile(block) {
     const payload = block.payload ?? {};
     const grainStr = typeof payload.grain === 'string' ? payload.grain : '';
     const declaredOutputs = stringArray(payload.declaredOutputs);
+    const declaredDimensions = stringArray(payload.dimensions);
     const entities = stringArray(payload.entities);
     const time = extractTimeGrain([grainStr, ...declaredOutputs]);
     const entityTokens = new Set();
@@ -181,17 +182,34 @@ function blockGrainProfile(block) {
         if (canonical)
             entityTokens.add(canonical);
     }
-    // Declared business entities are also an entity-grain signal.
-    for (const entity of entities) {
-        for (const token of grainTokens(entity)) {
-            const canonical = canonicalEntityToken(token);
-            if (canonical)
-                entityTokens.add(canonical);
+    // A block's `entities` describe every business object touched by its query;
+    // they are NOT necessarily its output grain. A customer ranking can join
+    // orders and products while still returning one row per customer. Only use
+    // dimensions/outputs as fallbacks when no explicit grain was declared.
+    if (entityTokens.size === 0) {
+        for (const dimension of declaredDimensions) {
+            for (const token of grainTokens(dimension)) {
+                const canonical = canonicalEntityToken(token);
+                if (canonical)
+                    entityTokens.add(canonical);
+            }
+        }
+    }
+    if (entityTokens.size === 0) {
+        // Output columns named for an entity are a useful legacy row-grain signal.
+        for (const output of declaredOutputs) {
+            for (const token of grainTokens(output)) {
+                const canonical = canonicalEntityToken(token);
+                if (canonical)
+                    entityTokens.add(canonical);
+            }
         }
     }
-    // Output columns named like `<entity>_id` are a strong row-grain signal.
-    for (const output of declaredOutputs) {
-        for (const token of grainTokens(output)) {
+    // Very old blocks sometimes declared only one business entity and no grain,
+    // dimensions, or outputs. Preserve that conservative compatibility fallback;
+    // never infer a grain from a multi-entity join list.
+    if (entityTokens.size === 0 && entities.length === 1) {
+        for (const token of grainTokens(entities[0])) {
             const canonical = canonicalEntityToken(token);
             if (canonical)
                 entityTokens.add(canonical);

package/dist/metadata/grain-gate.js.map

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

package/dist/metadata/meaning-evidence.d.ts

@@ -0,0 +1,70 @@
+import { type AnalysisQuestionPlan } from './analysis-planner.js';
+import type { MetadataObject } from './catalog.js';
+import type { AgentRetrievalEvidence } from '../meaning-resolution.js';
+export type MetadataEvidenceClass = 'certified' | 'semantic' | 'sql';
+export type MetadataEvidenceTrust = 'certified' | 'semantic' | 'governed_sql' | 'exploratory';
+export interface MetadataMeaningCandidate {
+    objectKey: string;
+    qualifiedId: string;
+    evidenceClass: MetadataEvidenceClass;
+    trustTier: MetadataEvidenceTrust;
+    classRank: number;
+    relevanceScore: number;
+    name: string;
+    aliases: string[];
+    objectType: string;
+    domain?: string;
+    status?: string;
+    definition?: string;
+    formula?: string;
+    semanticModel?: string;
+    relevanceReasons: string[];
+    compatibilityFacts: string[];
+    businessShape: {
+        aggregation?: string;
+        grain?: string;
+        entities: string[];
+        dimensions: string[];
+        timeGrains: string[];
+        parameters: string[];
+        filters: string[];
+        outputs: string[];
+        sourceRelations: string[];
+    };
+    provenance?: string;
+    ambiguityPeerIds: string[];
+}
+export interface MetadataMeaningEvidencePackage {
+    candidates: MetadataMeaningCandidate[];
+    byEvidenceClass: Record<MetadataEvidenceClass, MetadataMeaningCandidate[]>;
+    ambiguousGroups: Array<{
+        candidateIds: string[];
+        reason: string;
+    }>;
+}
+export interface AgentRetrievalEvidenceAdapterOptions {
+    snapshotId?: string;
+    sourceFingerprint?: string;
+    durationMs?: number;
+    truncated?: boolean;
+}
+export interface MeaningEvidenceInputCandidate {
+    row: MetadataObject;
+    rank: number;
+    score: number;
+    reason: string;
+    priorityTier: string;
+}
+/**
+ * Produce compact meaning-rich cards for an AI resolver. Relevance and trust
+ * intentionally remain separate: certification labels an execution lane but
+ * never makes an unrelated candidate more relevant to the question.
+ */
+export declare function buildMeaningEvidencePackage(question: string, questionPlan: AnalysisQuestionPlan, ranked: MeaningEvidenceInputCandidate[]): MetadataMeaningEvidencePackage;
+/**
+ * Adapter boundary used by evidence-first routing. Metadata keeps richer lane
+ * diagnostics, while the router receives the single provider-agnostic contract
+ * shared by CLI, notebook, MCP, and native agent hosts.
+ */
+export declare function toAgentRetrievalEvidence(evidence: MetadataMeaningEvidencePackage, questionPlan: AnalysisQuestionPlan, options?: AgentRetrievalEvidenceAdapterOptions): AgentRetrievalEvidence;
+//# sourceMappingURL=meaning-evidence.d.ts.map

package/dist/metadata/meaning-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meaning-evidence.d.ts","sourceRoot":"","sources":["../../src/metadata/meaning-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAGV,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,UAAU,GAAG,KAAK,CAAC;AACrE,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,UAAU,GAAG,cAAc,GAAG,aAAa,CAAC;AAE9F,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,qBAAqB,CAAC;IACrC,SAAS,EAAE,qBAAqB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,aAAa,EAAE;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,8BAA8B;IAC7C,UAAU,EAAE,wBAAwB,EAAE,CAAC;IACvC,eAAe,EAAE,MAAM,CAAC,qBAAqB,EAAE,wBAAwB,EAAE,CAAC,CAAC;IAC3E,eAAe,EAAE,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,oCAAoC;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,6BAA6B;IAC5C,GAAG,EAAE,cAAc,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAQD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,oBAAoB,EAClC,MAAM,EAAE,6BAA6B,EAAE,GACtC,8BAA8B,CAmEhC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,8BAA8B,EACxC,YAAY,EAAE,oBAAoB,EAClC,OAAO,GAAE,oCAAyC,GACjD,sBAAsB,CA+CxB"}

package/dist/metadata/meaning-evidence.js

@@ -0,0 +1,333 @@
+import { scoreMetadataObjectWithAnalysisPlan, } from './analysis-planner.js';
+const GENERIC_MEANING_TOKENS = new Set([
+    'amount', 'value', 'metric', 'measure', 'total', 'overall', 'monthly', 'daily',
+    'weekly', 'quarterly', 'yearly', 'annual', 'count', 'number', 'rate', 'ratio',
+]);
+const MAX_CANDIDATES_PER_CLASS = 4;
+/**
+ * Produce compact meaning-rich cards for an AI resolver. Relevance and trust
+ * intentionally remain separate: certification labels an execution lane but
+ * never makes an unrelated candidate more relevant to the question.
+ */
+export function buildMeaningEvidencePackage(question, questionPlan, ranked) {
+    const questionText = normalizeText(question);
+    const questionTokens = tokenSet(questionText);
+    const eligible = ranked.flatMap((item) => {
+        const evidenceClass = evidenceClassFor(item.row);
+        if (!evidenceClass)
+            return [];
+        const aliases = aliasesFor(item.row);
+        const lexical = lexicalRelevance(questionText, questionTokens, item.row, aliases);
+        const planned = scoreMetadataObjectWithAnalysisPlan(item.row, questionPlan);
+        const searchSignal = Math.max(0, Math.min(1, item.row.score ?? 0));
+        const relevanceScore = roundScore(lexical.score + Math.min(32, Math.max(0, planned.score)) + searchSignal * 24);
+        if (relevanceScore <= 0)
+            return [];
+        return [{
+                item,
+                evidenceClass,
+                aliases,
+                relevanceScore,
+                relevanceReasons: uniqueStrings([
+                    ...lexical.reasons,
+                    ...planned.reasons,
+                    searchSignal > 0 ? `ranked lexical search match (${searchSignal.toFixed(3)})` : '',
+                ]).slice(0, 6),
+            }];
+    });
+    eligible.sort((left, right) => right.relevanceScore - left.relevanceScore
+        || left.item.rank - right.item.rank
+        || left.item.row.objectKey.localeCompare(right.item.row.objectKey));
+    const selectedByClass = {
+        certified: [], semantic: [], sql: [],
+    };
+    for (const candidate of eligible) {
+        const lane = selectedByClass[candidate.evidenceClass];
+        if (lane.length < MAX_CANDIDATES_PER_CLASS)
+            lane.push(candidate);
+    }
+    const selected = ['certified', 'semantic', 'sql']
+        .flatMap((evidenceClass) => selectedByClass[evidenceClass]);
+    const peerMap = buildAmbiguityPeers(selected.map((candidate) => ({
+        objectKey: candidate.item.row.objectKey,
+        aliases: candidate.aliases,
+    })));
+    const byEvidenceClass = {
+        certified: [], semantic: [], sql: [],
+    };
+    for (const candidate of selected) {
+        const lane = byEvidenceClass[candidate.evidenceClass];
+        lane.push(candidateCard(candidate.item.row, candidate.evidenceClass, lane.length + 1, candidate.relevanceScore, candidate.aliases, candidate.relevanceReasons, peerMap.get(candidate.item.row.objectKey) ?? []));
+    }
+    return {
+        candidates: ['certified', 'semantic', 'sql']
+            .flatMap((evidenceClass) => byEvidenceClass[evidenceClass]),
+        byEvidenceClass,
+        ambiguousGroups: ambiguityGroups(peerMap),
+    };
+}
+/**
+ * Adapter boundary used by evidence-first routing. Metadata keeps richer lane
+ * diagnostics, while the router receives the single provider-agnostic contract
+ * shared by CLI, notebook, MCP, and native agent hosts.
+ */
+export function toAgentRetrievalEvidence(evidence, questionPlan, options = {}) {
+    const maxRelevance = Math.max(1, ...evidence.candidates.map((candidate) => candidate.relevanceScore));
+    const candidates = evidence.candidates.map((candidate) => ({
+        id: candidate.objectKey,
+        kind: agentEvidenceKind(candidate),
+        trustTier: candidate.trustTier,
+        name: candidate.name,
+        aliases: candidate.aliases,
+        definition: candidate.definition,
+        formula: candidate.formula,
+        aggregation: candidate.businessShape.aggregation,
+        domain: candidate.domain,
+        semanticModel: candidate.semanticModel,
+        primaryEntity: candidate.businessShape.entities[0],
+        dimensions: candidate.businessShape.dimensions,
+        timeGrains: candidate.businessShape.timeGrains,
+        requiredParameters: candidate.businessShape.parameters,
+        sourceObjects: candidate.businessShape.sourceRelations,
+        relevanceScore: Number((candidate.relevanceScore / maxRelevance).toFixed(6)),
+        matchReasons: candidate.relevanceReasons,
+        // Fit validation remains host-owned. Metadata only reports facts here and
+        // must not claim executable compatibility prematurely.
+        compatibility: 'unknown',
+        compatibilityFacts: candidate.compatibilityFacts,
+        eligible: true,
+        exactMatch: candidate.relevanceReasons.includes('exact name or alias'),
+    }));
+    return {
+        snapshotId: options.snapshotId,
+        sourceFingerprint: options.sourceFingerprint,
+        candidates,
+        parsedIntent: {
+            measures: questionPlan.requestedShape.measures,
+            dimensions: questionPlan.requestedShape.dimensions,
+            filters: [],
+            ...(questionPlan.timeTerms[0] ? { timeGrain: questionPlan.timeTerms[0] } : {}),
+            ...(questionPlan.requestedShape.rankingDirection
+                ? { order: questionPlan.requestedShape.rankingDirection === 'top' ? 'desc' : 'asc' }
+                : {}),
+            ...(questionPlan.requestedShape.topN ? { limit: questionPlan.requestedShape.topN.n } : {}),
+        },
+        diagnostics: {
+            searchedKinds: [...new Set(candidates.map((candidate) => candidate.kind))],
+            durationMs: options.durationMs,
+            truncated: options.truncated ?? false,
+        },
+    };
+}
+function evidenceClassFor(object) {
+    if (object.objectType === 'dql_block' && object.status === 'certified')
+        return 'certified';
+    if (object.objectType.startsWith('semantic_'))
+        return 'semantic';
+    if (object.objectType === 'dql_entity'
+        || object.objectType === 'relationship'
+        || object.objectType === 'contract'
+        || object.objectType === 'model_area'
+        || object.objectType.startsWith('dbt_')
+        || object.objectType.startsWith('warehouse_')
+        || object.objectType.startsWith('runtime_'))
+        return 'sql';
+    return undefined;
+}
+function trustTierFor(object, evidenceClass) {
+    if (evidenceClass === 'certified')
+        return 'certified';
+    if (evidenceClass === 'semantic')
+        return 'semantic';
+    if (['dql_entity', 'relationship', 'contract'].includes(object.objectType))
+        return 'governed_sql';
+    return 'exploratory';
+}
+function candidateCard(object, evidenceClass, classRank, relevanceScore, aliases, relevanceReasons, ambiguityPeerIds) {
+    const payload = object.payload ?? {};
+    const qualifiedId = firstString(payload.qualifiedId, payload.uniqueId, object.fullName, object.objectKey)
+        ?? object.objectKey;
+    const parameters = arrayNames(payload.parameters ?? payload.parameterPolicy);
+    const outputs = uniqueStrings([
+        ...stringArray(payload.declaredOutputs),
+        ...arrayNames(payload.outputContract),
+        ...arrayNames(payload.outputs),
+    ]);
+    const compatibilityFacts = uniqueStrings([
+        firstString(payload.grain) ? `grain: ${firstString(payload.grain)}` : '',
+        ...stringArray(payload.dimensions).slice(0, 8).map((value) => `dimension: ${value}`),
+        ...parameters.slice(0, 8).map((value) => `parameter: ${value}`),
+        ...stringArray(payload.allowedFilters).slice(0, 8).map((value) => `filter: ${value}`),
+        ...outputs.slice(0, 8).map((value) => `output: ${value}`),
+    ]).slice(0, 16);
+    return {
+        objectKey: object.objectKey,
+        qualifiedId,
+        evidenceClass,
+        trustTier: trustTierFor(object, evidenceClass),
+        classRank,
+        relevanceScore,
+        name: object.name,
+        aliases,
+        objectType: object.objectType,
+        domain: object.domain,
+        status: object.status,
+        definition: truncate(firstString(object.description, payload.description, payload.llmContext), 640),
+        formula: evidenceClass === 'semantic'
+            ? truncate(firstString(payload.formula, payload.expr, payload.sql), 320)
+            : undefined,
+        semanticModel: firstString(payload.semanticModel, payload.cube),
+        relevanceReasons,
+        compatibilityFacts,
+        businessShape: {
+            aggregation: firstString(payload.aggregation, payload.agg, payload.metricType),
+            grain: firstString(payload.grain),
+            entities: stringArray(payload.entities).slice(0, 12),
+            dimensions: stringArray(payload.dimensions).slice(0, 16),
+            timeGrains: uniqueStrings([
+                ...stringArray(payload.timeGrains),
+                ...stringArray(payload.supportedTimeGrains),
+            ]).slice(0, 8),
+            parameters: parameters.slice(0, 12),
+            filters: stringArray(payload.allowedFilters).slice(0, 12),
+            outputs: outputs.slice(0, 16),
+            sourceRelations: uniqueStrings([
+                firstString(payload.relation, payload.table) ?? '',
+                ...stringArray(payload.tableDependencies),
+                ...stringArray(payload.sourceSystems),
+            ]).slice(0, 12),
+        },
+        provenance: firstString(payload.provenance, object.sourceSystem),
+        ambiguityPeerIds,
+    };
+}
+function agentEvidenceKind(candidate) {
+    if (candidate.evidenceClass === 'certified')
+        return 'certified_block';
+    if (candidate.objectType === 'semantic_metric')
+        return 'semantic_metric';
+    if (candidate.evidenceClass === 'semantic')
+        return 'semantic_member';
+    if (['dql_entity', 'relationship', 'contract', 'model_area'].includes(candidate.objectType))
+        return 'dql_modeling';
+    if (candidate.objectType === 'dbt_model')
+        return 'dbt_model';
+    if (candidate.objectType === 'dbt_source')
+        return 'dbt_source';
+    if (candidate.objectType.endsWith('_column'))
+        return 'sql_column';
+    return 'sql_table';
+}
+function aliasesFor(object) {
+    const payload = object.payload ?? {};
+    return uniqueStrings([
+        object.name,
+        object.name.split('.').at(-1) ?? object.name,
+        object.fullName ?? '',
+        firstString(payload.localId) ?? '',
+        firstString(payload.label) ?? '',
+        ...stringArray(payload.aliases),
+        ...stringArray(payload.synonyms),
+        ...stringArray(payload.tags),
+    ]).slice(0, 12);
+}
+function lexicalRelevance(normalizedQuestion, questionTokens, object, aliases) {
+    const normalizedAliases = aliases.map(normalizeText).filter(Boolean);
+    const reasons = [];
+    let score = 0;
+    if (normalizedAliases.some((alias) => alias === normalizedQuestion)) {
+        score += 80;
+        reasons.push('exact name or alias');
+    }
+    else if (normalizedAliases.some((alias) => alias.length >= 3 && normalizedQuestion.includes(alias))) {
+        score += 52;
+        reasons.push('complete name or alias phrase');
+    }
+    const searchableTokens = tokenSet(normalizeText([...aliases, object.description ?? ''].join(' ')));
+    const shared = [...questionTokens].filter((token) => searchableTokens.has(token));
+    if (questionTokens.size > 0 && shared.length > 0) {
+        score += (shared.length / questionTokens.size) * 44;
+        reasons.push(`${shared.length}/${questionTokens.size} question terms matched`);
+    }
+    return { score, reasons };
+}
+function buildAmbiguityPeers(candidates) {
+    const peers = new Map();
+    for (let leftIndex = 0; leftIndex < candidates.length; leftIndex += 1) {
+        const left = candidates[leftIndex];
+        const leftTokens = meaningTokens(left.aliases);
+        for (let rightIndex = leftIndex + 1; rightIndex < candidates.length; rightIndex += 1) {
+            const right = candidates[rightIndex];
+            const rightTokens = meaningTokens(right.aliases);
+            const shared = [...leftTokens].filter((token) => rightTokens.has(token));
+            const overlap = Math.min(leftTokens.size, rightTokens.size) > 0
+                ? shared.length / Math.min(leftTokens.size, rightTokens.size)
+                : 0;
+            const exactAlias = left.aliases.some((leftAlias) => right.aliases.some((rightAlias) => normalizeText(leftAlias) === normalizeText(rightAlias)));
+            if (!exactAlias && (shared.length === 0 || overlap < 0.5))
+                continue;
+            addPeer(peers, left.objectKey, right.objectKey);
+            addPeer(peers, right.objectKey, left.objectKey);
+        }
+    }
+    return new Map([...peers.entries()].map(([key, values]) => [key, [...values].sort()]));
+}
+function ambiguityGroups(peerMap) {
+    const groups = new Map();
+    for (const [candidateId, peers] of peerMap) {
+        const ids = [candidateId, ...peers].sort();
+        groups.set(ids.join('\u0000'), ids);
+    }
+    return [...groups.values()].map((candidateIds) => ({
+        candidateIds,
+        reason: 'Candidates share the same alias or materially overlapping business-meaning terms.',
+    }));
+}
+function meaningTokens(aliases) {
+    return new Set(aliases.flatMap((alias) => [...tokenSet(normalizeText(alias))])
+        .filter((token) => !GENERIC_MEANING_TOKENS.has(token)));
+}
+function addPeer(peers, key, peer) {
+    const values = peers.get(key) ?? new Set();
+    values.add(peer);
+    peers.set(key, values);
+}
+function normalizeText(value) {
+    return value.toLowerCase().replace(/[_./:-]+/g, ' ').replace(/[^a-z0-9 ]+/g, ' ').replace(/\s+/g, ' ').trim();
+}
+function tokenSet(value) {
+    return new Set(value.split(/\s+/).filter((token) => token.length >= 2));
+}
+function stringArray(value) {
+    return Array.isArray(value)
+        ? value.filter((item) => typeof item === 'string' && Boolean(item.trim()))
+        : [];
+}
+function arrayNames(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap((item) => {
+        if (typeof item === 'string' && item.trim())
+            return [item];
+        if (!item || typeof item !== 'object' || Array.isArray(item))
+            return [];
+        const row = item;
+        const name = firstString(row.name, row.id, row.filter);
+        return name ? [name] : [];
+    });
+}
+function firstString(...values) {
+    return values.find((value) => typeof value === 'string' && Boolean(value.trim()));
+}
+function uniqueStrings(values) {
+    return [...new Set(values.map((value) => value.trim()).filter(Boolean))];
+}
+function truncate(value, limit) {
+    if (!value)
+        return undefined;
+    return value.length <= limit ? value : `${value.slice(0, limit - 1)}…`;
+}
+function roundScore(value) {
+    return Number(Math.max(0, value).toFixed(3));
+}
+//# sourceMappingURL=meaning-evidence.js.map

package/dist/metadata/meaning-evidence.js.map

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

package/dist/metadata/metric-match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metric-match.d.ts","sourceRoot":"","sources":["../../src/metadata/metric-match.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"metric-match.d.ts","sourceRoot":"","sources":["../../src/metadata/metric-match.ts"],"names":[],"mappings":"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"}

package/dist/metadata/metric-match.js

@@ -25,7 +25,7 @@
  * still fall through to generated SQL, and questions with no measure at all
  * still refuse honestly.
  */
-import { envEmbeddingProvider, hybridRank } from '../embeddings/provider.js';
+import { defaultEmbeddingProvider, hybridRank } from '../embeddings/provider.js';
 const TOKEN_RE = /[\p{L}\p{N}_]+/gu;
 /** Stopwords that should never count toward a measure/metric match. */
 const STOPWORDS = new Set([
@@ -293,7 +293,10 @@ export async function matchSemanticMetric(question, metrics, options = {}) {
     if (rankedCandidates.length === 0)
         return null;
     const hasLexicalSignal = rankedCandidates.some((entry) => entry.ftsScore > 0);
-    const provider = options.provider ?? envEmbeddingProvider();
+    // Retrieval must not silently send enterprise metric definitions to a remote
+    // provider merely because an ambient API key exists. Hosts may opt into an
+    // explicit provider; the default remains local and deterministic.
+    const provider = options.provider ?? defaultEmbeddingProvider();
     const ranked = await hybridRank(question, rankedCandidates.map((entry) => ({ item: entry, text: entry.text, ftsScore: entry.ftsScore })), {
         alpha: hasLexicalSignal ? options.alpha ?? DEFAULT_METRIC_MATCH_EMBEDDING_ALPHA : 0,
         provider,