Repository navigation
v0.135.0
Install or update: npm i -g cotal-ai@0.135.0
Changes in this release
-
An agent can follow a channel family such as
team.>and still get the posts it missed while away. The family holds a durable membership of its own, keyed with its final>stored as=, and each channel under it keeps its own delivery class, so the agent gets stored copies of posts on the durable channels and live delivery on the rest. It gets one copy of each post even when it also joined the channel by name. A family in an agent file'ssubscribegets its membership at startup. The root>and patterns with*stay live only.cotal_joinrefuses a name that is no channel name, checks a pattern against the read ACL by containment, and says whether a join keeps stored copies.cotal_channelslists a followed family with the state of its stored copies. When an agent's 1000 stored copies were full, its nextcotal_inboxreply says earlier posts may have been dropped and points tocotal history <channel>.An agent definition whose
subscribenames a pattern that no singleallowSubscribeentry contains, such asperm.>underperm.*, is now refused when it is loaded, ascotal_joinalready refused it.cotal_personawrites nothing the manager could not load back, which also refuses asubscribechannel outsideallowSubscribe.cotal_channelsno longer warns of a backstop on a channel read only through a pattern with*, shows a nested family as covered by the family above it, and shows a family the broker stopped the agent reading as no longer followed while its stored copies close.cotal_channel_inforefuses a name that is no channel name.cotal channel members, the console topology and the web graph show a family follower as a durable member of the durable channels under the family, and the removal checks incotal downandcotal teamcount it on every channel under it. The graph draws those links once it has read each channel's delivery class. The manager purges a retired agent's family row. -
Channel history has no age limit by default again. A space keeps a channel post until its sender has posted 1000 newer ones on that channel, as it did up to 0.133.13, and an age applies only when an operator sets one with
cotal history limit.An upgrade no longer moves or deletes posts. 0.134.0 moved every existing space to a 30-day limit at its first
cotal up, which deleted every channel post older than 30 days. That move is gone:cotal upchanges no space's limit, and a space that 0.134.0 already moved keeps its 30-day limit until an operator changes it.cotal up,team bootandsetup --startno longer reportCHAT_HISTORY_MIGRATED.@cotal-ai/coreno longer exportsLEGACY_CHAT_HISTORY,isLegacyChatHistoryorreconcileChatHistory, andsetupSpaceStreamsreturns nothing; it still refuses a chat stream whose settings other than the limit are not canonical. -
liveKvEntriesandliveKvValuesnow declare separate(kv, options?)and(kv, filter, options?)overloads (and the matchingdecodepair onliveKvValues), and refuse a call that passes options in the filter slot followed by a second options argument instead of dropping the trailing options. This is a breaking call-shape restriction: combine the signal and callbacks into one options object. -
cotal_spawntakesonce: truewith apromptto start a helper for one task. The manager relays the prompt to the helper as its only turn and stops the helper when that turn ends or when the deadline passes. The deadline is one hour unlessdeadlinesets another, and-1sets none. A spawn that succeeds names the task's goal in its result, andgoal-resultreads how it ended. A task that ends without the helper ending its turn may have run in part or in full, and nothing runs it again. A once spawn needs noruncapability.The manager's
spawncommand takesonce: { deadlineMs }, and the manager contract revision is 44. The task is served only after the spawn's succeeded terminal is written, so a manager that restarts before then cancels the task as never served. A seat hands a once task to its harness at most once. When it cannot confirm the harness took the task, it reports that with the new self-modeturn-unconfirmedcommand, which fails the task withdelivery-unconfirmedand stops the seat. A manager that inherits a once seat it cannot hold ends the task without serving it, says so in the outcome, and answers that seat's everyturn-pendingwithstopwhile its debt stays recorded.A connector declares
supportsTurnRelayto take a once task: Jcode, OpenCode, pi and Claude Code do. A connector whose seat needs a confirmed startup declaresonceNeedsConfirmed, and the manager serves its task only when the runtime reports the startup watch endedconfirmed. Claude Code needs it: a once launch waits for Claude's development-channels prompt and then itsconfirmNotice, the line sayingserver:cotalmessages reach the session. A runtime declaresreportsStartupOutcomeand its handles reportstartupOutcome(); the built-in pty runtime, tmux, cmux, herdr and orca do. A connector may declareturnFrameLimit, and a once prompt whose task does not fit it is refused at admission. A once exit registered withregisterOnceExitmay answer false to decline, and the seat then keeps reporting instead of exiting. A connector whose seat launches processes outside its own implementsretireAfterExit, and the manager keeps the task's debt until that hook proves them gone. Jcode records each native launch of a once seat under the seat's uid for that proof, and a Jcode once seat always starts a fresh session, never one an earlier seat of the same name left in its home. -
registerServiceInstancedistinguishes a reopen that lost its compare-and-set from one whose outcome is unknown. Both its Phase-4 and abort refusals tell the caller to re-read the gate rather than asserting it stayed frozen when the write may have committed. Both remainunavailable, and the abort refusal retains its original cause. -
Freeze lazy service contract tables and their input/output pairs so callers cannot replace a command's validators. This also makes the exported registry contract table immutable. Commands still compile only on first access.
-
Release each completed batched KV read's native reply subscription immediately through the native callback API, instead of retaining it until its five-second timeout. Paging, empty reads, tombstones and permission refusals remain unchanged.
-
Settle pending named-reply control, delivery and delivery-admin requests when their connection closes instead of leaving their promises pending after the reply subscription disappears. Interrupted liveness probes return unknown. Keep native reply subjects, timeout and no-responder handling, and do not replay requests on a replacement connection.
-
Explain Jcode model-route verification failures with the requested model and effort, reported runtime identity, matching-route count and refusal reason. Keep arbitrary provider output private and leave startup verification unchanged.
-
cotal meshes rmnow resolves all requested space names from a single registry load, removes the accepted records in oneremoveMeshesbatch call, and reads thecurrent-meshpointer once for the batch instead of once per name. Each completed removal is reported and its selection cleared before the next removal, so a later filesystem failure cannot hide earlier progress. -
cotal upnames the attempt when a recovered listener fails its NATS INFO read. The read used to report every failure as a restore listener failure, so an ordinary resume that timed out printedrestore listener INFO timed outwith no attempt id. It now prints the same<kind> attempt <id>label as the rest of the listener proof, for exampleresume attempt <id> listener INFO timed out.
What's Changed
- test(manager): force the describe split through the per-command handle cache by @davidfarah2003 in #5620
- test(ci): expect the --silent suite argv in the mutation-policy test by @davidfarah2003 in #5621
- fix(auth): keep the authority envelope parser's refusals a named 400 by @davidfarah2003 in #5623
- feat(connector-jcode)!: mirror Jcode's four Cursor keys and refuse an unreadable database by @davidfarah2003 in #5476
- feat: list the endpoints an agent can call with cotal_endpoints by @davidfarah2003 in #5499
- test(smoke): read MDX code fences and spans as text in the required-arg census by @davidfarah2003 in #5626
- test(smoke): count the endpoints listing's standaloneConnectOpts sites in the required-arg census by @davidfarah2003 in #5627
- feat(connectors): hand every agent one briefing and its orientation card by @davidfarah2003 in #5097
- test(manager): bind the restart-fence clients through a describe and read the retried command's handle by @davidfarah2003 in #5628
- test(core): respect readonly cleanup in reconnect smoke by @davidfarah2003 in #5443
- feat(connectors): let a spawn hand on channels and name the next call on a refused send by @davidfarah2003 in #5184
- test(connector-jcode): give the queue-fallback control socket a short directory of its own by @davidfarah2003 in #5629
- feat(core)!: limit how long a space keeps channel posts by @davidfarah2003 in #5403
- test(cli): send roster-head keys after the App can take them and stamp the wrap seats ahead of the clock by @davidfarah2003 in #5630
- test(workspace): grade the cutover preflight refusal by what it now says by @davidfarah2003 in #5631
- test(smoke): count the Hermes sidecar's copy of every manager-call connection in the required-arg census by @davidfarah2003 in #5632
- test(workspace): follow the reworded history gap note in the presence census by @Manas-Kenge in #5634
- chore(release): version packages by @davidfarah2003 in #5624
- feat: spawn a helper for one task with cotal_spawn once by @davidfarah2003 in #5518
- fix(core): freeze lazy service contract tables by @davidfarah2003 in #5645
- test: reconcile census guards with registry and new manager capabilities by @davidfarah2003 in #5646
- test(claude): use an unstarted agent for gateway connection ownership by @davidfarah2003 in #5647
- test(ci): account for Remotion in PR-head workflow fixtures by @davidfarah2003 in #5648
- test: align live fixtures with lazy issuance and sender validation by @davidfarah2003 in #5649
- fix(smoke): report native seat load failures accurately by @davidfarah2003 in #5650
- test: account for once-task connections in the required-argument census by @davidfarah2003 in #5651
- fix(cli): identify the attempt in listener INFO failures by @davidfarah2003 in #5652
- test(workspace): exercise canonical process record paths by @davidfarah2003 in #5654
- feat(smoke): add bounded native endpoint error diagnostics by @davidfarah2003 in #5653
- fix(core): settle control requests when their connection closes by @davidfarah2003 in #5656
- fix(smoke): classify wrapped native endpoint errors by @davidfarah2003 in #5655
- docs(auth): document generic HTTP server failures by @davidfarah2003 in #5657
- fix(cli): batch mesh removal without hiding partial progress by @davidfarah2003 in #5659
- fix(core)!: reject duplicate KV scan options by @davidfarah2003 in #5660
- fix(jcode): explain model route verification refusals by @davidfarah2003 in #5661
- test(core): identify native presence warning context by @davidfarah2003 in #5662
- fix(core): distinguish registration reopen outcomes by @davidfarah2003 in #5663
- fix(remotion): pair each wire with its glow by @davidfarah2003 in #5664
- fix: keep channel history with no age limit by default by @davidfarah2003 in #5665
- feat: catch up agents that follow a channel family by @davidfarah2003 in #5666
- fix(core): release completed direct-read reply subscriptions by @davidfarah2003 in #5667
- chore(release): version packages by @davidfarah2003 in #5644
Full Changelog: v0.133.13...v0.135.0