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 { closeSync, fsyncSync, openSync, renameSync, rmSync, writeFileSync } from 'node:fs'
import { basename, dirname, join } from 'node:path'
import { randomUUID } from 'node:crypto'
import { hardenPrivateStateFileIfPresent, readPrivateStateFile, secureStateDirectory, syncStateDirectory } from '../secureState.js'
const MAX_BYTES = 32 * 1024 * 1024
/** Atomic local transaction: reservations and immutable results survive together.
* Never log content. Corrupt/unwritable state fails closed instead of losing dedupe.
*/
export class DeviceResultJournal {
constructor(private readonly path: string) {}
load(): unknown {
secureStateDirectory(dirname(this.path))
if (!hardenPrivateStateFileIfPresent(this.path, MAX_BYTES)) return undefined
return JSON.parse(readPrivateStateFile(this.path, MAX_BYTES))
}
/** Set this journal aside under [owner] (the machine it was written for) so a fresh one can start,
* replacing an earlier copy set aside for the same owner. Returns the file it was moved to. */
archive(owner: string): string {
const tag = owner.replace(/[^A-Za-z0-9_-]/g, '_').slice(0, 64) || 'unknown'
const target = join(dirname(this.path), `${basename(this.path).replace(/\.json$/, '')}.${tag}.json`)
renameSync(this.path, target)
return target
}
save(value: unknown): void {
secureStateDirectory(dirname(this.path))
hardenPrivateStateFileIfPresent(this.path, MAX_BYTES)
const data = JSON.stringify(value)
if (Buffer.byteLength(data) > MAX_BYTES) throw new Error('Device result journal capacity exceeded')
const temporary = `${this.path}.${randomUUID()}.tmp`
try {
const fd = openSync(temporary, 'wx', 0o600)
try { writeFileSync(fd, data); fsyncSync(fd) } finally { closeSync(fd) }
renameSync(temporary, this.path)
syncStateDirectory(dirname(this.path))
} finally { rmSync(temporary, { force: true }) }
}
}