@audiofool/moondog 0.1.0 → 0.2.0-beta.2

package/src/core/capability-catalog.mjs

@@ -1,15 +1,33 @@
+import { N_ } from "../i18n/index.mjs";
+
+// Tool labels are marked English; screens translate them when shown.
 const catalog = [
+  {
+    id: "playback.service", version: "1", state: "enabled", effect: "write_local",
+    description: "Inspect or change the current music service through the same saved selection as the host's service picker.",
+    agent_tool: { name: "moondog_playback_service", label: N_("Choose a music service") },
+  },
+  {
+    id: "spotify.discovery.search", version: "1", state: "enabled", effect: "read_external", requires_spotify: true,
+    description: "Verify open-world music hypotheses with bounded Spotify queries, retaining a shared candidate pool.",
+    agent_tool: { name: "moondog_spotify_discover", label: N_("Discover verified Spotify tracks") },
+  },
+  {
+    id: "spotify.queue.batch", version: "1", state: "enabled", effect: "write_external", requires_spotify: true,
+    description: "Queue up to twelve verified tracks for an explicit listener request with Avoid, deduplication and partial receipts.",
+    agent_tool: { name: "moondog_spotify_queue_batch", label: N_("Queue the verified selection") },
+  },
   {
     id: "web.search", version: "1", state: "enabled", effect: "read_external",
-    description: "Search public music reviews, news, interviews and event information through the local Codex CLI.",
-    requires_web_research: true,
-    agent_tool: { name: "moondog_web_search", label: "Search the public web" },
+    description: "Search public music reviews, news, interviews and event information through {provider}.",
+    requires_web: "search",
+    agent_tool: { name: "moondog_web_search", label: N_("Search the public web") },
   },
   {
     id: "web.read", version: "1", state: "enabled", effect: "read_external",
-    description: "Read and summarize a public web page with dated source attribution through the local Codex CLI.",
-    requires_web_research: true,
-    agent_tool: { name: "moondog_web_read", label: "Read a public web page" },
+    description: "Read a public web page with dated source attribution through {provider}.",
+    requires_web: "read",
+    agent_tool: { name: "moondog_web_read", label: N_("Read a public web page") },
   },
   {
     id: "source.apple_music.status",
@@ -19,7 +37,7 @@ const catalog = [
     description: "Inspect aggregate Apple Music import readiness.",
     agent_tool: {
       name: "moondog_source_status",
-      label: "Check your music sources",
+      label: N_("Check your music sources"),
     },
   },
   {
@@ -30,7 +48,7 @@ const catalog = [
     description: "Inspect evidence-backed profile readiness.",
     agent_tool: {
       name: "moondog_profile_status",
-      label: "Check your profile",
+      label: N_("Check your profile"),
     },
   },
   {
@@ -41,7 +59,7 @@ const catalog = [
     description: "Inspect conversation and long-term memory readiness.",
     agent_tool: {
       name: "moondog_memory_status",
-      label: "Check what I remember",
+      label: N_("Check what I remember"),
     },
   },
   {
@@ -52,7 +70,7 @@ const catalog = [
     description: "Inspect the Moondog capability registry.",
     agent_tool: {
       name: "moondog_capability_status",
-      label: "Check what I can do",
+      label: N_("Check what I can do"),
     },
   },
   {
@@ -63,7 +81,7 @@ const catalog = [
     description: "Inspect the configured model runtime.",
     agent_tool: {
       name: "moondog_runtime_status",
-      label: "Check the model connection",
+      label: N_("Check the model connection"),
     },
   },
   {
@@ -75,7 +93,7 @@ const catalog = [
     requires_domain_services: true,
     agent_tool: {
       name: "moondog_library_search",
-      label: "Search your music library",
+      label: N_("Search your music library"),
     },
   },
   {
@@ -87,9 +105,27 @@ const catalog = [
     requires_profile_services: true,
     agent_tool: {
       name: "moondog_profile_summary",
-      label: "Read your music profile",
+      label: N_("Read your music profile"),
     },
   },
+  {
+    id: "profile.saved", version: "1", state: "enabled", effect: "read_local",
+    description: "Read a durable listener-profile revision and trace a finding to its frozen evidence.",
+    requires_profile_build: true,
+    agent_tool: { name: "moondog_profile_saved", label: N_("Read your saved listening profile") },
+  },
+  {
+    id: "profile.build", version: "1", state: "enabled", effect: "write_local",
+    description: "Build or resume a grounded local listener-profile revision with the configured model.",
+    requires_profile_build: true,
+    agent_tool: { name: "moondog_profile_build", label: N_("Build your saved listening profile") },
+  },
+  {
+    id: "profile.explore", version: "1", state: "enabled", effect: "read_local",
+    description: "Analyze all retained profile evidence with coverage, full-library facets, search, and pagination.",
+    requires_profile_exploration: true,
+    agent_tool: { name: "moondog_profile_explore", label: N_("Explore your complete music profile") },
+  },
   {
     id: "profile.rediscovery",
     version: "1",
@@ -100,7 +136,7 @@ const catalog = [
     requires_rediscovery_services: true,
     agent_tool: {
       name: "moondog_rediscovery_candidates",
-      label: "Find music worth another listen",
+      label: N_("Find music worth another listen"),
     },
   },
   {
@@ -113,7 +149,7 @@ const catalog = [
     requires_historical_return_services: true,
     agent_tool: {
       name: "moondog_historical_return_candidates",
-      label: "Find music that came back",
+      label: N_("Find music that came back"),
     },
   },
   {
@@ -126,7 +162,7 @@ const catalog = [
     requires_time_capsule_services: true,
     agent_tool: {
       name: "moondog_time_capsule_candidates",
-      label: "Travel through your years",
+      label: N_("Travel through your years"),
     },
   },
   {
@@ -139,7 +175,7 @@ const catalog = [
     requires_back_to_back_services: true,
     agent_tool: {
       name: "moondog_back_to_back_candidates",
-      label: "Find music played back to back",
+      label: N_("Find music played back to back"),
     },
   },
   {
@@ -151,7 +187,7 @@ const catalog = [
     requires_profile_services: true,
     agent_tool: {
       name: "moondog_profile_explain",
-      label: "Look at why it's in your profile",
+      label: N_("Look at why it's in your profile"),
     },
   },
   {
@@ -163,7 +199,7 @@ const catalog = [
     requires_playlist_services: true,
     agent_tool: {
       name: "moondog_playlist_plan",
-      label: "Build a playlist plan",
+      label: N_("Build a playlist plan"),
     },
   },
   {
@@ -176,7 +212,7 @@ const catalog = [
     requires_music_catalog: true,
     agent_tool: {
       name: "moondog_music_artist_releases",
-      label: "Find current artist releases",
+      label: N_("Find current artist releases"),
     },
   },
   {
@@ -189,9 +225,72 @@ const catalog = [
     requires_music_discovery: true,
     agent_tool: {
       name: "moondog_music_catalog_search",
-      label: "Search outside your library",
+      label: N_("Search outside your library"),
     },
   },
+  {
+    id: "music.preview.play",
+    version: "1",
+    state: "enabled",
+    effect: "play_preview",
+    description:
+      "Play 30-second Apple Music previews of named songs or one album, as a queue in the host's player.",
+    requires_music_preview: true,
+    agent_tool: {
+      name: "moondog_music_preview",
+      label: N_("Play previews"),
+    },
+  },
+  // NetEase Cloud Music through ncm-cli. The application offers these only while NetEase is the
+  // chosen service and ncm-cli is signed in.
+  {
+    id: "netease.search",
+    version: "1",
+    state: "enabled",
+    effect: "read_external",
+    description: "Search NetEase Music for songs, with whether each one can be played.",
+    agent_tool: { name: "moondog_netease_search", label: N_("Search NetEase Music") },
+  },
+  {
+    id: "netease.play",
+    version: "1",
+    state: "enabled",
+    effect: "write_external",
+    description: "Play or queue songs on NetEase Music through ncm-cli.",
+    agent_tool: { name: "moondog_netease_play", label: N_("Play on NetEase Music") },
+  },
+  {
+    id: "netease.control",
+    version: "1",
+    state: "enabled",
+    effect: "write_external",
+    description: "Pause, resume, skip, go back, move in the song or stop NetEase Music.",
+    agent_tool: { name: "moondog_netease_control", label: N_("Control NetEase Music") },
+  },
+  {
+    id: "netease.now_playing",
+    version: "1",
+    state: "enabled",
+    effect: "read_external",
+    description: "Read what NetEase Music is playing and what is queued after it.",
+    agent_tool: { name: "moondog_netease_now_playing", label: N_("See what is playing") },
+  },
+  {
+    id: "listening.now",
+    version: "1",
+    state: "enabled",
+    effect: "read_external",
+    description: "Read what the listener plays right now in the Music app, on Spotify's active device or on NetEase, and the playlist it plays from.",
+    agent_tool: { name: "moondog_listening_now", label: N_("See what you're listening to") },
+  },
+  {
+    id: "music_app.control",
+    version: "1",
+    state: "enabled",
+    effect: "write_local",
+    description: "Pause, resume, skip or go back in the Music app on this Mac, which the listener plays themselves.",
+    agent_tool: { name: "moondog_music_app_control", label: N_("Control the Music app") },
+  },
   {
     id: "music.discovery.artist_similarity",
     version: "1",
@@ -202,7 +301,7 @@ const catalog = [
     requires_music_similarity: true,
     agent_tool: {
       name: "moondog_music_artist_similarity",
-      label: "Find music nearby",
+      label: N_("Find music nearby"),
     },
   },
   {
@@ -214,7 +313,7 @@ const catalog = [
     requires_memory: true,
     agent_tool: {
       name: "moondog_memory_recall",
-      label: "Remember what you've told me",
+      label: N_("Remember what you've told me"),
     },
   },
   {
@@ -227,7 +326,7 @@ const catalog = [
     requires_memory: true,
     agent_tool: {
       name: "moondog_memory_remember",
-      label: "Remember something you said",
+      label: N_("Remember something you said"),
     },
   },
   {
@@ -239,7 +338,7 @@ const catalog = [
     requires_memory: true,
     agent_tool: {
       name: "moondog_memory_forget",
-      label: "Forget something",
+      label: N_("Forget something"),
     },
   },
   {
@@ -255,11 +354,24 @@ const catalog = [
     version: "1",
     state: "enabled",
     effect: "read_external",
-    description: "Inspect metadata-free Spotify playback state.",
+    description: "Inspect bounded Spotify playback metadata, device capabilities, and state.",
     requires_spotify: true,
     agent_tool: {
       name: "moondog_spotify_player_status",
-      label: "Check what Spotify is playing",
+      label: N_("Check what Spotify is playing"),
+    },
+  },
+  {
+    id: "spotify.player.now_playing",
+    version: "1",
+    state: "enabled",
+    effect: "read_external",
+    description:
+      "Read full Spotify now-playing metadata: track, artists, album, progress, and device.",
+    requires_spotify: true,
+    agent_tool: {
+      name: "moondog_spotify_now_playing",
+      label: N_("See what's playing in detail"),
     },
   },
   {
@@ -271,7 +383,7 @@ const catalog = [
     requires_spotify: true,
     agent_tool: {
       name: "moondog_spotify_player_control",
-      label: "Control Spotify playback",
+      label: N_("Control Spotify playback"),
     },
   },
   {
@@ -279,11 +391,48 @@ const catalog = [
     version: "1",
     state: "enabled",
     effect: "write_external",
-    description: "Add one explicit Spotify URI to the playback queue.",
+    description:
+      "Add one resolved track, one explicit Spotify URI, or the pending plan to the playback queue.",
     requires_spotify: true,
     agent_tool: {
       name: "moondog_spotify_queue_add",
-      label: "Add to Spotify queue",
+      label: N_("Add to Spotify queue"),
+    },
+  },
+  {
+    id: "spotify.queue.similar",
+    version: "1",
+    state: "enabled",
+    effect: "write_external",
+    description: "Queue a bounded artist-similarity selection from current Spotify playback, with filtering and partial receipts.",
+    requires_spotify: true,
+    requires_music_similarity: true,
+    agent_tool: { name: "moondog_spotify_queue_similar", label: N_("Queue more like this on Spotify") },
+  },
+  {
+    id: "spotify.queue.status",
+    version: "1",
+    state: "enabled",
+    effect: "read_external",
+    description:
+      "Inspect the current Spotify playback queue with track metadata.",
+    requires_spotify: true,
+    agent_tool: {
+      name: "moondog_spotify_queue_status",
+      label: N_("See what's queued on Spotify"),
+    },
+  },
+  {
+    id: "spotify.device.list",
+    version: "1",
+    state: "enabled",
+    effect: "read_external",
+    description:
+      "List visible Spotify Connect devices by name and type, without device identifiers.",
+    requires_spotify: true,
+    agent_tool: {
+      name: "moondog_spotify_devices",
+      label: N_("See your Spotify devices"),
     },
   },
   {
@@ -291,11 +440,12 @@ const catalog = [
     version: "1",
     state: "enabled",
     effect: "write_external",
-    description: "Transfer Spotify playback to an explicit device ID.",
+    description:
+      "Transfer Spotify playback to a device the user named, or to a device ID the user pasted.",
     requires_spotify: true,
     agent_tool: {
       name: "moondog_spotify_device_transfer",
-      label: "Move Spotify playback",
+      label: N_("Move Spotify playback"),
     },
   },
   {
@@ -304,12 +454,54 @@ const catalog = [
     state: "enabled",
     effect: "read_external",
     description:
-      "Resolve trusted library tracks to deterministic Spotify catalog identities.",
+      "Resolve trusted library, history, and external catalog tracks to Spotify catalog identities by title, artist, and release.",
     requires_spotify: true,
     requires_playlist_services: true,
     agent_tool: {
       name: "moondog_spotify_resolve_tracks",
-      label: "Find your songs on Spotify",
+      label: N_("Find your songs on Spotify"),
+    },
+  },
+  {
+    id: "spotify.top",
+    version: "1",
+    state: "enabled",
+    effect: "read_external",
+    description: "Read bounded Spotify top artists or tracks as transient calculated-affinity evidence.",
+    requires_spotify: true,
+    agent_tool: { name: "moondog_spotify_top", label: N_("Your Spotify top artists and tracks") },
+  },
+  {
+    id: "spotify.library.browse", version: "1", state: "enabled", effect: "read_external", requires_spotify: true,
+    description: "Browse bounded pages of saved Spotify tracks, albums, and shows.",
+    agent_tool: { name: "moondog_spotify_library_browse", label: N_("Browse your Spotify library") },
+  },
+  {
+    id: "spotify.history.recent", version: "1", state: "enabled", effect: "read_external", requires_spotify: true,
+    description: "Read a bounded page of recent Spotify listening with timestamps and cursors.",
+    agent_tool: { name: "moondog_spotify_history_recent", label: N_("Read recent Spotify listening") },
+  },
+  {
+    id: "spotify.catalog.items", version: "1", state: "enabled", effect: "read_external", requires_spotify: true,
+    description: "Read bounded album tracks or podcast episodes from a selected host reference.",
+    agent_tool: { name: "moondog_spotify_catalog_items", label: N_("Browse album tracks or podcast episodes") },
+  },
+  {
+    id: "spotify.library.remove", version: "1", state: "enabled", effect: "write_external", requires_spotify: true,
+    description: "Confirm removal of one selected saved track, album, episode, show, or owned private playlist.",
+    agent_tool: { name: "moondog_spotify_library_remove", label: N_("Remove a saved Spotify item") },
+  },
+  {
+    id: "spotify.search",
+    version: "1",
+    state: "enabled",
+    effect: "read_external",
+    description:
+      "Search the Spotify catalog for tracks by free text, with bounded results.",
+    requires_spotify: true,
+    agent_tool: {
+      name: "moondog_spotify_search",
+      label: N_("Search Spotify"),
     },
   },
   {
@@ -319,10 +511,9 @@ const catalog = [
     effect: "read_external",
     description: "Check whether resolved tracks are already saved in the Spotify library.",
     requires_spotify: true,
-    requires_playlist_services: true,
     agent_tool: {
       name: "moondog_spotify_library_check",
-      label: "Check Spotify saved tracks",
+      label: N_("Check Spotify saved tracks"),
     },
   },
   {
@@ -332,10 +523,9 @@ const catalog = [
     effect: "write_external",
     description: "Save explicitly requested resolved tracks to the Spotify library.",
     requires_spotify: true,
-    requires_playlist_services: true,
     agent_tool: {
       name: "moondog_spotify_library_save",
-      label: "Save tracks to Spotify library",
+      label: N_("Save tracks to Spotify library"),
     },
   },
   {
@@ -348,9 +538,23 @@ const catalog = [
     requires_spotify: true,
     agent_tool: {
       name: "moondog_spotify_playlist_read",
-      label: "Look at your Spotify playlists",
+      label: N_("Look at your Spotify playlists"),
     },
   },
+  {
+    id: "spotify.playlist.edit.quick",
+    version: "1",
+    state: "enabled",
+    effect: "write_external",
+    description: "Apply one exact user-authorized rename or unambiguous single-track removal to an inspected owned private playlist.",
+    requires_spotify: true,
+    agent_tool: { name: "moondog_spotify_playlist_edit_quick", label: N_("Make an exact playlist edit") },
+  },
+  {
+    id: "spotify.playlist.remove", version: "1", state: "enabled", effect: "write_external", requires_spotify: true,
+    description: "Confirm and remove an owned private playlist from the current user's library without claiming global deletion.",
+    agent_tool: { name: "moondog_spotify_playlist_remove", label: N_("Remove a playlist from your library") },
+  },
   {
     id: "spotify.playlist.edit.preview",
     version: "1",
@@ -361,7 +565,7 @@ const catalog = [
     requires_spotify: true,
     agent_tool: {
       name: "moondog_spotify_playlist_edit_preview",
-      label: "Preview a playlist change",
+      label: N_("Preview a playlist change"),
     },
   },
   {
@@ -374,7 +578,7 @@ const catalog = [
     requires_spotify: true,
     agent_tool: {
       name: "moondog_spotify_playlist_edit_apply",
-      label: "Change a Spotify playlist",
+      label: N_("Change a Spotify playlist"),
     },
   },
   {
@@ -388,7 +592,7 @@ const catalog = [
     requires_playlist_services: true,
     agent_tool: {
       name: "moondog_spotify_playlist_write",
-      label: "Save the playlist to Spotify",
+      label: N_("Save the playlist to Spotify"),
     },
   },
   {
@@ -421,10 +625,23 @@ function withRuntimeAvailability(
   musicCatalogReady,
   musicDiscoveryReady,
   musicSimilarityReady,
-  webResearchReady,
+  webProviders,
+  profileExplorationReady,
+  profileBuildReady,
+  musicPreviewReady,
 ) {
-  if (capability.requires_web_research && !webResearchReady) {
-    return { ...capability, state: "blocked", blocked_by: "codex_web_not_ready" };
+  if (capability.requires_profile_build && !profileBuildReady) {
+    return { ...capability, state: "blocked", blocked_by: "profile_build_not_ready" };
+  }
+  if (capability.requires_profile_exploration && !profileExplorationReady) {
+    return { ...capability, state: "blocked", blocked_by: "profile_exploration_not_ready" };
+  }
+  if (capability.requires_web) {
+    // The description names the service in use, or the ones that could be set up.
+    const provider = webProviders[capability.requires_web];
+    capability = { ...capability, description: capability.description.replace("{provider}", provider ??
+      (capability.requires_web === "search" ? "DeepSeek, Brave Search or the Codex CLI, once one is set up" : "DeepSeek or the Codex CLI, once one is set up")) };
+    if (!provider) return { ...capability, state: "blocked", blocked_by: `web_${capability.requires_web}_not_ready` };
   }
   if (capability.requires_domain_services && !domainServicesReady) {
     return {
@@ -513,6 +730,13 @@ function withRuntimeAvailability(
       blocked_by: "music_similarity_not_ready",
     };
   }
+  if (capability.requires_music_preview && !musicPreviewReady) {
+    return {
+      ...capability,
+      state: "blocked",
+      blocked_by: "music_preview_not_ready",
+    };
+  }
   return capability;
 }
 
@@ -529,7 +753,11 @@ export function listCapabilities({
   musicCatalogReady = false,
   musicDiscoveryReady = false,
   musicSimilarityReady = false,
-  webResearchReady = false,
+  webSearchProvider = null,
+  webReadProvider = null,
+  profileExplorationReady = false,
+  profileBuildReady = false,
+  musicPreviewReady = false,
 } = {}) {
   return structuredClone(
     catalog.map((capability) =>
@@ -547,7 +775,10 @@ export function listCapabilities({
         musicCatalogReady,
         musicDiscoveryReady,
         musicSimilarityReady,
-        webResearchReady,
+        { search: webSearchProvider, read: webReadProvider },
+        profileExplorationReady,
+        profileBuildReady,
+        musicPreviewReady,
       ),
     ),
   );
@@ -567,11 +798,3 @@ export function listAgentCapabilityDescriptors(options = {}) {
       label: capability.agent_tool.label,
     }));
 }
-
-export function getAgentCapabilityByToolName(toolName, options = {}) {
-  return (
-    listAgentCapabilityDescriptors(options).find(
-      (capability) => capability.tool_name === toolName,
-    ) ?? null
-  );
-}