Skip to content

v0.171.0

Choose a tag to compare

@davidfarah-dev davidfarah-dev released this 19 Nov 10:53
1bf6861

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 status and cotal ps now tell you to repair an invalid .cotal/channels.json before 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.ts into host-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.ts into plugin-seams.ts.
  • Mark endpoint work commands as unavailable, hide the web-only --no-open option from manager start help, and preserve ps --slots in manager selector errors.
  • History reports older direct messages only when the read finds an omission, and live follow honors time-based --since cutoffs.
  • 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 --resume as a usage error in both launches and previews, exit join cleanly when /quit is 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-run and --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 status when 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 show explain 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 show help now explains that --limit applies 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.ts into web-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/core advances the agent endpoint's cluster to revision 2 with four commands. commands lists { name, target, description?, inputHint? } entries or answers { supported: false }. command queues one by { target, name, args? } and answers its { id } at once. command-cancel cancels a queued command by id, and command-state reads whether it is queued, taken or started, was cancelled, was refused with not-found, failed-precondition or unavailable, or ended unknown. The four declare the owner authority word only, so an interactive ledger row gets their caller rows, and no grant row can name them. @cotal-ai/connector-core adds openAgentEndpoint, the one owner of the agent serve, which replaces openPromptDesk and serves the prompt desk beside a command lane. Every MeshAgent with a user-auth credential opens it, with the connector's commands dispatcher 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 with dispatchNextCommand() when MeshAgent emits command. An open or static mesh serves nothing yet. @cotal-ai/connector-opencode lists GET /api/command by name and GET /api/skill by id and runs a command through /command and a skill through /prompt. A first-turn command carries the persona's system field 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 status and cotal ps now tell you to repair an invalid .cotal/channels.json before 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.ts into host-support.ts. host.ts re-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.ts into plugin-seams.ts. plugin.ts re-exports them, so imports and behaviour are unchanged.

  • Mark endpoint work commands as unavailable, hide the web-only --no-open option from manager start help, and preserve ps --slots in manager selector errors.

  • History reports older direct messages only when the read finds an omission, and live follow honors time-based --since cutoffs.

  • 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 --resume as a usage error in both launches and previews, exit join cleanly when /quit is 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-run and --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 status when 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 show explain 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 show help now explains that --limit applies 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.ts into web-request.ts. web.ts re-exports the public names, so imports and behaviour are unchanged.

What's Changed

Full Changelog: v0.170.0...v0.171.0