@duckcodeailabs/dql-mcp 1.2.0

package/LICENSE

@@ -0,0 +1,123 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and
+distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright
+owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities
+that control, are controlled by, or are under common control with that entity.
+For the purposes of this definition, "control" means (i) the power, direct or
+indirect, to cause the direction or management of such entity, whether by
+contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising
+permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including
+but not limited to software source code, documentation source, and configuration
+files.
+
+"Object" form shall mean any form resulting from mechanical transformation or
+translation of a Source form, including but not limited to compiled object code,
+generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form, made
+available under the License, as indicated by a copyright notice that is included
+in or attached to the work.
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that
+is based on (or derived from) the Work and for which the editorial revisions,
+annotations, elaborations, or other modifications represent, as a whole, an
+original work of authorship.
+
+"Contribution" shall mean any work of authorship, including the original version
+of the Work and any modifications or additions to that Work or Derivative Works
+thereof, that is intentionally submitted to Licensor for inclusion in the Work
+by the copyright owner or by an individual or Legal Entity authorized to submit
+on behalf of the copyright owner.
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
+of whom a Contribution has been received by Licensor and subsequently
+incorporated within the Work.
+
+2. Grant of Copyright License.
+
+Subject to the terms and conditions of this License, each Contributor hereby
+grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+irrevocable copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the Work and such
+Derivative Works in Source or Object form.
+
+3. Grant of Patent License.
+
+Subject to the terms and conditions of this License, each Contributor hereby
+grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+irrevocable patent license to make, have made, use, offer to sell, sell, import,
+and otherwise transfer the Work.
+
+4. Redistribution.
+
+You may reproduce and distribute copies of the Work or Derivative Works thereof
+in any medium, with or without modifications, and in Source or Object form,
+provided that You meet the following conditions:
+
+(a) You must give any other recipients of the Work or Derivative Works a copy of
+this License; and
+
+(b) You must cause any modified files to carry prominent notices stating that
+You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works that You
+distribute, all copyright, patent, trademark, and attribution notices from the
+Source form of the Work, excluding those notices that do not pertain to any part
+of the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its distribution, then
+any Derivative Works that You distribute must include a readable copy of the
+attribution notices contained within such NOTICE file, excluding those notices
+that do not pertain to any part of the Derivative Works.
+
+5. Submission of Contributions.
+
+Unless You explicitly state otherwise, any Contribution intentionally submitted
+for inclusion in the Work by You to the Licensor shall be under the terms and
+conditions of this License, without any additional terms or conditions.
+
+6. Trademarks.
+
+This License does not grant permission to use the trade names, trademarks,
+service marks, or product names of the Licensor, except as required for
+reasonable and customary use in describing the origin of the Work.
+
+7. Disclaimer of Warranty.
+
+Unless required by applicable law or agreed to in writing, Licensor provides the
+Work on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+express or implied, including, without limitation, any warranties or conditions
+of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
+PURPOSE.
+
+8. Limitation of Liability.
+
+In no event and under no legal theory, whether in tort (including negligence),
+contract, or otherwise, unless required by applicable law, shall any Contributor
+be liable to You for damages, including any direct, indirect, special,
+incidental, or consequential damages of any character arising as a result of this
+License or out of the use or inability to use the Work.
+
+9. Accepting Warranty or Additional Liability.
+
+While redistributing the Work or Derivative Works thereof, You may choose to
+offer, and charge a fee for, acceptance of support, warranty, indemnity, or
+other liability obligations and/or rights consistent with this License.
+
+END OF TERMS AND CONDITIONS

package/dist/context.d.ts

@@ -0,0 +1,26 @@
+import { SemanticLayer, LineageGraph, type DQLManifest } from '@duckcodeailabs/dql-core';
+export interface DQLContextOptions {
+    projectRoot: string;
+    dqlVersion?: string;
+}
+/**
+ * Shared read-only view over a DQL project.
+ *
+ * Loads the manifest + semantic layer once per MCP session. Tools call
+ * {@link refresh} between turns if they need to see edits.
+ */
+export declare class DQLContext {
+    readonly projectRoot: string;
+    private readonly dqlVersion;
+    private _manifest;
+    private _semanticLayer;
+    private _lineage;
+    constructor(options: DQLContextOptions);
+    get manifest(): DQLManifest;
+    get semanticLayer(): SemanticLayer;
+    get lineageGraph(): LineageGraph;
+    refresh(): void;
+}
+/** Walk up from `startDir` until a `dql.config.json` is found, else return `startDir`. */
+export declare function findProjectRoot(startDir: string): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,aAAa,EAEb,YAAY,EACZ,KAAK,WAAW,EAIjB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAA6B;gBAEjC,OAAO,EAAE,iBAAiB;IAKtC,IAAI,QAAQ,IAAI,WAAW,CAG1B;IAED,IAAI,aAAa,IAAI,aAAa,CAGjC;IAED,IAAI,YAAY,IAAI,YAAY,CAG/B;IAED,OAAO,IAAI,IAAI;CAehB;AA8CD,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQxD"}

