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.

fix(security): remove browser setup links (OH-2, part of OH-4) (#348)

0xken158488f7138e65
diff --git a/cli/src/backendSocket.spec.ts b/cli/src/backendSocket.spec.ts
index d18cd5672..b56f5423e 100644
--- a/cli/src/backendSocket.spec.ts
+++ b/cli/src/backendSocket.spec.ts
@@ -435,14 +435,14 @@ describe('BackendSocket outbound queue', () => {
ws.open()
const frame = {
- type: 'e2e_setup_claim',
- payload: { requestId: 'setup-1', token: 'signed-setup-token' },
+ type: 'e2e_status',
+ payload: { requestId: 'status-1' },
}
ws.message({ t: 'down', connId: 'web-1', frame })
await vi.waitFor(() => expect(handle).toHaveBeenCalledWith('web-1', frame))
expect(parseSent(ws).some((item) =>
- (item.frame as { type?: string } | undefined)?.type === 'e2e_setup_claim_result',
+ (item.frame as { type?: string } | undefined)?.type === 'e2e_status_result',
)).toBe(false)
await socket.stop()
})
@@ -2571,6 +2571,12 @@ describe('relay down-frames are default-deny: sealed, or the backend\'s own', ()
expect(warn.mock.calls.flat().join(' ')).not.toContain('\n2026')
})
+ it('answers a sealed e2ee_browser_link_create UNSUPPORTED — setup links are gone', async () => {
+ const { socket, replies, dispatch } = harness()
+ await dispatch(sealedDown(socket, 'web-1', 'e2ee_browser_link_create', { requestId: 'r' }).frame, 'web-1')
+ expect(replies).toEqual([{ connId: 'web-1', type: 'e2ee_browser_link_create', payload: { error: 'UNSUPPORTED' } }])
+ })
+
it('leaves trusted local clients in cleartext', async () => {
const { socket, dispatch } = harness()
const onMessage = vi.fn()
diff --git a/cli/src/backendSocket.ts b/cli/src/backendSocket.ts
index f49b1155f..9c8d9637e 100644
--- a/cli/src/backendSocket.ts
+++ b/cli/src/backendSocket.ts
@@ -776,9 +776,6 @@ export class BackendSocket {
e2eeFingerprint(): string {
return this.e2ee.fingerprint()
}
- createSetupToken(): ReturnType<E2eeManager['createSetupToken']> {
- return this.e2ee.createSetupToken()
- }
/** `harness pairings` — list paired clients. */
listPairs(): ReturnType<E2eeManager['listPaired']> {
return this.e2ee.listPaired()
@@ -1701,12 +1698,6 @@ export class BackendSocket {
this.e2ee.revokeAllFromTrustedWeb(connId, requestId)
return
- case 'e2ee_browser_link_create': {
- const setup = this.e2ee.createSetupToken()
- reply(type, requestId, setup)
- return
- }
-
case 'agents_list': {
const projects = await Promise.all(registry.advertised().map((s) => this.toProject(s)))
// Older clients/devices keep their live-only contract. The desktop picker
diff --git a/cli/src/cli.ts b/cli/src/cli.ts
index e8592e346..663903944 100644
--- a/cli/src/cli.ts
+++ b/cli/src/cli.ts
@@ -397,7 +397,6 @@ ${dshUsage()}
${apiUsage}
Browser end-to-end encryption:
- harness browser-link print a reusable 7-day setup link for browsers
harness autonomous-device <command> pair/status/list/revoke an Autonomous device
harness pair <code> pair a BROWSER (code shown on the machine page)
harness pairings list paired clients
@@ -526,19 +525,6 @@ function computerId(): string {
function backendHttpBase(): string {
return env.BACKEND_WS_URL.replace(/\/$/, '').replace(/^wss:/, 'https:').replace(/^ws:/, 'http:')
}
-function webBase(): string {
- return env.WEB_URL.replace(/\/$/, '')
-}
-function createSetupToken(machineId?: string): { token: string; expiresAt: number; fingerprint: string } {
- const store = new E2eeStore()
- store.init()
- return store.createSetupToken(machineId)
-}
-function setupBrowserLink(machineId: string, token: string): string {
- const u = new URL(`${webBase()}/machine/${machineId}`)
- u.hash = `setup=browser&t=${encodeURIComponent(token)}`
- return u.toString()
-}
/** One control-plane call, returning the backend's `data` envelope; throws on a non-2xx / bad body.
* `signal` lets a caller bound the request — a bare `fetch` that accepts the TCP handshake and then
@@ -3928,10 +3914,6 @@ async function runForeground(session: AuthSession | null): Promise<void> {
}
return { status: codeMap[r.error] ?? 400, body: { error: r.error } }
},
- onSetupLink: () => {
- const r = backend.createSetupToken()
- return { status: 200, body: { url: setupBrowserLink(backend.machineId, r.token), expiresAt: r.expiresAt, fingerprint: r.fingerprint } }
- },
onListPairs: () => ({ status: 200, body: { pairs: backend.listPairs() } }),
onRevoke: (id) => {
const r = backend.revoke(id)
@@ -6386,33 +6368,6 @@ async function pairCommand(code: string | undefined): Promise<void> {
process.exit(1)
}
-/** `harness browser-link` — print a reusable 7-day browser setup link for the current machine. */
-async function browserLinkCommand(): Promise<void> {
- const session = readAuthSession()
- if (!session?.machineId) { console.error('\n ✗ This computer is not signed in. Run: harness login\n'); process.exit(1) }
- const agentId = session.machineId
- let url = ''
- try {
- const res = await fetch(`http://127.0.0.1:${daemonPort()}/api/e2ee/setup-link`, {
- method: 'POST',
- headers: { 'x-adapter-local': '1' },
- })
- if (res.ok) {
- const body = (await res.json().catch(() => null)) as { url?: unknown; expiresAt?: unknown; fingerprint?: unknown } | null
- if (typeof body?.url === 'string') url = body.url
- }
- } catch { /* fall back to disk-backed token below */ }
- if (!url) {
- const setup = createSetupToken(agentId)
- url = setupBrowserLink(agentId, setup.token)
- }
- console.log('\n Reusable browser setup link (valid for 7 days):\n')
- console.log(` ${url}\n`)
- console.log(' Anyone with this link can pair a browser until it expires. Keep it private.\n')
- if (!readPid()) console.log(' Start the adapter with `harness start` if the browser cannot connect.\n')
- process.exit(0)
-}
-
/** `harness pairings` — list the browsers paired for end-to-end encryption. */
async function pairingsCommand(): Promise<void> {
const { res, json } = await daemonCall('GET', '/api/pairs')
@@ -6519,9 +6474,8 @@ function promptPassword(prompt: string): Promise<string> {
* shared secret `harness link connect <machineId>` on another machine proves knowledge of, to link
* to this one. Not single-use and does not expire — stays valid until explicitly changed/cleared.
* Prefers the running daemon (so an in-progress `link connect` from elsewhere sees it immediately);
- * falls back to writing the disk-backed store directly when no daemon is running, same fallback
- * shape as `browserLinkCommand`. `--stdin` reads one line with no confirmation (for scripts/GUIs);
- * interactively it prompts twice (masked) and requires the two to match. */
+ * falls back to writing the disk-backed store directly when no daemon is running. `--stdin` reads
+ * one line with no confirmation (for scripts/GUIs); interactively it prompts twice (masked) and requires the two to match. */
async function remotePasswordSetCommand(json: boolean, stdin: boolean): Promise<void> {
const session = readAuthSession()
if (!session?.machineId) {
@@ -7130,12 +7084,11 @@ switch (cmd) {
pairCommand(args[0]).catch(onError)
break
case 'browser-link':
- browserLinkCommand().catch(onError)
- break
case 'e2ee-link':
- console.error('(note: "harness e2ee-link" is deprecated — use "harness browser-link")')
- browserLinkCommand().catch(onError)
- break
+ // Browser setup links served the retired web client. Said plainly rather than falling to "unknown
+ // command", for anyone following an old doc.
+ console.error(`\n ✗ harness ${cmd} was removed: the web client is retired. Use the desktop or phone app.\n`)
+ process.exit(1)
case 'pairings':
pairingsCommand().catch(onError)
break
diff --git a/cli/src/hookServer.spec.ts b/cli/src/hookServer.spec.ts
index f9b3a1c8a..17d205e6f 100644
--- a/cli/src/hookServer.spec.ts
+++ b/cli/src/hookServer.spec.ts
@@ -318,3 +318,13 @@ describe('/api/status', () => {
expect(await response.json()).toEqual({ pid: process.pid, connected: false, restarting: false, discoveryReady: true })
})
})
+
+describe('browser setup links are gone', () => {
+ // They served the retired web client; the route that minted them must not come back.
+ it('mints nothing at the old /api/e2ee/setup-link route', async () => {
+ const { base } = await start()
+ const response = await fetch(`${base}/api/e2ee/setup-link`, { method: 'POST', headers: { 'x-adapter-local': '1' } })
+ expect(response.status).not.toBe(200)
+ expect(await response.text()).not.toContain('setup=browser')
+ })
+})
diff --git a/cli/src/hookServer.ts b/cli/src/hookServer.ts
index d196f67e5..6cc458872 100644
--- a/cli/src/hookServer.ts
+++ b/cli/src/hookServer.ts
@@ -95,8 +95,6 @@ export interface HookServerHandlers {
}) => void
/** `harness pair <code>` from a second CLI process: run CPace toward the waiting browser. */
onPair?: (code: string) => Promise<PairOutcome>
- /** `adapter browser-link` — mint a setup-link token from the running daemon. */
- onSetupLink?: () => PairOutcome
/** `harness pairings` — list E2EE-paired browsers. */
onListPairs?: () => PairOutcome
/** `harness unpair <id>` — unpair one browser (by fingerprint/prefix/index). */
@@ -606,14 +604,6 @@ export function startHookServer(
return
}
- // `harness browser-link` → mint a reusable 7-day setup token using the running daemon's E2EE
- // identity. The signed token is self-contained, so it remains valid across daemon restarts.
- if (req.method === 'POST' && url === '/api/e2ee/setup-link') {
- if (!localOk) { json(403, { error: 'FORBIDDEN' }); return }
- if (!handlers.onSetupLink) { json(503, { error: 'UNAVAILABLE' }); return }
- const out = handlers.onSetupLink(); json(out.status, out.body); return
- }
-
// `harness remote-password set` → stretch + persist a new persistent remote password on the
// running daemon's live E2EE state (so an in-progress `harness link connect` from another
// machine sees it immediately, with no daemon restart needed).
diff --git a/cli/src/lib/e2ee/manager.test.ts b/cli/src/lib/e2ee/manager.test.ts
index 37a75f5b3..1c7ce981d 100644
--- a/cli/src/lib/e2ee/manager.test.ts
+++ b/cli/src/lib/e2ee/manager.test.ts
@@ -182,69 +182,12 @@ async function fullPair(h: ReturnType<typeof machine>, conn: string): Promise<We
}
describe('E2eeManager pairing', () => {
- it('setup-link claim auto-pairs the browser, then hello establishes a session', () => {
- const h = machine()
+ it('pairs nobody from an e2e_setup_claim — browser setup links were removed with the web client', () => {
+ const { mgr, sent } = machine()
const web = new WebPeer()
- const conn = 'setup1'
- const setup = h.mgr.createSetupToken()
- const claim = {
- type: 'e2e_setup_claim',
- payload: {
- requestId: 'setup-r1',
- token: setup.token,
- identityPub: C.b64e(web.identity.pub),
- label: 'Chrome · macOS',
- sig: C.b64e(C.setupClaimSig(web.identity.priv, AGENT, setup.token, web.identity.pub)),
- },
- }
-
- h.mgr.handleFrame(conn, claim)
- const result = h.lastFor(conn, 'e2e_setup_claim_result')!.payload as Record<string, unknown>
- expect(result).toMatchObject({ ok: true, requestId: 'setup-r1', fingerprint: h.mgr.fingerprint() })
- expect(h.mgr.listPaired()[0].fingerprint).toBe(C.fingerprint(web.identity.pub))
-
- h.mgr.handleFrame(conn, web.hello())
- web.adapterPub = C.b64d(C.verifySetupToken(setup.token)!.payload.pub)
- web.onWelcome(h.lastFor(conn, 'e2e_welcome')!, web.adapterPub)
- expect(h.mgr.hasSession(conn)).toBe(true)
- })
-
- it('one setup link pairs multiple browsers and establishes an E2EE session for each', () => {
- const h = machine()
- const web1 = new WebPeer()
- const web2 = new WebPeer()
- const setup = h.mgr.createSetupToken()
- h.mgr.handleFrame('setup-a', {
- type: 'e2e_setup_claim',
- payload: {
- requestId: 'a',
- token: setup.token,
- identityPub: C.b64e(web1.identity.pub),
- label: 'Chrome',
- sig: C.b64e(C.setupClaimSig(web1.identity.priv, AGENT, setup.token, web1.identity.pub)),
- },
- })
- h.mgr.handleFrame('setup-b', {
- type: 'e2e_setup_claim',
- payload: {
- requestId: 'b',
- token: setup.token,
- identityPub: C.b64e(web2.identity.pub),
- label: 'Firefox',
- sig: C.b64e(C.setupClaimSig(web2.identity.priv, AGENT, setup.token, web2.identity.pub)),
- },
- })
- expect(h.lastFor('setup-a', 'e2e_setup_claim_result')!.payload).toMatchObject({ ok: true })
- expect(h.lastFor('setup-b', 'e2e_setup_claim_result')!.payload).toMatchObject({ ok: true })
- expect(h.mgr.listPaired().length).toBe(2)
-
- const adapterPub = C.b64d(C.verifySetupToken(setup.token)!.payload.pub)
- h.mgr.handleFrame('setup-a', web1.hello())
- web1.onWelcome(h.lastFor('setup-a', 'e2e_welcome')!, adapterPub)
- h.mgr.handleFrame('setup-b', web2.hello())
- web2.onWelcome(h.lastFor('setup-b', 'e2e_welcome')!, adapterPub)
- expect(h.mgr.hasSession('setup-a')).toBe(true)
- expect(h.mgr.hasSession('setup-b')).toBe(true)
+ mgr.handleFrame('claim-1', { type: 'e2e_setup_claim', payload: { requestId: 'r', token: 'x', identityPub: C.b64e(web.identity.pub), sig: 'x' } })
+ expect(mgr.listPaired()).toEqual([])
+ expect(sent.some((s) => s.frame.type === 'e2e_setup_claim_result')).toBe(false)
})
it('completes a full pairing, pins the browser, and establishes a session + group key', async () => {
diff --git a/cli/src/lib/e2ee/manager.ts b/cli/src/lib/e2ee/manager.ts
index 4e41df336..b24a85e7d 100644
--- a/cli/src/lib/e2ee/manager.ts
+++ b/cli/src/lib/e2ee/manager.ts
@@ -135,9 +135,6 @@ export class E2eeManager {
}
fingerprint(): string { return this.store.fingerprint() }
- createSetupToken(machineId = this.deps.machineId): { token: string; expiresAt: number; fingerprint: string } {
- return this.store.createSetupToken(machineId)
- }
// ── persistent remote password (`harness remote-password set|clear|status`) ──────────────────────
setRemotePassword(password: string): Promise<{ fingerprint: string }> {
@@ -376,7 +373,6 @@ export class E2eeManager {
const payload = (frame.payload ?? {}) as Record<string, unknown>
switch (type) {
case 'e2e_status': return this.onStatus(connId, payload)
- case 'e2e_setup_claim': return this.onSetupClaim(connId, payload)
case 'e2e_pair_intent': return this.onPairIntent(connId, payload)
case 'e2e_pair_cancel': return this.onPairCancel(connId, payload)
case 'e2e_pake': return this.onPake(connId, payload)
@@ -496,25 +492,6 @@ export class E2eeManager {
if (reply) this.deps.sendTo(connId, reply)
}
- private onSetupClaim(connId: string, p: Record<string, unknown>): boolean {
- const requestId = p.requestId
- const token = typeof p.token === 'string' ? p.token : ''
- const identityPub = typeof p.identityPub === 'string' ? p.identityPub : ''
- const sig = typeof p.sig === 'string' ? p.sig : ''
- const label = typeof p.label === 'string' ? p.label.slice(0, 60) : 'browser'
- const fail = (error: string): void => {
- this.deps.sendTo(connId, { type: 'e2e_setup_claim_result', payload: { requestId, error } })
- }
- if (!token || !identityPub || !sig) { fail('BAD_CLAIM'); return true }
- const validated = this.store.validateSetupToken(token, this.deps.machineId)
- if (!validated.ok) { fail(validated.error); return true }
- const pub = C.b64d(identityPub)
- if (!C.setupClaimVerify(pub, this.deps.machineId, token, C.b64d(sig))) { fail('BAD_SIG'); return true }
- this.store.addPaired(identityPub, label, this.now(), 'web')
- this.deps.sendTo(connId, { type: 'e2e_setup_claim_result', payload: { requestId, ok: true, fingerprint: validated.fingerprint } })
- return true
- }
-
/** Called by the hook server when the user runs `harness pair <code>`. Resolves when done/failed. */
onPair(code: string): Promise<PairResult> {
return new Promise<PairResult>((resolve) => {
diff --git a/cli/src/lib/e2ee/setup-link.spec.ts b/cli/src/lib/e2ee/setup-link.spec.ts
deleted file mode 100644
index 596d00176..000000000
--- a/cli/src/lib/e2ee/setup-link.spec.ts
+++ /dev/null
@@ -1,242 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
-import { mkdtempSync, rmSync, writeFileSync } from 'fs'
-import { tmpdir } from 'os'
-import { join } from 'path'
-
-const AGENT = 'f2e0383771b734e4fc00f0bc8ccf060f'
-
-let dataDir = ''
-
-beforeEach(() => {
- dataDir = mkdtempSync(join(tmpdir(), 'e2ee-setup-'))
- process.env.ADAPTER_DATA_DIR = dataDir
- vi.resetModules()
-})
-
-afterEach(() => {
- rmSync(dataDir, { recursive: true, force: true })
- delete process.env.ADAPTER_DATA_DIR
-})
-
-async function loadE2ee() {
- const C = await import('./core.js')
- const { E2eeStore } = await import('./store.js')
- const { E2eeManager } = await import('./manager.js')
- return { C, E2eeStore, E2eeManager }
-}
-
-describe('E2EE setup links', () => {
- it('keeps signed setup tokens reusable without persisted nonce state', async () => {
- const { C, E2eeStore } = await loadE2ee()
- const store = new E2eeStore()
- store.init()
- const setup = store.createSetupToken(AGENT)
-
- expect(C.verifySetupToken(setup.token, Date.now(), AGENT)?.payload.machineId).toBe(AGENT)
- expect(store.validateSetupToken(setup.token, AGENT)).toMatchObject({ ok: true, fingerprint: setup.fingerprint })
- expect(store.validateSetupToken(setup.token, AGENT)).toMatchObject({ ok: true, fingerprint: setup.fingerprint })
-
- // Simulate a pre-upgrade build that already consumed this token and persisted an empty nonce list.
- // A fresh post-upgrade store must still accept the signed, unexpired link.
- writeFileSync(join(dataDir, 'e2e', 'setup-nonces.json'), '[]')
- const afterUpgrade = new E2eeStore()
- afterUpgrade.init()
- expect(afterUpgrade.validateSetupToken(setup.token, AGENT)).toMatchObject({ ok: true, fingerprint: setup.fingerprint })
- })
-
- it('keeps every generated link valid until its signed expiry', async () => {
- const { C, E2eeStore } = await loadE2ee()
- const store = new E2eeStore()
- store.init()
- const first = store.createSetupToken(AGENT)
- const second = store.createSetupToken(AGENT)
- const expired = store.createSetupToken(AGENT, -1)
- const foreign = C.newIdentity()
- const foreignToken = C.encodeSetupToken({
- v: 1,
- typ: 'adapter-e2ee-setup',
- pub: C.b64e(foreign.pub),
- nonce: 'foreign-adapter',
- exp: Date.now() + 60_000,
- machineId: AGENT,
- }, foreign.priv)
- const tampered = `${first.token.slice(0, -1)}${first.token.endsWith('A') ? 'B' : 'A'}`
-
- expect(store.validateSetupToken(first.token, AGENT).ok).toBe(true)
- expect(store.validateSetupToken(second.token, AGENT).ok).toBe(true)
- expect(store.validateSetupToken(expired.token, AGENT)).toEqual({ ok: false, error: 'BAD_TOKEN' })
- expect(store.validateSetupToken(first.token, '00000000000000000000000000000000')).toEqual({ ok: false, error: 'BAD_TOKEN' })
- expect(store.validateSetupToken(foreignToken, AGENT)).toEqual({ ok: false, error: 'WRONG_ADAPTER' })
- expect(store.validateSetupToken(tampered, AGENT)).toEqual({ ok: false, error: 'BAD_TOKEN' })
- })
-
- it('auto-pairs multiple browser identities from the same setup link', async () => {
- const { C, E2eeManager } = await loadE2ee()
- const sent: Array<{ connId: string; frame: Record<string, unknown> }> = []
- const mgr = new E2eeManager({
- machineId: AGENT,
- sendTo: (connId, frame) => sent.push({ connId, frame }),
- isConnected: () => true,
- })
- const web1 = C.newIdentity()
- const web2 = C.newIdentity()
- const setup = mgr.createSetupToken()
-
- mgr.handleFrame('a', {
- type: 'e2e_setup_claim',
- payload: {
- requestId: 'r1',
- token: setup.token,
- identityPub: C.b64e(web1.pub),
- label: 'Chrome',
- sig: C.b64e(C.setupClaimSig(web1.priv, AGENT, setup.token, web1.pub)),
- },
- })
- expect(sent.at(-1)?.frame.payload).toMatchObject({ requestId: 'r1', ok: true, fingerprint: setup.fingerprint })
- expect(mgr.listPaired()).toHaveLength(1)
- expect(mgr.listPaired()[0].fingerprint).toBe(C.fingerprint(web1.pub))
-
- mgr.handleFrame('b', {
- type: 'e2e_setup_claim',
- payload: {
- requestId: 'r2',
- token: setup.token,
- identityPub: C.b64e(web2.pub),
- label: 'Firefox',
- sig: C.b64e(C.setupClaimSig(web2.priv, AGENT, setup.token, web2.pub)),
- },
- })
- expect(sent.at(-1)?.frame.payload).toMatchObject({ requestId: 'r2', ok: true, fingerprint: setup.fingerprint })
- expect(mgr.listPaired()).toHaveLength(2)
- expect(mgr.listPaired().map((p) => p.fingerprint)).toEqual(expect.arrayContaining([
- C.fingerprint(web1.pub),
- C.fingerprint(web2.pub),
- ]))
- })
-})
-
-describe('trusted web device pairing', () => {
- it('notifies every trusted web session when a device pairing intent appears', async () => {
- const { C, E2eeManager } = await loadE2ee()
- const sent: Array<{ connId: string; frame: Record<string, unknown> }> = []
- const userSent: Array<Record<string, unknown>> = []
- const mgr = new E2eeManager({
- machineId: AGENT,
- sendTo: (connId, frame) => sent.push({ connId, frame }),
- sendUser: (frame) => userSent.push(frame),
- isConnected: () => true,
- })
- const key = new Uint8Array(32).fill(7)
- ;(mgr as unknown as { sessions: Map<string, unknown> }).sessions.set('web1', { webIdentityPub: 'w1', role: 'web', c2s: key, s2c: key, s2cCounter: 1, c2sRecv: -1 })
- ;(mgr as unknown as { sessions: Map<string, unknown> }).sessions.set('web2', { webIdentityPub: 'w2', role: 'web', c2s: key, s2c: key, s2cCounter: 1, c2sRecv: -1 })
- ;(mgr as unknown as { sessions: Map<string, unknown> }).sessions.set('device1', { webIdentityPub: 'd1', role: 'device', c2s: key, s2c: key, s2cCounter: 1, c2sRecv: -1 })
-
- mgr.handleFrame('device-conn', {
- type: 'e2e_pair_intent',
- payload: { requestId: 'intent', pairId: C.b64e(C.newPairId()), label: 'Device', role: 'device' },
- })
-
- const pending = sent.filter((s) => s.frame.type === 'device_e2ee_pair_pending')
- expect(pending.map((s) => s.connId).sort()).toEqual(['web1', 'web2'])
- expect(pending.every((s) => C.isWrapped(s.frame.payload))).toBe(true)
- expect(sent.some((s) => s.connId === 'device1' && s.frame.type === 'device_e2ee_pair_pending')).toBe(false)
- expect(userSent).toHaveLength(1)
- expect(userSent[0]).toMatchObject({
- type: 'device_e2ee_pair_pending',
- payload: { machineId: AGENT, label: 'Device' },
- })
- })
-
- it('rejects stale trusted-web device pair requests without starting CPace', async () => {
- const { C, E2eeManager } = await loadE2ee()
- const sent: Array<{ connId: string; frame: Record<string, unknown> }> = []
- const mgr = new E2eeManager({
- machineId: AGENT,
- sendTo: (connId, frame) => sent.push({ connId, frame }),
- isConnected: () => true,
- })
- const key = new Uint8Array(32).fill(9)
- ;(mgr as unknown as { sessions: Map<string, unknown> }).sessions.set('web1', { webIdentityPub: 'w1', role: 'web', c2s: key, s2c: key, s2cCounter: 1, c2sRecv: -1 })
- mgr.handleFrame('device-conn', {
- type: 'e2e_pair_intent',
- payload: { requestId: 'intent', pairId: C.b64e(C.newPairId()), label: 'Device', role: 'device' },
- })
-
- await mgr.pairDeviceFromTrustedWeb('web1', { requestId: 'pair', pairId: 'old-pair', code: 'ABC123' })
-
- const result = sent.find((s) => s.connId === 'web1' && s.frame.type === 'device_e2ee_pair_result')
- expect(result?.frame.payload).toBeTruthy()
- expect(C.isWrapped(result?.frame.payload)).toBe(true)
- const opened = C.unwrapPayload(key, (result!.frame.payload as { __e2e: never }).__e2e, 'device_e2ee_pair_result', undefined) as { requestId?: string; error?: string } | null
- expect(opened).toMatchObject({ requestId: 'pair', error: 'STALE_PAIR' })
- })
-
- it('clears trusted web popups when the device cancels pairing', async () => {
- const { C, E2eeManager } = await loadE2ee()
- const sent: Array<{ connId: string; frame: Record<string, unknown> }> = []
- const userSent: Array<Record<string, unknown>> = []
- const mgr = new E2eeManager({
- machineId: AGENT,
- sendTo: (connId, frame) => sent.push({ connId, frame }),
- sendUser: (frame) => userSent.push(frame),
- isConnected: () => true,
- })
- const key = new Uint8Array(32).fill(11)
- ;(mgr as unknown as { sessions: Map<string, unknown> }).sessions.set('web1', { webIdentityPub: 'w1', role: 'web', c2s: key, s2c: key, s2cCounter: 1, c2sRecv: -1 })
- const pairId = C.b64e(C.newPairId())
- mgr.handleFrame('device-conn', {
- type: 'e2e_pair_intent',
- payload: { requestId: 'intent', pairId, label: 'Device', role: 'device' },
- })
-
- mgr.handleFrame('device-conn', { type: 'e2e_pair_cancel', payload: { pairId } })
-
- expect(mgr.pendingPair()).toBeNull()
- const cleared = sent.find((s) => s.connId === 'web1' && s.frame.type === 'device_e2ee_pair_cleared')
- expect(C.isWrapped(cleared?.frame.payload)).toBe(true)
- const opened = C.unwrapPayload(key, (cleared!.frame.payload as { __e2e: never }).__e2e, 'device_e2ee_pair_cleared', undefined) as { pairId?: string; result?: string } | null
- expect(opened).toMatchObject({ pairId, result: 'cancelled' })
- expect(userSent.at(-1)).toMatchObject({
- type: 'device_e2ee_pair_cleared',
- payload: { machineId: AGENT, pairId, result: 'cancelled' },
- })
- })
-})
-
-describe('trusted web pairing management', () => {
- it('marks the requesting browser and sends encrypted unpair result before revoking it', async () => {
- const { C, E2eeManager } = await loadE2ee()
- const sent: Array<{ connId: string; frame: Record<string, unknown> }> = []
- const mgr = new E2eeManager({
- machineId: AGENT,
- sendTo: (connId, frame) => sent.push({ connId, frame }),
- isConnected: () => true,
- })
- const web = C.newIdentity()
- const setup = mgr.createSetupToken()
- mgr.handleFrame('setup', {
- type: 'e2e_setup_claim',
- payload: {
- requestId: 'setup',
- token: setup.token,
- identityPub: C.b64e(web.pub),
- label: 'Chrome',
- sig: C.b64e(C.setupClaimSig(web.priv, AGENT, setup.token, web.pub)),
- },
- })
-
- const key = new Uint8Array(32).fill(13)
- ;(mgr as unknown as { sessions: Map<string, unknown> }).sessions.set('web1', { webIdentityPub: C.b64e(web.pub), role: 'web', c2s: key, s2c: key, s2cCounter: 1, c2sRecv: -1 })
- const current = mgr.listPaired('web1')[0]
- expect(current.current).toBe(true)
-
- mgr.revokeFromTrustedWeb('web1', { requestId: 'revoke', selector: current.fingerprint })
-
- const result = sent.find((s) => s.connId === 'web1' && s.frame.type === 'e2ee_pairing_unpair_result')
- expect(C.isWrapped(result?.frame.payload)).toBe(true)
- const opened = C.unwrapPayload(key, (result!.frame.payload as { __e2e: never }).__e2e, 'e2ee_pairing_unpair_result', undefined) as { requestId?: string; ok?: boolean; fingerprint?: string } | null
- expect(opened).toMatchObject({ requestId: 'revoke', ok: true, fingerprint: current.fingerprint })
- expect(sent.some((s) => s.connId === 'web1' && s.frame.type === 'e2e_denied')).toBe(true)
- expect(mgr.listPaired()).toHaveLength(0)
- })
-})
diff --git a/cli/src/lib/e2ee/store.ts b/cli/src/lib/e2ee/store.ts
index e185f37e3..591c4aec3 100644
--- a/cli/src/lib/e2ee/store.ts
+++ b/cli/src/lib/e2ee/store.ts
@@ -7,14 +7,13 @@
import { mkdirSync, readFileSync, rmSync, writeFileSync } from 'fs'
import { join } from 'path'
import { env } from '../../config/env.js'
-import { newIdentity, newPairId, b64e, b64d, fingerprint, encodeSetupToken, verifySetupToken, type Identity, type PairRole } from './core.js'
+import { newIdentity, newPairId, b64e, b64d, fingerprint, type Identity, type PairRole } from './core.js'
import { stretchPassword } from './passwordPake.js'
const DIR = join(env.ADAPTER_DATA_DIR, 'e2e')
const IDENTITY_FILE = join(DIR, 'identity.json')
const PAIRED_FILE = join(DIR, 'paired.json')
const REMOTE_PASSWORD_FILE = join(DIR, 'remotePassword.json')
-const SETUP_TTL_MS = 7 * 24 * 60 * 60 * 1000
// Remote-password lockout tuning (anti online-guessing for a reusable, human-memorable secret — see
// notePwFailure()/pwLockedUntil()). Distinct regime from the live pairing code's RATE_MAX=3/5min in
@@ -128,30 +127,10 @@ export class E2eeStore {
return this.paired.size
}
- createSetupToken(machineId?: string, ttlMs = SETUP_TTL_MS): { token: string; expiresAt: number; fingerprint: string } {
- const id = this.getIdentity()
- const nonce = b64e(newPairId()).replace(/=+$/g, '')
- const expiresAt = Date.now() + ttlMs
- const payload = { v: 1 as const, typ: 'adapter-e2ee-setup' as const, pub: b64e(id.pub), nonce, exp: expiresAt, ...(machineId ? { machineId } : {}) }
- return { token: encodeSetupToken(payload, id.priv), expiresAt, fingerprint: this.fingerprint() }
- }
-
- /** Validate a reusable setup link. The signed token is the capability: successful claims never
- * consume server-side state, so the same unexpired link can pair multiple browser identities —
- * including a link whose nonce was consumed by an older one-time build before an upgrade. */
- validateSetupToken(token: string, expectedMachineId?: string): { ok: true; fingerprint: string } | { ok: false; error: 'BAD_TOKEN' | 'WRONG_ADAPTER' } {
- const id = this.getIdentity()
- const verified = verifySetupToken(token, Date.now(), expectedMachineId)
- if (!verified) return { ok: false, error: 'BAD_TOKEN' }
- if (b64e(id.pub) !== verified.payload.pub) return { ok: false, error: 'WRONG_ADAPTER' }
- return { ok: true, fingerprint: this.fingerprint() }
- }
-
// ── persistent remote password (machine-to-machine `harness link connect`) ───────────────────────
- // A fourth, separate trust primitive from the three above: not a browser pairing (paired.json), not
- // a one-time signed token (createSetupToken), and not the live 6-char CPace code — see
- // passwordPake.ts for why this needs its own domain-separated CPace generator, and manager.ts's
- // onPwPairIntent/onPwPake for the state machine that consumes remotePasswordVerifier()/
+ // A separate trust primitive from the ones above: not a pairing (paired.json) and not the live 6-char
+ // CPace code — see passwordPake.ts for why this needs its own domain-separated CPace generator, and
+ // manager.ts's onPwPairIntent/onPwPake for the state machine that consumes remotePasswordVerifier()/
// notePwFailure()/notePwSuccess() below.
/** Stretch + persist a new remote password (0600, same convention as identity.json/paired.json).
diff --git a/cli/src/webui.ts b/cli/src/webui.ts
index aa130856d..3669d8b1c 100644
--- a/cli/src/webui.ts
+++ b/cli/src/webui.ts
@@ -91,8 +91,6 @@ export const LOCAL_WEB_HTML = /* html */ `<!doctype html>
</div>
<div class="bar" style="margin-top:10px;">
<span class="mut">machine fingerprint</span> <span id="fp" class="fp">—</span>
- <span class="spacer"></span>
- <a id="weblink" href="#" target="_blank" rel="noreferrer">open in web ↗</a>
</div>
<div id="pending"></div>
@@ -128,10 +126,6 @@ let lastStatus = null; // last /api/status snapshot (for closeModal to re-rend
// clicks in their own browser (loopback), never through the backend — so CPace security is preserved.
const params = new URLSearchParams(location.search);
const urlCode = (params.get('code') || '').toUpperCase();
-const setupMode = params.get('setup') === 'browser';
-let setupModalOpen = false;
-let setupInFlight = false;
-let setupAutoAttempted = false;
function esc(s){ return String(s==null?'':s).replace(/[&<>"']/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c])); }
function toast(m){ const t=document.getElementById('toast'); t.textContent=m; t.classList.add('show'); clearTimeout(t._h); t._h=setTimeout(()=>t.classList.remove('show'),1800); }
function fmtDur(s){ s=Math.max(0,s|0); const d=s/86400|0,h=s%86400/3600|0,m=s%3600/60|0; return d?d+'d '+h+'h':h?h+'h '+m+'m':m?m+'m':s+'s'; }
@@ -144,62 +138,6 @@ async function post(path, body){
// Strip ?code=… from the address bar (no reload) once the pairing is handled — so a refresh doesn't
// re-open the modal with a stale/consumed code, and the code doesn't linger in history.
function clearUrlCode(){ try { history.replaceState(null, '', location.pathname); } catch(e) {} }
-function clearSetupUrl(){ try { history.replaceState(null, '', location.pathname); } catch(e) {} }
-
-function showBrowserSetup(html){
- document.getElementById('pending').innerHTML = '<div class="pending">'+html+'</div>';
-}
-function buildSetupApproveModal(s){
- const machineUrl = s && s.webUrl && s.agentId ? (s.webUrl.replace(/\\/$/,'')+'/machine/'+s.agentId) : 'Machine';
- document.getElementById('pending').innerHTML =
- '<div class="modal"><div class="modalCard">'
- + '<div class="mTitle">Set up browser encryption?</div>'
- + '<div class="mSub">This creates a reusable 7-day setup link. Anyone with the link can pair a browser until it expires, so keep it private.</div>'
- + '<div class="mCodeLabel">machine</div><div class="mFp"><span class="fp">'+esc((s&&s.fingerprint)||'—')+'</span></div>'
- + '<div class="mCodeLabel">destination</div><div class="mFp">'+esc(machineUrl)+'</div>'
- + '<div class="mBtns"><button class="btn" onclick="closeSetupModal()">Cancel</button><button id="setupApproveBtn" class="btn primary" onclick="approveBrowserSetup()">Approve</button></div>'
- + '</div></div>';
-}
-function startBrowserSetup(){
- if (setupInFlight) return;
- setupModalOpen = true;
- buildSetupApproveModal(lastStatus || {});
-}
-function closeSetupModal(){
- setupModalOpen = false;
- if (setupMode) {
- history.back();
- setTimeout(() => {
- clearSetupUrl();
- document.getElementById('pending').innerHTML = '';
- if (lastStatus) render(lastStatus);
- }, 250);
- return;
- }
- clearSetupUrl();
- document.getElementById('pending').innerHTML = '';
- if (lastStatus) render(lastStatus);
-}
-async function approveBrowserSetup(){
- if (setupInFlight) return;
- setupInFlight = true;
- setupModalOpen = false;
- const btn = document.getElementById('setupApproveBtn');
- if (btn) { btn.disabled = true; btn.textContent = 'Approving…'; }
- showBrowserSetup('<b>Generating browser setup link…</b><div class="mut" style="margin-top:6px">You will be returned to Machine automatically.</div>');
- const { ok, j } = await post('/api/e2ee/setup-link');
- if (ok && typeof j.url === 'string' && j.url) {
- location.replace(j.url);
- return;
- }
- setupInFlight = false;
- clearSetupUrl();
- showBrowserSetup(
- '<b>Could not generate setup link</b>'
- + '<div class="mut" style="margin-top:6px">'+esc(j.error || 'Try running harness browser-link in the terminal.')+'</div>'
- + '<div style="margin-top:10px"><button class="btn" onclick="startBrowserSetup()">Try again</button></div>'
- );
-}
async function doApprove(){
const el = document.getElementById('code');
@@ -263,8 +201,6 @@ function render(s){
: nAgents === 0 ? 'no agents' : nAgents + (nAgents === 1 ? ' agent' : ' agents');
document.getElementById('uptime').textContent = fmtDur(s.uptimeSec);
document.getElementById('fp').textContent = s.fingerprint || '—';
- const wl = document.getElementById('weblink');
- wl.href = s.webUrl ? (s.webUrl.replace(/\\/$/,'')+'/machine/'+s.agentId) : '#';
// sessions
const se = document.getElementById('sessions');
@@ -279,7 +215,7 @@ function render(s){
pe.innerHTML = (s.pairs&&s.pairs.length) ? s.pairs.map(p => {
const role = isDevicePair(p) ? 'device' : (p.role || 'web');
return '<div class="row"><span class="dot '+(p.online?'on':'idle')+'"></span><div class="main"><div class="name fp">'+esc(p.fingerprint)+'</div><div class="sub"><span class="pill">'+esc(role)+'</span>'+esc(p.label)+' · paired '+fmtWhen(p.pairedAt)+'</div></div><button class="btn danger" onclick="unpair(\\''+esc(p.fingerprint)+'\\')">Unpair</button></div>';
- }).join('') : '<div class="empty">No clients paired. Use Set up browser or run <span class="mono">harness browser-link</span>.</div>';
+ }).join('') : '<div class="empty">No clients paired.</div>';
// pending — rebuild ONLY when it actually changes (new/rotated pairing), else leave the code input
// and whatever the user typed/pasted intact (polling every 2.5s must not wipe the field).
@@ -287,25 +223,20 @@ function render(s){
// doesn't clobber it. If the web link supplied ?code=…, it's pre-filled and the user just clicks
// Approve — nothing to type. Otherwise a code input is shown as a fallback.
const pd = document.getElementById('pending');
- if (setupModalOpen) {
- buildSetupApproveModal(s);
- } else if (!setupInFlight) {
- if (s.pending) {
- const key = s.pending.expiresAt + '|' + s.pending.label;
- if (key !== pendKey) {
- pendKey = key;
- // A blocking modal ONLY when arrived via the web "Approve" link (?code=…) and not yet closed;
- // opening directly (or after Close) shows a subtle inline banner instead (normal UI, no overlay).
- if (dismissedKey !== key) { if (urlCode && !modalClosed) buildApproveModal(s); else buildInlinePending(s); }
- }
- } else if (pendKey !== null) { pd.innerHTML = ''; pendKey = null; dismissedKey = null; }
- }
+ if (s.pending) {
+ const key = s.pending.expiresAt + '|' + s.pending.label;
+ if (key !== pendKey) {
+ pendKey = key;
+ // A blocking modal ONLY when arrived via the web "Approve" link (?code=…) and not yet closed;
+ // opening directly (or after Close) shows a subtle inline banner instead (normal UI, no overlay).
+ if (dismissedKey !== key) { if (urlCode && !modalClosed) buildApproveModal(s); else buildInlinePending(s); }
+ }
+ } else if (pendKey !== null) { pd.innerHTML = ''; pendKey = null; dismissedKey = null; }
// machine summary — keep the default view human-readable; tuck raw paths/ports into Advanced.
const cfg = s.config||{};
const sessionCount = (s.sessions&&s.sessions.length) || 0;
const pairCount = (s.pairs&&s.pairs.length) || 0;
- const machineUrl = s.webUrl ? (s.webUrl.replace(/\\/$/,'')+'/machine/'+s.agentId) : '#';
document.getElementById('about').innerHTML =
'<div class="statusGrid">'
+ metric('Machine cloud', s.connected ? 'Connected' : 'Reconnecting')
@@ -313,7 +244,7 @@ function render(s){
+ metric('Browsers', pairCount ? (pairCount+' paired') : 'None paired')
+ metric('Device', deviceOnline ? 'Connected' : deviceTransport ? 'Pairing' : 'Offline')
+ '</div>'
- + '<div class="actions"><a class="btn" href="'+esc(machineUrl)+'" target="_blank" rel="noreferrer">Open machine</a><button class="btn" onclick="startBrowserSetup()">Set up browser</button><a class="btn" href="#pairs">Clients</a><button class="btn" onclick="document.getElementById(\\'logsBox\\').open=true;document.getElementById(\\'logsBox\\').scrollIntoView({behavior:\\'smooth\\',block:\\'nearest\\'});">View logs</button></div>'
+ + '<div class="actions"><a class="btn" href="#pairs">Clients</a><button class="btn" onclick="document.getElementById(\\'logsBox\\').open=true;document.getElementById(\\'logsBox\\').scrollIntoView({behavior:\\'smooth\\',block:\\'nearest\\'});">View logs</button></div>'
+ '<details class="adv"><summary>Advanced</summary>'
+ kv('Backend URL', s.backendUrl)
+ kv('Watched folder', cfg.watching)
@@ -328,7 +259,6 @@ async function refresh(){
try {
const s = await (await fetch('/api/status')).json();
render(s);
- if (setupMode && !setupAutoAttempted) { setupAutoAttempted = true; startBrowserSetup(); }
fetch('/api/logs').then(r=>r.ok?r.text():'').then(t=>{ if(t) document.getElementById('logs').textContent = t; }).catch(()=>{});
} catch { document.getElementById('conn').innerHTML = '<span class="dot off"></span> <span class="mut">cloud unreachable</span>'; }
}
diff --git a/desktop/lib/main_local_manual.dart b/desktop/lib/main_local_manual.dart
index 7fb2f04b3..b2c08afd0 100644
--- a/desktop/lib/main_local_manual.dart
+++ b/desktop/lib/main_local_manual.dart
@@ -22,13 +22,11 @@ Future<void> main() async {
'LOCAL_MANUAL_MACHINE_NAME',
defaultValue: 'local-terminal-manual',
);
- const setupToken = String.fromEnvironment('LOCAL_MANUAL_SETUP_TOKEN');
if (!enabled ||
!apiBaseUrl.startsWith('http://127.0.0.1:') ||
!RegExp(r'^[a-f0-9]{64}$').hasMatch(apiKey) ||
- !RegExp(r'^[a-f0-9]{32}$').hasMatch(machineId) ||
- setupToken.isEmpty) {
+ !RegExp(r'^[a-f0-9]{32}$').hasMatch(machineId)) {
throw StateError(
'Local manual mode requires its guarded loopback fixture configuration',
);
@@ -42,7 +40,6 @@ Future<void> main() async {
apiKey: apiKey,
machineId: machineId,
machineName: machineName,
- setupToken: setupToken,
),
);
notifier.bootstrap();
diff --git a/desktop/lib/state/app_state.dart b/desktop/lib/state/app_state.dart
index 80fcb95d1..67267f5ec 100644
--- a/desktop/lib/state/app_state.dart
+++ b/desktop/lib/state/app_state.dart
@@ -230,21 +230,19 @@ String? _normalizeComputerId(String? raw) {
/// Explicit, compile-time guarded fixture used only by `main_local_manual.dart`.
///
/// It lets a normal Flutter window exercise the local Backend -> Harness CLI ->
-/// tmux path without depending on SSO. The API key and setup token are random,
-/// disposable values produced by the local launcher and are never persisted.
+/// tmux path without depending on SSO. The API key is a random, disposable
+/// value produced by the local launcher and is never persisted.
class LocalManualFixture {
final String apiBaseUrl;
final String apiKey;
final String machineId;
final String machineName;
- final String setupToken;
const LocalManualFixture({
required this.apiBaseUrl,
required this.apiKey,
required this.machineId,
required this.machineName,
- required this.setupToken,
});
}
diff --git a/desktop/scripts/start-terminal-local-manual.sh b/desktop/scripts/start-terminal-local-manual.sh
index 6108b016f..e7668fae9 100755
--- a/desktop/scripts/start-terminal-local-manual.sh
+++ b/desktop/scripts/start-terminal-local-manual.sh
@@ -197,21 +197,6 @@ done
AGENT_SUMMARY="$(curl --silent --fail -H 'x-adapter-local: 1' "http://127.0.0.1:${CLI_PORT}/api/status" \
| jq -r '.sessions | map(.engine + ":" + .name) | join(", ")')"
-browser_link_output="$(
- cd "$HARNESS_ROOT/cli"
- env \
- BACKEND_WS_URL="$WS_BASE_URL" \
- WEB_URL="$API_BASE_URL" \
- ADAPTER_DATA_DIR="$RUN_ROOT/adapter-data" \
- PORT="$CLI_PORT" \
- ANALYTICS_ENABLED=false \
- ADAPTER_UPDATE_DISABLE=true \
- ./node_modules/.bin/tsx src/cli.ts browser-link
-)"
-setup_url="$(printf '%s\n' "$browser_link_output" | sed -nE 's/^[[:space:]]*(http[^[:space:]]+)[[:space:]]*$/\1/p' | head -1)"
-[[ -n "$setup_url" ]] || { echo "Harness did not return a setup link" >&2; exit 75; }
-SETUP_TOKEN="$(node -e 'const u=new URL(process.argv[1]); const t=new URLSearchParams(u.hash.slice(1)).get("t"); if (!t) process.exit(1); process.stdout.write(t)' "$setup_url")"
-
echo
echo "LOCAL TERMINAL MANUAL STACK READY"
echo " Backend $API_BASE_URL"
@@ -233,5 +218,4 @@ flutter run -d macos -t lib/main_local_manual.dart \
--dart-define=LOCAL_MANUAL_API_BASE_URL="$API_BASE_URL" \
--dart-define=LOCAL_MANUAL_API_KEY="$API_KEY" \
--dart-define=LOCAL_MANUAL_MACHINE_ID="$MACHINE_ID" \
- --dart-define=LOCAL_MANUAL_MACHINE_NAME=local-terminal-e2e \
- --dart-define=LOCAL_MANUAL_SETUP_TOKEN="$SETUP_TOKEN"
+ --dart-define=LOCAL_MANUAL_MACHINE_NAME=local-terminal-e2e
diff --git a/desktop/test/boot_flow_widget_test.dart b/desktop/test/boot_flow_widget_test.dart
index 5d4a94abf..8c711e50b 100644
--- a/desktop/test/boot_flow_widget_test.dart
+++ b/desktop/test/boot_flow_widget_test.dart
@@ -196,7 +196,6 @@ void main() {
'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
machineId: 'bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb',
machineName: 'local-manual',
- setupToken: 'ephemeral-setup-token',
),
);
diff --git a/desktop/test/signout_recovery_test.dart b/desktop/test/signout_recovery_test.dart
index 54a5337c5..022e1f37a 100644
--- a/desktop/test/signout_recovery_test.dart
+++ b/desktop/test/signout_recovery_test.dart
@@ -69,7 +69,6 @@ AppNotifier signOutApp(SignOutFixture cli, {bool local = false}) => AppNotifier(
apiKey: 'fixture',
machineId: 'fixture',
machineName: 'Fixture',
- setupToken: 'fixture',
)
: null,
)..status = AppStatus.authenticated;
diff --git a/docs/architecture.md b/docs/architecture.md
index 510a6fda9..789c53b5d 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -57,9 +57,8 @@ browser's copy, with a drift-guard test and committed self-vectors.
and hands out STUN/TURN, and persists machines, agent names and counters. `npm install && npm run
dev` on `:8085`; [`backend/README.md`](backend/README.md) and `.env.example` for the rest.
`harness-api.autonomous.ai` is the hosted instance.
-- **The web client** at [harness.autonomous.ai](https://harness.autonomous.ai) reaches the same
- machines from a browser after `harness pair <code>` or a `harness browser-link`. It is not in this
- repository; it also hosts the CLI installer and the desktop downloads.
+- **[harness.autonomous.ai](https://harness.autonomous.ai)** is the download page: it hosts the CLI
+ installer and the desktop downloads. It is not in this repository.
## The Harness device
diff --git a/docs/cli.md b/docs/cli.md
index cf7078d80..1fe6058fe 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -19,7 +19,6 @@ works the same on a headless Linux server; the app is not required on a machine,
| `harness dsh list` · `harness dsh update <owner/name>` | Installed harness package versions and available updates · update one package while preserving its workspaces. |
| `harness machines [list] [--json]` · `harness machines delete <id>` | This account's machines · remove another machine (never this one). |
| `harness pair <code>` · `harness pairings` · `harness unpair <#\|fp\|--all>` | Pair a browser with the code the web client shows; list; unpair. |
-| `harness browser-link` | Print a reusable seven-day setup link for browsers. |
| `harness remote-password set\|status\|clear` | This machine's persistent password for machine-to-machine links. |
| `harness link connect <id> [--name=<label>]` · `harness link list` · `harness link unlink <id>` | Let this machine reach another of yours, terminating E2EE here; list; unlink. |
| `harness remote` | From a Harness terminal tile: choose another of your machines (linking it on the spot if needed), open a terminal there and move this tile to it. |
diff --git a/mobile/lib/state/app_state.dart b/mobile/lib/state/app_state.dart
index 4a12fb3a4..20b338519 100644
--- a/mobile/lib/state/app_state.dart
+++ b/mobile/lib/state/app_state.dart
@@ -136,21 +136,19 @@ String? _normalizeComputerId(String? raw) {
/// Explicit, compile-time guarded fixture used only by `main_local_manual.dart`.
///
/// It lets a normal Flutter window exercise the local Backend -> Harness CLI ->
-/// tmux path without depending on SSO. The API key and setup token are random,
-/// disposable values produced by the local launcher and are never persisted.
+/// tmux path without depending on SSO. The API key is a random, disposable
+/// value produced by the local launcher and is never persisted.
class LocalManualFixture {
final String apiBaseUrl;
final String apiKey;
final String machineId;
final String machineName;
- final String setupToken;
const LocalManualFixture({
required this.apiBaseUrl,
required this.apiKey,
required this.machineId,
required this.machineName,
- required this.setupToken,
});
}