""" 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 import os 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, blocks:str, safety:bool) -> str: """ abstract method, implementation in child class. Execute the tool. """ pass @abstractmethod def execution_failure_check(self, output:str) -> bool: """ abstract method, implementation in child class. Check if the execution failed. """ pass @abstractmethod def interpreter_feedback(self, output:str) -> str: """ abstract method, implementation in child class. Provide feedback to the AI from the tool. For exemple the output of a python code or web search. """ pass def save_block(self, blocks:[str], save_path:str) -> None: """ Save the code/query block to a file. Creates the directory path if it doesn't exist. """ if save_path is None: return directory = os.path.dirname(save_path) if directory and not os.path.exists(directory): print(f"Creating directory: {directory}") os.makedirs(directory) for block in blocks: print(f"Saving code block to: {save_path}") 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 if __name__ == "__main__": tool = Tools() tool.tag = "python" rt = tool.load_exec_block(""" Got it, let me show you the Python files in the current directory using Python: ```python import os for file in os.listdir(): if file.endswith('.py'): print(file) ``` """) print(rt)