Cortex Actions

Statut

Addon first-party livré avec arka-deck. Registre actuel statique / first-party ; pas de marketplace tiers actif.

Champ	Valeur
Manifest	addons/cortex-actions/manifest.json
Entrypoint	addons/cortex-actions/src/index.ts
Maturité	beta

Rôle

Cortex Actions expose dans le chat un panneau de blocs catalogue sélectionnables pour cadrer le prochain tour agent. Un bloc sélectionné est préparé pour le prochain message utilisateur comme contenu prêt agent, rendu en TOON et injecté depuis le runtime local du projet.

Les favoris sont hydratés local-first via Cortex Lite. arka-deck résout d’abord l’atome par sourceId dans le graphe local ; le Cortex public n’est utilisé que si l’atome local est absent ou incomplet, puis le contenu récupéré est synchronisé dans Cortex Lite avant de pouvoir devenir une entrée runtime. Le runtime n’injecte jamais seulement une adresse MCP ou un pointeur distant.

Les agent action cards exposent aussi les choix runtime produits pendant l’orchestration : préparer les tasks ArkaDoc avant dispatch, approuver le dispatch, relancer après QA ou demander un arbitrage. Les cards d’approbation de dispatch ne ciblent que des documents ArkaDoc task ready assignés à des rôles worker (owner ou contributor) ; les assignations QA sont exclues des cibles de dispatch. Les cards sont indexées par session/run pour éviter les doublons lors des rafraîchissements.

Surfaces

Surface	Emplacement
Options projet	<projet>/.arka-deck/addons/cortex-actions.json
Logs d’exécution	<projet>/.arka-deck/cortex-actions/{année}/{mois}/exec_*.json
Favoris projet	<projet>/.arka-deck/cortex-actions/favorites.json
Worker déclaré	cortex-favorites-suggester
Cards runtime	Route projet /api/projects/:id/agent-action-cards

Évènements écoutés / publiés

• Écoute : événements de chat pertinents pour la sélection de blocs catalogue avant un tour.
• Publie : sélection enregistrée, exécution Cortex Actions, suggestion favorite.

Limites

Le panneau public n’expose pas les modes de gouvernance, profils, atomes ou documents comme surfaces runtime sélectionnables par l’utilisateur. L’addon consomme les surfaces Cortex déjà câblées dans le composition root, ne charge pas de code tiers dynamique et ne transforme pas le registre interne en marketplace public.

Les cards runtime ne contournent pas Mission Guardian. Sélectionner une card de dispatch soumet toujours une commande runtime, qui peut être refusée par les gates mission.

Pour aller plus loin

• Contrat addon formel : ../extension/contrat-addon (à venir)
• Tutoriel “écrire un addon” : ../extension/ecrire-un-addon (à venir)