overmind-mcp 2.3.1 → 2.3.2

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 (57) hide show
  1. package/dist/index.d.ts +0 -4
  2. package/dist/index.d.ts.map +1 -1
  3. package/dist/index.js +0 -5
  4. package/dist/index.js.map +1 -1
  5. package/dist/lib/orchestration/dispatcher.d.ts +3 -3
  6. package/dist/lib/orchestration/dispatcher.d.ts.map +1 -1
  7. package/dist/lib/orchestration/dispatcher.js +1 -56
  8. package/dist/lib/orchestration/dispatcher.js.map +1 -1
  9. package/dist/lib/telemetry.d.ts +17 -5
  10. package/dist/lib/telemetry.d.ts.map +1 -1
  11. package/dist/lib/telemetry.js +20 -65
  12. package/dist/lib/telemetry.js.map +1 -1
  13. package/dist/services/ClaudeRunner.d.ts.map +1 -1
  14. package/dist/services/ClaudeRunner.js.map +1 -1
  15. package/dist/services/GeminiRunner.d.ts.map +1 -1
  16. package/dist/services/GeminiRunner.js.map +1 -1
  17. package/dist/services/KiloRunner.d.ts.map +1 -1
  18. package/dist/services/KiloRunner.js.map +1 -1
  19. package/dist/tools/run_agents_parallel.d.ts +3 -3
  20. package/package.json +1 -12
  21. package/scripts/auto-install.mjs +0 -5
  22. package/scripts/uninstall.mjs +2 -15
  23. package/dist/bin/rabbitmq-worker.d.ts +0 -2
  24. package/dist/bin/rabbitmq-worker.d.ts.map +0 -1
  25. package/dist/bin/rabbitmq-worker.js +0 -63
  26. package/dist/bin/rabbitmq-worker.js.map +0 -1
  27. package/dist/bin/temporal-worker.d.ts +0 -2
  28. package/dist/bin/temporal-worker.d.ts.map +0 -1
  29. package/dist/bin/temporal-worker.js +0 -24
  30. package/dist/bin/temporal-worker.js.map +0 -1
  31. package/dist/lib/broker/rabbitmq.d.ts +0 -28
  32. package/dist/lib/broker/rabbitmq.d.ts.map +0 -1
  33. package/dist/lib/broker/rabbitmq.js +0 -67
  34. package/dist/lib/broker/rabbitmq.js.map +0 -1
  35. package/dist/lib/broker/rabbitmqDispatch.d.ts +0 -23
  36. package/dist/lib/broker/rabbitmqDispatch.d.ts.map +0 -1
  37. package/dist/lib/broker/rabbitmqDispatch.js +0 -77
  38. package/dist/lib/broker/rabbitmqDispatch.js.map +0 -1
  39. package/dist/lib/workflow/temporal/activities.d.ts +0 -15
  40. package/dist/lib/workflow/temporal/activities.d.ts.map +0 -1
  41. package/dist/lib/workflow/temporal/activities.js +0 -18
  42. package/dist/lib/workflow/temporal/activities.js.map +0 -1
  43. package/dist/lib/workflow/temporal/client.d.ts +0 -8
  44. package/dist/lib/workflow/temporal/client.d.ts.map +0 -1
  45. package/dist/lib/workflow/temporal/client.js +0 -48
  46. package/dist/lib/workflow/temporal/client.js.map +0 -1
  47. package/dist/lib/workflow/temporal/dispatch.d.ts +0 -13
  48. package/dist/lib/workflow/temporal/dispatch.d.ts.map +0 -1
  49. package/dist/lib/workflow/temporal/dispatch.js +0 -19
  50. package/dist/lib/workflow/temporal/dispatch.js.map +0 -1
  51. package/dist/lib/workflow/temporal/workflows.d.ts +0 -31
  52. package/dist/lib/workflow/temporal/workflows.d.ts.map +0 -1
  53. package/dist/lib/workflow/temporal/workflows.js +0 -79
  54. package/dist/lib/workflow/temporal/workflows.js.map +0 -1
  55. package/docs/ASYNC_AGENT_INTEGRATION.md +0 -311
  56. package/docs/INDEX.md +0 -149
  57. package/docs/tools.md +0 -819
