// The agent relay (scripts/agent/relay.js): a WebSocket router between the game page (src/agent/80-relay.js, agent // mode in Settings) and tool clients. This drives the whole chain with a real page: the harness loads the game // in jsdom, the page's own client dials the relay (a test opts in with __AGENT_RELAY_TEST__ and points it at the // relay's port, because under __TUBES_TEST__ nothing dials on its own), and a raw WebSocket tool client, the relay // client (scripts/lib/relay-client.js) and the MCP server in browser mode (scripts/mcp.js --browser) take turns driving // it. No token anywhere: whatever can connect to the port may drive the game, by design. const test = require('node:test'); const assert = require('node:assert/strict'); const fs = require('node:fs'); const os = require('node:os'); const path = require('node:path'); const { spawn } = require('node:child_process'); const http = require('node:http'); const WebSocket = require('ws'); const { load } = require('./harness'); const ROOT = path.join(__dirname, '..'); const { createRelay } = require('../scripts/agent/relay'); const { createRelaySession } = require('../scripts/lib/relay-client'); const SERVER = path.join(ROOT, 'scripts', 'mcp.js'); const PORT = 8799 + (process.pid % 500); // dodge a busy port across suites const tmp = () => fs.mkdtempSync(path.join(os.tmpdir(), 'tubes-relay-')); const wait = (ms) => new Promise((r) => setTimeout(r, ms)); // Waits until ok() holds, up to ms: a busy CI runner can take seconds to load a page, so no fixed delay is enough. const until = async (ok, ms = 20000) => { const t0 = Date.now(); while (!ok() && Date.now() - t0 < ms) await wait(50); return ok(); }; // The relay in-process, riding a real http.Server (the same createRelay the servers host): no child to leak, and // 'listening' means the first dial cannot race the bind. function startRelay(port = PORT) { const srv = http.createServer((req, res) => { res.writeHead(404); res.end(); }); const relay = createRelay({ server: srv }); return { relay, srv, listening: () => new Promise((res, rej) => { srv.once('error', rej); srv.listen(port, '127.0.0.1', res); }), close: () => new Promise((r) => { relay.close(); srv.close(() => r()); }), }; } // The game page: jsdom via the harness, agent mode on (opts.ms: the clock, 0 for the agent's). The page's own client // connects to this relay's host:port as the page. The harness origin matches the relay host, so the page's WebSocket // Origin is same-origin (the relay refuses a foreign one; a Node tool sends none). function page(opts = {}) { const a = load({ url: `http://127.0.0.1:${opts.port ?? PORT}/`, seed: opts.seed ?? 5, storage: { 'sot-agent': JSON.stringify({ on: true, ms: opts.ms ?? 60000 }) }, agent: true }); dial(a, opts.port); return a; } const dial = (a, port = PORT) => a.ev(`window.__AGENT_RELAY_TEST__=true;API_RELAY_HOST='127.0.0.1:'+${port};apiAgentSync()`); // Kill the page's dial and retry timer before a test ends, or its backoff keeps the process alive. const stop = (...ps) => { for (const a of ps) if (a) a.ev("window.__AGENT_RELAY_TEST__=false;apiAgentSet('on',false)"); }; // A raw tool client, the way the MCP server speaks to the relay. `headers` fakes a browser's Origin (which Node's ws // does not send) for the cross-site test. function toolClient(port = PORT, headers) { const ws = new WebSocket(`ws://127.0.0.1:${port}/agent`, headers ? { headers } : undefined); const calls = new Map(); let seq = 0; const events = []; ws.on('message', (d) => { const m = JSON.parse(String(d)); if (m.kind === 'presence') { events.push(m); return; } if (m.kind === 'result' && calls.has(m.id)) { calls.get(m.id)(m); calls.delete(m.id); } }); return { ws, events, open: () => new Promise((res, rej) => { ws.on('open', res); ws.on('error', rej); }), auth: (role = 'tool') => ws.send(JSON.stringify({ kind: 'auth', role })), call: (tool, args) => new Promise((res) => { // a timeout, never a hang const id = 'c' + (++seq); const t = setTimeout(() => { calls.delete(id); res({ error: `no answer for ${tool} (the page went silent?)` }); }, 20000); calls.set(id, (m) => { clearTimeout(t); res(m); }); ws.send(JSON.stringify({ kind: 'call', id, tool, args: args || {} })); }), close: () => { try { ws.close(); } catch {} }, }; } async function tool() { const t = toolClient(); await t.open(); t.auth('tool'); await wait(150); return t; } async function withRelay(fn) { const r = startRelay(); await r.listening(); try { return await fn(r); } finally { await r.close(); } } // The MCP server over stdio, as a client runs it. function mcp(argv, onErr) { const child = spawn(process.execPath, [SERVER, ...argv], { stdio: ['pipe', 'pipe', 'pipe'] }); let buf = '', id = 0, err = ''; const waiting = new Map(); child.stderr.on('data', (d) => { err += d; if (onErr) onErr(String(d)); }); child.stdout.on('data', (d) => { buf += d; let i; while ((i = buf.indexOf('\n')) >= 0) { const line = buf.slice(0, i); buf = buf.slice(i + 1); let m; try { m = JSON.parse(line); } catch { continue; } if (m.id !== undefined && waiting.has(m.id)) { waiting.get(m.id)(m); waiting.delete(m.id); } } }); const send = (o) => new Promise((res) => { const k = ++id; waiting.set(k, res); child.stdin.write(JSON.stringify({ jsonrpc: '2.0', id: k, ...o }) + '\n'); }); return { child, send, stderr: () => err, init: async () => { const r = await send({ method: 'initialize', params: { protocolVersion: '2025-06-18', capabilities: {}, clientInfo: { name: 'test', version: '0' } } }); child.stdin.write(JSON.stringify({ jsonrpc: '2.0', method: 'notifications/initialized' }) + '\n'); return r; }, call: async (name, args) => (await send({ method: 'tools/call', params: { name, arguments: args || {} } })).result, json: async (name, args) => JSON.parse((await send({ method: 'tools/call', params: { name, arguments: args || {} } })).result.content[0].text), kill: async () => { child.kill('SIGTERM'); await wait(200); child.kill('SIGKILL'); }, }; } test('the relay binds loopback, gates on the role, and never needs a token', () => withRelay(async () => { const silent = toolClient(); await silent.open(); assert.equal(await new Promise((res) => silent.ws.on('close', (code) => res(code))), 4003, 'a client that never states a role is closed'); const bogus = toolClient(); await bogus.open(); bogus.auth('hacker'); assert.equal(await new Promise((res) => bogus.ws.on('close', (code) => res(code))), 4001, 'a role that is neither page nor tool is refused'); const t = await tool(); assert.deepEqual(t.events.map((e) => e.page), [false], 'a fresh tool sees no page'); const r = await t.call('state', { path: 'cash' }); assert.match(r.error, /no game page connected/i); t.close(); })); test('a live page answers tool calls through the relay, from a fixed list of tools', () => withRelay(async () => { const t = await tool(); const a = page(); try { a.ev("ACT.start({});S.cash=500000;compute()"); await wait(600); assert.ok(t.events.some((e) => e.page === true), 'the tools see the page join'); const q = await t.call('act', { action: 'buildPop', args: { city: 'ams' }, dryRun: true }); assert.equal(q.value.outcome, 'quote'); assert.equal(q.value.quote.setup, 20000); assert.equal(a.ev('S.pops.ams'), undefined, 'nothing was dispatched in the page'); const r = await t.call('act', { action: 'buildPop', args: { city: 'ams' } }); assert.equal(r.value.outcome, 'applied'); assert.equal(r.value.charged, 20000); assert.equal(a.ev('S.pops.ams && S.pops.ams.day'), 0, 'the page really changed'); assert.equal(r.dayBefore, 0); assert.equal((await t.call('state', { path: 'cash' })).value, 480000); assert.equal((await t.call('status')).value.pops.length, 2); const nope = await t.call('act', { action: 'speed', args: { v: 0 } }); assert.match(nope.error, /not available here/); // Unknown tools never reach the facade: its fixed list is the whole vocabulary. const hack = await t.call('eval', { code: 'S.cash=1e9' }); assert.match(hack.error, /no tool "eval"/); assert.equal(a.ev('S.cash'), 480000); assert.equal(a.ev('API_TOASTS.depth===0&&API_TOASTS.real===null&&toast.name'), 'toast', 'toast() is the game\'s own again after every call'); } finally { stop(a); t.close(); } })); test('in the player\'s tab the player owns the game, their windows, their settings and the dice', () => withRelay(async () => { const t = await tool(); const a = page({ ms: 0 }); try { a.ev("ACT.start({});S.cash=1e7;S.nextFail=S.day+40;S.nextEvent=S.day+50;compute()"); await wait(500); // The dice stay hidden, whole or by path, and the schema says so. const st = (await t.call('state')).value; for (const k of ['rng', 'nextFail', 'nextEvent']) assert.ok(!(k in st), `${k} is held back`); assert.equal((await t.call('state', { path: 'nextFail' })).value, null); assert.equal(st.cash, 1e7, 'the board itself is all there'); const mode = (await t.call('schema', { section: 'mode' })).value; assert.equal(mode.backend, 'browser'); assert.equal(mode.clock, 'agent'); assert.ok(mode.withheld.nextFail); assert.ok((await t.call('schema', { section: 'state' })).value.rng.withheld); // Starting, loading or leaving a game is the player's. for (const [action, args] of [['startScn', { id: a.ev('SCN[0].id') }], ['pzStart', { id: a.ev('PZ[0].id') }], ['startWeekly', {}]]) { const r = await t.call('act', { action, args }); assert.match(r.error || '', /the player's/, action); } assert.equal(a.ev('S.mode'), 'normal'); // So are their settings, agent mode's own switch included: it is no game action, so no tool can find or press it. assert.match((await t.call('act', { action: 'prefSet', args: { v: 'pauseFurious:0' } })).error, /not available here/); assert.match((await t.call('act', { action: 'agentSet', args: {} })).error, /no action/); assert.equal(a.ev('API_AGENT_PREFS.on'), true); // A window the player opened by hand stays theirs: the agent plays behind it, and never closes or replaces it. a.ev("(()=>{const b=document.createElement('button');b.dataset.act='settings';document.body.appendChild(b);b.click();b.remove();})()"); assert.equal(a.ev("$('modal').hidden"), false, 'the player has a window open'); assert.equal(a.ev('API_MODAL.hand'), true, 'marked as theirs'); const html = a.ev("$('modalCard').innerHTML"); const sc = (await t.call('screen')).value; assert.equal(sc.where, 'modal'); assert.ok(sc.playerWindow, 'the screen says whose it is'); assert.equal(sc.question, false, 'and that it is no question'); const b = await t.call('act', { action: 'buildPop', args: { city: 'ams' } }); assert.equal(b.value.outcome, 'applied', 'the agent plays on behind it'); const v = await t.call('act', { action: 'opsOpen' }); assert.equal(v.value.screen.where, 'modal'); assert.match(v.value.screen.note || '', /shown to you and closed again/, 'its own sheet is shown, then the player\'s window comes back'); await t.call('act', { action: 'closeModal' }); assert.equal(a.ev("$('modal').hidden"), false, 'closeModal does not close the player\'s window'); assert.equal(a.ev("$('modalCard').innerHTML"), html, 'nor change it'); await t.call('screen', { where: 'modal' }); const c = await t.call('click', { button: 0 }); assert.match(c.error || '', /theirs to press/); assert.match((await t.call('open_link', { from: 'fra', to: 'nyc' })).error || '', /would replace it/); // Days run behind it (the agent's clock here), and it is still there after. const adv = await t.call('advance', { days: 3 }); assert.equal(adv.value.daysRun, 3); assert.equal(a.ev('S.day'), 3); assert.equal(a.ev("$('modalCard').innerHTML"), html); } finally { stop(a); t.close(); } })); test('the agent\'s clock moves only with advance; a running clock only with time, and wait reads it', () => withRelay(async () => { const t = await tool(); const a = page({ ms: 0 }); try { a.ev("ACT.start({});S.cash=1e7;compute()"); await wait(500); assert.equal(a.ev('UI.speed'), 0, 'a tool is connected, but the agent\'s clock stands still'); a.ev('last=performance.now();for(let i=1;i<=20;i++)frame(last+i*250)'); assert.equal(a.ev('S.day'), 0, 'the loop runs no days'); const adv = await t.call('advance', { days: 20 }); assert.equal(adv.value.daysRun, 20, 'advance runs them, where the player sees them'); assert.equal(a.ev('S.day'), 20); assert.match((await t.call('clock')).value.mode, /agent/); // The player switches to a pace: the clock runs by itself, and advance is refused. a.ev("apiAgentSet('ms',30000)"); assert.equal(a.ev('UI.speed'), a.ev('DAY_MS/30000'), 'a pace, and a tool connected: it runs, a day per 30 s'); assert.match((await t.call('advance', { days: 1 })).error, /use wait/); const c = (await t.call('clock')).value; assert.equal(c.mode, 'realtime'); assert.equal(c.running, true); // The page's own loop moves days at the pace (the test plays the browser's frames, 2 s of them per day). a.ev('API_AGENT_PREFS.ms=2000;apiAgentSync()'); a.ev('last=performance.now()'); const frames = setInterval(() => a.ev('frame(performance.now())'), 20); try { const { createBrowserSession } = require('../scripts/lib/mcp-browser'); const { TOOLS } = require('../scripts/lib/mcp-game'); const s = createBrowserSession({ port: PORT }); const w = await TOOLS.find((x) => x.name === 'wait').run(s, { days: 1, maxSeconds: 10 }); assert.ok(w.daysRun >= 1, `wait returns once a day has passed (${JSON.stringify(w)})`); assert.equal(w.stoppedBecause, null); await s.close(); } finally { clearInterval(frames); } } finally { stop(a); t.close(); } })); test('the page client reconnects after the relay restarts, and stops when the player switches agent mode off', () => withRelay(async (r) => { const t = await tool(); const a = page(); try { a.ev("ACT.start({});S.cash=500000;compute()"); await wait(500); assert.ok(t.events.some((e) => e.page === true)); await r.close(); await wait(300); a.ev("apiAgentSet('on',false)"); const r2 = startRelay(); await r2.listening(); try { await wait(1200); // past the first backoff retry assert.equal(a.ev('API_RELAY.on'), false, 'the client is off'); a.ev("apiAgentSet('on',true)"); await wait(1200); const t2 = await tool(); await wait(300); assert.ok(t2.events.some((e) => e.page === true), 'the page reconnected after the relay came back'); assert.equal((await t2.call('state', { path: 'cash' })).value, 500000, 'and answers calls again'); t2.close(); } finally { stop(a); await r2.close(); } } finally { stop(a); t.close(); } })); test('a paced clock holds while no tool is connected, and runs when one arrives', () => withRelay(async () => { const a = page({ seed: 5 }); try { a.ev("ACT.start({});S.nextFail=S.day+99;S.nextEvent=S.day+99;compute()"); await wait(500); assert.equal(a.ev('UI.speed'), 0, 'no tool connected: the clock holds'); assert.equal(a.ev('UI.clockLocked'), true, 'agent mode stays on'); a.ev('last=performance.now();frame(last);frame(last+250);frame(last+500)'); assert.equal(a.ev('S.day'), 0, 'no day ran'); const t = await tool(); await wait(300); assert.ok(a.ev('UI.speed') > 0, 'a tool connecting runs it'); t.close(); await wait(400); assert.equal(a.ev('UI.speed'), 0, 'the tool leaving holds it again'); a.ev('S.uiSpeed=4;gameResume()'); assert.equal(a.ev('UI.speed'), 0, 'gameResume holds with no tool connected'); const t2 = await tool(); await wait(300); assert.ok(a.ev('UI.speed') > 0, 'and a tool arriving runs it again'); // An unrelated preference change does not drop the connection or hold the clock. a.ev('window.__w0=API_RELAY.ws'); a.ev("ACT.prefSet({v:'pauseFurious:0'})"); a.ev("apiAgentSet('ms',300000)"); assert.equal(a.ev('API_RELAY.ws===window.__w0'), true, 'the same socket survived both'); assert.equal(a.ev('UI.speed'), a.ev('DAY_MS/300000'), 'the clock never held for them, and runs at the new pace'); t2.close(); } finally { stop(a); } })); test('a second page replaces the first: one game per relay, the newest tab wins', () => withRelay(async () => { const a = page({ seed: 5 }); a.ev("ACT.start({});S.cash=111000;compute()"); const b = page({ seed: 6 }); b.ev("ACT.start({});S.cash=222000;compute()"); await wait(700); const t = await tool(); try { assert.equal((await t.call('state', { path: 'cash' })).value, 222000, 'the newest page answers'); } finally { stop(a, b); t.close(); } })); test('the MCP server drives the player\'s page in browser mode, over stdio', () => withRelay(async () => { const a = page({ seed: 9, ms: 0 }); a.ev("ACT.start({});S.cash=1000000;compute()"); await wait(500); const m = mcp(['--browser', '--relay-host', 'localhost', '--relay-port', String(PORT)]); try { const init = await m.init(); assert.match(init.result.instructions, /player's own browser tab/); const list = (await m.send({ method: 'tools/list' })).result.tools.map((x) => x.name); for (const n of ['status', 'act', 'schema', 'state', 'advance', 'wait', 'screen', 'click']) assert.ok(list.includes(n), n); for (const n of ['new_game', 'load_save', 'export_save']) assert.ok(!list.includes(n), `${n} is the headless session's`); const mode = await m.json('schema', { section: 'mode' }); assert.equal(mode.backend, 'browser'); assert.equal(mode.transport, 'relay'); assert.equal(mode.relay, `ws://localhost:${PORT}/agent`, 'the mode says which relay: host, port and path'); assert.equal(await m.json('state', { path: 'cash' }), 1000000); const r = await m.json('act', { action: 'buildPop', args: { city: 'ams' } }); assert.equal(r.outcome, 'applied'); assert.equal(r.charged, 20000); assert.equal(a.ev('S.pops.ams && S.pops.ams.day'), 0, "the player's page really changed"); assert.equal((await m.json('advance', { days: 2 })).daysRun, 2); assert.ok((await m.json('actions')).includes('buildLink(a,b,tier,cable?,route?,premiumCrossing?)')); const no = await m.call('act', { action: 'startScn', args: { id: a.ev('SCN[0].id') } }); assert.equal(no.isError, true); assert.match(no.content[0].text, /the player's/); } finally { stop(a); await m.kill(); } })); test('a game page older than the code stops the server rather than mislead', () => withRelay(async () => { const a = page({ seed: 3 }); a.ev("ACT.start({});compute()"); // A stale tab whose commands keep their names but change shape: only a deep compare of the sections catches it. a.ev('const __c=TUBES.call;TUBES.call=(t,x,c)=>{const v=__c(t,x,c);if(t==="schema"&&!x.section)v.commands.buildPop.args=[{name:"city",required:true}];return v;};'); await wait(400); const m = mcp(['--browser', '--relay-port', String(PORT), '--page-wait-ms', '8000']); try { const init = await m.init(); assert.ok(init.result.serverInfo, 'the handshake is answered at once'); const code = await new Promise((r) => m.child.on('exit', (c2) => r(c2))); assert.equal(code, 1, 'the server exits with an error'); assert.match(m.stderr(), /disagrees with the code on disk \(commands\)/); assert.match(m.stderr(), /reload the page/); } finally { stop(a); await m.kill(); } })); test('the MCP server answers the handshake at once and waits for the game page', () => withRelay(async () => { const gone = mcp(['--browser', '--relay-port', String(PORT), '--page-wait-ms', '1200']); const code = await new Promise((r) => gone.child.on('exit', (c2) => r(c2))); assert.equal(code, 1, 'exits 1 without a page'); assert.match(gone.stderr(), /waiting for the game page/); assert.match(gone.stderr(), /no game page answered/); assert.match(gone.stderr(), /Settings → Agent API/); assert.doesNotMatch(gone.stderr(), /TypeError/); const m = mcp(['--browser', '--relay-port', String(PORT), '--page-wait-ms', '20000']); let a = null; try { const t0 = Date.now(); await m.init(); assert.ok(Date.now() - t0 < 3000, 'initialize does not wait for a browser tab'); const early = await m.call('status'); assert.equal(early.isError, true, 'a tool before the page arrives is an error, not a hang'); await wait(300); assert.match(m.stderr(), /waiting for the game page/); a = page({ seed: 4 }); a.ev("ACT.start({});S.cash=444000;compute()"); await until(() => /ready/.test(m.stderr())); assert.match(m.stderr(), /ready/, 'the server proceeded once the page answered'); assert.equal(await m.json('state', { path: 'cash' }), 444000, 'and drives the late page'); } finally { stop(a); await m.kill(); } })); const free = () => new Promise((res, rej) => { const s = http.createServer(); s.on('error', rej); s.listen(0, '127.0.0.1', () => { const p = s.address().port; s.close(() => res(p)); }); }); test('dev.js binds loopback and parses --port; the page dials its own host', async () => { const port = await free(); const child = spawn(process.execPath, [path.join(ROOT, 'scripts', 'dev.js'), '--port', String(port)], { stdio: ['ignore', 'ignore', 'pipe'] }); let serr = ''; child.stderr.on('data', (d) => { serr += d; }); let a = null; try { await wait(700); assert.match(serr, new RegExp(`agent relay on ws://127\\.0\\.0\\.1:${port}/agent`), 'dev.js binds loopback and honours --port'); const t = toolClient(port); await t.open(); t.auth('tool'); await wait(150); assert.ok(t.events.some((e) => e.page === false), 'the relay answers on 127.0.0.1'); t.close(); a = load({ url: `http://127.0.0.1:${port}/`, agent: true, storage: { 'sot-agent': JSON.stringify({ on: true }) } }); assert.equal(a.ev('API_RELAY.on'), false, 'under __TUBES_TEST__ nothing dials on its own'); a.ev(`window.__AGENT_RELAY_TEST__=true;API_RELAY_HOST='';apiAgentSync()`); assert.equal(a.ev('API_RELAY.on'), true); assert.equal(a.ev('apiRelayUrl()'), `ws://127.0.0.1:${port}/agent`, 'its own host and port, the relay path'); } finally { stop(a); child.kill('SIGTERM'); await wait(150); child.kill('SIGKILL'); } }); test('calls neither page nor relay can answer resolve as errors, not hangs', async () => { const r = startRelay(); await r.listening(); const pages = []; try { const t = await tool(); const a = page(); pages.push(a); a.ev('ACT.start({});S.cash=500000;compute()'); await wait(400); // The page dies with a call in flight; it is silenced first, so the call is provably pending when it closes. a.ev('API_RELAY.ws.onmessage=()=>{}'); const p = t.call('act', { action: 'buildPop', args: { city: 'ams' } }); await wait(100); a.ev('API_RELAY.ws.close(1000)'); assert.match((await p).error || '', /disconnected before answering/i); stop(a); t.close(); // The relay dies under a call in flight: the client answers on its own behalf, at once. const b = page({ seed: 12 }); pages.push(b); b.ev('ACT.start({});S.cash=222000;compute()'); await wait(400); b.ev('API_RELAY.ws.onmessage=()=>{}'); const s = createRelaySession({ host: '127.0.0.1', port: PORT }); const p2 = s.call('state', { path: 'cash' }); await wait(150); await r.close(); assert.match((await p2).refused || '', /connection closed/i); await s.close(); } finally { for (const pg of pages) stop(pg); await r.close(); } }); test('a page that hangs on a call answers within --call-ms, not minutes later', () => withRelay(async () => { const a = page({ seed: 4 }); try { a.ev('ACT.start({});compute()'); await wait(400); a.ev('API_RELAY.ws.onmessage=()=>{}'); // connected, alive, and never answering const s = createRelaySession({ host: '127.0.0.1', port: PORT, callMs: 300 }); const t0 = Date.now(); const r = await s.call('state', { path: 'cash' }); assert.match(r.refused || '', /no answer from the game page in 0\.3 s/); assert.ok(Date.now() - t0 < 2000, 'the configured timeout, not the default'); assert.equal(createRelaySession({}).config.callMs, 30000, 'the default is 30 s'); await s.close(); } finally { stop(a); } })); test('the relay refuses a cross-site Origin and takes a same-origin page or a token-less tool', () => withRelay(async () => { const evil = toolClient(PORT, { Origin: 'http://evil.example' }); await evil.open(); assert.equal(await new Promise((res) => evil.ws.on('close', (code) => res(code))), 4004, 'refused before any role is granted'); // DNS rebinding: evil.example re-pointed at 127.0.0.1 is "same-origin" with itself, but the Host is a name. const rebound = toolClient(PORT, { Host: `evil.example:${PORT}`, Origin: `http://evil.example:${PORT}` }); await rebound.open(); assert.equal(await new Promise((res) => rebound.ws.on('close', (code) => res(code))), 4004, 'a rebound DNS name is refused'); const named = toolClient(PORT, { Host: `evil.example:${PORT}` }); await named.open(); assert.equal(await new Promise((res) => named.ws.on('close', (code) => res(code))), 4004, 'with or without an Origin'); const same = toolClient(PORT, { Origin: `http://127.0.0.1:${PORT}` }); await same.open(); same.auth('page'); await wait(150); const t = await tool(); await wait(100); assert.ok(same.events.some((e) => e.tools === 1), 'the same-origin page connects and sees the tool'); t.close(); same.close(); })); // Spawns a server script and resolves with the address its relay banner reports (server.address()). function bannerOf(argv) { const child = spawn(process.execPath, argv, { stdio: ['ignore', 'ignore', 'pipe'] }); let serr = ''; return new Promise((res) => { const done = (v) => { clearTimeout(t); child.kill('SIGKILL'); res(v); }; const t = setTimeout(() => done({ addr: null, serr }), 5000); child.stderr.on('data', (d) => { serr += d; const m = /agent relay on ws:\/\/(\S+)\/agent/.exec(serr); if (m) done({ addr: m[1], serr }); }); }); } test('dev.js: a bare --host binds loopback, never every interface; binding wider is the operator\'s choice, and said', async () => { const p1 = await free(); const dev = await bannerOf([path.join(ROOT, 'scripts', 'dev.js'), '--host', '--port', String(p1)]); assert.equal(dev.addr, `127.0.0.1:${p1}`, `the socket is bound to loopback (${dev.serr})`); const p2 = await free(); const wide = await bannerOf([path.join(ROOT, 'scripts', 'dev.js'), '--host', '0.0.0.0', '--port', String(p2)]); assert.equal(wide.addr, `0.0.0.0:${p2}`, 'the banner is the real socket, not the flag echoed back'); assert.match(wide.serr, /bound to 0\.0\.0\.0, so anything that can reach this address can drive/); }); test('browser mode over HTTP: a client connects to the server, the server to the player\'s page', () => withRelay(async () => { const a = page({ seed: 11, ms: 0 }); a.ev("ACT.start({});S.cash=555000;compute()"); await wait(400); const child = spawn(process.execPath, [SERVER, '--browser', '--relay-port', String(PORT), '--http', '127.0.0.1:0'], { stdio: ['ignore', 'ignore', 'pipe'] }); let err = ''; try { const port = await new Promise((res, rej) => { child.stderr.on('data', (d) => { err += d; const m = /on http:\/\/127\.0\.0\.1:(\d+)\/mcp/.exec(err); if (m) res(+m[1]); }); child.on('exit', () => rej(new Error(err))); }); const post = (body) => new Promise((res, rej) => { const data = JSON.stringify({ jsonrpc: '2.0', id: 1, ...body }); const req = http.request({ host: '127.0.0.1', port, path: '/mcp', method: 'POST', headers: { 'content-type': 'application/json', accept: 'application/json, text/event-stream', 'mcp-protocol-version': '2025-06-18', 'content-length': Buffer.byteLength(data) } }, (r) => { let t = ''; r.setEncoding('utf8'); r.on('data', (d) => { t += d; }); r.on('end', () => { const line = t.split('\n').find((l) => l.startsWith('data: ')); res(JSON.parse(line ? line.slice(6) : t)); }); }); req.on('error', rej); req.end(data); }); const init = await post({ method: 'initialize', params: { protocolVersion: '2025-06-18', capabilities: {}, clientInfo: { name: 'test', version: '1' } } }); assert.match(init.result.instructions, /player's own browser tab/); const r = await post({ method: 'tools/call', params: { name: 'state', arguments: { path: 'cash' } } }); assert.equal(JSON.parse(r.result.content[0].text), 555000, 'the player\'s game, through HTTP and the relay'); const no = await post({ method: 'tools/call', params: { name: 'new_game', arguments: {} } }); assert.ok(no.error || (no.result && no.result.isError), 'no new_game in the player\'s tab'); } finally { stop(a); child.kill('SIGTERM'); await wait(150); child.kill('SIGKILL'); } }));