| # SPDX-License-Identifier: MIT | |
| """ | |
| Example TrashClaw Plugin — Weather Lookup | |
| Drop this file in ~/.trashclaw/plugins/ to add a weather tool. | |
| Demonstrates the plugin API. Modify or use as a template. | |
| Plugin contract: | |
| TOOL_DEF = dict with name, description, parameters (OpenAI function schema) | |
| run(**kwargs) -> str (called with the parsed arguments) | |
| """ | |
| import urllib.request | |
| import json | |
| TOOL_DEF = { | |
| "name": "weather", | |
| "description": "Get current weather for a city using wttr.in (no API key needed).", | |
| "parameters": { | |
| "type": "object", | |
| "properties": { | |
| "city": { | |
| "type": "string", | |
| "description": "City name (e.g. 'London', 'New York', 'Tokyo')" | |
| } | |
| }, | |
| "required": ["city"] | |
| } | |
| } | |
| def run(city: str = "London", **kwargs) -> str: | |
| """Fetch weather from wttr.in — free, no auth, returns plain text.""" | |
| try: | |
| url = f"https://wttr.in/{city.replace(' ', '+')}?format=3" | |
| req = urllib.request.Request(url, headers={"User-Agent": "TrashClaw"}) | |
| with urllib.request.urlopen(req, timeout=10) as resp: | |
| return resp.read().decode("utf-8").strip() | |
| except Exception as e: | |
| return f"Weather lookup failed: {e}" | |