Skip to content

πŸ™Œ OpenHands: AI-Driven Development

fix: pre-bundle all dependencies to prevent Safari 504 errors (#414)

John-Mason P. Shackelfordebe6b392d4f5
diff --git a/README.md b/README.md
index 75c3ab94e9..000a7de26a 100644
--- a/README.md
+++ b/README.md
@@ -80,6 +80,12 @@ npm run dev:dangerously-dockerless
Access the UI at [http://localhost:8000](http://localhost:8000)
+If you're not actively developing on agent-canvas and just want to run it locally, use the static build instead (faster loads, no hot reload):
+
+```sh
+npm run dev:static
+```
+
# Architecture
Agent Canvas is powered by the [OpenHands Agent Server](https://github.com/OpenHands/software-agent-sdk/tree/main/openhands-agent-server/openhands/agent_server), a REST API for running multiple agents on a single machine. Each Agent Server runs on a single host/port; the Agent Canvas can connect to multiple Agent Servers and easily flip between them.
diff --git a/vite.config.ts b/vite.config.ts
index ddb4985462..54fe579f5c 100644
--- a/vite.config.ts
+++ b/vite.config.ts
@@ -122,9 +122,15 @@ export default defineConfig(({ mode }) => {
: appBuildConfig,
copyPublicDir: !isLibraryBuild,
optimizeDeps: {
+ // Disable discovery of new deps at runtime. All deps must be listed in
+ // `include`. This prevents Vite from returning 504s while optimizing
+ // newly-discovered deps - Safari doesn't retry like Chrome does.
+ noDiscovery: true,
include: [
// Pre-bundle client entry dependencies so the first page load does not 504
// with Vite's "Outdated Optimize Dep" before hydration finishes.
+ // Safari is particularly sensitive to runtime dep optimization - it gets
+ // stuck in 504 errors when Vite triggers "optimized dependencies changed. reloading"
"react",
"react/jsx-runtime",
"react-dom/client",
@@ -132,6 +138,7 @@ export default defineConfig(({ mode }) => {
// Pre-bundle ALL dependencies to prevent runtime optimization and page reloads
// These are discovered during initial app load:
"posthog-js",
+ "posthog-js/react",
"@tanstack/react-query",
"react-hot-toast",
"i18next",
@@ -170,6 +177,83 @@ export default defineConfig(({ mode }) => {
"@xterm/addon-fit",
"@xterm/xterm",
"@xterm/xterm/css/xterm.css",
+ // OpenHands typescript client
+ "@openhands/typescript-client",
+ "@openhands/typescript-client/client/http-client",
+ "@openhands/typescript-client/clients",
+ "@openhands/typescript-client/events/remote-events-list",
+ "@openhands/typescript-client/workspace/remote-workspace",
+ // Additional dependencies discovered at runtime
+ "class-variance-authority",
+ "downshift",
+ "framer-motion",
+ "rehype-raw",
+ "rehype-sanitize",
+ "unist-util-visit",
+ "uuid",
+ "zustand",
+ "zustand/middleware",
+ // Syntax highlighter language definitions - Safari fails if these are
+ // optimized at runtime. Include all commonly used languages.
+ "react-syntax-highlighter/dist/esm/languages/prism/bash",
+ "react-syntax-highlighter/dist/esm/languages/prism/batch",
+ "react-syntax-highlighter/dist/esm/languages/prism/c",
+ "react-syntax-highlighter/dist/esm/languages/prism/clike",
+ "react-syntax-highlighter/dist/esm/languages/prism/clojure",
+ "react-syntax-highlighter/dist/esm/languages/prism/cpp",
+ "react-syntax-highlighter/dist/esm/languages/prism/csharp",
+ "react-syntax-highlighter/dist/esm/languages/prism/css",
+ "react-syntax-highlighter/dist/esm/languages/prism/dart",
+ "react-syntax-highlighter/dist/esm/languages/prism/diff",
+ "react-syntax-highlighter/dist/esm/languages/prism/docker",
+ "react-syntax-highlighter/dist/esm/languages/prism/elixir",
+ "react-syntax-highlighter/dist/esm/languages/prism/erlang",
+ "react-syntax-highlighter/dist/esm/languages/prism/fsharp",
+ "react-syntax-highlighter/dist/esm/languages/prism/go",
+ "react-syntax-highlighter/dist/esm/languages/prism/graphql",
+ "react-syntax-highlighter/dist/esm/languages/prism/groovy",
+ "react-syntax-highlighter/dist/esm/languages/prism/haskell",
+ "react-syntax-highlighter/dist/esm/languages/prism/hcl",
+ "react-syntax-highlighter/dist/esm/languages/prism/http",
+ "react-syntax-highlighter/dist/esm/languages/prism/ini",
+ "react-syntax-highlighter/dist/esm/languages/prism/java",
+ "react-syntax-highlighter/dist/esm/languages/prism/javascript",
+ "react-syntax-highlighter/dist/esm/languages/prism/json",
+ "react-syntax-highlighter/dist/esm/languages/prism/json5",
+ "react-syntax-highlighter/dist/esm/languages/prism/jsx",
+ "react-syntax-highlighter/dist/esm/languages/prism/julia",
+ "react-syntax-highlighter/dist/esm/languages/prism/kotlin",
+ "react-syntax-highlighter/dist/esm/languages/prism/less",
+ "react-syntax-highlighter/dist/esm/languages/prism/lua",
+ "react-syntax-highlighter/dist/esm/languages/prism/makefile",
+ "react-syntax-highlighter/dist/esm/languages/prism/markdown",
+ "react-syntax-highlighter/dist/esm/languages/prism/markup",
+ "react-syntax-highlighter/dist/esm/languages/prism/matlab",
+ "react-syntax-highlighter/dist/esm/languages/prism/nginx",
+ "react-syntax-highlighter/dist/esm/languages/prism/nix",
+ "react-syntax-highlighter/dist/esm/languages/prism/objectivec",
+ "react-syntax-highlighter/dist/esm/languages/prism/ocaml",
+ "react-syntax-highlighter/dist/esm/languages/prism/perl",
+ "react-syntax-highlighter/dist/esm/languages/prism/php",
+ "react-syntax-highlighter/dist/esm/languages/prism/powershell",
+ "react-syntax-highlighter/dist/esm/languages/prism/properties",
+ "react-syntax-highlighter/dist/esm/languages/prism/protobuf",
+ "react-syntax-highlighter/dist/esm/languages/prism/python",
+ "react-syntax-highlighter/dist/esm/languages/prism/r",
+ "react-syntax-highlighter/dist/esm/languages/prism/regex",
+ "react-syntax-highlighter/dist/esm/languages/prism/ruby",
+ "react-syntax-highlighter/dist/esm/languages/prism/rust",
+ "react-syntax-highlighter/dist/esm/languages/prism/sass",
+ "react-syntax-highlighter/dist/esm/languages/prism/scala",
+ "react-syntax-highlighter/dist/esm/languages/prism/scss",
+ "react-syntax-highlighter/dist/esm/languages/prism/shell-session",
+ "react-syntax-highlighter/dist/esm/languages/prism/solidity",
+ "react-syntax-highlighter/dist/esm/languages/prism/sql",
+ "react-syntax-highlighter/dist/esm/languages/prism/swift",
+ "react-syntax-highlighter/dist/esm/languages/prism/toml",
+ "react-syntax-highlighter/dist/esm/languages/prism/tsx",
+ "react-syntax-highlighter/dist/esm/languages/prism/typescript",
+ "react-syntax-highlighter/dist/esm/languages/prism/yaml",
],
},
server: {