Addons

Un addon est un module autonome qui ajoute une capacité à arka-deck : mémoire, Mission Control, panneau d’artefacts, squad, connecteur, etc. Les addons s’abonnent aux événements du chat et enrichissent l’expérience sans modifier le cœur.

Addons préinstallés (first-party)

arka-deck embarque ses addons fondamentaux. Aucune installation tierce n’est nécessaire pour démarrer.

Addon	Rôle	Statut
`cortex-actions`	Panneau d’artefacts Cortex et action cards runtime dans le chat	beta
`cortex-lite`	Runtime Cortex local en sidecar (graphe projet SurrealDB, contexte agent, MCP `arka_runtime`)	stable
`memory-local`	Mémoire agentique par projet (capture, consolidation, augmentation)	beta
`mission-guardian`	État mission, Mission Control, gates leader et QA, preuves	beta
`squad-leader`	Composition et coordination de squads	beta
`squad-orchestration`	Orchestration multi-agents LangGraph (mission, CR, verdict)	beta
`notion-connect`	Connecteur Notion (pages, blocs, OAuth)	beta
`gmail`	Connecteur Gmail via token ou gateway API géré par l’utilisateur	beta
`google-drive`	Connecteur Google Drive via token ou gateway API géré par l’utilisateur	beta
`@arkalabs/addon-expert-panel`	Infrastructure de Packs Métier	non exposé en release

Gmail et Google Drive n’utilisent pas une app OAuth Google globale arka-deck. L’utilisateur apporte le credential runtime ou la gateway de son installation et peut rattacher un endpoint MCP qu’il gère. Si aucun endpoint MCP n’est configuré, aucun endpoint fictif n’est exposé.

Les MCP externes se rattachent ensuite au projet depuis Sources externes → MCP projet. Un MCP attaché devient disponible aux agents de ce projet uniquement, sous un nom runtime connector_*. Les secrets ne sont pas copiés dans la configuration MCP : ils restent portés par l’installation connecteur ou par une politique de secret dédiée.

Modules, addons et packs

Tous les éléments visibles dans l’application ne sont pas des addons.

ArkaDoc est un module documentaire natif.
Cortex Lite est le runtime local et le graphe projet.
Mission Guardian est l’addon qui administre et applique les packs de gouvernance.
Deck Guardian est le pack de gouvernance first-party par défaut.
Expert Panel est l’infrastructure prévue pour activer des Packs Métier, mais aucun Pack Métier first-party n’est publié dans cette release.

Voir la carte complète : Modules et packs.

Activer un addon

La vue Addons liste les modules disponibles. Certains addons peuvent être activés ou désactivés par projet (par exemple, vous pouvez désactiver memory-local sur un projet qui n’a pas besoin de mémoire persistante).

Pour les addons toujours actifs (cortex-actions, cortex-lite), l’activation est gérée par arka-deck.

Expert Panel

Expert Panel reste une infrastructure interne de Packs Métier, mais elle n’est pas exposée dans cette release publique.

Raison : les Packs Métier doivent porter leur propre guardian pack dédié. Tant que cette gouvernance dédiée n’est pas validée end-to-end, arka-deck ne publie aucun pack métier first-party et ne propose pas leur activation dans l’UI.

Conséquence release :

aucun Pack Métier marketing, vente, formation ou client n’est publié ;
le catalogue runtime Expert Panel est vide par défaut ;
la vue projet ne propose pas d’activation Pack Métier ;
les packs privés restent hors dépôt public et hors tarball.

Le cadre standard reste Deck Guardian via Mission Guardian.

Limites publiques actuelles

Le contrat addon est stabilisé pour permettre, à terme, des extensions externes.
Pour aujourd’hui, tous les addons en production restent first-party et câblés explicitement dans arka-deck.
Il n’y a pas de chargement de marketplace tiers actif. Cette possibilité reste une trajectoire produit, pas une promesse actuelle.

Cette posture est volontaire : tant que le sandboxing et la signature d’addons tiers ne sont pas mûrs, nous préférons un périmètre maîtrisé.

Pour les contributeurs

Si vous voulez écrire un addon :

Lire la fiche addon-firstparty d’un addon proche (par exemple memory-local)
Suivre le tutoriel écrire un addon
Consulter le contrat addon

Et après ?

Comprendre où vivent vos données : 07-securite-et-donnees
Voir les cas d’usage qui s’appuient sur les addons : 04-cas-usage/
Rattacher un serveur MCP projet : connecter un MCP projet