@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.
Files changed (116) hide show
  1. package/README.md +242 -8
  2. package/dist/adapter.d.ts +130 -0
  3. package/dist/adapter.d.ts.map +1 -0
  4. package/dist/adapter.js +2 -0
  5. package/dist/adapter.js.map +1 -0
  6. package/dist/adapters/claude.d.ts +145 -0
  7. package/dist/adapters/claude.d.ts.map +1 -0
  8. package/dist/adapters/claude.js +537 -0
  9. package/dist/adapters/claude.js.map +1 -0
  10. package/dist/adapters/codex.d.ts +71 -0
  11. package/dist/adapters/codex.d.ts.map +1 -0
  12. package/dist/adapters/codex.js +379 -0
  13. package/dist/adapters/codex.js.map +1 -0
  14. package/dist/adapters/exec.d.ts +70 -0
  15. package/dist/adapters/exec.d.ts.map +1 -0
  16. package/dist/adapters/exec.js +161 -0
  17. package/dist/adapters/exec.js.map +1 -0
  18. package/dist/adapters/hosted.d.ts +168 -0
  19. package/dist/adapters/hosted.d.ts.map +1 -0
  20. package/dist/adapters/hosted.js +361 -0
  21. package/dist/adapters/hosted.js.map +1 -0
  22. package/dist/adapters/tools-server.d.ts +21 -0
  23. package/dist/adapters/tools-server.d.ts.map +1 -0
  24. package/dist/adapters/tools-server.js +19 -0
  25. package/dist/adapters/tools-server.js.map +1 -0
  26. package/dist/client.d.ts +9 -2
  27. package/dist/client.d.ts.map +1 -1
  28. package/dist/client.js +17 -3
  29. package/dist/client.js.map +1 -1
  30. package/dist/dispatcher.d.ts +69 -17
  31. package/dist/dispatcher.d.ts.map +1 -1
  32. package/dist/dispatcher.js +243 -17
  33. package/dist/dispatcher.js.map +1 -1
  34. package/dist/host.d.ts +1 -1
  35. package/dist/host.d.ts.map +1 -1
  36. package/dist/index.d.ts +18 -3
  37. package/dist/index.d.ts.map +1 -1
  38. package/dist/index.js +9 -1
  39. package/dist/index.js.map +1 -1
  40. package/dist/inputs.d.ts +40 -1
  41. package/dist/inputs.d.ts.map +1 -1
  42. package/dist/inputs.js +25 -2
  43. package/dist/inputs.js.map +1 -1
  44. package/dist/paths.d.ts +6 -0
  45. package/dist/paths.d.ts.map +1 -1
  46. package/dist/paths.js +19 -0
  47. package/dist/paths.js.map +1 -1
  48. package/dist/protocol.d.ts +5 -0
  49. package/dist/protocol.d.ts.map +1 -1
  50. package/dist/protocol.js +5 -0
  51. package/dist/protocol.js.map +1 -1
  52. package/dist/server.d.ts.map +1 -1
  53. package/dist/server.js +6 -1
  54. package/dist/server.js.map +1 -1
  55. package/dist/setup/claude.d.ts +53 -0
  56. package/dist/setup/claude.d.ts.map +1 -0
  57. package/dist/setup/claude.js +261 -0
  58. package/dist/setup/claude.js.map +1 -0
  59. package/dist/setup/codex.d.ts +22 -0
  60. package/dist/setup/codex.d.ts.map +1 -0
  61. package/dist/setup/codex.js +95 -0
  62. package/dist/setup/codex.js.map +1 -0
  63. package/dist/setup/files.d.ts +22 -0
  64. package/dist/setup/files.d.ts.map +1 -0
  65. package/dist/setup/files.js +86 -0
  66. package/dist/setup/files.js.map +1 -0
  67. package/dist/setup/index.d.ts +6 -0
  68. package/dist/setup/index.d.ts.map +1 -0
  69. package/dist/setup/index.js +3 -0
  70. package/dist/setup/index.js.map +1 -0
  71. package/dist/setup/setup.d.ts +52 -0
  72. package/dist/setup/setup.d.ts.map +1 -0
  73. package/dist/setup/setup.js +2 -0
  74. package/dist/setup/setup.js.map +1 -0
  75. package/dist/testing/conformance.d.ts +65 -0
  76. package/dist/testing/conformance.d.ts.map +1 -0
  77. package/dist/testing/conformance.js +217 -0
  78. package/dist/testing/conformance.js.map +1 -0
  79. package/dist/testing/fake-harnesses.d.ts +121 -0
  80. package/dist/testing/fake-harnesses.d.ts.map +1 -0
  81. package/dist/testing/fake-harnesses.js +303 -0
  82. package/dist/testing/fake-harnesses.js.map +1 -0
  83. package/dist/testing/index.d.ts +5 -0
  84. package/dist/testing/index.d.ts.map +1 -0
  85. package/dist/testing/index.js +3 -0
  86. package/dist/testing/index.js.map +1 -0
  87. package/dist/tools/caller.d.ts +39 -0
  88. package/dist/tools/caller.d.ts.map +1 -0
  89. package/dist/tools/caller.js +92 -0
  90. package/dist/tools/caller.js.map +1 -0
  91. package/dist/tools/guidance.d.ts +33 -0
  92. package/dist/tools/guidance.d.ts.map +1 -0
  93. package/dist/tools/guidance.js +92 -0
  94. package/dist/tools/guidance.js.map +1 -0
  95. package/dist/tools/index.d.ts +27 -0
  96. package/dist/tools/index.d.ts.map +1 -0
  97. package/dist/tools/index.js +24 -0
  98. package/dist/tools/index.js.map +1 -0
  99. package/dist/tools/tools.d.ts +38 -0
  100. package/dist/tools/tools.d.ts.map +1 -0
  101. package/dist/tools/tools.js +354 -0
  102. package/dist/tools/tools.js.map +1 -0
  103. package/dist/types.d.ts +3 -39
  104. package/dist/types.d.ts.map +1 -1
  105. package/dist/types.js +2 -0
  106. package/dist/types.js.map +1 -1
  107. package/dist/waiter.d.ts +36 -0
  108. package/dist/waiter.d.ts.map +1 -0
  109. package/dist/waiter.js +92 -0
  110. package/dist/waiter.js.map +1 -0
  111. package/fakes/claude.mjs +715 -0
  112. package/fakes/codex.mjs +571 -0
  113. package/fakes/lib.mjs +585 -0
  114. package/fakes/mcp.mjs +151 -0
  115. package/fakes/sandbox.mjs +84 -0
  116. 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.2.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
  }