Implement layer composition feature in Promptix

prompts/CodeReviewer/versions/v009.md

@@ -0,0 +1,5 @@
+You are a code review assistant specialized in {{programming_language}}. Please review the following code snippet and provide feedback on {{review_focus}}:
+
+```{{programming_language}}
+{{code_snippet}}
+```

prompts/ComplexCodeReviewer/versions/v008.md

@@ -0,0 +1,7 @@
+You are a code review assistant with active tools: {{active_tools}}. Specialized in {{programming_language}}. Review the code with {{severity}} scrutiny focusing on {{review_focus}}:
+
+```{{programming_language}}
+{{code_snippet}}
+```
+
+Provide feedback in: 'Summary', 'Critical Issues', 'Improvements', 'Positives'.

prompts/SimpleChat/versions/v009.md

@@ -0,0 +1 @@
+You are a helpful AI assistant named {{assistant_name}}. Your goal is to provide clear and concise answers to {{user_name}}'s questions.

prompts/TemplateDemo/versions/v008.md

@@ -0,0 +1,16 @@
+You are creating a {{content_type}} about {{theme}}.
+
+{% if difficulty == 'beginner' %}
+Keep it simple and accessible for beginners.
+{% elif difficulty == 'intermediate' %}
+Include some advanced concepts but explain them clearly.
+{% else %}
+Don't hold back on technical details and advanced concepts.
+{% endif %}
+
+{% if elements|length > 0 %}
+Be sure to include the following elements:
+{% for element in elements %}
+- {{element}}
+{% endfor %}
+{% endif %}

prompts/simple_chat/versions/v008.md

@@ -0,0 +1,11 @@
+You are a {{personality}} assistant specialized in {{domain}}.
+
+Your role is to provide helpful, accurate, and engaging responses to user questions and requests. Always maintain a professional and friendly tone while adapting to the user's needs.
+
+Key guidelines:
+- Be concise but thorough in your explanations
+- Ask clarifying questions when needed
+- Provide examples when helpful
+- Stay focused on the {{domain}} domain when specified
+
+How can I help you today?

src/promptix/core/base.py

@@ -5,14 +5,15 @@
 focused components and dependency injection for better testability and modularity.
 """
 
-from typing import Any, Dict, Optional, List
+from typing import Any, Dict, List, Optional, Tuple, Union
 from .container import get_container
 from .components import (
     PromptLoader,
     VariableValidator,
     TemplateRenderer,
     VersionManager,
-    ModelConfigBuilder
+    ModelConfigBuilder,
+    LayerComposer,
 )
 from .exceptions import PromptNotFoundError, ConfigurationError, StorageError
 
@@ -38,16 +39,16 @@ def __init__(self, container=None):
     @classmethod
     def get_prompt(cls, prompt_template: str, version: Optional[str] = None, **variables) -> str:
         """Get a prompt by name and fill in the variables.
-        
+
         Args:
             prompt_template (str): The name of the prompt template to use
-            version (Optional[str]): Specific version to use (e.g. "v1"). 
+            version (Optional[str]): Specific version to use (e.g. "v1").
                                      If None, uses the latest live version.
             **variables: Variable key-value pairs to fill in the prompt template
-            
+
         Returns:
             str: The rendered prompt
-            
+
         Raises:
             PromptNotFoundError: If the prompt template is not found
             RequiredVariableError: If required variables are missing
