Add weather tool on OpenWeatherMap, reusing the conky cache for home

A bare city name is ambiguous for the API (plain "Rome" and "Roma"
both resolve to Rome, US), so the parameter asks the model for
City,CC and the output names the country.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2 files changed, 81 insertions, 0 deletions

diff --git a/examples/tools/weather.sh b/examples/tools/weather.sh
new file mode 100755
index 0000000..7af4964
--- /dev/null
+++ b/examples/tools/weather.sh
@@ -0,0 +1,68 @@
+#!/bin/bash
+# desktop-assistant tool: weather from OpenWeatherMap.
+# Copyright (C) 2026 Danilo M. <danix@danix.xyz>
+#
+# This program is free software; you can redistribute it and/or modify it
+# under the terms of the GNU General Public License version 2 as published
+# by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
+# Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+# weather.sh [PLACE] [WHEN]: PLACE empty = home, WHEN now (default), today
+# or tomorrow. WEATHER_ENV names an env file with KEY, CITY, COUNTRY and
+# UNITS (the conky-theme-udt format). Home "now" reuses that project's
+# cache when it is under 30 minutes old, so it costs no request.
+# ponytail: wind is converted as metric (m/s to km/h); UNITS=imperial
+# would need mph instead.
+
+set -uo pipefail
+
+env_file="${WEATHER_ENV:-$HOME/.config/udt/weather.env}"
+[ -r "$env_file" ] || { echo "no weather env file at $env_file" >&2; exit 1; }
+# shellcheck source=/dev/null
+. "$env_file"
+[ -n "${KEY:-}" ] || { echo "KEY is empty in $env_file" >&2; exit 1; }
+
+place="${1:-}"
+when="${2:-}"
+q="${place:-$CITY,$COUNTRY}"
+
+get() {
+    curl -fsS --max-time 8 --get "https://api.openweathermap.org/data/2.5/$1" \
+        --data-urlencode "appid=$KEY" --data-urlencode "units=${UNITS:-metric}" \
+        --data-urlencode "q=$q" \
+        || { echo "weather request failed for $q" >&2; exit 1; }
+}
+
+case "${when:-now}" in
+now)
+    cache="${XDG_CACHE_HOME:-$HOME/.cache}/udt/weather.json"
+    if [ -z "$place" ] && [ -n "$(find "$cache" -mmin -30 2>/dev/null)" ]; then
+        json=$(cat "$cache")
+    else
+        json=$(get weather) || exit 1
+    fi
+    jq -r '"\(.name), \(.sys.country): \(.weather[0].description), \(.main.temp|round) degrees, feels like \(.main.feels_like|round), humidity \(.main.humidity)%, wind \(.wind.speed*3.6|round) km/h"' <<<"$json"
+    ;;
+today|tomorrow)
+    day=$(date -d "$when" +%F)
+    json=$(get forecast) || exit 1
+    jq -r --arg day "$day" '
+        "\(.city.name), \(.city.country)" as $c
+        | [.list[] | select((.dt | localtime | strftime("%Y-%m-%d")) == $day)]
+        | if length == 0 then "no forecast for \($c) on \($day)"
+          else "\($c) \($day): " + (map("\(.dt | localtime | strftime("%H:%M")) \(.weather[0].description) \(.main.temp|round) degrees") | join(", "))
+          end' <<<"$json"
+    ;;
+*)
+    echo "when must be now, today or tomorrow" >&2
+    exit 1
+    ;;
+esac
diff --git a/examples/tools/weather.toml b/examples/tools/weather.toml
new file mode 100644
index 0000000..ddf3f8e
--- /dev/null
+++ b/examples/tools/weather.toml
@@ -0,0 +1,13 @@
+description = "Weather now, or the forecast for today or tomorrow. Leave place empty for the user's home."
+command = ["weather.sh", "{place}", "{when}"]
+timeout = 12
+announce.it = ["Controllo il meteo.", "Vediamo che tempo fa."]
+announce.en = ["Checking the weather.", "Let me check the weather."]
+
+[params.place]
+type = "string"
+description = "City and ISO country code, e.g. Rome,IT or Paris,FR (a bare name can match a town in another country). Empty for home."
+
+[params.when]
+type = "string"
+description = "now, today or tomorrow. Empty for now."