agent-orchestration 0.5.0 → 0.5.1
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 +51 -59
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/src/index.ts +1 -1
package/README.md
CHANGED
|
@@ -41,28 +41,10 @@ Works with any AI coding agent that supports MCP or [AGENTS.md](https://agents.m
|
|
|
41
41
|
- **Devin**
|
|
42
42
|
- And many more!
|
|
43
43
|
|
|
44
|
-
## Installation
|
|
45
|
-
|
|
46
|
-
### Prerequisites
|
|
47
|
-
|
|
48
|
-
- Node.js 18 or higher
|
|
49
|
-
- npm
|
|
50
|
-
|
|
51
|
-
### Install
|
|
52
|
-
|
|
53
|
-
```bash
|
|
54
|
-
# Clone or navigate to the project
|
|
55
|
-
cd agent-orchestration
|
|
56
|
-
|
|
57
|
-
# Install dependencies
|
|
58
|
-
npm install
|
|
59
|
-
|
|
60
|
-
# Build the project
|
|
61
|
-
npm run build
|
|
62
|
-
```
|
|
63
|
-
|
|
64
44
|
## Quick Start
|
|
65
45
|
|
|
46
|
+
No installation required! Just use `npx`:
|
|
47
|
+
|
|
66
48
|
### For Any IDE/CLI (AGENTS.md)
|
|
67
49
|
|
|
68
50
|
```bash
|
|
@@ -96,9 +78,7 @@ npx agent-orchestration serve # Run the MCP server
|
|
|
96
78
|
npx agent-orchestration help # Show help
|
|
97
79
|
```
|
|
98
80
|
|
|
99
|
-
##
|
|
100
|
-
|
|
101
|
-
### 1. Configure Your IDE
|
|
81
|
+
## MCP Server Setup
|
|
102
82
|
|
|
103
83
|
Add to your MCP configuration (e.g., `~/.cursor/mcp.json` for Cursor):
|
|
104
84
|
|
|
@@ -118,7 +98,7 @@ Add to your MCP configuration (e.g., `~/.cursor/mcp.json` for Cursor):
|
|
|
118
98
|
|
|
119
99
|
The server automatically uses the current working directory as the project root.
|
|
120
100
|
|
|
121
|
-
###
|
|
101
|
+
### Start Your Session
|
|
122
102
|
|
|
123
103
|
Use the `bootstrap` tool to start:
|
|
124
104
|
|
|
@@ -176,37 +156,6 @@ This registers you, shows current focus, pending tasks, and recent decisions.
|
|
|
176
156
|
| `lock_check` | Check if a resource is locked |
|
|
177
157
|
| `coordination_status` | Get overall system status |
|
|
178
158
|
|
|
179
|
-
## Architecture
|
|
180
|
-
|
|
181
|
-
```
|
|
182
|
-
┌─────────────────────────────────────────────────────────────┐
|
|
183
|
-
│ IDE / CLI Tool │
|
|
184
|
-
├─────────────┬─────────────┬─────────────┬─────────────┬─────┤
|
|
185
|
-
│ Main Agent │ Sub-Agent 1 │ Sub-Agent 2 │ Sub-Agent 3 │ ... │
|
|
186
|
-
└──────┬──────┴──────┬──────┴──────┬──────┴──────┬──────┴─────┘
|
|
187
|
-
│ │ │ │
|
|
188
|
-
└─────────────┴──────┬──────┴─────────────┘
|
|
189
|
-
│
|
|
190
|
-
┌───────▼───────┐
|
|
191
|
-
│ MCP Server │
|
|
192
|
-
│ (TypeScript) │
|
|
193
|
-
└───────┬───────┘
|
|
194
|
-
│
|
|
195
|
-
┌─────────────┼─────────────┐
|
|
196
|
-
│ │ │
|
|
197
|
-
┌───────▼───┐ ┌───────▼───┐ ┌───────▼───┐
|
|
198
|
-
│ Agents │ │ Tasks │ │ Memory │
|
|
199
|
-
│ Registry │ │ Queue │ │ Store │
|
|
200
|
-
└───────────┘ └───────────┘ └───────────┘
|
|
201
|
-
│ │ │
|
|
202
|
-
└─────────────┼─────────────┘
|
|
203
|
-
│
|
|
204
|
-
┌───────▼───────┐
|
|
205
|
-
│ SQLite │
|
|
206
|
-
│ (per-project)│
|
|
207
|
-
└───────────────┘
|
|
208
|
-
```
|
|
209
|
-
|
|
210
159
|
## Recommended Workflow
|
|
211
160
|
|
|
212
161
|
### Main Orchestrator Agent
|
|
@@ -252,11 +201,42 @@ Use these namespaces for organization:
|
|
|
252
201
|
| `MCP_ORCH_AGENT_ROLE` | Default agent role | `sub` |
|
|
253
202
|
| `MCP_ORCH_CAPABILITIES` | Comma-separated capabilities | `code` |
|
|
254
203
|
|
|
204
|
+
## Architecture
|
|
205
|
+
|
|
206
|
+
```
|
|
207
|
+
┌─────────────────────────────────────────────────────────────┐
|
|
208
|
+
│ IDE / CLI Tool │
|
|
209
|
+
├─────────────┬─────────────┬─────────────┬─────────────┬─────┤
|
|
210
|
+
│ Main Agent │ Sub-Agent 1 │ Sub-Agent 2 │ Sub-Agent 3 │ ... │
|
|
211
|
+
└──────┬──────┴──────┬──────┴──────┬──────┴──────┬──────┴─────┘
|
|
212
|
+
│ │ │ │
|
|
213
|
+
└─────────────┴──────┬──────┴─────────────┘
|
|
214
|
+
│
|
|
215
|
+
┌───────▼───────┐
|
|
216
|
+
│ MCP Server │
|
|
217
|
+
│ (TypeScript) │
|
|
218
|
+
└───────┬───────┘
|
|
219
|
+
│
|
|
220
|
+
┌─────────────┼─────────────┐
|
|
221
|
+
│ │ │
|
|
222
|
+
┌───────▼───┐ ┌───────▼───┐ ┌───────▼───┐
|
|
223
|
+
│ Agents │ │ Tasks │ │ Memory │
|
|
224
|
+
│ Registry │ │ Queue │ │ Store │
|
|
225
|
+
└───────────┘ └───────────┘ └───────────┘
|
|
226
|
+
│ │ │
|
|
227
|
+
└─────────────┼─────────────┘
|
|
228
|
+
│
|
|
229
|
+
┌───────▼───────┐
|
|
230
|
+
│ SQLite │
|
|
231
|
+
│ (per-project)│
|
|
232
|
+
└───────────────┘
|
|
233
|
+
```
|
|
234
|
+
|
|
255
235
|
## AGENTS.md
|
|
256
236
|
|
|
257
237
|
This project follows the [AGENTS.md](https://agents.md/) format - a simple, open format for guiding AI coding agents used by over 60k open-source projects.
|
|
258
238
|
|
|
259
|
-
When you run `agent-orchestration init`, it creates an `AGENTS.md` file that works with:
|
|
239
|
+
When you run `npx agent-orchestration init`, it creates an `AGENTS.md` file that works with:
|
|
260
240
|
- OpenAI Codex
|
|
261
241
|
- Google Jules
|
|
262
242
|
- Cursor
|
|
@@ -270,8 +250,7 @@ When you run `agent-orchestration init`, it creates an `AGENTS.md` file that wor
|
|
|
270
250
|
### Server won't start
|
|
271
251
|
|
|
272
252
|
1. Make sure Node.js 18+ is installed: `node --version`
|
|
273
|
-
2.
|
|
274
|
-
3. Check the path in your MCP config is correct
|
|
253
|
+
2. Check the path in your MCP config is correct
|
|
275
254
|
|
|
276
255
|
### Database errors
|
|
277
256
|
|
|
@@ -291,11 +270,24 @@ It will be recreated on next server start.
|
|
|
291
270
|
|
|
292
271
|
## Development
|
|
293
272
|
|
|
273
|
+
For contributors and local development:
|
|
274
|
+
|
|
275
|
+
### Prerequisites
|
|
276
|
+
|
|
277
|
+
- Node.js 18 or higher
|
|
278
|
+
- npm
|
|
279
|
+
|
|
280
|
+
### Setup
|
|
281
|
+
|
|
294
282
|
```bash
|
|
283
|
+
# Clone the repository
|
|
284
|
+
git clone https://github.com/madebyaris/agent-orchestration.git
|
|
285
|
+
cd agent-orchestration
|
|
286
|
+
|
|
295
287
|
# Install dependencies
|
|
296
288
|
npm install
|
|
297
289
|
|
|
298
|
-
# Build
|
|
290
|
+
# Build the project
|
|
299
291
|
npm run build
|
|
300
292
|
|
|
301
293
|
# Watch mode (rebuild on changes)
|
package/dist/index.js
CHANGED
|
@@ -12,7 +12,7 @@ import { registerAgentTools, registerMemoryTools, registerTaskTools, registerCoo
|
|
|
12
12
|
// Create server instance
|
|
13
13
|
const server = new McpServer({
|
|
14
14
|
name: 'agent-orchestration',
|
|
15
|
-
version: '0.5.
|
|
15
|
+
version: '0.5.1',
|
|
16
16
|
});
|
|
17
17
|
// Register all tools
|
|
18
18
|
registerAgentTools(server);
|
package/package.json
CHANGED