@@ -56,7 +57,118 @@ def get_prompt(cls, prompt_template: str, version: Optional[str] = None, **varia
         """
         instance = cls()
         return instance.render_prompt(prompt_template, version, **variables)
-
+
+    @classmethod
+    def get_composed_prompt(
+        cls,
+        prompt_template: str,
+        version: Optional[str] = None,
+        layer_versions: Optional[Dict[str, str]] = None,
+        skip_layers: Optional[List[str]] = None,
+        _debug: bool = False,
+        **variables
+    ) -> Union[str, Tuple[str, Any]]:
+        """Get a prompt with layer composition.
+
+        Layers are automatically selected based on variables that match
+        layer configuration in config.yaml. For example, if config defines
+        a layer with variable='oem', passing oem='honda' will apply the
+        honda layer.
+
+        Args:
+            prompt_template: Name of the prompt template.
+            version: Base template version (None = current).
+            layer_versions: Override versions for specific layers.
+            skip_layers: Layer names to skip.
+            _debug: If True, returns tuple of (prompt, debug_info).
+            **variables: Template variables (also used for layer selection).
+
+        Returns:
+            Fully composed and rendered prompt string.
+            If _debug is True, returns tuple of (prompt, CompositionDebugInfo).
+
+        Raises:
+            PromptNotFoundError: If the prompt template is not found.
+            LayerRequiredError: If a required layer variable is not provided.
+            TemplateRenderError: If template rendering fails.
+            ConfigurationError: If configuration is invalid.
+
+        Example:
+            prompt = Promptix.get_composed_prompt(
+                prompt_template="ServiceAgent",
+                store_name="Honda World",
+                store_type="automotive",  # Selects automotive layer
+                oem="honda",              # Selects honda layer
+                locale="es-MX"            # Selects Spanish locale layer
+            )
+        """
+        instance = cls()
+        return instance.compose_prompt(
+            prompt_template=prompt_template,
+            version=version,
+            layer_versions=layer_versions,
+            skip_layers=skip_layers,
+            _debug=_debug,
+            **variables
+        )
+
+    def compose_prompt(
+        self,
+        prompt_template: str,
+        version: Optional[str] = None,
+        layer_versions: Optional[Dict[str, str]] = None,
+        skip_layers: Optional[List[str]] = None,
+        _debug: bool = False,
+        **variables
+    ) -> Union[str, Tuple[str, Any]]:
+        """Compose a prompt with layer overrides.
+
+        Args:
+            prompt_template: Name of the prompt template.
+            version: Base template version (None = current).
+            layer_versions: Override versions for specific layers.
+            skip_layers: Layer names to skip.
+            _debug: If True, returns tuple of (prompt, debug_info).
+            **variables: Template variables (also used for layer selection).
+
+        Returns:
+            Fully composed and rendered prompt string.
+            If _debug is True, returns tuple of (prompt, CompositionDebugInfo).
+        """
+        layer_composer = self._container.get_typed("layer_composer", LayerComposer)
+
+        return layer_composer.compose(
+            prompt_name=prompt_template,
+            variables=variables,
+            base_version=version,
+            layer_versions=layer_versions,
+            skip_layers=skip_layers,
+            _debug=_debug
+        )
+
+    @classmethod
+    def list_layers(cls, prompt_template: str) -> Dict[str, List[str]]:
+        """List available layers and their values for a prompt.
+
+        Args:
+            prompt_template: Name of the prompt template.
+
+        Returns:
+            Dict mapping layer names to lists of available values.
+
+        Example:
+            layers = Promptix.list_layers("ServiceAgent")
+            # Returns:
+            # {
+            #     "store_type": ["automotive", "powersports", "marine"],
+            #     "oem": ["honda", "toyota", "harley"],
+            #     "locale": ["en-US", "es-MX", "fr-CA"]
+            # }
+        """
+        instance = cls()
+        layer_composer = instance._container.get_typed("layer_composer", LayerComposer)
+        return layer_composer.list_layers(prompt_template)
+
     def render_prompt(self, prompt_template: str, version: Optional[str] = None, **variables) -> str:
         """Render a prompt with the provided variables.
 

src/promptix/core/components/__init__.py

@@ -10,11 +10,13 @@
 from .template_renderer import TemplateRenderer
 from .version_manager import VersionManager
 from .model_config_builder import ModelConfigBuilder
+from .layer_composer import LayerComposer
 
 __all__ = [
     "PromptLoader",
-    "VariableValidator", 
+    "VariableValidator",
     "TemplateRenderer",
     "VersionManager",
-    "ModelConfigBuilder"
+    "ModelConfigBuilder",
+    "LayerComposer",
 ]