@crossgen-ai/praxis-connectors 0.1.2

package/test/helpers/fake-mcp-stdio.js

@@ -0,0 +1,111 @@
+// Hermetic stdio MCP server, written to disk as a standalone node script so
+// the engine spawns it exactly like any real stdio connector. Speaks
+// ndjson JSON-RPC: initialize / tools/list / tools/call, and (on demand)
+// fires a server-initiated elicitation/create so the decline path is
+// provable offline.
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+/**
+ * @param {string} dir   where to write the script
+ * @param {object} [opts]
+ * @param {boolean} [opts.elicitOnCall]  ask_user elicits before answering
+ * @param {string} [opts.captureEnvTo]   file path: the child dumps its env
+ *        there on boot (proves the secret-env filter end to end)
+ * @returns {string} script path — spawn with process.execPath
+ */
+function writeFakeMcpStdio(dir, { elicitOnCall = false, captureEnvTo = '' } = {}) {
+  const script = path.join(dir, 'fake-mcp-stdio.js');
+  fs.writeFileSync(script, `#!/usr/bin/env node
+'use strict';
+const fs = require('fs');
+${captureEnvTo ? `fs.writeFileSync(${JSON.stringify(captureEnvTo)}, JSON.stringify(Object.keys(process.env)));` : ''}
+const ELICIT = ${JSON.stringify(Boolean(elicitOnCall))};
+let nextId = 1000;
+const pendingElicits = new Map(); // our request id → the tools/call to finish
+
+const TOOLS = [
+  { name: 'add', description: 'Add two numbers', inputSchema: {
+      type: 'object',
+      properties: { a: { type: 'number' }, b: { type: 'number' } },
+      required: ['a', 'b'] } },
+  { name: 'ask_user', description: 'Needs a human answer', inputSchema: {
+      type: 'object', properties: {} } },
+];
+
+function send(msg) { process.stdout.write(JSON.stringify(msg) + '\\n'); }
+function reply(id, result) { send({ jsonrpc: '2.0', id, result }); }
+function rpcError(id, code, message) { send({ jsonrpc: '2.0', id, error: { code, message } }); }
+
+let buf = '';
+process.stdin.on('data', (d) => {
+  buf += d;
+  let nl;
+  while ((nl = buf.indexOf('\\n')) !== -1) {
+    const line = buf.slice(0, nl).trim();
+    buf = buf.slice(nl + 1);
+    if (!line) continue;
+    let msg;
+    try { msg = JSON.parse(line); } catch { continue; }
+    handle(msg);
+  }
+});
+
+function handle(msg) {
+  // A response to one of OUR requests (the elicitation round-trip).
+  if (msg.id !== undefined && msg.method === undefined) {
+    const pending = pendingElicits.get(msg.id);
+    if (pending) {
+      pendingElicits.delete(msg.id);
+      const action = msg.result?.action || 'decline';
+      reply(pending.callId, {
+        content: [{ type: 'text', text: 'user said: ' + action }],
+        isError: action !== 'accept',
+      });
+    }
+    return;
+  }
+  if (msg.id === undefined) return; // notifications need no answer
+
+  switch (msg.method) {
+    case 'initialize':
+      return reply(msg.id, {
+        protocolVersion: (msg.params && msg.params.protocolVersion) || '2025-06-18',
+        capabilities: { tools: {} },
+        serverInfo: { name: 'fake-mcp-stdio', version: '1.0.0' },
+      });
+    case 'ping':
+      return reply(msg.id, {});
+    case 'tools/list':
+      return reply(msg.id, { tools: TOOLS });
+    case 'tools/call': {
+      const name = msg.params && msg.params.name;
+      const args = (msg.params && msg.params.arguments) || {};
+      if (name === 'add') {
+        return reply(msg.id, {
+          content: [{ type: 'text', text: String(Number(args.a) + Number(args.b)) }],
+          isError: false,
+        });
+      }
+      if (name === 'ask_user' && ELICIT) {
+        const elicitId = nextId++;
+        pendingElicits.set(elicitId, { callId: msg.id });
+        send({ jsonrpc: '2.0', id: elicitId, method: 'elicitation/create', params: {
+          message: 'Which option do you want?',
+          requestedSchema: { type: 'object', properties: { choice: { type: 'string' } } },
+        } });
+        return;
+      }
+      return reply(msg.id, { content: [{ type: 'text', text: 'ok' }], isError: false });
+    }
+    default:
+      return rpcError(msg.id, -32601, 'method not found: ' + msg.method);
+  }
+}
+`, { mode: 0o755 });
+  return script;
+}
+
+module.exports = { writeFakeMcpStdio };

package/test/helpers/index.js

@@ -0,0 +1,11 @@
+// The hermetic seam, exported for every consumer's test suite: their unit
+// and end-to-end tests drive the same fakes this package's own suite uses.
+'use strict';
+
+const { startFakeAs } = require('./fake-as');
+const { startFakeMcpHttp, DEFAULT_TOOLS } = require('./fake-mcp-http');
+const { writeFakeMcpStdio } = require('./fake-mcp-stdio');
+
+module.exports = {
+  startFakeAs, startFakeMcpHttp, writeFakeMcpStdio, DEFAULT_TOOLS,
+};