@rk0429/agentic-relay 3.8.0 → 3.10.0
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 +11 -2
- package/dist/application/spawn-agents-service.js +3 -2
- package/dist/application/spawn-agents-service.js.map +1 -1
- package/dist/core/types.d.ts +1 -0
- package/dist/domain/config.d.ts +2 -0
- package/dist/domain/config.js +12 -0
- package/dist/domain/config.js.map +1 -0
- package/dist/domain/depth.d.ts +1 -1
- package/dist/domain/depth.js +5 -6
- package/dist/domain/depth.js.map +1 -1
- package/dist/infrastructure/store/relay-store.js +13 -3
- package/dist/infrastructure/store/relay-store.js.map +1 -1
- package/dist/interfaces/mcp/relay-mcp-server.js +149 -40
- package/dist/interfaces/mcp/relay-mcp-server.js.map +1 -1
- package/package.json +4 -2
- package/scripts/benchmark-nonfunctional.mjs +184 -0
package/README.md
CHANGED
|
@@ -97,6 +97,7 @@ Routing can be customized through `.relay/config.json`:
|
|
|
97
97
|
|
|
98
98
|
```json
|
|
99
99
|
{
|
|
100
|
+
"max_depth": 5,
|
|
100
101
|
"routing": {
|
|
101
102
|
"research": "gemini",
|
|
102
103
|
"code_writing": "claude"
|
|
@@ -104,8 +105,16 @@ Routing can be customized through `.relay/config.json`:
|
|
|
104
105
|
}
|
|
105
106
|
```
|
|
106
107
|
|
|
107
|
-
|
|
108
|
-
|
|
108
|
+
`max_depth` sets the default call-depth limit when `spawn_agents.max_depth` is
|
|
109
|
+
omitted. When a `routing` entry exists for a `task_type`, it overrides the
|
|
110
|
+
built-in default for backend auto-selection.
|
|
111
|
+
|
|
112
|
+
Persisted relay files are created with private permissions (`0600`), and a
|
|
113
|
+
repeatable non-functional benchmark can be run with:
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
pnpm benchmark:nf
|
|
117
|
+
```
|
|
109
118
|
|
|
110
119
|
## Use From This Workspace
|
|
111
120
|
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { randomUUID } from "node:crypto";
|
|
2
2
|
import { DepthLimitError } from "../core/errors.js";
|
|
3
|
+
import { resolveConfiguredMaxDepth } from "../domain/config.js";
|
|
3
4
|
import { getCurrentDepth, resolveMaxDepth, validateDepth } from "../domain/depth.js";
|
|
4
5
|
import { buildCrossBackendHandoffPrompt, createCrossBackendHandoffInfo, } from "../domain/handoff.js";
|
|
5
6
|
import { canSpawnAgents } from "../domain/redelegation.js";
|
|
@@ -12,9 +13,9 @@ export class SpawnAgentsService {
|
|
|
12
13
|
async spawnAgents(input, options = {}) {
|
|
13
14
|
const env = this.dependencies.env ?? process.env;
|
|
14
15
|
const currentDepth = getCurrentDepth(env);
|
|
15
|
-
const maxDepth = resolveMaxDepth(input.max_depth, env);
|
|
16
|
-
validateDepth(currentDepth, maxDepth);
|
|
17
16
|
const relayConfig = await this.dependencies.store.readConfig();
|
|
17
|
+
const maxDepth = resolveMaxDepth(input.max_depth, env, resolveConfiguredMaxDepth(relayConfig));
|
|
18
|
+
validateDepth(currentDepth, maxDepth);
|
|
18
19
|
const routingRules = validateRoutingRules(relayConfig?.routing);
|
|
19
20
|
const installedBackends = await this.dependencies.backendRegistry.detectInstalled();
|
|
20
21
|
return Promise.all(input.agents.map((agent) => this.spawnSingleAgent({
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"spawn-agents-service.js","sourceRoot":"","sources":["../../src/application/spawn-agents-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAUzC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAM5E,MAAM,OAAO,kBAAkB;IAEV;IADnB,YACmB,YAUhB;QAVgB,iBAAY,GAAZ,YAAY,CAU5B;IACA,CAAC;IAEG,KAAK,CAAC,WAAW,CACtB,KAAuB,EACvB,UAAoC,EAAE;QAEtC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;QACjD,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,
|
|
1
|
+
{"version":3,"file":"spawn-agents-service.js","sourceRoot":"","sources":["../../src/application/spawn-agents-service.ts"],"names":[],"mappings":"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"}
|
package/dist/core/types.d.ts
CHANGED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { ValidationError } from "../core/errors.js";
|
|
2
|
+
export function resolveConfiguredMaxDepth(config) {
|
|
3
|
+
const value = config?.max_depth;
|
|
4
|
+
if (value === undefined) {
|
|
5
|
+
return undefined;
|
|
6
|
+
}
|
|
7
|
+
if (!Number.isInteger(value) || value <= 0) {
|
|
8
|
+
throw new ValidationError(`Invalid max_depth in .relay/config.json: ${value}`);
|
|
9
|
+
}
|
|
10
|
+
return value;
|
|
11
|
+
}
|
|
12
|
+
//# sourceMappingURL=config.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/domain/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,MAAM,UAAU,yBAAyB,CACvC,MAA0B;IAE1B,MAAM,KAAK,GAAG,MAAM,EAAE,SAAS,CAAC;IAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,eAAe,CAAC,4CAA4C,KAAK,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}
|
package/dist/domain/depth.d.ts
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
1
|
export declare function getCurrentDepth(env: NodeJS.ProcessEnv): number;
|
|
2
|
-
export declare function resolveMaxDepth(requestedMaxDepth: number | undefined, env: NodeJS.ProcessEnv): number;
|
|
2
|
+
export declare function resolveMaxDepth(requestedMaxDepth: number | undefined, env: NodeJS.ProcessEnv, configuredMaxDepth?: number): number;
|
|
3
3
|
export declare function validateDepth(currentDepth: number, maxDepth: number): void;
|
package/dist/domain/depth.js
CHANGED
|
@@ -11,13 +11,12 @@ export function getCurrentDepth(env) {
|
|
|
11
11
|
}
|
|
12
12
|
return value;
|
|
13
13
|
}
|
|
14
|
-
export function resolveMaxDepth(requestedMaxDepth, env) {
|
|
14
|
+
export function resolveMaxDepth(requestedMaxDepth, env, configuredMaxDepth) {
|
|
15
15
|
const inheritedRaw = env.RELAY_MAX_DEPTH;
|
|
16
|
-
const inherited = inheritedRaw
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
const
|
|
20
|
-
const effective = Math.min(requested, inherited);
|
|
16
|
+
const inherited = inheritedRaw ? Number.parseInt(inheritedRaw, 10) : undefined;
|
|
17
|
+
const configured = configuredMaxDepth ?? DEFAULT_MAX_DEPTH;
|
|
18
|
+
const requested = requestedMaxDepth ?? inherited ?? configured;
|
|
19
|
+
const effective = inherited !== undefined ? Math.min(requested, inherited) : requested;
|
|
21
20
|
if (!Number.isInteger(effective) || effective <= 0) {
|
|
22
21
|
throw new ValidationError(`Invalid max_depth: ${requestedMaxDepth}`);
|
|
23
22
|
}
|
package/dist/domain/depth.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"depth.js","sourceRoot":"","sources":["../../src/domain/depth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAErE,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B,MAAM,UAAU,eAAe,CAAC,GAAsB;IACpD,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC;IACjC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,eAAe,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,iBAAqC,EACrC,GAAsB;
|
|
1
|
+
{"version":3,"file":"depth.js","sourceRoot":"","sources":["../../src/domain/depth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAErE,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B,MAAM,UAAU,eAAe,CAAC,GAAsB;IACpD,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC;IACjC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,eAAe,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,iBAAqC,EACrC,GAAsB,EACtB,kBAA2B;IAE3B,MAAM,YAAY,GAAG,GAAG,CAAC,eAAe,CAAC;IACzC,MAAM,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,MAAM,UAAU,GAAG,kBAAkB,IAAI,iBAAiB,CAAC;IAC3D,MAAM,SAAS,GAAG,iBAAiB,IAAI,SAAS,IAAI,UAAU,CAAC;IAC/D,MAAM,SAAS,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,eAAe,CAAC,sBAAsB,iBAAiB,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,YAAoB,EAAE,QAAgB;IAClE,IAAI,YAAY,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,eAAe,CACvB,cAAc,YAAY,qCAAqC,QAAQ,GAAG,CAC3E,CAAC;IACJ,CAAC;AACH,CAAC"}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { appendFile, mkdir, readdir, readFile, rename, rm, writeFile, } from "node:fs/promises";
|
|
2
2
|
import os from "node:os";
|
|
3
3
|
import path from "node:path";
|
|
4
|
+
const PRIVATE_FILE_MODE = 0o600;
|
|
4
5
|
export class RelayStore {
|
|
5
6
|
rootDir;
|
|
6
7
|
constructor(rootDir) {
|
|
@@ -17,7 +18,10 @@ export class RelayStore {
|
|
|
17
18
|
async writeResponse(sessionId, content) {
|
|
18
19
|
await this.ensureLayout();
|
|
19
20
|
const responsePath = path.join(this.responsesDir(), `${sessionId}.md`);
|
|
20
|
-
await writeFile(responsePath, content,
|
|
21
|
+
await writeFile(responsePath, content, {
|
|
22
|
+
encoding: "utf8",
|
|
23
|
+
mode: PRIVATE_FILE_MODE,
|
|
24
|
+
});
|
|
21
25
|
return responsePath;
|
|
22
26
|
}
|
|
23
27
|
async readResponse(sessionId) {
|
|
@@ -61,7 +65,10 @@ export class RelayStore {
|
|
|
61
65
|
await this.ensureLayout();
|
|
62
66
|
const date = entry.timestamp.slice(0, 10);
|
|
63
67
|
const logPath = path.join(this.logsDir(), `${date}.jsonl`);
|
|
64
|
-
await appendFile(logPath, `${JSON.stringify(entry)}\n`,
|
|
68
|
+
await appendFile(logPath, `${JSON.stringify(entry)}\n`, {
|
|
69
|
+
encoding: "utf8",
|
|
70
|
+
mode: PRIVATE_FILE_MODE,
|
|
71
|
+
});
|
|
65
72
|
}
|
|
66
73
|
async listLogs() {
|
|
67
74
|
try {
|
|
@@ -130,7 +137,10 @@ export class RelayStore {
|
|
|
130
137
|
}
|
|
131
138
|
async function writeJsonAtomic(targetPath, value) {
|
|
132
139
|
const tempPath = path.join(os.tmpdir(), `relay-${path.basename(targetPath)}-${process.pid}-${Date.now()}.tmp`);
|
|
133
|
-
await writeFile(tempPath, `${JSON.stringify(value, null, 2)}\n`,
|
|
140
|
+
await writeFile(tempPath, `${JSON.stringify(value, null, 2)}\n`, {
|
|
141
|
+
encoding: "utf8",
|
|
142
|
+
mode: PRIVATE_FILE_MODE,
|
|
143
|
+
});
|
|
134
144
|
await rename(tempPath, targetPath);
|
|
135
145
|
await rm(tempPath, { force: true });
|
|
136
146
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"relay-store.js","sourceRoot":"","sources":["../../../src/infrastructure/store/relay-store.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,EACL,OAAO,EACP,QAAQ,EACR,MAAM,EACN,EAAE,EACF,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAQ7B,MAAM,OAAO,UAAU;IACL,OAAO,CAAS;IAEhC,YAAmB,OAAe;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEM,KAAK,CAAC,YAAY;QACvB,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,OAAe;QAC3D,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,GAAG,SAAS,KAAK,CAAC,CAAC;QACvE,MAAM,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"relay-store.js","sourceRoot":"","sources":["../../../src/infrastructure/store/relay-store.ts"],"names":[],"mappings":"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"}
|
|
@@ -2,9 +2,16 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
|
2
2
|
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
3
3
|
import { z } from "zod";
|
|
4
4
|
const agentSchema = z.object({
|
|
5
|
-
backend: z
|
|
6
|
-
|
|
7
|
-
|
|
5
|
+
backend: z
|
|
6
|
+
.enum(["claude", "codex", "gemini"])
|
|
7
|
+
.describe("Override automatic backend selection. If omitted, resolved from task_type via routing rules.")
|
|
8
|
+
.optional(),
|
|
9
|
+
prompt: z.string().min(1).describe("The instruction to send to the child agent."),
|
|
10
|
+
task_id: z
|
|
11
|
+
.string()
|
|
12
|
+
.min(1)
|
|
13
|
+
.describe("Task ID to link. The task auto-transitions ready → in_progress → review.")
|
|
14
|
+
.optional(),
|
|
8
15
|
task_type: z
|
|
9
16
|
.enum([
|
|
10
17
|
"orchestration",
|
|
@@ -14,13 +21,30 @@ const agentSchema = z.object({
|
|
|
14
21
|
"document_writing",
|
|
15
22
|
"code_review",
|
|
16
23
|
])
|
|
24
|
+
.describe("Determines the backend via routing rules: orchestration/document_writing/code_review → Claude, research/document_review/code_writing → Codex. Only orchestration can recursively call spawn_agents.")
|
|
25
|
+
.optional(),
|
|
26
|
+
session_id: z
|
|
27
|
+
.string()
|
|
28
|
+
.min(1)
|
|
29
|
+
.describe("Explicit session ID for the child agent. Auto-generated if omitted.")
|
|
30
|
+
.optional(),
|
|
31
|
+
system_prompt: z
|
|
32
|
+
.string()
|
|
33
|
+
.min(1)
|
|
34
|
+
.describe("Additional system prompt injected into the child agent alongside AGENTS.md content.")
|
|
17
35
|
.optional(),
|
|
18
|
-
session_id: z.string().min(1).optional(),
|
|
19
|
-
system_prompt: z.string().min(1).optional(),
|
|
20
36
|
});
|
|
21
37
|
const spawnAgentsInputSchema = {
|
|
22
|
-
agents: z
|
|
23
|
-
|
|
38
|
+
agents: z
|
|
39
|
+
.array(agentSchema)
|
|
40
|
+
.min(1)
|
|
41
|
+
.describe("One or more agent definitions to launch in parallel."),
|
|
42
|
+
max_depth: z
|
|
43
|
+
.number()
|
|
44
|
+
.int()
|
|
45
|
+
.positive()
|
|
46
|
+
.describe("Maximum recursive spawn depth. Defaults to .relay/config.json value (5 if unconfigured). Prevents infinite recursion.")
|
|
47
|
+
.optional(),
|
|
24
48
|
};
|
|
25
49
|
const taskStatusSchema = z.enum([
|
|
26
50
|
"backlog",
|
|
@@ -33,50 +57,108 @@ const taskStatusSchema = z.enum([
|
|
|
33
57
|
"archived",
|
|
34
58
|
]);
|
|
35
59
|
const createTaskInputSchema = {
|
|
36
|
-
title: z.string().min(1),
|
|
37
|
-
description: z.string().min(1),
|
|
38
|
-
parent_id: z
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
60
|
+
title: z.string().min(1).describe("Short, descriptive title for the task."),
|
|
61
|
+
description: z.string().min(1).describe("Detailed description of what the task entails."),
|
|
62
|
+
parent_id: z
|
|
63
|
+
.string()
|
|
64
|
+
.min(1)
|
|
65
|
+
.describe("ID of the parent task. Omit to create a root task.")
|
|
66
|
+
.optional(),
|
|
67
|
+
depends_on: z
|
|
68
|
+
.array(z.string().min(1))
|
|
69
|
+
.describe("IDs of sibling tasks (same parent) that must complete before this task can start.")
|
|
70
|
+
.optional(),
|
|
71
|
+
acceptance_criteria: z
|
|
72
|
+
.string()
|
|
73
|
+
.min(1)
|
|
74
|
+
.describe("Required for leaf tasks before they can transition to ready. Defines when the task is considered complete.")
|
|
75
|
+
.optional(),
|
|
76
|
+
actor_id: z
|
|
77
|
+
.string()
|
|
78
|
+
.min(1)
|
|
79
|
+
.describe("Override the actor identity for authorization. Usually auto-resolved from session context.")
|
|
80
|
+
.optional(),
|
|
42
81
|
};
|
|
43
82
|
const updateTaskStatusInputSchema = {
|
|
44
|
-
task_id: z.string().min(1),
|
|
45
|
-
status: taskStatusSchema,
|
|
46
|
-
comment: z
|
|
47
|
-
|
|
83
|
+
task_id: z.string().min(1).describe("ID of the task to transition."),
|
|
84
|
+
status: taskStatusSchema.describe("Target status. Valid transitions: backlog→ready, ready→in_progress, in_progress→review, review→done/in_progress, any→archived/superseded."),
|
|
85
|
+
comment: z
|
|
86
|
+
.string()
|
|
87
|
+
.min(1)
|
|
88
|
+
.describe("Required when rejecting a review (review → in_progress). Records feedback for the assigned agent.")
|
|
89
|
+
.optional(),
|
|
90
|
+
actor_id: z
|
|
91
|
+
.string()
|
|
92
|
+
.min(1)
|
|
93
|
+
.describe("Override the actor identity for authorization. Usually auto-resolved from session context.")
|
|
94
|
+
.optional(),
|
|
48
95
|
};
|
|
49
96
|
const assignAgentInputSchema = {
|
|
50
|
-
task_id: z.string().min(1),
|
|
51
|
-
agent_id: z
|
|
52
|
-
|
|
97
|
+
task_id: z.string().min(1).describe("ID of the task to assign."),
|
|
98
|
+
agent_id: z
|
|
99
|
+
.string()
|
|
100
|
+
.min(1)
|
|
101
|
+
.describe("ID of the agent to assign. The assigned agent gains permission to transition the task status."),
|
|
102
|
+
actor_id: z
|
|
103
|
+
.string()
|
|
104
|
+
.min(1)
|
|
105
|
+
.describe("Override the actor identity for authorization. Usually auto-resolved from session context.")
|
|
106
|
+
.optional(),
|
|
53
107
|
};
|
|
54
108
|
const listTasksInputSchema = {
|
|
55
|
-
parent_id: z
|
|
56
|
-
|
|
109
|
+
parent_id: z
|
|
110
|
+
.string()
|
|
111
|
+
.min(1)
|
|
112
|
+
.describe("Filter by parent task ID. Returns only direct children of the specified task.")
|
|
113
|
+
.optional(),
|
|
114
|
+
status: taskStatusSchema
|
|
115
|
+
.describe("Filter by task status. Returns only tasks matching the specified status.")
|
|
116
|
+
.optional(),
|
|
57
117
|
};
|
|
58
118
|
const getTaskInputSchema = {
|
|
59
|
-
task_id: z.string().min(1),
|
|
119
|
+
task_id: z.string().min(1).describe("ID of the task to retrieve."),
|
|
60
120
|
};
|
|
61
121
|
const updateTaskInputSchema = {
|
|
62
|
-
task_id: z.string().min(1),
|
|
63
|
-
title: z.string().min(1).optional(),
|
|
64
|
-
description: z.string().min(1).optional(),
|
|
65
|
-
acceptance_criteria: z
|
|
66
|
-
|
|
67
|
-
|
|
122
|
+
task_id: z.string().min(1).describe("ID of the task to update."),
|
|
123
|
+
title: z.string().min(1).describe("New title for the task.").optional(),
|
|
124
|
+
description: z.string().min(1).describe("New description for the task.").optional(),
|
|
125
|
+
acceptance_criteria: z
|
|
126
|
+
.string()
|
|
127
|
+
.min(1)
|
|
128
|
+
.describe("New acceptance criteria. Required for leaf tasks before transitioning to ready.")
|
|
129
|
+
.optional(),
|
|
130
|
+
depends_on: z
|
|
131
|
+
.array(z.string().min(1))
|
|
132
|
+
.describe("Replace the dependency list. All IDs must be sibling tasks sharing the same parent.")
|
|
133
|
+
.optional(),
|
|
134
|
+
actor_id: z
|
|
135
|
+
.string()
|
|
136
|
+
.min(1)
|
|
137
|
+
.describe("Override the actor identity for authorization. Usually auto-resolved from session context.")
|
|
138
|
+
.optional(),
|
|
68
139
|
};
|
|
69
140
|
const deleteTaskInputSchema = {
|
|
70
|
-
task_id: z.string().min(1),
|
|
71
|
-
actor_id: z
|
|
141
|
+
task_id: z.string().min(1).describe("ID of the task to archive."),
|
|
142
|
+
actor_id: z
|
|
143
|
+
.string()
|
|
144
|
+
.min(1)
|
|
145
|
+
.describe("Override the actor identity for authorization. Usually auto-resolved from session context.")
|
|
146
|
+
.optional(),
|
|
72
147
|
};
|
|
73
148
|
export function createRelayMcpServer(options) {
|
|
74
149
|
const server = new McpServer({
|
|
75
150
|
name: "agentic-relay",
|
|
76
|
-
version: "3.
|
|
151
|
+
version: "3.10.0",
|
|
77
152
|
});
|
|
78
153
|
if (options.allowSpawnAgents) {
|
|
79
|
-
server.tool("spawn_agents", "Launch one or more child agent CLI processes in parallel."
|
|
154
|
+
server.tool("spawn_agents", "Launch one or more child agent CLI processes in parallel. " +
|
|
155
|
+
"Use when a task decomposes into independent subtasks that benefit from parallel execution or different expertise (research, coding, review). " +
|
|
156
|
+
"Each agent runs as a separate CLI process; task_type determines the backend automatically. " +
|
|
157
|
+
"Link to a task via agents[].task_id for automatic status transitions (ready → in_progress → review). " +
|
|
158
|
+
"Do not use for simple, single-step tasks that the current agent can handle directly.", spawnAgentsInputSchema, {
|
|
159
|
+
destructiveHint: true,
|
|
160
|
+
openWorldHint: true,
|
|
161
|
+
}, async (args, extra) => {
|
|
80
162
|
const results = await options.service.spawnAgents(args, {
|
|
81
163
|
signal: extra.signal,
|
|
82
164
|
});
|
|
@@ -93,30 +175,57 @@ export function createRelayMcpServer(options) {
|
|
|
93
175
|
};
|
|
94
176
|
});
|
|
95
177
|
}
|
|
96
|
-
server.tool("create_task", "Create a task in the local task tree."
|
|
178
|
+
server.tool("create_task", "Create a task in the local task tree. " +
|
|
179
|
+
"Use parent_id to create child tasks under an existing task, or omit it for a root task. " +
|
|
180
|
+
"Leaf tasks (no children) require acceptance_criteria before they can transition to ready. " +
|
|
181
|
+
"Dependencies (depends_on) must reference sibling tasks sharing the same parent.", createTaskInputSchema, async (args, extra) => {
|
|
97
182
|
const task = await options.taskService.createTask(args, {
|
|
98
183
|
actorId: resolveActorId(extra.sessionId, args.actor_id),
|
|
99
184
|
});
|
|
100
185
|
return asJsonResult(task);
|
|
101
186
|
});
|
|
102
|
-
server.tool("update_task_status", "Transition a task to another lifecycle status."
|
|
187
|
+
server.tool("update_task_status", "Transition a task to another lifecycle status. " +
|
|
188
|
+
"Valid transitions: backlog→ready (requires deps done + acceptance_criteria for leaf), ready→in_progress (requires assigned agent), " +
|
|
189
|
+
"in_progress→review (requires all children done), review→done (parent agent approves), review→in_progress (rejection, comment required). " +
|
|
190
|
+
"Use update_task instead to change fields like title, description, or acceptance_criteria without changing status.", updateTaskStatusInputSchema, async (args, extra) => {
|
|
103
191
|
const task = await options.taskService.updateTaskStatus(args, {
|
|
104
192
|
actorId: resolveActorId(extra.sessionId, args.actor_id),
|
|
105
193
|
});
|
|
106
194
|
return asJsonResult(task);
|
|
107
195
|
});
|
|
108
|
-
server.tool("assign_agent", "Assign or reassign the owning agent for a task."
|
|
196
|
+
server.tool("assign_agent", "Assign or reassign the owning agent for a task. " +
|
|
197
|
+
"The assigned agent gains exclusive permission to transition the task through in_progress and review states. " +
|
|
198
|
+
"When using spawn_agents with agents[].task_id, assignment happens automatically. " +
|
|
199
|
+
"Use this tool for manual assignment or reassignment.", assignAgentInputSchema, async (args, extra) => asJsonResult(await options.taskService.assignAgent(args, {
|
|
109
200
|
actorId: resolveActorId(extra.sessionId, args.actor_id),
|
|
110
201
|
})));
|
|
111
|
-
server.tool("list_tasks", "List tasks, optionally filtered by parent or status."
|
|
112
|
-
|
|
113
|
-
|
|
202
|
+
server.tool("list_tasks", "List tasks, optionally filtered by parent or status. " +
|
|
203
|
+
"Returns a compact summary (no comments or timestamps). Use get_task for full details of a specific task. " +
|
|
204
|
+
"Prefer filtering by status or parent_id to reduce response size. " +
|
|
205
|
+
"Returns all non-archived tasks by default; use status filter to narrow results.", listTasksInputSchema, {
|
|
206
|
+
readOnlyHint: true,
|
|
207
|
+
}, async (args) => asJsonResult({ tasks: await options.taskService.listTasks(args) }));
|
|
208
|
+
server.tool("get_task", "Get the full detail of a single task including description, comments, and timestamps. " +
|
|
209
|
+
"Use this to review task deliverables, check feedback comments, or inspect the full task state. " +
|
|
210
|
+
"Use list_tasks instead when you need an overview of multiple tasks.", getTaskInputSchema, {
|
|
211
|
+
readOnlyHint: true,
|
|
212
|
+
}, async (args) => asJsonResult(await options.taskService.getTask(args.task_id)));
|
|
213
|
+
server.tool("update_task", "Update task fields such as title, description, acceptance criteria, or dependencies. " +
|
|
214
|
+
"Does not change the task status; use update_task_status for status transitions. " +
|
|
215
|
+
"Only the task initiator, assigned agent, or local-operator can update fields. " +
|
|
216
|
+
"Setting depends_on replaces the entire dependency list.", updateTaskInputSchema, {
|
|
217
|
+
idempotentHint: true,
|
|
218
|
+
}, async (args, extra) => {
|
|
114
219
|
const task = await options.taskService.updateTask(args, {
|
|
115
220
|
actorId: resolveActorId(extra.sessionId, args.actor_id),
|
|
116
221
|
});
|
|
117
222
|
return asJsonResult(task);
|
|
118
223
|
});
|
|
119
|
-
server.tool("delete_task", "Archive a task and all of its descendants
|
|
224
|
+
server.tool("delete_task", "Archive a task and all of its descendants by transitioning them to archived status. " +
|
|
225
|
+
"This is not a physical deletion; archived tasks remain in storage but are excluded from list_tasks results. " +
|
|
226
|
+
"Use this to clean up completed or abandoned task trees.", deleteTaskInputSchema, {
|
|
227
|
+
destructiveHint: true,
|
|
228
|
+
}, async (args, extra) => asJsonResult(await options.taskService.deleteTask(args, {
|
|
120
229
|
actorId: resolveActorId(extra.sessionId, args.actor_id),
|
|
121
230
|
})));
|
|
122
231
|
return server;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"relay-mcp-server.js","sourceRoot":"","sources":["../../../src/interfaces/mcp/relay-mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,
|
|
1
|
+
{"version":3,"file":"relay-mcp-server.js","sourceRoot":"","sources":["../../../src/interfaces/mcp/relay-mcp-server.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@rk0429/agentic-relay",
|
|
3
|
-
"version": "3.
|
|
3
|
+
"version": "3.10.0",
|
|
4
4
|
"displayName": "agentic-relay",
|
|
5
5
|
"description": "Unified MCP relay for Claude Code, Codex CLI, and Gemini CLI",
|
|
6
6
|
"type": "module",
|
|
@@ -78,7 +78,8 @@
|
|
|
78
78
|
},
|
|
79
79
|
"files": [
|
|
80
80
|
"dist",
|
|
81
|
-
"README.md"
|
|
81
|
+
"README.md",
|
|
82
|
+
"scripts"
|
|
82
83
|
],
|
|
83
84
|
"publishConfig": {
|
|
84
85
|
"access": "public"
|
|
@@ -87,6 +88,7 @@
|
|
|
87
88
|
"build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
|
|
88
89
|
"typecheck": "tsc -p tsconfig.json --noEmit",
|
|
89
90
|
"test": "vitest run",
|
|
91
|
+
"benchmark:nf": "node scripts/benchmark-nonfunctional.mjs",
|
|
90
92
|
"relay": "tsx src/bin/relay.ts",
|
|
91
93
|
"vscode:prepublish": "pnpm build",
|
|
92
94
|
"prepublishOnly": "pnpm typecheck && pnpm test && pnpm build"
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
|
|
2
|
+
import os from "node:os";
|
|
3
|
+
import path from "node:path";
|
|
4
|
+
import { performance } from "node:perf_hooks";
|
|
5
|
+
import { spawn } from "node:child_process";
|
|
6
|
+
import { fileURLToPath } from "node:url";
|
|
7
|
+
import { BackendRegistry } from "../dist/infrastructure/backends/backend-registry.js";
|
|
8
|
+
import { CliBackendExecutor } from "../dist/infrastructure/backends/cli-backend-executor.js";
|
|
9
|
+
import { ChildProcessExecutor } from "../dist/infrastructure/process/process-executor.js";
|
|
10
|
+
import { RelayStore } from "../dist/infrastructure/store/relay-store.js";
|
|
11
|
+
import { SpawnAgentsService } from "../dist/application/spawn-agents-service.js";
|
|
12
|
+
|
|
13
|
+
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
14
|
+
const projectRoot = path.resolve(__dirname, "..");
|
|
15
|
+
const nodeBinary = process.execPath;
|
|
16
|
+
const benchmarkPrompt = "benchmark prompt";
|
|
17
|
+
const sleepSeconds = "2.0";
|
|
18
|
+
const iterations = 3;
|
|
19
|
+
|
|
20
|
+
const workspace = await mkdtemp(path.join(os.tmpdir(), "agentic-relay-bench-"));
|
|
21
|
+
|
|
22
|
+
try {
|
|
23
|
+
const backendPath = await createStubBackend(workspace);
|
|
24
|
+
const pathValue = `${path.dirname(backendPath)}:${process.env.PATH ?? ""}`;
|
|
25
|
+
|
|
26
|
+
const direct = await measureAverage(async () => {
|
|
27
|
+
await runCommand({
|
|
28
|
+
command: backendPath,
|
|
29
|
+
args: ["--session-id", "direct-bench", "-p", benchmarkPrompt, "--output-format", "text"],
|
|
30
|
+
cwd: workspace,
|
|
31
|
+
env: {
|
|
32
|
+
...process.env,
|
|
33
|
+
PATH: pathValue,
|
|
34
|
+
},
|
|
35
|
+
});
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
const relay = await measureAverage(async () => {
|
|
39
|
+
await runCommand({
|
|
40
|
+
command: nodeBinary,
|
|
41
|
+
args: [path.join(projectRoot, "dist/bin/relay.js"), "claude", "-p", benchmarkPrompt],
|
|
42
|
+
cwd: workspace,
|
|
43
|
+
env: {
|
|
44
|
+
...process.env,
|
|
45
|
+
PATH: pathValue,
|
|
46
|
+
},
|
|
47
|
+
});
|
|
48
|
+
});
|
|
49
|
+
|
|
50
|
+
const single = await measureAverage(async () => {
|
|
51
|
+
const service = createSpawnAgentsBenchmarkService(workspace, backendPath);
|
|
52
|
+
await service.spawnAgents({
|
|
53
|
+
agents: [
|
|
54
|
+
{
|
|
55
|
+
backend: "claude",
|
|
56
|
+
prompt: benchmarkPrompt,
|
|
57
|
+
},
|
|
58
|
+
],
|
|
59
|
+
});
|
|
60
|
+
});
|
|
61
|
+
|
|
62
|
+
const parallel = await measureAverage(async () => {
|
|
63
|
+
const service = createSpawnAgentsBenchmarkService(workspace, backendPath);
|
|
64
|
+
await service.spawnAgents({
|
|
65
|
+
agents: Array.from({ length: 5 }, (_, index) => ({
|
|
66
|
+
backend: "claude",
|
|
67
|
+
prompt: `${benchmarkPrompt} ${index + 1}`,
|
|
68
|
+
})),
|
|
69
|
+
});
|
|
70
|
+
});
|
|
71
|
+
|
|
72
|
+
const relayOverheadPct = percentageIncrease(direct, relay);
|
|
73
|
+
const parallelOverheadPct = percentageIncrease(single, parallel);
|
|
74
|
+
|
|
75
|
+
const results = {
|
|
76
|
+
timestamp: new Date().toISOString(),
|
|
77
|
+
environment: {
|
|
78
|
+
node: process.version,
|
|
79
|
+
workspace,
|
|
80
|
+
backendDelaySeconds: Number(sleepSeconds),
|
|
81
|
+
iterations,
|
|
82
|
+
},
|
|
83
|
+
req_nf_001: {
|
|
84
|
+
direct_ms: round(direct),
|
|
85
|
+
relay_ms: round(relay),
|
|
86
|
+
overhead_pct: round(relayOverheadPct),
|
|
87
|
+
threshold_pct: 10,
|
|
88
|
+
pass: relayOverheadPct <= 10,
|
|
89
|
+
},
|
|
90
|
+
req_nf_002: {
|
|
91
|
+
single_ms: round(single),
|
|
92
|
+
parallel_five_ms: round(parallel),
|
|
93
|
+
overhead_pct: round(parallelOverheadPct),
|
|
94
|
+
threshold_pct: 20,
|
|
95
|
+
pass: parallelOverheadPct <= 20,
|
|
96
|
+
},
|
|
97
|
+
};
|
|
98
|
+
|
|
99
|
+
process.stdout.write(`${JSON.stringify(results, null, 2)}\n`);
|
|
100
|
+
} finally {
|
|
101
|
+
await rm(workspace, { recursive: true, force: true });
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
async function createStubBackend(root) {
|
|
105
|
+
const binDir = path.join(root, "bin");
|
|
106
|
+
const backendPath = path.join(binDir, "claude");
|
|
107
|
+
await mkdir(binDir, { recursive: true });
|
|
108
|
+
await writeFile(
|
|
109
|
+
backendPath,
|
|
110
|
+
[
|
|
111
|
+
"#!/bin/sh",
|
|
112
|
+
`sleep ${sleepSeconds}`,
|
|
113
|
+
"printf 'stub:%s\\n' \"$*\"",
|
|
114
|
+
].join("\n"),
|
|
115
|
+
{
|
|
116
|
+
encoding: "utf8",
|
|
117
|
+
mode: 0o755,
|
|
118
|
+
},
|
|
119
|
+
);
|
|
120
|
+
return backendPath;
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
function createSpawnAgentsBenchmarkService(root, backendPath) {
|
|
124
|
+
const backendRegistry = new BackendRegistry(undefined, {
|
|
125
|
+
claude: backendPath,
|
|
126
|
+
});
|
|
127
|
+
|
|
128
|
+
return new SpawnAgentsService({
|
|
129
|
+
backendRegistry,
|
|
130
|
+
backendExecutor: new CliBackendExecutor(
|
|
131
|
+
backendRegistry,
|
|
132
|
+
new ChildProcessExecutor(),
|
|
133
|
+
),
|
|
134
|
+
store: new RelayStore(path.join(root, ".relay")),
|
|
135
|
+
cwd: root,
|
|
136
|
+
env: {
|
|
137
|
+
...process.env,
|
|
138
|
+
PATH: `${path.dirname(backendPath)}:${process.env.PATH ?? ""}`,
|
|
139
|
+
},
|
|
140
|
+
});
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
async function measureAverage(run) {
|
|
144
|
+
const measurements = [];
|
|
145
|
+
for (let index = 0; index < iterations; index += 1) {
|
|
146
|
+
const started = performance.now();
|
|
147
|
+
await run();
|
|
148
|
+
measurements.push(performance.now() - started);
|
|
149
|
+
}
|
|
150
|
+
return measurements.reduce((sum, value) => sum + value, 0) / measurements.length;
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
function percentageIncrease(base, compared) {
|
|
154
|
+
return ((compared - base) / base) * 100;
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
function round(value) {
|
|
158
|
+
return Number(value.toFixed(2));
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
async function runCommand(options) {
|
|
162
|
+
await new Promise((resolve, reject) => {
|
|
163
|
+
const child = spawn(options.command, options.args, {
|
|
164
|
+
cwd: options.cwd,
|
|
165
|
+
env: options.env,
|
|
166
|
+
stdio: ["ignore", "pipe", "pipe"],
|
|
167
|
+
});
|
|
168
|
+
|
|
169
|
+
let stderr = "";
|
|
170
|
+
|
|
171
|
+
child.stderr.on("data", (chunk) => {
|
|
172
|
+
stderr += chunk.toString();
|
|
173
|
+
});
|
|
174
|
+
|
|
175
|
+
child.on("error", reject);
|
|
176
|
+
child.on("close", (code) => {
|
|
177
|
+
if (code === 0) {
|
|
178
|
+
resolve(undefined);
|
|
179
|
+
return;
|
|
180
|
+
}
|
|
181
|
+
reject(new Error(stderr.trim() || `Command failed: ${options.command}`));
|
|
182
|
+
});
|
|
183
|
+
});
|
|
184
|
+
}
|