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 harness answers to the ids it went by: formerly

deecf2d7d4011cf
diff --git a/cli/src/dsh/installed.ts b/cli/src/dsh/installed.ts
index 08b8ebcf3..8831f11f8 100644
--- a/cli/src/dsh/installed.ts
+++ b/cli/src/dsh/installed.ts
@@ -147,6 +147,13 @@ export function listDshState(): { installed: InstalledDsh[]; broken: BrokenDsh[]
return stateNow()
}
+/**
+ * The installed harness for an id — by its own id first, then by a name it went by before
+ * (`formerly` in the manifest): an agent created under the old name keeps its harness, its viewer
+ * and its verdict across a rename instead of falling back to a plain engine.
+ */
export function installedDsh(id: string): InstalledDsh | undefined {
- return stateNow().installed.find((entry) => entry.id === id)
+ const { installed } = stateNow()
+ return installed.find((entry) => entry.id === id)
+ ?? installed.find((entry) => entry.manifest.formerly?.includes(id))
}
diff --git a/cli/src/dsh/manifest.spec.ts b/cli/src/dsh/manifest.spec.ts
index dc68aed26..a98c29fd9 100644
--- a/cli/src/dsh/manifest.spec.ts
+++ b/cli/src/dsh/manifest.spec.ts
@@ -1,7 +1,7 @@
import { describe, expect, it } from 'vitest'
import { readFileSync } from 'node:fs'
import { fileURLToPath } from 'node:url'
-import { dshSkillsDirFor, dshTier, dshVerdictPath, expandDshValue, parseDshManifest, readDshManifest } from './manifest.js'
+import { DshManifestSchema, dshSkillsDirFor, dshTier, dshVerdictPath, expandDshValue, parseDshManifest, readDshManifest } from './manifest.js'
const STARTER = fileURLToPath(new URL('../../../dsh/starter-dsh', import.meta.url))
@@ -67,4 +67,11 @@ describe('dshSkillsDirFor', () => {
expect(dshSkillsDirFor('codex')).toBe('.agents/skills')
expect(dshSkillsDirFor('cursor')).toBe('.agents/skills')
})
+ it('accepts the ids a harness went by before, and only well-formed ones', () => {
+ const base = { spec: 1, id: 'acme/solid', name: 'Solid', engine: 'codex' }
+ expect(DshManifestSchema.safeParse({ ...base, formerly: ['acme/workshop'] }).success).toBe(true)
+ expect(DshManifestSchema.safeParse({ ...base, formerly: ['Not An Id'] }).success).toBe(false)
+ expect(DshManifestSchema.safeParse({ ...base, formerly: Array(9).fill('acme/x') }).success).toBe(false)
+ })
+
})
diff --git a/cli/src/dsh/manifest.ts b/cli/src/dsh/manifest.ts
index 3fad5416e..7c3eb9c6c 100644
--- a/cli/src/dsh/manifest.ts
+++ b/cli/src/dsh/manifest.ts
@@ -36,6 +36,8 @@ export const DshManifestSchema = z.strictObject({
description: z.string().max(300).optional(),
/** The one- or two-word kind of thing it makes — "PCB", "3D design", "Slides" — the picker's second line. */
category: z.string().min(1).max(24).optional(),
+ /** Ids this harness answered to before: an agent created under one keeps its harness across a rename. */
+ formerly: z.array(z.string().regex(DSH_ID_RE)).max(8).optional(),
engine: z.enum(ENGINES),
workspace: z.strictObject({
template: relativePath.optional(),
diff --git a/dsh/spec/CHANGES.md b/dsh/spec/CHANGES.md
index 968322117..e663e07ae 100644
--- a/dsh/spec/CHANGES.md
+++ b/dsh/spec/CHANGES.md
@@ -20,6 +20,7 @@ Initial contract. Lifted from the `.board.json` (Circuit) and `.episode.json` (T
in a word or two — "PCB", "3D design", "Slides". `dsh_list` forwards it; the picker shows it under
the name, the way every engine now shows "Code". The first-party ids are `autonomous/copper`
(Circuit's pipeline) and `autonomous/solid` (Workshop's Make stage); `autonomous/marp` is unchanged.
-- **Backward compatible:** `category` is optional. The old ids are not aliased: an agent created as
- `autonomous/circuit` or `autonomous/workshop` before this change draws by its name and loses its
- viewer on the next daemon start.
+- **Backward compatible:** `category` is optional. Manifests may list the ids they went by in
+ `formerly` (≤ 8); the daemon resolves an agent's `HARNESS_DSH` through it, so an agent created as
+ `autonomous/circuit` or `autonomous/workshop` keeps its harness, viewer and verdict after the
+ rename. Without it, such an agent draws by its name and runs as its plain engine.
diff --git a/dsh/spec/schema/harness.schema.json b/dsh/spec/schema/harness.schema.json
index 22ada8c0b..bbcbb1495 100644
--- a/dsh/spec/schema/harness.schema.json
+++ b/dsh/spec/schema/harness.schema.json
@@ -35,6 +35,15 @@
"maxLength": 24,
"description": "The kind of thing it makes, in a word or two \u2014 PCB, 3D design, Slides. The picker's second line under the name."
},
+ "formerly": {
+ "type": "array",
+ "maxItems": 8,
+ "items": {
+ "type": "string",
+ "pattern": "^[a-z0-9-]+/[a-z0-9-]+$"
+ },
+ "description": "Ids this harness answered to before. An agent created under one keeps its harness across a rename."
+ },
"engine": {
"type": "string",
"description": "The base engine this harness runs on: claude, codex, cursor, \u2026 (one of the CLI's ENGINES)."