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 { describe, expect, it } from 'vitest'
import { applyCommand, commandSchema } from './commands.js'
import { createSuperTab, SuperTabError, type Actor } from './model.js'
import { projectsOf } from './projects.js'
const config = { engine: 'codex', model: 'old', effort: 'high', contextWindow: null, engineVersion: null }
const next = { ...config, engine: 'claude', model: 'sonnet' }
const person: Actor = { kind: 'person', userId: 'owner', email: '[email protected]' }
function fixture() {
let state = createSuperTab('tab', 'Work', { id: 'owner', email: '[email protected]' }, 'prod')
state = applyCommand(state, person, { type: 'agent.add', conversationId: 'lead', machineId: 'machine', harnessId: 'old', name: 'Lead', lead: true, configuration: config },
{ now: 1, operationId: 'add', contribution: { machineOwnerId: 'owner', contributorId: 'owner' } }).state
const member = state.agents[0]!
member.workDecision = 'keep'
state.conversations[0]!.assignment = { id: 'work', agentId: member.id, status: 'working', configuration: config,
execution: { machineId: 'machine', machineOwnerId: 'owner', harnessId: 'old' }, result: null }
const actor: Actor = { kind: 'agent', agentId: member.id, machineOwnerId: 'owner' }
const command = { type: 'agent.rebind', agentId: member.id, machineId: 'machine', projectId: 'lead', previousHarnessId: 'old', harnessId: 'new', configuration: next }
const run = (input = command, who: Actor = actor) => applyCommand(state, who, commandSchema.parse(input), { now: 2, operationId: 'replace' })
return { state, member, actor, command, run }
}
describe('Change agent keeps the Swarm member', () => {
it('moves only terminal and current configuration, preserving the Lead and active assignment', () => {
const f = fixture(), changed = f.run()
expect(changed.state.agents[0]).toMatchObject({ ...f.member, harnessId: 'new', configuration: next, configurationVersion: expect.any(String) })
expect(changed.state.conversations[0]).toMatchObject({ leadId: f.member.id, agentIds: [f.member.id], assignment: {
id: 'work', agentId: f.member.id, status: 'working', configuration: next, execution: { harnessId: 'new' } } })
expect(changed.cancelledAgents).toEqual([])
expect(f.state.agents[0]!.harnessId).toBe('old')
})
it('forgets the grid model the old terminal was started on, since the new one reports its own (review of #1808)', () => {
const f = fixture()
f.state.agents[0]!.gridModel = 'moonshotai/kimi-k3'
expect(f.run().state.agents[0]).not.toHaveProperty('gridModel')
})
it('repeating the same replacement is a no-op and cannot roll back newer configuration', () => {
const f = fixture(), changed = f.run().state
changed.agents[0]!.configuration.model = 'opus'
expect(applyCommand(changed, f.actor, commandSchema.parse(f.command), { now: 3, operationId: 'retry' }).state).toEqual(changed)
})
it.each(['person', 'account', 'machine', 'project', 'old', 'occupied', 'self', 'stopping'])('refuses %s without changing state', kind => {
const f = fixture(), before = structuredClone(f.state)
let who: Actor = f.actor
const command = { ...f.command }
if (kind === 'person') who = person
if (kind === 'account') who = { ...f.actor, machineOwnerId: 'other' } as Actor
if (kind === 'machine') command.machineId = 'other'
if (kind === 'project') {
f.state.projects = [...projectsOf(f.state), { ...projectsOf(f.state)[0]!, id: 'other', leadConversationId: 'other-lead' }]
command.projectId = 'other'
}
if (kind === 'old') command.previousHarnessId = 'other'
if (kind === 'self') command.harnessId = 'old'
if (kind === 'stopping') f.member.workDecision = 'stop'
if (kind === 'occupied') f.state.agents.push({ ...f.member, id: 'another', harnessId: 'new' })
const code = kind === 'account' ? 'FORBIDDEN' : kind === 'project' ? 'NOT_FOUND' : kind === 'occupied' ? 'SESSION_CONTRIBUTED'
: kind === 'old' || kind === 'self' ? 'AGENT_CHANGED' : kind === 'stopping' ? 'STOP_REQUESTED' : 'HOST_REQUIRED'
try { f.run(command, who); expect.fail('A mismatched replacement must be refused') } catch (error) {
expect(error).toBeInstanceOf(SuperTabError)
expect(error).toMatchObject({ code })
}
expect(f.state.agents[0]!.harnessId).toBe(before.agents[0]!.harnessId)
})
// After a rebind the member keeps its old id, so adding its current terminal must find it by machine + harness, not id.
it('finds a rebound session by its current terminal when a person adds it', () => {
const f = fixture(), rebound = f.run().state
const other = applyCommand(rebound, person, { type: 'project.create', name: 'Other', visibility: 'public', brief: '' }, { now: 3, operationId: 'other' })
const chat = (other.result as { conversationId: string }).conversationId
const add = (state: typeof rebound, conversationId: string, machineOwnerId = 'owner') => applyCommand(state, person,
commandSchema.parse({ type: 'agent.add', conversationId, machineId: 'machine', harnessId: 'new', name: 'Lead', lead: false, configuration: next }),
{ now: 4, operationId: 'again', contribution: { machineOwnerId, contributorId: 'owner' } })
expect(() => add(other.state, chat)).toThrow(expect.objectContaining({ code: 'PROJECT_SESSION' }))
expect(() => add(rebound, 'lead', 'someone-else')).toThrow(expect.objectContaining({ code: 'ALREADY_SHARED' }))
expect(other.state.agents).toHaveLength(1)
expect(add(rebound, 'lead').state.agents).toHaveLength(1)
})
})