Skip to content

v0.172.0

Choose a tag to compare

@davidfarah-dev davidfarah-dev released this 20 Nov 19:08
78cf3b4

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 setup and cotal daemon connect-check to cotal up for 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 --restore completes the restore.
  • Fix cotal after 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_DIR is 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 list without loading or repairing packages.
  • Move the body of the endpoint's channelMembers into its internal subscriptions component.
  • Split serve-credential authorization and the issuance fence out of endpoint-service.ts into an internal module that it re-exports.
  • Split the service registry's value shapes and validators out of endpoint-service.ts into 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.ts into an internal agent-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 opencode on 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.ts into an internal service-managed-agents.ts.
  • Move the authority plane's manager-service issuance, platform-supervisor end, endpoint deregistration and remote Manager maintenance operations out of service.ts into an internal service-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.ts into an internal service-manager-runs.ts.
  • Move the AuthAuthorityPlane interface out of service.ts into an internal service-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.ts into an internal service-routes.ts.
  • When cotal up cannot 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 --repair when 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 PermissionRequest and SubagentStop. The hook relay holds a PermissionRequest past 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 own agent endpoint, 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. AskUserQuestion and ExitPlanMode stay with Claude's dialog. On Windows the hook answers each permission itself with no decision and the connector warns once. MeshAgent.prompts exposes the agent's prompt desk to a connector. A connector can declare prompts, and every Manager status.connectors row now carries prompts, 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. HookHandle takes a third argument, the hook's connection context, so code that calls a handler typed as HookHandle passes 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 setup and cotal daemon connect-check to cotal up for 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 --restore completes the restore.

  • Fix cotal after 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_DIR is 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 list without loading or repairing packages.

  • Move the body of the endpoint's channelMembers into 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.ts into 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.ts into 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.ts into an internal agent-presence.ts. MeshAgent keeps 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 opencode on 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.ts into an internal service-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.ts into an internal service-manager-issuance.ts. service.ts re-exports authorizeRemoteManagerRetirement, 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.ts into an internal service-manager-runs.ts. The package surface is unchanged.

  • Move the AuthAuthorityPlane interface out of service.ts into an internal service-plane-types.ts. service.ts re-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.ts into an internal service-routes.ts. Both route tables stay in service.ts, which re-exports the two tool-result handlers, so the package surface is unchanged.

  • When cotal up cannot 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 --repair when 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

Full Changelog: v0.171.5...v0.172.0