Repository navigation
v0.154.0
Install or update: npm i -g cotal-ai@0.154.0
Restart running Cotal processes and agent sessions to use the new code.
What changed
- Daemon setup makes a computer ready to launch agents from its space.
- An agent can now give a helper it spawns endpoint commands it holds itself, by listing them in the helper's persona under
endpoints. - Expose an optional non-secret store-failure classification in service renewal state.
- Daemon setup recovers when no agent application was available.
- Keep machine-daemon commands available when preferences are malformed or the invoking project folder is missing or has a conflicting .cotal file.
- Hosted Managers refuse new launches when first-party connector generations differ from their running generation.
- Show invisible characters in CLI refusals as Unicode escapes so refused names cannot look like a different name.
- Workflow agent arguments now report a handle requirement instead of an internal error when given an agent name.
- Explain when a local space identity reset invalidates exported credentials.
- Status checks a silent broker once and reports it as not answering across space commands.
Every change in full
-
Daemon setup makes a computer ready to launch agents from its space.
The machine daemon supervises a stock Manager per space, resumes it after restart, and reports
launch-readiness separately from machine-service approval. Setup re-probes the pinned Manager on
reruns and reports its identity atmanager.instanceId, while top-levelinstanceIdremains the
machine-service registration. Use--no-managerfor connection-only setup;--waitrequires it.
Hosted status includes observation time, exit and stop diagnostics, and bounded private rotating logs.
Setup restarts a mismatched daemon through its recorded native service. Installed npm replacement
verifies the new entry before releasing the daemon to its recorded supervisor.cotal update
checks hosted custody and waits for hosted Manager readiness to return. Self-update also reloads
a mismatched default daemon from the same installation when it hosts no Managers.
Setup and update never restart a service pinned to another installation. Setup reuses compatible
hosting operations or names both installations and the reinstall choices. Update reports the
other daemon's installation and version after reconciling its own installation.
Update reports and skips hosted records without a live child, and gives a disconnect remedy for
live custody that cannot be confirmed. Native restart failures retain their cause and name
cotal daemon start; a failed rollback no longer hides the primary failure.
Update keeps its ordinary continuity checks when Linux has no runtime directory for a daemon.
New native jobs mark their launch, and generation activation verifies that marker against the
recorded same-install source before exiting for the supervisor.
Setup reports unsupported machine-service registration with the same state as service status and
preserves the provider session check in its sign-in step.
Setup requires an available connector in the hosted Manager's fresh status before reporting launch-ready,
and allows time for daemon reconciliation before Manager readiness.
Setup validates usage without installing or reconciling connector packages in the invoking shell.
The daemon reconciles stock connectors in its own environment before hosting and prepares the
default persona in the Manager's own catalog. A bare npm upgrade prepares idle Managers and
restarts first. The new daemon refuses stale connectors with a repair command and backed-off
retry, so the old generation never reopens launches after a partial shared-store reconciliation.
Uninstall removes only per-space hosting records and works with the default daemon home's lock file.
Corrupt hosting records refuse only their space and setup repairs them after readiness succeeds.
Periodic liveness uses the parent IPC channel without auth callouts and never restarts for the
daemon's own authority outage. Fresh pinned status probes withdraw stale readiness. Child recovery
requires repeated IPC misses and an empty-seat preservation fence. Stopped status retains the
Manager identity and observation, and daemon sign-in refusals consistently name daemon login.
Pending upgrades count seats without fencing admission, back off activation attempts, and show the
installed version and waiting cause in status. Foreground daemons stay running after replacement.
Endpoint limit refusals stop parsing immediately and allow already accepted finite replies a bounded
flush before closing the connection. -
An agent can now give a helper it spawns endpoint commands it holds itself, by listing them in the helper's persona under
endpoints.Each entry names an endpoint and its commands, such as
{ endpoint: com.example.orders, commands: [list] }, and may addinstanceIdto hand on the commands on one instance of the endpoint only. The field works in a persona file, in the inline persona oncotal_spawn, incotal_persona, and in a cotal-lang inlinespawn. On a static mesh the manager measures every command against the spawner's own issued credential and refuses, by name, any command the spawner cannot call. A workflow run's spawn is measured against what the run's starter held when the run was admitted. The helper's credential carries the commands from its first mint, and every renewal keeps them.cotal spawn --foregroundmints them for the operator's own seat. The orientation card lists the commands a seat was handed.cotal_describeandcotal_invoketake an optionalinstance, so an agent handed a command on one instance can call that instance and no other.For third-party endpoints, an issued static agent credential carries only untargeted, unjournaled commands, and the mint refuses any other shape, because a static despawn has no step that settles accepted work keyed to the retired agent. A despawn revokes the helper's ledger rows and evicts its live connections, but a credential copied off disk before then still works until it expires, as every static credential does.
A per-user auth mesh refuses a persona that names
endpoints, an empty list included, and the refusal points tocotal service-endpoint grant, which is how endpoint access is granted there. A manifest launch also refuses such a persona and points tocotal spawn --detach. Single-label endpoints such asmanagerand thedescribeandcancelcommands are refused.A persona file whose
endpointskey is not a valid list now fails to load, where the key used to be ignored. The manager cluster contract moves to revision 47, which addsendpointsto thespawnpersona record and todefine-persona.@cotal-ai/coreexportsparsePersonaEndpoints,lowerPersonaEndpoints,copyPersonaEndpointsand thePersonaEndpointtype, andLaunchOptsgainsendpoints, which connectors forward to the session asCOTAL_ENDPOINTS. -
Expose an optional non-secret store-failure classification in service renewal state. Report damaged daemon ready and renewal records as local-state conflicts rather than remote outages, preserving records and request IDs for deliberate recovery.
-
Daemon setup recovers when no agent application was available.
After one is installed, running setup again restarts an idle hosted Manager under its seat-preservation fence and reads application availability again. A Manager with active seats stays running and reports the seat cause. Missing-application remedies name the applications to install.Updating Cotal succeeds when a running machine daemon has no recorded user service. The update reports its PID and version and leaves it running.
-
Keep machine-daemon commands available when preferences are malformed or the invoking project folder is missing or has a conflicting .cotal file. Preserve machine-home validation and safety checks for ordinary project commands.
-
Hosted Managers refuse new launches when first-party connector generations differ from their running generation.
The daemon checks for a replaced installation before trusting the seed stamp. Refusals name the cause and the restart step for the recorded service or foreground daemon. Existing seats and stock Manager connector loading remain unchanged.
-
Show invisible characters in CLI refusals as Unicode escapes so refused names cannot look like a different name.
The shared operator renderer now covers format and default-ignorable characters, including astral characters, in both quoted errors and report fields. -
Workflow agent arguments now report a handle requirement instead of an internal error when given an agent name.
The refusal names the argument and directs authors to the value returned by spawn or participant before an effect is dispatched. -
Explain when a local space identity reset invalidates exported credentials.
Rejected credentials now name the local identity mismatch and a new mint with the original grants or profile. Reset previews and receipts warn that exported files need replacement after the next startup and remain on disk.
Agent replacement commands include
--no-personaso a preserved persona cannot add read channels or a task role to a replacement. The flag ignores persona defaults while preserving explicit grants and grants carried through--identity. -
Status checks a silent broker once and reports it as not answering across space commands.
The selected space's connection check is shared by its status rows and delivery probe.
Space listings preserve the slow-link diagnosis instead of reporting it as unreachable.
What's Changed
- fix(lang): diagnose agent names passed instead of handles by @davidfarah2003 in #6155
- fix(cli): show invisible characters in refused names by @davidfarah2003 in #6158
- feat(daemon): host a Manager per space from the machine daemon by @davidfarah2003 in #6159
- fix(cli): share status preflight and preserve silent broker diagnosis by @davidfarah2003 in #6160
- fix(daemon): identify ready and renewal store failures by @davidfarah2003 in #6157
- fix(cli): explain credentials invalidated by space identity reset by @davidfarah2003 in #6161
- fix(daemon): recover hosted setup after an agent application is installed by @davidfarah2003 in #6162
- fix(cli): decouple daemon commands from project context by @davidfarah2003 in #6163
- fix(daemon): pin hosted connector launches to the running generation by @davidfarah2003 in #6166
- docs(changeset): say setup refreshes applications only when none was available by @davidfarah2003 in #6167
- feat: hand endpoint commands to spawned helpers through the persona by @davidfarah2003 in #6164
- chore(release): version packages by @davidfarah2003 in #6156
Full Changelog: v0.153.1...v0.154.0