@agentix-e/nl2spel 0.0.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (134) hide show
  1. package/README.md +69 -39
  2. package/dist/SpelEvaluator.d.ts +124 -0
  3. package/dist/SpelEvaluator.d.ts.map +1 -0
  4. package/dist/SpelEvaluator.js +2 -0
  5. package/dist/SpelEvaluator.js.map +1 -0
  6. package/dist/__tests__/auto-fixer.test.d.ts +2 -0
  7. package/dist/__tests__/auto-fixer.test.d.ts.map +1 -0
  8. package/dist/__tests__/auto-fixer.test.js +285 -0
  9. package/dist/__tests__/auto-fixer.test.js.map +1 -0
  10. package/dist/__tests__/chinese-number-parser.test.d.ts +2 -0
  11. package/dist/__tests__/chinese-number-parser.test.d.ts.map +1 -0
  12. package/dist/__tests__/chinese-number-parser.test.js +106 -0
  13. package/dist/__tests__/chinese-number-parser.test.js.map +1 -0
  14. package/dist/__tests__/context-extractor.test.d.ts +2 -0
  15. package/dist/__tests__/context-extractor.test.d.ts.map +1 -0
  16. package/dist/__tests__/context-extractor.test.js +347 -0
  17. package/dist/__tests__/context-extractor.test.js.map +1 -0
  18. package/dist/__tests__/coverage-gaps.test.d.ts +2 -0
  19. package/dist/__tests__/coverage-gaps.test.d.ts.map +1 -0
  20. package/dist/__tests__/coverage-gaps.test.js +578 -0
  21. package/dist/__tests__/coverage-gaps.test.js.map +1 -0
  22. package/dist/__tests__/intent-classifier.test.d.ts +2 -0
  23. package/dist/__tests__/intent-classifier.test.d.ts.map +1 -0
  24. package/dist/__tests__/intent-classifier.test.js +384 -0
  25. package/dist/__tests__/intent-classifier.test.js.map +1 -0
  26. package/dist/__tests__/nl2spel-engine.test.d.ts +2 -0
  27. package/dist/__tests__/nl2spel-engine.test.d.ts.map +1 -0
  28. package/dist/__tests__/nl2spel-engine.test.js +344 -0
  29. package/dist/__tests__/nl2spel-engine.test.js.map +1 -0
  30. package/dist/__tests__/pattern-matcher.test.d.ts +2 -0
  31. package/dist/__tests__/pattern-matcher.test.d.ts.map +1 -0
  32. package/dist/__tests__/pattern-matcher.test.js +754 -0
  33. package/dist/__tests__/pattern-matcher.test.js.map +1 -0
  34. package/dist/__tests__/prompt-builder.test.d.ts +2 -0
  35. package/dist/__tests__/prompt-builder.test.d.ts.map +1 -0
  36. package/dist/__tests__/prompt-builder.test.js +99 -0
  37. package/dist/__tests__/prompt-builder.test.js.map +1 -0
  38. package/dist/__tests__/provider-registry.test.d.ts +2 -0
  39. package/dist/__tests__/provider-registry.test.d.ts.map +1 -0
  40. package/dist/__tests__/provider-registry.test.js +240 -0
  41. package/dist/__tests__/provider-registry.test.js.map +1 -0
  42. package/dist/__tests__/schema-formatter.test.d.ts +2 -0
  43. package/dist/__tests__/schema-formatter.test.d.ts.map +1 -0
  44. package/dist/__tests__/schema-formatter.test.js +298 -0
  45. package/dist/__tests__/schema-formatter.test.js.map +1 -0
  46. package/dist/__tests__/self-correction-loop.test.d.ts +2 -0
  47. package/dist/__tests__/self-correction-loop.test.d.ts.map +1 -0
  48. package/dist/__tests__/self-correction-loop.test.js +253 -0
  49. package/dist/__tests__/self-correction-loop.test.js.map +1 -0
  50. package/dist/__tests__/strategy-router.test.d.ts +2 -0
  51. package/dist/__tests__/strategy-router.test.d.ts.map +1 -0
  52. package/dist/__tests__/strategy-router.test.js +493 -0
  53. package/dist/__tests__/strategy-router.test.js.map +1 -0
  54. package/dist/__tests__/template-engine.test.d.ts +2 -0
  55. package/dist/__tests__/template-engine.test.d.ts.map +1 -0
  56. package/dist/__tests__/template-engine.test.js +367 -0
  57. package/dist/__tests__/template-engine.test.js.map +1 -0
  58. package/dist/__tests__/validation-pipeline.test.d.ts +2 -0
  59. package/dist/__tests__/validation-pipeline.test.d.ts.map +1 -0
  60. package/dist/__tests__/validation-pipeline.test.js +262 -0
  61. package/dist/__tests__/validation-pipeline.test.js.map +1 -0
  62. package/dist/context/context-extractor.d.ts +82 -0
  63. package/dist/context/context-extractor.d.ts.map +1 -0
  64. package/dist/context/context-extractor.js +166 -0
  65. package/dist/context/context-extractor.js.map +1 -0
  66. package/dist/context/schema-formatter.d.ts +20 -0
  67. package/dist/context/schema-formatter.d.ts.map +1 -0
  68. package/dist/context/schema-formatter.js +104 -0
  69. package/dist/context/schema-formatter.js.map +1 -0
  70. package/dist/engine/nl2spel-engine.d.ts +144 -0
  71. package/dist/engine/nl2spel-engine.d.ts.map +1 -0
  72. package/dist/engine/nl2spel-engine.js +125 -0
  73. package/dist/engine/nl2spel-engine.js.map +1 -0
  74. package/dist/index.d.ts +28 -0
  75. package/dist/index.d.ts.map +1 -0
  76. package/dist/index.js +24 -0
  77. package/dist/index.js.map +1 -0
  78. package/dist/pattern/builtin-patterns.d.ts +12 -0
  79. package/dist/pattern/builtin-patterns.d.ts.map +1 -0
  80. package/dist/pattern/builtin-patterns.js +812 -0
  81. package/dist/pattern/builtin-patterns.js.map +1 -0
  82. package/dist/pattern/pattern-definition.d.ts +49 -0
  83. package/dist/pattern/pattern-definition.d.ts.map +1 -0
  84. package/dist/pattern/pattern-definition.js +2 -0
  85. package/dist/pattern/pattern-definition.js.map +1 -0
  86. package/dist/pattern/pattern-matcher.d.ts +55 -0
  87. package/dist/pattern/pattern-matcher.d.ts.map +1 -0
  88. package/dist/pattern/pattern-matcher.js +216 -0
  89. package/dist/pattern/pattern-matcher.js.map +1 -0
  90. package/dist/provider/llm-provider.d.ts +146 -0
  91. package/dist/provider/llm-provider.d.ts.map +1 -0
  92. package/dist/provider/llm-provider.js +2 -0
  93. package/dist/provider/llm-provider.js.map +1 -0
  94. package/dist/provider/provider-registry.d.ts +28 -0
  95. package/dist/provider/provider-registry.d.ts.map +1 -0
  96. package/dist/provider/provider-registry.js +65 -0
  97. package/dist/provider/provider-registry.js.map +1 -0
  98. package/dist/strategy/strategy-router.d.ts +79 -0
  99. package/dist/strategy/strategy-router.d.ts.map +1 -0
  100. package/dist/strategy/strategy-router.js +182 -0
  101. package/dist/strategy/strategy-router.js.map +1 -0
  102. package/dist/template/intent-classifier.d.ts +56 -0
  103. package/dist/template/intent-classifier.d.ts.map +1 -0
  104. package/dist/template/intent-classifier.js +251 -0
  105. package/dist/template/intent-classifier.js.map +1 -0
  106. package/dist/template/nl-intent.d.ts +38 -0
  107. package/dist/template/nl-intent.d.ts.map +1 -0
  108. package/dist/template/nl-intent.js +39 -0
  109. package/dist/template/nl-intent.js.map +1 -0
  110. package/dist/template/prompts/prompt-builder.d.ts +20 -0
  111. package/dist/template/prompts/prompt-builder.d.ts.map +1 -0
  112. package/dist/template/prompts/prompt-builder.js +243 -0
  113. package/dist/template/prompts/prompt-builder.js.map +1 -0
  114. package/dist/template/template-engine.d.ts +27 -0
  115. package/dist/template/template-engine.d.ts.map +1 -0
  116. package/dist/template/template-engine.js +378 -0
  117. package/dist/template/template-engine.js.map +1 -0
  118. package/dist/utils/chinese-number-parser.d.ts +30 -0
  119. package/dist/utils/chinese-number-parser.d.ts.map +1 -0
  120. package/dist/utils/chinese-number-parser.js +92 -0
  121. package/dist/utils/chinese-number-parser.js.map +1 -0
  122. package/dist/validation/auto-fixer.d.ts +14 -0
  123. package/dist/validation/auto-fixer.d.ts.map +1 -0
  124. package/dist/validation/auto-fixer.js +111 -0
  125. package/dist/validation/auto-fixer.js.map +1 -0
  126. package/dist/validation/self-correction-loop.d.ts +46 -0
  127. package/dist/validation/self-correction-loop.d.ts.map +1 -0
  128. package/dist/validation/self-correction-loop.js +141 -0
  129. package/dist/validation/self-correction-loop.js.map +1 -0
  130. package/dist/validation/validation-pipeline.d.ts +81 -0
  131. package/dist/validation/validation-pipeline.d.ts.map +1 -0
  132. package/dist/validation/validation-pipeline.js +306 -0
  133. package/dist/validation/validation-pipeline.js.map +1 -0
  134. package/package.json +36 -7
