diff --git a/.DS_Store b/.DS_Store index 06359845..7c41d3b8 100644 Binary files a/.DS_Store and b/.DS_Store differ diff --git a/.serena/.gitignore b/.serena/.gitignore new file mode 100644 index 00000000..2e510aff --- /dev/null +++ b/.serena/.gitignore @@ -0,0 +1,2 @@ +/cache +/project.local.yml diff --git a/.serena/project.yml b/.serena/project.yml new file mode 100644 index 00000000..adeadfe4 --- /dev/null +++ b/.serena/project.yml @@ -0,0 +1,133 @@ +# the name by which the project can be referenced within Serena +project_name: "pmomusic" + + +# list of languages for which language servers are started; choose from: +# al angular ansible bash clojure +# cpp cpp_ccls crystal csharp csharp_omnisharp +# dart elixir elm erlang fortran +# fsharp go groovy haskell haxe +# hlsl html java json julia +# kotlin lean4 lua luau markdown +# matlab msl nix ocaml pascal +# perl php php_phpactor powershell python +# python_jedi python_ty r rego ruby +# ruby_solargraph rust scala scss solidity +# svelte swift systemverilog terraform toml +# typescript typescript_vts vue yaml zig +# (This list may be outdated. For the current list, see values of Language enum here: +# https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py +# For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.) +# Note: +# - For C, use cpp +# - For JavaScript, use typescript +# - For Angular projects, use angular (subsumes typescript+html; requires `npm install` in the project root) +# - For Svelte projects, use svelte (subsumes typescript/javascript for .svelte projects; requires npm) +# - For SCSS / Sass / plain CSS, use scss (some-sass-language-server handles all three) +# - For Free Pascal/Lazarus, use pascal +# Special requirements: +# Some languages require additional setup/installations. +# See here for details: https://oraios.github.io/serena/01-about/020_programming-languages.html#language-servers +# When using multiple languages, the first language server that supports a given file will be used for that file. +# The first language is the default language and the respective language server will be used as a fallback. +# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored. +languages: +- rust + +# the encoding used by text files in the project +# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings +encoding: "utf-8" + +# line ending convention to use when writing source files. +# Possible values: unset (use global setting), "lf", "crlf", or "native" (platform default) +# This does not affect Serena's own files (e.g. memories and configuration files), which always use native line endings. +line_ending: + +# The language backend to use for this project. +# If not set, the global setting from serena_config.yml is used. +# Valid values: LSP, JetBrains +# Note: the backend is fixed at startup. If a project with a different backend +# is activated post-init, an error will be returned. +language_backend: + +# whether to use project's .gitignore files to ignore files +ignore_all_files_in_gitignore: true + +# advanced configuration option allowing to configure language server-specific options. +# Maps the language key to the options. +# Have a look at the docstring of the constructors of the LS implementations within solidlsp (e.g., for C# or PHP) to see which options are available. +# No documentation on options means no options are available. +ls_specific_settings: {} + +# list of additional workspace folder paths for cross-package reference support (e.g. in monorepos). +# Paths can be absolute or relative to the project root. +# Each folder is registered as an LSP workspace folder, enabling language servers to discover +# symbols and references across package boundaries. +# Currently supported for: TypeScript. +# Example: +# additional_workspace_folders: +# - ../sibling-package +# - ../shared-lib +additional_workspace_folders: [] + +# list of additional paths to ignore in this project. +# Same syntax as gitignore, so you can use * and **. +# Note: global ignored_paths from serena_config.yml are also applied additively. +ignored_paths: [] + +# whether the project is in read-only mode +# If set to true, all editing tools will be disabled and attempts to use them will result in an error +# Added on 2025-04-18 +read_only: false + +# list of tool names to exclude. +# This extends the existing exclusions (e.g. from the global configuration) +# Find the list of tools here: https://oraios.github.io/serena/01-about/035_tools.html +excluded_tools: [] + +# list of tools to include that would otherwise be disabled (particularly optional tools that are disabled by default). +# This extends the existing inclusions (e.g. from the global configuration). +# Find the list of tools here: https://oraios.github.io/serena/01-about/035_tools.html +included_optional_tools: [] + +# fixed set of tools to use as the base tool set (if non-empty), replacing Serena's default set of tools. +# This cannot be combined with non-empty excluded_tools or included_optional_tools. +# Find the list of tools here: https://oraios.github.io/serena/01-about/035_tools.html +fixed_tools: [] + +# list of mode names that are to be activated by default, overriding the setting in the global configuration. +# The full set of modes to be activated is base_modes (from global config) + default_modes + added_modes. +# If the setting is undefined/empty, the default_modes from the global configuration (serena_config.yml) apply. +# Otherwise, this overrides the setting from the global configuration (serena_config.yml). +# Therefore, you can set this to [] if you do not want the default modes defined in the global config to apply +# for this project. +# This setting can, in turn, be overridden by CLI parameters (--mode). +# See https://oraios.github.io/serena/02-usage/050_configuration.html#modes +default_modes: + +# list of mode names to be activated additionally for this project, e.g. ["query-projects"] +# The full set of modes to be activated is base_modes (from global config) + default_modes + added_modes. +# See https://oraios.github.io/serena/02-usage/050_configuration.html#modes +added_modes: + +# initial prompt for the project. It will always be given to the LLM upon activating the project +# (contrary to the memories, which are loaded on demand). +initial_prompt: "" + +# time budget (seconds) per tool call for the retrieval of additional symbol information +# such as docstrings or parameter information. +# This overrides the corresponding setting in the global configuration; see the documentation there. +# If null or missing, use the setting from the global configuration. +symbol_info_budget: + +# list of regex patterns which, when matched, mark a memory entry as read‑only. +# Extends the list from the global configuration, merging the two lists. +read_only_memory_patterns: [] + +# list of regex patterns for memories to completely ignore. +# Matching memories will not appear in list_memories or activate_project output +# and cannot be accessed via read_memory or write_memory. +# To access ignored memory files, use the read_file tool on the raw file path. +# Extends the list from the global configuration, merging the two lists. +# Example: ["_archive/.*", "_episodes/.*"] +ignored_memory_patterns: [] diff --git a/Blackboard/ToDiscuss/play_from_url.md b/Blackboard/ToDiscuss/play_from_url.md new file mode 100644 index 00000000..d6dd2f6a --- /dev/null +++ b/Blackboard/ToDiscuss/play_from_url.md @@ -0,0 +1,323 @@ +# Play From URL — source `UrlSource` + +Inspiré par BubbleUPnP : recevoir n'importe quelle URL (lien de partage Qobuz, +flux radio, playlist M3U, page web contenant de l'audio…) et la jouer +immédiatement sur le renderer actif. + +--- + +## Vision architecturale + +`UrlSource` est une **source musicale ordinaire** qui implémente `MusicSource`, +exactement comme Qobuz, RadioFrance ou RadioParadise. Elle apparaît dans le +drawer gauche au même titre que les autres sources du serveur PMO. + +Sa particularité : sa **barre de recherche est le champ URL**. L'utilisateur +colle ou tape une URL, appuie sur Entrée — la source résout l'URL et retourne +le contenu jouable comme un `BrowseResult` normal. + +``` +Drawer gauche + └─ PMO Music Server + ├─ Qobuz + ├─ Radio Paradise + ├─ Radio France + └─ URL / Partage ← nouvelle source + └─ [barre de recherche = champ URL] + └─ coller une URL + Entrée + └─ résolution → BrowseResult → queue + play +``` + +Avantages de cette approche : +- **Zéro nouvelle UI** : la barre de recherche existante du drawer gère tout +- **Zéro nouvel endpoint REST** : browse/search existants suffisent +- **Zéro cas particulier** dans le drawer ou le content directory handler +- `browse()` du container racine peut afficher un **historique** des URLs jouées + +--- + +## Trait `UrlHandler` (dans `pmosource`) + +Chaque source (et un handler générique) peut revendiquer les URLs qu'elle sait +résoudre. + +```rust +pub enum ResolvedContent { + /// Référence à un container d'une source existante + /// → la UrlSource délègue le browse à cette source + SourceContainer { + source_id: String, // "qobuz", "radiofrance", … + container_id: String, // "qobuz:album:l46fxnqnxp5vs" + }, + /// Liste de tracks (M3U, PLS, XSPF, RSS/podcast…) + Playlist { + title: Option, + items: Vec, + }, + /// Track unique ou flux continu + Track { + uri: String, + metadata: TrackMetadata, + }, + Stream { + uri: String, + metadata: StreamMetadata, + }, +} + +#[async_trait] +pub trait UrlHandler: Send + Sync { + fn name(&self) -> &str; + /// Priorité : plus grand = essayé en premier (défaut 50) + fn priority(&self) -> u8 { 50 } + /// Test rapide sans I/O (regex sur l'URL) + fn can_handle(&self, url: &str) -> bool; + /// Résolution effective (I/O autorisé) + async fn resolve(&self, url: &str) -> Result; +} +``` + +--- + +## Handlers spécifiques aux sources + +### `QobuzUrlHandler` (dans `pmoqobuz`) — priorité 90 + +URLs reconnues. Les IDs sont potentiellement alphanumériques pour tous les +types (pas seulement les albums) : + +| Forme d'URL | Exemple | +|---|---| +| `open.qobuz.com/album/` | `https://open.qobuz.com/album/l46fxnqnxp5vs` | +| `play.qobuz.com/album/` | `https://play.qobuz.com/album/l46fxnqnxp5vs` | +| `open.qobuz.com/track/` | `https://open.qobuz.com/track/48471123` | +| `open.qobuz.com/playlist/` | `https://open.qobuz.com/playlist/63246908` | +| `open.qobuz.com/artist/` | `https://open.qobuz.com/artist/125709` | + +Regex d'extraction : `[a-zA-Z0-9]+` pour tous les types sans exception. + +Résolution sans appel API — l'ID est directement mappé sur un container_id : + +``` +open.qobuz.com/album/l46fxnqnxp5vs + → ResolvedContent::SourceContainer { + source_id: "qobuz", + container_id: "qobuz:album:l46fxnqnxp5vs", + } +``` + +### `RadioFranceUrlHandler` (dans `pmoradiofrance`) — priorité 90 + +URLs `radiofrance.fr/*`, `francemusique.fr/*`, `fip.fr/*`, etc. +→ `ResolvedContent::Stream` + +### `RadioParadiseUrlHandler` (dans `pmoparadise`) — priorité 90 + +URLs `radioparadise.com/*` +→ `ResolvedContent::Stream` + +--- + +## Handler générique (dans `pmourlresolver`, nouveau crate) — priorité 10 + +Dernier recours. Pipeline interne : + +``` +URL + │ + ├─ Garde-fou SSRF : rejeter si IP résolue est privée/locale + │ (RFC-1918 : 10/8, 172.16/12, 192.168/16 ; loopback : 127/8, ::1 ; + │ link-local : 169.254/16, fe80::/10) + │ → aucun cas d'usage légitime pour une URL interne ici + │ + ├─ HEAD request → Content-Type audio/* ? + │ └─ → ResolvedContent::Stream / Track (URI directe) + │ + ├─ Extension ou Content-Type playlist ? + │ ├─ .m3u / .m3u8 / application/vnd.apple.mpegurl → parse M3U + │ ├─ .pls / audio/x-scpls → parse PLS + │ └─ .xspf / application/xspf+xml → parse XSPF + │ + ├─ application/rss+xml / application/xml ? + │ └─ → parse RSS, extraire les audio → Playlist + │ + └─ text/html ? + └─ GET + parse HTML + ├─