@duckcodeailabs/dql-agent 1.6.6 → 1.6.8

package/dist/metadata/sql-context-validation.js

@@ -0,0 +1,340 @@
+import { analyzeSqlReferences } from '@duckcodeailabs/dql-core';
+export function validateSqlAgainstLocalContext(sql, contextPack, options = {}) {
+    const analysis = analyzeSqlReferences(sql);
+    const referencedRelations = analysis.tables;
+    const referencedColumns = analysis.columns.map((column) => ({
+        relation: column.relation,
+        column: column.column,
+    }));
+    const outputAliases = extractSelectAliases(sql);
+    const base = {
+        warnings: [],
+        referencedRelations,
+        referencedColumns,
+    };
+    if (!analysis.parsed) {
+        return {
+            ok: false,
+            code: 'insufficient_context',
+            error: `SQL could not be parsed for context validation: ${analysis.error ?? 'unknown parse error'}`,
+            ...base,
+        };
+    }
+    const unsafeType = analysis.statementTypes.find((type) => type !== 'select');
+    if (unsafeType) {
+        return {
+            ok: false,
+            code: 'unsafe_sql',
+            error: `Tier-2 metadata SQL only supports read-only SELECT or WITH queries; parser found ${unsafeType.toUpperCase()}.`,
+            ...base,
+        };
+    }
+    if (!contextPack)
+        return { ok: true, ...base };
+    if (contextPack.routeDecision?.route === 'clarify') {
+        const missing = contextPack.missingContext.map((item) => item.message).join(' ');
+        return {
+            ok: false,
+            code: 'insufficient_context',
+            error: `Metadata context is insufficient for SQL generation. ${missing || contextPack.routeDecision.reason}`,
+            ...base,
+        };
+    }
+    if (!contextPack.allowedSqlContext) {
+        return {
+            ok: true,
+            ...base,
+            warnings: ['No allowed SQL context was available in the context pack, so relation and column validation were advisory only.'],
+        };
+    }
+    const allowed = buildAllowedRelationLookup(contextPack);
+    if (allowed.size === 0) {
+        return {
+            ok: true,
+            ...base,
+            warnings: ['No allowed SQL relations were available in the context pack, so relation and column validation were advisory only.'],
+        };
+    }
+    const unknownRelations = referencedRelations.filter((relation) => !relationLookupKeys(relation).some((key) => allowed.has(key)));
+    if (unknownRelations.length > 0) {
+        return {
+            ok: false,
+            code: 'unknown_relation',
+            error: `SQL references relation(s) outside the inspected metadata context: ${unknownRelations.join(', ')}. Use inspect_metadata_context and only query allowed relations.`,
+            ...base,
+        };
+    }
+    const warnings = [];
+    for (const relation of referencedRelations) {
+        const allowedRelation = findAllowedRelation(allowed, relation);
+        if (allowedRelation && allowedRelation.columns.length === 0) {
+            warnings.push(`Column validation was advisory for ${relation} because the context pack did not include column metadata.`);
+        }
+    }
+    const unknownColumn = findUnknownColumn(analysis.columns, allowed, analysis.ctes.length > 0, outputAliases);
+    if (unknownColumn) {
+        return {
+            ok: false,
+            code: 'unknown_column',
+            error: unknownColumn.relation
+                ? `SQL references column "${unknownColumn.column}" outside the inspected columns for ${unknownColumn.relation}.`
+                : `SQL references column "${unknownColumn.column}" outside the inspected metadata context.`,
+            warnings,
+            referencedRelations,
+            referencedColumns,
+        };
+    }
+    if (options.intent === 'diagnose_change' && !contextHasTimeLikeColumn(contextPack)) {
+        return {
+            ok: false,
+            code: 'missing_baseline',
+            error: 'Change-diagnosis SQL needs a comparable time or baseline column in the inspected context.',
+            warnings,
+            referencedRelations,
+            referencedColumns,
+        };
+    }
+    const ambiguousEntityFilter = options.intent === 'entity_drilldown'
+        ? findAmbiguousEntityFilter(sql, analysis.aliasToRelation, contextPack, options)
+        : undefined;
+    if (ambiguousEntityFilter) {
+        return {
+            ok: false,
+            code: 'ambiguous_filter',
+            error: ambiguousEntityFilter,
+            warnings,
+            referencedRelations,
+            referencedColumns,
+        };
+    }
+    return {
+        ok: true,
+        warnings,
+        referencedRelations,
+        referencedColumns,
+    };
+}
+function buildAllowedRelationLookup(contextPack) {
+    const allowed = new Map();
+    for (const relation of contextPack.allowedSqlContext.relations) {
+        for (const key of relationLookupKeys(relation.relation))
+            allowed.set(key, relation);
+        for (const key of relationLookupKeys(relation.name))
+            allowed.set(key, relation);
+    }
+    for (const source of contextPack.allowedSqlContext.sourceBlockSql) {
+        const analysis = analyzeSqlReferences(source.sql);
+        for (const relation of analysis.tables) {
+            const entry = {
+                relation,
+                name: relation.split('.').at(-1) ?? relation,
+                objectKey: source.objectKey,
+                source: 'certified source block SQL',
+                columns: [],
+            };
+            for (const key of relationLookupKeys(relation))
+                allowed.set(key, entry);
+        }
+    }
+    return allowed;
+}
+function findAllowedRelation(allowed, relation) {
+    for (const key of relationLookupKeys(relation)) {
+        const match = allowed.get(key);
+        if (match)
+            return match;
+    }
+    return undefined;
+}
+function findUnknownColumn(columns, allowed, hasCtes, outputAliases) {
+    for (const column of columns) {
+        if (column.column === '*')
+            continue;
+        if (column.unqualified && outputAliases.has(normalizeColumnName(column.column)))
+            continue;
+        if (column.relation) {
+            const relation = findAllowedRelation(allowed, column.relation);
+            if (!relation || relation.columns.length === 0)
+                continue;
+            if (!relation.columns.some((allowedColumn) => namesEqual(allowedColumn.name, column.column))) {
+                return { column: column.column, relation: relation.relation };
+            }
+            continue;
+        }
+        if (hasCtes)
+            continue;
+        const relationsWithColumns = Array.from(new Set(Array.from(allowed.values())))
+            .filter((relation) => relation.columns.length > 0);
+        if (relationsWithColumns.length === 0)
+            continue;
+        if (!relationsWithColumns.some((relation) => relation.columns.some((allowedColumn) => namesEqual(allowedColumn.name, column.column)))) {
+            return { column: column.column };
+        }
+    }
+    return undefined;
+}
+function extractSelectAliases(sql) {
+    const aliases = new Set();
+    for (const section of sql.matchAll(/\bSELECT\b([\s\S]*?)\bFROM\b/gi)) {
+        for (const alias of (section[1] ?? '').matchAll(/\bAS\s+(["`]?\w+["`]?)/gi)) {
+            const name = cleanIdentifier(alias[1] ?? '');
+            if (name)
+                aliases.add(normalizeColumnName(name));
+        }
+    }
+    return aliases;
+}
+function relationLookupKeys(relation) {
+    const normalized = normalizeRelation(relation).toLowerCase();
+    const parts = normalized.split('.').filter(Boolean);
+    const keys = new Set();
+    if (normalized)
+        keys.add(normalized);
+    if (parts.length >= 2)
+        keys.add(parts.slice(-2).join('.'));
+    if (parts.length >= 1)
+        keys.add(parts[parts.length - 1]);
+    return Array.from(keys);
+}
+function normalizeRelation(value) {
+    return value
+        .replace(/["`]/g, '')
+        .replace(/\s*\.\s*/g, '.')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+function namesEqual(a, b) {
+    return a.replace(/["`]/g, '').toLowerCase() === b.replace(/["`]/g, '').toLowerCase();
+}
+function normalizeColumnName(value) {
+    return value.replace(/["`]/g, '').toLowerCase();
+}
+function contextHasTimeLikeColumn(contextPack) {
+    return contextPack.allowedSqlContext.relations.some((relation) => relation.columns.some((column) => isTimeLikeColumn(column.name)));
+}
+function isTimeLikeColumn(name) {
+    return /\b(date|time|day|week|month|quarter|year|season|period|created_at|updated_at)\b/i.test(name);
+}
+function findAmbiguousEntityFilter(sql, aliasToRelation, contextPack, options) {
+    const question = options.question ?? '';
+    const explicitValues = uniqueStrings([
+        ...(options.filterValues ?? []),
+        ...Array.from(question.matchAll(/"([^"]+)"|'([^']+)'/g))
+            .map((match) => match[1] ?? match[2])
+            .filter((value) => typeof value === 'string' && value.length > 0),
+        ...Array.from(question.matchAll(/\b[\w.%+-]+@[\w.-]+\.[A-Za-z]{2,}\b/g)).map((match) => match[0]),
+    ]
+        .map((value) => value.trim())
+        .filter((value) => value.length > 0 && !isTemporalEntityFilter(value)));
+    if (explicitValues.length === 0)
+        return undefined;
+    const sampleMatches = sampleValueColumnMatches(contextPack);
+    if (sampleMatches.size === 0)
+        return undefined;
+    const predicates = extractEntityValuePredicates(sql, aliasToRelation);
+    for (const value of explicitValues) {
+        const valueKey = normalizeSampleValue(value);
+        const matchedColumns = sampleMatches.get(valueKey) ?? [];
+        if (matchedColumns.length === 0) {
+            return `Entity drilldown SQL needs an inspected value match for "${value}" before it can apply that filter.`;
+        }
+        const valuePredicates = predicates.filter((predicate) => normalizeSampleValue(predicate.value) === valueKey);
+        if (valuePredicates.length === 0) {
+            return `Entity drilldown SQL does not apply the requested inspected entity filter "${value}".`;
+        }
+        if (!valuePredicates.some((predicate) => predicateMatchesSampleColumn(predicate, matchedColumns))) {
+            const expected = matchedColumns
+                .map((match) => `${match.relation}.${match.column}`)
+                .sort()
+                .join(', ');
+            const actual = valuePredicates
+                .map((predicate) => `${predicate.relation ? `${predicate.relation}.` : ''}${predicate.column}`)
+                .sort()
+                .join(', ');
+            return `Entity drilldown SQL filters "${value}" on ${actual}, but inspected metadata matched that value on ${expected}.`;
+        }
+    }
+    return undefined;
+}
+function sampleValueColumnMatches(contextPack) {
+    const matches = new Map();
+    for (const relation of contextPack.allowedSqlContext.relations) {
+        for (const column of relation.columns) {
+            for (const sampleValue of column.sampleValues ?? []) {
+                const key = normalizeSampleValue(sampleValue);
+                if (!key)
+                    continue;
+                const existing = matches.get(key) ?? [];
+                existing.push({ relation: relation.relation, column: column.name });
+                matches.set(key, existing);
+            }
+        }
+    }
+    return matches;
+}
+function extractEntityValuePredicates(sql, aliasToRelation) {
+    const predicates = [];
+    const equalityPattern = /(?:(["`]?[\w]+["`]?)\s*\.\s*)?(["`]?[\w]+["`]?)\s*=\s*('(?:''|[^'])*'|"(?:\\"|[^"])*")/gi;
+    for (const match of sql.matchAll(equalityPattern)) {
+        predicates.push({
+            relation: resolvePredicateRelation(match[1], aliasToRelation),
+            column: cleanIdentifier(match[2] ?? ''),
+            value: unquoteSqlLiteral(match[3] ?? ''),
+        });
+    }
+    const inPattern = /(?:(["`]?[\w]+["`]?)\s*\.\s*)?(["`]?[\w]+["`]?)\s+IN\s*\(([^)]*)\)/gi;
+    for (const match of sql.matchAll(inPattern)) {
+        const relation = resolvePredicateRelation(match[1], aliasToRelation);
+        const column = cleanIdentifier(match[2] ?? '');
+        for (const value of stringLiteralsInList(match[3] ?? '')) {
+            predicates.push({ relation, column, value });
+        }
+    }
+    return predicates.filter((predicate) => predicate.column.length > 0 && predicate.value.length > 0);
+}
+function predicateMatchesSampleColumn(predicate, matches) {
+    return matches.some((match) => {
+        if (!namesEqual(predicate.column, match.column))
+            return false;
+        if (!predicate.relation)
+            return true;
+        return relationLookupKeys(predicate.relation).some((key) => relationLookupKeys(match.relation).includes(key));
+    });
+}
+function resolvePredicateRelation(qualifier, aliasToRelation) {
+    if (!qualifier)
+        return undefined;
+    const cleaned = cleanIdentifier(qualifier);
+    if (!cleaned)
+        return undefined;
+    const direct = aliasToRelation[cleaned] ?? aliasToRelation[cleaned.toLowerCase()];
+    if (direct)
+        return direct;
+    return cleaned;
+}
+function stringLiteralsInList(raw) {
+    return Array.from(raw.matchAll(/'(?:''|[^'])*'|"(?:\\"|[^"])*"/g)).map((match) => unquoteSqlLiteral(match[0]));
+}
+function unquoteSqlLiteral(raw) {
+    const trimmed = raw.trim();
+    if ((trimmed.startsWith("'") && trimmed.endsWith("'")) ||
+        (trimmed.startsWith('"') && trimmed.endsWith('"'))) {
+        return trimmed.slice(1, -1).replace(/''/g, "'").replace(/\\"/g, '"');
+    }
+    return trimmed;
+}
+function cleanIdentifier(value) {
+    return value.replace(/^["`]|["`]$/g, '').trim();
+}
+function normalizeSampleValue(value) {
+    return value.trim().toLowerCase();
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values));
+}
+function isTemporalEntityFilter(value) {
+    return /\b(last|this|next|previous|prior|current)\s+(day|week|month|quarter|year)\b/i.test(value)
+        || /\b(today|yesterday|tomorrow|ytd|mtd|qtd|wtd)\b/i.test(value)
+        || /^\d{4}-\d{2}-\d{2}/.test(value);
+}
+//# sourceMappingURL=sql-context-validation.js.map

package/dist/metadata/sql-context-validation.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckcodeailabs/dql-agent",
-  "version": "1.6.6",
+  "version": "1.6.8",
   "description": "DQL agent: knowledge graph, Skills, block-first answer loop, and pluggable LLM providers (Claude / OpenAI / Gemini / Ollama)",
   "license": "Apache-2.0",
   "type": "module",
@@ -24,9 +24,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@duckcodeailabs/dql-core": "^1.6.6",
-    "@duckcodeailabs/dql-governance": "^1.6.6",
-    "@duckcodeailabs/dql-project": "^1.6.6",
+    "@duckcodeailabs/dql-core": "^1.6.8",
+    "@duckcodeailabs/dql-governance": "^1.6.8",
+    "@duckcodeailabs/dql-project": "^1.6.8",
     "better-sqlite3": "^11.7.0"
   },
   "devDependencies": {