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.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
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.mdindex 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 slowanswer, it produces **no answer**, and the seats that fail that way are not the weakest models — theyare 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.jsonindex 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.mjsindex 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) => ({ '&': '&', '<': '<', '>': '>', '"': '"' }[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.mjsindex 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.mjsindex 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.jpgnew file mode 100644index 000000000..a63b2d874Binary files /dev/null and b/store/showcase/roundtable/claim-map-mid-round.jpg differdiff --git a/store/showcase/roundtable/windows-port-room.jpg b/store/showcase/roundtable/windows-port-room.jpgnew file mode 100644index 000000000..8bb7ab625Binary files /dev/null and b/store/showcase/roundtable/windows-port-room.jpg differ