diff --git a/docs.json b/docs.json index 48130b422..f1ee86e20 100644 --- a/docs.json +++ b/docs.json @@ -318,6 +318,7 @@ { "group": "Release Notes", "pages": [ + "openhands/usage/agent-canvas/release-notes/v1.23.0", "openhands/usage/agent-canvas/release-notes/v1.22.0", "openhands/usage/agent-canvas/release-notes/v1.21.0", "openhands/usage/agent-canvas/release-notes/v1.20.0", diff --git a/openhands/usage/agent-canvas/conversations.mdx b/openhands/usage/agent-canvas/conversations.mdx index 387cd14cf..95999c98c 100644 --- a/openhands/usage/agent-canvas/conversations.mdx +++ b/openhands/usage/agent-canvas/conversations.mdx @@ -17,7 +17,7 @@ Use the conversation list controls to manage automation runs and visible tags: - Choose `All`, `Hide`, or `Only` to include, exclude, or show only automation-run conversations. You can further select individual automation names, including unnamed automations. - Pinned conversations remain visible when automation-run filtering would otherwise hide them. -- Enable the `Tags` preference to show conversation tag chips. Tags are off by default; when there are more tags than fit, Agent Canvas shows a `+N` chip with the remaining count. +- Enable the `Tags` preference to show conversation tag chips. Tags are off by default. Each chip shows the tag key and value as a `Key: value` pair, such as `Artifacts: 1`. When there are more tags than fit, Agent Canvas shows a `+N` chip with the remaining count. Agent Canvas omits reserved tags and raw automation IDs from the chips. LLM metadata is also hidden by default. @@ -29,6 +29,8 @@ While an agent is running, the composer shows a live activity chip for its curre If a message fails to send, select `Retry` to send it again or `Dismiss` to remove the failed message bubble. Dismissing a message does not restore its text to the composer. +A "Failed to send" bubble can appear while the connection is slow or reconnecting. Once the server confirms the message and it appears in the conversation, Agent Canvas clears the stale bubble automatically. Select `Retry` only if the message never arrives. + ## Inline Markdown Artifact Previews When an agent creates a Markdown file, Agent Canvas renders it inline as a height-limited rich preview with an internal scrollbar instead of showing only the raw file content. Select `View` to open the full file in the Files drawer. diff --git a/openhands/usage/agent-canvas/managing-automations.mdx b/openhands/usage/agent-canvas/managing-automations.mdx index 2671d84ac..04d2b96cd 100644 --- a/openhands/usage/agent-canvas/managing-automations.mdx +++ b/openhands/usage/agent-canvas/managing-automations.mdx @@ -16,6 +16,7 @@ Open the **Automate** tab in the sidebar to see all automations on the active ba Click an automation to open its detail view. The detail view shows: - The full prompt the automation runs +- The automation's script, for automations that run a script bundle instead of a prompt - Trigger configuration (schedule, webhook, or event) - LLM profile used for runs - Recent run history and status @@ -28,6 +29,16 @@ A run can be `PENDING`, `RUNNING`, `COMPLETED`, `FAILED`, `CANCELLED`, or `SKIPP Automation runs surface a live **phase** that reflects a run's current state: `PENDING`, `RUNNING`, or `FAILED`. The phase appears on automation cards, in the Activity Log, and on the home screen, and updates live as a run progresses. A failed run retains its last phase after it stops. +### Script Automation Run Logs + +An automation that runs a script bundle executes its entrypoint directly instead of starting a conversation. For these runs, the run record has no conversation. Use **View logs** on the run to read the script's output; Agent Canvas resolves the logs from the run's sandbox on cloud backends. A run that executed a script shows `No conversation — this run executed a script. Use View logs for its output.` instead of `No Conversation`. + + + On cloud backends, a run's sandbox is deleted shortly after the run finishes unless the backend keeps it for a cleanup delay. Once the sandbox is gone, the logs are no longer available and the run shows a deleted-sandbox message. Open **View logs** while the run is in progress to read its output. + + +To see what a script automation runs, open its detail view and read the **Script** section, which replaces the prompt section for prompt-less automations and lists the bundle's files. + ### Activity Log Costs and Exports The Activity Log displays a completed run's reported LLM cost in USD to four decimal places. A measured zero cost appears as `$0.0000`; when the backend does not report a cost, no cost appears in the log. diff --git a/openhands/usage/agent-canvas/release-notes/v1.23.0.mdx b/openhands/usage/agent-canvas/release-notes/v1.23.0.mdx new file mode 100644 index 000000000..1d124d8c3 --- /dev/null +++ b/openhands/usage/agent-canvas/release-notes/v1.23.0.mdx @@ -0,0 +1,33 @@ +--- +title: Agent Canvas 1.23.0 +description: Release notes for Agent Canvas version 1.23.0 +--- + +# Agent Canvas 1.23.0 + +Released September 23, 2026. + +[View the full release on GitHub](https://github.com/OpenHands/OpenHands/releases/tag/v1.23.0). + +## Highlights + +- **Universal macOS desktop installer** — The macOS desktop build is now a single universal disk image that runs on both Apple silicon and Intel Macs, with bundled `uv` and Node.js runtimes selected per architecture. See [Desktop App (Preview Build)](/openhands/usage/agent-canvas/setup#desktop-app-preview-build). +- **Light and Solarized color themes** — Agent Canvas adds `Light+` and `Solarized Light` themes to the `Settings > Application` color-theme setting. See [Customize and Settings](/openhands/usage/agent-canvas/customize-and-settings). + +## Fixes + +- Script (bundle) automation runs now load their logs on cloud backends, and the automation detail view shows the automation's script in a **Script** section. See [Managing Automations](/openhands/usage/agent-canvas/managing-automations#script-automation-run-logs). +- A "Failed to send" bubble now clears on its own once the server confirms the message, instead of persisting after a delayed or reconnected delivery. See [Conversations](/openhands/usage/agent-canvas/conversations#handle-a-failed-message). +- Conversation tag chips now show the tag key and value as a `Key: value` pair, such as `Artifacts: 1`. See [Conversations](/openhands/usage/agent-canvas/conversations#conversation-list-controls). +- Restored the 11px mode label on the change-agent button. +- Historical Markdown messages that have not changed are no longer re-rendered, reducing work while scrolling a long conversation. + +## Maintenance + +- Released agent runtime dependencies bumped: SDK, Agent Server, and TypeScript client 1.49.5, Automation 1.15.0. +- Removed merged PR artifacts from `main`. + +## Full Changelog + +- [GitHub release notes](https://github.com/OpenHands/OpenHands/releases/tag/v1.23.0) +- [Compare v1.22.0 to v1.23.0](https://github.com/OpenHands/OpenHands/compare/v1.22.0...v1.23.0) diff --git a/openhands/usage/agent-canvas/setup.mdx b/openhands/usage/agent-canvas/setup.mdx index 05ba5193f..59c5561a7 100644 --- a/openhands/usage/agent-canvas/setup.mdx +++ b/openhands/usage/agent-canvas/setup.mdx @@ -318,13 +318,13 @@ The Agent Canvas desktop app for macOS, Windows, and Linux is an early preview b Download the installer for your operating system from the [OpenHands releases page](https://github.com/OpenHands/OpenHands/releases). -**macOS (Apple silicon)** +**macOS** -1. Download the `Agent-Canvas--arm64.dmg` file. +1. Download the `Agent-Canvas--universal.dmg` file. 2. Open the disk image and drag **Agent Canvas** to **Applications**. 3. Launch Agent Canvas from Applications. -Pre-built desktop releases support Apple silicon Macs. On an Intel Mac, use the npm or [from-source](#install-and-run) installation method. +The universal disk image runs on both Apple silicon and Intel Macs, and bundles the `uv` and Node.js runtimes for each architecture. You do not need a separate install method on an Intel Mac. **Windows**