@@ -0,0 +1,104 @@
1
+ /**
2
+ * SchemaFormatter — formats ContextSchema into readable text.
3
+ *
4
+ * Two formats:
5
+ * 1. formatForLLM(): optimized for LLM prompts (compact, key info first)
6
+ * 2. formatForHuman(): human-readable format (complete, indent-friendly)
7
+ */
8
+ export class SchemaFormatter {
9
+ /**
10
+ * LLM-optimized format — compact, injected into the User part of the prompt
11
+ */
12
+ formatForLLM(schema) {
13
+ const lines = ['## Context Schema'];
14
+ // Root Object
15
+ if (schema.root) {
16
+ lines.push('');
17
+ lines.push(`Root Object (accessible as #${schema.root.name}):`);
18
+ lines.push(` Type: ${schema.root.type}`);
19
+ lines.push(` Fields:`);
20
+ for (const [name, field] of Object.entries(schema.root.fields)) {
21
+ lines.push(this.formatFieldForLLM(name, field, ' '));
22
+ }
23
+ }
24
+ // Variables
25
+ if (Object.keys(schema.variables).length > 0) {
26
+ lines.push('');
27
+ lines.push(`Variables:`);
28
+ for (const [name, varDef] of Object.entries(schema.variables)) {
29
+ lines.push(` #${name}: ${varDef.type}` + (varDef.description ? ` (${varDef.description})` : ''));
30
+ }
31
+ }
32
+ // Beans
33
+ if (Object.keys(schema.beans).length > 0) {
34
+ lines.push('');
35
+ lines.push(`Beans:`);
36
+ for (const [name, beanDef] of Object.entries(schema.beans)) {
37
+ lines.push(` @${name}: ${beanDef.type}` + (beanDef.description ? ` (${beanDef.description})` : ''));
38
+ }
39
+ }
40
+ // Types
41
+ if (Object.keys(schema.types).length > 0) {
42
+ lines.push('');
43
+ lines.push(`Types (accessible via T(typeName)):`);
44
+ for (const [name, typeDef] of Object.entries(schema.types)) {
45
+ lines.push(` ${name}` + (typeDef.description ? `: ${typeDef.description}` : ''));
46
+ }
47
+ }
48
+ // Functions
49
+ if (Object.keys(schema.functions).length > 0) {
50
+ lines.push('');
51
+ lines.push(`Functions:`);
52
+ for (const [name, funcDef] of Object.entries(schema.functions)) {
53
+ const params = funcDef.params.map(p => `${p.name}: ${p.type}`).join(', ');
54
+ lines.push(` #${name}(${params}): ${funcDef.returnType}`);
55
+ }
56
+ }
57
+ lines.push('');
58
+ return lines.join('\n');
59
+ }
60
+ /**
61
+ * Human-readable format
62
+ */
63
+ formatForHuman(schema) {
64
+ const lines = [
65
+ '═══════════════════════════════════════',
66
+ ' Context Schema (Human-Readable)',
67
+ '═══════════════════════════════════════',
68
+ ];
69
+ if (schema.root) {
70
+ lines.push('');
71
+ lines.push(`┌─ Root: #${schema.root.name}`);
72
+ lines.push(`│ Type: ${schema.root.type}`);
73
+ lines.push(`│ Fields:`);
74
+ const entries = Object.entries(schema.root.fields);
75
+ for (let i = 0; i < entries.length; i++) {
76
+ const [name, field] = entries[i];
77
+ const prefix = i < entries.length - 1 ? '├─' : '└─';
78
+ lines.push(`│ ${prefix} ${name} (${field.type})` +
79
+ (field.description ? ` — ${field.description}` : '') +
80
+ (field.nullable ? ' | nullable' : '') +
81
+ (field.isCollection ? ` | collection<${field.elementType ?? 'unknown'}>` : ''));
82
+ }
83
+ lines.push(`│ └─ (${entries.length} fields total)`);
84
+ }
85
+ return lines.join('\n');
86
+ }
87
+ formatFieldForLLM(name, field, indent) {
88
+ const parts = [`${indent}- ${name}: ${field.type}`];
89
+ if (field.description) {
90
+ parts.push(`(${field.description})`);
91
+ }
92
+ if (field.isCollection) {
93
+ parts.push(`[array of ${field.elementType ?? 'unknown'}]`);
94
+ }
95
+ if (field.nullable) {
96
+ parts.push(`[nullable]`);
97
+ }
98
+ if (field.example !== undefined) {
99
+ parts.push(`(e.g. ${JSON.stringify(field.example)})`);
100
+ }
101
+ return parts.join(' ');
102
+ }
103
+ }
104
+ //# sourceMappingURL=schema-formatter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema-formatter.js","sourceRoot":"","sources":["../../src/context/schema-formatter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,144 @@
1
+ import { type StrategyRouterConfig } from '../strategy/strategy-router.js';
2
+ import type { LLMProvider } from '../provider/llm-provider.js';
3
+ import type { PatternDefinition } from '../pattern/pattern-definition.js';
4
+ import type { ContextSchema, SpelEvaluator } from '../SpelEvaluator.js';
5
+ export interface GenerateOptions {
6
+ /** Context Schema (optional) */
7
+ contextSchema?: ContextSchema;
8
+ /** Raw context object (auto-extracted to ContextSchema) */
9
+ context?: {
10
+ rootObject?: unknown;
11
+ rootName?: string;
12
+ variables?: Record<string, {
13
+ type: string;
14
+ value?: unknown;
15
+ description?: string;
16
+ nullable?: boolean;
17
+ }>;
18
+ beans?: Array<{
19
+ name: string;
20
+ type: string;
21
+ description?: string;
22
+ }>;
23
+ types?: Array<{
24
+ name: string;
25
+ className?: string;
26
+ description?: string;
27
+ }>;
28
+ };
29
+ /** Force using a specific LLM Provider */
30
+ preferredProvider?: string;
31
+ /** Minimum confidence threshold (default 0.5) */
32
+ minConfidence?: number;
33
+ /** Offline only (Pattern + Template, no LLM calls) */
34
+ offlineOnly?: boolean;
35
+ /** Whether validation is enabled (default true) */
36
+ enableValidation?: boolean;
37
+ /** Whether self-correction is enabled (default true) */
38
+ enableSelfCorrection?: boolean;
39
+ /** Language (default auto-detect) */
40
+ language?: 'zh' | 'en';
41
+ /** Whether to return debug information */
42
+ debug?: boolean;
43
+ }
44
+ export interface GenerateResult {
45
+ /** Generated SpEL expression */
46
+ expression: string;
47
+ /** Strategy used */
48
+ strategy: string;
49
+ /** Confidence (0-1) */
50
+ confidence: number;
51
+ /** Generation latency (ms) */
52
+ latencyMs: number;
53
+ /** Debug info (only when debug=true) */
54
+ debugInfo?: DebugInfo;
55
+ }
56
+ export interface DebugInfo {
57
+ /** Pattern match result */
58
+ patternMatch?: {
59
+ matched: boolean;
60
+ patternId?: string;
61
+ spel?: string;
62
+ };
63
+ /** Intent classification result */
64
+ intent?: {
65
+ primary: string;
66
+ complexity: number;
67
+ };
68
+ /** Template generation result */
69
+ template?: {
70
+ expression?: string;
71
+ templateName?: string;
72
+ };
73
+ /** LLM Provider info */
74
+ provider?: {
75
+ name: string;
76
+ model: string;
77
+ };
78
+ /** Self-correction info */
79
+ corrections?: {
80
+ attempts: number;
81
+ };
82
+ }
83
+ export interface ExplainResult {
84
+ /** Input text */
85
+ input: string;
86
+ /** Strategy used */
87
+ strategy: string;
88
+ /** Intent information */
89
+ intent: {
90
+ primary: string;
91
+ complexity: number;
92
+ all: Array<{
93
+ intent: string;
94
+ confidence: number;
95
+ }>;
96
+ };
97
+ /** Whether pattern was matched */
98
+ patternMatched: boolean;
99
+ /** Matched Pattern ID */
100
+ patternId?: string;
101
+ /** Final expression */
102
+ expression: string;
103
+ /** All possible expressions (from different strategies) */
104
+ alternatives: string[];
105
+ }
106
+ export declare class NL2SpelEngine {
107
+ private readonly router;
108
+ private readonly providerRegistry;
109
+ constructor(config?: StrategyRouterConfig);
110
+ /**
111
+ * Register an LLM Provider
112
+ */
113
+ registerProvider(provider: LLMProvider): void;
114
+ /**
115
+ * Unregister an LLM Provider
116
+ */
117
+ unregisterProvider(name: string): void;
118
+ /**
119
+ * Register a custom Pattern
120
+ */
121
+ registerPattern(pattern: PatternDefinition): void;
122
+ /**
123
+ * Set SpelEvaluator for validation pipeline.
124
+ * Must be called before generate() if parse-level validation is required.
125
+ */
126
+ setSpelEvaluator(evaluator: SpelEvaluator): void;
127
+ /**
128
+ * Extract ContextSchema from raw context object
129
+ */
130
+ extractContextSchema(context: NonNullable<GenerateOptions['context']>): ContextSchema;
131
+ /**
132
+ * Core generation API
133
+ */
134
+ generate(nl: string, options?: GenerateOptions): Promise<GenerateResult>;
135
+ /**
136
+ * Batch generation
137
+ */
138
+ generateBatch(nls: string[], options?: GenerateOptions): Promise<GenerateResult[]>;
139
+ /**
140
+ * Debug explanation
141
+ */
142
+ explain(nl: string, options?: GenerateOptions): Promise<ExplainResult>;
143
+ }
144
+ //# sourceMappingURL=nl2spel-engine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"nl2spel-engine.d.ts","sourceRoot":"","sources":["../../src/engine/nl2spel-engine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,125 @@
1
+ import { StrategyRouter } from '../strategy/strategy-router.js';
2
+ import { ProviderRegistry } from '../provider/provider-registry.js';
3
+ import { PatternMatcher } from '../pattern/pattern-matcher.js';
4
+ import { IntentClassifier } from '../template/intent-classifier.js';
5
+ import { ContextExtractor } from '../context/context-extractor.js';
6
+ import { ValidationPipeline } from '../validation/validation-pipeline.js';
7
+ export class NL2SpelEngine {
8
+ router;
9
+ providerRegistry;
10
+ constructor(config = {}) {
11
+ this.providerRegistry = new ProviderRegistry();
12
+ this.router = new StrategyRouter(this.providerRegistry, config);
13
+ }
14
+ /**
15
+ * Register an LLM Provider
16
+ */
17
+ registerProvider(provider) {
18
+ this.providerRegistry.register(provider);
19
+ }
20
+ /**
21
+ * Unregister an LLM Provider
22
+ */
23
+ unregisterProvider(name) {
24
+ this.providerRegistry.unregister(name);
25
+ }
26
+ /**
27
+ * Register a custom Pattern
28
+ */
29
+ registerPattern(pattern) {
30
+ this.router.getPatternMatcher().register(pattern);
31
+ }
32
+ /**
33
+ * Set SpelEvaluator for validation pipeline.
34
+ * Must be called before generate() if parse-level validation is required.
35
+ */
36
+ setSpelEvaluator(evaluator) {
37
+ this.router.setEvaluator(evaluator);
38
+ }
39
+ /**
40
+ * Extract ContextSchema from raw context object
41
+ */
42
+ extractContextSchema(context) {
43
+ const extractor = new ContextExtractor();
44
+ return extractor.extract(context);
45
+ }
46
+ /**
47
+ * Core generation API
48
+ */
49
+ async generate(nl, options = {}) {
50
+ const startTime = Date.now();
51
+ // Build ContextSchema
52
+ let contextSchema = options.contextSchema;
53
+ if (!contextSchema && options.context) {
54
+ const extractor = new ContextExtractor();
55
+ contextSchema = extractor.extract(options.context);
56
+ }
57
+ // Offline mode
58
+ if (options.offlineOnly) {
59
+ const patternMatcher = this.router.getPatternMatcher();
60
+ const patternResult = patternMatcher.match(nl);
61
+ if (patternResult.matched) {
62
+ return {
63
+ expression: patternResult.spel,
64
+ strategy: 'pattern',
65
+ confidence: patternResult.confidence,
66
+ latencyMs: Date.now() - startTime,
67
+ };
68
+ }
69
+ const classifier = new IntentClassifier();
70
+ const intentResult = classifier.classify(nl);
71
+ const templateEngine = this.router.getTemplateEngine();
72
+ if (contextSchema)
73
+ templateEngine.setContext(contextSchema);
74
+ const templateResult = templateEngine.generate(nl, intentResult);
75
+ if (templateResult) {
76
+ return {
77
+ expression: templateResult.expression,
78
+ strategy: 'template',
79
+ confidence: templateResult.confidence,
80
+ latencyMs: Date.now() - startTime,
81
+ };
82
+ }
83
+ throw new Error('Cannot generate expression offline: no pattern or template matched.');
84
+ }
85
+ // Route generation
86
+ const result = await this.router.generate(nl, contextSchema, options.preferredProvider);
87
+ return {
88
+ expression: result.expression,
89
+ strategy: result.strategy,
90
+ confidence: result.confidence,
91
+ latencyMs: Date.now() - startTime,
92
+ };
93
+ }
94
+ /**
95
+ * Batch generation
96
+ */
97
+ async generateBatch(nls, options = {}) {
98
+ return Promise.all(nls.map(nl => this.generate(nl, options)));
99
+ }
100
+ /**
101
+ * Debug explanation
102
+ */
103
+ async explain(nl, options = {}) {
104
+ const classifier = new IntentClassifier();
105
+ const intentResult = classifier.classify(nl);
106
+ const patternMatcher = this.router.getPatternMatcher();
107
+ const patternResult = patternMatcher.match(nl);
108
+ const allPatternResults = patternMatcher.matchAll(nl, 5);
109
+ const result = await this.generate(nl, { ...options });
110
+ return {
111
+ input: nl,
112
+ strategy: result.strategy,
113
+ intent: {
114
+ primary: intentResult.primaryIntent,
115
+ complexity: intentResult.complexity,
116
+ all: intentResult.intents,
117
+ },
118
+ patternMatched: patternResult.matched,
119
+ patternId: patternResult.pattern?.id,
120
+ expression: result.expression,
121
+ alternatives: allPatternResults.filter(r => r.spel).map(r => r.spel),
122
+ };
123
+ }
124
+ }
125
+ //# sourceMappingURL=nl2spel-engine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"nl2spel-engine.js","sourceRoot":"","sources":["../../src/engine/nl2spel-engine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ export type { SpelEvaluator, ParseResult, ParseError, ContextSchema, RootObjectSchema, FieldSchema, VariableSchema, BeanSchema, TypeSchema, MethodSchema, FunctionSchema, } from './SpelEvaluator.js';
2
+ export type { LLMProvider, LLMCapabilities, LLMPrompt, LLMGenerateOptions, LLMResponse, LLMStreamChunk, LLMUsage, FewShotExample, } from './provider/llm-provider.js';
3
+ export { ProviderRegistry } from './provider/provider-registry.js';
4
+ export { ContextExtractor } from './context/context-extractor.js';
5
+ export { SchemaFormatter } from './context/schema-formatter.js';
6
+ export type { PatternDefinition, SlotDefinition, SlotTransform, } from './pattern/pattern-definition.js';
7
+ export { PatternMatcher } from './pattern/pattern-matcher.js';
8
+ export type { PatternMatchResult } from './pattern/pattern-matcher.js';
9
+ export { BUILTIN_PATTERNS } from './pattern/builtin-patterns.js';
10
+ export { NLIntent } from './template/nl-intent.js';
11
+ export { IntentClassifier } from './template/intent-classifier.js';
12
+ export type { IntentResult, IntentEntity } from './template/intent-classifier.js';
13
+ export { TemplateEngine } from './template/template-engine.js';
14
+ export type { TemplateResult } from './template/template-engine.js';
15
+ export { PromptBuilder } from './template/prompts/prompt-builder.js';
16
+ export type { PromptBuilderOptions } from './template/prompts/prompt-builder.js';
17
+ export { ValidationPipeline } from './validation/validation-pipeline.js';
18
+ export type { ValidationResult, ValidationError, ValidationWarning, StageResult, } from './validation/validation-pipeline.js';
19
+ export { AutoFixer } from './validation/auto-fixer.js';
20
+ export type { AutoFixResult } from './validation/auto-fixer.js';
21
+ export { SelfCorrectionLoop } from './validation/self-correction-loop.js';
22
+ export type { SelfCorrectionResult, CorrectionLog, SelfCorrectionConfig, } from './validation/self-correction-loop.js';
23
+ export { StrategyRouter } from './strategy/strategy-router.js';
24
+ export type { StrategyType, StrategyResult, StrategyMetadata, StrategyRouterConfig, } from './strategy/strategy-router.js';
25
+ export { NL2SpelEngine } from './engine/nl2spel-engine.js';
26
+ export type { GenerateOptions, GenerateResult, ExplainResult, DebugInfo, } from './engine/nl2spel-engine.js';
27
+ export { ChineseNumberParser } from './utils/chinese-number-parser.js';
28
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"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 ADDED
@@ -0,0 +1,24 @@
1
+ // Core public API — @agentix-e/nl2spel
2
+ // ProviderRegistry
3
+ export { ProviderRegistry } from './provider/provider-registry.js';
4
+ // Context
5
+ export { ContextExtractor } from './context/context-extractor.js';
6
+ export { SchemaFormatter } from './context/schema-formatter.js';
7
+ export { PatternMatcher } from './pattern/pattern-matcher.js';
8
+ export { BUILTIN_PATTERNS } from './pattern/builtin-patterns.js';
9
+ // Template (Layer 1)
10
+ export { NLIntent } from './template/nl-intent.js';
11
+ export { IntentClassifier } from './template/intent-classifier.js';
12
+ export { TemplateEngine } from './template/template-engine.js';
13
+ export { PromptBuilder } from './template/prompts/prompt-builder.js';
14
+ // Validation (Layer 2)
15
+ export { ValidationPipeline } from './validation/validation-pipeline.js';
16
+ export { AutoFixer } from './validation/auto-fixer.js';
17
+ export { SelfCorrectionLoop } from './validation/self-correction-loop.js';
18
+ // Strategy Router (Layer 2)
19
+ export { StrategyRouter } from './strategy/strategy-router.js';
20
+ // NL2Spel Engine
21
+ export { NL2SpelEngine } from './engine/nl2spel-engine.js';
22
+ // Utils
23
+ export { ChineseNumberParser } from './utils/chinese-number-parser.js';
24
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"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"}
@@ -0,0 +1,12 @@
1
+ import type { PatternDefinition } from './pattern-definition.js';
2
+ /**
3
+ * Built-in pattern library — covers ≥80% Easy scenarios, ≥35 PatternDefinitions.
4
+ *
5
+ * Core design:
6
+ * 1. All patterns use named capture groups `(?<field>…)` or `(?<value>…)` to extract parameters
7
+ * 2. Separate Chinese/English patterns (don't mix keywords, avoids cross-language false matches)
8
+ * 3. High-specificity patterns have higher priority ("not empty" > "not")
9
+ * 4. Sorted by priority descending
10
+ */
11
+ export declare const BUILTIN_PATTERNS: PatternDefinition[];
12
+ //# sourceMappingURL=builtin-patterns.d.ts.map
@@ -0,0 +1 @@
1
+ {"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"}