Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

fix(roundtable): a seat never waits on stdin, and the pane reads

dee5cb7b92ae858
diff --git a/docs/research/2026-09-20-roundtable-harness.md b/docs/research/2026-09-20-roundtable-harness.md
index 94a9bf1f0..0cced8847 100644
--- a/docs/research/2026-09-20-roundtable-harness.md
+++ b/docs/research/2026-09-20-roundtable-harness.md
@@ -260,3 +260,22 @@ about the same file in 17 seconds. So:
The general lesson is worth keeping: in a panel, an unbounded research task does not produce a slow
answer, it produces **no answer**, and the seats that fail that way are not the weakest models — they
are the most thorough. A room has to hand out a budget with the question.
+
+### Two bugs the first room found, both mine
+
+The absent cells were not the vendors' fault. Running four agent CLIs as subprocesses turns out to
+have two traps, and a panel harness hits both on its first run:
+
+- **A piped stdin nobody closes.** `codex exec` reads stdin when it is piped and appends it to the
+ prompt. `spawn()` gives a child a stdin pipe by default, and nothing ever closed it, so the seat
+ waited for input that would never arrive and died on its timeout with nothing to show — while the
+ identical prompt answered in 194 seconds from a shell. Seats now run with `stdio[0] = 'ignore'`.
+- **A kill that does not reach the grandchildren.** These CLIs shell out (`/bin/zsh -lc rg …`).
+ Killing the CLI leaves those holding the stdout pipe open, so the round hangs past its own
+ timeout — the first run's 900-second timeout reported 1079 seconds. Seats now run `detached` and
+ are killed as a process group, and a round now ends at its deadline to the second.
+
+Both are tested. The general form is worth remembering for any harness that drives another agent as
+a subprocess: **you do not control the child's stdio contract, and you do not control its
+children.** Assume both and the panel is reliable; assume neither and it looks like the models
+failed when it was the plumbing.
diff --git a/store/agents/roundtable/store.json b/store/agents/roundtable/store.json
index 76491384f..e99a95434 100644
--- a/store/agents/roundtable/store.json
+++ b/store/agents/roundtable/store.json
@@ -3,7 +3,8 @@
"examples": [
{
"prompt": "Should our Windows port be native, or should we ship the daemon inside WSL2? One engineer on it. Evidence: the cli/ folder.",
- "caption": "Four vendors read the daemon, split 2–2 on whether it is genuinely tmux-shaped"
+ "caption": "Four vendors read the daemon · agreed on 2 claims, split on 5, decided with the dissent attached",
+ "image": "https://raw.githubusercontent.com/autonomous-ai/openharness/main/store/showcase/roundtable/windows-port-room.jpg"
},
{
"prompt": "We're about to rename the product. Red-team the new name: three seats whose only job is to break it.",
@@ -13,5 +14,9 @@
"prompt": "Postgres or SQLite for this app's local store? Evidence: this repo. I care about migrations and multi-process access.",
"caption": "Panel · agreed on five claims, split on one, decided with the dissent attached"
}
+ ],
+ "screenshots": [
+ "https://raw.githubusercontent.com/autonomous-ai/openharness/main/store/showcase/roundtable/windows-port-room.jpg",
+ "https://raw.githubusercontent.com/autonomous-ai/openharness/main/store/showcase/roundtable/claim-map-mid-round.jpg"
]
}
diff --git a/store/agents/roundtable/toolchain/lib/render.mjs b/store/agents/roundtable/toolchain/lib/render.mjs
index 0f5dad33b..fe92a2e3c 100644
--- a/store/agents/roundtable/toolchain/lib/render.mjs
+++ b/store/agents/roundtable/toolchain/lib/render.mjs
@@ -12,27 +12,51 @@ import { trimToShape } from './prompts.mjs'
import { PROTOCOL, WORKSPACE, decision, motion, readClaims, readRoom, readTurn } from './room.mjs'
const ENGINE_HUE = { claude: 18, codex: 220, opencode: 268, grok: 0, pi: 150, hermes: 44 }
+/**
+ * Seats cite files by the absolute path they were given, because that is what they were given. In
+ * the pane that is noise — and on a page anyone might share, it is the reader's home directory. The
+ * evidence root is stripped back to the repo-relative path the reader recognises.
+ */
+export function relativise(text, evidence = []) {
+ let out = String(text ?? '')
+ for (const root of [...evidence].sort((a, b) => b.length - a.length)) {
+ if (!root) continue
+ out = out.split(`${root}/`).join('').split(root).join(root.split('/').pop())
+ }
+ return out
+}
+
const esc = (s) => String(s ?? '').replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]))
/** Just enough markdown for a turn: headings, bold, code, bullets, paragraphs. No dependencies. */
function md(text) {
+ // Seats cite differently: Codex writes markdown links to files, others write bare paths. A link to
+ // the web is a link; a link to a file is the path, which is the part a reader can act on.
const inline = (s) => esc(s)
+ .replace(/\[([^\]]+)\]\((https?:\/\/[^)\s]+)\)/g, '<a href="$2" target="_blank" rel="noopener noreferrer">$1</a>')
+ .replace(/\[([^\]]+)\]\(([^)\s]+)\)/g, '<code>$2</code>')
.replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>')
.replace(/(^|[\s(])\*([^*\n]+)\*/g, '$1<em>$2</em>')
.replace(/`([^`]+)`/g, '<code>$1</code>')
+ // Turns arrive hard-wrapped, so a paragraph is a run of lines and a bullet continues until the
+ // next one. Formatting line by line splits `**a bold phrase**` across two lines and it renders as
+ // asterisks — which is exactly what the first draft of this did to the decision card.
const out = []
let list = null
+ let para = []
+ const flushPara = () => { if (para.length) { out.push(`<p>${inline(para.join(' '))}</p>`); para = [] } }
+ const flushList = () => { if (list) { out.push(`<ul>${list.map((i) => `<li>${inline(i)}</li>`).join('')}</ul>`); list = null } }
for (const raw of String(text ?? '').split('\n')) {
- const line = raw.trimEnd()
- const bullet = /^\s*[-*]\s+(.*)$/.exec(line)
+ const line = raw.trim()
+ const bullet = /^[-*]\s+(.*)$/.exec(line)
const heading = /^(#{1,6})\s+(.*)$/.exec(line)
- if (bullet) { list ??= []; list.push(inline(bullet[1])); continue }
- if (list) { out.push(`<ul>${list.map((i) => `<li>${i}</li>`).join('')}</ul>`); list = null }
- if (!line) continue
- if (heading) out.push(`<h4>${inline(heading[2])}</h4>`)
- else out.push(`<p>${inline(line)}</p>`)
+ if (!line) { flushPara(); flushList(); continue }
+ if (heading) { flushPara(); flushList(); out.push(`<h4>${inline(heading[2])}</h4>`); continue }
+ if (bullet) { flushPara(); list ??= []; list.push(bullet[1]); continue }
+ if (list) { list[list.length - 1] += ` ${line}`; continue }
+ para.push(line)
}
- if (list) out.push(`<ul>${list.map((i) => `<li>${i}</li>`).join('')}</ul>`)
+ flushPara(); flushList()
return out.join('\n')
}
@@ -49,7 +73,7 @@ function seatHead(seat) {
</div>`
}
-function cell(roundId, seat) {
+function cell(roundId, seat, evidence) {
const turn = readTurn(roundId, seat.id)
if (!turn) return '<div class="cell empty"><span>—</span></div>'
const state = turn.front.state ?? 'answered'
@@ -60,7 +84,7 @@ function cell(roundId, seat) {
if (state === 'absent') {
return `<div class="cell absent"><p class="why">No answer.</p><p class="why dim">${esc(turn.front.error ?? '')}</p></div>`
}
- return `<div class="cell" tabindex="0" role="button" aria-expanded="false"><div class="turn">${md(trimToShape(turn.body, roundId))}</div>
+ return `<div class="cell" tabindex="0" role="button" aria-expanded="false"><div class="turn">${md(relativise(trimToShape(turn.body, roundId), evidence))}</div>
<div class="fade"></div>
<div class="cell-foot"><span class="more">more</span>${esc(seconds(Number(turn.front.elapsed_ms)))}${turn.front.model && turn.front.model !== 'default' ? ` · ${esc(turn.front.model)}` : ''}</div></div>`
}
@@ -78,8 +102,8 @@ function claimsTable(room, claims) {
<td class="verdictcol">${settled ? 'settled' : split ? 'split' : 'open'}</td></tr>`
}).join('')
return `<section class="claims"><h2>Where they agree, and where they don't</h2>
- <table><thead><tr><th>Claim</th>${room.seats.map((s) => `<th class="seatcol">${esc(s.id)}</th>`).join('')}<th></th></tr></thead>
- <tbody>${rows}</tbody></table></section>`
+ <div class="scroller"><table><thead><tr><th>Claim</th>${room.seats.map((s) => `<th class="seatcol">${esc(s.id)}</th>`).join('')}<th></th></tr></thead>
+ <tbody>${rows}</tbody></table></div></section>`
}
function phaseStrip(room) {
@@ -96,7 +120,7 @@ function readView(room) {
for (const { seat, turn } of turns) {
blocks.push(`<article class="readturn" style="--hue:${ENGINE_HUE[seat.engine] ?? 210}">
<header><span class="chip">${esc(seat.engine.slice(0, 2).toUpperCase())}</span><b>${esc(seat.id)}</b>
- <span class="dim">${esc(ADAPTERS[seat.engine]?.label ?? seat.engine)}</span></header>${md(trimToShape(turn.body, round.id))}</article>`)
+ <span class="dim">${esc(ADAPTERS[seat.engine]?.label ?? seat.engine)}</span></header>${md(relativise(trimToShape(turn.body, round.id), room.evidence))}</article>`)
}
}
return blocks.join('\n')
@@ -134,24 +158,29 @@ main{padding:16px 20px 60px}
.call{background:var(--card);border:1px solid var(--line);border-left:3px solid var(--accent);border-radius:8px;padding:14px 18px;margin-bottom:18px}
.call h2{font-size:11px;letter-spacing:.12em;text-transform:uppercase;color:var(--accent);margin:0 0 6px}
.claims{margin-bottom:22px}
+.claims table{min-width:min-content}
+.claims .scroller{margin-top:2px}
.claims h2,.grid-title{font-size:11px;letter-spacing:.1em;text-transform:uppercase;color:var(--dim);margin:0 0 8px;font-weight:600}
table{border-collapse:collapse;width:100%;font-size:12.5px}
th,td{text-align:left;padding:7px 10px;border-bottom:1px solid var(--line);vertical-align:top}
th{font-size:10.5px;text-transform:uppercase;letter-spacing:.06em;color:var(--dim);font-weight:600}
th.seatcol,td:not(.claim):not(.verdictcol){text-align:center;width:74px}
+td.claim,th:first-child{min-width:260px}
tr.settled td.claim{color:var(--dim)}tr.split{background:light-dark(#fff8f0,#26211c)}
.verdictcol{font-size:10.5px;color:var(--dim);text-transform:uppercase;letter-spacing:.06em;width:60px}
.m.yes{color:var(--yes)}.m.no{color:var(--no)}.m.dim{color:var(--dim)}
-.grid{display:grid;grid-template-columns:${cols};gap:1px;background:var(--line);border:1px solid var(--line);border-radius:8px;overflow:hidden}
+.scroller{overflow-x:auto;border:1px solid var(--line);border-radius:8px}
+.grid{display:grid;grid-template-columns:${cols};gap:1px;background:var(--line);min-width:min-content}
.grid>*{background:var(--bg)}
-.corner{background:var(--bg)}
.seat{padding:10px 12px;background:var(--card)}
.seat-top{display:flex;gap:8px;align-items:center}
.chip{display:grid;place-items:center;width:20px;height:20px;border-radius:5px;font-size:9.5px;font-weight:700;letter-spacing:.02em;
background:oklch(.72 .13 var(--hue));color:#111;flex:none}
.seat-name{font-weight:600;font-size:12.5px}.seat-engine{font-size:10.5px;color:var(--dim)}
.stance{margin-top:7px;font-size:11px;color:var(--dim);line-height:1.35}.stance.none{font-style:italic;opacity:.7}
-.rowhead{padding:12px;background:var(--card);font-size:11px;text-transform:uppercase;letter-spacing:.08em;color:var(--dim);font-weight:600}
+.rowhead{padding:12px;background:var(--card);font-size:11px;text-transform:uppercase;letter-spacing:.08em;color:var(--dim);font-weight:600;
+position:sticky;left:0;z-index:2;box-shadow:1px 0 0 var(--line)}
+.corner{position:sticky;left:0;z-index:3}
.cell{position:relative;padding:11px 13px 30px;max-height:340px;overflow:hidden;font-size:12.5px;cursor:pointer}
.cell.open{max-height:none;cursor:default}
.cell:focus-visible{outline:2px solid var(--accent);outline-offset:-2px}
@@ -192,11 +221,11 @@ code{font-family:ui-monospace,SFMono-Regular,monospace;font-size:.92em;backgroun
${call ? `<section class="call"><h2>The call</h2>${md(call.replace(/^#\s+.*\n/, ''))}</section>` : ''}
${claimsTable(room, claims)}
${room.seats.length ? `<div class="grid-title">The room</div>
- <div class="grid">
+ <div class="scroller"><div class="grid">
<div class="corner"></div>
${room.seats.map(seatHead).join('')}
- ${PROTOCOL.map((round) => `<div class="rowhead">${esc(round.name)}</div>${room.seats.map((s) => cell(round.id, s)).join('')}`).join('')}
- </div>` : '<div class="empty-room">No seats yet. The moderator is still setting the room.</div>'}
+ ${PROTOCOL.map((round) => `<div class="rowhead">${esc(round.name)}</div>${room.seats.map((s) => cell(round.id, s, room.evidence)).join('')}`).join('')}
+ </div></div>` : '<div class="empty-room">No seats yet. The moderator is still setting the room.</div>'}
${motionText ? `<details style="margin-top:22px"><summary class="grid-title" style="cursor:pointer">The motion in full</summary><div style="max-width:74ch;margin-top:8px">${md(motionText)}</div></details>` : ''}
<div id="read">${readView(room)}</div>
</main>
diff --git a/store/agents/roundtable/toolchain/lib/run.mjs b/store/agents/roundtable/toolchain/lib/run.mjs
index 82247b7e5..3f3742cb2 100644
--- a/store/agents/roundtable/toolchain/lib/run.mjs
+++ b/store/agents/roundtable/toolchain/lib/run.mjs
@@ -45,7 +45,12 @@ async function runOne(seat, room, round, { motionText, peerTurns, ownTurns, time
// `detached` puts the seat in its own process group. These CLIs shell out (`/bin/zsh -lc rg …`),
// and killing only the CLI leaves those grandchildren holding the stdout pipe open — the round
// then hangs well past its own timeout waiting for a close that never comes.
- const child = spawn(adapter.bin, args, { cwd, env: { ...process.env, NO_COLOR: '1' }, detached: true })
+ // stdin is `ignore`, not a pipe, and that is load-bearing: `codex exec` reads stdin when it is
+ // piped and appends it to the prompt, so an open pipe nobody ever closes means the seat waits for
+ // input that never comes and the round dies on its timeout with nothing to show.
+ const child = spawn(adapter.bin, args, {
+ cwd, env: { ...process.env, NO_COLOR: '1' }, detached: true, stdio: ['ignore', 'pipe', 'pipe'],
+ })
child.stdout.on('data', (d) => { stdout += d })
child.stderr.on('data', (d) => { stderr += d })
const timer = setTimeout(() => {
diff --git a/store/agents/roundtable/toolchain/test/room.test.mjs b/store/agents/roundtable/toolchain/test/room.test.mjs
index ea75d451c..07f3a18e2 100644
--- a/store/agents/roundtable/toolchain/test/room.test.mjs
+++ b/store/agents/roundtable/toolchain/test/room.test.mjs
@@ -187,3 +187,70 @@ describe('a seat that overruns', () => {
match(room.readTurn('opening', 'slow').front.error, /within 2s/)
})
})
+
+describe('a seat never waits on stdin', () => {
+ it('runs a CLI that reads stdin to completion instead of hanging on an open pipe', async () => {
+ const { runRound } = await import('../lib/run.mjs')
+ const { ADAPTERS } = await import('../lib/engines.mjs')
+ const real = ADAPTERS.claude.build
+ ADAPTERS.claude.build = () => ({ args: ['-c', 'cat; echo "**Position.** Read to EOF."'], capture: 'stdout' })
+ ADAPTERS.claude.bin = 'sh'
+ const one = { ...base, seats: [{ id: 'reader', engine: 'claude', stance: null }] }
+ const [result] = await runRound(one, { ...room.PROTOCOL[0], previousId: null }, { motionText: 'x', timeoutMs: 8000 })
+ ADAPTERS.claude.build = real; ADAPTERS.claude.bin = 'claude'
+ strictEqual(result.state, 'answered')
+ match(room.readTurn('opening', 'reader').body, /Read to EOF/)
+ })
+})
+
+describe('the pane does not leak the reader a home directory', () => {
+ it('cites files by their path inside the evidence, not by the absolute one the seat was given', async () => {
+ const { relativise } = await import('../lib/render.mjs')
+ strictEqual(relativise('see /Users/someone/code/app/cli/src/a.ts:20', ['/Users/someone/code/app']), 'see cli/src/a.ts:20')
+ strictEqual(relativise('the repo at /Users/someone/code/app is big', ['/Users/someone/code/app']), 'the repo at app is big')
+ strictEqual(relativise('nothing to do', []), 'nothing to do')
+ })
+})
+
+describe('citations', () => {
+ it('keeps a web link and turns a file link into the path itself', () => {
+ room.writeRoom({ ...base, seats: [SEATS[0]] })
+ room.writeTurn('opening', SEATS[0], { state: 'answered', elapsedMs: 1,
+ body: '**Position.** See [terminalBackend.ts](cli/src/lib/terminalBackend.ts:20) and [the docs](https://example.com/x).' })
+ const html = renderHtml()
+ match(html, /<code>cli\/src\/lib\/terminalBackend\.ts:20<\/code>/)
+ match(html, /<a href="https:\/\/example\.com\/x" target="_blank" rel="noopener noreferrer">the docs<\/a>/)
+ room.writeRoom(base)
+ })
+})
+
+describe('hard-wrapped turns', () => {
+ it('joins wrapped lines so bold across a line break still renders', () => {
+ room.writeRoom({ ...base, seats: [SEATS[0]] })
+ room.writeTurn('opening', SEATS[0], { state: 'answered', elapsedMs: 1,
+ body: '**Position.** Ship the viewer\nnow, and hold the tier.\n\n- a bullet that\n wraps onto a second line\n- a second bullet' })
+ const html = renderHtml()
+ match(html, /<p><strong>Position\.<\/strong> Ship the viewer now, and hold the tier\.<\/p>/)
+ match(html, /<li>a bullet that wraps onto a second line<\/li>/)
+ match(html, /<li>a second bullet<\/li>/)
+ room.writeRoom(base)
+ })
+
+ it('keeps bold that opens on one line and closes on the next', () => {
+ room.writeRoom({ ...base, seats: [SEATS[0]] })
+ room.writeTurn('opening', SEATS[0], { state: 'answered', elapsedMs: 1, body: '**Ship the viewer now.\nHold the tier.**' })
+ const html = renderHtml()
+ match(html, /<strong>Ship the viewer now\. Hold the tier\.<\/strong>/)
+ ok(!/\*\*Ship/.test(html))
+ room.writeRoom(base)
+ })
+})
+
+describe('a narrow pane', () => {
+ it('scrolls the seats sideways with the round labels pinned, instead of overflowing the page', () => {
+ const html = renderHtml()
+ match(html, /class="scroller"/)
+ match(html, /\.rowhead\{[^}]*position:sticky;left:0/)
+ ok(!/\.grid\{[^}]*overflow:hidden/.test(html), 'the grid itself must not clip its own columns')
+ })
+})
diff --git a/store/showcase/roundtable/claim-map-mid-round.jpg b/store/showcase/roundtable/claim-map-mid-round.jpg
new file mode 100644
index 000000000..a63b2d874
Binary files /dev/null and b/store/showcase/roundtable/claim-map-mid-round.jpg differ
diff --git a/store/showcase/roundtable/windows-port-room.jpg b/store/showcase/roundtable/windows-port-room.jpg
new file mode 100644
index 000000000..8bb7ab625
Binary files /dev/null and b/store/showcase/roundtable/windows-port-room.jpg differ