@reasoningco/infer 0.0.2

package/dist/entity-resolver.js

@@ -0,0 +1,91 @@
+import { InferError } from './errors.js';
+// ── Entity Resolver Registry ──
+export class EntityResolverRegistry {
+    resolvers = new Map();
+    register(name, resolver) {
+        this.resolvers.set(name, resolver);
+    }
+    get(name) {
+        return this.resolvers.get(name);
+    }
+    has(name) {
+        return this.resolvers.has(name);
+    }
+    async resolveAll(entityFilters, tenantId) {
+        const results = [];
+        for (const filter of entityFilters) {
+            const resolver = this.resolvers.get(filter.resolver);
+            if (!resolver) {
+                throw new InferError('ENTITY_NOT_FOUND', 'resolver', `No resolver registered for: ${filter.resolver}`);
+            }
+            const result = await resolver.resolve(filter.input, tenantId);
+            result.outputColumn = filter.outputColumn;
+            results.push(result);
+        }
+        return results;
+    }
+}
+// ── Database-backed Entity Resolver (example implementation) ──
+export class DatabaseEntityResolver {
+    connector;
+    tableName;
+    idColumn;
+    nameColumn;
+    tenantScoped;
+    resolverName;
+    constructor(config) {
+        this.connector = config.connector;
+        this.tableName = config.tableName;
+        this.idColumn = config.idColumn;
+        this.nameColumn = config.nameColumn;
+        this.resolverName = config.resolverName;
+        this.tenantScoped = config.tenantScoped ?? true;
+    }
+    async resolve(input, tenantId) {
+        const trimmed = input.trim();
+        // Try exact match first
+        const exactParams = [trimmed];
+        let exactSql = `SELECT "${this.idColumn}" AS id FROM "${this.tableName}" WHERE LOWER("${this.nameColumn}") = LOWER($1)`;
+        if (this.tenantScoped) {
+            exactSql += ` AND "tenant_id" = $2`;
+            exactParams.push(tenantId);
+        }
+        exactSql += ' LIMIT 5';
+        const exactResult = await this.connector.execute(exactSql, exactParams);
+        if (exactResult.rows.length > 0) {
+            return {
+                resolver: this.resolverName,
+                input: trimmed,
+                outputColumn: '',
+                resolvedIds: exactResult.rows.map(r => String(r.id)),
+                confidence: 'exact',
+            };
+        }
+        // Try contains match
+        const containsParams = [`%${trimmed}%`];
+        let containsSql = `SELECT "${this.idColumn}" AS id FROM "${this.tableName}" WHERE "${this.nameColumn}" ILIKE $1`;
+        if (this.tenantScoped) {
+            containsSql += ` AND "tenant_id" = $2`;
+            containsParams.push(tenantId);
+        }
+        containsSql += ' LIMIT 5';
+        const containsResult = await this.connector.execute(containsSql, containsParams);
+        if (containsResult.rows.length > 0) {
+            return {
+                resolver: this.resolverName,
+                input: trimmed,
+                outputColumn: '',
+                resolvedIds: containsResult.rows.map(r => String(r.id)),
+                confidence: 'contains',
+            };
+        }
+        return {
+            resolver: this.resolverName,
+            input: trimmed,
+            outputColumn: '',
+            resolvedIds: [],
+            confidence: 'none',
+        };
+    }
+}
+//# sourceMappingURL=entity-resolver.js.map