package/dist/context.js

@@ -0,0 +1,102 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { buildManifest, resolveDbtManifestPath, SemanticLayer, loadSemanticLayerFromDir, LineageGraph, } from '@duckcodeailabs/dql-core';
+/**
+ * Shared read-only view over a DQL project.
+ *
+ * Loads the manifest + semantic layer once per MCP session. Tools call
+ * {@link refresh} between turns if they need to see edits.
+ */
+export class DQLContext {
+    projectRoot;
+    dqlVersion;
+    _manifest = null;
+    _semanticLayer = null;
+    _lineage = null;
+    constructor(options) {
+        this.projectRoot = options.projectRoot;
+        this.dqlVersion = options.dqlVersion ?? 'mcp';
+    }
+    get manifest() {
+        if (!this._manifest)
+            this.refresh();
+        return this._manifest;
+    }
+    get semanticLayer() {
+        if (!this._semanticLayer)
+            this.refresh();
+        return this._semanticLayer;
+    }
+    get lineageGraph() {
+        if (!this._lineage)
+            this._lineage = buildGraphFromManifest(this.manifest);
+        return this._lineage;
+    }
+    refresh() {
+        const dbtManifestPath = resolveDbtManifestPath(this.projectRoot) ?? undefined;
+        this._manifest = buildManifest({
+            projectRoot: this.projectRoot,
+            dqlVersion: this.dqlVersion,
+            dbtManifestPath,
+        });
+        const semanticDir = resolveSemanticDir(this.projectRoot);
+        this._semanticLayer = existsSync(semanticDir)
+            ? loadSemanticLayerFromDir(semanticDir)
+            : new SemanticLayer();
+        this._lineage = null;
+    }
+}
+function buildGraphFromManifest(manifest) {
+    const graph = new LineageGraph();
+    for (const node of manifest.lineage.nodes) {
+        graph.addNode({
+            id: node.id,
+            type: node.type,
+            name: node.name,
+            layer: node.layer,
+            domain: node.domain,
+            owner: node.owner,
+            status: node.status,
+            metadata: node.metadata,
+            columns: node.columns,
+        });
+    }
+    for (const edge of manifest.lineage.edges) {
+        graph.addEdge({
+            source: edge.source,
+            target: edge.target,
+            type: edge.type,
+            sourceDomain: edge.sourceDomain,
+            targetDomain: edge.targetDomain,
+        });
+    }
+    return graph;
+}
+function resolveSemanticDir(projectRoot) {
+    const configPath = join(projectRoot, 'dql.config.json');
+    if (existsSync(configPath)) {
+        try {
+            const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+            if (config.semanticLayer?.path) {
+                return join(projectRoot, config.semanticLayer.path);
+            }
+        }
+        catch {
+            /* fall through */
+        }
+    }
+    return join(projectRoot, 'semantic-layer');
+}
+/** Walk up from `startDir` until a `dql.config.json` is found, else return `startDir`. */
+export function findProjectRoot(startDir) {
+    let current = resolve(startDir);
+    while (true) {
+        if (existsSync(join(current, 'dql.config.json')))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return resolve(startDir);
+        current = parent;
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @duckcodeailabs/dql-mcp — MCP server exposing DQL blocks, semantic layer,
+ * lineage, and governance to LLM agents.
+ */
+export { createDQLMCPServer } from './server.js';
+export { DQLContext, findProjectRoot } from './context.js';
+export type { DQLContextOptions } from './context.js';
+export { runStdio } from './transports/stdio.js';
+export { runLoopbackHTTP } from './transports/http.js';
+export { searchBlocks, searchBlocksInput } from './tools/search-blocks.js';
+export { getBlock, getBlockInput } from './tools/get-block.js';
+export { queryViaBlock, queryViaBlockInput } from './tools/query-via-block.js';
+export { listMetrics, listMetricsInput, listDimensions, listDimensionsInput, } from './tools/semantic.js';
+export { lineageImpact, lineageImpactInput } from './tools/lineage-impact.js';
+export { certify, certifyInput } from './tools/certify.js';
+export { suggestBlock, suggestBlockInput } from './tools/suggest-block.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * @duckcodeailabs/dql-mcp — MCP server exposing DQL blocks, semantic layer,
+ * lineage, and governance to LLM agents.
+ */
+export { createDQLMCPServer } from './server.js';
+export { DQLContext, findProjectRoot } from './context.js';
+export { runStdio } from './transports/stdio.js';
+export { runLoopbackHTTP } from './transports/http.js';
+export { searchBlocks, searchBlocksInput } from './tools/search-blocks.js';
+export { getBlock, getBlockInput } from './tools/get-block.js';
+export { queryViaBlock, queryViaBlockInput } from './tools/query-via-block.js';
+export { listMetrics, listMetricsInput, listDimensions, listDimensionsInput, } from './tools/semantic.js';
+export { lineageImpact, lineageImpactInput } from './tools/lineage-impact.js';
+export { certify, certifyInput } from './tools/certify.js';
+export { suggestBlock, suggestBlockInput } from './tools/suggest-block.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export interface CreateServerOptions {
+    projectRoot?: string;
+    version?: string;
+}
+export declare function createDQLMCPServer(options?: CreateServerOptions): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUpE,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,SAAS,CAyD/E"}

package/dist/server.js

@@ -0,0 +1,34 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { DQLContext, findProjectRoot } from './context.js';
+import { searchBlocks, searchBlocksInput } from './tools/search-blocks.js';
+import { getBlock, getBlockInput } from './tools/get-block.js';
+import { queryViaBlock, queryViaBlockInput } from './tools/query-via-block.js';
+import { listMetrics, listMetricsInput, listDimensions, listDimensionsInput } from './tools/semantic.js';
+import { lineageImpact, lineageImpactInput } from './tools/lineage-impact.js';
+import { certify, certifyInput } from './tools/certify.js';
+import { suggestBlock, suggestBlockInput } from './tools/suggest-block.js';
+export function createDQLMCPServer(options = {}) {
+    const projectRoot = options.projectRoot ?? findProjectRoot(process.cwd());
+    const ctx = new DQLContext({ projectRoot, dqlVersion: options.version });
+    const server = new McpServer({ name: 'dql-mcp', version: options.version ?? '0.1.0' }, {
+        instructions: 'DQL exposes certified, git-versioned analytics blocks. Every answer you build ' +
+            'should be grounded in a block returned by search_blocks / get_block. Use ' +
+            'query_via_block to execute — never fabricate SQL. Use suggest_block when a ' +
+            'new question needs a new block; the governance gate returns which rules pass.',
+    });
+    server.registerTool('search_blocks', { description: 'Find certified DQL blocks by keyword, domain, or status.', inputSchema: searchBlocksInput }, async (args) => wrap(await searchBlocks(ctx, args)));
+    server.registerTool('get_block', { description: 'Return full metadata, dependencies, and SQL for a block.', inputSchema: getBlockInput }, async (args) => wrap(await getBlock(ctx, args)));
+    server.registerTool('query_via_block', { description: 'Execute a certified block against the local DQL runtime.', inputSchema: queryViaBlockInput }, async (args) => wrap(await queryViaBlock(ctx, args)));
+    server.registerTool('list_metrics', { description: 'List semantic-layer metrics, optionally filtered by domain.', inputSchema: listMetricsInput }, async (args) => wrap(await listMetrics(ctx, args)));
+    server.registerTool('list_dimensions', { description: 'List semantic-layer dimensions, optionally filtered by domain.', inputSchema: listDimensionsInput }, async (args) => wrap(await listDimensions(ctx, args)));
+    server.registerTool('lineage_impact', { description: 'Return upstream/downstream lineage for a block, metric, or model.', inputSchema: lineageImpactInput }, async (args) => wrap(await lineageImpact(ctx, args)));
+    server.registerTool('certify', { description: 'Run governance rules against a block and report pass/fail.', inputSchema: certifyInput }, async (args) => wrap(await certify(ctx, args)));
+    server.registerTool('suggest_block', { description: 'Write a proposed block to blocks/_drafts/ and return the governance gate result.', inputSchema: suggestBlockInput }, async (args) => wrap(await suggestBlock(ctx, args)));
+    return server;
+}
+function wrap(result) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/certify.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import type { DQLContext } from '../context.js';
+export declare const certifyInput: {
+    name: z.ZodString;
+};
+export declare function certify(ctx: DQLContext, args: {
+    name: string;
+}): {
+    error: string;
+    block?: undefined;
+    path?: undefined;
+    certified?: undefined;
+    errors?: undefined;
+    warnings?: undefined;
+    checkedAt?: undefined;
+} | {
+    block: string;
+    path: string;
+    certified: boolean;
+    errors: {
+        rule: string;
+        message: string;
+    }[];
+    warnings: {
+        rule: string;
+        message: string;
+    }[];
+    checkedAt: string;
+    error?: undefined;
+};
+//# sourceMappingURL=certify.d.ts.map

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

@@ -0,0 +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"}

package/dist/tools/certify.js

@@ -0,0 +1,22 @@
+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.'),
+};
+export function certify(ctx, args) {
+    const manifestBlock = ctx.manifest.blocks[args.name];
+    if (!manifestBlock)
+        return { error: `No block named "${args.name}".` };
+    const record = manifestBlockToRecord(manifestBlock);
+    const result = new Certifier().evaluate(record);
+    return {
+        block: args.name,
+        path: manifestBlock.filePath,
+        certified: result.certified,
+        errors: result.errors,
+        warnings: result.warnings,
+        checkedAt: result.checkedAt.toISOString(),
+    };
+}
+//# sourceMappingURL=certify.js.map

