@vybestack/llxprt-code-core 0.1.14 → 0.1.16

package/dist/src/prompt-config/TemplateEngine.test.js

@@ -0,0 +1,494 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { TemplateEngine } from './TemplateEngine.js';
+describe('TemplateEngine', () => {
+    let engine;
+    beforeEach(() => {
+        engine = new TemplateEngine();
+    });
+    describe('basic variable substitution', () => {
+        it('should substitute known variables with actual values', () => {
+            /**
+             * @requirement REQ-004.1, REQ-004.2
+             * @scenario Template contains MODEL and PROVIDER variables
+             * @given Template: "You are running on {{PROVIDER}} using model {{MODEL}}"
+             * @when processTemplate() called with variables
+             * @then Returns: "You are running on anthropic using model claude-3-opus"
+             */
+            const template = 'You are running on {{PROVIDER}} using model {{MODEL}}';
+            const variables = {
+                PROVIDER: 'anthropic',
+                MODEL: 'claude-3-opus',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('You are running on anthropic using model claude-3-opus');
+        });
+        it('should handle single variable substitution', () => {
+            /**
+             * @requirement REQ-004.1, REQ-004.2
+             * @scenario Template with only MODEL variable
+             * @given Template: "Current model: {{MODEL}}"
+             * @when processTemplate() called with MODEL value
+             * @then Returns: "Current model: gpt-4"
+             */
+            const template = 'Current model: {{MODEL}}';
+            const variables = {
+                MODEL: 'gpt-4',
+                PROVIDER: 'openai',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('Current model: gpt-4');
+        });
+    });
+    describe('optional variable handling', () => {
+        it('should handle optional TOOL_NAME variable when provided', () => {
+            /**
+             * @requirement REQ-004.2
+             * @scenario Template with optional TOOL_NAME
+             * @given Template with TOOL_NAME variable
+             * @when Variable provided in context
+             * @then Substitutes the tool name
+             */
+            const template = 'Use the {{TOOL_NAME}} tool carefully';
+            const variables = {
+                PROVIDER: 'gemini',
+                MODEL: 'gemini-pro',
+                TOOL_NAME: 'ReadFile',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('Use the ReadFile tool carefully');
+        });
+        it('should handle missing optional variables by replacing with empty string', () => {
+            /**
+             * @requirement REQ-004.2
+             * @scenario Template with optional variable not provided
+             * @given Template with TOOL_NAME but no value provided
+             * @when processTemplate called
+             * @then Replaces with empty string
+             */
+            const template = 'Tool: {{TOOL_NAME}} for {{PROVIDER}}';
+            const variables = {
+                PROVIDER: 'ollama',
+                MODEL: 'llama2',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('Tool:  for ollama');
+        });
+        it('should handle undefined variable values as empty strings', () => {
+            /**
+             * @requirement REQ-004.2
+             * @scenario Variable exists but value is undefined
+             * @given Template with variable whose value is undefined
+             * @when processTemplate called
+             * @then Treats undefined as empty string
+             */
+            const template = 'Provider: {{PROVIDER}}, Tool: {{TOOL_NAME}}';
+            const variables = {
+                PROVIDER: 'azure',
+                MODEL: 'gpt-35-turbo',
+                TOOL_NAME: undefined,
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('Provider: azure, Tool: ');
+        });
+    });
+    describe('malformed variable handling', () => {
+        it('should leave malformed variables unchanged', () => {
+            /**
+             * @requirement REQ-004.3
+             * @scenario Template contains malformed variable syntax
+             * @given Various malformed patterns
+             * @when processTemplate called
+             * @then Malformed parts remain unchanged
+             */
+            const template = 'Valid {{MODEL}} but {{BROKEN and {{UNCLOSED';
+            const variables = {
+                MODEL: 'gpt-4',
+                PROVIDER: 'openai',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('Valid gpt-4 but {{BROKEN and {{UNCLOSED');
+        });
+        it('should handle nested brackets without processing inner content', () => {
+            /**
+             * @requirement REQ-004.3
+             * @scenario Nested variable brackets
+             * @given Template with {{{{VAR}}}}
+             * @when processTemplate called
+             * @then Only outer brackets processed
+             */
+            const template = 'Nested {{{{MODEL}}}} here';
+            const variables = {
+                MODEL: 'claude',
+                PROVIDER: 'anthropic',
+            };
+            const result = engine.processTemplate(template, variables);
+            // Should process outer brackets, leaving {{claude}}
+            expect(result).toBe('Nested {{claude}} here');
+        });
+        it('should handle mismatched brackets', () => {
+            /**
+             * @requirement REQ-004.3
+             * @scenario Template with mismatched brackets
+             * @given }}{{MODEL}}{{ pattern
+             * @when processTemplate called
+             * @then Only properly formed variables substituted
+             */
+            const template = '}}Start {{MODEL}} End{{';
+            const variables = {
+                MODEL: 'llama-2',
+                PROVIDER: 'meta',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('}}Start llama-2 End{{');
+        });
+    });
+    describe('edge cases', () => {
+        it('should handle empty template', () => {
+            /**
+             * @requirement REQ-004.1
+             * @scenario Empty template string
+             * @given Empty string template
+             * @when processTemplate called
+             * @then Returns empty string
+             */
+            const result = engine.processTemplate('', {
+                MODEL: 'test',
+                PROVIDER: 'test',
+            });
+            expect(result).toBe('');
+        });
+        it('should handle template with no variables', () => {
+            /**
+             * @requirement REQ-004.1
+             * @scenario Template without any variables
+             * @given Plain text template
+             * @when processTemplate called
+             * @then Returns unchanged template
+             */
+            const template = 'This is plain text with no variables';
+            const result = engine.processTemplate(template, {
+                MODEL: 'test',
+                PROVIDER: 'test',
+            });
+            expect(result).toBe(template);
+        });
+        it('should handle variables at start and end of template', () => {
+            /**
+             * @requirement REQ-004.1
+             * @scenario Variables at boundaries
+             * @given Template starting and ending with variables
+             * @when processTemplate called
+             * @then All variables substituted correctly
+             */
+            const template = '{{PROVIDER}} is the provider and model is {{MODEL}}';
+            const variables = {
+                PROVIDER: 'azure',
+                MODEL: 'gpt-35-turbo',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('azure is the provider and model is gpt-35-turbo');
+        });
+        it('should handle null content', () => {
+            /**
+             * @requirement REQ-004.1
+             * @scenario Null template content
+             * @given null passed as template
+             * @when processTemplate called
+             * @then Returns empty string
+             */
+            const result = engine.processTemplate(null, {
+                MODEL: 'test',
+                PROVIDER: 'test',
+            });
+            expect(result).toBe('');
+        });
+        it('should handle undefined content', () => {
+            /**
+             * @requirement REQ-004.1
+             * @scenario Undefined template content
+             * @given undefined passed as template
+             * @when processTemplate called
+             * @then Returns empty string
+             */
+            const result = engine.processTemplate(undefined, {
+                MODEL: 'test',
+                PROVIDER: 'test',
+            });
+            expect(result).toBe('');
+        });
+        it('should handle null variables map', () => {
+            /**
+             * @requirement REQ-004.1
+             * @scenario Null variables map
+             * @given Valid template but null variables
+             * @when processTemplate called
+             * @then Variables treated as missing (empty string)
+             */
+            const template = 'Model: {{MODEL}}';
+            const result = engine.processTemplate(template, null);
+            expect(result).toBe('Model: ');
+        });
+        it('should handle undefined variables map', () => {
+            /**
+             * @requirement REQ-004.1
+             * @scenario Undefined variables map
+             * @given Valid template but undefined variables
+             * @when processTemplate called
+             * @then Variables treated as missing (empty string)
+             */
+            const template = 'Provider: {{PROVIDER}}';
+            const result = engine.processTemplate(template, undefined);
+            expect(result).toBe('Provider: ');
+        });
+    });
+    describe('complex templates', () => {
+        it('should handle multiple occurrences of same variable', () => {
+            /**
+             * @requirement REQ-004.1
+             * @scenario Same variable appears multiple times
+             * @given Template with repeated variables
+             * @when processTemplate called
+             * @then All occurrences substituted
+             */
+            const template = '{{MODEL}} is great. I repeat, {{MODEL}} is great!';
+            const variables = {
+                MODEL: 'claude-3',
+                PROVIDER: 'anthropic',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('claude-3 is great. I repeat, claude-3 is great!');
+        });
+        it('should handle adjacent variables', () => {
+            /**
+             * @requirement REQ-004.1
+             * @scenario Variables with no space between
+             * @given {{VAR1}}{{VAR2}}
+             * @when processTemplate called
+             * @then Both substituted correctly
+             */
+            const template = '{{PROVIDER}}{{MODEL}}';
+            const variables = {
+                PROVIDER: 'google/',
+                MODEL: 'palm2',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('google/palm2');
+        });
+        it('should handle all three variables in one template', () => {
+            /**
+             * @requirement REQ-004.2
+             * @scenario Template using all supported variables
+             * @given Template with PROVIDER, MODEL, and TOOL_NAME
+             * @when processTemplate called
+             * @then All variables substituted
+             */
+            const template = 'Using {{PROVIDER}} provider with {{MODEL}} model for {{TOOL_NAME}} tool';
+            const variables = {
+                PROVIDER: 'anthropic',
+                MODEL: 'claude-3-sonnet',
+                TOOL_NAME: 'WebSearch',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('Using anthropic provider with claude-3-sonnet model for WebSearch tool');
+        });
+        it('should handle variables with whitespace inside brackets', () => {
+            /**
+             * @requirement REQ-004.1
+             * @scenario Variables with internal whitespace
+             * @given {{ MODEL }} with spaces
+             * @when processTemplate called
+             * @then Whitespace trimmed, variable substituted
+             */
+            const template = 'Model: {{ MODEL }} and {{  PROVIDER  }}';
+            const variables = {
+                MODEL: 'gpt-4',
+                PROVIDER: 'openai',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('Model: gpt-4 and openai');
+        });
+    });
+    describe('special characters in values', () => {
+        it('should handle special characters in variable values', () => {
+            /**
+             * @requirement REQ-004.1
+             * @scenario Variable values contain special characters
+             * @given Values with quotes, brackets, etc
+             * @when processTemplate called
+             * @then Values inserted as-is
+             */
+            const template = 'Model: {{MODEL}}';
+            const variables = {
+                MODEL: 'model-with-"quotes"-and-{brackets}',
+                PROVIDER: 'test',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('Model: model-with-"quotes"-and-{brackets}');
+        });
+        it('should handle newlines in variable values', () => {
+            /**
+             * @requirement REQ-004.1
+             * @scenario Variable values contain newlines
+             * @given Values with line breaks
+             * @when processTemplate called
+             * @then Values inserted preserving newlines
+             */
+            const template = 'Description: {{MODEL}}';
+            const variables = {
+                MODEL: 'line1\nline2\nline3',
+                PROVIDER: 'test',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('Description: line1\nline2\nline3');
+        });
+        it('should handle unicode in variable values', () => {
+            /**
+             * @requirement REQ-004.1
+             * @scenario Variable values contain unicode
+             * @given Values with emoji and unicode characters
+             * @when processTemplate called
+             * @then Values inserted preserving unicode
+             */
+            const template = 'Model: {{MODEL}}';
+            const variables = {
+                MODEL: 'claude-3-🚀-日本語',
+                PROVIDER: 'anthropic',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('Model: claude-3-🚀-日本語');
+        });
+    });
+    describe('debug logging', () => {
+        let originalDebug;
+        let consoleSpy;
+        beforeEach(() => {
+            originalDebug = process.env.DEBUG;
+            consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        });
+        afterEach(() => {
+            process.env.DEBUG = originalDebug;
+            consoleSpy.mockRestore();
+        });
+        it('should log substitutions when DEBUG=1', () => {
+            /**
+             * @requirement REQ-010.4
+             * @scenario DEBUG environment variable is set
+             * @given DEBUG=1 and template with variables
+             * @when processTemplate called
+             * @then Logs variable substitutions
+             */
+            process.env.DEBUG = '1';
+            const template = 'Provider: {{PROVIDER}}';
+            const variables = {
+                PROVIDER: 'anthropic',
+                MODEL: 'claude',
+            };
+            engine.processTemplate(template, variables);
+            expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('PROVIDER'));
+        });
+        it('should not log when DEBUG is not set', () => {
+            /**
+             * @requirement REQ-010.4
+             * @scenario DEBUG environment variable is not set
+             * @given No DEBUG and template with variables
+             * @when processTemplate called
+             * @then No logging occurs
+             */
+            delete process.env.DEBUG;
+            const template = 'Provider: {{PROVIDER}}';
+            const variables = {
+                PROVIDER: 'anthropic',
+                MODEL: 'claude',
+            };
+            engine.processTemplate(template, variables);
+            expect(consoleSpy).not.toHaveBeenCalled();
+        });
+        it('should log through options when debug option is true', () => {
+            /**
+             * @requirement REQ-010.4
+             * @scenario Debug option passed explicitly
+             * @given options.debug = true
+             * @when processTemplate called
+             * @then Logs variable substitutions
+             */
+            const template = 'Model: {{MODEL}}';
+            const variables = {
+                MODEL: 'gpt-4',
+                PROVIDER: 'openai',
+            };
+            const options = { debug: true };
+            engine.processTemplate(template, variables, options);
+            expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('MODEL'));
+        });
+        it('should log multiple substitutions', () => {
+            /**
+             * @requirement REQ-010.4
+             * @scenario Multiple variables substituted
+             * @given Template with multiple variables and DEBUG=1
+             * @when processTemplate called
+             * @then Logs each substitution
+             */
+            process.env.DEBUG = '1';
+            const template = '{{PROVIDER}} uses {{MODEL}} with {{TOOL_NAME}}';
+            const variables = {
+                PROVIDER: 'google',
+                MODEL: 'gemini-pro',
+                TOOL_NAME: 'Search',
+            };
+            engine.processTemplate(template, variables);
+            expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('PROVIDER'));
+            expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('MODEL'));
+            expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('TOOL_NAME'));
+        });
+    });
+    describe('variable extraction edge cases', () => {
+        it('should handle empty variable names', () => {
+            /**
+             * @requirement REQ-004.3
+             * @scenario Empty variable name between brackets
+             * @given Template with {{}}
+             * @when processTemplate called
+             * @then Empty brackets left unchanged
+             */
+            const template = 'Empty {{}} variable';
+            const variables = { MODEL: 'test', PROVIDER: 'test' };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('Empty {{}} variable');
+        });
+        it('should handle very long variable names', () => {
+            /**
+             * @requirement REQ-004.1
+             * @scenario Variable with very long name
+             * @given Template with 100+ character variable name
+             * @when processTemplate called
+             * @then Variable processed normally
+             */
+            const longVarName = 'A'.repeat(100);
+            const template = `Long {{${longVarName}}} variable`;
+            const variables = {
+                [longVarName]: 'replaced',
+                MODEL: 'test',
+                PROVIDER: 'test',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('Long replaced variable');
+        });
+        it('should handle consecutive bracket patterns', () => {
+            /**
+             * @requirement REQ-004.1
+             * @scenario Multiple {{ }} patterns in sequence
+             * @given {{{{}}}}{{MODEL}}{{{{}}}}
+             * @when processTemplate called
+             * @then Only valid variables substituted
+             */
+            const template = '{{{{}}}}{{MODEL}}{{{{}}}}';
+            const variables = {
+                MODEL: 'claude',
+                PROVIDER: 'anthropic',
+            };
+            const result = engine.processTemplate(template, variables);
+            expect(result).toBe('{{{{}}}}claude{{{{}}}}');
+        });
+    });
+});
+//# sourceMappingURL=TemplateEngine.test.js.map

package/dist/src/prompt-config/TemplateEngine.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateEngine.test.js","sourceRoot":"","sources":["../../../src/prompt-config/TemplateEngine.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAI,MAAsB,CAAC;IAE3B,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;QAC3C,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,uDAAuD,CAAC;YACzE,MAAM,SAAS,GAAsB;gBACnC,QAAQ,EAAE,WAAW;gBACrB,KAAK,EAAE,eAAe;aACvB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CACjB,wDAAwD,CACzD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,0BAA0B,CAAC;YAC5C,MAAM,SAAS,GAAsB;gBACnC,KAAK,EAAE,OAAO;gBACd,QAAQ,EAAE,QAAQ;aACnB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAC1C,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;YACjE;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,sCAAsC,CAAC;YACxD,MAAM,SAAS,GAAsB;gBACnC,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,YAAY;gBACnB,SAAS,EAAE,UAAU;aACtB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;YACjF;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,sCAAsC,CAAC;YACxD,MAAM,SAAS,GAAsB;gBACnC,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,QAAQ;aAChB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;YAClE;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,6CAA6C,CAAC;YAC/D,MAAM,SAAS,GAAsB;gBACnC,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,cAAc;gBACrB,SAAS,EAAE,SAA8B;aAC1C,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;QAC3C,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,6CAA6C,CAAC;YAC/D,MAAM,SAAS,GAAsB;gBACnC,KAAK,EAAE,OAAO;gBACd,QAAQ,EAAE,QAAQ;aACnB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;YACxE;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,2BAA2B,CAAC;YAC7C,MAAM,SAAS,GAAsB;gBACnC,KAAK,EAAE,QAAQ;gBACf,QAAQ,EAAE,WAAW;aACtB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,oDAAoD;YACpD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,yBAAyB,CAAC;YAC3C,MAAM,SAAS,GAAsB;gBACnC,KAAK,EAAE,SAAS;gBAChB,QAAQ,EAAE,MAAM;aACjB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC;;;;;;eAMG;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE;gBACxC,KAAK,EAAE,MAAM;gBACb,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,sCAAsC,CAAC;YACxD,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE;gBAC9C,KAAK,EAAE,MAAM;gBACb,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,qDAAqD,CAAC;YACvE,MAAM,SAAS,GAAsB;gBACnC,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,cAAc;aACtB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC;;;;;;eAMG;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,IAAyB,EAAE;gBAC/D,KAAK,EAAE,MAAM;gBACb,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC;;;;;;eAMG;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,SAA8B,EAAE;gBACpE,KAAK,EAAE,MAAM;gBACb,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,kBAAkB,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CACnC,QAAQ,EACR,IAAoC,CACrC,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,wBAAwB,CAAC;YAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CACnC,QAAQ,EACR,SAAyC,CAC1C,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC7D;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,mDAAmD,CAAC;YACrE,MAAM,SAAS,GAAsB;gBACnC,KAAK,EAAE,UAAU;gBACjB,QAAQ,EAAE,WAAW;aACtB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,uBAAuB,CAAC;YACzC,MAAM,SAAS,GAAsB;gBACnC,QAAQ,EAAE,SAAS;gBACnB,KAAK,EAAE,OAAO;aACf,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D;;;;;;eAMG;YACH,MAAM,QAAQ,GACZ,yEAAyE,CAAC;YAC5E,MAAM,SAAS,GAAsB;gBACnC,QAAQ,EAAE,WAAW;gBACrB,KAAK,EAAE,iBAAiB;gBACxB,SAAS,EAAE,WAAW;aACvB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CACjB,wEAAwE,CACzE,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;YACjE;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,yCAAyC,CAAC;YAC3D,MAAM,SAAS,GAAsB;gBACnC,KAAK,EAAE,OAAO;gBACd,QAAQ,EAAE,QAAQ;aACnB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;QAC5C,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC7D;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,kBAAkB,CAAC;YACpC,MAAM,SAAS,GAAsB;gBACnC,KAAK,EAAE,oCAAoC;gBAC3C,QAAQ,EAAE,MAAM;aACjB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,wBAAwB,CAAC;YAC1C,MAAM,SAAS,GAAsB;gBACnC,KAAK,EAAE,qBAAqB;gBAC5B,QAAQ,EAAE,MAAM;aACjB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,kBAAkB,CAAC;YACpC,MAAM,SAAS,GAAsB;gBACnC,KAAK,EAAE,iBAAiB;gBACxB,QAAQ,EAAE,WAAW;aACtB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,IAAI,aAAiC,CAAC;QACtC,IAAI,UAAuC,CAAC;QAE5C,UAAU,CAAC,GAAG,EAAE;YACd,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAClC,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,SAAS,CAAC,GAAG,EAAE;YACb,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,aAAa,CAAC;YAClC,UAAU,CAAC,WAAW,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C;;;;;;eAMG;YACH,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC;YAExB,MAAM,QAAQ,GAAG,wBAAwB,CAAC;YAC1C,MAAM,SAAS,GAAsB;gBACnC,QAAQ,EAAE,WAAW;gBACrB,KAAK,EAAE,QAAQ;aAChB,CAAC;YAEF,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE5C,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CACrC,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CACpC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C;;;;;;eAMG;YACH,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAEzB,MAAM,QAAQ,GAAG,wBAAwB,CAAC;YAC1C,MAAM,SAAS,GAAsB;gBACnC,QAAQ,EAAE,WAAW;gBACrB,KAAK,EAAE,QAAQ;aAChB,CAAC;YAEF,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE5C,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,kBAAkB,CAAC;YACpC,MAAM,SAAS,GAAsB;gBACnC,KAAK,EAAE,OAAO;gBACd,QAAQ,EAAE,QAAQ;aACnB,CAAC;YACF,MAAM,OAAO,GAA8B,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YAE3D,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAErD,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C;;;;;;eAMG;YACH,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC;YAExB,MAAM,QAAQ,GAAG,gDAAgD,CAAC;YAClE,MAAM,SAAS,GAAsB;gBACnC,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,YAAY;gBACnB,SAAS,EAAE,QAAQ;aACpB,CAAC;YAEF,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE5C,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CACrC,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CACpC,CAAC;YACF,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;YAC1E,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CACrC,MAAM,CAAC,gBAAgB,CAAC,WAAW,CAAC,CACrC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;QAC9C,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,qBAAqB,CAAC;YACvC,MAAM,SAAS,GAAsB,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YAEzE,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD;;;;;;eAMG;YACH,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,QAAQ,GAAG,UAAU,WAAW,aAAa,CAAC;YACpD,MAAM,SAAS,GAAsB;gBACnC,CAAC,WAAW,CAAC,EAAE,UAAU;gBACzB,KAAK,EAAE,MAAM;gBACb,QAAQ,EAAE,MAAM;aACjB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,2BAA2B,CAAC;YAC7C,MAAM,SAAS,GAAsB;gBACnC,KAAK,EAAE,QAAQ;gBACf,QAAQ,EAAE,WAAW;aACtB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE3D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/prompt-config/defaults/compression.md

@@ -0,0 +1,58 @@
+You are the component that summarizes internal chat history into a given structure.
+
+When the conversation history grows too large, you will be invoked to distill the entire history into a concise, structured XML snapshot. This snapshot is CRITICAL, as it will become the agent's _only_ memory of the past. The agent will resume its work based solely on this snapshot. All crucial details, plans, errors, and user directives MUST be preserved.
+
+First, you will think through the entire history in a private <scratchpad>. Review the user's overall goal, the agent's actions, tool outputs, file modifications, and any unresolved questions. Identify every piece of information that is essential for future actions.
+
+After your reasoning is complete, generate the final <state_snapshot> XML object. Be incredibly dense with information. Omit any irrelevant conversational filler.
+
+The structure MUST be as follows:
+
+<state_snapshot>
+<overall_goal>
+
+<!-- A single, concise sentence describing the user's high-level objective. -->
+<!-- Example: "Refactor the authentication service to use a new JWT library." -->
+
+</overall_goal>
+
+    <key_knowledge>
+        <!-- Crucial facts, conventions, and constraints the agent must remember based on the conversation history and interaction with the user. Use bullet points. -->
+        <!-- Example:
+         - Build Command: \`npm run build\`
+         - Testing: Tests are run with \`npm test\`. Test files must end in \`.test.ts\`.
+         - API Endpoint: The primary API endpoint is \`https://api.example.com/v2\`.
+
+        -->
+    </key_knowledge>
+
+    <file_system_state>
+        <!-- List files that have been created, read, modified, or deleted. Note their status and critical learnings. -->
+        <!-- Example:
+         - CWD: \`/home/user/project/src\`
+         - READ: \`package.json\` - Confirmed 'axios' is a dependency.
+         - MODIFIED: \`services/auth.ts\` - Replaced 'jsonwebtoken' with 'jose'.
+         - CREATED: \`tests/new-feature.test.ts\` - Initial test structure for the new feature.
+        -->
+    </file_system_state>
+
+    <recent_actions>
+        <!-- A summary of the last few significant agent actions and their outcomes. Focus on facts. -->
+        <!-- Example:
+         - Ran \`grep 'old_function'\` which returned 3 results in 2 files.
+         - Ran \`npm run test\`, which failed due to a snapshot mismatch in \`UserProfile.test.ts\`.
+         - Ran \`ls -F static/\` and discovered image assets are stored as \`.webp\`.
+        -->
+    </recent_actions>
+
+    <current_plan>
+        <!-- The agent's step-by-step plan. Mark completed steps. -->
+        <!-- Example:
+         1. [DONE] Identify all files using the deprecated 'UserAPI'.
+         2. [IN PROGRESS] Refactor \`src/components/UserProfile.tsx\` to use the new 'ProfileAPI'.
+         3. [TODO] Refactor the remaining files.
+         4. [TODO] Update tests to reflect the API change.
+        -->
+    </current_plan>
+
+</state_snapshot>

package/dist/src/prompt-config/defaults/core-defaults.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Core and environment default prompts
+ * These constants contain the default content for core system prompts
+ */
+export declare const CORE_DEFAULTS: Record<string, string>;