package/dist/entity-resolver.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,10 @@
+export type InferErrorCode = 'INPUT_TOO_LONG' | 'INPUT_PII_DETECTED' | 'INPUT_INJECTION_BLOCKED' | 'LLM_TIMEOUT' | 'LLM_UNAVAILABLE' | 'LLM_INVALID_RESPONSE' | 'PLAN_INVALID' | 'PLAN_SENSITIVE_COLUMN' | 'PLAN_OUT_OF_SCOPE' | 'ENTITY_NOT_FOUND' | 'SQL_VALIDATION_FAILED' | 'QUERY_TIMEOUT' | 'QUERY_ERROR' | 'CONNECTION_ERROR' | 'RATE_LIMITED';
+export type PipelineStage = 'input' | 'planner' | 'validator' | 'resolver' | 'compiler' | 'sql_check' | 'executor';
+export declare class InferError extends Error {
+    readonly code: InferErrorCode;
+    readonly stage: PipelineStage;
+    readonly retryable: boolean;
+    readonly details?: Record<string, unknown>;
+    constructor(code: InferErrorCode, stage: PipelineStage, message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,gBAAgB,GAChB,oBAAoB,GACpB,yBAAyB,GACzB,aAAa,GACb,iBAAiB,GACjB,sBAAsB,GACtB,cAAc,GACd,uBAAuB,GACvB,mBAAmB,GACnB,kBAAkB,GAClB,uBAAuB,GACvB,eAAe,GACf,aAAa,GACb,kBAAkB,GAClB,cAAc,CAAC;AAEnB,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,SAAS,GACT,WAAW,GACX,UAAU,GACV,UAAU,GACV,WAAW,GACX,UAAU,CAAC;AAYf,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGzC,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAcpC"}

package/dist/errors.js

@@ -0,0 +1,28 @@
+// Retry behavior table
+const RETRYABLE_CODES = new Set([
+    'LLM_TIMEOUT', 'LLM_UNAVAILABLE', 'QUERY_TIMEOUT', 'CONNECTION_ERROR', 'RATE_LIMITED'
+]);
+// Security-sensitive errors that must NOT expose details
+const SECURITY_ERROR_CODES = new Set([
+    'PLAN_SENSITIVE_COLUMN', 'SQL_VALIDATION_FAILED', 'INPUT_INJECTION_BLOCKED'
+]);
+export class InferError extends Error {
+    code;
+    stage;
+    retryable;
+    details;
+    constructor(code, stage, message, details) {
+        // Security errors get generic messages - never expose internals
+        const safeMessage = SECURITY_ERROR_CODES.has(code)
+            ? 'The requested data is not available.'
+            : message;
+        super(safeMessage);
+        this.name = 'InferError';
+        this.code = code;
+        this.stage = stage;
+        this.retryable = RETRYABLE_CODES.has(code);
+        // Security errors don't expose details
+        this.details = SECURITY_ERROR_CODES.has(code) ? undefined : details;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AA0BA,uBAAuB;AACvB,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC;IACnD,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,kBAAkB,EAAE,cAAc;CACtF,CAAC,CAAC;AAEH,yDAAyD;AACzD,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC;IACxD,uBAAuB,EAAE,uBAAuB,EAAE,yBAAyB;CAC5E,CAAC,CAAC;AAEH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IACrB,KAAK,CAAgB;IACrB,SAAS,CAAU;IACnB,OAAO,CAA2B;IAE3C,YACE,IAAoB,EACpB,KAAoB,EACpB,OAAe,EACf,OAAiC;QAEjC,gEAAgE;QAChE,MAAM,WAAW,GAAG,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC;YAChD,CAAC,CAAC,sCAAsC;YACxC,CAAC,CAAC,OAAO,CAAC;QACZ,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,uCAAuC;QACvC,IAAI,CAAC,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IACtE,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import type { InferConfig, InferResult, SmartQueryPlan, ExecutionContext } from './types.js';
+export declare class Infer {
+    private connector;
+    private llmProvider;
+    private catalog;
+    private catalogSource;
+    private config;
+    private entityResolvers;
+    private debug;
+    constructor(config: InferConfig);
+    ask(question: string, ctx?: Partial<ExecutionContext>): Promise<InferResult>;
+    execute(plan: SmartQueryPlan, ctx?: Partial<ExecutionContext>): Promise<InferResult>;
+    introspect(): Promise<import('./types.js').IntrospectedSchema>;
+    generateSchema(): Promise<string>;
+    refresh(): Promise<void>;
+    registerResolver(name: string, resolver: import('./entity-resolver.js').EntityResolver): void;
+    close(): Promise<void>;
+    private ensureCatalog;
+    private callLLMWithRetry;
+    private log;
+}
+export { InferError } from './errors.js';
+export type { InferErrorCode, PipelineStage } from './errors.js';
+export { validateInput, classifyInjection, sanitizeResult } from './security.js';
+export type { ClassificationResult } from './security.js';
+export { validateSQL, validateMetricExpression } from './sql-validator.js';
+export { compileSQL, quoteIdentifier } from './sql-builder.js';
+export { validateQueryPlan } from './query-validator.js';
+export { createLLMProvider, buildCatalogSummary, extractJSON } from './llm.js';
+export type { LLMProvider } from './llm.js';
+export { OpenRouterProvider, OpenAIProvider, AnthropicProvider, OllamaProvider } from './llm.js';
+export { PostgresConnector, HTTPConnector, SupabaseConnector, LambdaConnector } from './connectors.js';
+export type { PostgresConnectorConfig, HTTPConnectorConfig } from './connectors.js';
+export { loadCatalogFromYAML, buildCatalogFromIntrospection, mergeCatalogs } from './catalog.js';
+export type { YAMLSchema, YAMLDatasource } from './catalog.js';
+export { EntityResolverRegistry, DatabaseEntityResolver } from './entity-resolver.js';
+export type { EntityResolver } from './entity-resolver.js';
+export { RELATIVE_PHRASES, detectRelativePhrase, computeRelativeRange, resolveDateRange, parseRelativeDateRange, } from './dates.js';
+export type { RelativeDatePhrase } from './dates.js';
+export { SmartQueryPlanSchema, FilterSchema, EntityFilterSchema, DateRangeSchema, OrderBySchema } from './schemas.js';
+export type { ColumnType, TimeMode, TimeConfig, EntityDef, DimensionDef, MetricAgg, MetricDef, JoinDef, DatasetEntry, InferCatalog, ColumnMeta, InferResult, SmartQueryPlan, AnswerMode, SmartFilter, SmartEntityFilter, DateRange, OrderByClause, ExecutionContext, ValidatedSmartPlan, ResolvedEntity, CompiledSQL, LLMMessage, LLMOptions, InferConnector, IntrospectedColumn, IntrospectedTable, IntrospectedSchema, InferConfig, LLMProviderConfig, } from './types.js';
+export { datasetHasColumn, getMetricDef, getDimensionDef, allowlistedMetricIds, allowlistedGroupByColumns, effectiveTimeConfig, } from './types.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":"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"}

package/dist/index.js

@@ -0,0 +1,240 @@
+import { InferError } from './errors.js';
+import { validateInput } from './security.js';
+import { sanitizeResult } from './security.js';
+import { validateQueryPlan } from './query-validator.js';
+import { compileSQL } from './sql-builder.js';
+import { validateSQL } from './sql-validator.js';
+import { createLLMProvider, buildCatalogSummary, extractJSON } from './llm.js';
+import { loadCatalogFromYAML, buildCatalogFromIntrospection } from './catalog.js';
+import { EntityResolverRegistry } from './entity-resolver.js';
+export class Infer {
+    connector;
+    llmProvider;
+    catalog = null;
+    catalogSource;
+    config;
+    entityResolvers = new EntityResolverRegistry();
+    debug;
+    constructor(config) {
+        this.connector = config.connector;
+        this.config = config;
+        this.debug = config.debug ?? false;
+        this.catalogSource = config.catalog;
+        // Create LLM provider
+        this.llmProvider = createLLMProvider(config.llm);
+    }
+    // ── Main API ──
+    async ask(question, ctx) {
+        const startTime = Date.now();
+        const warnings = [];
+        // Layer 1: Input validation & safety check
+        this.log('input', `Validating: "${question}"`);
+        validateInput(question);
+        // Ensure catalog is loaded
+        const catalog = await this.ensureCatalog();
+        // Layer 2: LLM Query Planner
+        this.log('planner', 'Generating query plan...');
+        const systemPrompt = buildCatalogSummary(catalog);
+        const llmResponse = await this.callLLMWithRetry([
+            { role: 'system', content: systemPrompt },
+            { role: 'user', content: question },
+        ]);
+        const rawPlan = extractJSON(llmResponse);
+        this.config.onPlan?.(rawPlan);
+        // Layer 3: Plan validation
+        this.log('validator', 'Validating query plan...');
+        const validatedPlan = validateQueryPlan(rawPlan, catalog, {
+            maxLimit: this.config.maxRows ?? 200,
+        });
+        // Layer 4: Entity resolution
+        if (validatedPlan.resolvedEntities.length === 0 && rawPlan?.entityFilters?.length > 0) {
+            this.log('resolver', 'Resolving entities...');
+            const tenantId = ctx?.tenantId ?? this.config.tenantId ?? '';
+            validatedPlan.resolvedEntities = await this.entityResolvers.resolveAll(rawPlan.entityFilters, tenantId);
+        }
+        // Layer 5: SQL compilation
+        this.log('compiler', 'Compiling SQL...');
+        const executionCtx = {
+            tenantId: ctx?.tenantId ?? this.config.tenantId ?? '',
+            locationIds: ctx?.locationIds,
+        };
+        const compiled = compileSQL(validatedPlan, executionCtx);
+        this.config.onSQL?.(compiled.sql, compiled.params);
+        // Layer 6: SQL validation (defense-in-depth)
+        this.log('sql_check', 'Validating SQL...');
+        const allowedTables = Object.values(catalog.datasets).map(ds => `${ds.table.schema}.${ds.table.name}`);
+        validateSQL(compiled.sql, { allowedTables });
+        // Layer 7: Secure execution
+        this.log('executor', 'Executing query...');
+        const result = await this.connector.execute(compiled.sql, compiled.params);
+        // Layer 8: Result sanitization
+        const sensitiveColumns = validatedPlan.dataset.sensitiveColumns;
+        const sanitizedRows = sanitizeResult(result.rows, sensitiveColumns);
+        this.config.onValidation?.(warnings);
+        const inferResult = {
+            rows: sanitizedRows,
+            columns: result.columns,
+            sql: this.config.includeSQL ? compiled.sql : undefined,
+            plan: rawPlan,
+            warnings,
+            executionTime: Date.now() - startTime,
+        };
+        this.config.onResult?.(inferResult);
+        return inferResult;
+    }
+    // ── Direct plan execution (skip LLM) ──
+    async execute(plan, ctx) {
+        const startTime = Date.now();
+        const catalog = await this.ensureCatalog();
+        const validatedPlan = validateQueryPlan(plan, catalog, {
+            maxLimit: this.config.maxRows ?? 200,
+        });
+        const executionCtx = {
+            tenantId: ctx?.tenantId ?? this.config.tenantId ?? '',
+            locationIds: ctx?.locationIds,
+        };
+        const compiled = compileSQL(validatedPlan, executionCtx);
+        validateSQL(compiled.sql);
+        const result = await this.connector.execute(compiled.sql, compiled.params);
+        const sanitizedRows = sanitizeResult(result.rows, validatedPlan.dataset.sensitiveColumns);
+        return {
+            rows: sanitizedRows,
+            columns: result.columns,
+            sql: this.config.includeSQL ? compiled.sql : undefined,
+            plan,
+            warnings: [],
+            executionTime: Date.now() - startTime,
+        };
+    }
+    // ── Schema introspection ──
+    async introspect() {
+        return this.connector.introspect();
+    }
+    // ── Generate schema YAML ──
+    async generateSchema() {
+        const schema = await this.introspect();
+        const catalog = buildCatalogFromIntrospection(schema);
+        return catalogToYAML(catalog);
+    }
+    // ── Refresh schema cache ──
+    async refresh() {
+        this.catalog = null;
+        await this.ensureCatalog();
+    }
+    // ── Entity resolver registration ──
+    registerResolver(name, resolver) {
+        this.entityResolvers.register(name, resolver);
+    }
+    // ── Cleanup ──
+    async close() {
+        await this.connector.close();
+    }
+    // ── Private methods ──
+    async ensureCatalog() {
+        if (this.catalog)
+            return this.catalog;
+        if (typeof this.catalogSource === 'object' && this.catalogSource !== null) {
+            this.catalog = this.catalogSource;
+        }
+        else if (typeof this.catalogSource === 'string') {
+            // Load from YAML file path - try dynamic import of fs and yaml
+            try {
+                // Dynamic imports to avoid hard dependency on Node.js built-ins and yaml package
+                const fsModule = await Function('return import("fs")')();
+                const yamlModule = await Function('return import("yaml")')();
+                const content = fsModule.readFileSync(this.catalogSource, 'utf-8');
+                const parsed = yamlModule.parse(content);
+                this.catalog = loadCatalogFromYAML(parsed);
+            }
+            catch {
+                throw new InferError('CONNECTION_ERROR', 'validator', 'Failed to load catalog from file. Install the "yaml" package.');
+            }
+        }
+        else {
+            // Auto-introspect
+            const schema = await this.connector.introspect();
+            this.catalog = buildCatalogFromIntrospection(schema);
+        }
+        return this.catalog;
+    }
+    async callLLMWithRetry(messages) {
+        const maxRetries = this.config.retries?.max ?? 0;
+        let lastError = null;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                return await this.llmProvider.chat(messages, { temperature: 0 });
+            }
+            catch (error) {
+                lastError = error;
+                if (error instanceof InferError && !error.retryable)
+                    throw error;
+                if (attempt < maxRetries) {
+                    const delay = this.config.retries?.backoff === 'exponential'
+                        ? Math.min(250 * Math.pow(2, attempt), 5000)
+                        : 250 * (attempt + 1);
+                    await new Promise(r => setTimeout(r, delay));
+                }
+            }
+        }
+        throw lastError ?? new InferError('LLM_UNAVAILABLE', 'planner', 'LLM call failed after retries');
+    }
+    log(stage, message) {
+        if (this.debug) {
+            console.log(`[infer:${stage}] ${message}`);
+        }
+    }
+}
+// ── Helper: Convert catalog to YAML string ──
+function catalogToYAML(catalog) {
+    const lines = ['# infer-schema.yaml — auto-generated by infer-cli', '# Review and customize before use', '', 'datasources:'];
+    for (const [id, ds] of Object.entries(catalog.datasets)) {
+        lines.push(`  ${id}:`);
+        lines.push(`    table: ${ds.table.schema}.${ds.table.name}`);
+        if (ds.dateColumn)
+            lines.push(`    date_column: ${ds.dateColumn}`);
+        if (ds.estimatedRows)
+            lines.push(`    estimated_rows: ${ds.estimatedRows}`);
+        if (ds.selectableColumns.length > 0) {
+            lines.push('    columns:');
+            for (const col of ds.selectableColumns) {
+                lines.push(`      - name: ${col}`);
+                lines.push(`        type: ${ds.columnTypes[col] ?? 'text'}`);
+                const dim = ds.dimensions.find(d => d.column === col);
+                if (dim?.groupable)
+                    lines.push('        groupable: true');
+            }
+        }
+        if (ds.metrics.length > 0) {
+            lines.push('    metrics:');
+            for (const m of ds.metrics) {
+                lines.push(`      - id: ${m.id}`);
+                lines.push(`        expression: "${m.expression}"`);
+                if (m.description)
+                    lines.push(`        description: "${m.description}"`);
+            }
+        }
+        if (ds.sensitiveColumns.length > 0) {
+            lines.push('    sensitive:');
+            for (const col of ds.sensitiveColumns) {
+                lines.push(`      - ${col}`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ── Re-exports ──
+export { InferError } from './errors.js';
+export { validateInput, classifyInjection, sanitizeResult } from './security.js';
+export { validateSQL, validateMetricExpression } from './sql-validator.js';
+export { compileSQL, quoteIdentifier } from './sql-builder.js';
+export { validateQueryPlan } from './query-validator.js';
+export { createLLMProvider, buildCatalogSummary, extractJSON } from './llm.js';
+export { OpenRouterProvider, OpenAIProvider, AnthropicProvider, OllamaProvider } from './llm.js';
+export { PostgresConnector, HTTPConnector, SupabaseConnector, LambdaConnector } from './connectors.js';
+export { loadCatalogFromYAML, buildCatalogFromIntrospection, mergeCatalogs } from './catalog.js';
+export { EntityResolverRegistry, DatabaseEntityResolver } from './entity-resolver.js';
+export { RELATIVE_PHRASES, detectRelativePhrase, computeRelativeRange, resolveDateRange, parseRelativeDateRange, } from './dates.js';
+export { SmartQueryPlanSchema, FilterSchema, EntityFilterSchema, DateRangeSchema, OrderBySchema } from './schemas.js';
+export { datasetHasColumn, getMetricDef, getDimensionDef, allowlistedMetricIds, allowlistedGroupByColumns, effectiveTimeConfig, } from './types.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":"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"}

package/dist/llm.d.ts

@@ -0,0 +1,50 @@
+import type { LLMMessage, LLMOptions, LLMProviderConfig, InferCatalog } from './types.js';
+export interface LLMProvider {
+    chat(messages: LLMMessage[], options?: LLMOptions): Promise<string>;
+}
+export declare class OpenRouterProvider implements LLMProvider {
+    private apiKey;
+    private model;
+    private baseUrl;
+    constructor(config: {
+        apiKey: string;
+        model?: string;
+        baseUrl?: string;
+    });
+    chat(messages: LLMMessage[], options?: LLMOptions): Promise<string>;
+}
+export declare class OpenAIProvider implements LLMProvider {
+    private apiKey;
+    private model;
+    private baseUrl;
+    constructor(config: {
+        apiKey: string;
+        model?: string;
+        baseUrl?: string;
+    });
+    chat(messages: LLMMessage[], options?: LLMOptions): Promise<string>;
+}
+export declare class AnthropicProvider implements LLMProvider {
+    private apiKey;
+    private model;
+    private baseUrl;
+    constructor(config: {
+        apiKey: string;
+        model?: string;
+        baseUrl?: string;
+    });
+    chat(messages: LLMMessage[], options?: LLMOptions): Promise<string>;
+}
+export declare class OllamaProvider implements LLMProvider {
+    private model;
+    private baseUrl;
+    constructor(config: {
+        model?: string;
+        baseUrl?: string;
+    });
+    chat(messages: LLMMessage[], options?: LLMOptions): Promise<string>;
+}
+export declare function createLLMProvider(config: LLMProviderConfig): LLMProvider;
+export declare function buildCatalogSummary(catalog: InferCatalog): string;
+export declare function extractJSON(text: string): unknown;
+//# sourceMappingURL=llm.d.ts.map

package/dist/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAgB,MAAM,YAAY,CAAC;AAGxG,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrE;AAGD,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAMlE,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CAuC1E;AAGD,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAMlE,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CAqC1E;AAGD,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAMlE,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CA2C1E;AAGD,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAKlD,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CAgC1E;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAgBxE;AAGD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAqEjE;AAGD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAmBjD"}