overmind-mcp 3.3.5 → 3.3.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +6 -9
  2. package/docs/SETUP_HERMES_AGENT_FROM_SCRATCH.md +12 -10
  3. package/docs/SUBTILISATION_EXPLAINED.md +1 -1
  4. package/docs/provider-config-map.md +2 -2
  5. package/package.json +1 -1
package/README.md CHANGED
@@ -49,17 +49,14 @@ Le postinstall crée `~/.overmind/` automatiquement :
49
49
  ├── bridge/
50
50
  │ ├── agents.json ← registre sessions unifié
51
51
  │ └── process-registry.json ← runtime live
52
- └── hermes/
52
+ └── hermes/ ← HERMES_HOME (injecté par HermesRunner)
53
53
  └── profiles/ ← SOURCE homes (unique)
54
54
  └── <name>/
55
- │ ├── profile.yaml ← description kanban (OBLIGATOIRE)
56
- │ ├── config.yaml ← Hermes config (model, provider)
57
- │ ├── SOUL.md ← system prompt
58
- │ ├── .env ← credentials spécifiques
59
- │ ├── .mcp.json ← override MCP
60
- │ ├── state.db ← state local (SQLite)
61
- │ ├── workspace.yaml ← kind: scratch|persistent|shared
62
- │ └── README.md ← rôle + owner
55
+ ├── config.yaml ← Hermes config (model, provider)
56
+ ├── SOUL.md ← system prompt
57
+ ├── .env ← credentials spécifiques
58
+ ├── state.db ← state local (SQLite)
59
+ └── skills/ ← skills personnalisés
63
60
  ```
64
61
 
65
62
  ### Configuration MCP Client
package/docs/SETUP_HERMES_AGENT_FROM_SCRATCH.md CHANGED
@@ -128,12 +128,14 @@ automatiquement quels env vars provider-specific seed (e.g. `MINIMAX_CN_API_KEY`
128
128
  │ └── agents/<agent>.md ← (legacy, ignoré par Hermes)
129
129
  ├── .mcp.json ← registre MCP servers HTTP
130
130
  ├── .env ← tokens + secrets ($VAR)
131
- ├── .overmind/hermes/ ← HERMES_HOME (root partagé)
132
- │ ├── agents/<agent>/ ← COUCHE 2 (canonique, auto-généré)
133
- │ │ ├── settings.json ← écrit par le runner
134
- │ │ ├── SOUL.md ← persona de l'agent
135
- │ │ ├── sessions/ logs/ memories/ ← Hermes upstream écrit
136
- │ ├── config.yaml ← COUCHE 3 (Hermes global, auto-bootstrappé)
131
+ ├── .overmind/hermes/ ← HERMES_HOME (root partagé, injecté par HermesRunner)
132
+ │ ├── config.yaml ← Config globale Hermes (auto-bootstrappé)
133
+ │ ├── auth.json ← Credential pool
134
+ │ └── profiles/<agent>/ ← COUCHE 2 (canonique v3.1)
135
+ │ ├── config.yaml ← Provider + model + mcp_servers
136
+ │ ├── SOUL.md ← Persona de l'agent
137
+ │ ├── .env ← Clés API spécifiques
138
+ │ └── state.db ← Sessions + state local
137
139
  │ ├── auth.json ← COUCHE 3 (credential pool, Hermes global)
138
140
  │ ├── sessions/ logs/ ← partagés entre agents
139
141
  └── src/ ← code source Overmind (si dev)
@@ -141,7 +143,7 @@ automatiquement quels env vars provider-specific seed (e.g. `MINIMAX_CN_API_KEY`
141
143
 
142
144
  **3 couches pour 3 raisons :**
143
145
  - **Source** `.claude/settings_<name>.json` = portable entre 4 runners (Claude/Kilo/OpenClaw/Hermes)
144
- - **Canonique** `.overmind/hermes/agents/<name>/settings.json` = ce qu'Hermes upstream lit
146
+ - **Canonique** `.overmind/hermes/profiles/<name>/config.yaml` = ce qu'Hermes upstream lit (via HERMES_HOME injecté par HermesRunner)
145
147
  - **Globale** `.overmind/hermes/config.yaml` + `auth.json` = état partagé, géré par Hermes upstream
146
148
 
147
149
  ### 4.3 La subtilisation — TABLE DE MAPPING (le coeur du fix 2.8.x)
@@ -246,7 +248,7 @@ de matcher mais ça peut casser.
246
248
 
247
249
  ### 6.3 Le persona de l'agent (SOUL.md)
248
250
 
249
- **`~/overmind-workflow/.overmind/hermes/agents/sniperbot_analyst/SOUL.md`**
251
+ **`~/.overmind/hermes/profiles/sniperbot_analyst/SOUL.md`**
250
252
 
251
253
  Ce fichier est créé automatiquement par le runner au premier spawn, mais
252
254
  tu peux le pré-créer. Format : markdown libre.
@@ -276,7 +278,7 @@ toujours via les outils MCP Discord (jamais de texte brut après un appel).
276
278
  **`~/overmind-workflow/.overmind/hermes/config.yaml`**
277
279
 
278
280
  Ce fichier est créé automatiquement par le runner Overmind au premier
279
- spawn (depuis `~/.hermes/config.yaml` par défaut). Contient au minimum :
281
+ spawn (depuis `~/.overmind/hermes/config.yaml` par défaut). Contient au minimum :
280
282
 
281
283
  ```yaml
