@duckcodeailabs/dql-cli 1.4.4 → 1.5.1

package/dist/commands/validate.js

@@ -0,0 +1,163 @@
+import { readdirSync, readFileSync, existsSync, statSync } from 'node:fs';
+import { dirname, extname, join, relative, resolve } from 'node:path';
+import { Parser, analyze, loadSemanticLayerFromDir } from '@duckcodeailabs/dql-core';
+function normalizePath(path) {
+    return path.replaceAll('\\', '/');
+}
+function findProjectRoot(startPath) {
+    let current = existsSync(startPath) && statSync(startPath).isFile() ? dirname(startPath) : startPath;
+    while (true) {
+        if (existsSync(join(current, 'dql.config.json')) || existsSync(join(current, 'blocks')) || existsSync(join(current, 'semantic-layer'))) {
+            return current;
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            return startPath;
+        current = parent;
+    }
+}
+function collectDqlFilesFromDir(dirPath, projectRoot) {
+    if (!existsSync(dirPath))
+        return [];
+    const files = [];
+    for (const entry of readdirSync(dirPath, { withFileTypes: true })) {
+        const entryPath = join(dirPath, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...collectDqlFilesFromDir(entryPath, projectRoot));
+        }
+        else if (entry.isFile() && extname(entry.name) === '.dql') {
+            files.push({
+                filePath: entryPath,
+                relativePath: normalizePath(relative(projectRoot, entryPath)),
+            });
+        }
+    }
+    return files;
+}
+function collectValidationFiles(targetPath) {
+    const target = resolve(targetPath ?? '.');
+    const projectRoot = findProjectRoot(target);
+    if (existsSync(target)) {
+        const targetStat = statSync(target);
+        if (targetStat.isFile()) {
+            return {
+                projectRoot,
+                files: extname(target) === '.dql'
+                    ? [{ filePath: target, relativePath: normalizePath(relative(projectRoot, target)) }]
+                    : [],
+            };
+        }
+        if (targetStat.isDirectory() && target !== projectRoot) {
+            return {
+                projectRoot,
+                files: collectDqlFilesFromDir(target, projectRoot),
+            };
+        }
+    }
+    const dirs = ['blocks', 'dashboards', 'workbooks'];
+    return {
+        projectRoot,
+        files: dirs.flatMap((dir) => collectDqlFilesFromDir(join(projectRoot, dir), projectRoot)),
+    };
+}
+export async function runValidate(path, flags) {
+    const { projectRoot, files } = collectValidationFiles(path);
+    const diagnostics = [];
+    // Load semantic layer if present
+    let semanticLayer;
+    const semanticDir = join(projectRoot, 'semantic-layer');
+    if (existsSync(semanticDir)) {
+        try {
+            semanticLayer = loadSemanticLayerFromDir(semanticDir);
+        }
+        catch (err) {
+            diagnostics.push({
+                file: 'semantic-layer/',
+                severity: 'error',
+                message: `Failed to load semantic layer: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    }
+    for (const { filePath, relativePath } of files) {
+        try {
+            const source = readFileSync(filePath, 'utf-8');
+            const parser = new Parser(source, relativePath);
+            const ast = parser.parse();
+            // Run semantic analysis
+            try {
+                const diags = analyze(ast);
+                for (const diag of diags) {
+                    diagnostics.push({
+                        file: relativePath,
+                        severity: diag.severity === 'error' ? 'error' : 'warning',
+                        message: diag.message,
+                        line: diag.span?.start?.line,
+                    });
+                }
+            }
+            catch {
+                // analyze may throw on some inputs
+            }
+            // Check semantic block metric references
+            for (const stmt of ast.statements) {
+                if (stmt.kind !== 'BlockDecl')
+                    continue;
+                const block = stmt;
+                if (block.blockType === 'semantic' && block.metricRef) {
+                    if (semanticLayer) {
+                        const composed = semanticLayer.composeQuery({
+                            metrics: [block.metricRef],
+                            dimensions: [],
+                        });
+                        if (!composed) {
+                            diagnostics.push({
+                                file: relativePath,
+                                severity: 'error',
+                                message: `Metric "${block.metricRef}" referenced in block "${block.name}" not found in semantic layer`,
+                            });
+                        }
+                    }
+                    else {
+                        diagnostics.push({
+                            file: relativePath,
+                            severity: 'warning',
+                            message: `Semantic block "${block.name}" references metric "${block.metricRef}" but no semantic-layer/ directory exists`,
+                        });
+                    }
+                }
+            }
+        }
+        catch (err) {
+            diagnostics.push({
+                file: relativePath,
+                severity: 'error',
+                message: `Parse error: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    }
+    const fileCount = files.length;
+    // Output
+    const errors = diagnostics.filter((d) => d.severity === 'error');
+    const warnings = diagnostics.filter((d) => d.severity === 'warning');
+    if (flags.format === 'json') {
+        console.log(JSON.stringify({ files: fileCount, diagnostics }, null, 2));
+    }
+    else {
+        console.log(`\n  Validated ${fileCount} DQL file(s)\n`);
+        if (diagnostics.length === 0) {
+            console.log('  All files are valid.\n');
+        }
+        else {
+            for (const d of diagnostics) {
+                const loc = d.line ? `:${d.line}` : '';
+                const icon = d.severity === 'error' ? 'ERROR' : 'WARN';
+                console.log(`  ${icon} ${d.file}${loc}: ${d.message}`);
+            }
+            console.log(`\n  ${errors.length} error(s), ${warnings.length} warning(s)\n`);
+        }
+    }
+    if (errors.length > 0) {
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

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

package/dist/commands/validate.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validate.test.d.ts.map

package/dist/commands/validate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.test.d.ts","sourceRoot":"","sources":["../../src/commands/validate.test.ts"],"names":[],"mappings":""}

package/dist/commands/validate.test.js

@@ -0,0 +1,55 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { mkdtempSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { runValidate } from './validate.js';
+const tempDirs = [];
+afterEach(() => {
+    vi.restoreAllMocks();
+    process.exitCode = undefined;
+    while (tempDirs.length > 0) {
+        const dir = tempDirs.pop();
+        if (dir)
+            rmSync(dir, { recursive: true, force: true });
+    }
+});
+function tempProject() {
+    const dir = mkdtempSync(join(tmpdir(), 'dql-validate-'));
+    tempDirs.push(dir);
+    writeFileSync(join(dir, 'dql.config.json'), JSON.stringify({ version: 1, name: 'validate-test' }));
+    return dir;
+}
+function writeValidBlock(path) {
+    writeFileSync(path, `block "Monthly Revenue" {
+    domain = "finance"
+    type = "custom"
+    status = "certified"
+    query = """
+      SELECT 1 AS revenue
+    """
+  }
+`);
+}
+describe('runValidate', () => {
+    it('recursively validates domain-scoped DQL files in a project folder', async () => {
+        const root = tempProject();
+        mkdirSync(join(root, 'blocks', 'finance'), { recursive: true });
+        writeValidBlock(join(root, 'blocks', 'finance', 'monthly_revenue.dql'));
+        const log = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await runValidate(root, { format: 'text' });
+        expect(log.mock.calls.map((call) => call.join(' ')).join('\n')).toContain('Validated 1 DQL file(s)');
+        expect(process.exitCode).toBeUndefined();
+    });
+    it('validates a nested single file while loading project-level context', async () => {
+        const root = tempProject();
+        mkdirSync(join(root, 'blocks', 'finance'), { recursive: true });
+        const blockPath = join(root, 'blocks', 'finance', 'monthly_revenue.dql');
+        writeValidBlock(blockPath);
+        const log = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await runValidate(blockPath, { format: 'json' });
+        const payload = JSON.parse(String(log.mock.calls.at(-1)?.[0]));
+        expect(payload.files).toBe(1);
+        expect(payload.diagnostics).toEqual([]);
+    });
+});
+//# sourceMappingURL=validate.test.js.map

package/dist/commands/validate.test.js.map

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

package/{index.js → dist/index.js}

@@ -28,6 +28,7 @@ import { runSchedule } from './commands/schedule.js';
 import { runAgent } from './commands/agent.js';
 import { runSlack } from './commands/slack.js';
 import { runVerify } from './commands/verify.js';
+import { runImport } from './commands/import.js';
 const HELP = `
   dql — DQL CLI
 
@@ -45,6 +46,7 @@ const HELP = `
     dql info <file.dql>             Show block metadata
     dql migrate <source>            Scaffold migration from looker/tableau/dbt/metabase/raw-sql
     dql migrate format [--check]    Upgrade all .dql/.dqlnb files to canonical format
+    dql import sql <path>           Preview SQL files/folders as draft Block Studio import candidates
     dql fmt <file.dql|.dqlnb>       Format DQL/notebook file in place
     dql diff <path>                 Diff a .dql/.dqlnb file vs HEAD
     dql diff <before> <after>       Semantic diff between two files
@@ -55,7 +57,7 @@ const HELP = `
     dql lineage [block] [path]      Answer-layer lineage analysis
     dql mcp [--http]                Run the DQL MCP server (stdio by default; --http = loopback)
     dql app new|ls|show|build|reindex <name>
-                                    Manage App artifacts (members, roles, RBAC, dashboards, schedules)
+                                    Manage App artifacts (metadata, policies, dashboards, schedules)
     dql schedule list|run|start|status  Local scheduler for @schedule'd blocks (alerts + notifications)
     dql agent ask "<question>"      Block-first agent loop (certified blocks → fallback LLM SQL)
     dql agent reindex               Rebuild .dql/cache/agent-kg.sqlite
@@ -139,6 +141,9 @@ async function main() {
             case 'migrate':
                 await runMigrate(file, flags);
                 break;
+            case 'import':
+                await runImport(file, rest, flags);
+                break;
             case 'fmt':
                 await runFmt(file, flags);
                 break;

package/dist/index.js.map

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

package/{llm → dist/llm}/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AAepB,wBAAgB,SAAS,CAAC,QAAQ,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,CAElE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AAgBpB,wBAAgB,SAAS,CAAC,QAAQ,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,CAElE"}

package/{llm → dist/llm}/index.js

@@ -2,9 +2,9 @@ import { claudeAgentSdkRunner } from './providers/claude-agent-sdk.js';
 import { claudeCodeRunner } from './providers/claude-code.js';
 import { createDqlAgentProviderRunner } from './providers/dql-agent-provider.js';
 /**
- * Registry of available LLM providers. Claude keeps the tool-use loop; the
- * OpenAI/Gemini/Ollama adapters reuse `@duckcodeailabs/dql-agent` providers
- * and emit the same AgentTurn SSE envelope for notebook Chat.
+ * Registry of available LLM providers. Notebook and App chat default to the
+ * Settings-resolved DQL agent providers. Claude Agent SDK / Claude Code remain
+ * explicit experimental runners for MCP-oriented workflows.
  */
 const RUNNERS = {
     'claude-agent-sdk': claudeAgentSdkRunner,
@@ -12,6 +12,7 @@ const RUNNERS = {
     openai: createDqlAgentProviderRunner('openai'),
     gemini: createDqlAgentProviderRunner('gemini'),
     ollama: createDqlAgentProviderRunner('ollama'),
+    'custom-openai': createDqlAgentProviderRunner('custom-openai'),
 };
 export function getRunner(provider) {
     return RUNNERS[provider] ?? null;

package/{llm → dist/llm}/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAajF;;;;GAIG;AACH,MAAM,OAAO,GAAoC;IAC/C,kBAAkB,EAAE,oBAAoB;IACxC,aAAa,EAAE,gBAAgB;IAC/B,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC;IAC9C,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC;IAC9C,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC;CAC/C,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,QAAoB;IAC5C,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AACnC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAajF;;;;GAIG;AACH,MAAM,OAAO,GAAoC;IAC/C,kBAAkB,EAAE,oBAAoB;IACxC,aAAa,EAAE,gBAAgB;IAC/B,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC;IAC9C,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC;IAC9C,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC;IAC9C,eAAe,EAAE,4BAA4B,CAAC,eAAe,CAAC;CAC/D,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,QAAoB;IAC5C,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AACnC,CAAC"}

package/{llm → dist/llm}/providers/dql-agent-provider.d.ts

@@ -1,5 +1,5 @@
 import type { AgentRunner, ProviderId } from '../types.js';
-type SimpleProviderId = Extract<ProviderId, 'openai' | 'gemini' | 'ollama'>;
+type SimpleProviderId = Extract<ProviderId, 'openai' | 'gemini' | 'ollama' | 'custom-openai'>;
 export declare function createDqlAgentProviderRunner(id: SimpleProviderId): AgentRunner;
 export {};
 //# sourceMappingURL=dql-agent-provider.d.ts.map

package/dist/llm/providers/dql-agent-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dql-agent-provider.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/dql-agent-provider.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAmB,WAAW,EAA4B,UAAU,EAAE,MAAM,aAAa,CAAC;AAGtG,KAAK,gBAAgB,GAAG,OAAO,CAAC,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,eAAe,CAAC,CAAC;AAmE9F,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,gBAAgB,GAAG,WAAW,CAmE9E"}

package/dist/llm/providers/dql-agent-provider.js

@@ -0,0 +1,287 @@
+import { KGStore, MemoryStore, defaultKgPath, defaultMemoryPath, GeminiProvider, OllamaProvider, OpenAIProvider, answer, loadSkills, reindexProject, } from '@duckcodeailabs/dql-agent';
+import { existsSync } from 'node:fs';
+import { getEffectiveProviderConfig } from '../../settings/provider-settings.js';
+const SPECS = {
+    openai: {
+        label: 'OpenAI',
+        setup: 'Configure OpenAI in Settings or set OPENAI_API_KEY. Optional: OPENAI_MODEL and OPENAI_BASE_URL.',
+        create: (projectRoot) => {
+            const config = getEffectiveProviderConfig(projectRoot, 'openai');
+            return new OpenAIProvider({ apiKey: config.apiKey, model: config.model, baseUrl: config.baseUrl });
+        },
+    },
+    gemini: {
+        label: 'Gemini',
+        setup: 'Configure Gemini in Settings or set GEMINI_API_KEY. Optional: GEMINI_MODEL.',
+        create: (projectRoot) => {
+            const config = getEffectiveProviderConfig(projectRoot, 'gemini');
+            return new GeminiProvider({ apiKey: config.apiKey, model: config.model });
+        },
+    },
+    ollama: {
+        label: 'Ollama',
+        setup: 'Start Ollama and configure OLLAMA_BASE_URL / OLLAMA_MODEL in Settings or env.',
+        create: (projectRoot) => {
+            const config = getEffectiveProviderConfig(projectRoot, 'ollama');
+            return new OllamaProvider({ model: config.model, baseUrl: config.baseUrl });
+        },
+    },
+    'custom-openai': {
+        label: 'Custom OpenAI-compatible',
+        setup: 'Configure a custom OpenAI-compatible endpoint in Settings with base URL, model, and optional API key.',
+        create: (projectRoot) => {
+            const config = getEffectiveProviderConfig(projectRoot, 'custom-openai');
+            return new OpenAIProvider({ apiKey: config.apiKey, model: config.model, baseUrl: config.baseUrl, allowNoApiKey: true });
+        },
+    },
+};
+function emitProposalFromText(text, emit) {
+    const match = text.match(/DQL_BLOCK_PROPOSAL\s*[:=]?\s*(\{[\s\S]*\})\s*$/);
+    if (!match)
+        return;
+    try {
+        const raw = JSON.parse(match[1]);
+        if (!raw.name || !raw.sql)
+            return;
+        emit({
+            kind: 'proposal',
+            proposal: {
+                name: String(raw.name),
+                domain: String(raw.domain ?? ''),
+                owner: String(raw.owner ?? ''),
+                description: String(raw.description ?? ''),
+                sql: String(raw.sql),
+                tags: Array.isArray(raw.tags) ? raw.tags.map(String) : undefined,
+                chartType: typeof raw.chartType === 'string' ? raw.chartType : undefined,
+            },
+            governance: { certified: false, errors: [], warnings: ['Generated by a non-tool provider; review before saving.'] },
+        });
+    }
+    catch {
+        // Ignore malformed proposal text. The visible assistant response still streams as text.
+    }
+}
+export function createDqlAgentProviderRunner(id) {
+    return {
+        async run(req, emit, signal) {
+            const spec = SPECS[id];
+            const provider = spec.create(req.projectRoot);
+            const available = await provider.available().catch(() => false);
+            if (!available) {
+                emit({ kind: 'error', message: `${spec.label} is not configured or reachable. ${spec.setup}` });
+                return;
+            }
+            try {
+                emit({ kind: 'thinking', text: `Using ${spec.label} through the governed DQL agent.` });
+                const kgPath = defaultKgPath(req.projectRoot);
+                if (!existsSync(kgPath)) {
+                    emit({ kind: 'thinking', text: 'Building the local agent knowledge graph from blocks, apps, dashboards, dbt, and semantic metadata.' });
+                    await reindexProject(req.projectRoot, { kgPath });
+                }
+                const question = lastUserMessage(req);
+                if (!question) {
+                    emit({ kind: 'error', message: 'No user question found.' });
+                    return;
+                }
+                const memory = new MemoryStore(defaultMemoryPath(req.projectRoot));
+                const kg = new KGStore(kgPath);
+                try {
+                    const memoryContext = memory.search({
+                        query: question,
+                        scopes: ['thread', 'notebook', 'project', 'user', 'artifact'],
+                        scopeId: req.upstream?.cellId,
+                        limit: 6,
+                    });
+                    const skills = loadSkills(req.projectRoot).skills;
+                    const blockHints = inferFollowUpBlockHints(req, question);
+                    const result = await answer({
+                        question,
+                        extraContext: renderExtraContext(req, blockHints),
+                        provider,
+                        kg,
+                        skills,
+                        blockHints,
+                        memoryContext,
+                        signal,
+                        executeCertifiedBlock: req.executeCertifiedBlock,
+                    });
+                    emit({ kind: 'tool_result', id: 'governed_answer', output: result });
+                    emit({ kind: 'text', text: formatAgentAnswer(result) });
+                    if (result.proposedSql) {
+                        emitDraftProposal(result, question, emit);
+                    }
+                    else {
+                        emitProposalFromText(result.text, emit);
+                    }
+                    persistThreadMemory(memory, req, question, result);
+                }
+                finally {
+                    kg.close();
+                    memory.close();
+                }
+                emit({ kind: 'done', stopReason: 'stop' });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                const setupHint = shouldShowProviderSetupHint(message) ? ` ${spec.setup}` : '';
+                emit({ kind: 'error', message: `${spec.label} failed: ${message}.${setupHint}` });
+            }
+        },
+    };
+}
+function shouldShowProviderSetupHint(message) {
+    return /api key|not configured|not reachable|connection refused|ECONNREFUSED|fetch failed|network error|model .*not found/i
+        .test(message);
+}
+function lastUserMessage(req) {
+    for (let i = req.messages.length - 1; i >= 0; i--) {
+        const msg = req.messages[i];
+        if (msg.role === 'user' && msg.content.trim())
+            return msg.content.trim();
+    }
+    return '';
+}
+function renderExtraContext(req, blockHints) {
+    const parts = [];
+    if (req.upstream?.sql)
+        parts.push(`Current upstream SQL:\n${req.upstream.sql}`);
+    if (blockHints.length > 0) {
+        parts.push(`Follow-up context: the user is referring to certified block "${blockHints[0]}".`);
+    }
+    return parts.length > 0 ? parts.join('\n\n') : undefined;
+}
+function inferFollowUpBlockHints(req, question) {
+    if (!isGenericFollowUp(question))
+        return [];
+    for (let i = req.messages.length - 1; i >= 0; i--) {
+        const msg = req.messages[i];
+        if (msg.role !== 'assistant')
+            continue;
+        const fromAnswer = msg.content.match(/Answered by certified block \*\*([^*]+)\*\*/i)?.[1];
+        const fromCitation = msg.content.match(/^- block:\s*([A-Za-z0-9_.-]+)/im)?.[1];
+        const block = fromAnswer ?? fromCitation;
+        if (block)
+            return [block.trim()];
+    }
+    return [];
+}
+const GENERIC_FOLLOW_UP_WORDS = new Set([
+    'a', 'about', 'again', 'all', 'also', 'and', 'as', 'be', 'block', 'can', 'could', 'data', 'do',
+    'execute', 'for', 'from', 'get', 'give', 'import', 'it', 'its', 'let', 'lets', 'me', 'metrics',
+    'more', 'now', 'of', 'output', 'please', 'result', 'results', 'run', 'show', 'solution', 'summary',
+    'that', 'the', 'them', 'this', 'to', 'use', 'with', 'you',
+]);
+function isGenericFollowUp(question) {
+    const lower = question.toLowerCase();
+    if (!/\b(block|data|execute|import|it|result|results|run|solution|that|this)\b/.test(lower))
+        return false;
+    const tokens = lower.match(/[a-z0-9_]+/g) ?? [];
+    const meaningful = tokens.filter((token) => token.length > 1 && !GENERIC_FOLLOW_UP_WORDS.has(token));
+    return meaningful.length === 0;
+}
+function formatAgentAnswer(result) {
+    const badge = result.certification === 'certified'
+        ? 'Certified'
+        : result.sourceTier === 'semantic_layer'
+            ? 'AI generated from semantic layer - analyst review required'
+            : result.kind === 'no_answer'
+                ? 'No answer'
+                : 'AI generated from dbt manifest - analyst review required';
+    const citations = result.citations.length > 0
+        ? '\n\nCitations:\n' + result.citations.map((c) => `- ${c.kind}: ${c.name}${c.provenance ? ` (${c.provenance})` : ''}`).join('\n')
+        : '';
+    const resultPreview = formatResultPreview(result.result);
+    const sql = result.proposedSql ? `\n\nProposed SQL:\n\`\`\`sql\n${result.proposedSql}\n\`\`\`` : '';
+    return `[${badge}]\n\n${result.text}${resultPreview}${citations}${sql}`;
+}
+function formatResultPreview(result) {
+    if (!result)
+        return '';
+    const columns = normalizeColumns(result.columns).slice(0, 8);
+    const rows = Array.isArray(result.rows) ? result.rows.slice(0, 8) : [];
+    const shown = rows.length;
+    const timing = typeof result.executionTime === 'number' && result.executionTime > 0
+        ? ` in ${Math.round(result.executionTime)} ms`
+        : '';
+    if (columns.length === 0 || rows.length === 0) {
+        return `\n\nResults: ${result.rowCount} row${result.rowCount === 1 ? '' : 's'}${timing}.`;
+    }
+    const tableRows = rows.map((row) => {
+        const record = row && typeof row === 'object' ? row : {};
+        return `| ${columns.map((col) => formatCell(record[col])).join(' | ')} |`;
+    });
+    const omittedRows = result.rowCount > shown ? ` Showing first ${shown} rows.` : '';
+    return [
+        `\n\nResults: ${result.rowCount} row${result.rowCount === 1 ? '' : 's'}${timing}.${omittedRows}`,
+        `| ${columns.map(escapeMarkdownTable).join(' | ')} |`,
+        `| ${columns.map(() => '---').join(' | ')} |`,
+        ...tableRows,
+    ].join('\n');
+}
+function normalizeColumns(columns) {
+    return columns.map((column) => {
+        if (typeof column === 'string')
+            return column;
+        if (column && typeof column === 'object' && typeof column.name === 'string') {
+            return column.name;
+        }
+        return String(column);
+    });
+}
+function formatCell(value) {
+    if (value === null || typeof value === 'undefined')
+        return '';
+    const raw = typeof value === 'object' ? JSON.stringify(value) : String(value);
+    return escapeMarkdownTable(raw.length > 80 ? `${raw.slice(0, 77)}...` : raw);
+}
+function escapeMarkdownTable(value) {
+    return value.replace(/\|/g, '\\|').replace(/\r?\n/g, ' ');
+}
+function emitDraftProposal(result, question, emit) {
+    const proposal = {
+        name: slugify(question).slice(0, 56) || 'ai_generated_analysis',
+        domain: '',
+        owner: `${process.env.USER ?? 'analyst'}@local`,
+        description: result.text.slice(0, 240),
+        sql: result.proposedSql,
+        tags: ['ai-generated', 'needs-review', result.sourceTier ?? 'dbt_manifest'],
+        chartType: result.suggestedViz,
+    };
+    emit({
+        kind: 'proposal',
+        proposal,
+        governance: {
+            certified: false,
+            errors: [],
+            warnings: ['AI generated. Analyst review and certification are required before reuse as governed content.'],
+        },
+    });
+}
+function persistThreadMemory(memory, req, question, result) {
+    const cellId = req.upstream?.cellId;
+    if (!cellId)
+        return;
+    memory.upsert({
+        id: `thread:${cellId}`,
+        scope: 'thread',
+        scopeId: cellId,
+        title: 'Notebook chat summary',
+        content: [
+            `Latest question: ${question}`,
+            `Latest route: ${result.sourceTier ?? 'unknown'} / ${result.certification ?? 'unknown'}`,
+            `Latest answer: ${result.text.slice(0, 500)}`,
+        ].join('\n'),
+        tags: ['chat', result.sourceTier ?? 'unknown', result.certification ?? 'unknown'],
+        source: 'notebook-chat',
+        confidence: result.confidence ?? 0.5,
+        importance: 0.45,
+    });
+}
+function slugify(input) {
+    return input
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        .replace(/_{2,}/g, '_');
+}
+//# sourceMappingURL=dql-agent-provider.js.map