package/dist/tools/certify.js.map

@@ -0,0 +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"}

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

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+import type { DQLContext } from '../context.js';
+export declare const getBlockInput: {
+    name: z.ZodString;
+    includeSource: z.ZodOptional<z.ZodBoolean>;
+};
+export declare function getBlock(ctx: DQLContext, args: {
+    name: string;
+    includeSource?: boolean;
+}): {
+    error: string;
+    name?: undefined;
+    path?: undefined;
+    domain?: undefined;
+    owner?: undefined;
+    status?: undefined;
+    description?: undefined;
+    tags?: undefined;
+    chartType?: undefined;
+    metricRef?: undefined;
+    dependencies?: undefined;
+    tests?: undefined;
+    llmContext?: undefined;
+    examples?: undefined;
+    invariants?: undefined;
+    sql?: undefined;
+    source?: undefined;
+} | {
+    name: string;
+    path: string;
+    domain: string | null;
+    owner: string | null;
+    status: string;
+    description: string | null;
+    tags: string[];
+    chartType: string | null;
+    metricRef: string | null;
+    dependencies: {
+        tables: string[];
+        refs: string[];
+        metrics: string[];
+        dimensions: string[];
+    };
+    tests: string[];
+    llmContext: string | null;
+    examples: {
+        question: string;
+        sql?: string;
+    }[];
+    invariants: string[];
+    sql: string;
+    source: string | null;
+    error?: undefined;
+};
+//# sourceMappingURL=get-block.d.ts.map

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

