Repository navigation
v0.166.0
Install or update: npm i -g cotal-ai@0.166.0
Restart running Cotal processes and agent sessions to use the new code.
What changed
- Withdraw harness permission requests, released in 0.165.0.
- Fix the daemon generation smoke fixture to verify a replacement whose CLI reports the new version.
- Reject extra persona names in legacy
personascommands before reading or changing the catalog. - Remove an unused auth smoke probe that still expected Mesh manifests to deploy through spawn --file, keeping the maintained user-mode teardown suite as coverage.
- Linux daemon installation now accepts home and config directories containing spaces.
- Self-updates without a machine daemon now finish successfully after reconciliation.
cotal update --selffrom a release before 0.166.0 prints the daemon wait line again.- Windows setup now waits for the matching service reply when recovering from a timed-out preparation request.
- Avoid creating an anycast scan consumer on spaces with an empty request-record bucket.
- An
@inside an email address or a path no longer counts as a mention. - An accepted
cotal spawn --detach --on <instance>now reports its real outcome when the manager briefly serves nothing right after accepting it, instead of ending at once withOPERATION_UNKNOWN. - Retire durable channel memberships from earlier sessions when the same principal leaves a channel.
- A manager's standing connections that the broker closed as their old credentials expired now come back as soon as the renewed credentials are adopted.
- Automatic updates on an installation this account cannot write now record the refusal once and stop retrying every hour.
- Show distinct messages with empty IDs independently in the console and history follow while continuing to deduplicate nonempty IDs.
- Keep the registered space when a broker URL uses a trailing slash or different scheme case.
- Refuse agent-profile credentials in console and watch before announcing a feed, with instructions to mint a separate observer credential.
- Create missing signer export folders privately without following symbolic links, including output paths containing spaces or shell characters.
- Resolve presence-render census exclusions through a shared class rationale or an entry-specific exception reason.
- Keep internal Claude connector helpers and types private without changing the public package API.
- Keep internal Codex and Jcode connector helpers and types module-private without changing their published APIs.
- Remove unused internal connector exports while preserving the published package API.
- Keep internal connector helpers and types module-private while preserving the published package exports.
- Keep auth implementation helpers private and remove an unused managed-actor revoke wrapper without changing the published package exports.
- Document space adoption in command help and correct controller-stack log and teardown preview instructions.
- Refuse a changed
up --max-sessionswhile the controller manager runs, naming its current ceiling and the stop/start commands instead of silently ignoring the request. - Validate the first user-auth IdP before native startup writes trust, credentials or store state, and report missing or invalid inputs as usage refusals.
- Report native broker permission and file-size write failures with the recovery step that keeps stored history.
cotal persona editnow keeps your edited draft and names its path when saving fails for any reason, such as a persona catalog that became read-only while the editor was open.cotal personas newnow refuses a--rolethat is not a single NATS-safe token ([A-Za-z0-9_-]), ascotal persona createdoes, instead of saving it and suggesting acotal spawnthat refuses it.- Resume a suspended owned broker during confirmed whole-stack shutdown instead of requiring a manual signal and retry.
- Wait for the personal Codex server to exit independently of mesh presence in the live shutdown check.
- Create a missing local project folder when setup receives
--yes. - Recommend a targeted connector install when setup finds no connectors after built-ins were removed.
- Reject extra operands to extension add and remove before changing installed packages.
cotal upwith no--store-dirreopens the store this folder's last broker served, such as abackup restore --store-dirtarget, when the default.cotal/natsholds no data, instead of refusingCONFLICTand asking for the path it already named.- Allow software updates past unreachable registered brokers when no local Manager of this installation serves their spaces, without changing the registrations.
cotal upnow starts the broker again on a new websocket port when another process took the one it picked before the broker could bind it, instead of failing with "Unable to listen for websocket connections".- Allow connector seeding and repair from read-only package installs by making private seed-store directories owner-writable.
- Keep file-local delivery and workflow runtime helpers private without changing package entrypoints or runtime behavior.
- Keep unused dashboard and Linear implementation helpers private without changing the public package APIs.
- Document that journal action smoke coverage does not establish a shipped spawn or launch path, and print that scope in the manager wiring suite.
- Retry rejected standing credential renewals before the current credentials expire so manager connections retain their native identities.
- Cover a manager authorization refusal during terminal attachment reconnection, including terminal restoration and session cleanup.
- Remove unused internal manager exports and an uncalled workspace lookup helper without changing the public package API.
Every change in full
-
Withdraw harness permission requests, released in 0.165.0. A Claude Code connector no longer holds a permission prompt for its owner to answer from another session, so Claude Code's own dialog is the only way to answer one. This removes the
permanswer subject, thecotal_permissions_<space>bucket and its readers, the@cotal-ai/core/permissionsexport, therequestfield on a presence condition andpermissionRequestson a Managerstatus.connectorsrow. The Manager cluster advances to revision 51. A space set up on 0.165 keeps the bucket, which this release neither reads nor writes. -
Fix the daemon generation smoke fixture to verify a replacement whose CLI reports the new version.
-
Reject extra persona names in legacy
personascommands before reading or changing the catalog. -
Remove an unused auth smoke probe that still expected Mesh manifests to deploy through spawn --file, keeping the maintained user-mode teardown suite as coverage.
-
Linux daemon installation now accepts home and config directories containing spaces.
Decode systemd's quoted environment values without evaluating shell text, while retaining directory validation and refusal of malformed values. -
Self-updates without a machine daemon now finish successfully after reconciliation.
Keep the no-daemon return even when the version-changing updater has already waited for its installed generation. -
cotal update --selffrom a release before 0.166.0 prints the daemon wait line again. The reconcile step of the new version stayed quiet whenever an updater had started it, on the assumption that the updater printsmachine daemon: waiting up to 120s for Cotal <version> and its hosted Managers before the continuity checkafterwards. An updater from 0.164.10 does not wait there, so the update waited up to two minutes without saying why. The updater now tells its reconcile step that it waits, and the step stays quiet only then. -
Windows setup now waits for the matching service reply when recovering from a timed-out preparation request.
The installer keeps partial replies across reads and discards only replies to requests that timed out. Malformed or unknown replies refuse the connection, and a missing abort reply remains unconfirmed. This also works when setup talks to an older installed runtime.
-
Avoid creating an anycast scan consumer on spaces with an empty request-record bucket.
The delivery maintenance pass checks the bucket status before enumerating keys. Pending requests
and existing records keep their current maintenance behavior. -
An
@inside an email address or a path no longer counts as a mention. Before,mail ana@example.comsent a mention ofexample.comand could wake an agent of that name.mentionsInnow starts no mention right after an ASCII letter or digit,_,.,-or/, so every surface that posts typed text follows the same rule. A mention typed right after Chinese, Japanese or Thai text, as in你好@rover, still counts. -
An accepted
cotal spawn --detach --on <instance>now reports its real outcome when the manager briefly serves nothing right after accepting it, instead of ending at once withOPERATION_UNKNOWN. Agoal-resultread that the broker answers with no responder did not run, so the goal follow reads again every 250ms until its wait deadline, while live progress can still settle the goal. Any other read failure still ends the follow with an unknown outcome, and a follow that times out after unanswered reads names the last one. -
Retire durable channel memberships from earlier sessions when the same principal leaves a channel.
-
A manager's standing connections that the broker closed as their old credentials expired now come back as soon as the renewed credentials are adopted. The manager's own endpoint used to stay down until its reconnect backoff ended, up to a minute, and the goal-writer and session-ledger connections waited a fixed second.
CotalEndpoint.refreshCredsRequestSafe()now redials an endpoint that is re-establishing instead of refusing. A closed standing connection makes its first re-dial attempt when an in-flight renewal adopts, and a goal-writer or session-ledger connection whose credential expired makes it at once, which starts the renewal. -
Automatic updates on an installation this account cannot write now record the refusal once and stop retrying every hour.
The updater writes the same refusal sentence that
cotal update --selfprints into the attempt record, without counting a failed attempt and without scheduling a retry. A successfulcotal updateafter the installation changes records a new result and resumes automatic updates. -
Show distinct messages with empty IDs independently in the console and history follow while continuing to deduplicate nonempty IDs.
-
Keep the registered space when a broker URL uses a trailing slash or different scheme case.
-
Refuse agent-profile credentials in console and watch before announcing a feed, with instructions to mint a separate observer credential.
-
Create missing signer export folders privately without following symbolic links, including output paths containing spaces or shell characters.
-
Resolve presence-render census exclusions through a shared class rationale or an entry-specific exception reason.
-
Keep internal Claude connector helpers and types private without changing the public package API.
-
Keep internal Codex and Jcode connector helpers and types module-private without changing their published APIs.
-
Remove unused internal connector exports while preserving the published package API.
-
Keep internal connector helpers and types module-private while preserving the published package exports.
-
Keep auth implementation helpers private and remove an unused managed-actor revoke wrapper without changing the published package exports.
-
Document space adoption in command help and correct controller-stack log and teardown preview instructions.
-
Refuse a changed
up --max-sessionswhile the controller manager runs, naming its current ceiling and the stop/start commands instead of silently ignoring the request. -
Validate the first user-auth IdP before native startup writes trust, credentials or store state, and report missing or invalid inputs as usage refusals.
-
Report native broker permission and file-size write failures with the recovery step that keeps stored history. Recognize the broker's permission warning and stream-write error alongside critical file-store errors.
-
cotal persona editnow keeps your edited draft and names its path when saving fails for any reason, such as a persona catalog that became read-only while the editor was open. -
cotal personas newnow refuses a--rolethat is not a single NATS-safe token ([A-Za-z0-9_-]), ascotal persona createdoes, instead of saving it and suggesting acotal spawnthat refuses it. Nothing is written on the refusal, so--forceno longer replaces a working persona with one that cannot launch. -
Resume a suspended owned broker during confirmed whole-stack shutdown instead of requiring a manual signal and retry.
-
Wait for the personal Codex server to exit independently of mesh presence in the live shutdown check.
-
Create a missing local project folder when setup receives
--yes. -
Recommend a targeted connector install when setup finds no connectors after built-ins were removed.
-
Reject extra operands to extension add and remove before changing installed packages.
-
cotal upwith no--store-dirreopens the store this folder's last broker served, such as abackup restore --store-dirtarget, when the default.cotal/natsholds no data, instead of refusingCONFLICTand asking for the path it already named. It prints the store it reopens. When the auth and open broker configs name two such stores, it still refuses, andup -fkeeps its refusal. -
Allow software updates past unreachable registered brokers when no local Manager of this installation serves their spaces, without changing the registrations.
-
cotal upnow starts the broker again on a new websocket port when another process took the one it picked before the broker could bind it, instead of failing with "Unable to listen for websocket connections". -
Allow connector seeding and repair from read-only package installs by making private seed-store directories owner-writable.
-
Keep file-local delivery and workflow runtime helpers private without changing package entrypoints or runtime behavior.
-
Keep unused dashboard and Linear implementation helpers private without changing the public package APIs.
-
Document that journal action smoke coverage does not establish a shipped spawn or launch path, and print that scope in the manager wiring suite.
-
Retry rejected standing credential renewals before the current credentials expire so manager connections retain their native identities.
-
Cover a manager authorization refusal during terminal attachment reconnection, including terminal restoration and session cleanup.
-
Remove unused internal manager exports and an uncalled workspace lookup helper without changing the public package API.
What's Changed
- test(smoke): record the static helper seat as a reviewed ambient read by @davidfarah-dev in #7222
- fix(cli): name effective recovery for removed setup connectors by @davidfarah-dev in #7162
- fix(core): retire earlier durable channel memberships by @davidfarah-dev in #7163
- fix(cli): preserve distinct messages with empty IDs by @davidfarah-dev in #7164
- test(cli): align marked generation fixture with entry version by @davidfarah-dev in #7165
- fix(cli): allow connector seeding from read-only installs by @davidfarah-dev in #7166
- fix(cli): refuse invalid roles in personas new before saving by @davidfarah-dev in #7168
- refactor(connector-claude-code): keep internal bindings private by @davidfarah-dev in #7169
- fix(cli): create missing setup project with --yes by @davidfarah-dev in #7172
- fix(cli): keep the persona edit draft when saving fails by @davidfarah-dev in #7173
- refactor(connector-core): remove unused private exports by @davidfarah-dev in #7174
- fix(cli): refuse agent credentials in passive observers by @davidfarah-dev in #7175
- refactor(manager): remove unused internal exports by @davidfarah-dev in #7176
- refactor(auth): remove unused internal exports by @davidfarah-dev in #7178
- refactor(connectors): keep internal Codex and Jcode declarations private by @davidfarah-dev in #7179
- refactor(connectors): make unused internal exports module-private by @davidfarah-dev in #7180
- test(auth): remove obsolete manifest spawn probe by @davidfarah-dev in #7183
- fix(manager): retry standing renewals before credential expiry by @davidfarah-dev in #7187
- fix(cli): clarify controller stack recovery commands by @davidfarah-dev in #7189
- refactor(ui): remove unused TUI, web, and Linear exports by @davidfarah-dev in #7190
- fix(cli): reject extra extension operands by @davidfarah-dev in #7191
- fix(cli): reject extra names in legacy personas commands by @davidfarah-dev in #7192
- fix(workspace): retain registered space for equivalent broker URLs by @davidfarah-dev in #7193
- fix(auth): create private signer export folders by @davidfarah-dev in #7195
- refactor(runtime): keep delivery and runtime helpers private by @davidfarah-dev in #7196
- fix(cli): reopen a restored store on bare up instead of refusing by @davidfarah-dev in #7197
- fix(cli): record an automatic self-update refusal once instead of retrying hourly by @davidfarah-dev in #7198
- fix(cli): validate user-auth IdP before native startup by @davidfarah-dev in #7199
- fix(update): print each daemon wait line once per self-update by @davidfarah-dev in #6917
- fix(cli): reject changed session ceilings on running stacks by @davidfarah-dev in #7157
- fix(cli): diagnose native broker store write failures by @davidfarah-dev in #7149
- fix(cli): resume suspended owned broker during down by @davidfarah-dev in #7182
- fix(cli): decode quoted systemd user directories by @davidfarah-dev in #7204
- docs(manager): clarify journal action coverage limits by @davidfarah-dev in #7205
- test(cli): wait for personal Codex server exit by @davidfarah-dev in #7208
- test(connector-core): cover the agui egress policy across a live read grant by @davidfarah-dev in #7211
- fix(cli): start the broker again on a new websocket port when another process took it by @davidfarah-dev in #7212
- test(attach): cover manager denial during reconnect by @davidfarah-dev in #7213
- test(claude): drive the shipped connector to presence on a real manager by @davidfarah-dev in #7214
- fix(core): keep following an accepted goal when a result read has no responder by @davidfarah-dev in #7215
- test(workspace): resolve shared presence census rationales by @davidfarah-dev in #7216
- test(smoke): strip ambient Cotal variables in two suites added since #7207 by @davidfarah-dev in #7227
- test(tui): expect process-exit when an attached seat exits on its own by @Manas-Kenge in #7230
- test(smoke): keep the caller's Cotal variables from auto-update-repair's updater by @davidfarah-dev in #7233
- revert!: withdraw harness permission requests by @davidfarah-dev in #7139
- test(smoke): isolate ambient Cotal environment in suite children by @davidfarah-dev in #7218
- fix(core): count an @ as a mention only at a word boundary by @Manas-Kenge in #7234
- fix(update): retain the no-daemon return after waiting by @davidfarah-dev in #7228
- fix(update): ignore unreachable registrations without local custody by @davidfarah-dev in #7226
- fix(manager): re-dial standing connections when renewed credentials are adopted by @davidfarah-dev in #7229
- test(cli): assign the private COTAL_HOME before the update pin smoke records a mesh by @davidfarah-dev in #7240
- test(desktop): bound historical foreign fixture dependencies by @davidfarah-dev in #7235
- fix(update): keep the daemon wait line when an older updater starts the reconcile step by @davidfarah-dev in #7248
- fix(desktop): correlate pinned service replies across timeouts by @davidfarah-dev in #7252
- fix(core): skip anycast scans on empty buckets by @davidfarah-dev in #7253
- chore(release): version packages by @davidfarah-dev in #7223
Full Changelog: v0.165.4...v0.166.0