centralu 0.1.0-beta.43 → 0.1.0-beta.44

package/bin/serve-detach.mjs

@@ -270,7 +270,8 @@ export async function runDetachedChild({ spec, ...opts }) {
  *
  * A stop that went through is remembered in the data folder (`markStopped`, #1143), so a linked hub does not start the
  * host again by itself; the next host that starts here removes the mark. Not for a hub's own stop, which starts the
- * host again itself (an update, a rollback): the hub runs it with `CENTRALU_STOP_BY=hub` (links/tunnel.ts `stopCommand`)
+ * host again itself (an update, a rollback): the hub runs it with `CENTRALU_STOP_BY=hub` (links/tunnel.ts `stopCommand`).
+ * With `CENTRALU_STOP_FOR=update` too (#1618), the host is asked to list the turns it ends, which the next host continues
  */
 export async function runStop({
   env,
@@ -283,7 +284,7 @@ export async function runStop({
   write = (line) => process.stdout.write(line),
 }) {
   const dataDir = serveDataDir(env, home)
-  const stopped = await stopServedHost({ dataDir, entry, platform, timeoutMs, graceMs, kill })
+  const stopped = await stopServedHost({ dataDir, entry, platform, forUpdate: env.CENTRALU_STOP_FOR === 'update', timeoutMs, graceMs, kill })
   if (stopped.ok && env.CENTRALU_STOP_BY !== 'hub') markStopped(dataDir, 'stop')
   return answerLine(write, 'stop', stopped)
 }

package/bin/serve-handover.mjs

@@ -23,9 +23,11 @@ import { isAlive, say, sleep, waitUntil } from './serve-util.mjs'
  * with this folder's token: a stale pid is never signalled.
  *
  * `{ ok, wasRunning, how?, message? }`, the `--stop` line's `stop`. With `ifIdle` (#1224, the hand-over) the host stops only
- * when nothing runs there, and `{ ok: false, busy: true }` says it did not.
+ * when nothing runs there, and `{ ok: false, busy: true }` says it did not. `forUpdate` (#1618): a hub's update stops it, and
+ * the host writes the turns it ends for the next one (`host.stop { forUpdate }`); a host that does not take the request is
+ * ended as any is, and lists nothing.
  */
-export async function stopServedHost({ dataDir, entry, platform = process.platform, ifIdle = false, timeoutMs = 30_000, graceMs = 15_000, kill = (pid, sig) => process.kill(pid, sig) }) {
+export async function stopServedHost({ dataDir, entry, platform = process.platform, ifIdle = false, forUpdate = false, timeoutMs = 30_000, graceMs = 15_000, kill = (pid, sig) => process.kill(pid, sig) }) {
   const state = readServeState(dataDir)
   if (!state) return { ok: true, wasRunning: false, message: `no centralu serve has run for ${dataDir}` }
   const port = state.port ?? DEFAULT_SERVE_PORT
@@ -41,8 +43,8 @@ export async function stopServedHost({ dataDir, entry, platform = process.platfo
   const launcherPid = launcher && hostPid && launcher.hostPid === hostPid ? launcher.pid : null
   const down = async () => !(await probe()).running && !(hostPid && isAlive(hostPid))
 
-  let asked = await askHostToStop({ port, token: state.token, protocolVersion: first.protocolVersion ?? installed, prove, ifIdle })
-  if (!asked.ok && asked.protocolVersion !== undefined) asked = await askHostToStop({ port, token: state.token, protocolVersion: asked.protocolVersion, prove, ifIdle })
+  let asked = await askHostToStop({ port, token: state.token, protocolVersion: first.protocolVersion ?? installed, prove, ifIdle, forUpdate })
+  if (!asked.ok && asked.protocolVersion !== undefined) asked = await askHostToStop({ port, token: state.token, protocolVersion: asked.protocolVersion, prove, ifIdle, forUpdate })
   // `ifIdle` and it has work running (#1224): it was left as it is
   if (asked.busy) return { ok: false, wasRunning: true, busy: true, message: asked.message }
   let how = 'asked'

package/bin/serve-host.mjs

@@ -367,9 +367,9 @@ export function askHostRpc({ port, token, protocolVersion, prove = false, method
  * `{ ok: true }` once the host took it, `{ ok: false, message, protocolVersion? }` otherwise; the
  * last names the host's protocol when the hello was refused for it, so the caller can ask again.
  * `ifIdle` (#1224): only if nothing runs there, checked and acted on by the host in one step; `{ ok: false, busy: true }`
- * when something does.
+ * when something does. `forUpdate` (#1618): a hub's update stops it, and the host lists the turns it ends for the next one.
  */
-export function askHostToStop({ port, token, protocolVersion, prove = false, ifIdle = false, timeoutMs = 5000, WebSocketImpl = globalThis.WebSocket }) {
+export function askHostToStop({ port, token, protocolVersion, prove = false, ifIdle = false, forUpdate = false, timeoutMs = 5000, WebSocketImpl = globalThis.WebSocket }) {
   if (typeof WebSocketImpl !== 'function') return Promise.resolve({ ok: false, message: `Node ${process.version} has no WebSocket to ask with` })
   // With `prove`, the token goes out only to a host that proved it holds it (#838)
   return helloExchange({
@@ -380,7 +380,7 @@ export function askHostToStop({ port, token, protocolVersion, prove = false, ifI
       unproven: () => done({ ok: false, message: 'what answers on the port did not prove it holds the token' }),
       gone: () => done({ ok: false, message: 'the connection closed' }),
       message: (m, ws) => {
-        if (m.kind === 'hello_ok') ws.send(JSON.stringify({ kind: 'rpc', id: 'stop', method: 'host.stop', params: ifIdle ? { ifIdle: true } : {} }))
+        if (m.kind === 'hello_ok') ws.send(JSON.stringify({ kind: 'rpc', id: 'stop', method: 'host.stop', params: { ...(ifIdle ? { ifIdle: true } : {}), ...(forUpdate ? { forUpdate: true } : {}) } }))
         else if (m.kind === 'res' && m.id === 'stop' && m.ok && m.result?.ok === false) {
           // `ifIdle` and something runs there (#1224): nothing was changed
           done({ ok: false, busy: true, message: 'it has work running', activity: m.result.busy ?? null, calls: m.result.calls ?? 0 })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "centralu",
-  "version": "0.1.0-beta.43",
+  "version": "0.1.0-beta.44",
   "description": "Run, watch and steer several Claude Code and Codex CLI sessions from one window",
   "license": "MIT",
   "author": "ijun17",
@@ -38,9 +38,9 @@
     "win32"
   ],
   "optionalDependencies": {
-    "@centralu/darwin-arm64": "0.1.0-beta.43",
-    "@centralu/linux-arm64": "0.1.0-beta.43",
-    "@centralu/linux-x64": "0.1.0-beta.43",
-    "@centralu/win32-x64": "0.1.0-beta.43"
+    "@centralu/darwin-arm64": "0.1.0-beta.44",
+    "@centralu/linux-arm64": "0.1.0-beta.44",
+    "@centralu/linux-x64": "0.1.0-beta.44",
+    "@centralu/win32-x64": "0.1.0-beta.44"
   }
 }