Tool Factory

#!/usr/bin/env python3 """ my_tool — One-line summary of what this tool does. WHEN TO USE: ◄── Agents read this section - User asks for X or wants to Y to decide if this tool - "Example user message that triggers this" is the right one. - Another scenario where this is the right tool DESCRIPTION: ◄── This gets embedded in Longer explanation of what the tool does, the vector database. how it works, what API it connects to. Write for SEMANTIC Include synonyms and related concepts. MATCHING, not humans. PARAMETERS: ◄── Maps to CLI args --name (required) Person's name and JSON schema. --format (optional) Output format, default: text RETURNS: ◄── What callers expect. JSON: {"result": "...", "error": null} EXAMPLES: ◄── Copy-paste runnable. python3 tools/my-tool.py "value" --json DEPENDENCIES: ◄── Almost always "None." None beyond Python 3.10+ stdlib. """ import argparse, json, os, sys # ◄── stdlib only API_KEY = os.environ.get("MY_API_KEY", "") # ◄── config from env def my_tool(name: str, format: str = "text") -> dict: """Pure logic. No printing. No sys.exit.""" # ◄── testable function return {"result": f"Hello {name}"} def main(): parser = argparse.ArgumentParser(...) # ... if args.json: # ◄── machine-readable output print(json.dumps({"result": ..., "error": None})) if __name__ == "__main__": main()