@duckcodeailabs/dql-agent 1.4.0

package/dist/kg/build.js

@@ -0,0 +1,126 @@
+/**
+ * Build the KG node + edge arrays from a compiled DQL manifest.
+ *
+ * Inputs:
+ *   - dql-manifest.json (blocks, dashboards, apps, metrics, dimensions, sources)
+ *   - dbt manifest (already merged into the DQL manifest's dbtImport.dbtDag)
+ *   - project Skills folder (loaded separately by the Skills loader)
+ *
+ * The output is intentionally flat — caller passes it to `KGStore.rebuild()`.
+ */
+export function buildKGFromManifest(manifest) {
+    const nodes = [];
+    const edges = [];
+    // Blocks
+    for (const block of Object.values(manifest.blocks)) {
+        const nodeId = `block:${block.name}`;
+        nodes.push({
+            nodeId,
+            kind: 'block',
+            name: block.name,
+            domain: block.domain,
+            status: block.status,
+            owner: block.owner,
+            description: block.description,
+            tags: block.tags ?? [],
+            llmContext: block.llmContext,
+            examples: block.examples,
+            sourcePath: block.filePath,
+        });
+    }
+    // Metrics
+    for (const m of Object.values(manifest.metrics)) {
+        const nodeId = `metric:${m.name}`;
+        nodes.push({
+            nodeId,
+            kind: 'metric',
+            name: m.name,
+            domain: m.domain,
+            description: m.description,
+            sourcePath: m.filePath,
+        });
+    }
+    // Dimensions
+    for (const d of Object.values(manifest.dimensions)) {
+        const nodeId = `dimension:${d.name}`;
+        nodes.push({
+            nodeId,
+            kind: 'dimension',
+            name: d.name,
+            description: d.description,
+            sourcePath: d.filePath,
+        });
+    }
+    // Sources / dbt models
+    for (const s of Object.values(manifest.sources)) {
+        const isDbt = s.origin === 'dbt';
+        const kind = isDbt ? 'dbt_model' : 'dbt_source';
+        const nodeId = `${kind}:${s.name}`;
+        nodes.push({
+            nodeId,
+            kind,
+            name: s.name,
+            description: s.dbtModel?.description,
+        });
+    }
+    // Dashboards
+    for (const d of Object.values(manifest.dashboards ?? {})) {
+        const nodeId = `dashboard:${d.id}`;
+        nodes.push({
+            nodeId,
+            kind: 'dashboard',
+            name: d.title,
+            domain: d.domain,
+            description: d.description,
+            tags: d.tags ?? [],
+            sourcePath: d.filePath,
+        });
+        for (const blockId of d.blockIds) {
+            edges.push({ src: `block:${blockId}`, dst: nodeId, kind: 'contains' });
+        }
+        for (const blockName of d.blockPathRefs) {
+            edges.push({ src: `block:${blockName}`, dst: nodeId, kind: 'contains' });
+        }
+    }
+    // Apps
+    for (const a of Object.values(manifest.apps ?? {})) {
+        const nodeId = `app:${a.id}`;
+        nodes.push({
+            nodeId,
+            kind: 'app',
+            name: a.name,
+            domain: a.domain,
+            owner: a.owners[0],
+            description: a.description,
+            tags: a.tags ?? [],
+            sourcePath: a.filePath,
+        });
+        for (const dashboardId of a.dashboards) {
+            edges.push({ src: `dashboard:${dashboardId}`, dst: nodeId, kind: 'contains' });
+        }
+    }
+    // Domains: derive a node per distinct domain seen across blocks/dashboards/apps.
+    const domains = new Set();
+    for (const block of Object.values(manifest.blocks))
+        if (block.domain)
+            domains.add(block.domain);
+    for (const d of Object.values(manifest.dashboards ?? {}))
+        if (d.domain)
+            domains.add(d.domain);
+    for (const a of Object.values(manifest.apps ?? {}))
+        if (a.domain)
+            domains.add(a.domain);
+    for (const m of Object.values(manifest.metrics))
+        if (m.domain)
+            domains.add(m.domain);
+    for (const d of domains) {
+        nodes.push({
+            nodeId: `domain:${d}`,
+            kind: 'domain',
+            name: d,
+            domain: d,
+        });
+    }
+    return { nodes, edges };
+}
+//# sourceMappingURL=build.js.map

