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.

A shell is never spoken to, and the device can now tell one

0xdiego25cf94dd79c3e4
diff --git a/cli/src/lib/voiceRouter.spec.ts b/cli/src/lib/voiceRouter.spec.ts
index 6adf89442..ae93a5305 100644
--- a/cli/src/lib/voiceRouter.spec.ts
+++ b/cli/src/lib/voiceRouter.spec.ts
@@ -246,6 +246,26 @@ describe('routeVoiceTask', () => {
routerImpl = async () => ({ text: '', sessionId: null })
})
+ it('never routes to a terminal, and treats a machine of only terminals as having no agent', async () => {
+ // Delivery is a paste and an Enter. In an agent's composer that is a prompt somebody can still
+ // read and edit; in a shell it is a command that has already run, so a spoken sentence must not
+ // be able to land in one — however it was routed, and whoever asked.
+ const withShell: RouterAgent[] = [
+ { id: 'sh', name: 'harness', engine: 'terminal' },
+ { id: '2', name: 'Auth', recentSummary: 'JWT refresh', engine: 'claude' },
+ ]
+ // One real agent left after the shell is dropped: it takes the "only agent" path and no engine or
+ // backend is consulted at all.
+ const one = await routeVoiceTask('rotate the signing key', withShell)
+ expect(one).toMatchObject({ agentId: '2', reason: 'only agent in machine' })
+ expect(rankAgents).not.toHaveBeenCalled()
+
+ // And with nothing but shells there is nobody to route to — the same answer an empty machine gets,
+ // which is what offers to make a new agent rather than silently picking the shell.
+ const none = await routeVoiceTask('rotate the signing key', [{ id: 'sh', name: 'harness', engine: 'terminal' }])
+ expect(none).toMatchObject({ agentId: '', needNewAgent: true })
+ })
+
it('takes the backend ranking when there is one, and asks no engine', async () => {
rankAgents.mockResolvedValue([
{ agentId: '2', score: 0.92, reason: 'auth' },
diff --git a/cli/src/lib/voiceRouter.ts b/cli/src/lib/voiceRouter.ts
index 9f1eded4a..0d5603c6e 100644
--- a/cli/src/lib/voiceRouter.ts
+++ b/cli/src/lib/voiceRouter.ts
@@ -389,10 +389,19 @@ export async function routeVoiceTask(
timeoutMs: number = ROUTE_CLASSIFY_MS,
continuity?: RouterContinuity,
): Promise<RouteDecision> {
+ // A SHELL IS NEVER A DESTINATION. Every caller builds its candidates from the same agent list, and
+ // that list carries terminals now — they are tiles the dial can reach. But routing delivers by
+ // typing the words in and pressing Enter, and in a shell that is not a prompt to be edited, it is a
+ // command that has already run. Dropped here, at the one point all three callers pass through, so
+ // no future caller has to remember. The tile's own Voice button is hidden for the same reason.
+ const routable = agents.filter((agent) => agent.engine !== 'terminal')
+ const dropped = agents.length - routable.length
+ agents = routable
// What the backend handed down, and what it may choose between. Logged before anything can fail, so a
// route that times out still shows the task and the candidates it was weighing.
console.log(
`[voice-route] task "${taskPreview(transcript)}" · candidates=${agents.length}` +
+ `${dropped ? ` (${dropped} terminal${dropped === 1 ? '' : 's'} not routable)` : ''}` +
`${agents.length ? ` [${agents.map((agent) => `${agent.name}/${agent.engine ?? '?'}`).join(', ')}]` : ''}`,
)
if (agents.length === 0) {
diff --git a/devices/harness-device/firmware/main/ui/ui_screens.c b/devices/harness-device/firmware/main/ui/ui_screens.c
index def879c88..bafeac41f 100644
--- a/devices/harness-device/firmware/main/ui/ui_screens.c
+++ b/devices/harness-device/firmware/main/ui/ui_screens.c
@@ -5377,9 +5377,18 @@ void ui_project_set_name(const char *project_id, const char *name)
display_unlock();
}
+// The words this device will store as an engine. An unknown one is dropped rather than shown, so a
+// daemon that learns a new engine cannot put a name on this screen that nothing here can draw.
+//
+// `terminal` is in the list and is NOT a product: it is the shell a pane holds when no engine is
+// running in it, and three things on a tile read it — the `>_` mark instead of a product logo, the
+// resting line, and the Voice button, which a shell must not offer. Leaving it out did not merely
+// hide the mark: the word was erased on arrival, so every one of those tests silently answered "not
+// a terminal" and the tile drew itself as an agent that had simply gone quiet.
static const char *normalized_engine(const char *engine)
{
- return engine && (!strcmp(engine, "claude") || !strcmp(engine, "codex") ||
+ return engine && (!strcmp(engine, "terminal") ||
+ !strcmp(engine, "claude") || !strcmp(engine, "codex") ||
!strcmp(engine, "cursor") || !strcmp(engine, "opencode") ||
!strcmp(engine, "pi") || !strcmp(engine, "hermes") ||
!strcmp(engine, "commandcode") || !strcmp(engine, "devin") ||