@@ -0,0 +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"}

package/dist/tools/get-block.js

@@ -0,0 +1,46 @@
+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.'),
+};
+export function getBlock(ctx, args) {
+    const block = ctx.manifest.blocks[args.name];
+    if (!block) {
+        return { error: `No block named "${args.name}". Run search_blocks first.` };
+    }
+    const absPath = join(ctx.projectRoot, block.filePath);
+    const source = args.includeSource !== false && existsSync(absPath)
+        ? readFileSync(absPath, 'utf-8')
+        : null;
+    return {
+        name: block.name,
+        path: block.filePath,
+        domain: block.domain ?? null,
+        owner: block.owner ?? null,
+        status: block.status ?? 'draft',
+        description: block.description ?? null,
+        tags: block.tags ?? [],
+        chartType: block.chartType ?? null,
+        metricRef: block.metricRef ?? null,
+        dependencies: {
+            tables: block.tableDependencies,
+            refs: block.refDependencies,
+            metrics: block.metricRefs ?? [],
+            dimensions: block.dimensionRefs ?? [],
+        },
+        tests: block.tests,
+        // v1.2 Track G — agent-facing metadata. Full payload on get_block so
+        // chat cells can few-shot on `examples` and cite `invariants`.
+        llmContext: block.llmContext ?? null,
+        examples: block.examples ?? [],
+        invariants: block.invariants ?? [],
+        sql: block.sql,
+        source,
+    };
+}
+//# sourceMappingURL=get-block.js.map

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

@@ -0,0 +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"}