package/dist/kg/build.js.map

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

package/dist/kg/sqlite-fts.d.ts

@@ -0,0 +1,39 @@
+/**
+ * SQLite + FTS5 backing store for the knowledge graph.
+ *
+ * Schema (created on demand):
+ *   kg_nodes       — structured columns + JSON blobs for tags/examples
+ *   kg_nodes_fts   — virtual FTS5 table over name/description/llm_context/tags
+ *   kg_edges       — adjacency list (src, dst, kind)
+ *   kg_feedback    — feedback events for self-learning ranking
+ *   kg_meta        — last-build timestamp + manifest fingerprint
+ */
+import type { KGNode, KGEdge, KGSearchHit, KGSearchOptions, KGFeedbackRow } from './types.js';
+export declare class KGStore {
+    private db;
+    constructor(dbPath: string);
+    private initSchema;
+    /**
+     * Wholesale rebuild — clears every node/edge then inserts the supplied
+     * arrays inside one transaction. Feedback rows are preserved across
+     * rebuilds because they're index inputs.
+     */
+    rebuild(nodes: KGNode[], edges: KGEdge[]): void;
+    search(options: KGSearchOptions): KGSearchHit[];
+    getNode(nodeId: string): KGNode | null;
+    getNodesByKind(kind: string, limit?: number): KGNode[];
+    recordFeedback(row: KGFeedbackRow): void;
+    blockFeedbackScore(blockId: string): {
+        up: number;
+        down: number;
+    };
+    /** Surface high-confidence uncertified answers ready for promotion. */
+    promotionCandidates(minUps?: number): Array<{
+        question: string;
+        blockId: string;
+        ups: number;
+    }>;
+    meta(key: string): string | null;
+    close(): void;
+}
+//# sourceMappingURL=sqlite-fts.d.ts.map

package/dist/kg/sqlite-fts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-fts.d.ts","sourceRoot":"","sources":["../../src/kg/sqlite-fts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EACV,MAAM,EACN,MAAM,EACN,WAAW,EACX,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAQ1B,OAAO,CAAC,UAAU;IA8DlB;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IA+C/C,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,EAAE;IA2C/C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAUtC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,MAAM,EAAE;IAYnD,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAUxC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAajE,uEAAuE;IACvE,mBAAmB,CAAC,MAAM,SAAI,GAAG,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAmB1F,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMhC,KAAK,IAAI,IAAI;CAGd"}

package/dist/kg/sqlite-fts.js

