Repository navigation
v0.165.0
Install or update: npm i -g cotal-ai@0.165.0
Restart running Cotal processes and agent sessions to use the new code.
What changed
- The owner of a Claude agent launched in a permission mode that asks can now approve or deny its permission prompts from another session, while Claude's own dialog keeps working.
- Correct contract validation for admitted JSON Schema 2020-12 references and evaluated annotations.
- Agent files now refuse
cwdandworktreefrontmatter instead of silently ignoring the requested directory. - Retain and verify a Linux migration's Node executable beside the existing native package generation, binding both in the maintenance resume document under the root and installation locks.
- Staged updates now remove abandoned staging folders and finished transactions while keeping all execution generations.
- Daemon login and setup now report invalid provider URLs as usage refusals without echoing or recording the rejected URL.
- Keep a manually reinstalled CLI usable when another account's old generation store is unreadable.
- Read the newest chat messages across a channel family without listing every concrete channel.
- A channel post that mentions an agent who may not read the channel no longer drops that mention silently.
- Pin
@nats-io/nkeysto 2.0.3. - An authenticated seat whose DM durable is gone after a broker outage or restore now says so.
- A refusal for a missing required property names the property again, for example
must have required property 'windowMs'. - Add a retained maintenance-lock check and pre-stop controller identity observation for migration hosts.
- Protect daemon state inside a redirected Cotal home from being used as a project folder.
- The terminal app can open a managed agent's live terminal in its middle column and type into it.
- The Claude Code plugin no longer rewrites a
cotal_connectcall to add the session. - Report harness work timestamps across the Claude Code, Codex, Hermes, OpenCode and pi connectors.
- Pause automatic redelivery after a Codex message has failed three turns.
- A Jcode seat no longer reports
donefor a manager turn its model never received. - Provider HTTP 4xx readiness refusals now report a client-error category instead of an unknown startup failure.
- Report a self-update refused before any change as a refusal instead of an unknown outcome.
- An attached terminal now reports that the agent exited when the agent's own process ends, instead of reporting that it was stopped.
- Restore named inspection, model-pin audits and helper shutdown for managed static control sessions on their holding manager.
- Stop unfinished legacy dashboard delete uploads after ten seconds without changing the channel.
Every change in full
-
The owner of a Claude agent launched in a permission mode that asks can now approve or deny its permission prompts from another session, while Claude's own dialog keeps working.
The first answer applies, and a denial's note reaches Claude as the reason. The connector holds each prompt on Claude's
PermissionRequesthook and keeps one record per prompt in the newcotal_permissions_<space>bucket, which space setup creates and a restore recreates empty. An owner's interactive principal reads the records by binding its own lifecycle'sperm_pull consumer, which a provisioner opens withCotalEndpoint.openPermissionReader; no principal can create a consumer on the bucket. Answers ride the newcotal.<space>.perm.<agentOwner>.<agentActor>.<runtimeId>.<owner>.<actor>rail to the one process that holds the prompt, and only the owner's interactive principals may publish there, so no agent's credential can answer its own prompt or a sibling's. A Yes at the terminal settles only prompts of the scope that ran it, so a background subagent's prompt survives the main thread's turn.CotalEndpointgainsopenPermissionHolder,openPermissionReader,watchPermissionsandanswerPermission, and theapprovalpresence condition can name the held prompt inrequest. Every Managerstatus.connectorsrow now reportspermissionRequests, true only on a user-auth mesh, and the Manager cluster advances to revision 50. A static mint refuses to mark a credential interactive, and on an open mesh prompts stay with the terminal. See SPEC §8.2. -
Correct contract validation for admitted JSON Schema 2020-12 references and evaluated annotations.
Instance validation now uses json-schema-library 11.6.16, while Ajv retains schema meta-validation.
The synchronous validator exposes backend-neutral errors instead of Ajv metadata. Generated browser
contract modules import the shared interpreter and must be regenerated with this release. -
Agent files now refuse
cwdandworktreefrontmatter instead of silently ignoring the requested directory.
Set the directory on the spawn request with--cwd. Other unmodeled scalar hints still round-trip throughmeta. -
Retain and verify a Linux migration's Node executable beside the existing native package generation, binding both in the maintenance resume document under the root and installation locks. This adds no public migration or activation command; controller preservation remains unsupported until its complete custody integration is available.
-
Staged updates now remove abandoned staging folders and finished transactions while keeping all execution generations.
Cleanup runs under the installation's update lock when an update starts, after it succeeds, and when the daemon starts. It skips another account's store and reports removal failures without failing the update. -
Daemon login and setup now report invalid provider URLs as usage refusals without echoing or recording the rejected URL. Validation runs before account selection or native setup effects, and help consistently describes auth URLs and discovery hostnames.
-
Keep a manually reinstalled CLI usable when another account's old generation store is unreadable.
A plain start leaves inaccessible retired descriptors untouched and runs the installed version.
-
Read the newest chat messages across a channel family without listing every concrete channel.
CotalEndpoint.multiChannelHistory(["events.>"], { limit })uses one broker filter and returns
the same subject-tagged, stream-ordered rows as the equivalent concrete-channel read.
The family must be the only filter, and the broker still enforces the caller's existing grants. -
A channel post that mentions an agent who may not read the channel no longer drops that mention silently. On an authenticated mesh the delivery daemon sends the post's sender a mention notice that names those agents, so the sender can reach them another way. The connectors show it as
[mention notice from the delivery daemon], and Hermes runs it in its ownnotice:mentionchat. -
Pin
@nats-io/nkeysto 2.0.3. Its 2.1.0 release no longer exposes the module the credential signer imports, so every fresh install and every update crashed at start withERR_PACKAGE_PATH_NOT_EXPORTED. -
An authenticated seat whose DM durable is gone after a broker outage or restore now says so.
cotal_reconnectand theconnectionIssueincotal_connection_statusname the missing durable and the recovery: restart the session, or respawn it if a manager launched it. Before, reconnect reported a bare "consumer not found" and offered retries that could never bring the durable back, and status gave no reason. The endpoint now fails that rebind withdm-durable-missing. Open-mesh seats still recreate their durable on reconnect. -
A refusal for a missing required property names the property again, for example
must have required property 'windowMs'. -
Add a retained maintenance-lock check and pre-stop controller identity observation for migration hosts.
The observation binds the controller operation, member launches, broker configuration and store identity without stopping services or admitting a migration. Controller preservation and restore commands remain unsupported.
-
Protect daemon state inside a redirected Cotal home from being used as a project folder.
Space creation and startup now treat the daemon record directory and its descendants as control paths, while still allowing project folders beside the home's records.
-
The terminal app can open a managed agent's live terminal in its middle column and type into it.
openTerminalSession()from@cotal-ai/workspace/attachopens one attach session for a caller that draws the terminal itself. It locates and pins the seat asattachSeat()does, honorsexpectedTarget, touches no process terminal, does not reconnect, and returns every refusal as a message. Itsclose()hands the session back to the manager. -
The Claude Code plugin no longer rewrites a
cotal_connectcall to add the session. The server uses the one native session it has already bound. -
Report harness work timestamps across the Claude Code, Codex, Hermes, OpenCode and pi connectors.
Relay work events into the existing presence
activeAtfield so roster and operator surfaces can date the last reported work separately from heartbeats. No new wire field or progress verdict is added. Boundary-only hosts report less frequently than streaming hosts, and work age cannot distinguish a slow provider from a hung one. -
Pause automatic redelivery after a Codex message has failed three turns.
The first turn and two retries share one budget across broker redelivery while the message remains buffered. Exhausted messages stay unacknowledged and readable with cotal_inbox. The host log and seat status name them, and unrelated messages can still run. A host-process restart starts a new budget. Model output alone never acknowledges a message.
-
A Jcode seat no longer reports
donefor a manager turn its model never received.Jcode acknowledges a message before it checks whether the API connection is still processing an earlier one, and then refuses the busy send with
Already processing a message. The acknowledgement marked the send's manager turns as delivered, so a refused turn was never offered again. It settled asdoneat the seat's next turn boundary, or waited out its deadline when no boundary came. When the refusal answers the connector's latest send, those turns now go back to waiting and are sent again once the running native turn ends.MeshAgent.unsurfaceTurns()hands run turns back this way; a once task's confirmed handoff is unchanged. -
Provider HTTP 4xx readiness refusals now report a client-error category instead of an unknown startup failure. Existing authentication, payment, permission, rate-limit and model-refusal diagnostics keep their categories, and provider response text stays private.
-
Report a self-update refused before any change as a refusal instead of an unknown outcome.
The initial execution check preserves its reason and owning install command, states that no changes were made, and exits with the boundary-refusal code. Failures after update work begins keep their existing outcome handling.
-
An attached terminal now reports that the agent exited when the agent's own process ends, instead of reporting that it was stopped.
The manager ended every live attach session with
target-despawnwhen it freed a seat, and its exit watcher runs before the session sees the process exit, so a natural exit reached the caller as a stop. A seat that exits on its own, including the last exit of a spent restart budget, now ends its sessions withprocess-exit. A stop, a reap and a failed restart still end them withtarget-despawn, and a child the manager stops because its parent exited is logged as reaped instead of as exiting on its own. The session also sends the seat's last output before its end frame, which the coalescing buffer used to drop when the exit watcher ended the session first. -
Restore named inspection, model-pin audits and helper shutdown for managed static control sessions on their holding manager.
Keep instance reads within the spawner's issued authority, preserve workflow starter ceilings without adding implicit reads to run-spawned helpers, and renew each seat with its original issued scope.
-
Stop unfinished legacy dashboard delete uploads after ten seconds without changing the channel.
The body deadline returns HTTP 408 and closes the connection even when the caller keeps sending small chunks. The existing 8 KiB limit and read-only service refusal are unchanged.
What's Changed
- test(matrix): import @cotal-ai/core by name in the native fixture and retire the #6802 refusal by @davidfarah-dev in #6898
- fix(manager): restore holding-instance reads for static spawners by @davidfarah-dev in #6907
- revert(manager): holding-instance reads for static spawners by @davidfarah-dev in #6910
- fix(core)!: refuse directory keys in agent files by @davidfarah-dev in #6911
- test(workspace): declare the win32 update job suite skipped off Windows by @davidfarah-dev in #6877
- test(cli): print the shard sentinel from the update extension-set suites by @davidfarah-dev in #6853
- fix(connector-claude-code): stop rewriting cotal_connect input by @davidfarah-dev in #6684
- fix(web): bound legacy delete body uploads to ten seconds by @davidfarah-dev in #6912
- fix(connectors): relay harness work into presence activity timestamps by @davidfarah-dev in #6913
- fix(web): describe the delete body deadline in the dashboard API source by @davidfarah-dev in #6915
- fix(core)!: correct admitted contract validation verdicts by @davidfarah-dev in #6918
- docs(agent-files): say what a saved persona without channel fields can reach by @davidfarah-dev in #6914
- fix(core): support newest history across one channel family by @davidfarah-dev in #6919
- test(workspace): follow the delete deadline in the presence render census anchor by @davidfarah-dev in #6920
- test(core): allow the contract validator subpath in the frozen exports proof by @davidfarah-dev in #6921
- fix(desktop): stage only the validator library's ESM entry by @davidfarah-dev in #6922
- fix(connector-jcode): classify remaining readiness HTTP 4xx refusals by @davidfarah-dev in #6923
- test(cli): match the bundled warning registration by parameter name by @davidfarah-dev in #6924
- test(auth): distinguish idle issuers in the callout retry soak by @davidfarah-dev in #6926
- fix(core): name the missing property in a contract refusal by @davidfarah-dev in #6927
- fix(update): retire old staged execution data under the update lock by @davidfarah-dev in #6909
- test(manager): publish reconnect fixture holder binding by @davidfarah-dev in #6916
- test(update): run the execution store cleanup smoke under its own Cotal home by @davidfarah-dev in #6930
- test: publish holding manager in managed seat fixtures by @davidfarah-dev in #6964
- fix(manager): restore bounded static holding-instance reads by @davidfarah-dev in #6962
- fix(smoke): refresh explicit TLS argument census by @davidfarah-dev in #6972
- fix(daemon): classify invalid provider URLs as usage refusals by @davidfarah-dev in #6973
- fix(smoke): isolate fixture registry homes by @davidfarah-dev in #6974
- test(hermes): isolate close-diagnostic probe credentials by @davidfarah-dev in #6975
- fix(update): start installed CLI beside unreadable retired stores by @davidfarah-dev in #6965
- test(core): align vitals grant smoke with baseline self calls by @davidfarah-dev in #6977
- feat(connector-claude-code): relay permission prompts to the agent's owner by @Manas-Kenge in #6493
- fix(codex): pause messages after three failed turns by @davidfarah-dev in #6970
- feat(cli): bind controller identities before migration custody by @davidfarah-dev in #6969
- fix(ci): refuse assertion results after a final tally by @davidfarah-dev in #6971
- test(manager): align stock restart smoke with in-process pty by @davidfarah-dev in #6980
- test(update): accept installed-entry launchd handoffs by @davidfarah-dev in #6984
- fix(workspace): protect daemon home records from project creation by @davidfarah-dev in #6985
- test(cli): isolate renewal honesty smoke home by @davidfarah-dev in #6987
- fix(smoke): stage connector payloads when building daemon fixtures by @davidfarah-dev in #6988
- docs(upgrade): explain stopped legacy automatic updates by @davidfarah-dev in #6986
- test(daemon): keep the account heartbeat out of the H2 GET-only check by @davidfarah-dev in #6979
- test(connector-claude-code): start the live permission broker under the smoke token by @davidfarah-dev in #6982
- test(ext): check materializer closure waiting and resumption by @davidfarah-dev in #6990
- fix(manager): repair remote continuity transport witnesses by @davidfarah-dev in #6991
- test: let connector host smoke finish graceful shutdown by @davidfarah-dev in #6992
- test(daemon): align account setup journey with provider selection by @davidfarah-dev in #6993
- test(cli): declare MCP server for foreground stack fixture by @davidfarah-dev in #6996
- test(manager): print static-helper-control checks as counted rows by @davidfarah-dev in #6967
- test(workspace): classify permission hook control states by @davidfarah-dev in #6997
- fix(manager): end an attach with process-exit when the agent exits on its own by @Manas-Kenge in #6963
- fix(cli): report initial self-update refusals accurately by @davidfarah-dev in #6976
- feat(tui): attach to a managed agent's terminal in the middle column by @Manas-Kenge in #6931
- test(claude): match the registered cotal server in live smokes by @davidfarah-dev in #6999
- fix(ci): run validator acquisition in its own workspace copy by @davidfarah-dev in #6989
- feat(cli): retain migration Node beside native execution generations by @davidfarah-dev in #6983
- test(daemon): gate manual admission at staged publication boundaries by @davidfarah-dev in #7001
- test(cli): align fresh-home smoke checks with Cloud sign-in guidance by @davidfarah-dev in #7002
- test(cli): run space-registration's structured suite last in its chain by @davidfarah-dev in #6995
- fix(connector-jcode): offer a busy-refused turn again instead of yielding done by @davidfarah-dev in #7004
- fix(connector-core): name the missing DM durable and the respawn route on reconnect by @davidfarah-dev in #7008
- fix(core): pin @nats-io/nkeys to 2.0.3 by @davidfarah-dev in #7076
- fix(delivery): tell a sender when a mention names an agent who cannot read the channel by @davidfarah-dev in #7082
- chore(release): version packages by @davidfarah-dev in #6908
Full Changelog: v0.164.18...v0.165.0