@agentix-e/nl2spel 1.2.1 → 1.3.0

package/dist/engine/nl2spel-engine.js

@@ -1,130 +0,0 @@
-import { StrategyRouter } from '../strategy/strategy-router.js';
-import { ProviderRegistry } from '../provider/provider-registry.js';
-import { IntentClassifier } from '../template/intent-classifier.js';
-import { ContextExtractor } from '../context/context-extractor.js';
-export class NL2SpelEngine {
-    router;
-    providerRegistry;
-    evaluatorInstance = null;
-    constructor(config = {}) {
-        this.providerRegistry = new ProviderRegistry();
-        this.router = new StrategyRouter(this.providerRegistry, config);
-    }
-    /**
-     * Register an LLM Provider
-     */
-    registerProvider(provider) {
-        this.providerRegistry.register(provider);
-    }
-    /**
-     * Unregister an LLM Provider
-     */
-    unregisterProvider(name) {
-        this.providerRegistry.unregister(name);
-    }
-    /**
-     * Register a custom Pattern
-     */
-    registerPattern(pattern) {
-        this.router.getPatternMatcher().register(pattern);
-    }
-    /**
-     * Set SpelEvaluator for validation pipeline.
-     * Must be called before generate() if parse-level validation is required.
-     */
-    setSpelEvaluator(evaluator) {
-        this.evaluatorInstance = evaluator;
-        this.router.setEvaluator(evaluator);
-    }
-    /**
-     * Extract ContextSchema from raw context object
-     */
-    extractContextSchema(context) {
-        const extractor = new ContextExtractor();
-        return extractor.extract(context);
-    }
-    /**
-     * Core generation API
-     */
-    async generate(nl, options = {}) {
-        const startTime = Date.now();
-        // Build ContextSchema — priority: explicit > evaluator > raw context
-        let contextSchema = options.contextSchema;
-        if (!contextSchema && this.evaluatorInstance) {
-            const schema = await Promise.resolve(this.evaluatorInstance.getContextSchema());
-            if (schema)
-                contextSchema = schema;
-        }
-        if (!contextSchema && options.context) {
-            const extractor = new ContextExtractor();
-            contextSchema = extractor.extract(options.context);
-        }
-        // Offline mode
-        if (options.offlineOnly) {
-            const patternMatcher = this.router.getPatternMatcher();
-            const patternResult = patternMatcher.match(nl);
-            if (patternResult.matched) {
-                return {
-                    expression: patternResult.spel,
-                    strategy: 'pattern',
-                    confidence: patternResult.confidence,
-                    latencyMs: Date.now() - startTime,
-                };
-            }
-            const classifier = new IntentClassifier();
-            const intentResult = classifier.classify(nl);
-            const templateEngine = this.router.getTemplateEngine();
-            if (contextSchema)
-                templateEngine.setContext(contextSchema);
-            const templateResult = templateEngine.generate(nl, intentResult);
-            if (templateResult) {
-                return {
-                    expression: templateResult.expression,
-                    strategy: 'template',
-                    confidence: templateResult.confidence,
-                    latencyMs: Date.now() - startTime,
-                };
-            }
-            throw new Error('Cannot generate expression offline: no pattern or template matched.');
-        }
-        // Route generation
-        const result = await this.router.generate(nl, contextSchema, options.preferredProvider);
-        return {
-            expression: result.expression,
-            strategy: result.strategy,
-            confidence: result.confidence,
-            latencyMs: Date.now() - startTime,
-        };
-    }
-    /**
-     * Batch generation
-     */
-    async generateBatch(nls, options = {}) {
-        return Promise.all(nls.map((nl) => this.generate(nl, options)));
-    }
-    /**
-     * Debug explanation
-     */
-    async explain(nl, options = {}) {
-        const classifier = new IntentClassifier();
-        const intentResult = classifier.classify(nl);
-        const patternMatcher = this.router.getPatternMatcher();
-        const patternResult = patternMatcher.match(nl);
-        const allPatternResults = patternMatcher.matchAll(nl, 5);
-        const result = await this.generate(nl, { ...options });
-        return {
-            input: nl,
-            strategy: result.strategy,
-            intent: {
-                primary: intentResult.primaryIntent,
-                complexity: intentResult.complexity,
-                all: intentResult.intents,
-            },
-            patternMatched: patternResult.matched,
-            patternId: patternResult.pattern?.id,
-            expression: result.expression,
-            alternatives: allPatternResults.filter((r) => r.spel).map((r) => r.spel),
-        };
-    }
-}
-//# sourceMappingURL=nl2spel-engine.js.map

package/dist/engine/nl2spel-engine.js.map

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

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,WAAW,EACX,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,QAAQ,EACR,cAAc,GACf,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGhE,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,aAAa,GACd,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAGjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,WAAW,GACZ,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,oBAAoB,GACrB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,YAAY,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,SAAS,GACV,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AA6BvC,mBAAmB;AACnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAQhE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,qBAAqB;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAGrE,uBAAuB;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAOzE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAO1E,4BAA4B;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAQ/D,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAQ3D,QAAQ;AACR,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/pattern/builtin-patterns.d.ts

@@ -1,12 +0,0 @@
-import type { PatternDefinition } from './pattern-definition.js';
-/**
- * Built-in pattern library — covers ≥80% Easy scenarios, 63 PatternDefinitions.
- *
- * Core design:
- * 1. All patterns use named capture groups `(?<field>…)` or `(?<value>…)` to extract parameters
- * 2. Separate Chinese/English patterns (don't mix keywords, avoids cross-language false matches)
- * 3. High-specificity patterns have higher priority ("not empty" > "not")
- * 4. Sorted by priority descending
- */
-export declare const BUILTIN_PATTERNS: PatternDefinition[];
-//# sourceMappingURL=builtin-patterns.d.ts.map

package/dist/pattern/builtin-patterns.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"builtin-patterns.d.ts","sourceRoot":"","sources":["../../src/pattern/builtin-patterns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,iBAAiB,EA20B/C,CAAC"}