Memory Local

Statut

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

Champ	Valeur
Manifest	addons/memory-local/manifest.json
Entrypoint	addons/memory-local/src/index.ts
Maturité	beta
Port inbound exposé	ForMemory

Rôle

Memory Local capture une mémoire par session, consolide une mémoire par profil agent, compose une mémoire projet et l’injecte dans les prochains tours via le mécanisme BeforeTurnAugmenter.

L’addon est provider-neutre : tout runtime de chat qui émet les événements attendus peut alimenter la mémoire.

Surfaces

Surface	Emplacement
Options addon	<projet>/.arka-deck/addons/memory-local/options.json
Stockage mémoire	<projet>/.arka-deck/addons/memory-local/memory.json

Événements écoutés

• chat.session.ended — déclenche une capture de jalons
• chat.runtime.failure — note les erreurs runtime utiles à la mémoire
• chat.memorize — capture explicite demandée

Modèle de mémoire

L’addon expose :

• une fonction registerLocalMemoryAddon qui câble les abonnements et le port inbound ;
• un port ForMemory pour lire et écrire les options, la vue d’ensemble et les captures ;
• un before-turn augmenter qui lit la mémoire locale récente avant un tour ;
• un subscriber qui réagit aux événements session/failure.

Limites

• Mémoire locale d’abord : pas de service cloud requis.
• Le Cortex Runtime peut enrichir les prompts et les atomes de contexte, mais il n’est pas l’autorité de stockage pour les notes locales.
• arka-deck ne mute jamais CLAUDE.md ou autres fichiers d’instructions agent comme chemin de mémoire par défaut.
• Aucun secret ni credential ne doit être persisté dans une note mémoire.

Pour aller plus loin

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