@duckcodeailabs/dql-cli 1.4.3 → 1.5.0

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

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

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

package/dist/llm/tools.d.ts

@@ -0,0 +1,9 @@
+import { DQLContext } from '@duckcodeailabs/dql-mcp';
+export interface AgentTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    run(args: unknown): Promise<unknown>;
+}
+export declare function buildAgentTools(ctx: DQLContext): AgentTool[];
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/llm/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAQX,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC;AAuED,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,EAAE,CA+C5D"}

package/dist/llm/tools.js

@@ -0,0 +1,112 @@
+import { searchBlocks, getBlock, listMetrics, listDimensions, lineageImpact, certify, suggestBlock, } from '@duckcodeailabs/dql-mcp';
+const SEARCH_BLOCKS_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        query: { type: 'string', description: 'Substring matched against name, description, or tags.' },
+        domain: { type: 'string', description: 'Filter to a single business domain.' },
+        status: {
+            type: 'string',
+            enum: ['draft', 'review', 'certified', 'deprecated', 'pending_recertification'],
+            description: 'Filter by certification status.',
+        },
+        limit: { type: 'number', description: 'Max results (default 50).' },
+    },
+};
+const GET_BLOCK_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['name'],
+    properties: {
+        name: { type: 'string', description: 'Block name (as shown in search_blocks).' },
+        includeSource: { type: 'boolean', description: 'Include full .dql source text. Default true.' },
+    },
+};
+const DOMAIN_FILTER_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        domain: { type: 'string', description: 'Filter to a single domain.' },
+    },
+};
+const LINEAGE_IMPACT_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['focus'],
+    properties: {
+        focus: { type: 'string', description: 'Node id ("block:revenue") or bare name.' },
+        upstreamDepth: { type: 'number' },
+        downstreamDepth: { type: 'number' },
+        paths: { type: 'boolean', description: 'Include full source→leaf paths (slower on large graphs).' },
+    },
+};
+const CERTIFY_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['name'],
+    properties: {
+        name: { type: 'string', description: 'Block name to certify.' },
+    },
+};
+const SUGGEST_BLOCK_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['name', 'domain', 'owner', 'description', 'sql'],
+    properties: {
+        name: { type: 'string', description: 'Proposed block name (kebab_case).' },
+        domain: { type: 'string', description: 'Business domain (finance, product, …).' },
+        owner: { type: 'string', description: 'Block owner identity (email or team handle).' },
+        description: { type: 'string', description: 'One-line description.' },
+        sql: { type: 'string', description: 'The block body SQL.' },
+        tags: { type: 'array', items: { type: 'string' } },
+        chartType: { type: 'string', description: 'Optional visualization type.' },
+    },
+};
+export function buildAgentTools(ctx) {
+    return [
+        {
+            name: 'search_blocks',
+            description: 'Find certified DQL blocks by keyword, domain, or status.',
+            inputSchema: SEARCH_BLOCKS_SCHEMA,
+            run: async (args) => searchBlocks(ctx, args),
+        },
+        {
+            name: 'get_block',
+            description: 'Return full metadata, dependencies, and SQL for a block.',
+            inputSchema: GET_BLOCK_SCHEMA,
+            run: async (args) => getBlock(ctx, args),
+        },
+        {
+            name: 'list_metrics',
+            description: 'List semantic-layer metrics, optionally filtered by domain.',
+            inputSchema: DOMAIN_FILTER_SCHEMA,
+            run: async (args) => listMetrics(ctx, args),
+        },
+        {
+            name: 'list_dimensions',
+            description: 'List semantic-layer dimensions, optionally filtered by domain.',
+            inputSchema: DOMAIN_FILTER_SCHEMA,
+            run: async (args) => listDimensions(ctx, args),
+        },
+        {
+            name: 'lineage_impact',
+            description: 'Return upstream/downstream lineage for a block, metric, or model.',
+            inputSchema: LINEAGE_IMPACT_SCHEMA,
+            run: async (args) => lineageImpact(ctx, args),
+        },
+        {
+            name: 'certify',
+            description: 'Run governance rules against a block and report pass/fail.',
+            inputSchema: CERTIFY_SCHEMA,
+            run: async (args) => certify(ctx, args),
+        },
+        {
+            name: 'suggest_block',
+            description: 'Write a proposed block to blocks/_drafts/ and return governance results. ' +
+                'Use this at the end of a conversation to hand the user a reviewable draft.',
+            inputSchema: SUGGEST_BLOCK_SCHEMA,
+            run: async (args) => suggestBlock(ctx, args),
+        },
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/dist/llm/tools.js.map

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

package/dist/llm/types.d.ts

@@ -0,0 +1,72 @@
+import type { AgentResultPayload, KGNode } from '@duckcodeailabs/dql-agent';
+export type ProviderId = 'claude-agent-sdk' | 'claude-code' | 'openai' | 'gemini' | 'ollama' | 'custom-openai';
+export interface ChatTurn {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export interface BlockProposal {
+    name: string;
+    domain: string;
+    owner: string;
+    description: string;
+    sql: string;
+    tags?: string[];
+    chartType?: string;
+}
+/**
+ * Normalized event a provider streams back for each step of an agent run.
+ * The UI renders these in order; the final `proposal` (if any) routes through
+ * the governance gate before `/api/blocks/save-from-cell`.
+ */
+export type AgentTurn = {
+    kind: 'thinking';
+    text: string;
+} | {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'tool_call';
+    id: string;
+    name: string;
+    input: unknown;
+} | {
+    kind: 'tool_result';
+    id: string;
+    output: unknown;
+    isError?: boolean;
+} | {
+    kind: 'proposal';
+    proposal: BlockProposal;
+    governance: {
+        certified: boolean;
+        errors: string[];
+        warnings: string[];
+    };
+} | {
+    kind: 'error';
+    message: string;
+} | {
+    kind: 'done';
+    stopReason?: string;
+};
+export interface AgentRunRequest {
+    provider: ProviderId;
+    messages: ChatTurn[];
+    upstream?: {
+        cellId?: string;
+        sql?: string;
+        preview?: unknown;
+    };
+    projectRoot: string;
+    executeCertifiedBlock?: (block: KGNode) => Promise<AgentResultPayload>;
+}
+export interface AgentRunner {
+    run(req: AgentRunRequest, emit: (turn: AgentTurn) => void, signal: AbortSignal): Promise<void>;
+}
+/**
+ * Public-facing name for the adapter contract a provider must implement.
+ * `AgentRunner` is the internal call site; `LLMProvider` is what community
+ * authors target when they add a new `providers/<name>.ts`. Keep in sync.
+ */
+export type LLMProvider = AgentRunner;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAE5E,MAAM,MAAM,UAAU,GAAG,kBAAkB,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,eAAe,CAAC;AAE/G,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,GACvH;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChG;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC"}

package/dist/llm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/llm/types.js.map

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