Skip to content

v0.135.0

Choose a tag to compare

@davidfarah-dev davidfarah-dev released this 02 Nov 18:16
f074312

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's subscribe gets its membership at startup. The root > and patterns with * stay live only.

    cotal_join refuses 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_channels lists a followed family with the state of its stored copies. When an agent's 1000 stored copies were full, its next cotal_inbox reply says earlier posts may have been dropped and points to cotal history <channel>.

    An agent definition whose subscribe names a pattern that no single allowSubscribe entry contains, such as perm.> under perm.*, is now refused when it is loaded, as cotal_join already refused it. cotal_persona writes nothing the manager could not load back, which also refuses a subscribe channel outside allowSubscribe. cotal_channels no 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_info refuses 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 in cotal down and cotal team count 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 up changes 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 boot and setup --start no longer report CHAT_HISTORY_MIGRATED. @cotal-ai/core no longer exports LEGACY_CHAT_HISTORY, isLegacyChatHistory or reconcileChatHistory, and setupSpaceStreams returns nothing; it still refuses a chat stream whose settings other than the limit are not canonical.

  • liveKvEntries and liveKvValues now declare separate (kv, options?) and (kv, filter, options?) overloads (and the matching decode pair on liveKvValues), 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_spawn takes once: true with a prompt to 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 unless deadline sets another, and -1 sets none. A spawn that succeeds names the task's goal in its result, and goal-result reads 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 no run capability.

    The manager's spawn command takes once: { 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-mode turn-unconfirmed command, which fails the task with delivery-unconfirmed and 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 every turn-pending with stop while its debt stays recorded.

    A connector declares supportsTurnRelay to take a once task: Jcode, OpenCode, pi and Claude Code do. A connector whose seat needs a confirmed startup declares onceNeedsConfirmed, and the manager serves its task only when the runtime reports the startup watch ended confirmed. Claude Code needs it: a once launch waits for Claude's development-channels prompt and then its confirmNotice, the line saying server:cotal messages reach the session. A runtime declares reportsStartupOutcome and its handles report startupOutcome(); the built-in pty runtime, tmux, cmux, herdr and orca do. A connector may declare turnFrameLimit, and a once prompt whose task does not fit it is refused at admission. A once exit registered with registerOnceExit may answer false to decline, and the seat then keeps reporting instead of exiting. A connector whose seat launches processes outside its own implements retireAfterExit, 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.

  • registerServiceInstance distinguishes 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 remain unavailable, 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 rm now resolves all requested space names from a single registry load, removes the accepted records in one removeMeshes batch call, and reads the current-mesh pointer 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 up names 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 printed restore listener INFO timed out with no attempt id. It now prints the same <kind> attempt <id> label as the rest of the listener proof, for example resume 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