@@ -0,0 +1,257 @@
+/**
+ * SQLite + FTS5 backing store for the knowledge graph.
+ *
+ * Schema (created on demand):
+ *   kg_nodes       — structured columns + JSON blobs for tags/examples
+ *   kg_nodes_fts   — virtual FTS5 table over name/description/llm_context/tags
+ *   kg_edges       — adjacency list (src, dst, kind)
+ *   kg_feedback    — feedback events for self-learning ranking
+ *   kg_meta        — last-build timestamp + manifest fingerprint
+ */
+import Database from 'better-sqlite3';
+import { dirname } from 'node:path';
+import { mkdirSync } from 'node:fs';
+export class KGStore {
+    db;
+    constructor(dbPath) {
+        mkdirSync(dirname(dbPath), { recursive: true });
+        this.db = new Database(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+        this.initSchema();
+    }
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS kg_nodes (
+        node_id      TEXT PRIMARY KEY,
+        kind         TEXT NOT NULL,
+        name         TEXT NOT NULL,
+        domain       TEXT,
+        status       TEXT,
+        owner        TEXT,
+        description  TEXT,
+        llm_context  TEXT,
+        tags_json    TEXT NOT NULL DEFAULT '[]',
+        examples_json TEXT NOT NULL DEFAULT '[]',
+        source_path  TEXT,
+        git_sha      TEXT NOT NULL DEFAULT '',
+        updated_at   TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_kg_nodes_kind   ON kg_nodes(kind);
+      CREATE INDEX IF NOT EXISTS idx_kg_nodes_domain ON kg_nodes(domain);
+
+      CREATE VIRTUAL TABLE IF NOT EXISTS kg_nodes_fts USING fts5(
+        node_id UNINDEXED,
+        name,
+        description,
+        llm_context,
+        tags,
+        kind,
+        domain,
+        tokenize = 'porter unicode61'
+      );
+
+      CREATE TABLE IF NOT EXISTS kg_edges (
+        src    TEXT NOT NULL,
+        dst    TEXT NOT NULL,
+        kind   TEXT NOT NULL,
+        weight REAL NOT NULL DEFAULT 1.0,
+        PRIMARY KEY (src, dst, kind)
+      );
+      CREATE INDEX IF NOT EXISTS idx_kg_edges_src ON kg_edges(src);
+      CREATE INDEX IF NOT EXISTS idx_kg_edges_dst ON kg_edges(dst);
+
+      CREATE TABLE IF NOT EXISTS kg_feedback (
+        id          TEXT PRIMARY KEY,
+        ts          TEXT NOT NULL,
+        user        TEXT NOT NULL,
+        question    TEXT NOT NULL,
+        answer_kind TEXT NOT NULL,
+        block_id    TEXT,
+        rating      TEXT NOT NULL CHECK (rating IN ('up', 'down')),
+        comment     TEXT
+      );
+      CREATE INDEX IF NOT EXISTS idx_kg_feedback_user  ON kg_feedback(user);
+      CREATE INDEX IF NOT EXISTS idx_kg_feedback_block ON kg_feedback(block_id);
+
+      CREATE TABLE IF NOT EXISTS kg_meta (
+        key   TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+    `);
+    }
+    /**
+     * Wholesale rebuild — clears every node/edge then inserts the supplied
+     * arrays inside one transaction. Feedback rows are preserved across
+     * rebuilds because they're index inputs.
+     */
+    rebuild(nodes, edges) {
+        const insertNode = this.db.prepare(`
+      INSERT INTO kg_nodes (
+        node_id, kind, name, domain, status, owner, description, llm_context,
+        tags_json, examples_json, source_path, git_sha, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        const insertFts = this.db.prepare(`
+      INSERT INTO kg_nodes_fts (node_id, name, description, llm_context, tags, kind, domain)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `);
+        const insertEdge = this.db.prepare(`
+      INSERT OR IGNORE INTO kg_edges (src, dst, kind, weight) VALUES (?, ?, ?, ?)
+    `);
+        const now = new Date().toISOString();
+        const txn = this.db.transaction(() => {
+            this.db.prepare('DELETE FROM kg_edges').run();
+            this.db.prepare('DELETE FROM kg_nodes_fts').run();
+            this.db.prepare('DELETE FROM kg_nodes').run();
+            for (const n of nodes) {
+                insertNode.run(n.nodeId, n.kind, n.name, n.domain ?? null, n.status ?? null, n.owner ?? null, n.description ?? null, n.llmContext ?? null, JSON.stringify(n.tags ?? []), JSON.stringify(n.examples ?? []), n.sourcePath ?? null, n.gitSha ?? '', now);
+                insertFts.run(n.nodeId, n.name, n.description ?? '', n.llmContext ?? '', (n.tags ?? []).join(' '), n.kind, n.domain ?? '');
+            }
+            for (const e of edges) {
+                insertEdge.run(e.src, e.dst, e.kind, e.weight ?? 1.0);
+            }
+            this.db.prepare(`INSERT OR REPLACE INTO kg_meta (key, value) VALUES ('built_at', ?)`).run(now);
+        });
+        txn();
+    }
+    search(options) {
+        const { query, kinds, domain, limit = 20 } = options;
+        if (!query.trim())
+            return [];
+        const sanitized = sanitizeFtsQuery(query);
+        if (!sanitized)
+            return [];
+        const filters = [];
+        const params = [sanitized];
+        if (kinds && kinds.length > 0) {
+            filters.push(`f.kind IN (${kinds.map(() => '?').join(', ')})`);
+            params.push(...kinds);
+        }
+        if (domain) {
+            filters.push(`f.domain = ?`);
+            params.push(domain);
+        }
+        const whereExtra = filters.length > 0 ? ` AND ${filters.join(' AND ')}` : '';
+        const rows = this.db.prepare(`
+      SELECT n.*,
+             bm25(kg_nodes_fts) AS rank,
+             snippet(kg_nodes_fts, -1, '<mark>', '</mark>', '…', 12) AS snip
+      FROM kg_nodes_fts AS f
+      JOIN kg_nodes AS n ON n.node_id = f.node_id
+      WHERE kg_nodes_fts MATCH ?${whereExtra}
+      ORDER BY rank
+      LIMIT ?
+    `).all(...params, limit);
+        return rows.map((r) => ({
+            node: rowToNode(r),
+            score: r.rank ? 1 / (1 + Math.max(0, r.rank)) : 0,
+            snippet: r.snip ?? undefined,
+        }));
+    }
+    getNode(nodeId) {
+        const row = this.db.prepare('SELECT * FROM kg_nodes WHERE node_id = ?').get(nodeId);
+        return row ? rowToNode(row) : null;
+    }
+    getNodesByKind(kind, limit = 100) {
+        const rows = this.db.prepare('SELECT * FROM kg_nodes WHERE kind = ? ORDER BY name LIMIT ?').all(kind, limit);
+        return rows.map((r) => rowToNode(r));
+    }
+    recordFeedback(row) {
+        this.db.prepare(`
+      INSERT INTO kg_feedback (id, ts, user, question, answer_kind, block_id, rating, comment)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(row.id, row.ts, row.user, row.question, row.answerKind, row.blockId ?? null, row.rating, row.comment ?? null);
+    }
+    blockFeedbackScore(blockId) {
+        const row = this.db.prepare(`
+      SELECT
+        SUM(CASE WHEN rating = 'up' THEN 1 ELSE 0 END) AS up,
+        SUM(CASE WHEN rating = 'down' THEN 1 ELSE 0 END) AS down
+      FROM kg_feedback WHERE block_id = ?
+    `).get(blockId);
+        return {
+            up: row?.up ?? 0,
+            down: row?.down ?? 0,
+        };
+    }
+    /** Surface high-confidence uncertified answers ready for promotion. */
+    promotionCandidates(minUps = 5) {
+        const rows = this.db.prepare(`
+      SELECT block_id, question, COUNT(*) AS ups
+      FROM kg_feedback
+      WHERE answer_kind = 'uncertified' AND rating = 'up' AND block_id IS NOT NULL
+      GROUP BY block_id, question
+      HAVING ups >= ?
+        AND NOT EXISTS (
+          SELECT 1 FROM kg_feedback f2
+          WHERE f2.block_id = kg_feedback.block_id
+            AND f2.answer_kind = 'uncertified'
+            AND f2.rating = 'down'
+        )
+      ORDER BY ups DESC
+      LIMIT 50
+    `).all(minUps);
+        return rows.map((r) => ({ blockId: r.block_id, question: r.question, ups: r.ups }));
+    }
+    meta(key) {
+        const row = this.db.prepare('SELECT value FROM kg_meta WHERE key = ?').get(key);
+        return row?.value ?? null;
+    }
+    close() {
+        this.db.close();
+    }
+}
+function rowToNode(row) {
+    return {
+        nodeId: row.node_id,
+        kind: row.kind,
+        name: row.name,
+        domain: row.domain ?? undefined,
+        status: row.status ?? undefined,
+        owner: row.owner ?? undefined,
+        description: row.description ?? undefined,
+        llmContext: row.llm_context ?? undefined,
+        tags: safeJSON(row.tags_json, []),
+        examples: safeJSON(row.examples_json, []),
+        sourcePath: row.source_path ?? undefined,
+        gitSha: row.git_sha ?? undefined,
+    };
+}
+function safeJSON(raw, fallback) {
+    if (!raw)
+        return fallback;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return fallback;
+    }
+}
+/**
+ * Defang FTS5 query syntax we don't trust from arbitrary user input.
+ * Allows AND/OR/NOT/quotes/parens and column-prefix syntax (`name:foo`).
+ * Strips anything else to whitespace, then collapses.
+ */
+function sanitizeFtsQuery(raw) {
+    // Drop characters FTS5 might interpret as operators we don't want exposed,
+    // except for quotes (allows phrase search) and a couple of column scopers.
+    const cleaned = raw
+        .replace(/[*]/g, ' ') // strip wildcard injection
+        .replace(/\s+/g, ' ')
+        .trim();
+    if (!cleaned)
+        return '';
+    // If no quotes and no boolean keyword, fall back to a tokenized OR query
+    // for better recall — FTS5 default is implicit AND.
+    if (!/["()]|\b(AND|OR|NOT|NEAR)\b/.test(cleaned)) {
+        return cleaned
+            .split(/\s+/)
+            .map((t) => t.replace(/[^\w]/g, ''))
+            .filter(Boolean)
+            .join(' OR ');
+    }
+    return cleaned;
+}
+//# sourceMappingURL=sqlite-fts.js.map

package/dist/kg/sqlite-fts.js.map

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

package/dist/kg/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Knowledge graph node + edge shapes for the DQL agent.
+ *
+ * The KG is built from the compiled `dql-manifest.json` (blocks, dashboards,
+ * apps, metrics, dimensions, sources) plus dbt manifest data and the project's
+ * Skills folder. It is stored in SQLite at `.dql/cache/agent-kg.sqlite` with
+ * an FTS5 index for keyword search and structured filters for domain/kind.
+ */
+export type KGNodeKind = 'block' | 'metric' | 'dimension' | 'domain' | 'dbt_model' | 'dbt_source' | 'dashboard' | 'app' | 'skill';
+export interface KGNode {
+    /** Stable identifier — `${kind}:${name}` (lower-cased). */
+    nodeId: string;
+    kind: KGNodeKind;
+    name: string;
+    domain?: string;
+    status?: string;
+    owner?: string;
+    description?: string;
+    tags?: string[];
+    /** Free-form natural-language context for the LLM (block.llmContext, skill body, etc.). */
+    llmContext?: string;
+    /** Question/SQL pairs the agent can few-shot on. */
+    examples?: Array<{
+        question: string;
+        sql?: string;
+    }>;
+    /** Path on disk so the UI can deep-link. */
+    sourcePath?: string;
+    /** Pinned git SHA at index time. */
+    gitSha?: string;
+}
+export interface KGEdge {
+    src: string;
+    dst: string;
+    kind: 'feeds_into' | 'reads_from' | 'aggregates' | 'visualizes' | 'depends_on' | 'contains' | 'related_to';
+    weight?: number;
+}
+export interface KGSearchHit {
+    node: KGNode;
+    /** BM25-derived score (lower is better in raw FTS5; we expose 1/(1+rank) so higher is better). */
+    score: number;
+    /** Match snippets per field, useful for UI surfacing. */
+    snippet?: string;
+}
+export interface KGFeedbackRow {
+    id: string;
+    ts: string;
+    user: string;
+    question: string;
+    answerKind: 'certified' | 'uncertified';
+    blockId?: string;
+    rating: 'up' | 'down';
+    comment?: string;
+}
+export interface KGSearchOptions {
+    query: string;
+    /** Restrict to specific kinds. Defaults to all. */
+    kinds?: KGNodeKind[];
+    /** Restrict to a domain. */
+    domain?: string;
+    /** Maximum hits to return. */
+    limit?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/kg/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/kg/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,WAAW,GACX,KAAK,GACL,OAAO,CAAC;AAEZ,MAAM,WAAW,MAAM;IACrB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,YAAY,CAAC;IAC3G,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,WAAW,GAAG,aAAa,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/kg/types.js

@@ -0,0 +1,10 @@
+/**
+ * Knowledge graph node + edge shapes for the DQL agent.
+ *
+ * The KG is built from the compiled `dql-manifest.json` (blocks, dashboards,
+ * apps, metrics, dimensions, sources) plus dbt manifest data and the project's
+ * Skills folder. It is stored in SQLite at `.dql/cache/agent-kg.sqlite` with
+ * an FTS5 index for keyword search and structured filters for domain/kind.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/kg/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/kg/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/providers/claude.d.ts

@@ -0,0 +1,21 @@
+import type { AgentProvider, AgentMessage, ProviderRunOptions } from './types.js';
+/**
+ * Anthropic Claude provider via the Messages API. Reads ANTHROPIC_API_KEY.
+ *
+ * We deliberately avoid `@anthropic-ai/sdk` to keep dql-agent zero-dep —
+ * the existing `apps/cli/src/llm/providers/claude-agent-sdk.ts` already
+ * uses the SDK for the chat-cell agent loop, and that's a different layer.
+ * Here we want a simple "generate from a message list" surface.
+ */
+export declare class ClaudeProvider implements AgentProvider {
+    readonly name: "claude";
+    private readonly apiKey?;
+    private readonly defaultModel;
+    constructor(opts?: {
+        apiKey?: string;
+        model?: string;
+    });
+    available(): Promise<boolean>;
+    generate(messages: AgentMessage[], options?: ProviderRunOptions): Promise<string>;
+}
+//# sourceMappingURL=claude.d.ts.map

package/dist/providers/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/providers/claude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAKpD,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAI7B,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;CAoC5F"}

package/dist/providers/claude.js

@@ -0,0 +1,56 @@
+/**
+ * Anthropic Claude provider via the Messages API. Reads ANTHROPIC_API_KEY.
+ *
+ * We deliberately avoid `@anthropic-ai/sdk` to keep dql-agent zero-dep —
+ * the existing `apps/cli/src/llm/providers/claude-agent-sdk.ts` already
+ * uses the SDK for the chat-cell agent loop, and that's a different layer.
+ * Here we want a simple "generate from a message list" surface.
+ */
+export class ClaudeProvider {
+    name = 'claude';
+    apiKey;
+    defaultModel;
+    constructor(opts = {}) {
+        this.apiKey = opts.apiKey ?? process.env.ANTHROPIC_API_KEY;
+        this.defaultModel = opts.model ?? 'claude-opus-4-7';
+    }
+    async available() {
+        return Boolean(this.apiKey);
+    }
+    async generate(messages, options = {}) {
+        if (!this.apiKey) {
+            throw new Error('claude: ANTHROPIC_API_KEY is not set');
+        }
+        const system = messages.filter((m) => m.role === 'system').map((m) => m.content).join('\n\n');
+        const turns = messages
+            .filter((m) => m.role !== 'system')
+            .map((m) => ({ role: m.role, content: m.content }));
+        const res = await fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: {
+                'x-api-key': this.apiKey,
+                'anthropic-version': '2023-06-01',
+                'content-type': 'application/json',
+            },
+            body: JSON.stringify({
+                model: options.model ?? this.defaultModel,
+                max_tokens: options.maxTokens ?? 1024,
+                temperature: options.temperature ?? 0.2,
+                system: system || undefined,
+                messages: turns,
+            }),
+            signal: options.signal,
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => res.statusText);
+            throw new Error(`claude: ${res.status} ${body}`);
+        }
+        const json = (await res.json());
+        const blocks = json.content ?? [];
+        return blocks
+            .filter((b) => b.type === 'text')
+            .map((b) => b.text ?? '')
+            .join('');
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/providers/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/providers/claude.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,QAAiB,CAAC;IACjB,MAAM,CAAU;IAChB,YAAY,CAAS;IAEtC,YAAY,OAA4C,EAAE;QACxD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC3D,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,IAAI,iBAAiB,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAwB,EAAE,UAA8B,EAAE;QACvE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9F,MAAM,KAAK,GAAG,QAAQ;aACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;aAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAEtD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,uCAAuC,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,WAAW,EAAE,IAAI,CAAC,MAAM;gBACxB,mBAAmB,EAAE,YAAY;gBACjC,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY;gBACzC,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;gBACrC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,GAAG;gBACvC,MAAM,EAAE,MAAM,IAAI,SAAS;gBAC3B,QAAQ,EAAE,KAAK;aAChB,CAAC;YACF,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAyD,CAAC;QACxF,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QAClC,OAAO,MAAM;aACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;aACxB,IAAI,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;CACF"}

package/dist/providers/gemini.d.ts

@@ -0,0 +1,18 @@
+import type { AgentProvider, AgentMessage, ProviderRunOptions } from './types.js';
+/**
+ * Google Gemini provider via the v1beta REST surface. Reads GEMINI_API_KEY.
+ * Maps system messages by prepending them to the first user turn since
+ * Gemini's API doesn't have a first-class system role.
+ */
+export declare class GeminiProvider implements AgentProvider {
+    readonly name: "gemini";
+    private readonly apiKey?;
+    private readonly defaultModel;
+    constructor(opts?: {
+        apiKey?: string;
+        model?: string;
+    });
+    available(): Promise<boolean>;
+    generate(messages: AgentMessage[], options?: ProviderRunOptions): Promise<string>;
+}
+//# sourceMappingURL=gemini.d.ts.map

package/dist/providers/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/providers/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAKpD,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAI7B,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;CA4C5F"}