@cogitator-ai/bridge 0.2.0 → 0.4.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 +242 -8
- package/dist/adapter.d.ts +130 -0
- package/dist/adapter.d.ts.map +1 -0
- package/dist/adapter.js +2 -0
- package/dist/adapter.js.map +1 -0
- package/dist/adapters/claude.d.ts +145 -0
- package/dist/adapters/claude.d.ts.map +1 -0
- package/dist/adapters/claude.js +537 -0
- package/dist/adapters/claude.js.map +1 -0
- package/dist/adapters/codex.d.ts +71 -0
- package/dist/adapters/codex.d.ts.map +1 -0
- package/dist/adapters/codex.js +379 -0
- package/dist/adapters/codex.js.map +1 -0
- package/dist/adapters/exec.d.ts +70 -0
- package/dist/adapters/exec.d.ts.map +1 -0
- package/dist/adapters/exec.js +161 -0
- package/dist/adapters/exec.js.map +1 -0
- package/dist/adapters/hosted.d.ts +168 -0
- package/dist/adapters/hosted.d.ts.map +1 -0
- package/dist/adapters/hosted.js +361 -0
- package/dist/adapters/hosted.js.map +1 -0
- package/dist/adapters/tools-server.d.ts +21 -0
- package/dist/adapters/tools-server.d.ts.map +1 -0
- package/dist/adapters/tools-server.js +19 -0
- package/dist/adapters/tools-server.js.map +1 -0
- package/dist/client.d.ts +9 -2
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +17 -3
- package/dist/client.js.map +1 -1
- package/dist/dispatcher.d.ts +69 -17
- package/dist/dispatcher.d.ts.map +1 -1
- package/dist/dispatcher.js +243 -17
- package/dist/dispatcher.js.map +1 -1
- package/dist/host.d.ts +1 -1
- package/dist/host.d.ts.map +1 -1
- package/dist/index.d.ts +18 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -1
- package/dist/index.js.map +1 -1
- package/dist/inputs.d.ts +40 -1
- package/dist/inputs.d.ts.map +1 -1
- package/dist/inputs.js +25 -2
- package/dist/inputs.js.map +1 -1
- package/dist/paths.d.ts +6 -0
- package/dist/paths.d.ts.map +1 -1
- package/dist/paths.js +19 -0
- package/dist/paths.js.map +1 -1
- package/dist/protocol.d.ts +5 -0
- package/dist/protocol.d.ts.map +1 -1
- package/dist/protocol.js +5 -0
- package/dist/protocol.js.map +1 -1
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +6 -1
- package/dist/server.js.map +1 -1
- package/dist/setup/claude.d.ts +53 -0
- package/dist/setup/claude.d.ts.map +1 -0
- package/dist/setup/claude.js +261 -0
- package/dist/setup/claude.js.map +1 -0
- package/dist/setup/codex.d.ts +22 -0
- package/dist/setup/codex.d.ts.map +1 -0
- package/dist/setup/codex.js +95 -0
- package/dist/setup/codex.js.map +1 -0
- package/dist/setup/files.d.ts +22 -0
- package/dist/setup/files.d.ts.map +1 -0
- package/dist/setup/files.js +86 -0
- package/dist/setup/files.js.map +1 -0
- package/dist/setup/index.d.ts +6 -0
- package/dist/setup/index.d.ts.map +1 -0
- package/dist/setup/index.js +3 -0
- package/dist/setup/index.js.map +1 -0
- package/dist/setup/setup.d.ts +52 -0
- package/dist/setup/setup.d.ts.map +1 -0
- package/dist/setup/setup.js +2 -0
- package/dist/setup/setup.js.map +1 -0
- package/dist/testing/conformance.d.ts +65 -0
- package/dist/testing/conformance.d.ts.map +1 -0
- package/dist/testing/conformance.js +217 -0
- package/dist/testing/conformance.js.map +1 -0
- package/dist/testing/fake-harnesses.d.ts +121 -0
- package/dist/testing/fake-harnesses.d.ts.map +1 -0
- package/dist/testing/fake-harnesses.js +303 -0
- package/dist/testing/fake-harnesses.js.map +1 -0
- package/dist/testing/index.d.ts +5 -0
- package/dist/testing/index.d.ts.map +1 -0
- package/dist/testing/index.js +3 -0
- package/dist/testing/index.js.map +1 -0
- package/dist/tools/caller.d.ts +39 -0
- package/dist/tools/caller.d.ts.map +1 -0
- package/dist/tools/caller.js +92 -0
- package/dist/tools/caller.js.map +1 -0
- package/dist/tools/guidance.d.ts +33 -0
- package/dist/tools/guidance.d.ts.map +1 -0
- package/dist/tools/guidance.js +92 -0
- package/dist/tools/guidance.js.map +1 -0
- package/dist/tools/index.d.ts +27 -0
- package/dist/tools/index.d.ts.map +1 -0
- package/dist/tools/index.js +24 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/tools.d.ts +38 -0
- package/dist/tools/tools.d.ts.map +1 -0
- package/dist/tools/tools.js +354 -0
- package/dist/tools/tools.js.map +1 -0
- package/dist/types.d.ts +3 -39
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +2 -0
- package/dist/types.js.map +1 -1
- package/dist/waiter.d.ts +36 -0
- package/dist/waiter.d.ts.map +1 -0
- package/dist/waiter.js +92 -0
- package/dist/waiter.js.map +1 -0
- package/fakes/claude.mjs +715 -0
- package/fakes/codex.mjs +571 -0
- package/fakes/lib.mjs +585 -0
- package/fakes/mcp.mjs +151 -0
- package/fakes/sandbox.mjs +84 -0
- package/package.json +19 -1
package/fakes/mcp.mjs
ADDED
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The MCP client of the fake harnesses: starts the stdio servers a session is configured with
|
|
3
|
+
* and calls their tools the way the real harnesses do, as far as the bridge depends on it.
|
|
4
|
+
*/
|
|
5
|
+
import { spawn } from 'node:child_process';
|
|
6
|
+
import { createInterface } from 'node:readline';
|
|
7
|
+
|
|
8
|
+
const REQUEST_TIMEOUT_MS = 15_000;
|
|
9
|
+
const PROTOCOL_VERSION = '2025-06-18';
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* @typedef {object} ServerConfig
|
|
13
|
+
* @property {string} command
|
|
14
|
+
* @property {string[]} [args]
|
|
15
|
+
* @property {Record<string, string>} [env]
|
|
16
|
+
*/
|
|
17
|
+
|
|
18
|
+
/** @typedef {{ name: string, annotations?: Record<string, unknown> }} ListedTool */
|
|
19
|
+
|
|
20
|
+
/** @typedef {{ text: string, isError: boolean }} ToolAnswer */
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* One running server. Its stderr is dropped: a server writes its diagnostics there.
|
|
24
|
+
* @param {ServerConfig} config
|
|
25
|
+
* @param {object} options
|
|
26
|
+
* @param {string} options.cwd
|
|
27
|
+
* @param {NodeJS.ProcessEnv} options.env the whole environment of the server process
|
|
28
|
+
* @param {{ name: string, title?: string, version: string }} options.clientInfo
|
|
29
|
+
*/
|
|
30
|
+
function startServer(config, { cwd, env, clientInfo }) {
|
|
31
|
+
const child = spawn(config.command, config.args ?? [], {
|
|
32
|
+
cwd,
|
|
33
|
+
env,
|
|
34
|
+
stdio: ['pipe', 'pipe', 'ignore'],
|
|
35
|
+
});
|
|
36
|
+
const waiting = new Map();
|
|
37
|
+
let nextId = 0;
|
|
38
|
+
let failure;
|
|
39
|
+
const fail = (error) => {
|
|
40
|
+
failure ??= error;
|
|
41
|
+
for (const { reject, timer } of waiting.values()) {
|
|
42
|
+
clearTimeout(timer);
|
|
43
|
+
reject(failure);
|
|
44
|
+
}
|
|
45
|
+
waiting.clear();
|
|
46
|
+
};
|
|
47
|
+
child.on('error', (error) => fail(new Error(`MCP server failed to start: ${error.message}`)));
|
|
48
|
+
child.on('exit', () => fail(new Error('MCP server exited')));
|
|
49
|
+
child.stdin.on('error', () => undefined);
|
|
50
|
+
createInterface({ input: child.stdout }).on('line', (line) => {
|
|
51
|
+
let message;
|
|
52
|
+
try {
|
|
53
|
+
message = JSON.parse(line);
|
|
54
|
+
} catch {
|
|
55
|
+
return;
|
|
56
|
+
}
|
|
57
|
+
const call = waiting.get(message.id);
|
|
58
|
+
if (!call || message.method !== undefined) return;
|
|
59
|
+
waiting.delete(message.id);
|
|
60
|
+
clearTimeout(call.timer);
|
|
61
|
+
if (message.error) call.reject(new Error(message.error.message ?? 'MCP error'));
|
|
62
|
+
else call.resolve(message.result);
|
|
63
|
+
});
|
|
64
|
+
|
|
65
|
+
const write = (message) => child.stdin.write(`${JSON.stringify(message)}\n`);
|
|
66
|
+
const request = (method, params) =>
|
|
67
|
+
new Promise((resolve, reject) => {
|
|
68
|
+
if (failure) return reject(failure);
|
|
69
|
+
const id = (nextId += 1);
|
|
70
|
+
const timer = setTimeout(() => {
|
|
71
|
+
waiting.delete(id);
|
|
72
|
+
reject(new Error(`MCP server did not answer ${method}`));
|
|
73
|
+
}, REQUEST_TIMEOUT_MS);
|
|
74
|
+
waiting.set(id, { resolve, reject, timer });
|
|
75
|
+
write({ jsonrpc: '2.0', id, method, ...(params !== undefined && { params }) });
|
|
76
|
+
});
|
|
77
|
+
|
|
78
|
+
const ready = (async () => {
|
|
79
|
+
const hello = await request('initialize', {
|
|
80
|
+
protocolVersion: PROTOCOL_VERSION,
|
|
81
|
+
capabilities: {},
|
|
82
|
+
clientInfo,
|
|
83
|
+
});
|
|
84
|
+
write({ jsonrpc: '2.0', method: 'notifications/initialized' });
|
|
85
|
+
const { tools } = await request('tools/list', {});
|
|
86
|
+
return { instructions: hello.instructions, tools };
|
|
87
|
+
})();
|
|
88
|
+
ready.catch(() => undefined);
|
|
89
|
+
|
|
90
|
+
return {
|
|
91
|
+
ready,
|
|
92
|
+
/**
|
|
93
|
+
* @param {string} tool
|
|
94
|
+
* @param {Record<string, unknown>} args
|
|
95
|
+
* @param {Record<string, unknown>} meta
|
|
96
|
+
* @returns {Promise<ToolAnswer>}
|
|
97
|
+
*/
|
|
98
|
+
async call(tool, args, meta) {
|
|
99
|
+
const result = await request('tools/call', { name: tool, arguments: args, _meta: meta });
|
|
100
|
+
const text = (result.content ?? [])
|
|
101
|
+
.filter((part) => part.type === 'text')
|
|
102
|
+
.map((part) => part.text)
|
|
103
|
+
.join('\n');
|
|
104
|
+
return { text, isError: result.isError === true };
|
|
105
|
+
},
|
|
106
|
+
close() {
|
|
107
|
+
child.stdin.end();
|
|
108
|
+
child.kill('SIGTERM');
|
|
109
|
+
},
|
|
110
|
+
};
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* The servers of one session, each started when a tool of it is first called.
|
|
115
|
+
* @param {Record<string, ServerConfig>} configs by the name the session knows the server by
|
|
116
|
+
* @param {object} options
|
|
117
|
+
* @param {string} options.cwd
|
|
118
|
+
* @param {(config: ServerConfig) => NodeJS.ProcessEnv} options.envOf
|
|
119
|
+
* @param {{ name: string, title?: string, version: string }} options.clientInfo
|
|
120
|
+
*/
|
|
121
|
+
export function toolServers(configs, { cwd, envOf, clientInfo }) {
|
|
122
|
+
const running = new Map();
|
|
123
|
+
return {
|
|
124
|
+
names: () => Object.keys(configs),
|
|
125
|
+
/** @returns {Promise<{ server: ReturnType<typeof startServer>, tools: ListedTool[], instructions?: string } | undefined>} */
|
|
126
|
+
async get(name) {
|
|
127
|
+
if (!Object.hasOwn(configs, name)) return undefined;
|
|
128
|
+
if (!running.has(name)) {
|
|
129
|
+
const config = configs[name];
|
|
130
|
+
running.set(name, startServer(config, { cwd, env: envOf(config), clientInfo }));
|
|
131
|
+
}
|
|
132
|
+
const server = running.get(name);
|
|
133
|
+
return { server, ...(await server.ready) };
|
|
134
|
+
},
|
|
135
|
+
close() {
|
|
136
|
+
for (const server of running.values()) server.close();
|
|
137
|
+
running.clear();
|
|
138
|
+
},
|
|
139
|
+
};
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
/** `K=V` pairs of a command line as an object. A pair without `=` is refused with undefined */
|
|
143
|
+
export function envPairs(pairs) {
|
|
144
|
+
const env = {};
|
|
145
|
+
for (const pair of pairs) {
|
|
146
|
+
const cut = pair.indexOf('=');
|
|
147
|
+
if (cut <= 0) return undefined;
|
|
148
|
+
env[pair.slice(0, cut)] = pair.slice(cut + 1);
|
|
149
|
+
}
|
|
150
|
+
return env;
|
|
151
|
+
}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* What the sandbox of a harness denies the commands of a session, for the Node processes among
|
|
3
|
+
* them: every connection out, unix sockets included, and every write outside the folder the
|
|
4
|
+
* session works in (any write at all when the sandbox is read-only). The fake harnesses load it
|
|
5
|
+
* into the commands they run with `--import` in NODE_OPTIONS. A server of tools is started by the harness
|
|
6
|
+
* itself and never gets it, which is the point: it lives outside the sandbox.
|
|
7
|
+
*/
|
|
8
|
+
import fs from 'node:fs';
|
|
9
|
+
import { syncBuiltinESMExports } from 'node:module';
|
|
10
|
+
import net from 'node:net';
|
|
11
|
+
import path from 'node:path';
|
|
12
|
+
|
|
13
|
+
const mode = process.env.FAKE_SANDBOX;
|
|
14
|
+
const root = process.env.FAKE_SANDBOX_ROOT;
|
|
15
|
+
|
|
16
|
+
function denied(syscall, target) {
|
|
17
|
+
const error = new Error(`${syscall} EPERM${target ? ` ${target}` : ''}`);
|
|
18
|
+
error.code = 'EPERM';
|
|
19
|
+
error.errno = -1;
|
|
20
|
+
error.syscall = syscall;
|
|
21
|
+
return error;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
function real(file) {
|
|
25
|
+
const absolute = path.resolve(String(file));
|
|
26
|
+
for (let current = absolute, rest = []; ; current = path.dirname(current)) {
|
|
27
|
+
try {
|
|
28
|
+
return path.join(fs.realpathSync.native(current), ...rest.reverse());
|
|
29
|
+
} catch {
|
|
30
|
+
if (path.dirname(current) === current) return absolute;
|
|
31
|
+
rest.push(path.basename(current));
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
function writable(file) {
|
|
37
|
+
if (mode !== 'workspace-write' || !root) return false;
|
|
38
|
+
const inner = path.relative(real(root), real(file));
|
|
39
|
+
return inner === '' || (!inner.startsWith('..') && !path.isAbsolute(inner));
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
const writes = (flags) => flags !== undefined && !/^r(?!\+)/.test(String(flags));
|
|
43
|
+
|
|
44
|
+
/** Whether a call of `name` with `args` would write to a place the sandbox keeps from it. */
|
|
45
|
+
function refuses(name, args) {
|
|
46
|
+
const [file, second] = args;
|
|
47
|
+
if (typeof file !== 'string' && !Buffer.isBuffer(file) && !(file instanceof URL)) return false;
|
|
48
|
+
if (name === 'open' && !writes(second)) return false;
|
|
49
|
+
return !writable(file instanceof URL ? file.pathname : file);
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
const GUARDED = ['writeFile', 'appendFile', 'mkdir', 'open', 'rm', 'unlink', 'rename'];
|
|
53
|
+
|
|
54
|
+
if (mode && mode !== 'danger-full-access') {
|
|
55
|
+
net.Socket.prototype.connect = function sandboxedConnect(...args) {
|
|
56
|
+
const first = Array.isArray(args[0]) ? args[0][0] : args[0];
|
|
57
|
+
const target =
|
|
58
|
+
typeof first === 'object' && first !== null
|
|
59
|
+
? (first.path ?? `${first.host ?? 'localhost'}:${first.port}`)
|
|
60
|
+
: String(first);
|
|
61
|
+
process.nextTick(() => this.destroy(denied('connect', target)));
|
|
62
|
+
return this;
|
|
63
|
+
};
|
|
64
|
+
|
|
65
|
+
for (const name of GUARDED) {
|
|
66
|
+
const sync = fs[`${name}Sync`];
|
|
67
|
+
fs[`${name}Sync`] = function sandboxedSync(...args) {
|
|
68
|
+
if (refuses(name, args)) throw denied(name, String(args[0]));
|
|
69
|
+
return sync.apply(this, args);
|
|
70
|
+
};
|
|
71
|
+
const later = fs[name];
|
|
72
|
+
fs[name] = function sandboxedCallback(...args) {
|
|
73
|
+
if (!refuses(name, args)) return later.apply(this, args);
|
|
74
|
+
const done = args.at(-1);
|
|
75
|
+
if (typeof done === 'function') process.nextTick(done, denied(name, String(args[0])));
|
|
76
|
+
};
|
|
77
|
+
const promised = fs.promises[name];
|
|
78
|
+
fs.promises[name] = function sandboxedPromise(...args) {
|
|
79
|
+
if (refuses(name, args)) return Promise.reject(denied(name, String(args[0])));
|
|
80
|
+
return promised.apply(this, args);
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
syncBuiltinESMExports();
|
|
84
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cogitator-ai/bridge",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "Agent bridge for Cogitator: Claude Code, Codex and other agents hand each other jobs, ask questions and report back, each in its own window (experimental)",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"cogitator",
|
|
@@ -22,19 +22,33 @@
|
|
|
22
22
|
"types": "./dist/index.d.ts",
|
|
23
23
|
"import": "./dist/index.js",
|
|
24
24
|
"default": "./dist/index.js"
|
|
25
|
+
},
|
|
26
|
+
"./tools": {
|
|
27
|
+
"types": "./dist/tools/index.d.ts",
|
|
28
|
+
"import": "./dist/tools/index.js",
|
|
29
|
+
"default": "./dist/tools/index.js"
|
|
30
|
+
},
|
|
31
|
+
"./testing": {
|
|
32
|
+
"types": "./dist/testing/index.d.ts",
|
|
33
|
+
"import": "./dist/testing/index.js",
|
|
34
|
+
"default": "./dist/testing/index.js"
|
|
25
35
|
}
|
|
26
36
|
},
|
|
27
37
|
"sideEffects": false,
|
|
28
38
|
"files": [
|
|
29
39
|
"dist",
|
|
40
|
+
"fakes",
|
|
30
41
|
"README.md"
|
|
31
42
|
],
|
|
32
43
|
"dependencies": {
|
|
33
44
|
"@cogitator-ai/a2a": "0.12.0",
|
|
34
45
|
"@cogitator-ai/server-shared": "0.17.0",
|
|
46
|
+
"@cogitator-ai/types": "0.89.0",
|
|
35
47
|
"zod": "^4.6.6"
|
|
36
48
|
},
|
|
37
49
|
"devDependencies": {
|
|
50
|
+
"@cogitator-ai/core": "0.78.1",
|
|
51
|
+
"@cogitator-ai/mcp": "19.11.0",
|
|
38
52
|
"@types/better-sqlite3": "^9.6.0",
|
|
39
53
|
"@types/node": "^22.20.4",
|
|
40
54
|
"better-sqlite3": "^13.0.3",
|
|
@@ -42,9 +56,13 @@
|
|
|
42
56
|
"vitest": "^5.0.3"
|
|
43
57
|
},
|
|
44
58
|
"peerDependencies": {
|
|
59
|
+
"@cogitator-ai/core": ">=0.78.1",
|
|
45
60
|
"better-sqlite3": "^11.0.0 || ^12.0.0 || ^13.0.0"
|
|
46
61
|
},
|
|
47
62
|
"peerDependenciesMeta": {
|
|
63
|
+
"@cogitator-ai/core": {
|
|
64
|
+
"optional": true
|
|
65
|
+
},
|
|
48
66
|
"better-sqlite3": {
|
|
49
67
|
"optional": true
|
|
50
68
|
}
|