Repository navigation
v0.171.2
Install or update: npm i -g cotal-ai@0.171.2
Restart running Cotal processes and agent sessions to use the new code.
What changed
- Backup commands now explain symbolic-link loops,
uprejects an empty--restorepath before starting anything, and setup help labels the self-hosted example as interactive while the installation guide shows the full scripted command. - Report self-update registry connection failures with npm's error code and the scoped registry setting to check instead of asking users to wait for publication.
- Fix the CLI setup smoke tests so their Codex stand-ins report the plugin version they installed.
- Keep the requested space in broker preset retries and preserve the saved manager settings when a console host override or stack start is rejected.
- Show the correct foreground start command for an explicit daemon home and report saved automatic update preferences even when another daemon owns the socket.
- Shutdown preserves the requested agent teardown in its confirmation commands, setup points stopped projects to startup, and spawn offers compatible launch and manager restart commands.
- Wait for a simultaneous self-update of the same npm installation and recheck its installed CLI before replacing packages again.
- Quote the folder path in the
backup createpermission error so the suggestedchmodcommand works for paths with spaces. - Retry the startup scan after a broker interruption so eligible workflow runs can resume without another manager restart.
- Continue self-update from the restored version, show when an update is still running, and remove abandoned release archive caches without disturbing active checks.
- Keep npm-installed Cotal usable when Node is off PATH, leave recovery files untouched on offline updates, and preserve the npm launcher when the shell installer finds a recorded daemon service.
- Self-update reports when a signal stops npm's dependency check, and
cotal updateaccepts the recorded broker URL of a stopped local stack without restarting it. - Move the endpoint's dialing, auth options, bearer lifetimes and reachability probes out of
endpoint.tsinto their own module. - Move the endpoint's message authentication against the delivery subject and its history-row checks out of
endpoint.tsinto their own module. - Move the endpoint's options, its public types and errors, and the history page fitter out of
endpoint.tsinto their own module. - Show usable next steps for manager status and credential minting, and retire durable memberships when leaving a channel that switched to live delivery.
- Refuse invalid spawn arguments and inaccessible working directories before provisioning credentials, reject pi resume flags, and remove Hermes launch credentials, sockets and disposable profiles after stopping.
- Allow self-update and local space startup through a protected symbolic-link home, and discard staged builds when the update snapshot fails.
- Move the maintenance foundation (the journal and lock contract types, MaintenanceError, store identity, the process owner and the maintenance lock) out of
maintenance.tsinto an internalmaintenance-foundation.ts. - Move the maintenance journal (the persisted record validators, listener custody proofs, the resume document and the journal read/validate/write path) out of
maintenance.tsinto an internalmaintenance-journal.ts. - Claude Code and Pi seats return to
idleafter their user interrupts a turn, and the run ends as an interrupt on the event plane. - An empty
cotal_waiton a connection that cannot hear from the broker no longer returns the plain "No new messages" reply. pnpm dlxruns under pnpm 11, which start the package from its global virtual store, are now recognised.- Resolve foreground persona and broker log paths from the invoking folder, accept log rotation flags with a manifest log path, and report incompatible manifest flags as a usage refusal.
- Report lost registry connectivity before self-update replacement as an unchanged installation instead of a release-propagation failure or raw npm errors.
- Fix
cotal downleaving delivery and the broker running when the manager records a completed stop and exits during the receipt check. - Allow
space forgetto remove a damaged registration when another space's registry file is damaged too, instead of refusing with a recovery command that cannot run either. cotal statusnow shows how to list spaces and select a different one.- Move seat stop, exit cause recording, recursive reap and the named despawn doors into their own component without changing the manager API.
- Move the dashboard's operator posting (the posting decision, the operator credential, the poster and
POST /api/send) out ofweb.tsinto its own module. - Move the dashboard's read paths (client assets, activity aggregation, the session feed and agent events) out of
web.tsinto their own module.
Every change in full
- Backup commands now explain symbolic-link loops,
uprejects an empty--restorepath before starting anything, and setup help labels the self-hosted example as interactive while the installation guide shows the full scripted command. - Report self-update registry connection failures with npm's error code and the scoped registry setting to check instead of asking users to wait for publication.
- Fix the CLI setup smoke tests so their Codex stand-ins report the plugin version they installed.
- Keep the requested space in broker preset retries and preserve the saved manager settings when a console host override or stack start is rejected.
- Show the correct foreground start command for an explicit daemon home and report saved automatic update preferences even when another daemon owns the socket.
- Shutdown preserves the requested agent teardown in its confirmation commands, setup points stopped projects to startup, and spawn offers compatible launch and manager restart commands.
- Wait for a simultaneous self-update of the same npm installation and recheck its installed CLI before replacing packages again.
- Quote the folder path in the
backup createpermission error so the suggestedchmodcommand works for paths with spaces. - Retry the startup scan after a broker interruption so eligible workflow runs can resume without another manager restart.
- Continue self-update from the restored version, show when an update is still running, and remove abandoned release archive caches without disturbing active checks.
- Keep npm-installed Cotal usable when Node is off PATH, leave recovery files untouched on offline updates, and preserve the npm launcher when the shell installer finds a recorded daemon service.
- Self-update reports when a signal stops npm's dependency check, and
cotal updateaccepts the recorded broker URL of a stopped local stack without restarting it. - Move the endpoint's dialing, auth options, bearer lifetimes and reachability probes out of
endpoint.tsinto their own module. The package's exports are unchanged. - Move the endpoint's message authentication against the delivery subject and its history-row checks out of
endpoint.tsinto their own module. The package's exports are unchanged. - Move the endpoint's options, its public types and errors, and the history page fitter out of
endpoint.tsinto their own module. The package's exports are unchanged. - Show usable next steps for manager status and credential minting, and retire durable memberships when leaving a channel that switched to live delivery.
- Refuse invalid spawn arguments and inaccessible working directories before provisioning credentials, reject pi resume flags, and remove Hermes launch credentials, sockets and disposable profiles after stopping.
- Allow self-update and local space startup through a protected symbolic-link home, and discard staged builds when the update snapshot fails.
- Move the maintenance foundation (the journal and lock contract types, MaintenanceError, store identity, the process owner and the maintenance lock) out of
maintenance.tsinto an internalmaintenance-foundation.ts.maintenance.tsre-exports every public name, so the package surface and import paths are unchanged. - Move the maintenance journal (the persisted record validators, listener custody proofs, the resume document and the journal read/validate/write path) out of
maintenance.tsinto an internalmaintenance-journal.ts.maintenance.tsre-exports every public name, so the package surface and import paths are unchanged. - Claude Code and Pi seats return to
idleafter their user interrupts a turn, and the run ends as an interrupt on the event plane. Claude Code fires no hook on an interrupt, so the connector now watches the open turn's transcript for the interrupt record Claude Code writes. That record sets presence toidle, clears any approval or input condition, and closes the run withRUN_FINISHEDcarrying aninterruptoutcome. A Pi turn without a Cotal batch now publishesidlewhen it ends after an abort or an error. An aborted Pi turn, including one stopped during a tool call, ends with aninterruptoutcome instead ofRUN_ERROR. - An empty
cotal_waiton a connection that cannot hear from the broker no longer returns the plain "No new messages" reply. It opens with the connection warningcotal_inboxgives and says only the local buffer was read. A connected wait keeps the plain reply. pnpm dlxruns under pnpm 11, which start the package from its global virtual store, are now recognised. The entry card andstatussuggestpnpm dlx cotal-aicommands instead of Node plus a store path, andsetupoffers the global install it offers under otherpnpm dlxruns.- Resolve foreground persona and broker log paths from the invoking folder, accept log rotation flags with a manifest log path, and report incompatible manifest flags as a usage refusal.
- Report lost registry connectivity before self-update replacement as an unchanged installation instead of a release-propagation failure or raw npm errors.
- Fix
cotal downleaving delivery and the broker running when the manager records a completed stop and exits during the receipt check. - Allow
space forgetto remove a damaged registration when another space's registry file is damaged too, instead of refusing with a recovery command that cannot run either. cotal statusnow shows how to list spaces and select a different one.- Move seat stop, exit cause recording, recursive reap and the named despawn doors into their own component without changing the manager API.
- Move the dashboard's operator posting (the posting decision, the operator credential, the poster and
POST /api/send) out ofweb.tsinto its own module. No behaviour change. - Move the dashboard's read paths (client assets, activity aggregation, the session feed and agent events) out of
web.tsinto their own module. No behaviour change.
What's Changed
- fix(manager): reread the stop receipt after manager exit by @davidfarah-dev in #8052
- test(upgrade): verify other-home evidence against the Node the cell recorded by @davidfarah-dev in #8033
- fix(update): preserve npm launcher and recovery state by @davidfarah-dev in #7985
- fix(connector-core): say an empty cotal_wait only read the local buffer while the broker is unreachable by @davidfarah-dev in #8071
- fix(cli): recognise pnpm 11 dlx runs from the global virtual store by @davidfarah-dev in #8072
- fix(manager): retry the inherited-run scan after its connection closes at boot by @davidfarah-dev in #8070
- fix(cli): correct local stack command guidance by @davidfarah-dev in #8004
- fix(cli): correct local guidance and durable channel leave by @davidfarah-dev in #7991
- fix(cli): forget a damaged space registration when another record is damaged too by @Huyvux12 in #7987
- fix(update): recover interrupted updates and report registry and network failures apart by @davidfarah-dev in #8036
- fix(update): support protected symlink homes by @davidfarah-dev in #7467
- fix(cli): honor startup settings and foreground paths by @davidfarah-dev in #7981
- fix(cli): clarify backup paths and scripted setup by @davidfarah-dev in #7996
- fix(cli): preserve service start inputs by @davidfarah-dev in #8008
- fix(spawn): validate before provisioning and clean Hermes artifacts by @davidfarah-dev in #7698
- refactor(web): move the read paths into web-read.ts by @davidfarah-dev in #8042
- refactor(web): move operator posting into web-post.ts by @davidfarah-dev in #8043
- test(manager): characterise seat stop, exit cause and retirement by @davidfarah-dev in #8045
- refactor(manager): move seat stop, exit cause and named despawn into SeatStop by @davidfarah-dev in #8053
- fix(cli): show how to switch spaces by @davidfarah-dev in #8085
- fix(cli): quote backup destination in chmod remedy by @davidfarah-dev in #8084
- test(setup): report installed Codex plugins in smoke fixtures by @davidfarah-dev in #8081
- refactor(core): extract endpoint dial module by @davidfarah-dev in #8074
- refactor(core): extract endpoint options module by @davidfarah-dev in #8075
- refactor(workspace): move the maintenance foundation into maintenance-foundation.ts by @davidfarah-dev in #8054
- refactor(core): extract endpoint messages module by @davidfarah-dev in #8076
- refactor(workspace): move the maintenance journal into maintenance-journal.ts by @davidfarah-dev in #8077
- fix(connectors): end interrupted Claude and Pi turns as idle interrupts by @davidfarah-dev in #8095
- chore(release): version packages by @davidfarah-dev in #8073
New Contributors
Full Changelog: v0.171.1...v0.171.2