Add calc, mail, playing and finance example tools

All read-only: each command is fixed in its tool file, so the model
fills parameters but can never reach mailctl tag or firefly tx add.
qalc reads "17.5% of 240" as a modulo, so the calc hint shows percent
as a factor.

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

1 files changed, 30 insertions, 0 deletions

diff --git a/examples/tools/playing.sh b/examples/tools/playing.sh
new file mode 100755
index 0000000..9605f82
--- /dev/null
+++ b/examples/tools/playing.sh
@@ -0,0 +1,30 @@
+#!/bin/bash
+# desktop-assistant tool: what is playing now.
+# 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.
+#
+# playing.sh: the current track from any MPRIS player (playerctl), or from
+# MPD (mpc) when no MPRIS player is running.
+
+set -uo pipefail
+
+if out=$(playerctl metadata --format '{{status}}: {{artist}} - {{title}} ({{playerName}})' 2>/dev/null); then
+    echo "$out"
+elif out=$(mpc status --format '%artist% - %title%' 2>/dev/null) && [ "$(wc -l <<<"$out")" -gt 1 ]; then
+    head -2 <<<"$out" | tac | tr '\n' ' '
+    echo "(mpd)"
+else
+    echo "nothing is playing"
+fi