@duckcodeailabs/dql-mcp 1.6.31 → 1.6.33

package/dist/tool-schema.js.map

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

package/dist/tools/certify.d.ts

@@ -1,8 +1,5 @@
-import { z } from 'zod';
 import type { DQLContext } from '../context.js';
-export declare const certifyInput: {
-    name: z.ZodString;
-};
+export declare const certifyInput: Record<string, import("zod").ZodTypeAny>;
 export declare function certify(ctx: DQLContext, args: {
     name: string;
 }): {

package/dist/tools/certify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"certify.d.ts","sourceRoot":"","sources":["../../src/tools/certify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,eAAO,MAAM,YAAY;;CAExB,CAAC;AAEF,wBAAgB,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;EAe9D"}
+{"version":3,"file":"certify.d.ts","sourceRoot":"","sources":["../../src/tools/certify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,eAAO,MAAM,YAAY,0CAAkC,CAAC;AAE5D,wBAAgB,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;EAe9D"}

package/dist/tools/certify.js

@@ -1,9 +1,7 @@
-import { z } from 'zod';
 import { Certifier } from '@duckcodeailabs/dql-governance';
 import { manifestBlockToRecord } from './util.js';
-export const certifyInput = {
-    name: z.string().describe('Block name to evaluate.'),
-};
+import { zodInputShapeForTool } from '../tool-schema.js';
+export const certifyInput = zodInputShapeForTool('certify');
 export function certify(ctx, args) {
     const manifestBlock = ctx.manifest.blocks[args.name];
     if (!manifestBlock)

package/dist/tools/certify.js.map

@@ -1 +1 @@
-{"version":3,"file":"certify.js","sourceRoot":"","sources":["../../src/tools/certify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CACrD,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,GAAe,EAAE,IAAsB;IAC7D,MAAM,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,aAAa;QAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAEvE,MAAM,MAAM,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhD,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,IAAI;QAChB,IAAI,EAAE,aAAa,CAAC,QAAQ;QAC5B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE;KAC1C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"certify.js","sourceRoot":"","sources":["../../src/tools/certify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;AAE5D,MAAM,UAAU,OAAO,CAAC,GAAe,EAAE,IAAsB;IAC7D,MAAM,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,aAAa;QAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAEvE,MAAM,MAAM,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhD,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,IAAI;QAChB,IAAI,EAAE,aAAa,CAAC,QAAQ;QAC5B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE;KAC1C,CAAC;AACJ,CAAC"}

package/dist/tools/expand-context.d.ts

@@ -0,0 +1,62 @@
+import type { DQLContext } from '../context.js';
+export declare const expandContextInput: Record<string, import("zod").ZodTypeAny>;
+export declare function expandContext(ctx: DQLContext, args: {
+    contextPackId: string;
+    relations: string[];
+    question?: string;
+}): Promise<{
+    ok: boolean;
+    error: string;
+    contextPackId?: undefined;
+    missed?: undefined;
+    previousContextPackId?: undefined;
+    regroundAttemptsUsed?: undefined;
+    repairBudget?: undefined;
+    addedRelations?: undefined;
+    notes?: undefined;
+    allowedSqlContext?: undefined;
+    nextTool?: undefined;
+} | {
+    ok: boolean;
+    contextPackId: string;
+    missed: string[];
+    error: string;
+    previousContextPackId?: undefined;
+    regroundAttemptsUsed?: undefined;
+    repairBudget?: undefined;
+    addedRelations?: undefined;
+    notes?: undefined;
+    allowedSqlContext?: undefined;
+    nextTool?: undefined;
+} | {
+    ok: boolean;
+    previousContextPackId: string;
+    contextPackId: string;
+    regroundAttemptsUsed: number;
+    repairBudget: import("@duckcodeailabs/dql-agent").McpTier2RepairBudget;
+    addedRelations: {
+        relation: string;
+        name: string;
+        source: string;
+        columnCompleteness: "complete" | "partial" | undefined;
+        columns: {
+            name: string;
+            type: string | undefined;
+        }[];
+    }[];
+    missed: string[];
+    notes: string[];
+    allowedSqlContext: {
+        relationCount: number;
+        relations: {
+            relation: string;
+            name: string;
+            source: string;
+            columnCompleteness: "complete" | "partial" | undefined;
+            columns: string[];
+        }[];
+    };
+    nextTool: string;
+    error?: undefined;
+}>;
+//# sourceMappingURL=expand-context.d.ts.map

package/dist/tools/expand-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-context.d.ts","sourceRoot":"","sources":["../../src/tools/expand-context.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,eAAO,MAAM,kBAAkB,0CAAyC,CAAC;AAEzE,wBAAsB,aAAa,CACjC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IACJ,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FF"}

package/dist/tools/expand-context.js

@@ -0,0 +1,130 @@
+import { applyGroundingExpansion, ensureMetadataCatalogFresh, expandGroundingFromCatalog, mcpTier2RegroundRepairBudget, openMetadataCatalog, } from '@duckcodeailabs/dql-agent';
+import { zodInputShapeForTool } from '../tool-schema.js';
+export const expandContextInput = zodInputShapeForTool('expand_context');
+export async function expandContext(ctx, args) {
+    await ensureMetadataCatalogFresh(ctx.projectRoot);
+    const catalog = openMetadataCatalog(ctx.projectRoot);
+    try {
+        const existing = catalog.getContextPack(args.contextPackId);
+        if (!existing) {
+            return {
+                ok: false,
+                error: `No context pack found for id "${args.contextPackId}". Re-run ask_dql or inspect_metadata_context.`,
+            };
+        }
+        const question = args.question?.trim() || existing.question;
+        const expansions = [];
+        const missed = [];
+        for (const relation of uniqueStrings(args.relations.map((value) => value.trim()).filter(Boolean))) {
+            const expansion = expandGroundingFromCatalog(catalog, {
+                question,
+                sql: relation,
+                code: 'unknown_relation',
+                offending: { relation },
+                contextPack: existing,
+            });
+            if (expansion && expansion.relations.length > 0)
+                expansions.push(expansion);
+            else
+                missed.push(relation);
+        }
+        const combined = combineExpansions(expansions);
+        const merged = applyGroundingExpansion(existing, [], combined);
+        if (!combined || !merged.contextPack) {
+            return {
+                ok: false,
+                contextPackId: existing.id,
+                missed,
+                error: missed.length > 0
+                    ? `No requested relation(s) were found in the metadata catalog or runtime schema: ${missed.join(', ')}.`
+                    : 'No additional context was found for the requested relation(s).',
+            };
+        }
+        const regroundAttempts = (existing.retrievalDiagnostics?.regroundAttempts ?? 0) + 1;
+        const addedRelationKeys = new Set(combined.relations.map((relation) => relation.relation.toLowerCase()));
+        const payload = contextPackWithoutId({
+            ...merged.contextPack,
+            question,
+            retrievalDiagnostics: {
+                ...merged.contextPack.retrievalDiagnostics,
+                strategy: 'expanded_context',
+                regroundAttempts,
+                selectedRelations: summarizeSelectedRelations(merged.contextPack, existing, addedRelationKeys),
+            },
+        });
+        const expandedId = catalog.insertContextPack(payload);
+        const expandedPack = { ...payload, id: expandedId };
+        const addedRelations = combined.relations.map((relation) => ({
+            relation: relation.relation,
+            name: relation.name,
+            source: relation.source,
+            columnCompleteness: relation.columnCompleteness,
+            columns: relation.columns.slice(0, 32).map((column) => ({
+                name: column.name,
+                type: column.type,
+            })),
+        }));
+        return {
+            ok: true,
+            previousContextPackId: existing.id,
+            contextPackId: expandedId,
+            regroundAttemptsUsed: regroundAttempts,
+            repairBudget: mcpTier2RegroundRepairBudget(regroundAttempts),
+            addedRelations,
+            missed,
+            notes: combined.notes,
+            allowedSqlContext: {
+                relationCount: expandedPack.allowedSqlContext.relations.length,
+                relations: expandedPack.allowedSqlContext.relations.slice(0, 24).map((relation) => ({
+                    relation: relation.relation,
+                    name: relation.name,
+                    source: relation.source,
+                    columnCompleteness: relation.columnCompleteness,
+                    columns: relation.columns.slice(0, 32).map((column) => column.name),
+                })),
+            },
+            nextTool: 'query_via_metadata',
+        };
+    }
+    finally {
+        catalog.close();
+    }
+}
+function combineExpansions(expansions) {
+    if (expansions.length === 0)
+        return undefined;
+    return {
+        relations: expansions.flatMap((expansion) => expansion.relations),
+        schemaContext: expansions.flatMap((expansion) => expansion.schemaContext ?? []),
+        notes: uniqueStrings(expansions.flatMap((expansion) => expansion.notes)).slice(0, 16),
+    };
+}
+function contextPackWithoutId(pack) {
+    const { id: _id, ...payload } = pack;
+    return payload;
+}
+function summarizeSelectedRelations(pack, existing, addedRelationKeys) {
+    // Preserve the real retrieval scores/ranks from the prior pack where we have
+    // them; only synthesize a diagnostics row for relations newly added by this
+    // expansion, and mark them explicitly (score 0, "not ranked") rather than
+    // fabricating a rank-derived score.
+    const priorByRelation = new Map((existing.retrievalDiagnostics?.selectedRelations ?? []).map((entry) => [entry.relation.toLowerCase(), entry]));
+    return pack.allowedSqlContext.relations.slice(0, 24).map((relation, index) => {
+        const prior = priorByRelation.get(relation.relation.toLowerCase());
+        if (prior && !addedRelationKeys.has(relation.relation.toLowerCase()))
+            return prior;
+        return {
+            relation: relation.relation,
+            name: relation.name,
+            source: relation.source,
+            score: 0,
+            reason: 'added by expand_context (not ranked)',
+            columns: relation.columns.slice(0, 24).map((column) => column.name),
+            rank: index + 1,
+        };
+    });
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values.filter((value) => value.trim().length > 0)));
+}
+//# sourceMappingURL=expand-context.js.map

package/dist/tools/expand-context.js.map

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

package/dist/tools/get-block.d.ts

@@ -1,9 +1,5 @@
-import { z } from 'zod';
 import type { DQLContext } from '../context.js';
-export declare const getBlockInput: {
-    name: z.ZodString;
-    includeSource: z.ZodOptional<z.ZodBoolean>;
-};
+export declare const getBlockInput: Record<string, import("zod").ZodTypeAny>;
 export declare function getBlock(ctx: DQLContext, args: {
     name: string;
     includeSource?: boolean;

package/dist/tools/get-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-block.d.ts","sourceRoot":"","sources":["../../src/tools/get-block.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,eAAO,MAAM,aAAa;;;CAMzB,CAAC;AAEF,wBAAgB,QAAQ,CACtB,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsChD"}
+{"version":3,"file":"get-block.d.ts","sourceRoot":"","sources":["../../src/tools/get-block.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,eAAO,MAAM,aAAa,0CAAoC,CAAC;AAE/D,wBAAgB,QAAQ,CACtB,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsChD"}

package/dist/tools/get-block.js

@@ -1,13 +1,7 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { z } from 'zod';
-export const getBlockInput = {
-    name: z.string().describe('Block name (as shown in search_blocks).'),
-    includeSource: z
-        .boolean()
-        .optional()
-        .describe('When true, include the full .dql source text. Default true.'),
-};
+import { zodInputShapeForTool } from '../tool-schema.js';
+export const getBlockInput = zodInputShapeForTool('get_block');
 export function getBlock(ctx, args) {
     const block = ctx.manifest.blocks[args.name];
     if (!block) {

package/dist/tools/get-block.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-block.js","sourceRoot":"","sources":["../../src/tools/get-block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IACpE,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,6DAA6D,CAAC;CAC3E,CAAC;AAEF,MAAM,UAAU,QAAQ,CACtB,GAAe,EACf,IAA+C;IAE/C,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,KAAK,EAAE,mBAAmB,IAAI,CAAC,IAAI,6BAA6B,EAAE,CAAC;IAC9E,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,MAAM,GACV,IAAI,CAAC,aAAa,KAAK,KAAK,IAAI,UAAU,CAAC,OAAO,CAAC;QACjD,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;QAChC,CAAC,CAAC,IAAI,CAAC;IAEX,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,QAAQ;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;QAC5B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,OAAO;QAC/B,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;QACtC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;QAClC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;QAClC,YAAY,EAAE;YACZ,MAAM,EAAE,KAAK,CAAC,iBAAiB;YAC/B,IAAI,EAAE,KAAK,CAAC,eAAe;YAC3B,OAAO,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;YAC/B,UAAU,EAAE,KAAK,CAAC,aAAa,IAAI,EAAE;SACtC;QACD,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,qEAAqE;QACrE,+DAA+D;QAC/D,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;QACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;QAClC,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,MAAM;KACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-block.js","sourceRoot":"","sources":["../../src/tools/get-block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;AAE/D,MAAM,UAAU,QAAQ,CACtB,GAAe,EACf,IAA+C;IAE/C,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,KAAK,EAAE,mBAAmB,IAAI,CAAC,IAAI,6BAA6B,EAAE,CAAC;IAC9E,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,MAAM,GACV,IAAI,CAAC,aAAa,KAAK,KAAK,IAAI,UAAU,CAAC,OAAO,CAAC;QACjD,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;QAChC,CAAC,CAAC,IAAI,CAAC;IAEX,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,QAAQ;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;QAC5B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,OAAO;QAC/B,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;QACtC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;QAClC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;QAClC,YAAY,EAAE;YACZ,MAAM,EAAE,KAAK,CAAC,iBAAiB;YAC/B,IAAI,EAAE,KAAK,CAAC,eAAe;YAC3B,OAAO,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;YAC/B,UAAU,EAAE,KAAK,CAAC,aAAa,IAAI,EAAE;SACtC;QACD,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,qEAAqE;QACrE,+DAA+D;QAC/D,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;QACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;QAClC,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/tools/governed.d.ts

@@ -0,0 +1,94 @@
+import type { DQLContext } from '../context.js';
+export declare function answerQuestion(ctx: DQLContext, args: {
+    question: string;
+    audience?: 'analyst' | 'stakeholder';
+    requestedMode?: 'auto' | 'ask' | 'research';
+    reasoningEffort?: 'low' | 'medium' | 'high';
+    analysisDepth?: 'quick' | 'deep';
+    threadId?: string;
+    serverUrl?: string;
+}): Promise<{
+    ok: false;
+    runtimeUnavailable: true;
+    error: string;
+} | {
+    artifacts: {
+        id?: string;
+        kind?: string;
+        title?: string;
+        trustState?: string;
+        ref?: string;
+        payload?: unknown;
+    }[] | undefined;
+    nextActions: unknown[] | undefined;
+    trustNote: string;
+    sql?: string | undefined;
+    result?: {
+        columns?: unknown[];
+        rows?: unknown[];
+        rowCount?: number;
+    } | undefined;
+    rowCount?: number | undefined;
+    dqlArtifact?: unknown;
+    draftBlockPath?: string | undefined;
+    promote?: string | undefined;
+    citations?: unknown[] | undefined;
+    validationWarnings?: string[] | undefined;
+    executionError?: string | undefined;
+    ok: true;
+    question: string | undefined;
+    route: string | undefined;
+    status: string | undefined;
+    trustState: string | undefined;
+    answerKind: string | undefined;
+    answer: string | undefined;
+    summary: string | undefined;
+} | {
+    ok: false;
+    error: string;
+}>;
+export declare function buildBlockFromPrompt(ctx: DQLContext, args: {
+    prompt: string;
+    mode?: 'create' | 'edit';
+    blockPath?: string;
+    owner?: string;
+    serverUrl?: string;
+}): Promise<{
+    ok: false;
+    runtimeUnavailable: true;
+    error: string;
+} | {
+    ok: false;
+    error: string;
+    status?: undefined;
+    route?: undefined;
+    draftBlock?: undefined;
+    draftBlockPath?: undefined;
+    dqlArtifact?: undefined;
+    verdict?: undefined;
+    appliedSkills?: undefined;
+    citations?: undefined;
+    promote?: undefined;
+    trustNote?: undefined;
+} | {
+    ok: true;
+    status: string | undefined;
+    route: unknown;
+    draftBlock: {
+        path?: string;
+        slug?: string;
+        name?: string;
+        domain?: string;
+        status?: string;
+        askedTimes?: number;
+    } | undefined;
+    draftBlockPath: string | undefined;
+    dqlArtifact: unknown;
+    verdict: unknown;
+    appliedSkills: unknown[] | undefined;
+    citations: unknown[] | undefined;
+    promote: string | undefined;
+    trustNote: string;
+    error?: undefined;
+}>;
+//# sourceMappingURL=governed.d.ts.map

package/dist/tools/governed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governed.d.ts","sourceRoot":"","sources":["../../src/tools/governed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAiGhD,wBAAsB,cAAc,CAClC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IACJ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;IAC5C,eAAe,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5C,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;aAjDwB,MAAM;eAAS,MAAM;gBAAU,MAAM;qBAAe,MAAM;cAAQ,MAAM;kBAAY,OAAO;;;;;;kBApB/F,OAAO,EAAE;eAAS,OAAO,EAAE;mBAAa,MAAM;;;;;;;;;;;;;;;;;;;;GAiGpE;AAeD,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;;;;;;;;;;;;;eAlBqB,MAAM;eAAS,MAAM;eAAS,MAAM;iBAAW,MAAM;iBAAW,MAAM;qBAAe,MAAM;;;;;;;;;;GAgElH"}

package/dist/tools/governed.js

@@ -0,0 +1,139 @@
+/**
+ * Governed-generation MCP tools. Unlike the BYOSQL Tier-2 tool
+ * (`query_via_metadata`, where the CALLING agent authors the SQL), these run
+ * DQL's OWN governed engines end-to-end and return the executed answer / block
+ * draft — the SAME cascade the web UI uses, so every trust guard (honesty gate,
+ * hollow-answer handling, forced-join retry, deterministic refusal) applies
+ * automatically. They are thin proxies to the local runtime's governed HTTP
+ * endpoints (`/api/agent-runs`, `/api/ai/build`), which already own the LLM
+ * provider + warehouse executors, so there is no second provider to configure.
+ *
+ * Both require the DQL runtime to be running (`dql serve`) because governed
+ * answering/building executes SQL against the warehouse.
+ */
+const DEFAULT_RUNTIME_URL = 'http://127.0.0.1:3474';
+function runtimeBase(serverUrl) {
+    return (serverUrl ?? process.env.DQL_RUNTIME_URL ?? DEFAULT_RUNTIME_URL).replace(/\/$/, '');
+}
+function runtimeUnavailable(base, projectRoot, err) {
+    return {
+        ok: false,
+        runtimeUnavailable: true,
+        error: `Could not reach the DQL runtime at ${base}. Governed answering/building needs it running — ` +
+            `start it with \`dql serve\` in ${projectRoot} (or pass serverUrl), then retry. ` +
+            `(${err instanceof Error ? err.message : String(err)})`,
+    };
+}
+/** Reshape a runtime AgentRun into a compact, agent-friendly governed result. */
+function mapRun(run) {
+    const primary = (run.artifacts ?? [])[0];
+    const p = (primary?.kind === 'answer' ? primary.payload : undefined);
+    return {
+        ok: true,
+        question: run.question,
+        route: run.route,
+        status: run.status,
+        // Canonical trust — report VERBATIM. Generated/semantic answers are
+        // review-required, never certified.
+        trustState: run.trustState,
+        answerKind: run.answerKind,
+        answer: run.answer ?? run.summary,
+        summary: run.summary,
+        ...(p
+            ? {
+                sql: p.proposedSql ?? p.sql,
+                result: p.result,
+                rowCount: p.result?.rowCount,
+                dqlArtifact: p.dqlArtifact,
+                draftBlockPath: p.draftBlockId ?? p.draftBlock?.path,
+                promote: p.promoteCommand,
+                citations: p.citations,
+                validationWarnings: p.validationWarnings,
+                executionError: p.executionError,
+            }
+            : {}),
+        artifacts: run.artifacts,
+        nextActions: run.nextActions,
+        trustNote: 'Report trustState verbatim and never upgrade it. A review-required answer is generated/semantic-layer backed and must be reviewed before it is trusted as certified.',
+    };
+}
+export async function answerQuestion(ctx, args) {
+    const question = args.question?.trim();
+    if (!question)
+        return { ok: false, error: 'Provide a non-empty { question }.' };
+    const base = runtimeBase(args.serverUrl);
+    let response;
+    try {
+        response = await fetch(`${base}/api/agent-runs`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                question,
+                requestedMode: args.requestedMode ?? 'auto',
+                ...(args.audience ? { audience: args.audience } : {}),
+                ...(args.reasoningEffort ? { reasoningEffort: args.reasoningEffort } : {}),
+                ...(args.analysisDepth ? { analysisDepth: args.analysisDepth } : {}),
+                ...(args.threadId ? { threadId: args.threadId } : {}),
+            }),
+        });
+    }
+    catch (err) {
+        return runtimeUnavailable(base, ctx.projectRoot, err);
+    }
+    if (!response.ok) {
+        return { ok: false, error: `DQL runtime returned ${response.status}: ${await response.text()}` };
+    }
+    const payload = (await response.json().catch(() => ({})));
+    if (payload.error || !payload.run)
+        return { ok: false, error: payload.error ?? 'No run returned by the runtime.' };
+    return mapRun(payload.run);
+}
+export async function buildBlockFromPrompt(ctx, args) {
+    const prompt = args.prompt?.trim();
+    if (!prompt)
+        return { ok: false, error: 'Provide a non-empty { prompt } describing the block to build.' };
+    const mode = args.mode === 'edit' ? 'edit' : 'create';
+    if (mode === 'edit' && !args.blockPath?.trim()) {
+        return { ok: false, error: 'Edit mode requires { blockPath } (the block to modify in place).' };
+    }
+    const base = runtimeBase(args.serverUrl);
+    let response;
+    try {
+        response = await fetch(`${base}/api/ai/build`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                prompt,
+                target: 'block',
+                mode,
+                ...(args.blockPath ? { blockPath: args.blockPath.trim() } : {}),
+                ...(args.owner ? { owner: args.owner } : {}),
+            }),
+        });
+    }
+    catch (err) {
+        return runtimeUnavailable(base, ctx.projectRoot, err);
+    }
+    if (!response.ok) {
+        return { ok: false, error: `DQL runtime returned ${response.status}: ${await response.text()}` };
+    }
+    const result = (await response.json().catch(() => ({})));
+    if (result.error)
+        return { ok: false, error: result.error };
+    // Refresh the in-process context so subsequent tool calls see the new draft.
+    ctx.refresh();
+    return {
+        ok: true,
+        status: result.status,
+        route: result.route,
+        draftBlock: result.draftBlock,
+        draftBlockPath: result.draftBlock?.path,
+        dqlArtifact: result.dqlArtifact,
+        verdict: result.verdict,
+        appliedSkills: result.appliedSkills,
+        citations: result.citations,
+        promote: result.draftBlock?.path ? `dql certify --from-draft ${result.draftBlock.path}` : undefined,
+        trustNote: 'AI drafts, humans certify. This is a review-required DRAFT — never present it as certified. Review the verdict, then certify explicitly.',
+    };
+}
+//# sourceMappingURL=governed.js.map

package/dist/tools/governed.js.map

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

package/dist/tools/hints.d.ts

@@ -10,42 +10,8 @@
  * Source of truth is Git (`.dql/hints`, `.dql/traces`, `.dql/reviews`); SQLite
  * (`.dql/cache/agent-kg.sqlite`) is reindexed automatically on every write.
  */
-import { z } from 'zod';
 import type { DQLContext } from '../context.js';
-export declare const recordCorrectionInput: {
-    question: z.ZodString;
-    wrongAnswer: z.ZodString;
-    correction: z.ZodString;
-    scope: z.ZodObject<{
-        metric: z.ZodOptional<z.ZodString>;
-        dbtModel: z.ZodOptional<z.ZodString>;
-        domain: z.ZodOptional<z.ZodString>;
-        dialect: z.ZodOptional<z.ZodString>;
-        term: z.ZodOptional<z.ZodString>;
-        block: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        term?: string | undefined;
-        block?: string | undefined;
-        metric?: string | undefined;
-        domain?: string | undefined;
-        dbtModel?: string | undefined;
-        dialect?: string | undefined;
-    }, {
-        term?: string | undefined;
-        block?: string | undefined;
-        metric?: string | undefined;
-        domain?: string | undefined;
-        dbtModel?: string | undefined;
-        dialect?: string | undefined;
-    }>;
-    rationale: z.ZodOptional<z.ZodString>;
-    author: z.ZodOptional<z.ZodString>;
-    correctedSql: z.ZodOptional<z.ZodString>;
-    hintTitle: z.ZodOptional<z.ZodString>;
-    hintGuidance: z.ZodOptional<z.ZodString>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    anchorObjectKey: z.ZodOptional<z.ZodString>;
-};
+export declare const recordCorrectionInput: Record<string, import("zod").ZodTypeAny>;
 export declare function recordCorrection(ctx: DQLContext, args: {
     question: string;
     wrongAnswer: string;
@@ -84,12 +50,7 @@ export declare function recordCorrection(ctx: DQLContext, args: {
         updatedAt: string;
     };
 };
-export declare const approveHintInput: {
-    hintId: z.ZodString;
-    decision: z.ZodEnum<["approved", "rejected"]>;
-    reviewer: z.ZodString;
-    note: z.ZodOptional<z.ZodString>;
-};
+export declare const approveHintInput: Record<string, import("zod").ZodTypeAny>;
 export declare function approveHint(ctx: DQLContext, args: {
     hintId: string;
     decision: 'approved' | 'rejected';
@@ -123,11 +84,7 @@ export declare function approveHint(ctx: DQLContext, args: {
     };
     error?: undefined;
 };
-export declare const listHintsInput: {
-    status: z.ZodOptional<z.ZodEnum<["candidate", "approved", "rejected"]>>;
-    domain: z.ZodOptional<z.ZodString>;
-    metric: z.ZodOptional<z.ZodString>;
-};
+export declare const listHintsInput: Record<string, import("zod").ZodTypeAny>;
 export declare function listHints(ctx: DQLContext, args: {
     status?: 'candidate' | 'approved' | 'rejected';
     domain?: string;

package/dist/tools/hints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hints.d.ts","sourceRoot":"","sources":["../../src/tools/hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAkBhD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYjC,CAAC;AAEF,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IACJ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;;;;;;;;;;;;;;;;;;EAyBF;AAED,eAAO,MAAM,gBAAgB;;;;;CAK5B,CAAC;AAEF,wBAAgB,WAAW,CACzB,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0B7F;AAED,eAAO,MAAM,cAAc;;;;CAI1B,CAAC;AAEF,wBAAgB,SAAS,CACvB,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;EAU3F"}
+{"version":3,"file":"hints.d.ts","sourceRoot":"","sources":["../../src/tools/hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAUhD,eAAO,MAAM,qBAAqB,0CAA4C,CAAC;AAE/E,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IACJ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;;;;;;;;;;;;;;;;;;EAyBF;AAED,eAAO,MAAM,gBAAgB,0CAAuC,CAAC;AAErE,wBAAgB,WAAW,CACzB,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0B7F;AAED,eAAO,MAAM,cAAc,0CAAqC,CAAC;AAEjE,wBAAgB,SAAS,CACvB,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;EAU3F"}