package/dist/tools/lineage-impact.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { DQLContext } from '../context.js';
+export declare const lineageImpactInput: {
+    focus: z.ZodString;
+    upstreamDepth: z.ZodOptional<z.ZodNumber>;
+    downstreamDepth: z.ZodOptional<z.ZodNumber>;
+    paths: z.ZodOptional<z.ZodBoolean>;
+};
+export declare function lineageImpact(ctx: DQLContext, args: {
+    focus: string;
+    upstreamDepth?: number;
+    downstreamDepth?: number;
+    paths?: boolean;
+}): Record<string, unknown>;
+//# sourceMappingURL=lineage-impact.d.ts.map

package/dist/tools/lineage-impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineage-impact.d.ts","sourceRoot":"","sources":["../../src/tools/lineage-impact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,eAAO,MAAM,kBAAkB;;;;;CAQ9B,CAAC;AAEF,wBAAgB,aAAa,CAC3B,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;IACJ,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,2BA+BF"}

package/dist/tools/lineage-impact.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { queryLineage, queryCompleteLineagePaths } from '@duckcodeailabs/dql-core';
+export const lineageImpactInput = {
+    focus: z.string().describe('Node id ("block:revenue") or bare name — resolved against the lineage graph.'),
+    upstreamDepth: z.number().int().min(0).max(20).optional(),
+    downstreamDepth: z.number().int().min(0).max(20).optional(),
+    paths: z
+        .boolean()
+        .optional()
+        .describe('When true, include full source→leaf paths (slower on large graphs).'),
+};
+export function lineageImpact(ctx, args) {
+    const graph = ctx.lineageGraph;
+    const result = queryLineage(graph, {
+        focus: args.focus,
+        upstreamDepth: args.upstreamDepth,
+        downstreamDepth: args.downstreamDepth,
+    });
+    if (!result.focalNode) {
+        return { error: `No node matches "${args.focus}".` };
+    }
+    const response = {
+        focalNode: result.focalNode,
+        nodeCount: result.graph.nodes.length,
+        edgeCount: result.graph.edges.length,
+        nodes: result.graph.nodes,
+        edges: result.graph.edges,
+    };
+    if (args.paths) {
+        const paths = queryCompleteLineagePaths(graph, result.focalNode.id);
+        if (paths) {
+            response.upstreamPaths = paths.upstreamPaths.map(formatPath);
+            response.downstreamPaths = paths.downstreamPaths.map(formatPath);
+            response.layerSummary = paths.layerSummary;
+        }
+    }
+    return response;
+}
+function formatPath(path) {
+    return {
+        chain: path.nodes.map((n) => `${n.type}:${n.name}`).join(' → '),
+        layers: path.layers,
+    };
+}
+//# sourceMappingURL=lineage-impact.js.map

package/dist/tools/lineage-impact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineage-impact.js","sourceRoot":"","sources":["../../src/tools/lineage-impact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAGnF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8EAA8E,CAAC;IAC1G,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3D,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,qEAAqE,CAAC;CACnF,CAAC;AAEF,MAAM,UAAU,aAAa,CAC3B,GAAe,EACf,IAKC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC;IAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE;QACjC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,eAAe,EAAE,IAAI,CAAC,eAAe;KACtC,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,oBAAoB,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,QAAQ,GAA4B;QACxC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM;QACpC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM;QACpC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK;KAC1B,CAAC;IAEF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACpE,IAAI,KAAK,EAAE,CAAC;YACV,QAAQ,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC7D,QAAQ,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACjE,QAAQ,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,UAAU,CAAC,IAAoF;IACtG,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/D,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC"}

package/dist/tools/query-via-block.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import type { DQLContext } from '../context.js';
+export declare const queryViaBlockInput: {
+    name: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+    serverUrl: z.ZodOptional<z.ZodString>;
+};
+/**
+ * Execute a certified block by name. Delegates SQL prep + warehouse execution
+ * to the local-runtime HTTP server, so results honor the same semantic resolver
+ * and connection config as the notebook UI — the agent never sees raw SQL.
+ */
+export declare function queryViaBlock(ctx: DQLContext, args: {
+    name: string;
+    limit?: number;
+    serverUrl?: string;
+}): Promise<{
+    error: string;
+    block?: undefined;
+    blockPath?: undefined;
+    rowCount?: undefined;
+    durationMs?: undefined;
+    columns?: undefined;
+    rows?: undefined;
+} | {
+    block: string;
+    blockPath: string;
+    rowCount: number;
+    durationMs: number | null;
+    columns: {
+        name: string;
+        type?: string;
+    }[];
+    rows: unknown[][];
+    error?: undefined;
+}>;
+//# sourceMappingURL=query-via-block.d.ts.map