Permettre aux intégrations externes de déclarer leur propre déclencheur/actions de scènes

pierre-gilles · Septembre 18, 2026, 7:50

Les intégrations externes devraient pouvoir déclarer des déclencheurs et des actions de scènes, pour pouvoir étendre Gladys sans mise à jour du core.

cursor-bot · Septembre 18, 2026, 8:07

Salut tout le monde !

Ce sujet est désormais en cours de développement.

Une PR a été ouverte pour spécifier les déclencheurs et actions de scènes déclarés par les intégrations externes :

github.com/GladysAssistant/Gladys

docs(specs): specify scene triggers and actions declared by external integrations (#3110)

master ← claude/wonderful-albattani-8v9pbw

ouvert 08:06AM - 18 Sep 26 UTC

Pierre-Gilles

+259 -0

### Description Spec-first PR (no code): adds `docs/specs/external-integrations…/capabilities/scene-triggers-and-actions.md`, a self-contained capability file of the external integrations living spec, following the folder's rules (one file per capability, owns its manifest field, endpoints, WebSocket messages, SDK surface, frontend behavior, tests and manual verification; no new section identifier, nothing edited in the shared `contracts/` tables). What the spec defines: - **Manifest**: two optional top-level fields, `scene_triggers` and `scene_actions` (1–20 each), declarable by every integration type. Triggers carry `fields` (filters, same flat format as `config_schema`, restricted type list) and `variables` (whitelist of the event data exposed to the scene). Actions carry `fields`, `timeout_seconds` (5–120) and `outputs` (whitelist of the values returned to the scene). Keys are permanent. - **Core scene engine**: one generic trigger type `external-integration.scene-event` and one generic action type `external-integration.scene-action`, both carrying the integration selector and the declared key, with `fields` nested (stored shapes given). Matching is deliberately simple: equality / `multi_select` membership on declared fields, empty = wildcard; thresholds and operators stay on device features. Actions template `string` fields, validate against the declaration at execution time, relay through the proxy service (`scene.runAction`) and write whitelisted `outputs` into the scope. The manifest is consulted at execution time, never at save time, so scenes load and save even when the integration is gone. - **Host API**: `POST /api/integration/v1/scene/event` `{ key, data }` — flat bounded data, whitelisted against the declaration, `404` on an undeclared key, 60 events/min per integration. REST rather than a fire-and-forget WS message because the payload can be wrong and the integration must get a `4xx`. - **WebSocket**: `external-integration.scene-action.run` `{ message_id, key, fields }` → `command-result` `data.outputs`, ack within the declared `timeout_seconds`. - **Frontend**: a new read-only `GET /api/v1/external_integration/scene` (every authenticated user, literal route before `:selector`), a dynamic "Integrations" category in both type pickers, trigger/action cards rendered by the existing `ConfigField` engine (string fields of actions use the variables-aware input), orphan/stopped cards flagged honestly and never edited behind the user's back, an informational line on the install screen. - **Lifecycle, security, SDK** (`publishSceneEvent`, `onSceneAction`), template demo declarations, developer-docs doctrines (state vs event, trigger not data, keys are forever), the test matrix and the manual verification journey, and an explicit out-of-scope list. ### Related request Forum: ``https://community.gladysassistant.com/t/permettre-aux-integrations-externes-de-declarer-leur-propre-declencheur-actions-de-scenes``/10870 ### Checklist - [x] If a forum topic or GitHub issue exists, the description links it (`Forum: https://community.gladysassistant.com/t/...` or `Closes #...`) - [ ] Tests pass: `cd server && npm run coverage` (Codecov requires 100% coverage on changed lines) and Cypress (`npm run cypress:run`) if the UI changed — not applicable, documentation only - [ ] Linter and prettier pass on both front and server (`npm run eslint`, `npm run prettier`) — not applicable, documentation only - [x] No undocumented breaking change 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01SzdCt7PkgNaicRRsFLnzkJ --- _Generated by [Claude Code](https://claude.ai/code/session_01SzdCt7PkgNaicRRsFLnzkJ)_

N’hésitez pas à suivre la PR, à tester (optionnel, surtout pour les petites demandes) et à faire vos retours ici si besoin.

Sujet		Réponses	Vues
[Intégrations externes] Ecrans personnalisés Demande de fonctionnalités to-be-processed	0	41	Août 29, 2026
Intégrations externes - Mises à jour automatiquement installées Demande de fonctionnalités to-be-processed	5	53	Août 17, 2026
Prévisions Météo en déclencheur dans la gestion des scènes Demande de fonctionnalités feature-core	2	650	Mars 13, 2022
Scènes partageables : exporter, importer et partager des scènes paramétrables Demande de fonctionnalités to-be-processed	0	30	Août 3, 2026
Pouvoir créer des variables globales utilisables dans gladys (Latitude, Longitude, Date, Heure etc) Demande de fonctionnalités feature-core , variables-globales	0	240	Décembre 6, 2023

Permettre aux intégrations externes de déclarer leur propre déclencheur/actions de scènes

Sujets connexes