红尘
d73ff9b0fb
Deploy Site / deploy-vercel (push) Has been cancelled
Deploy Site / deploy-docs (push) Has been cancelled
Docker / shell lint / Lint Dockerfile (hadolint) (push) Has been cancelled
Docker / shell lint / Lint docker/ shell scripts (shellcheck) (push) Has been cancelled
Docker Build and Publish / build-amd64 (push) Has been cancelled
Docker Build and Publish / build-arm64 (push) Has been cancelled
Lint (ruff + ty) / ruff + ty diff (push) Has been cancelled
Lint (ruff + ty) / ruff enforcement (blocking) (push) Has been cancelled
Lint (ruff + ty) / Windows footguns (blocking) (push) Has been cancelled
Nix Lockfile Fix / auto-fix-main (push) Has been cancelled
Nix Lockfile Fix / fix (push) Has been cancelled
Nix / nix (macos-latest) (push) Has been cancelled
Nix / nix (ubuntu-latest) (push) Has been cancelled
OSV-Scanner / Scan lockfiles (push) Has been cancelled
Build Skills Index / build-index (push) Has been cancelled
Tests / test (1) (push) Has been cancelled
Tests / test (2) (push) Has been cancelled
Tests / test (3) (push) Has been cancelled
Tests / test (4) (push) Has been cancelled
Tests / test (5) (push) Has been cancelled
Tests / test (6) (push) Has been cancelled
Tests / e2e (push) Has been cancelled
uv.lock check / uv lock --check (push) Has been cancelled
Docker Build and Publish / merge (push) Has been cancelled
Build Skills Index / trigger-deploy (push) Has been cancelled
Tests / save-durations (push) Has been cancelled
67 lines
2.6 KiB
Python
67 lines
2.6 KiB
Python
"""Spotify integration plugin — bundled, auto-loaded.
|
|
|
|
Registers 7 tools (playback, devices, queue, search, playlists, albums,
|
|
library) into the ``spotify`` toolset. Each tool's handler is gated by
|
|
``_check_spotify_available()`` — when the user has not run ``hermes auth
|
|
spotify``, the tools remain registered (so they appear in ``hermes
|
|
tools``) but the runtime check prevents dispatch.
|
|
|
|
Why a plugin instead of a top-level ``tools/`` file?
|
|
|
|
- ``plugins/`` is where third-party service integrations live (see
|
|
``plugins/image_gen/`` for the backend-provider pattern, ``plugins/
|
|
disk-cleanup/`` for the standalone pattern). ``tools/`` is reserved
|
|
for foundational capabilities (terminal, read_file, web_search, etc.).
|
|
- Mirroring the image_gen plugin layout (``plugins/<category>/<backend>/``
|
|
for categories, flat ``plugins/<name>/`` for standalones) makes new
|
|
service integrations a pattern contributors can copy.
|
|
- Bundled + ``kind: backend`` auto-loads on startup just like image_gen
|
|
backends — no user opt-in needed, no ``plugins.enabled`` config.
|
|
|
|
The Spotify auth flow (``hermes auth spotify``), CLI plumbing, and docs
|
|
are unchanged. This move is purely structural.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from plugins.spotify.tools import (
|
|
SPOTIFY_ALBUMS_SCHEMA,
|
|
SPOTIFY_DEVICES_SCHEMA,
|
|
SPOTIFY_LIBRARY_SCHEMA,
|
|
SPOTIFY_PLAYBACK_SCHEMA,
|
|
SPOTIFY_PLAYLISTS_SCHEMA,
|
|
SPOTIFY_QUEUE_SCHEMA,
|
|
SPOTIFY_SEARCH_SCHEMA,
|
|
_check_spotify_available,
|
|
_handle_spotify_albums,
|
|
_handle_spotify_devices,
|
|
_handle_spotify_library,
|
|
_handle_spotify_playback,
|
|
_handle_spotify_playlists,
|
|
_handle_spotify_queue,
|
|
_handle_spotify_search,
|
|
)
|
|
|
|
_TOOLS = (
|
|
("spotify_playback", SPOTIFY_PLAYBACK_SCHEMA, _handle_spotify_playback, "🎵"),
|
|
("spotify_devices", SPOTIFY_DEVICES_SCHEMA, _handle_spotify_devices, "🔈"),
|
|
("spotify_queue", SPOTIFY_QUEUE_SCHEMA, _handle_spotify_queue, "📻"),
|
|
("spotify_search", SPOTIFY_SEARCH_SCHEMA, _handle_spotify_search, "🔎"),
|
|
("spotify_playlists", SPOTIFY_PLAYLISTS_SCHEMA, _handle_spotify_playlists, "📚"),
|
|
("spotify_albums", SPOTIFY_ALBUMS_SCHEMA, _handle_spotify_albums, "💿"),
|
|
("spotify_library", SPOTIFY_LIBRARY_SCHEMA, _handle_spotify_library, "❤️"),
|
|
)
|
|
|
|
|
|
def register(ctx) -> None:
|
|
"""Register all Spotify tools. Called once by the plugin loader."""
|
|
for name, schema, handler, emoji in _TOOLS:
|
|
ctx.register_tool(
|
|
name=name,
|
|
toolset="spotify",
|
|
schema=schema,
|
|
handler=handler,
|
|
check_fn=_check_spotify_available,
|
|
emoji=emoji,
|
|
)
|