overmind-mcp 2.0.0 β 2.0.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.
- package/README.md +145 -139
- package/dist/server.d.ts +40 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +104 -61
- package/dist/server.js.map +1 -1
- package/dist/services/ClaudeRunner.d.ts.map +1 -1
- package/dist/services/ClaudeRunner.js +68 -47
- package/dist/services/ClaudeRunner.js.map +1 -1
- package/docs/INDEX.md +144 -0
- package/docs/README.md +128 -0
- package/docs/api/prompt/Claude_code.md +74 -0
- package/docs/api/prompt/Kilo.md +74 -0
- package/docs/api/prompt/Kilo_Hermes.md +170 -0
- package/docs/api/prompt/Minimax4.md +96 -0
- package/docs/changelog/CHANGELOG.add.md +106 -0
- package/docs/changelog/CHANGELOG.md +339 -0
- package/docs/guides/DEPLOYMENT.md +418 -0
- package/docs/guides/SWARM_USAGE.md +444 -0
- package/docs/index.html +569 -0
- package/docs/library.html +239 -0
- package/docs/prompt.html +1212 -0
- package/docs/script.js +428 -0
- package/docs/styles.css +2816 -0
- package/docs/tools.md +794 -0
- package/package.json +26 -11
- package/scripts/docker-manager.mjs +200 -0
- package/scripts/install-dependencies.mjs +462 -0
- package/scripts/postinstall.mjs +192 -0
- package/scripts/setup-overmind-db.mjs +199 -0
- package/scripts/setup-windows.js +264 -0
- package/scripts/setup.mjs +394 -0
- package/scripts/uninstall.mjs +224 -0
- package/dist/tools/metadata.d.ts +0 -20
- package/dist/tools/metadata.d.ts.map +0 -1
- package/dist/tools/metadata.js +0 -246
- package/dist/tools/metadata.js.map +0 -1
package/README.md
CHANGED
|
@@ -1,139 +1,145 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
-
|
|
29
|
-
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
**
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
#
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
#
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
#
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
##
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
1
|
+
# OverMind-MCP
|
|
2
|
+
|
|
3
|
+
Orchestrateur universel d'agents IA multi-modèles via MCP (Model Context Protocol).
|
|
4
|
+
|
|
5
|
+
## π DΓ©marrage Rapide
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
# Installation
|
|
9
|
+
npm install -g overmind-mcp
|
|
10
|
+
|
|
11
|
+
# Setup initial (interactif)
|
|
12
|
+
overmind-setup
|
|
13
|
+
|
|
14
|
+
# Lancer un agent
|
|
15
|
+
overmind run-agent --runner claude --agent-name mon-agent --prompt "Explique ce code"
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## π Documentation
|
|
19
|
+
|
|
20
|
+
Toute la documentation est centralisΓ©e dans le dossier [`docs/`](./docs/) :
|
|
21
|
+
|
|
22
|
+
### Guides Utilisateur
|
|
23
|
+
- **[README](./docs/guides/README.md)** - Guide principal
|
|
24
|
+
- **[DEPLOYMENT](./docs/guides/DEPLOYMENT.md)** - Guide de dΓ©ploiement complet
|
|
25
|
+
- **[SWARM_USAGE](./docs/guides/SWARM_USAGE.md)** - Guide d'orchestration Swarm
|
|
26
|
+
|
|
27
|
+
### Infrastructure
|
|
28
|
+
- **[`docker-compose.yml`](./docker-compose.yml)** - Stack principale (9 services)
|
|
29
|
+
- **[`docker-compose.exporters.yml`](./docker-compose.exporters.yml)** - Exporters de mΓ©triques
|
|
30
|
+
- **[`scripts/`](./scripts/)** - Scripts d'installation et gestion
|
|
31
|
+
|
|
32
|
+
### API & RΓ©fΓ©rence
|
|
33
|
+
- **[Prompts](./docs/api/prompt/)** - Documentation des prompts système
|
|
34
|
+
- **[Tools](./docs/tools.md)** - RΓ©fΓ©rence des outils MCP
|
|
35
|
+
|
|
36
|
+
### Changelog
|
|
37
|
+
- **[CHANGELOG](./docs/changelog/CHANGELOG.md)** - Historique des versions
|
|
38
|
+
- **[CHANGELOG.add](./docs/changelog/CHANGELOG.add.md)** - Notes de version v2.0.0
|
|
39
|
+
|
|
40
|
+
## π― FonctionnalitΓ©s Principales
|
|
41
|
+
|
|
42
|
+
- **Multi-Runners** : Claude, Gemini, Kilo, Hermes, OpenClaw, Cline, OpenCode, QwenCLI
|
|
43
|
+
- **Fallback Tokens** : Rotation automatique sur quota exhausted (AUTH_FALLBACK_1/2/3)
|
|
44
|
+
- **Swarm Orchestration** : Allocation dynamique de tΓ’ches aux agents spΓ©cialisΓ©s
|
|
45
|
+
- **Long-Running Workflows** : Workflows Temporal jusqu'Γ 7 jours
|
|
46
|
+
- **ObservabilitΓ©** : OpenTelemetry, Prometheus, Grafana, Jaeger
|
|
47
|
+
- **Vector DB** : PostgreSQL + pgvector (4096D)
|
|
48
|
+
|
|
49
|
+
## π¦ Scripts NPM
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
# Build
|
|
53
|
+
npm run build
|
|
54
|
+
npm run rebuild
|
|
55
|
+
|
|
56
|
+
# QualitΓ©
|
|
57
|
+
npm run lint
|
|
58
|
+
npm run format
|
|
59
|
+
npm run check-types
|
|
60
|
+
npm run test
|
|
61
|
+
|
|
62
|
+
# Infrastructure
|
|
63
|
+
npm run deploy:infra # Docker Compose stack principale
|
|
64
|
+
npm run deploy:exporters # Exporters de mΓ©triques
|
|
65
|
+
npm run deploy:all # Tout dΓ©marrer
|
|
66
|
+
npm run deploy:logs # Logs des services
|
|
67
|
+
npm run deploy:status # Γtat des services
|
|
68
|
+
|
|
69
|
+
# Setup
|
|
70
|
+
npm run setup # Setup interactif complet
|
|
71
|
+
npm run setup:full # Setup avec toutes les dΓ©pendances
|
|
72
|
+
npm run setup:deps # Installation dΓ©pendances Docker uniquement
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
## π§ Configuration
|
|
76
|
+
|
|
77
|
+
Le fichier `.env` Γ la racine du projet contient toute la configuration :
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
# Modèles AI
|
|
81
|
+
ANTHROPIC_MODEL=claude-sonnet-4-6
|
|
82
|
+
ANTHROPIC_AUTH_TOKEN=sk-ant-...
|
|
83
|
+
AUTH_FALLBACK_1=sk-ant-...
|
|
84
|
+
AUTH_FALLBACK_2=sk-ant-...
|
|
85
|
+
|
|
86
|
+
# OverMind
|
|
87
|
+
OVERMIND_WORKSPACE=/chemin/vers/workspace
|
|
88
|
+
|
|
89
|
+
# OpenTelemetry (optionnel)
|
|
90
|
+
OTEL_ENABLED=true
|
|
91
|
+
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
## ποΈ Architecture
|
|
95
|
+
|
|
96
|
+
```
|
|
97
|
+
Workflow/
|
|
98
|
+
βββ src/
|
|
99
|
+
β βββ services/ # Runners (Claude, Gemini, Kilo, etc.)
|
|
100
|
+
β βββ tools/ # Outils MCP (run_agent, create_agent, etc.)
|
|
101
|
+
β βββ lib/ # BibliothΓ¨ques internes
|
|
102
|
+
β βββ bin/ # Binaires CLI
|
|
103
|
+
βββ docs/ # Documentation centralisΓ©e
|
|
104
|
+
βββ scripts/ # Scripts NPM (lien vers docs/infrastructure/scripts)
|
|
105
|
+
βββ dist/ # Build output
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
## π Aide
|
|
109
|
+
|
|
110
|
+
```bash
|
|
111
|
+
# Aide gΓ©nΓ©rale
|
|
112
|
+
overmind --help
|
|
113
|
+
|
|
114
|
+
# Aide sur une commande spΓ©cifique
|
|
115
|
+
overmind run-agent --help
|
|
116
|
+
|
|
117
|
+
# Lister les agents disponibles
|
|
118
|
+
overmind list-agents
|
|
119
|
+
|
|
120
|
+
# Voir la config d'un agent
|
|
121
|
+
overmind get-config --name mon-agent
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
## π€ Contribution
|
|
125
|
+
|
|
126
|
+
Ce projet utilise Changesets pour la gestion des versions :
|
|
127
|
+
|
|
128
|
+
```bash
|
|
129
|
+
# CrΓ©er un changeset
|
|
130
|
+
pnpm changeset
|
|
131
|
+
|
|
132
|
+
# Versionner (après changesets)
|
|
133
|
+
pnpm changeset version
|
|
134
|
+
|
|
135
|
+
# Publier
|
|
136
|
+
pnpm release
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
## π Licence
|
|
140
|
+
|
|
141
|
+
MIT
|
|
142
|
+
|
|
143
|
+
---
|
|
144
|
+
|
|
145
|
+
**Documentation complète :** [`docs/`](./docs/)
|
package/dist/server.d.ts
CHANGED
|
@@ -1,3 +1,43 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* OverMind-MCP Server
|
|
3
|
+
* ====================
|
|
4
|
+
*
|
|
5
|
+
* Ce fichier enregistre les 13 outils MCP du serveur Overmind.
|
|
6
|
+
*
|
|
7
|
+
* βββ ARCHITECTURE βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
8
|
+
*
|
|
9
|
+
* CHAQUE OUTIL MCP VIT DANS SON PROPRE FICHIER sous src/tools/.
|
|
10
|
+
* Cela garantit :
|
|
11
|
+
* - MaintenabilitΓ© : un outil = un fichier, pas de fichier fourre-tout
|
|
12
|
+
* - TestabilitΓ© : chaque outil peut Γͺtre importΓ© et testΓ© isolΓ©ment
|
|
13
|
+
* - LisibilitΓ© : server.ts reste un index lisible, pas 500 lignes de code
|
|
14
|
+
* - DX : retrouver un tool = grep src/tools/, pas explorer 2000 lignes
|
|
15
|
+
*
|
|
16
|
+
* Convention de nommage :
|
|
17
|
+
* src/tools/<nom_du_tool>.ts β contient le schΓ©ma Zod ET la fonction execute
|
|
18
|
+
* src/tools/run_<runner>.ts β implΓ©mentation par runner (pas des outils MCP)
|
|
19
|
+
*
|
|
20
|
+
* Ajout d'un nouvel outil :
|
|
21
|
+
* 1. CrΓ©er src/tools/<nom>.ts β exporter <nom>Schema + <nom>Function
|
|
22
|
+
* 2. L'importer dans server.ts β import { <nom> } from './tools/<nom>.js'
|
|
23
|
+
* 3. Ajouter server.addTool() β name, description, parameters, execute
|
|
24
|
+
*
|
|
25
|
+
* βββ LISTE DES 13 OUTILS βββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
26
|
+
*
|
|
27
|
+
* 1. run_agent β src/tools/run_agent.ts
|
|
28
|
+
* 2. run_agents_parallel β src/tools/run_agents_parallel.ts
|
|
29
|
+
* 3. create_agent β src/tools/create_agent.ts
|
|
30
|
+
* 4. list_agents β src/tools/manage_agents.ts
|
|
31
|
+
* 5. delete_agent β src/tools/manage_agents.ts
|
|
32
|
+
* 6. update_agent_config β src/tools/manage_agents.ts
|
|
33
|
+
* 7. create_prompt β src/tools/manage_prompts.ts
|
|
34
|
+
* 8. edit_prompt β src/tools/manage_prompts.ts
|
|
35
|
+
* 9. memory_search β src/tools/memory_search.ts
|
|
36
|
+
* 10. memory_store β src/tools/memory_store.ts
|
|
37
|
+
* 11. memory_runs β src/tools/memory_runs.ts
|
|
38
|
+
* 12. get_agent_configs β src/tools/get_agent_configs.ts
|
|
39
|
+
* 13. config_example β src/tools/config_example.ts
|
|
40
|
+
*/
|
|
1
41
|
import { FastMCP } from 'fastmcp';
|
|
2
42
|
export declare function createServer(name?: string): FastMCP<import("fastmcp").FastMCPSessionAuth>;
|
|
3
43
|
//# sourceMappingURL=server.d.ts.map
|
package/dist/server.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AA+BlC,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAuB,
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AA+BlC,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAuB,iDAwKzD"}
|
package/dist/server.js
CHANGED
|
@@ -1,3 +1,43 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* OverMind-MCP Server
|
|
3
|
+
* ====================
|
|
4
|
+
*
|
|
5
|
+
* Ce fichier enregistre les 13 outils MCP du serveur Overmind.
|
|
6
|
+
*
|
|
7
|
+
* βββ ARCHITECTURE βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
8
|
+
*
|
|
9
|
+
* CHAQUE OUTIL MCP VIT DANS SON PROPRE FICHIER sous src/tools/.
|
|
10
|
+
* Cela garantit :
|
|
11
|
+
* - MaintenabilitΓ© : un outil = un fichier, pas de fichier fourre-tout
|
|
12
|
+
* - TestabilitΓ© : chaque outil peut Γͺtre importΓ© et testΓ© isolΓ©ment
|
|
13
|
+
* - LisibilitΓ© : server.ts reste un index lisible, pas 500 lignes de code
|
|
14
|
+
* - DX : retrouver un tool = grep src/tools/, pas explorer 2000 lignes
|
|
15
|
+
*
|
|
16
|
+
* Convention de nommage :
|
|
17
|
+
* src/tools/<nom_du_tool>.ts β contient le schΓ©ma Zod ET la fonction execute
|
|
18
|
+
* src/tools/run_<runner>.ts β implΓ©mentation par runner (pas des outils MCP)
|
|
19
|
+
*
|
|
20
|
+
* Ajout d'un nouvel outil :
|
|
21
|
+
* 1. CrΓ©er src/tools/<nom>.ts β exporter <nom>Schema + <nom>Function
|
|
22
|
+
* 2. L'importer dans server.ts β import { <nom> } from './tools/<nom>.js'
|
|
23
|
+
* 3. Ajouter server.addTool() β name, description, parameters, execute
|
|
24
|
+
*
|
|
25
|
+
* βββ LISTE DES 13 OUTILS βββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
26
|
+
*
|
|
27
|
+
* 1. run_agent β src/tools/run_agent.ts
|
|
28
|
+
* 2. run_agents_parallel β src/tools/run_agents_parallel.ts
|
|
29
|
+
* 3. create_agent β src/tools/create_agent.ts
|
|
30
|
+
* 4. list_agents β src/tools/manage_agents.ts
|
|
31
|
+
* 5. delete_agent β src/tools/manage_agents.ts
|
|
32
|
+
* 6. update_agent_config β src/tools/manage_agents.ts
|
|
33
|
+
* 7. create_prompt β src/tools/manage_prompts.ts
|
|
34
|
+
* 8. edit_prompt β src/tools/manage_prompts.ts
|
|
35
|
+
* 9. memory_search β src/tools/memory_search.ts
|
|
36
|
+
* 10. memory_store β src/tools/memory_store.ts
|
|
37
|
+
* 11. memory_runs β src/tools/memory_runs.ts
|
|
38
|
+
* 12. get_agent_configs β src/tools/get_agent_configs.ts
|
|
39
|
+
* 13. config_example β src/tools/config_example.ts
|
|
40
|
+
*/
|
|
1
41
|
import { FastMCP } from 'fastmcp';
|
|
2
42
|
import { withSpan } from './lib/telemetry.js';
|
|
3
43
|
import { runAgent, runAgentSchema } from './tools/run_agent.js';
|
|
@@ -18,139 +58,142 @@ export function createServer(name = 'OverMind-MCP') {
|
|
|
18
58
|
name,
|
|
19
59
|
version: '1.0.0',
|
|
20
60
|
});
|
|
21
|
-
// βββ
|
|
61
|
+
// βββ 1. run_agent βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
22
62
|
server.addTool({
|
|
23
63
|
name: 'run_agent',
|
|
24
|
-
description: `ExΓ©cute une commande sur un agent IA via le runner spΓ©cifiΓ©.
|
|
25
|
-
|
|
26
|
-
**Runners disponibles:**
|
|
27
|
-
- claude: Claude Code (NΓ©cessite 'create_agent' au prΓ©alable)
|
|
28
|
-
- gemini: Gemini CLI
|
|
29
|
-
- kilo: Kilocode (modes: code, architect, ask, debug, orchestrator)
|
|
30
|
-
- qwencli: Qwen Code CLI (qwen -p)
|
|
31
|
-
- openclaw: OpenClaw (openclaw message send)
|
|
32
|
-
- cline: Cline (modes: plan, act)
|
|
33
|
-
- opencode: OpenCode (opencode run)
|
|
34
|
-
- hermes: Nous Hermes Agent (NΓ©cessite 'create_agent' au prΓ©alable)
|
|
35
|
-
|
|
36
|
-
**Modèles recommandés :**
|
|
37
|
-
| Fournisseur | Modèle recommandé | Usage |
|
|
38
|
-
| :--- | :--- | :--- |
|
|
39
|
-
| **Mistral** | **Devstral 2** (\`codestral-latest\`) | Expert Coding & DΓ©veloppement |
|
|
40
|
-
| **Mistral** | **Mistral Large 3** (\`mistral-large-latest\`) | Raisonnement & Architecture |
|
|
41
|
-
| **Kilo** | **step 3.5 flash** | Polyvalent (262K context) |
|
|
42
|
-
| **Kilo** | **free** | Modèle par défaut gratuit |
|
|
43
|
-
|
|
44
|
-
**Parameters:**
|
|
45
|
-
- runner: Type de runner (claude, gemini, etc.)
|
|
46
|
-
- prompt: Instruction Γ envoyer Γ l'agent
|
|
47
|
-
- agentName: Nom de l'agent (optionnel)
|
|
48
|
-
- path: RΓ©pertoire de travail (CWD). Par dΓ©faut: dossier Overmind.
|
|
49
|
-
- config: RΓ©pertoire racine de l'Overmind. Par dΓ©faut: dossier Overmind.
|
|
50
|
-
|
|
51
|
-
**Exemples:**
|
|
52
|
-
run_agent(runner: "claude", agentName: "expert_python", prompt: "Analyse ce code")
|
|
53
|
-
run_agent(runner: "kilo", agentName: "architect", mode: "architect", prompt: "ConΓ§ois une API REST", path: "./my-project")
|
|
64
|
+
description: `ExΓ©cute une commande sur un agent IA via le runner spΓ©cifiΓ©.
|
|
65
|
+
|
|
66
|
+
**Runners disponibles:**
|
|
67
|
+
- claude: Claude Code (NΓ©cessite 'create_agent' au prΓ©alable)
|
|
68
|
+
- gemini: Gemini CLI
|
|
69
|
+
- kilo: Kilocode (modes: code, architect, ask, debug, orchestrator)
|
|
70
|
+
- qwencli: Qwen Code CLI (qwen -p)
|
|
71
|
+
- openclaw: OpenClaw (openclaw message send)
|
|
72
|
+
- cline: Cline (modes: plan, act)
|
|
73
|
+
- opencode: OpenCode (opencode run)
|
|
74
|
+
- hermes: Nous Hermes Agent (NΓ©cessite 'create_agent' au prΓ©alable)
|
|
75
|
+
|
|
76
|
+
**Modèles recommandés :**
|
|
77
|
+
| Fournisseur | Modèle recommandé | Usage |
|
|
78
|
+
| :--- | :--- | :--- |
|
|
79
|
+
| **Mistral** | **Devstral 2** (\`codestral-latest\`) | Expert Coding & DΓ©veloppement |
|
|
80
|
+
| **Mistral** | **Mistral Large 3** (\`mistral-large-latest\`) | Raisonnement & Architecture |
|
|
81
|
+
| **Kilo** | **step 3.5 flash** | Polyvalent (262K context) |
|
|
82
|
+
| **Kilo** | **free** | Modèle par défaut gratuit |
|
|
83
|
+
|
|
84
|
+
**Parameters:**
|
|
85
|
+
- runner: Type de runner (claude, gemini, etc.)
|
|
86
|
+
- prompt: Instruction Γ envoyer Γ l'agent
|
|
87
|
+
- agentName: Nom de l'agent (optionnel)
|
|
88
|
+
- path: RΓ©pertoire de travail (CWD). Par dΓ©faut: dossier Overmind.
|
|
89
|
+
- config: RΓ©pertoire racine de l'Overmind. Par dΓ©faut: dossier Overmind.
|
|
90
|
+
|
|
91
|
+
**Exemples:**
|
|
92
|
+
run_agent(runner: "claude", agentName: "expert_python", prompt: "Analyse ce code")
|
|
93
|
+
run_agent(runner: "kilo", agentName: "architect", mode: "architect", prompt: "ConΓ§ois une API REST", path: "./my-project")
|
|
54
94
|
run_agent(runner: "cline", agentName: "planner", mode: "plan", prompt: "Planifie l'implΓ©mentation")`,
|
|
55
95
|
parameters: runAgentSchema,
|
|
56
96
|
execute: wrapExecute('run_agent', runAgent),
|
|
57
97
|
});
|
|
58
|
-
// βββ
|
|
98
|
+
// βββ 2. run_agents_parallel βββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
59
99
|
server.addTool({
|
|
60
100
|
name: 'run_agents_parallel',
|
|
61
|
-
description: `π Lance plusieurs agents IA EN PARALLΓLE depuis un seul appel MCP. Polyglotte (mixe runners/modΓ¨les). Retourne les rΓ©sultats consolidΓ©s une fois tous terminΓ©s.
|
|
62
|
-
|
|
63
|
-
**Cas d'usage :** Orchestration de flotte, rotation de tokens, tΓ’ches indΓ©pendantes simultanΓ©es.
|
|
64
|
-
|
|
65
|
-
**Exemple :**
|
|
66
|
-
run_agents_parallel(agents: [
|
|
67
|
-
{ taskId: "build", runner: "kilo", agentName: "mistral_1", prompt: "npm run build", path: "./project" },
|
|
68
|
-
{ taskId: "lint", runner: "kilo", agentName: "mistral_2", prompt: "npm run lint", path: "./project" },
|
|
69
|
-
{ taskId: "test", runner: "kilo", agentName: "mistral_3", prompt: "npm test", path: "./project" },
|
|
70
|
-
{ taskId: "audit", runner: "kilo", agentName: "mistral_4", prompt: "Analyse le fichier audit.md", path: "./project" },
|
|
71
|
-
])
|
|
72
|
-
|
|
73
|
-
**Options :**
|
|
74
|
-
- waitAll (dΓ©faut: true) : attend tous les agents avant de retourner.
|
|
101
|
+
description: `π Lance plusieurs agents IA EN PARALLΓLE depuis un seul appel MCP. Polyglotte (mixe runners/modΓ¨les). Retourne les rΓ©sultats consolidΓ©s une fois tous terminΓ©s.
|
|
102
|
+
|
|
103
|
+
**Cas d'usage :** Orchestration de flotte, rotation de tokens, tΓ’ches indΓ©pendantes simultanΓ©es.
|
|
104
|
+
|
|
105
|
+
**Exemple :**
|
|
106
|
+
run_agents_parallel(agents: [
|
|
107
|
+
{ taskId: "build", runner: "kilo", agentName: "mistral_1", prompt: "npm run build", path: "./project" },
|
|
108
|
+
{ taskId: "lint", runner: "kilo", agentName: "mistral_2", prompt: "npm run lint", path: "./project" },
|
|
109
|
+
{ taskId: "test", runner: "kilo", agentName: "mistral_3", prompt: "npm test", path: "./project" },
|
|
110
|
+
{ taskId: "audit", runner: "kilo", agentName: "mistral_4", prompt: "Analyse le fichier audit.md", path: "./project" },
|
|
111
|
+
])
|
|
112
|
+
|
|
113
|
+
**Options :**
|
|
114
|
+
- waitAll (dΓ©faut: true) : attend tous les agents avant de retourner.
|
|
75
115
|
- waitAll: false : retourne dès que le premier agent réussit (race mode).`,
|
|
76
116
|
parameters: runAgentsParallelSchema,
|
|
77
117
|
execute: wrapExecute('run_agents_parallel', runAgentsParallel),
|
|
78
118
|
});
|
|
79
|
-
//
|
|
119
|
+
// βββ 3. create_agent ββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
80
120
|
server.addTool({
|
|
81
121
|
name: 'create_agent',
|
|
82
|
-
description: `CrΓ©e un nouvel agent (Prompt + Config) compatible avec tous les runners.
|
|
83
|
-
|
|
84
|
-
**Runners supportΓ©s:** claude, gemini, kilo, qwencli, openclaw, cline, opencode, hermes
|
|
85
|
-
|
|
86
|
-
**Exemples:**
|
|
87
|
-
create_agent(name: "expert_python", runner: "claude", prompt: "Tu es un expert Python...")
|
|
88
|
-
create_agent(name: "architecte", runner: "kilo", mode: "architect", prompt: "Tu es un architecte logiciel...")
|
|
122
|
+
description: `CrΓ©e un nouvel agent (Prompt + Config) compatible avec tous les runners.
|
|
123
|
+
|
|
124
|
+
**Runners supportΓ©s:** claude, gemini, kilo, qwencli, openclaw, cline, opencode, hermes
|
|
125
|
+
|
|
126
|
+
**Exemples:**
|
|
127
|
+
create_agent(name: "expert_python", runner: "claude", prompt: "Tu es un expert Python...")
|
|
128
|
+
create_agent(name: "architecte", runner: "kilo", mode: "architect", prompt: "Tu es un architecte logiciel...")
|
|
89
129
|
create_agent(name: "planner", runner: "cline", mode: "plan", prompt: "Tu es un planificateur de tΓ’ches...")`,
|
|
90
130
|
parameters: createAgentSchema,
|
|
91
131
|
execute: createAgent,
|
|
92
132
|
});
|
|
93
|
-
//
|
|
133
|
+
// βββ 4. list_agents βββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
94
134
|
server.addTool({
|
|
95
135
|
name: 'list_agents',
|
|
96
136
|
description: "Liste tous les agents disponibles. Option 'details=true' pour voir la config complète.",
|
|
97
137
|
parameters: listAgentsSchema,
|
|
98
138
|
execute: listAgents,
|
|
99
139
|
});
|
|
100
|
-
//
|
|
140
|
+
// βββ 5. delete_agent βββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
101
141
|
server.addTool({
|
|
102
142
|
name: 'delete_agent',
|
|
103
143
|
description: 'Supprime dΓ©finitivement un agent (Prompt et Config)',
|
|
104
144
|
parameters: deleteAgentSchema,
|
|
105
145
|
execute: deleteAgent,
|
|
106
146
|
});
|
|
107
|
-
//
|
|
147
|
+
// βββ 6. update_agent_config ββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
108
148
|
server.addTool({
|
|
109
149
|
name: 'update_agent_config',
|
|
110
150
|
description: "Modifie la configuration technique d'un agent (Runner, Modèle, Serveurs MCP, Variables d'environnement) OU réécrit entièrement l'un des 4 fichiers (prompt, settings, mcp, skill)",
|
|
111
151
|
parameters: updateAgentConfigSchema,
|
|
112
152
|
execute: updateAgentConfig,
|
|
113
153
|
});
|
|
114
|
-
// βββ
|
|
115
|
-
// Outil : CrΓ©er un prompt seul
|
|
154
|
+
// βββ 7. create_prompt βββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
116
155
|
server.addTool({
|
|
117
156
|
name: 'create_prompt',
|
|
118
157
|
description: 'CrΓ©e ou Γ©crase un fichier prompt Markdown (Persona)',
|
|
119
158
|
parameters: createPromptSchema,
|
|
120
159
|
execute: createPrompt,
|
|
121
160
|
});
|
|
122
|
-
//
|
|
161
|
+
// βββ 8. edit_prompt βββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
123
162
|
server.addTool({
|
|
124
163
|
name: 'edit_prompt',
|
|
125
164
|
description: 'Modifie un prompt existant en remplaΓ§ant un bloc de texte spΓ©cifique',
|
|
126
165
|
parameters: editPromptSchema,
|
|
127
166
|
execute: editPrompt,
|
|
128
167
|
});
|
|
129
|
-
// βββ
|
|
168
|
+
// βββ 9. memory_search ββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
130
169
|
server.addTool({
|
|
131
170
|
name: 'memory_search',
|
|
132
171
|
description: 'Recherche sΓ©mantique + full-text dans la mΓ©moire OverMind (connaissances + historique)',
|
|
133
172
|
parameters: memorySearchSchema,
|
|
134
173
|
execute: memorySearchTool,
|
|
135
174
|
});
|
|
175
|
+
// βββ 10. memory_store βββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
136
176
|
server.addTool({
|
|
137
177
|
name: 'memory_store',
|
|
138
178
|
description: "MΓ©morise durablement une connaissance, dΓ©cision ou pattern d'orchestration",
|
|
139
179
|
parameters: memoryStoreSchema,
|
|
140
180
|
execute: memoryStoreTool,
|
|
141
181
|
});
|
|
182
|
+
// βββ 11. memory_runs βββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
142
183
|
server.addTool({
|
|
143
184
|
name: 'memory_runs',
|
|
144
185
|
description: "Liste l'historique des runs d'agents enregistrΓ©s par OverMind (avec stats optionnelles)",
|
|
145
186
|
parameters: memoryRunsSchema,
|
|
146
187
|
execute: memoryRunsTool,
|
|
147
188
|
});
|
|
189
|
+
// βββ 12. get_agent_configs βββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
148
190
|
server.addTool({
|
|
149
191
|
name: 'get_agent_configs',
|
|
150
192
|
description: "Affiche les 4 fichiers de configuration d'un agent (prompt.md, .mcp.json, settings.json, skill.md)",
|
|
151
193
|
parameters: getAgentConfigsSchema,
|
|
152
194
|
execute: getAgentConfigs,
|
|
153
195
|
});
|
|
196
|
+
// βββ 13. config_example βββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
154
197
|
server.addTool({
|
|
155
198
|
name: 'config_example',
|
|
156
199
|
description: 'Fournit des exemples de configuration settings.json pour diffΓ©rents LLM (GLM, MiniMax, OpenRouter).',
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAI/E,SAAS,WAAW,CAAC,QAAgB,EAAE,EAAe;IACpD,OAAO,CAAC,GAAG,IAA6B,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,cAAc;IACxD,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC;QACzB,IAAI;QACJ,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ClaudeRunner.d.ts","sourceRoot":"","sources":["../../src/services/ClaudeRunner.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"ClaudeRunner.d.ts","sourceRoot":"","sources":["../../src/services/ClaudeRunner.ts"],"names":[],"mappings":"AAuDA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAAS;;IAOpB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAqjBlE"}
|