Skip to content

v0.166.0

Choose a tag to compare

@davidfarah-dev davidfarah-dev released this 17 Nov 10:39
481f0e3

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 personas commands 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 --self from 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 with OPERATION_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-sessions while 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 edit now 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 new now refuses a --role that is not a single NATS-safe token ([A-Za-z0-9_-]), as cotal persona create does, instead of saving it and suggesting a cotal spawn that 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 up with no --store-dir reopens the store this folder's last broker served, such as a backup restore --store-dir target, when the default .cotal/nats holds no data, instead of refusing CONFLICT and 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 up now 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 perm answer subject, the cotal_permissions_<space> bucket and its readers, the @cotal-ai/core/permissions export, the request field on a presence condition and permissionRequests on a Manager status.connectors row. 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 personas commands 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 --self from 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 prints machine daemon: waiting up to 120s for Cotal <version> and its hosted Managers before the continuity check afterwards. 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.com sent a mention of example.com and could wake an agent of that name. mentionsIn now 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 with OPERATION_UNKNOWN. A goal-result read 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 --self prints into the attempt record, without counting a failed attempt and without scheduling a retry. A successful cotal update after 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-sessions while 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 edit now 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 new now refuses a --role that is not a single NATS-safe token ([A-Za-z0-9_-]), as cotal persona create does, instead of saving it and suggesting a cotal spawn that refuses it. Nothing is written on the refusal, so --force no 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 up with no --store-dir reopens the store this folder's last broker served, such as a backup restore --store-dir target, when the default .cotal/nats holds no data, instead of refusing CONFLICT and 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, and up -f keeps its refusal.

  • Allow software updates past unreachable registered brokers when no local Manager of this installation serves their spaces, without changing the registrations.

  • cotal up now 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

Full Changelog: v0.165.4...v0.166.0