signalwire-agents 0.1.46__tar.gz → 0.1.47__tar.gz

{signalwire_agents-0.1.46/signalwire_agents.egg-info → signalwire_agents-0.1.47}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: signalwire_agents
-Version: 0.1.46
+Version: 0.1.47
 Summary: SignalWire AI Agents SDK
 Author-email: SignalWire Team <info@signalwire.com>
 License: MIT
@@ -664,6 +664,7 @@ class PreciseAgent(AgentBase):
         self.prompt_add_section("Instructions", "Provide accurate, detailed information.")
         
         # Set custom LLM parameters for the main prompt
+        # These parameters are passed to the server which validates them based on the model
         self.set_prompt_llm_params(
             temperature=0.3,        # Low temperature for more consistent responses
             top_p=0.9,             # Slightly reduced for focused responses
@@ -685,13 +686,17 @@ agent = PreciseAgent()
 agent.serve()
 ```
 
-#### Available LLM Parameters
+#### Common LLM Parameters
 
-- **temperature** (0.0-1.5): Controls randomness. Lower = more focused, higher = more creative
-- **top_p** (0.0-1.0): Nucleus sampling. Lower = more focused on likely tokens
-- **barge_confidence** (0.0-1.0): ASR confidence to interrupt. Higher = harder to interrupt
-- **presence_penalty** (-2.0-2.0): Topic diversity. Positive = new topics
-- **frequency_penalty** (-2.0-2.0): Repetition control. Positive = varied vocabulary
+The SDK accepts any parameters which are passed to the server for validation based on the model. Common parameters include:
+
+- **temperature**: Controls randomness. Lower = more focused, higher = more creative
+- **top_p**: Nucleus sampling. Lower = more focused on likely tokens
+- **barge_confidence**: ASR confidence to interrupt. Higher = harder to interrupt (main prompt only)
+- **presence_penalty**: Topic diversity. Positive = new topics
+- **frequency_penalty**: Repetition control. Positive = varied vocabulary
+
+Note: No defaults are sent unless explicitly set. The server handles validation and applies appropriate defaults based on the model.
 
 For more details on LLM parameter tuning, see [LLM Parameters Guide](docs/llm_parameters.md).
 

{signalwire_agents-0.1.46 → signalwire_agents-0.1.47}/README.md

@@ -572,6 +572,7 @@ class PreciseAgent(AgentBase):
         self.prompt_add_section("Instructions", "Provide accurate, detailed information.")
         
         # Set custom LLM parameters for the main prompt
+        # These parameters are passed to the server which validates them based on the model
         self.set_prompt_llm_params(
             temperature=0.3,        # Low temperature for more consistent responses
             top_p=0.9,             # Slightly reduced for focused responses
@@ -593,13 +594,17 @@ agent = PreciseAgent()
 agent.serve()
 ```
 
-#### Available LLM Parameters
+#### Common LLM Parameters
 
-- **temperature** (0.0-1.5): Controls randomness. Lower = more focused, higher = more creative
-- **top_p** (0.0-1.0): Nucleus sampling. Lower = more focused on likely tokens
-- **barge_confidence** (0.0-1.0): ASR confidence to interrupt. Higher = harder to interrupt
-- **presence_penalty** (-2.0-2.0): Topic diversity. Positive = new topics
-- **frequency_penalty** (-2.0-2.0): Repetition control. Positive = varied vocabulary
+The SDK accepts any parameters which are passed to the server for validation based on the model. Common parameters include:
+
+- **temperature**: Controls randomness. Lower = more focused, higher = more creative
+- **top_p**: Nucleus sampling. Lower = more focused on likely tokens
+- **barge_confidence**: ASR confidence to interrupt. Higher = harder to interrupt (main prompt only)
+- **presence_penalty**: Topic diversity. Positive = new topics
+- **frequency_penalty**: Repetition control. Positive = varied vocabulary
+
+Note: No defaults are sent unless explicitly set. The server handles validation and applies appropriate defaults based on the model.
 
 For more details on LLM parameter tuning, see [LLM Parameters Guide](docs/llm_parameters.md).
 

{signalwire_agents-0.1.46 → signalwire_agents-0.1.47}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "signalwire_agents"
-version = "0.1.46"
+version = "0.1.47"
 description = "SignalWire AI Agents SDK"
 authors = [
     {name = "SignalWire Team", email = "info@signalwire.com"}

{signalwire_agents-0.1.46 → signalwire_agents-0.1.47}/signalwire_agents/__init__.py

@@ -18,7 +18,7 @@ A package for building AI agents using SignalWire's AI and SWML capabilities.
 from .core.logging_config import configure_logging
 configure_logging()
 
-__version__ = "0.1.46"
+__version__ = "0.1.47"
 
 # Import core classes for easier access
 from .core.agent_base import AgentBase

{signalwire_agents-0.1.46 → signalwire_agents-0.1.47}/signalwire_agents/cli/build_search.py

@@ -66,6 +66,11 @@ Examples:
   sw-search ./docs \\
     --chunking-strategy qa
 
+
+  # JSON-based chunking (pre-chunked content)
+  sw-search ./api_chunks.json \
+    --chunking-strategy json \
+    --file-types json
   # Full configuration example
   sw-search ./docs ./examples README.md \\
     --output ./knowledge.swsearch \\
@@ -141,7 +146,7 @@ Examples:
     
     parser.add_argument(
         '--chunking-strategy',
-        choices=['sentence', 'sliding', 'paragraph', 'page', 'semantic', 'topic', 'qa'],
+        choices=['sentence', 'sliding', 'paragraph', 'page', 'semantic', 'topic', 'qa', 'json'],
         default='sentence',
         help='Chunking strategy to use (default: sentence)'
     )

{signalwire_agents-0.1.46 → signalwire_agents-0.1.47}/signalwire_agents/core/agent_base.py

@@ -250,20 +250,9 @@ class AgentBase(
         self._params = {}
         self._global_data = {}
         self._function_includes = []
-        # Initialize with default LLM params
-        self._prompt_llm_params = {
-            'temperature': 0.3,
-            'top_p': 1.0,
-            'barge_confidence': 0.0,
-            'presence_penalty': 0.1,
-            'frequency_penalty': 0.1
-        }
-        self._post_prompt_llm_params = {
-            'temperature': 0.0,
-            'top_p': 1.0,
-            'presence_penalty': 0.0,
-            'frequency_penalty': 0.0
-        }
+        # Initialize LLM params as empty - only send if explicitly set
+        self._prompt_llm_params = {}
+        self._post_prompt_llm_params = {}
         
         # Dynamic configuration callback
         self._dynamic_config_callback = None
@@ -692,7 +681,7 @@ class AgentBase(
                     "parameters": func._ensure_parameter_structure()
                 }
                 
-                # Add wait_file if present (SignalWire SWML expects wait_file, not fillers)
+                # Add wait_file if present (audio/video file URL)
                 if hasattr(func, 'wait_file') and func.wait_file:
                     wait_file_url = func.wait_file
                     # If wait_file is a relative URL, convert it to absolute using agent's base URL
@@ -704,9 +693,10 @@ class AgentBase(
                             wait_file_url = '/' + wait_file_url
                         wait_file_url = f"{base_url}{wait_file_url}"
                     function_entry["wait_file"] = wait_file_url
-                elif func.fillers:
-                    # Backward compatibility: use fillers as wait_file if wait_file not specified
-                    function_entry["wait_file"] = func.fillers
+                
+                # Add fillers if present (text phrases to say while processing)
+                if hasattr(func, 'fillers') and func.fillers:
+                    function_entry["fillers"] = func.fillers
                 
                 # Add wait_file_loops if present
                 if hasattr(func, 'wait_file_loops') and func.wait_file_loops is not None:
@@ -833,27 +823,29 @@ class AgentBase(
                 
                 # Always add LLM parameters to prompt
                 if "prompt" in ai_config:
-                    # Update existing prompt with LLM params
-                    if isinstance(ai_config["prompt"], dict):
-                        ai_config["prompt"].update(agent_to_use._prompt_llm_params)
-                    elif isinstance(ai_config["prompt"], str):
-                        # Convert string prompt to dict format
-                        ai_config["prompt"] = {
-                            "text": ai_config["prompt"],
-                            **agent_to_use._prompt_llm_params
-                        }
+                    # Only add LLM params if explicitly set
+                    if agent_to_use._prompt_llm_params:
+                        if isinstance(ai_config["prompt"], dict):
+                            ai_config["prompt"].update(agent_to_use._prompt_llm_params)
+                        elif isinstance(ai_config["prompt"], str):
+                            # Convert string prompt to dict format
+                            ai_config["prompt"] = {
+                                "text": ai_config["prompt"],
+                                **agent_to_use._prompt_llm_params
+                            }
                     
-                # Always add LLM parameters to post_prompt if post_prompt exists
+                # Only add LLM parameters to post_prompt if explicitly set
                 if post_prompt and "post_prompt" in ai_config:
-                    # Update existing post_prompt with LLM params
-                    if isinstance(ai_config["post_prompt"], dict):
-                        ai_config["post_prompt"].update(agent_to_use._post_prompt_llm_params)
-                    elif isinstance(ai_config["post_prompt"], str):
-                        # Convert string post_prompt to dict format
-                        ai_config["post_prompt"] = {
-                            "text": ai_config["post_prompt"],
-                            **agent_to_use._post_prompt_llm_params
-                        }
+                    # Only add LLM params if explicitly set
+                    if agent_to_use._post_prompt_llm_params:
+                        if isinstance(ai_config["post_prompt"], dict):
+                            ai_config["post_prompt"].update(agent_to_use._post_prompt_llm_params)
+                        elif isinstance(ai_config["post_prompt"], str):
+                            # Convert string post_prompt to dict format
+                            ai_config["post_prompt"] = {
+                                "text": ai_config["post_prompt"],
+                                **agent_to_use._post_prompt_llm_params
+                            }
                     
             except ValueError as e:
                 if not agent_to_use._suppress_logs:

{signalwire_agents-0.1.46 → signalwire_agents-0.1.47}/signalwire_agents/core/mixins/ai_config_mixin.py

@@ -372,28 +372,22 @@ class AIConfigMixin:
             self._function_includes = valid_includes
         return self
     
-    def set_prompt_llm_params(
-        self,
-        temperature: Optional[float] = None,
-        top_p: Optional[float] = None,
-        barge_confidence: Optional[float] = None,
-        presence_penalty: Optional[float] = None,
-        frequency_penalty: Optional[float] = None
-    ) -> 'AgentBase':
+    def set_prompt_llm_params(self, **params) -> 'AgentBase':
         """
         Set LLM parameters for the main prompt.
         
-        Args:
-            temperature: Randomness setting (0.0-1.5). Lower values make output more deterministic.
-                        Default: 0.3
-            top_p: Alternative to temperature (0.0-1.0). Controls nucleus sampling.
-                   Default: 1.0
-            barge_confidence: ASR confidence to interrupt (0.0-1.0). Higher values make it harder to interrupt.
-                             Default: 0.0
-            presence_penalty: Topic diversity (-2.0 to 2.0). Positive values encourage new topics.
-                             Default: 0.1
-            frequency_penalty: Repetition control (-2.0 to 2.0). Positive values reduce repetition.
-                              Default: 0.1
+        Accepts any parameters which will be passed through to the SignalWire server.
+        The server will validate and apply parameters based on the target model's capabilities.
+        
+        Common parameters include:
+            temperature: Randomness setting. Lower values make output more deterministic.
+            top_p: Alternative to temperature. Controls nucleus sampling.
+            barge_confidence: ASR confidence to interrupt. Higher values make it harder to interrupt.
+            presence_penalty: Topic diversity. Positive values encourage new topics.
+            frequency_penalty: Repetition control. Positive values reduce repetition.
+        
+        Note: Parameters are model-specific and will be validated by the server.
+        Invalid parameters for the selected model will be handled/ignored by the server.
         
         Returns:
             Self for method chaining
@@ -405,57 +399,28 @@ class AIConfigMixin:
                 barge_confidence=0.6
             )
         """
-        # Validate and set temperature
-        if temperature is not None:
-            if not 0.0 <= temperature <= 1.5:
-                raise ValueError("temperature must be between 0.0 and 1.5")
-            self._prompt_llm_params['temperature'] = temperature
-        
-        # Validate and set top_p
-        if top_p is not None:
-            if not 0.0 <= top_p <= 1.0:
-                raise ValueError("top_p must be between 0.0 and 1.0")
-            self._prompt_llm_params['top_p'] = top_p
-        
-        # Validate and set barge_confidence
-        if barge_confidence is not None:
-            if not 0.0 <= barge_confidence <= 1.0:
-                raise ValueError("barge_confidence must be between 0.0 and 1.0")
-            self._prompt_llm_params['barge_confidence'] = barge_confidence
-        
-        # Validate and set presence_penalty
-        if presence_penalty is not None:
-            if not -2.0 <= presence_penalty <= 2.0:
-                raise ValueError("presence_penalty must be between -2.0 and 2.0")
-            self._prompt_llm_params['presence_penalty'] = presence_penalty
-        
-        # Validate and set frequency_penalty
-        if frequency_penalty is not None:
-            if not -2.0 <= frequency_penalty <= 2.0:
-                raise ValueError("frequency_penalty must be between -2.0 and 2.0")
-            self._prompt_llm_params['frequency_penalty'] = frequency_penalty
+        # Accept any parameters without validation
+        if params:
+            self._prompt_llm_params.update(params)
         
         return self
     
-    def set_post_prompt_llm_params(
-        self,
-        temperature: Optional[float] = None,
-        top_p: Optional[float] = None,
-        presence_penalty: Optional[float] = None,
-        frequency_penalty: Optional[float] = None
-    ) -> 'AgentBase':
+    def set_post_prompt_llm_params(self, **params) -> 'AgentBase':
         """
         Set LLM parameters for the post-prompt.
         
-        Args:
-            temperature: Randomness setting (0.0-1.5). Lower values make output more deterministic.
-                        Default: 0.0
-            top_p: Alternative to temperature (0.0-1.0). Controls nucleus sampling.
-                   Default: 1.0
-            presence_penalty: Topic diversity (-2.0 to 2.0). Positive values encourage new topics.
-                             Default: 0.0
-            frequency_penalty: Repetition control (-2.0 to 2.0). Positive values reduce repetition.
-                              Default: 0.0
+        Accepts any parameters which will be passed through to the SignalWire server.
+        The server will validate and apply parameters based on the target model's capabilities.
+        
+        Common parameters include:
+            temperature: Randomness setting. Lower values make output more deterministic.
+            top_p: Alternative to temperature. Controls nucleus sampling.
+            presence_penalty: Topic diversity. Positive values encourage new topics.
+            frequency_penalty: Repetition control. Positive values reduce repetition.
+        
+        Note: Parameters are model-specific and will be validated by the server.
+        Invalid parameters for the selected model will be handled/ignored by the server.
+        barge_confidence is not applicable to post-prompt.
         
         Returns:
             Self for method chaining
@@ -466,28 +431,8 @@ class AIConfigMixin:
                 top_p=0.9
             )
         """
-        # Validate and set temperature
-        if temperature is not None:
-            if not 0.0 <= temperature <= 1.5:
-                raise ValueError("temperature must be between 0.0 and 1.5")
-            self._post_prompt_llm_params['temperature'] = temperature
-        
-        # Validate and set top_p
-        if top_p is not None:
-            if not 0.0 <= top_p <= 1.0:
-                raise ValueError("top_p must be between 0.0 and 1.0")
-            self._post_prompt_llm_params['top_p'] = top_p
-        
-        # Validate and set presence_penalty
-        if presence_penalty is not None:
-            if not -2.0 <= presence_penalty <= 2.0:
-                raise ValueError("presence_penalty must be between -2.0 and 2.0")
-            self._post_prompt_llm_params['presence_penalty'] = presence_penalty
-        
-        # Validate and set frequency_penalty
-        if frequency_penalty is not None:
-            if not -2.0 <= frequency_penalty <= 2.0:
-                raise ValueError("frequency_penalty must be between -2.0 and 2.0")
-            self._post_prompt_llm_params['frequency_penalty'] = frequency_penalty
+        # Accept any parameters without validation
+        if params:
+            self._post_prompt_llm_params.update(params)
         
         return self

{signalwire_agents-0.1.46 → signalwire_agents-0.1.47}/signalwire_agents/core/swaig_function.py

@@ -57,8 +57,8 @@ class SWAIGFunction:
         self.description = description
         self.parameters = parameters or {}
         self.secure = secure
-        self.fillers = fillers  # Keep for backward compatibility
-        self.wait_file = wait_file or fillers  # Use wait_file if provided, else fall back to fillers
+        self.fillers = fillers  # Text phrases to say while processing
+        self.wait_file = wait_file  # URL to audio/video file to play while waiting
         self.wait_file_loops = wait_file_loops
         self.webhook_url = webhook_url
         self.required = required or []

{signalwire_agents-0.1.46 → signalwire_agents-0.1.47}/signalwire_agents/search/document_processor.py

@@ -140,6 +140,8 @@ class DocumentProcessor:
             return self._chunk_by_topics(content, filename, file_type)
         elif self.chunking_strategy == 'qa':
             return self._chunk_by_qa_optimization(content, filename, file_type)
+        elif self.chunking_strategy == 'json':
+            return self._chunk_from_json(content, filename, file_type)
         else:
             # Fallback to sentence-based chunking
             return self._chunk_by_sentences(content, filename, file_type)
@@ -1022,4 +1024,103 @@ class DocumentProcessor:
             ))
         
         return chunks if chunks else [self._create_chunk(content, filename, "QA Section 1",
-                                                       metadata={'chunk_method': 'qa_optimized', 'chunk_index': 0})] 
+                                                       metadata={'chunk_method': 'qa_optimized', 'chunk_index': 0})]
+    
+    def _chunk_from_json(self, content: str, filename: str, file_type: str) -> List[Dict[str, Any]]:
+        """
+        Create chunks from pre-processed JSON content
+        
+        This strategy expects content to be a JSON string with the following structure:
+        {
+            "chunks": [
+                {
+                    "chunk_id": "unique_id",
+                    "type": "content|toc",
+                    "content": "text content",
+                    "metadata": {
+                        "url": "https://...",
+                        "section_number": 1,
+                        "related_toc": "toc_id",
+                        ...
+                    }
+                },
+                ...
+            ]
+        }
+        
+        Args:
+            content: JSON string containing pre-chunked content
+            filename: Name of the source file
+            file_type: Should be 'json'
+            
+        Returns:
+            List of chunk dictionaries formatted for the search index
+        """
+        try:
+            # Parse JSON content
+            data = json.loads(content)
+            
+            if not isinstance(data, dict) or 'chunks' not in data:
+                logger.error(f"Invalid JSON structure in {filename}: expected 'chunks' key")
+                # Fallback to treating it as plain text
+                return self._chunk_by_sentences(content, filename, file_type)
+            
+            chunks = []
+            for idx, json_chunk in enumerate(data['chunks']):
+                if not isinstance(json_chunk, dict) or 'content' not in json_chunk:
+                    logger.warning(f"Skipping invalid chunk {idx} in {filename}")
+                    continue
+                
+                # Extract metadata from JSON chunk
+                json_metadata = json_chunk.get('metadata', {})
+                chunk_type = json_chunk.get('type', 'content')
+                
+                # Build chunk metadata
+                metadata = {
+                    'chunk_method': 'json',
+                    'chunk_index': idx,
+                    'chunk_type': chunk_type,
+                    'original_chunk_id': json_chunk.get('chunk_id', f'chunk_{idx}')
+                }
+                
+                # Merge JSON metadata
+                metadata.update(json_metadata)
+                
+                # Determine section name
+                if chunk_type == 'toc':
+                    section = f"TOC: {json_chunk.get('content', '')[:50]}"
+                else:
+                    section = json_metadata.get('section', f"Section {json_metadata.get('section_number', idx + 1)}")
+                
+                # Create chunk with proper structure
+                chunk = self._create_chunk(
+                    content=json_chunk['content'],
+                    filename=filename,
+                    section=section,
+                    metadata=metadata
+                )
+                
+                # Add any additional fields from JSON
+                if 'tags' in json_chunk:
+                    chunk['tags'] = json_chunk['tags']
+                
+                # For TOC entries, we might want to add special tags
+                if chunk_type == 'toc' and 'tags' not in chunk:
+                    chunk['tags'] = ['toc', 'navigation']
+                
+                chunks.append(chunk)
+            
+            if not chunks:
+                logger.warning(f"No valid chunks found in JSON file {filename}")
+                return self._chunk_by_sentences(str(data), filename, file_type)
+            
+            logger.info(f"Created {len(chunks)} chunks from JSON file {filename}")
+            return chunks
+            
+        except json.JSONDecodeError as e:
+            logger.error(f"Failed to parse JSON in {filename}: {e}")
+            # Fallback to sentence chunking
+            return self._chunk_by_sentences(content, filename, file_type)
+        except Exception as e:
+            logger.error(f"Unexpected error processing JSON chunks in {filename}: {e}")
+            return self._chunk_by_sentences(content, filename, file_type) 

{signalwire_agents-0.1.46 → signalwire_agents-0.1.47}/signalwire_agents/search/index_builder.py

@@ -55,7 +55,7 @@ class IndexBuilder:
         
         Args:
             model_name: Name of the sentence transformer model to use
-            chunking_strategy: Strategy for chunking documents ('sentence', 'sliding', 'paragraph', 'page', 'semantic', 'topic', 'qa')
+            chunking_strategy: Strategy for chunking documents ('sentence', 'sliding', 'paragraph', 'page', 'semantic', 'topic', 'qa', 'json')
             max_sentences_per_chunk: For sentence strategy (default: 5)
             chunk_size: For sliding strategy - words per chunk (default: 50)
             chunk_overlap: For sliding strategy - overlap in words (default: 10)

{signalwire_agents-0.1.46 → signalwire_agents-0.1.47}/signalwire_agents/skills/weather_api/skill.py

@@ -176,7 +176,7 @@ class WeatherApiSkill(SkillBase):
             "data_map": {
                 "webhooks": [
                     {
-                        "url": f"https://api.weatherapi.com/v1/current.json?key={self.api_key}&q=${{args.location}}&aqi=no",
+                        "url": f"https://api.weatherapi.com/v1/current.json?key={self.api_key}&q=${{lc:enc:args.location}}&aqi=no",
                         "method": "GET",
                         "output": SwaigFunctionResult(weather_template).to_dict()
                     }
@@ -188,4 +188,4 @@ class WeatherApiSkill(SkillBase):
             }
         }
         
-        return [tool] 
+        return [tool] 

{signalwire_agents-0.1.46 → signalwire_agents-0.1.47/signalwire_agents.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: signalwire_agents
-Version: 0.1.46
+Version: 0.1.47
 Summary: SignalWire AI Agents SDK
 Author-email: SignalWire Team <info@signalwire.com>
 License: MIT
@@ -664,6 +664,7 @@ class PreciseAgent(AgentBase):
         self.prompt_add_section("Instructions", "Provide accurate, detailed information.")
         
         # Set custom LLM parameters for the main prompt
+        # These parameters are passed to the server which validates them based on the model
         self.set_prompt_llm_params(
             temperature=0.3,        # Low temperature for more consistent responses
             top_p=0.9,             # Slightly reduced for focused responses
@@ -685,13 +686,17 @@ agent = PreciseAgent()
 agent.serve()
 ```
 
-#### Available LLM Parameters
+#### Common LLM Parameters
 
-- **temperature** (0.0-1.5): Controls randomness. Lower = more focused, higher = more creative
-- **top_p** (0.0-1.0): Nucleus sampling. Lower = more focused on likely tokens
-- **barge_confidence** (0.0-1.0): ASR confidence to interrupt. Higher = harder to interrupt
-- **presence_penalty** (-2.0-2.0): Topic diversity. Positive = new topics
-- **frequency_penalty** (-2.0-2.0): Repetition control. Positive = varied vocabulary
+The SDK accepts any parameters which are passed to the server for validation based on the model. Common parameters include:
+
+- **temperature**: Controls randomness. Lower = more focused, higher = more creative
+- **top_p**: Nucleus sampling. Lower = more focused on likely tokens
+- **barge_confidence**: ASR confidence to interrupt. Higher = harder to interrupt (main prompt only)
+- **presence_penalty**: Topic diversity. Positive = new topics
+- **frequency_penalty**: Repetition control. Positive = varied vocabulary
+
+Note: No defaults are sent unless explicitly set. The server handles validation and applies appropriate defaults based on the model.
 
 For more details on LLM parameter tuning, see [LLM Parameters Guide](docs/llm_parameters.md).