cancel_push
ChatGPTAnnuler un push en cours et revenir tout de suite au service précédent (sinon il expire de lui-même, voir push_content).
describe_device
ChatGPTIdentifier un écran Écran Papier à partir du lien de sa page ou de son identifiant : renvoie son nom et son lien. À appeler quand l'utilisateur te présente un écran, pour le retenir sous son nom.
get_alarm_schedule
ChatGPTLire les alarmes hebdomadaires mémorisées avec tous leurs réglages (heure, jours, son, mélodie, volume, fade_in_seconds, max_duration_seconds), leur révision et la prochaine occurrence calculée dans le fuseau de l'appareil. Au réveil, le volume monte de 0 à volume pendant fade_in_seconds, puis l'alarme sonne max_duration_seconds à ce volume.
get_capabilities
ChatGPTLire les capacités effectives et leur source (déclaration firmware ou vérification admin) : écran, haut-parleur, microphone et alarmes.
get_local_time
ChatGPTLire l'heure UTC de confiance, l'heure locale dérivée et le fuseau IANA mémorisé pour cet appareil.
get_orientation
ChatGPTLire l'orientation de contenu de l'écran avant de composer une image : horizontal/vertical, rotation, dimensions logiques et dimensions du buffer.
get_product
ChatGPTOne frame by its slug (from list_products), with the same fields plus its product page's text: details, characteristics and every photo.
get_schedule
ChatGPTLire le planning de l'écran : les règles horaires (tel service de telle heure à telle heure, tels jours), le service par défaut hors règles, et le service que tout cela donne en ce moment.
get_state
ChatGPTLire l'état de l'écran : service affiché, réglages utiles (params), règles horaires, capacités et santé. Les URL privées sont remplacées par url_configured ; les jetons, paramètres internes et détails techniques des erreurs sont omis. À appeler avant de décider quoi changer. Une préparation réussie ne prouve pas la réception physique par l'écran.
list_products
ChatGPTList the frames on sale with their live price and stock: slug, name, description, price (VAT and shipping included), units remaining, sold_out, photo, and the product page to link a person to. Also returns the shop page where a person orders, the countries shipped to and the contact address. Stock changes with every sale: call this again rather than reusing an earlier answer.
preview_tune
ChatGPTFaire écouter une mélodie d'alarme (MML, voir le champ tune de set_alarm_schedule) avant de la régler : vérifie le texte, puis renvoie un lien vers un lecteur qui la joue dans le navigateur exactement comme l'écran la synthétise, en boucle (sans le fondu d'entrée de l'alarme). Donne le lien au propriétaire : il appuie sur Lecture. Les applications qui affichent les MCP Apps montrent le lecteur directement dans la conversation. Ne touche à aucune alarme ; pour l'enregistrer, update_alarm. Une erreur nomme la ligne à corriger.
push_content
ChatGPTAfficher tout de suite un texte ou une image, prioritaire sur le service actuellement configuré — même si des règles horaires sont actives — puis revenir automatiquement au service précédent. Un texte remplace le message enregistré du tableau de messages : l'expiration rétablit le service habituel, pas l'ancien texte. Ne présente donc pas un push de texte comme une opération qui conserve tous les contenus enregistrés. Exactement un de text/image_url/image_base64/image_file est requis. Sur ChatGPT, pour une image jointe à la conversation ou que tu as générée, passe-la en image_file : la plateforme télécharge le fichier elle-même, sans limite pratique de taille ni copie en base64. Ailleurs, image_base64 sert quand l'image a été fabriquée dans un bac à sable de code sans accès réseau : les octets passent dans l'appel lui-même, pas besoin d'URL ; pour une photo, compose-la d'abord à la taille de l'écran avec compose.py (skill://wignet/SKILL.md). Si la photo a une URL, ou que tu peux la déposer sur un hébergement temporaire de ton choix, passe ce lien en image_url. Recours quand elle reste trop lourde pour la conversation : l'utilisateur la dépose lui-même sur la page de l'écran (lien suivi de #photo), sans limite de taille mais sans durée réglable. L'image est téléchargée et stockée par la plateforme au moment du push, puis convertie pour l'écran : une URL signée ou temporaire convient donc, elle peut expirer juste après. Une URL injoignable est refusée immédiatement (erreur), l'écran n'est pas touché. Ce stockage est un dépannage pour un affichage ponctuel, pas un hébergement : l'image est gardée 24 h au maximum, une seule par appareil, et la suivante remplace la précédente. Pour une image qu'on veut réafficher, alterner ou garder dans la durée, l'héberger sur un service prévu pour ça et utiliser le service custom avec cette URL — voir sa note. « Tout de suite » veut dire dès le prochain réveil de l'appareil, pas instantané : sur un appareil à cadence lente ça peut rester de quelques minutes à quelques heures (vérifie interval_seconds via get_state), sauf si params.active_watch_enabled est vrai (réglage propriétaire, pas une action IA) — l'appareil reste alors joignable en permanence et le push y est visible presque tout de suite. Retour à la normale : à duration_seconds si fourni (borné 30–14400 s), sinon automatiquement au prochain cycle normalement dû du service précédent.
read_skill
ChatGPTLire un guide (Agent Skill) écrit pour toi : comment bien utiliser ces outils pour une tâche donnée. Sans argument : la liste des guides et de leurs fichiers. Avec uri : le contenu d'un fichier, en commençant par son SKILL.md ; les chemins relatifs qu'il cite (references/…, scripts/…) sont sous la même racine skill://<nom>/. Les scripts s'exécutent dans ton propre bac à sable de code, si tu en as un. Guides disponibles : - wignet (skill://wignet/SKILL.md) : Drive a Écran Papier framed e-paper display for its owner — show a message, a photo or a generated picture, switch what the frame displays (weather, surf, transit, bikes, a custom image), schedule it, save its battery, and check the result. Also answers price and stock questions about the frames sold on ecranpapier.com. Use whenever the user mentions their Écran Papier or e-paper frame, pastes a app.ecranpapier.com/w/… link, or wants something shown on the frame. - wignet-tunes (skill://wignet-tunes/SKILL.md) : Compose the melody a Écran Papier e-paper frame's alarm clock plays — write it in MML (four Game Boy-style channels), check it, let the owner hear a WAV preview, and set it on the alarm. Use when the owner wants their frame's alarm to play a tune, jingle or melody, or to change, fix or explain an alarm tune. - wignet-visuals (skill://wignet-visuals/SKILL.md) : Design images for a Écran Papier colour e-paper frame (Spectra 6 panel) that print cleanly - choose from its six inks, pick a harmonious palette and fonts that stay sharp, size text for a panel read across a room, check the file before pushing it, and convert photos so their colours stay true. Use when composing a picture, poster, dashboard, card or illustration for a Écran Papier frame, or when a pushed image looks dotted, dull or muddy.
refresh
ChatGPTRégénérer l'image maintenant (sinon l'appareil se met à jour à son prochain réveil).
set_alarm_schedule
ChatGPTRemplacer toute la collection d'alarmes hebdomadaires. Une liste vide désactive toutes les alarmes. Les jours sont mon..sun et l'heure HH:MM. Un champ omis reprend sa valeur par défaut : pour changer un réglage d'une alarme existante (volume, tune, fade_in_seconds, max_duration_seconds…), utilise plutôt update_alarm.
set_interval
ChatGPTRégler la cadence de rafraîchissement en secondes. Prend effet au prochain réveil.
set_local_time
ChatGPTChoisir le fuseau horaire IANA de l'appareil (par exemple Europe/Paris). L'horloge de confiance reste en UTC ; l'heure locale et les prochains réveils suivent automatiquement les changements DST.
set_message
ChatGPTAfficher un message texte sur l'écran (bascule sur le tableau de messages et régénère l'image par défaut).
set_orientation
ChatGPTChoisir et mémoriser l'orientation de contenu de cet écran. Accepte paysage, portrait, paysage_inverse, portrait_inverse, horizontal, landscape ou vertical. Le réglage est global à l'appareil.
set_schedule
ChatGPTRemplacer TOUTES les règles horaires de l'écran par rules (une liste vide les supprime toutes) : lis d'abord get_schedule et renvoie la liste complète, règles gardées comprises. Hors de toute règle, l'écran affiche son service par défaut (set_service). Une règle vaut chacun des jours listés ; une plage qui passe minuit (22:00 → 07:00) couvre, ces jours-là, le soir et le petit matin. Si deux règles se chevauchent, celle qui commence le plus tôt l'emporte. Les heures sont celles de Paris (Europe/Paris), quel que soit le fuseau réglé sur l'écran. Un push en cours reste prioritaire. Les réglages de chaque service se font avec set_service, pas ici.
set_service
ChatGPTChanger le service affiché et, en option, régler ses paramètres (fusionnés dans params.services.<slug>). params ne contient QUE les réglages de ce service : ne lui renvoie pas l'objet params complet lu dans get_state (une clé services ou _push est refusée). N'inclus jamais width/height. L'orientation appartient au cadre, pas au service : règle-la avec set_orientation (une clé orientation dans params est refusée) ; les services orientables en héritent. Certains services exigent un paramètre pour fonctionner — p. ex. une url renvoyant une image déjà à la taille de l'écran (voir get_state → params.width/height). Services disponibles : - bus58 (params : monitoring_ref, line_ref, destination_name) — Prochains passages d'une ligne de bus d'Île-de-France, à un arrêt et dans un sens donnés (temps réel IDFM/PRIM). - custom (params : url) — Affiche une image fournie par le propriétaire : le serveur télécharge l'URL donnée et l'envoie à l'écran. - message_board (params : text) — Affiche un texte libre saisi par le propriétaire (tableau de messages). - meteo (params : lat, lon, city, timezone, background) — Météo du jour (matin / après-midi) pour une ville, via Open-Meteo. Suit l'orientation du cadre (set_orientation) : en portrait la page est recomposée — matin et après-midi l'un au-dessus de l'autre, chacun avec sa température à gauche et son pictogramme à droite — et non pivotée. - rer_e (params : monitoring_ref, line_ref, destination_name, stop_point) — Prochains passages du RER E à un arrêt (temps réel IDFM/PRIM). - surf_bazin5 (params : spot) — Prévisions de surf détaillées pour un spot (houle, période, direction, marées). - surf_table (params : spot) — Tableau de surf heure par heure pour aujourd'hui (08/11/14/17/20h) : hauteur de vague, période, énergie, vent, et la marée du jour en bas avec son coefficient. - velib (params : station_id) — Disponibilité en temps réel des vélos et bornes d'une station Vélib (par ID de station). - windsurf_table (params : spot) — Tableau de windsurf heure par heure pour aujourd'hui (08/11/14/17/20h) : vent, rafales, et la marée du jour en bas avec son coefficient. - surf_forecast (params : spot) — Prévisions de surf sur 5 jours pour un spot. - windsurf_forecast (params : spot) — Prévisions de windsurf sur 5 jours pour un spot. [bus58] Malgré son slug, le service affiche n'importe quelle ligne de bus d'Île-de-France : trois identifiants IDFM la désignent. line_ref est la ligne, au format STIF:Line::<code>: (la 82 est STIF:Line::C01114:). monitoring_ref est l'arrêt, au format stop_point:IDFM:<id> (STIF:StopPoint:Q:<id>: est accepté aussi). destination_name filtre le sens et accepte plusieurs terminus séparés par | ; la comparaison ignore accents et casse et porte sur un fragment du nom, donc Luxembourg suffit pour « Luxembourg (Paris) ». Piège principal : un arrêt porte un identifiant par sens de circulation — deux stop_point distincts pour un même nom sur le plan. Choisir celui d'en face donne un écran qui n'affiche jamais rien, ou l'autre direction, sans message d'erreur. Les identifiants se lisent sur l'API Navitia d'IDFM (/lines?filter=line.code="82", puis /lines/<id>/stop_points) et le bon sens se vérifie sur les départs de l'arrêt, champ route.direction.name. L'écran s'étiquette seul à partir de la réponse de l'API : numéro de la ligne, nom de l'arrêt, direction. Rien à saisir pour l'affichage, et le numéro affiché ne peut donc pas contredire line_ref ; tant qu'aucune réponse n'a jamais été obtenue pour ces paramètres, l'écran reste sans numéro plutôt que d'en inventer un. Le service dépend du quota de la clé PRIM partagée : quota atteint ou API en panne affiche « Quota API ? » ou « Erreur API » à la place des minutes, l'arrêt et la ligne restant affichés. Le rafraîchissement par défaut est d'une minute — c'est du temps réel, un temps d'attente vieux de dix minutes ne veut plus rien dire. [custom] L'image est téléchargée par le serveur Écran Papier, pas par l'écran : l'URL doit être publique en http(s). Une adresse locale (localhost, IP privée) ou un service du …
sleep
ChatGPTMettre en veille prolongée pour économiser la batterie (défaut 12 h). L'écran garde son image. Effet au prochain réveil ; un sommeil en cours ne peut pas être interrompu.
update_alarm
ChatGPTModifier certains réglages d'une alarme existante, désignée par son id (voir get_alarm_schedule) ; les autres champs gardent leur valeur. Exemple : {"id": "matin", "fade_in_seconds": 300} pour une montée du volume en 5 minutes, ou {"id": "matin", "enabled": false} pour la désactiver, ou {"id": "matin", "tune": "A t120 o5 l8 c e g >c"} pour lui donner une mélodie.
wake
ChatGPTSortir de veille : rétablir la cadence normale et régénérer l'image.