Repository navigation
v0.171.0
Install or update: npm i -g cotal-ai@0.171.0
Restart running Cotal processes and agent sessions to use the new code.
What changed
- An agent owner's interactive session can now list an OpenCode 2.x agent's own commands and skills and run one, such as
/review, which waits for the agent's next idle turn and can be cancelled until it starts, and the broker refuses every other caller. - Clarify how to identify the broker executable, answer or resume a workflow, preview a team without its applications, and interpret the dashboard credential in
doctor auth. - Reject malformed space names in daemon status, report unregistered spaces when connecting, and keep nonexistent Managers out of status after disconnect.
- Keep shell installs working when the system Node executable is upgraded, explain how to reinstall npm copies after a Node upgrade, and document curl-free and noncolliding install options.
- Let manual self-updates on Linux restart a prepared machine daemon, and let future daemons give a slow version probe more time on retry.
- Fix Linux daemon installation when an owned group-writable systemd unit directory sits below a private directory that other accounts cannot traverse.
- On Windows, daemon installation now gives the initial Task Scheduler lookup up to 60 seconds to finish before refusing.
- Codex setup lists its configuration and plugin files in the JSON receipt, status reports disabled plugins, and updates leave read-only Codex configuration unchanged.
- Move the endpoint's boot durable self-join and its reconcile into an internal module without changing the endpoint API.
- Move the endpoint's stream creation and durable provisioning into an internal module without changing the endpoint API.
- Internal refactor: the per-profile permission builders now live in their own module.
- Restarting a local stack no longer leaves unused manager goal-index consumers, and channel replay windows are saved without surrounding whitespace.
- Hosted workflow starts include syntax diagnostics in JSON refusals, and simulations reject invalid handoff destinations, nonnumeric clock starts, and duplicate script keys.
- Keep the right project in CLI recovery steps for unreachable brokers, stopped spaces, and missing managers, and keep component health consistent when a broker URL has a trailing slash.
- List meshes and save preferences without installing connectors, reject malformed commands and conflicting seed modes before seeding, and direct users with a corrupt extension manifest to
cotal ext seed --repair. - Show the restart step for a stopped local space that stays registered, give equivalent broker URLs the same recovery advice, and allow a named reset of an isolated stopped open space.
cotal statusandcotal psnow tell you to repair an invalid.cotal/channels.jsonbefore restarting a stopped local stack.- Separate the workspace's persisted identity records into an internal module without changing the package API.
- Internal refactor: the inbox item types, limits and helpers now live in their own module.
- Move the Jcode host's module-level support code (timing bounds, the bridge-recovery classifier, the seat home, MCP config, relay server and env scrub) out of
host.tsintohost-support.ts. - A Jcode seat now stops its TUI before its server, on a normal stop and when a launch fails.
- Move the OpenCode plugin's shared seams (retirement and settle tokens, the model refusal check, the bounded settle and the surfaced inbox batch) out of
plugin.tsintoplugin-seams.ts. - Mark endpoint work commands as unavailable, hide the web-only
--no-openoption from manager start help, and preserveps --slotsin manager selector errors. - History reports older direct messages only when the read finds an omission, and live follow honors time-based
--sincecutoffs. - Reject an empty setup project, mark forced legacy mesh registrations as unchecked, and refuse unsafe credential output paths without creating directories.
- Report an empty
spawn --resumeas a usage error in both launches and previews, exitjoincleanly when/quitis pasted after a status command, and stop the plain console without a false broker outage warning. - Local cleanup refusals tell you to remove only the unsupported mesh flags and their values, so a retry keeps options such as
--force,--dry-runand--store-dir. - Configure-only setup no longer needs a runnable NATS server, setup names the install command for a missing built-in connector, and slow connector setup no longer expires the broker startup credential.
- Report missing member records in
cotal statuswhen a live stack's journal does not name its launching Cotal home, even if the current home has prepared a space in that folder. - Reject persona imports with invalid UTF-8 and keep the requested space or server in the edit and removal commands shown when a persona already exists.
- Keep foreground service stop receipts intact and reject unsupported preset start options in dry runs before saving the definition.
- Make
space showexplain explicit selections and give working recovery commands for renamed stopped projects. - Move the renewal of the manager's own standing credentials into its own component without changing the manager API.
- Move the goal-writer connection and the goal index it reconciles into its own component without changing the manager API.
- Move the core of agent start into the launch component without changing the manager API.
- Move the agent-start path out of the launch component into its own component without changing the manager API.
- The
cotal run showhelp now explains that--limitapplies only to text output and cannot be combined with--json. - Separate the mesh handler's turn and ask clients into an internal module without changing the runtime API.
- Move the web dashboard's request input and operator text handling (caller errors, body caps, operator quoting and escaping, and channel, history, agent-id and tap parsing) out of
web.tsintoweb-request.ts.
Every change in full
-
An agent owner's interactive session can now list an OpenCode 2.x agent's own commands and skills and run one, such as
/review, which waits for the agent's next idle turn and can be cancelled until it starts, and the broker refuses every other caller.@cotal-ai/coreadvances theagentendpoint's cluster to revision 2 with four commands.commandslists{ name, target, description?, inputHint? }entries or answers{ supported: false }.commandqueues one by{ target, name, args? }and answers its{ id }at once.command-cancelcancels a queued command by id, andcommand-statereads whether it isqueued,takenorstarted, wascancelled, wasrefusedwithnot-found,failed-preconditionorunavailable, or endedunknown. The four declare theownerauthority word only, so an interactive ledger row gets their caller rows, and no grant row can name them.@cotal-ai/connector-coreaddsopenAgentEndpoint, the one owner of the agent serve, which replacesopenPromptDeskand serves the prompt desk beside a command lane. EveryMeshAgentwith a user-auth credential opens it, with the connector'scommandsdispatcher or none. A command starts only while no turn runs. At most 8 are queued, with no time bound, stopping the agent refuses every queued one, and the agent remembers the last 32 to end. A connector takes each queued command withdispatchNextCommand()whenMeshAgentemitscommand. An open or static mesh serves nothing yet.@cotal-ai/connector-opencodelistsGET /api/commandby name andGET /api/skillby id and runs a command through/commandand a skill through/prompt. A first-turn command carries the persona'ssystemfield as a first message does, though OpenCode 2.2.5 passes it to the model for neither, and right after a command turn, waiting messages go first. -
Clarify how to identify the broker executable, answer or resume a workflow, preview a team without its applications, and interpret the dashboard credential in
doctor auth. -
Reject malformed space names in daemon status, report unregistered spaces when connecting, and keep nonexistent Managers out of status after disconnect.
-
Keep shell installs working when the system Node executable is upgraded, explain how to reinstall npm copies after a Node upgrade, and document curl-free and noncolliding install options.
-
Let manual self-updates on Linux restart a prepared machine daemon, and let future daemons give a slow version probe more time on retry.
-
Fix Linux daemon installation when an owned group-writable systemd unit directory sits below a private directory that other accounts cannot traverse.
-
On Windows, daemon installation now gives the initial Task Scheduler lookup up to 60 seconds to finish before refusing.
-
Codex setup lists its configuration and plugin files in the JSON receipt, status reports disabled plugins, and updates leave read-only Codex configuration unchanged.
-
Move the endpoint's boot durable self-join and its reconcile into an internal module without changing the endpoint API.
-
Move the endpoint's stream creation and durable provisioning into an internal module without changing the endpoint API.
-
Internal refactor: the per-profile permission builders now live in their own module. Credential permissions are unchanged.
-
Restarting a local stack no longer leaves unused manager goal-index consumers, and channel replay windows are saved without surrounding whitespace.
-
Hosted workflow starts include syntax diagnostics in JSON refusals, and simulations reject invalid handoff destinations, nonnumeric clock starts, and duplicate script keys.
-
Keep the right project in CLI recovery steps for unreachable brokers, stopped spaces, and missing managers, and keep component health consistent when a broker URL has a trailing slash.
-
List meshes and save preferences without installing connectors, reject malformed commands and conflicting seed modes before seeding, and direct users with a corrupt extension manifest to
cotal ext seed --repair. -
Show the restart step for a stopped local space that stays registered, give equivalent broker URLs the same recovery advice, and allow a named reset of an isolated stopped open space.
-
cotal statusandcotal psnow tell you to repair an invalid.cotal/channels.jsonbefore restarting a stopped local stack. -
Separate the workspace's persisted identity records into an internal module without changing the package API.
-
Internal refactor: the inbox item types, limits and helpers now live in their own module. Inbox behaviour is unchanged.
-
Move the Jcode host's module-level support code (timing bounds, the bridge-recovery classifier, the seat home, MCP config, relay server and env scrub) out of
host.tsintohost-support.ts.host.tsre-exports the public names, so imports and behaviour are unchanged. -
A Jcode seat now stops its TUI before its server, on a normal stop and when a launch fails. From Jcode 0.99.1 a TUI that loses its server starts a new one on the seat's socket, and that server made the next launch of the same name fail until Jcode's idle timeout ended it. The TUI also starts with Jcode's desktop companion autostart off, so Jcode 1.0 no longer leaves a companion process behind each seat.
-
Move the OpenCode plugin's shared seams (retirement and settle tokens, the model refusal check, the bounded settle and the surfaced inbox batch) out of
plugin.tsintoplugin-seams.ts.plugin.tsre-exports them, so imports and behaviour are unchanged. -
Mark endpoint work commands as unavailable, hide the web-only
--no-openoption from manager start help, and preserveps --slotsin manager selector errors. -
History reports older direct messages only when the read finds an omission, and live follow honors time-based
--sincecutoffs. -
Reject an empty setup project, mark forced legacy mesh registrations as unchecked, and refuse unsafe credential output paths without creating directories.
-
Report an empty
spawn --resumeas a usage error in both launches and previews, exitjoincleanly when/quitis pasted after a status command, and stop the plain console without a false broker outage warning. -
Local cleanup refusals tell you to remove only the unsupported mesh flags and their values, so a retry keeps options such as
--force,--dry-runand--store-dir. -
Configure-only setup no longer needs a runnable NATS server, setup names the install command for a missing built-in connector, and slow connector setup no longer expires the broker startup credential.
-
Report missing member records in
cotal statuswhen a live stack's journal does not name its launching Cotal home, even if the current home has prepared a space in that folder. -
Reject persona imports with invalid UTF-8 and keep the requested space or server in the edit and removal commands shown when a persona already exists.
-
Keep foreground service stop receipts intact and reject unsupported preset start options in dry runs before saving the definition.
-
Make
space showexplain explicit selections and give working recovery commands for renamed stopped projects. -
Move the renewal of the manager's own standing credentials into its own component without changing the manager API.
-
Move the goal-writer connection and the goal index it reconciles into its own component without changing the manager API.
-
Move the core of agent start into the launch component without changing the manager API.
-
Move the agent-start path out of the launch component into its own component without changing the manager API.
-
The
cotal run showhelp now explains that--limitapplies only to text output and cannot be combined with--json. -
Separate the mesh handler's turn and ask clients into an internal module without changing the runtime API.
-
Move the web dashboard's request input and operator text handling (caller errors, body caps, operator quoting and escaping, and channel, history, agent-id and tap parsing) out of
web.tsintoweb-request.ts.web.tsre-exports the public names, so imports and behaviour are unchanged.
What's Changed
- fix(runtime): clarify run show journal limit in help by @davidfarah-dev in #7964
- fix(cli): preserve options in local cleanup retry guidance by @davidfarah-dev in #7963
- refactor(core): move endpoint stream and inbox provisioning into a component by @davidfarah-dev in #7956
- refactor(manager): move agent start into SeatLaunch by @davidfarah-dev in #7953
- fix(connector-jcode): stop the TUI before the server it would restart by @davidfarah-dev in #7971
- fix(cli)!: distinguish unrecorded broker processes by @davidfarah-dev in #7973
- refactor(core): move endpoint boot memberships into a component by @davidfarah-dev in #7970
- refactor(core): move the per-profile permission builders into their own module by @davidfarah-dev in #7972
- refactor(runtime): extract mesh handler turn and ask clients by @davidfarah-dev in #7980
- fix(cli): validate resume IDs and clean up shutdown by @davidfarah-dev in #7969
- fix(daemon): handle invalid and unknown spaces by @davidfarah-dev in #7965
- fix(runtime): report and reject invalid workflow inputs by @davidfarah-dev in #7960
- fix(cli): correct history omission and follow cutoffs by @davidfarah-dev in #7961
- fix(cli): preserve service stop receipts and validate preset previews by @davidfarah-dev in #7976
- refactor(manager): move standing credential renewal into CredentialRenewal by @davidfarah-dev in #7990
- docs(cli): clarify operator command behavior by @davidfarah-dev in #7975
- fix(cli): retire goal-index scans and normalize replay windows by @davidfarah-dev in #7983
- fix(cli): correct space show guidance by @davidfarah-dev in #7984
- refactor(connector-core): extract agent inbox model module by @davidfarah-dev in #8002
- fix(cli): reject invalid persona imports and preserve conflict targets by @davidfarah-dev in #7988
- fix(cli): correct command help and slot rerun guidance by @davidfarah-dev in #7989
- fix(cli): handle stopped local spaces that stay registered by @davidfarah-dev in #7994
- fix(cli): validate setup, mesh registration, and credential output by @davidfarah-dev in #7997
- refactor(connector-opencode): extract plugin seams module by @davidfarah-dev in #8009
- test(cli): repair the status report and presence census fixtures on main by @davidfarah-dev in #8014
- fix(cli): preserve local project context by @davidfarah-dev in #7993
- refactor(manager): move the agent-start path into SeatStart by @davidfarah-dev in #8016
- feat: run an agent's own commands and skills through its agent endpoint by @Manas-Kenge in #7251
- fix(installer): preserve Node upgrades and clarify npm recovery by @davidfarah-dev in #7982
- fix(daemon): activate verified manual Linux updates by @davidfarah-dev in #7995
- fix(cli): honor private ancestors of systemd unit directories by @davidfarah-dev in #7998
- fix(daemon): allow a slow Windows task lookup during install by @davidfarah-dev in #8007
- fix(cli): avoid unintended connector seeding by @davidfarah-dev in #7999
- refactor(connector-jcode): extract host support module by @davidfarah-dev in #8021
- refactor(workspace): move persisted identity records out of auth-paths by @davidfarah-dev in #8022
- fix(cli): report invalid channel seeds before restart by @davidfarah-dev in #7927
- fix(cli): restore the warning for missing stack member records by @davidfarah-dev in #8000
- fix(codex): respect plugin configuration and report setup writes by @davidfarah-dev in #7986
- refactor(web): move request input handling into web-request.ts by @davidfarah-dev in #8030
- refactor(manager): move the goal-writer into GoalWriter by @davidfarah-dev in #8031
- fix(cli): make local setup and startup reliable by @davidfarah-dev in #7978
- test: follow the goal-writer extraction in the required-argument census by @davidfarah-dev in #8037
- test(daemon): open the chain above the group-writable install refusal cells by @davidfarah-dev in #8032
- revert(cli): restore the broker row for a missing legacy process record by @davidfarah-dev in #8006
- chore(release): version packages by @davidfarah-dev in #7968
Full Changelog: v0.170.0...v0.171.0