Repository navigation
v0.172.0
Install or update: npm i -g cotal-ai@0.172.0
Restart running Cotal processes and agent sessions to use the new code.
What changed
- A Claude Code seat that Cotal launches on a signed-in space now lets its owner answer Claude's tool permissions from another session, while Claude's own dialog stays open.
- Stop stalled self-update downloads without changing the installed version or counting an automatic update failure.
- Fix global updates from pnpm projects with Corepack and report npm refusals instead of a false registry outage.
- Connection instructions now recommend only the Cotal tools that the connection can call.
- Fix self-update in a separate Cotal home and npm prefix when another home's daemon is already listening at the shared endpoint.
- Keep npm downgrades compatible with idle retained connector sets and let installation and stack maintenance report unreadable connector selections without losing access to built-in commands.
- Update Cotal without stopping a selected local stack whose Manager belongs to a separate installation.
- Point
cotal daemon setupandcotal daemon connect-checktocotal upfor stopped local static-auth and open spaces instead of asking users to sign in or register the space again. - Show the restore attempt and a cleanup command you can copy when
cotal up --foreground --restorecompletes the restore. - Fix
cotalafter Volta or another npm package manager moves the installed package out of its staging directory. - The uninstall guide now shows how to remove the machine daemon before deleting the Cotal CLI.
- Linux updates use the validated per-user runtime when
XDG_RUNTIME_DIRis unset and report a partial self-update with a recovery command if the systemd user manager cannot activate the daemon. - Report missing or corrupt extension package metadata in
cotal ext listwithout loading or repairing packages. - Move the body of the endpoint's
channelMembersinto its internal subscriptions component. - Split serve-credential authorization and the issuance fence out of
endpoint-service.tsinto an internal module that it re-exports. - Split the service registry's value shapes and validators out of
endpoint-service.tsinto an internal module that it re-exports. - The space inventory now shows how to keep a renamed stopped project's new location, and plain create after forgetting it prints the exact adoption command.
- Inside a named open space's project, an unmatched loopback broker address now names the registered address instead of sending to
main. - Keep verified Cotal updates installed when a Codex or Claude configuration file is read-only, refresh the connector files that can be updated, and report any remaining configuration work.
- Move the mesh agent's own presence writes (status with its turn-boundary yield, activity, condition, model and cwd, and the chain that keeps them in call order) out of
agent.tsinto an internalagent-presence.ts. - When OpenCode is too old to start, the connector tells you to replace the executable it checked, not a non-executable file found earlier on PATH.
- Spawning OpenCode with an unsupported
opencodeon PATH now ends in one line that names the file, its version, the supported lines and how to install a supported OpenCode. - Move the authority plane's managed-agent operations (retained-agent validation, managed-agent enrollment and its verification, prepare-retirement and the runtime check) out of
service.tsinto an internalservice-managed-agents.ts. - Move the authority plane's manager-service issuance, platform-supervisor end, endpoint deregistration and remote Manager maintenance operations out of
service.tsinto an internalservice-manager-issuance.ts. - Move the authority plane's manager run operations (goal-index scan, admin and participation authorization, run submission, admission, cancellation and revocation, and run-attempt issuance) out of
service.tsinto an internalservice-manager-runs.ts. - Move the
AuthAuthorityPlaneinterface out ofservice.tsinto an internalservice-plane-types.ts. - Move the auth service's HTTP route handlers (chat sessions, the service endpoint host and authority routes, endpoint deregistration and the tool-result human-proof and consent routes) out of
service.tsinto an internalservice-routes.ts. - When
cotal upcannot bind a broker address that nothing listens on, its refusal now counts only connections on the address's own host or a wildcard. - Restart guidance explains how to clear an occupied broker port or recover a missing preserved store and keeps broker-only restarts from adding a manager.
- Point version and update checks to
cotal ext seed --repairwhen the extension manifest is unreadable or corrupt. - Keep up and down remedies runnable for the current installation, reject empty manifest and run targets, preserve missing-stack diagnoses in structured output, and refuse suspended brokers and busy bind hosts before starting a replacement.
Every change in full
-
A Claude Code seat that Cotal launches on a signed-in space now lets its owner answer Claude's tool permissions from another session, while Claude's own dialog stays open.
The plugin registers
PermissionRequestandSubagentStop. The hook relay holds aPermissionRequestpast its 2-second deadline once a proven connector has it, and the control server passes each handler a signal that aborts when the hook's connection closes. The connector opens each permission as a prompt on the agent's ownagentendpoint, offered for 7 days, and hands Claude the remote allow or deny. It settles a prompt from what Claude reports later: a closed hook connection, a batch that ran a call with the same scope, tool and input, or the end of that scope's turn. A call the remote deny refused is listed in Claude's batch with the deny's message as its result, and it does not count as a call that ran.AskUserQuestionandExitPlanModestay with Claude's dialog. On Windows the hook answers each permission itself with no decision and the connector warns once.MeshAgent.promptsexposes the agent's prompt desk to a connector. A connector can declareprompts, and every Managerstatus.connectorsrow now carriesprompts, true when the connector declares it and the mesh is user-auth. The Manager cluster advances to revision 52, whose closed status schema a revision-51 reader rejects.HookHandletakes a third argument, the hook's connection context, so code that calls a handler typed asHookHandlepasses one. -
Stop stalled self-update downloads without changing the installed version or counting an automatic update failure.
-
Fix global updates from pnpm projects with Corepack and report npm refusals instead of a false registry outage.
-
Connection instructions now recommend only the Cotal tools that the connection can call.
-
Fix self-update in a separate Cotal home and npm prefix when another home's daemon is already listening at the shared endpoint.
-
Keep npm downgrades compatible with idle retained connector sets and let installation and stack maintenance report unreadable connector selections without losing access to built-in commands.
-
Update Cotal without stopping a selected local stack whose Manager belongs to a separate installation.
-
Point
cotal daemon setupandcotal daemon connect-checktocotal upfor stopped local static-auth and open spaces instead of asking users to sign in or register the space again. -
Show the restore attempt and a cleanup command you can copy when
cotal up --foreground --restorecompletes the restore. -
Fix
cotalafter Volta or another npm package manager moves the installed package out of its staging directory. -
The uninstall guide now shows how to remove the machine daemon before deleting the Cotal CLI.
-
Linux updates use the validated per-user runtime when
XDG_RUNTIME_DIRis unset and report a partial self-update with a recovery command if the systemd user manager cannot activate the daemon. -
Report missing or corrupt extension package metadata in
cotal ext listwithout loading or repairing packages. -
Move the body of the endpoint's
channelMembersinto its internal subscriptions component. The method stays on the endpoint with the same overloads and behavior. The package's exports are unchanged. -
Split serve-credential authorization and the issuance fence out of
endpoint-service.tsinto an internal module that it re-exports. The package's exports are unchanged. -
Split the service registry's value shapes and validators out of
endpoint-service.tsinto an internal module that it re-exports. The package's exports are unchanged. -
The space inventory now shows how to keep a renamed stopped project's new location, and plain create after forgetting it prints the exact adoption command.
-
Inside a named open space's project, an unmatched loopback broker address now names the registered address instead of sending to
main. -
Keep verified Cotal updates installed when a Codex or Claude configuration file is read-only, refresh the connector files that can be updated, and report any remaining configuration work.
-
Move the mesh agent's own presence writes (status with its turn-boundary yield, activity, condition, model and cwd, and the chain that keeps them in call order) out of
agent.tsinto an internalagent-presence.ts.MeshAgentkeeps the status it reports and a forwarder for each member called from outside the family. The package surface is unchanged. -
When OpenCode is too old to start, the connector tells you to replace the executable it checked, not a non-executable file found earlier on PATH.
-
Spawning OpenCode with an unsupported
opencodeon PATH now ends in one line that names the file, its version, the supported lines and how to install a supported OpenCode. It no longer prints a line of the bundled connector and a stack trace. Any other launch refusal also ends in its one-line reason. -
Move the authority plane's managed-agent operations (retained-agent validation, managed-agent enrollment and its verification, prepare-retirement and the runtime check) out of
service.tsinto an internalservice-managed-agents.ts. The package surface is unchanged. -
Move the authority plane's manager-service issuance, platform-supervisor end, endpoint deregistration and remote Manager maintenance operations out of
service.tsinto an internalservice-manager-issuance.ts.service.tsre-exportsauthorizeRemoteManagerRetirement, so the package surface is unchanged. -
Move the authority plane's manager run operations (goal-index scan, admin and participation authorization, run submission, admission, cancellation and revocation, and run-attempt issuance) out of
service.tsinto an internalservice-manager-runs.ts. The package surface is unchanged. -
Move the
AuthAuthorityPlaneinterface out ofservice.tsinto an internalservice-plane-types.ts.service.tsre-exports the type, so the package surface is unchanged. -
Move the auth service's HTTP route handlers (chat sessions, the service endpoint host and authority routes, endpoint deregistration and the tool-result human-proof and consent routes) out of
service.tsinto an internalservice-routes.ts. Both route tables stay inservice.ts, which re-exports the two tool-result handlers, so the package surface is unchanged. -
When
cotal upcannot bind a broker address that nothing listens on, its refusal now counts only connections on the address's own host or a wildcard. A connection elsewhere on the machine that happens to share the port number no longer turns a TIME-WAIT into "an open connection's local end holds its port", so the next step stays "wait up to a minute". -
Restart guidance explains how to clear an occupied broker port or recover a missing preserved store and keeps broker-only restarts from adding a manager.
-
Point version and update checks to
cotal ext seed --repairwhen the extension manifest is unreadable or corrupt. -
Keep up and down remedies runnable for the current installation, reject empty manifest and run targets, preserve missing-stack diagnoses in structured output, and refuse suspended brokers and busy bind hosts before starting a replacement.
What's Changed
- test(smoke): end the console browser's process group at teardown by @davidfarah-dev in #8229
- fix(update): ignore unrelated daemons during self-update by @davidfarah-dev in #8227
- fix(update): verify Linux daemon activation by @davidfarah-dev in #8215
- fix(connector-opencode): refuse an unsupported OpenCode in one line by @davidfarah-dev in #8233
- fix(cli): guard up and down targets and broker startup by @davidfarah-dev in #7704
- refactor(connector-core): move the agent's presence writes into a component by @davidfarah-dev in #8203
- refactor(auth): move the AuthAuthorityPlane interface into its own module by @davidfarah-dev in #8206
- refactor(auth): move the manager-service issuance operations into their own module by @davidfarah-dev in #8207
- test(workspace): classify the agent's two presence forwarders in the presence-render census by @davidfarah-dev in #8250
- docs(install): remove the machine daemon before the CLI by @davidfarah-dev in #8253
- fix(mcp): align connection instructions with served tools by @davidfarah-dev in #8254
- fix(cli): recommend repairing corrupt extension manifests by @davidfarah-dev in #8252
- fix(cli): count only sockets that can hold the broker address in a bind refusal by @davidfarah-dev in #8259
- fix(cli): show the foreground restore receipt by @davidfarah-dev in #8251
- test(scripts): bound the foreign container finish by the end of the inspect that reported it by @davidfarah-dev in #8263
- fix(workspace): refuse unmatched loopback aliases in open projects by @davidfarah-dev in #8255
- fix(cli): bound self-update package staging by @davidfarah-dev in #8257
- fix(update): leave Managers from other installations running by @davidfarah-dev in #8258
- fix(daemon): recognize stopped local spaces by @davidfarah-dev in #8256
- fix(cli): show recovery for moved stopped spaces by @davidfarah-dev in #8260
- fix(cli): make stack restart guidance actionable by @davidfarah-dev in #8029
- refactor(core): move endpoint channelMembers into the subscriptions component by @davidfarah-dev in #8204
- refactor(core): split service spec and status shapes out of endpoint-service by @davidfarah-dev in #8239
- refactor(core): split serve-grant authorization and the issuance fence out of endpoint-service by @davidfarah-dev in #8240
- refactor(auth): move the managed-agent operations into their own module by @davidfarah-dev in #8208
- refactor(auth): move the manager-run operations into their own module by @davidfarah-dev in #8209
- refactor(auth): move the HTTP route handlers into their own module by @davidfarah-dev in #8210
- test(core): bind the functions two endpoint mutation records call by @davidfarah-dev in #8245
- fix(update): preserve read-only harness configuration by @davidfarah-dev in #8261
- fix(cli): isolate global npm updates from projects by @davidfarah-dev in #8271
- feat: answer Claude Code tool permissions on the agent endpoint by @Manas-Kenge in #8309
- test(daemon): run the no-connectors setup rig with the service's pinned PATH by @davidfarah-dev in #8327
- test(smoke): exempt the live Claude permission prompts suite from the gate by @davidfarah-dev in #8328
- ci(upgrade-matrix): take the released desktop package from its release by @davidfarah-dev in #8331
- fix(update): preserve downgrade-compatible connector selections by @davidfarah-dev in #8269
- fix(npm): resolve the launcher after relocation by @davidfarah-dev in #8270
- fix(connector-opencode): name the executable that answered the version probe by @davidfarah-dev in #8329
- fix(cli): report missing or corrupt extensions in inventory by @davidfarah-dev in #8330
- chore(release): version packages by @davidfarah-dev in #8232
Full Changelog: v0.171.5...v0.172.0