282
284
  mcp_servers:
@@ -421,7 +423,7 @@ curl http://localhost:3001/status # bridge
421
423
  | Sniperbot dit "j'ai pas de MCP" mais log montre 69 tools registered | SOUL.md désaligné | Réécrire le SOUL.md pour lister les vrais tools |
422
424
  | "Provider: openrouter" au lieu de "minimax-cn" | `--provider` flag pas passé | Vérifier que le runner a `--provider` dans cleanArgs |
423
425
  | `EXIT_CODE_1` sur le bridge | MCP server tourne l'ancien build | `pkill -f overmind && overmind start &` |
424
- | "Erreur inconnue" générique | Stale state dans `.overmind/hermes/agents/<name>/.hermes/` | Migrer vers `agents/<name>/` (le helper `getAgentHermesHome` 2.8.30 le fait auto) |
426
+ | "Erreur inconnue" générique | Stale state dans l'ancien layout | Migrer vers `~/.overmind/hermes/profiles/<name>/` (le script `install-overmind-native.sh` le fait auto) |
425
427
  | `cleanupTempFiles` efface le settings.json canonique | settings.json pushé dans `tempFiles` | Bug fixé en 2.8.32 — ne pas push |
426
428
 
427
429
  ---
package/docs/SUBTILISATION_EXPLAINED.md CHANGED
@@ -165,7 +165,7 @@ Ce que tu n'as PAS besoin de faire
165
165
  - Tu n'as pas à lire plugins/model-providers/minimax/init.py
166
166
  - Tu n'as pas à mapper manuellement $KEY vers le bon provider
167
167
  - Tu n'as pas à tester 50 combinaisons d'env var names
168
- - Tu n'as pas à te soucier du cwd du process pour HERMES_HOME
168
+ - Tu n'as pas à te soucier du cwd du process pour HERMES_HOME (v3.1: injecté par HermesRunner)
169
169
 
170
170
  Tu mets ton token, Overmind s'occupe du reste.
171
171
 
package/docs/provider-config-map.md CHANGED
@@ -11,7 +11,7 @@ Workflow/.env (~/.env)
11
11
  ↓
12
12
  settings_[agent].json → env (apres interpolation $VAR par process.env)
13
13
  ↓
14
- HERMES_HOME/.env (~/.hermes/.env) ← DERNIER MOT
14
+ HERMES_HOME/.env (~/.overmind/hermes/.env) ← DERNIER MOT (v3.1: HERMES_HOME injecté par HermesRunner)
15
15
  ```
16
16
 
17
17
  **Detail du code** (`NousHermesRunner.ts` l.268-456):
@@ -36,7 +36,7 @@ Donc le `.hermes/.env` de l'agent a **toujours le dernier mot**. Si tu mets `MIN
36
36
 
37
37
  | Fichier | Role |
38
38
  |---|---|
39
- | `HERMES_HOME/.env` | API keys globales Hermes (fallback) |
39
+ | `HERMES_HOME/.env` | API keys globales Hermes (~/.overmind/hermes/.env) (fallback) |
40
40
  | `Workflow/.env` | Variables du workflow (DB, tokens, etc.) |
41
41
  | `settings_[agent].json` | Config par agent (model, provider, tokens, MCP) |
42
42
  | `HERMES_HOME/.hermes/config.yaml` | Config systeme Hermes (model.default, provider, etc.) |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "overmind-mcp",
3
- "version": "3.3.5",
3
+ "version": "3.3.6",
4
4
  "description": "Orchestrateur universel agents IA multi-modeles via MCP. Inclut le protocole 'Custom-Nickname' pour identifier vos agents avec des surnoms originaux (The Chaos Prophet, Shadow Sniper, etc.), l'isolation mémoire (Private Memory Context) et le support pour QwenCli et Nous Hermes. Installation automatique des dépendances Docker (PostgreSQL, pgvector) inclus.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",