package/docs/tools.md DELETED
@@ -1,819 +0,0 @@
1
- # 🛠️ Documentation Complète des Outils OverMind MCP
2
-
3
- Ce serveur MCP expose des outils d'orchestration multi-agents avec isolation de mémoire sémantique. Compatible avec **8 runners** différents : Claude Code, Gemini, Kilocode, Qwen Code, OpenClaw, Cline, OpenCode et Trae.
4
-
5
- ---
6
-
7
- ## 📖 Table des Matières
8
-
9
- - [🤖 Exécution d'Agents](#-exécution-dagents)
10
- - [🎨 Gestion des Prompts](#-gestion-des-prompts)
11
- - [🧠 Mémoire OverMind](#-mémoire-overmind)
12
- - [⚙️ Gestion des Agents](#️-gestion-des-agents)
13
- - [🔄 agent_control — Cycle de Vie](#🔄-agent_control--cycle-de-vie)
14
-
15
- ---
16
-
17
- ## 🤖 Exécution d'Agents
18
-
19
- ### `run_agent` (GÉNÉRIQUE - TOUS RUNNERS)
20
-
21
- **Description** : Exécute une commande sur un agent IA via le runner spécifié. C'est l'outil principal d'orchestration.
22
-
23
- **Runners supportés** : `claude`, `gemini`, `kilo`, `qwen`, `openclaw`, `cline`, `opencode`, `trae`
24
-
25
- **Paramètres** :
26
-
27
- - **`runner`** (string, requis) : Type de runner à utiliser
28
- - Valeurs possibles : `claude`, `gemini`, `kilo`, `qwen`, `openclaw`, `cline`, `opencode`, `trae`
29
- - **`prompt`** (string, requis) : La consigne à envoyer à l'agent
30
- - **`sessionId`** (string, optionnel) : ID de session pour continuer une conversation existante
31
- - **`agentName`** (string, optionnel) : Nom de l'agent (pour logging, monitoring et persistance mémoire)
32
- - **`autoResume`** (boolean, optionnel, défaut: `false`) : Si `true` et `agentName` fourni, reprend automatiquement la dernière conversation de cet agent
33
- - **`mode`** (enum, optionnel) : Mode spécifique pour certains runners :
34
- - **Kilo** : `code`, `architect`, `ask`, `debug`, `orchestrator`
35
- - **Cline** : `plan`, `act`
36
-
37
- **Exemple d'utilisation** :
38
-
39
- ```javascript
40
- run_agent({
41
- runner: 'claude',
42
- agentName: 'expert_python',
43
- prompt: 'Analyse ce code et corrige les bugs',
44
- autoResume: true,
45
- });
46
-
47
- run_agent({
48
- runner: 'kilo',
49
- agentName: 'architecte',
50
- mode: 'architect',
51
- prompt: 'Conçois une API REST scalable',
52
- });
53
- ```
54
-
55
- **Valeurs de retour** :
56
-
57
- - `result` : Résultat de l'exécution (texte)
58
- - `SESSION_ID` : Identifiant de session (pour reprise)
59
- - `RUNNER` : Runner utilisé
60
-
61
- ---
62
-
63
- ### `run_claude` (SPÉCIFIQUE CLAUDE CODE)
64
-
65
- **Description** : Exécute un agent via Claude Code CLI.
66
-
67
- **Paramètres** :
68
-
69
- - **`prompt`** (string, requis) : La consigne à envoyer à l'agent
70
- - **`sessionId`** (string, optionnel) : ID de session pour continuer une conversation
71
- - **`agentName`** (string, optionnel) : Nom de l'agent (pour logging et persistance)
72
- - **`autoResume`** (boolean, optionnel, défaut: `false`) : Si `true`, reprend automatiquement la dernière conversation de l'agent
73
-
74
- **Exemple** :
75
-
76
- ```javascript
77
- run_claude({
78
- agentName: 'code_reviewer',
79
- prompt: 'Review ce PR et suggère des améliorations',
80
- autoResume: true,
81
- });
82
- ```
83
-
84
- ---
85
-
86
- ### `run_gemini` (SPÉCIFIQUE GEMINI)
87
-
88
- **Description** : Exécute un agent via Gemini CLI.
89
-
90
- **Paramètres** :
91
-
92
- - **`prompt`** (string, requis) : La consigne à envoyer à l'agent
93
- - **`sessionId`** (string, optionnel) : ID de session pour continuer une conversation
94
- - **`agentName`** (string, optionnel) : Nom de l'agent
95
- - **`autoResume`** (boolean, optionnel, défaut: `false`) : Reprendre la conversation
96
-
97
- ---
98
-
99
- ### `run_kilo` (SPÉCIFIQUE KILOCODE)
100
-
101
- **Description** : Exécute un agent via Kilocode CLI avec modes avancés.
102
-
103
- **Paramètres** :
104
-
105
- - **`prompt`** (string, requis) : La consigne à envoyer à l'agent
106
- - **`mode`** (enum, optionnel) : Mode de fonctionnement
107
- - `code` : Mode code standard (défaut)
108
- - `architect` : Mode architecture logicielle
109
- - `ask` : Mode questions-réponses
110
- - `debug` : Mode débogage
111
- - `orchestrator` : Mode orchestration multi-tâches
112
- - **`sessionId`** (string, optionnel) : ID de session
113
- - **`agentName`** (string, optionnel) : Nom de l'agent
114
- - **`autoResume`** (boolean, optionnel, défaut: `false`) : Reprendre la conversation
115
-
116
- **Exemple** :
117
-
118
- ```javascript
119
- run_kilo({
120
- agentName: 'senior_architect',
121
- mode: 'architect',
122
- prompt: 'Conçois une architecture micro-services pour cette application',
123
- });
124
- ```
125
-
126
- ---
127
-
128
- ### `run_qwen` (SPÉCIFIQUE QWEN CODE)
129
-
130
- **Description** : Exécute un agent via Qwen Code CLI.
131
-
132
- **Paramètres** :
133
-
134
- - **`prompt`** (string, requis) : La consigne à envoyer à l'agent
135
- - **`sessionId`** (string, optionnel) : ID de session
136
- - **`agentName`** (string, optionnel) : Nom de l'agent
137
- - **`autoResume`** (boolean, optionnel, défaut: `false`) : Reprendre la conversation
138
-
139
- ---
140
-
141
- ### `run_openclaw` (SPÉCIFIQUE OPENCLAW)
142
-
143
- **Description** : Exécute un agent via OpenClaw CLI.
144
-
145
- **Paramètres** :
146
-
147
- - **`prompt`** (string, requis) : La consigne à envoyer à l'agent
148
- - **`sessionId`** (string, optionnel) : ID de session
149
- - **`agentName`** (string, optionnel) : Nom de l'agent
150
- - **`autoResume`** (boolean, optionnel, défaut: `false`) : Reprendre la conversation
151
-
152
- ---
153
-
154
- ### `run_cline` (SPÉCIFIQUE CLINE)
155
-
156
- **Description** : Exécute un agent via Cline CLI avec modes planification/action.
157
-
158
- **Paramètres** :
159
-
160
- - **`prompt`** (string, requis) : La consigne à envoyer à l'agent
161
- - **`mode`** (enum, optionnel) : Mode de fonctionnement
162
- - `plan` : Mode planification (stratégie)
163
- - `act` : Mode action (exécution autonome)
164
- - **`sessionId`** (string, optionnel) : ID de session
165
- - **`agentName`** (string, optionnel) : Nom de l'agent
166
- - **`autoResume`** (boolean, optionnel, défaut: `false`) : Reprendre la conversation
167
-
168
- **Exemple** :
169
-
170
- ```javascript
171
- run_cline({
172
- agentName: 'planner_dev',
173
- mode: 'plan',
174
- prompt: "Planifie l'implémentation d'un système d'auth",
175
- });
176
-
177
- run_cline({
178
- agentName: 'executor_bot',
179
- mode: 'act',
180
- prompt: 'Implémente les endpoints API définis',
181
- });
182
- ```
183
-
184
- ---
185
-
186
- ### `run_opencode` (SPÉCIFIQUE OPENCODE)
187
-
188
- **Description** : Exécute un agent via OpenCode CLI.
189
-
190
- **Paramètres** :
191
-
192
- - **`prompt`** (string, requis) : La consigne à envoyer à l'agent
193
- - **`sessionId`** (string, optionnel) : ID de session
194
- - **`agentName`** (string, optionnel) : Nom de l'agent
195
- - **`autoResume`** (boolean, optionnel, défaut: `false`) : Reprendre la conversation
196
-
197
- ---
198
-
199
- ### `run_trae` (SPÉCIFIQUE TRAE)
200
-
201
- **Description** : Exécute un agent via Trae CLI.
202
-
203
- **Paramètres** :
204
-
205
- - **`prompt`** (string, requis) : La consigne à envoyer à l'agent
206
- - **`sessionId`** (string, optionnel) : ID de session
207
- - **`agentName`** (string, optionnel) : Nom de l'agent
208
- - **`autoResume`** (boolean, optionnel, défaut: `false`) : Reprendre la conversation
209
-
210
- ---
211
-
212
- ## 🎨 Gestion des Prompts
213
-
214
- ### `create_prompt`
215
-
216
- **Description** : Crée un nouveau fichier prompt Markdown (Persona) dans `.claude/agents/`.
217
-
218
- **Paramètres** :
219
-
220
- - **`name`** (string, requis) : Nom du fichier sans extension (ex: `analyse_financiere`)
221
- - **`content`** (string, requis) : Contenu Markdown complet du prompt
222
-
223
- **Exemple** :
224
-
225
- ```javascript
226
- create_prompt({
227
- name: 'expert_crypto',
228
- content: `# Expert Cryptocurrency Analyst
229
-
230
- Tu es un expert en analyse de marchés crypto.
231
- Spécialités: DeFi, NFTs, trading algorithms.
232
- ...`,
233
- });
234
- ```
235
-
236
- **Valeur de retour** :
237
-
238
- ```
239
- ✅ Prompt 'expert_crypto' créé avec succès.
240
- 📍 /chemin/vers/.claude/agents/expert_crypto.md
241
- ```
242
-
243
- ---
244
-
245
- ### `edit_prompt`
246
-
247
- **Description** : Modifie un prompt existant en remplaçant un bloc de texte spécifique (Search & Replace).
248
-
249
- **Paramètres** :
250
-
251
- - **`name`** (string, requis) : Nom du fichier prompt à modifier (sans extension)
252
- - **`search`** (string, requis) : Le texte exact à rechercher
253
- - **`replace`** (string, requis) : Le nouveau texte de remplacement
254
-
255
- **Exemple** :
256
-
257
- ```javascript
258
- edit_prompt({
259
- name: 'expert_crypto',
260
- search: 'Spécialités: DeFi, NFTs, trading algorithms.',
261
- replace: 'Spécialités: DeFi, NFTs, trading algorithms, AI analysis.',
262
- });
263
- ```
264
-
265
- **Valeur de retour** :
266
-
267
- ```
268
- ✅ Prompt 'expert_crypto' modifié avec succès.
269
-
270
- 🔻 Avant :
271
- Spécialités: DeFi, NFTs, trading algorithms.
272
-
273
- 🔺 Après :
274
- Spécialités: DeFi, NFTs, trading algorithms, AI analysis.
275
- ```
276
-
277
- ---
278
-
279
- ## 🧠 Mémoire OverMind
280
-
281
- La mémoire OverMind permet une **isolation sémantique par agent** avec recherche vectorielle et historique des exécutions.
282
-
283
- ### `memory_store`
284
-
285
- **Description** : Mémorise durablement une connaissance, décision ou pattern dans la base de données vectorielle.
286
-
287
- **Paramètres** :
288
-
289
- - **`text`** (string, requis, min 1 caractère) : Texte ou connaissance à mémoriser
290
- - **`source`** (enum, optionnel, défaut: `user`) : Type de connaissance
291
- - `user` : Connaissance manuelle (entrée par l'utilisateur)
292
- - `agent` : Connaissance automatique (générée par un agent)
293
- - `pattern` : Pattern de workflow réutilisable
294
- - `error` : Bug connu et solution
295
- - `decision` : Choix architectural important
296
- - **`agent_name`** (string, optionnel) : Nom de l'agent (détecté automatiquement si exécuté via OverMind)
297
-
298
- **Exemple** :
299
-
300
- ```javascript
301
- memory_store({
302
- text: "Le projet utilise PostgreSQL avec l'extension pgvector pour la recherche sémantique. La configuration est dans docker-compose.yml",
303
- source: 'decision',
304
- agent_name: 'senior_dev',
305
- });
306
- ```
307
-
308
- **Valeur de retour** :
309
-
310
- ```
311
- ✅ Souvenir mémorisé [decision]
312
- ID: 550e8400-e29b-41d4-a716-446655440000
313
-
314
- "Le projet utilise PostgreSQL avec l'extension pgvector..."
315
- ```
316
-
317
- ---
318
-
319
- ### `memory_search`
320
-
321
- **Description** : Recherche hybride (sémantique + full-text) dans la mémoire OverMind.
322
-
323
- **Paramètres** :
324
-
325
- - **`query`** (string, requis) : Requête de recherche
326
- - **`limit`** (integer, optionnel, défaut: 10, min: 1, max: 50) : Nombre maximum de résultats
327
- - **`include_runs`** (boolean, optionnel, défaut: `false`) : Inclure l'historique des exécutions d'agents
328
- - **`agent_name`** (string, optionnel) : Filtrer par nom d'agent (détecté automatiquement si exécuté via OverMind)
329
-
330
- **Exemple** :
331
-
332
- ```javascript
333
- memory_search({
334
- query: 'configuration PostgreSQL pgvector',
335
- limit: 5,
336
- include_runs: false,
337
- });
338
- ```
339
-
340
- **Valeur de retour** :
341
-
342
- ```
343
- 🧠 3 résultat(s) trouvé(s) pour "configuration PostgreSQL pgvector"
344
-
345
- 1. [decision] (score: 0.892) — 2025-01-15
346
- Le projet utilise PostgreSQL avec l'extension pgvector...
347
-
348
- ---
349
-
350
- 2. [pattern] (score: 0.845) — 2025-01-10
351
- Pattern de connexion PostgreSQL avec pool...
352
-
353
- ---
354
-
355
- 3. [error] (score: 0.781) — 2025-01-08
356
- Erreur pgvector extension not found...
357
- ```
358
-
359
- ---
360
-
361
- ### `memory_runs`
362
-
363
- **Description** : Liste l'historique des exécutions d'agents enregistrées par OverMind avec statistiques.
364
-
365
- **Paramètres** :
366
-
367
- - **`runner`** (string, optionnel) : Filtrer par runner (ex: `claude`, `gemini`, `kilo`). Vide = tous les runners
368
- - **`limit`** (integer, optionnel, défaut: 20, min: 1, max: 100) : Nombre de runs à retourner
369
- - **`stats`** (boolean, optionnel, défaut: `false`) : Afficher les statistiques globales d'orchestration
370
- - **`agent_name`** (string, optionnel) : Filtrer par agent (détecté automatiquement)
371
-
372
- **Exemples** :
373
-
374
- ```javascript
375
- // Liste les derniers runs
376
- memory_runs({
377
- runner: 'claude',
378
- limit: 10,
379
- });
380
-
381
- // Affiche les statistiques
382
- memory_runs({
383
- stats: true,
384
- });
385
- ```
386
-
387
- **Valeur de retour (liste)** :
388
-
389
- ```
390
- 🕐 10 run(s) pour claude
391
-
392
- ✅ **[claude] (expert_python)** — 2025-01-15 14:30:22 — 2.3s
393
- > Analyse ce code Python
394
- > Le code utilise asyncio avec une approche producteur-consommateur...
395
-
396
- ---
397
-
398
- ❌ **[claude]** — 2025-01-15 14:25:10 — 0.8s
399
- > Bug dans la fonction de tri
400
- > TypeError: 'NoneType' object is not iterable...
401
- ```
402
-
403
- **Valeur de retour (stats)** :
404
-
405
- ```
406
- 📊 OverMind Statistics (pour l'agent expert_python)
407
-
408
- - Runs totaux : 156
409
- - Connaissances stockées : 42
410
-
411
- Par runner :
412
- • claude : 89 runs (87 ✅)
413
- • kilo : 45 runs (43 ✅)
414
- • gemini : 22 runs (20 ✅)
415
- ```
416
-
417
- ---
418
-
419
- ## ⚙️ Gestion des Agents
420
-
421
- ### `agent_control` — NOUVEAU (unifié)
422
-
423
- **Description** : Outil unifié pour contrôler le cycle de vie des agents OverMind. Remplace `get_agent_status`, `stream_agent_output`, `kill_agent`, `wait_agent`.
424
-
425
- **Paramètres** :
426
-
427
- - **`agentName`** (string, requis) : Nom unique de l'agent à contrôler
428
- - **`runner`** (enum, optionnel) : `claude`, `gemini`, `kilo`, `qwencli`, `openclaw`, `cline`, `opencode`, `hermes`
429
- - **`action`** (enum, requis) :
430
- - `status` — Lecture pure (pid, status, sessionId, outputBuffer)
431
- - `stream` — Lecture + flag isComplete
432
- - `kill` — Destruction irréversible du process tree
433
- - `wait` — Blocage async avec polling (1s interval)
434
- - **`timeoutMs`** (number, optionnel, défaut: 900000) : Timeout pour action `wait`
435
- - **`sinceTimestamp`** (number, optionnel) : Pour `stream`, ne retourner que l'output après ce timestamp
436
- - **`config`** (string, optionnel) : Chemin racine Overmind
437
-
438
- **Codes d'erreur** : `AGENT_NOT_FOUND`, `AGENT_NOT_RUNNING`, `KILL_FAILED`, `WAIT_TIMEOUT`, `ORPHANED_PROCESS`
439
- **États du process** : `running`, `done`, `failed`, `orphaned`
440
-
441
- **Documentation complète** : [`agent_control.md`](./agent_control.md)
442
-
443
- ---
444
-
445
- ### `create_agent`
446
-
447
- **Description** : Crée un nouvel agent complet (Prompt + Config) compatible avec tous les runners.
448
-
449
- **Paramètres** :
450
-
451
- - **`name`** (string, requis) : Nom unique de l'agent (ex: `sniper_analyst`, `expert_python`)
452
- - **Règle** : Lettres, chiffres, tirets (-) et underscores (\_) uniquement
453
- - Ce nom servira d'identifiant pour sa mémoire sémantique isolée
454
- - **`prompt`** (string, requis) : Le prompt système OBLIGATOIRE
455
- - Définit le persona de l'agent
456
- - Spécifie ses missions
457
- - Liste les outils MCP autorisés
458
- - Ordonne de consulter/enrichir systématiquement sa mémoire OverMind
459
- - **`runner`** (enum, optionnel, défaut: `claude`) : Type de runner
460
- - Valeurs : `claude`, `gemini`, `kilo`, `qwen`, `openclaw`, `cline`, `opencode`, `trae`
461
- - **`model`** (string, optionnel) : Modèle IA à utiliser
462
- - Exemples : `z.ai/glm-4.7`, `MiniMax-Text-01`, `deepseek-reasoner`, `moonshot-v1-32k`
463
- - Défaut : Modèle configuré dans les variables d'environnement
464
- - **`copyEnvFrom`** (string, optionnel) : Chemin vers un settings.json existant pour copier les variables d'environnement
465
- - Exemple : `.claude/settingsM.json`
466
- - **`mode`** (enum, optionnel) : Mode spécifique pour Kilo ou Cline
467
- - **Kilo** : `code`, `architect`, `ask`, `debug`, `orchestrator`
468
- - **Cline** : `plan`, `act`
469
- - **`cliPath`** (string, optionnel) : Chemin vers l'exécutable CLI
470
- - Exemple : `"cline"`, `"opencode"`, `"./trae"`
471
-
472
- **Exemples** :
473
-
474
- ```javascript
475
- // Agent simple Claude
476
- create_agent({
477
- name: 'code_reviewer',
478
- runner: 'claude',
479
- prompt: `Tu es un expert en revue de code.
480
-
481
- Ton rôle :
482
- - Analyser le code pour les bugs de sécurité
483
- - Suggérer des optimisations de performance
484
- - Vérifier les best pratiques du langage
485
-
486
- Outils MCP autorisés :
487
- - postgresql: pour requêter la base de données
488
- - memory: pour consulter ta mémoire des projets passés`,
489
- });
490
-
491
- // Agent Kilo avec mode architect
492
- create_agent({
493
- name: 'system_architect',
494
- runner: 'kilo',
495
- mode: 'architect',
496
- prompt: 'Tu es un architecte logiciel senior...',
497
- copyEnvFrom: '.claude/settingsProd.json',
498
- });
499
-
500
- // Agent Cline avec mode plan
501
- create_agent({
502
- name: 'planner',
503
- runner: 'cline',
504
- mode: 'plan',
505
- prompt: 'Tu es un planificateur de tâches...',
506
- });
507
- ```
508
-
509
- **Valeur de retour** :
510
-
511
- ````
512
- ✅ Agent 'code_reviewer' créé avec succès pour Claude Code !
513
-
514
- 📂 Fichiers créés :
515
- - Prompt : /path/to/.claude/agents/code_reviewer.md
516
- - Config : /path/to/.claude/agents/code_reviewer.json
517
-
518
- 🚀 Pour lancer cet agent avec le runner claude :
519
- ```bash
520
- # Via l'outil MCP run_agent:
521
- run_agent(runner: "claude", agentName: "code_reviewer", prompt: "votre prompt")
522
- ````
523
-
524
- 💡 Runners disponibles:
525
-
526
- - claude: Claude Code (défaut)
527
- - gemini: Gemini
528
- - kilo: Kilocode
529
- - qwen: Qwen Code
530
- - openclaw: OpenClaw
531
- - cline: Cline
532
- - opencode: OpenCode
533
- - trae: Trae
534
-
535
- ````
536
-
537
- **Erreurs possibles** :
538
- - `INVALID_NAME` : Le nom contient des caractères interdits
539
- - Utilisez uniquement lettres, chiffres, tirets et underscores
540
-
541
- ---
542
-
543
- ### `list_agents`
544
-
545
- **Description** : Liste tous les agents disponibles dans le projet.
546
-
547
- **Paramètres** :
548
- - **`details`** (boolean, optionnel, défaut: `false`) : Si `true`, affiche les détails complets
549
- - Modèle utilisé
550
- - Serveurs MCP activés
551
- - Taille du prompt
552
- - Mode spécifique (si applicable)
553
-
554
- **Exemples** :
555
-
556
- ```javascript
557
- // Liste simple
558
- list_agents({})
559
-
560
- // Liste détaillée
561
- list_agents({ details: true })
562
- ````
563
-
564
- **Valeur de retour (simple)** :
565
-
566
- ```
567
- 📋 Liste des Agents Disponibles (3) :
568
-
569
- 1. code_reviewer (Claude Code)
570
- 2. expert_crypto (Kilocode - mode: architect)
571
- 3. planner_dev (Cline - mode: plan)
572
- ```
573
-
574
- **Valeur de retour (détaillée)** :
575
-
576
- ```
577
- 📋 Liste des Agents Disponibles (3) :
578
-
579
- 1. **code_reviewer** (Claude Code)
580
- - Modèle: claude-3-5-sonnet-20241022
581
- - Serveurs MCP: postgresql, memory
582
- - Taille prompt: 2456 caractères
583
-
584
- 2. **expert_crypto** (Kilocode)
585
- - Mode: architect
586
- - Modèle: z.ai/glm-4.7
587
- - Serveurs MCP: postgresql, news
588
- - Taille prompt: 1823 caractères
589
-
590
- 3. **planner_dev** (Cline)
591
- - Mode: plan
592
- - Modèle: gpt-4
593
- - Serveurs MCP: memory
594
- - Taille prompt: 956 caractères
595
- ```
596
-
597
- ---
598
-
599
- ### `delete_agent`
600
-
601
- **Description** : Supprime définitivement un agent (fichier Prompt `.md` et Config `.json`).
602
-
603
- **Paramètres** :
604
-
605
- - **`name`** (string, requis) : Nom de l'agent à supprimer
606
-
607
- **Exemple** :
608
-
609
- ```javascript
610
- delete_agent({
611
- name: 'old_agent',
612
- });
613
- ```
614
-
615
- **Valeur de retour** (succès) :
616
-
617
- ```
618
- 🗑️ Suppression de l'agent 'old_agent'
619
-
620
- ✅ Fichiers supprimés :
621
- - old_agent.md
622
- - old_agent.json
623
- ```
624
-
625
- **Valeur de retour** (erreur) :
626
-
627
- ```
628
- ⚠️ Agent 'unknown_agent' introuvable (ni prompt, ni settings).
629
- ```
630
-
631
- **⚠️ Attention** : Cette opération est irréversible. Les fichiers sont définitivement supprimés.
632
-
633
- ---
634
-
635
- ### `update_agent_config`
636
-
637
- **Description** : Met à jour la configuration technique d'un agent existant sans modifier son prompt.
638
-
639
- **Paramètres** :
640
-
641
- - **`name`** (string, requis) : Nom de l'agent à modifier
642
- - **`model`** (string, optionnel) : Change le modèle IA
643
- - Exemples : `z.ai/glm-4.7`, `MiniMax-Text-01`, `deepseek-chat`, `moonshot-v1-128k`
644
- - **`mcpServers`** (array<string>, optionnel) : Remplace la liste des serveurs MCP activés
645
- - Exemple : `["postgresql", "news", "memory"]`
646
- - **Note** : Remplace TOUTE la liste existante
647
- - **`env`** (object<string, string>, optionnel) : Ajoute ou écrase des variables d'environnement
648
- - Exemple : `{"API_KEY": "sk-xxx", "ENDPOINT": "https://api.example.com"}`
649
-
650
- **Exemples** :
651
-
652
- ```javascript
653
- // Changer le modèle
654
- update_agent_config({
655
- name: 'expert_crypto',
656
- model: 'claude-opus-4-6',
657
- });
658
-
659
- // Mettre à jour les serveurs MCP
660
- update_agent_config({
661
- name: 'data_analyst',
662
- mcpServers: ['postgresql', 'memory', 'news'],
663
- });
664
-
665
- // Ajouter des variables d'environnement
666
- update_agent_config({
667
- name: 'api_client',
668
- env: {
669
- API_ENDPOINT: 'https://api.production.com',
670
- RATE_LIMIT: '100',
671
- },
672
- });
673
-
674
- // Tout mettre à jour en une fois
675
- update_agent_config({
676
- name: 'full_stack_agent',
677
- model: 'gpt-4',
678
- mcpServers: ['postgresql', 'memory', 'discord-server'],
679
- env: {
680
- NODE_ENV: 'production',
681
- LOG_LEVEL: 'info',
682
- },
683
- });
684
- ```
685
-
686
- **Valeur de retour** (succès) :
687
-
688
- ```
689
- ✅ Configuration de l'agent 'expert_crypto' mise à jour :
690
-
691
- - Modèle changé pour: claude-opus-4-6
692
- ```
693
-
694
- **Valeur de retour** (erreur) :
695
-
696
- ```
697
- ❌ Agent Introuvable
698
-
699
- Impossible de modifier la configuration pour 'unknown_agent' car le fichier settings est introuvable.
700
-
701
- 💡 Solution: Vérifiez le nom de l'agent avec `list_agents`.
702
- ```
703
-
704
- **Valeur de retour** (aucune modification) :
705
-
706
- ```
707
- ⚠️ Aucune modification demandée pour l'agent 'expert_crypto'.
708
- ```
709
-
710
- ---
711
-
712
- ## 🔄 Workflow Typique
713
-
714
- Voici un workflow d'utilisation typique des outils OverMind :
715
-
716
- ```javascript
717
- // 1. Créer un agent spécialisé
718
- create_agent({
719
- name: 'crypto_analyst',
720
- runner: 'claude',
721
- prompt: 'Tu es un expert en analyse de marchés cryptos...',
722
- model: 'claude-3-5-sonnet-20241022',
723
- });
724
-
725
- // 2. Mémoriser des connaissances de base
726
- memory_store({
727
- text: 'Bitcoin utilise un algorithme SHA-256 pour le minage',
728
- source: 'decision',
729
- });
730
-
731
- // 3. Lancer l'agent sur une tâche
732
- run_agent({
733
- runner: 'claude',
734
- agentName: 'crypto_analyst',
735
- prompt: 'Analyse les tendances actuelles du marché BTC',
736
- autoResume: true,
737
- });
738
-
739
- // 4. Rechercher dans la mémoire
740
- memory_search({
741
- query: 'tendances Bitcoin',
742
- limit: 5,
743
- });
744
-
745
- // 5. Consulter l'historique des exécutions
746
- memory_runs({
747
- agent_name: 'crypto_analyst',
748
- limit: 10,
749
- });
750
-
751
- // 6. Modifier la configuration si nécessaire
752
- update_agent_config({
753
- name: 'crypto_analyst',
754
- mcpServers: ['news', 'postgresql', 'memory'],
755
- });
756
- ```
757
-
758
- ---
759
-
760
- ## 📚 Notes Importantes
761
-
762
- ### Isolation de Mémoire
763
-
764
- - Chaque agent possède sa propre base de données PostgreSQL isolée
765
- - La mémoire sémantique est **privée et sécurisée** par agent
766
- - L'auto-détection de l'agent se fait via la variable d'environnement `OVERMIND_AGENT_NAME`
767
-
768
- ### Gestion des Sessions
769
-
770
- - **`sessionId`** : Pour continuer manuellement une conversation spécifique
771
- - **`autoResume`** : Pour reprendre AUTOMATIQUEMENT la dernière conversation d'un agent nommé
772
- - Les sessions sont persistantes entre les exécutions
773
-
774
- ### Modes Spéciaux
775
-
776
- - **Kilo Modes** :
777
- - `code` : Développement standard
778
- - `architect` : Architecture et design
779
- - `ask` : Questions-réponses techniques
780
- - `debug` : Chasse aux bugs
781
- - `orchestrator` : Orchestration multi-tâches
782
-
783
- - **Cline Modes** :
784
- - `plan` : Planification stratégique
785
- - `act` : Exécution autonome
786
-
787
- ### Erreurs Courantes
788
-
789
- 1. **`INVALID_AGENT`** : L'agent n'existe pas. Utilisez `create_agent` d'abord.
790
- 2. **`JSON_PARSE_ERROR`** : Le runner a retourné un JSON invalide. Vérifiez le prompt.
791
- 3. **`SEARCH_NOT_FOUND`** (edit_prompt) : Le texte à remplacer n'existe pas.
792
-
793
- ---
794
-
795
- ## 🚀 Démarrage Rapide
796
-
797
- ```javascript
798
- // Créer et exécuter votre premier agent
799
- create_agent({
800
- name: 'hello_agent',
801
- prompt: 'Tu es un assistant amical qui dit bonjour.',
802
- });
803
-
804
- run_agent({
805
- runner: 'claude',
806
- agentName: 'hello_agent',
807
- prompt: 'Dis-moi bonjour !',
808
- });
809
-
810
- // Résultat attendu
811
- // "Bonjour ! Je suis ravi de vous rencontrer. Comment puis-je vous aider aujourd'hui ?"
812
- ```
813
-
814
- ---
815
-
816
- **Version** : 1.3.6
817
- **Auteur** : DeaMoN888
818
- **License** : MIT
819
- **Repository** : [GitHub](https://github.com/DeamonDev888/overmind-mcp)