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
import type { ScreenReader } from '../../lib/screenReader.js'
/**
* Turn activity: whether an agent is really working, beyond what its transcript says. A turn's
* transcript can go quiet while the agent thinks or runs a long tool, so an open turn is checked against
* the runtime: Codex's own activity file, or what the pane shows.
*
* Moved verbatim out of `runForeground` (the core boundary, step 7: docs/design/2026-10-03-harnessd.md).
*/
import { isTerminalEngine } from '../../engines/types.js'
import type { RegisteredSession } from '../../lib/registry.js'
import { RuntimeActivityReader, activityRuntimeKey } from '../../lib/runtimeActivity.js'
import type { ActivityState } from '../../lib/turnActivity.js'
import type { TerminalBackendCoordinator } from '../../lib/terminalBackendCoordinator.js'
import { TurnActivity, type ActivityFrame } from '../../lib/turnActivity.js'
export interface TurnActivityDeps {
readScreen: ScreenReader
terminals: Pick<TerminalBackendCoordinator, 'capture'>
bySession: (sessionId: string) => RegisteredSession | undefined
sessionTurnOpen: (sessionId: string) => boolean
/** Read whatever the session's transcript has that the tail has not delivered yet (Watcher.pollSession). */
drain: (sessionId: string) => Promise<void>
/** What the engine's own server says (Codex's app-server, read in its worker: core/engines/nativeControls.ts). */
nativeActivity: (session: RegisteredSession) => Promise<ActivityState>
}
export function createTurnActivity({ readScreen, terminals, bySession, sessionTurnOpen, drain, nativeActivity }: TurnActivityDeps) {
const runtimeActivity = new RuntimeActivityReader({
readScreen,
codex: session => nativeActivity(session),
capture: async session => {
const screen = await terminals.capture(session, { mode: 'visible', ansi: true })
return screen.state === 'succeeded' ? screen.value : null
},
})
const turnActivity = new TurnActivity({
runtime: sessionId => {
const session = bySession(sessionId)
return session?.active ? { key: activityRuntimeKey(session), turnOpen: sessionTurnOpen(sessionId) } : undefined
},
drain: sessionId => drain(sessionId),
probe: async sessionId => {
const session = bySession(sessionId)
return session?.active ? runtimeActivity.read(session) : 'unknown'
},
})
/** The activity the app shows for an agent; none for a plain terminal. */
const activityFrame = (session: RegisteredSession): ActivityFrame | null =>
isTerminalEngine(session.engine) ? null : turnActivity.snapshot(session.sessionId) ?? null
return { runtimeActivity, turnActivity, activityFrame }
}
/**
* The working state of each listed agent, as the windows are told it (`activityFrame`): for Agent Messages, which
* tells a shared tab's other accounts. An agent that is not live is left out.
*/
export function activityOf(
agentIds: string[],
byAgent: (agentId: string) => RegisteredSession | undefined,
activityFrame: (session: RegisteredSession) => ActivityFrame | null,
): Record<string, ActivityState> {
const states: Record<string, ActivityState> = {}
for (const agentId of agentIds) {
const session = byAgent(agentId)
if (session) states[agentId] = activityFrame(session)?.state ?? 'unknown'
}
return states
}
export type TurnActivityReaders = ReturnType<typeof createTurnActivity>