""" define a generic tool class, any tool can be used by the agent. A tool can be used by deepseek like so: ``` ``` For example: ```python print("Hello world") ``` This is then executed by the tool with its own class implementation of execute(). A tool is not just for code tool but also API, internet, etc.. For example a flight API tool could be used like so: ```flight_search HU787 ``` """ import sys from abc import abstractmethod sys.path.append('..') class Tools(): """ Abstract class for all tools. """ def __init__(self): self.tag = "undefined" self.api_key = None self.client = None self.messages = [] @abstractmethod def execute(self, codes:str, safety:bool) -> str: """ abstract method, implementation in child class. """ pass @abstractmethod def execution_failure_check(self, output:str) -> bool: """ abstract method, implementation in child class. """ pass @abstractmethod def interpreter_feedback(self, output:str) -> str: """ abstract method, implementation in child class. """ pass def remove_block(self, text:str) -> str: """ Remove all code/query blocks within a tag from the answer text. """ assert self.tag != "undefined", "Tag not defined" start_tag = f'```{self.tag}' end_tag = '```' start_idx = text.find(start_tag) end_idx = text.rfind(end_tag)+3 if start_idx == -1 or end_idx == -1: return text return text[:start_idx] + text[end_idx:] def save_block(self, blocks:[str], save_path:str) -> None: """ Save the code/query block to a file. """ if save_path is None: return for block in blocks: with open(save_path, 'w') as f: f.write(block) def load_exec_block(self, llm_text: str) -> str: """ Extract the code/query blocks from the answer text, removing consistent leading whitespace. """ assert self.tag != "undefined", "Tag not defined" start_tag = f'```{self.tag}' end_tag = '```' code_blocks = [] start_index = 0 save_path = None if start_tag not in llm_text: return None, None while True: start_pos = llm_text.find(start_tag, start_index) if start_pos == -1: break line_start = llm_text.rfind('\n', 0, start_pos) + 1 if line_start == 0: line_start = 0 leading_whitespace = llm_text[line_start:start_pos] end_pos = llm_text.find(end_tag, start_pos + len(start_tag)) if end_pos == -1: break content = llm_text[start_pos + len(start_tag):end_pos] lines = content.split('\n') if leading_whitespace: processed_lines = [] for line in lines: if line.startswith(leading_whitespace): processed_lines.append(line[len(leading_whitespace):]) else: processed_lines.append(line) content = '\n'.join(processed_lines) if ':' in content.split('\n')[0]: save_path = content.split('\n')[0].split(':')[1] content = content[content.find('\n')+1:] code_blocks.append(content) start_index = end_pos + len(end_tag) return code_blocks, save_path