@openhands/agent-canvas 1.7.2 → 1.9.0

package/dist/utils/transcript-export/index.js

@@ -4,10 +4,10 @@ import { isACPToolCallEvent as n, isActionEvent as r, isAgentErrorEvent as i, is
 import { getActionThoughtText as f, getReasoningContent as p, splitInlineThink as m } from "../../components/conversation-events/chat/event-thought-helpers.js";
 import { handleEventForUI as h } from "../handle-event-for-ui.js";
 import { shouldRenderEvent as g } from "../../components/conversation-events/chat/event-content-helpers/should-render-event.js";
-import { parseMessageFromEvent as _ } from "../../components/conversation-events/chat/event-content-helpers/parse-message-from-event.js";
-import { getActionContent as v } from "../../components/conversation-events/chat/event-content-helpers/get-action-content.js";
-import { getObservationContent as y } from "../../components/conversation-events/chat/event-content-helpers/get-observation-content.js";
-import { getACPToolCallContent as b, stripRedundantTitlePrefix as x } from "../../components/conversation-events/chat/event-content-helpers/get-acp-tool-call-content.js";
+import { getACPToolCallContent as _, stripRedundantTitlePrefix as v } from "../../components/conversation-events/chat/event-content-helpers/get-acp-tool-call-content.js";
+import { parseMessageFromEvent as y } from "../../components/conversation-events/chat/event-content-helpers/parse-message-from-event.js";
+import { getActionContent as b } from "../../components/conversation-events/chat/event-content-helpers/get-action-content.js";
+import { getObservationContent as x } from "../../components/conversation-events/chat/event-content-helpers/get-observation-content.js";
 import { groupEvents as S } from "../../components/conversation-events/chat/group-events.js";
 //#region src/utils/transcript-export/index.ts
 var C = new Set([
@@ -60,7 +60,7 @@ var C = new Set([
 		i ? `${t.t(e.TASK$QUERY)}:\n${i.prompt}` : "",
 		`${t.t(e.TASK$RESULT)}:\n${I(n.content)}`
 	].filter(Boolean).join("\n\n");
-}, z = (e) => e.action.kind === "TaskAction" ? L(e.action) : C.has(e.action.kind) ? v(e) : "", B = (e, t) => e.observation.kind === "TaskObservation" ? R(e.observation, t) : w.has(e.observation.kind) ? y(e) : "", V = (e) => s(e) ? [
+}, z = (e) => e.action.kind === "TaskAction" ? L(e.action) : C.has(e.action.kind) ? b(e) : "", B = (e, t) => e.observation.kind === "TaskObservation" ? R(e.observation, t) : w.has(e.observation.kind) ? x(e) : "", V = (e) => s(e) ? [
 	e.reason,
 	e.error,
 	e.stdout,
@@ -70,13 +70,13 @@ var C = new Set([
 	"SwitchLLMAction",
 	"ThinkAction"
 ].includes(e.action.kind), W = (f, p) => {
-	let v = f.reduce((e, t) => {
+	let b = f.reduce((e, t) => {
 		try {
 			return h(t, e);
 		} catch {
 			return e;
 		}
-	}, []), y = new Map(f.filter(r).map((e) => [e.id, e])), C = [], w = /* @__PURE__ */ new Set(), D = S(v.filter((e) => d(e) && !e.observation.is_error || g(e)), 2 ** 53 - 1, f), O = (e) => {
+	}, []), x = new Map(f.filter(r).map((e) => [e.id, e])), C = [], w = /* @__PURE__ */ new Set(), D = S(b.filter((e) => d(e) && !e.observation.is_error || g(e)), 2 ** 53 - 1, f), O = (e) => {
 		if (w.has(e.id) || !U(e)) return;
 		w.add(e.id);
 		let t = H(e);
@@ -95,7 +95,7 @@ var C = new Set([
 		}
 		let { event: h } = f;
 		try {
-			let f = r(h) ? h : l(h) ? y.get(h.action_id) : void 0;
+			let f = r(h) ? h : l(h) ? x.get(h.action_id) : void 0;
 			if (f && O(f), d(h) && !h.observation.is_error) {
 				C.push({
 					kind: "note",
@@ -106,7 +106,7 @@ var C = new Set([
 				continue;
 			}
 			if (c(h)) {
-				let e = _(h).trim();
+				let e = y(h).trim();
 				if (h.source === "agent") {
 					let { reasoning: t, message: n } = m(e);
 					[t, n].filter(Boolean).forEach((e) => {
@@ -166,7 +166,7 @@ var C = new Set([
 				continue;
 			}
 			if (l(h)) {
-				let e = y.get(h.action_id);
+				let e = x.get(h.action_id);
 				C.push({
 					kind: "tool",
 					summary: F(h, e),
@@ -178,8 +178,8 @@ var C = new Set([
 			if (n(h)) {
 				C.push({
 					kind: "tool",
-					summary: x(h) || t.t(e.ACTION_MESSAGE$ACP_TOOL),
-					details: p ? b(h) : "",
+					summary: v(h) || t.t(e.ACTION_MESSAGE$ACP_TOOL),
+					details: p ? _(h) : "",
 					timestamp: h.timestamp
 				});
 				continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openhands/agent-canvas",
-  "version": "1.7.2",
+  "version": "1.9.0",
   "description": "Agent Canvas UI for OpenHands - run AI coding agents with a visual interface",
   "license": "MIT",
   "private": false,
@@ -23,8 +23,8 @@
     "@heroui/react": "2.8.10",
     "@microlink/react-json-view": "1.31.20",
     "@monaco-editor/react": "4.7.0",
-    "@openhands/extensions": "0.11.0",
-    "@openhands/typescript-client": "1.34.0",
+    "@openhands/extensions": "0.13.0",
+    "@openhands/typescript-client": "1.36.1",
     "@react-router/node": "7.17.0",
     "@react-router/serve": "7.17.0",
     "@tailwindcss/vite": "4.2.4",

package/scripts/check-sdk-version-sync.mjs

@@ -19,7 +19,7 @@
  *
  * Usage:
  *   node scripts/check-sdk-version-sync.mjs
- *   EXPECTED_SDK_VERSION=1.38.0 node scripts/check-sdk-version-sync.mjs
+ *   EXPECTED_SDK_VERSION=1.39.1 node scripts/check-sdk-version-sync.mjs
  *   node scripts/check-sdk-version-sync.mjs --check-pypi
  *
  * Environment variables:
@@ -78,7 +78,7 @@ Triggering from other repos:
     -H "Authorization: token \$GITHUB_TOKEN" \\
     -H "Accept: application/vnd.github.v3+json" \\
     https://api.github.com/repos/OpenHands/OpenHands/dispatches \\
-    -d '{"event_type": "sdk-version-check", "client_payload": {"version": "1.38.0"}}'
+    -d '{"event_type": "sdk-version-check", "client_payload": {"version": "1.39.1"}}'
 `);
   process.exit(0);
 }
@@ -260,9 +260,9 @@ async function fetchPyPIDependencies(packageName, version) {
  * Parse PyPI requires_dist array and extract SDK package versions
  *
  * PyPI returns dependencies in PEP 508 format like:
- *   "openhands-sdk>=1.38.0,<2.0.0"
- *   "openhands-tools==1.38.0"
- *   "openhands-workspace (>=1.38.0)"
+ *   "openhands-sdk>=1.39.1,<2.0.0"
+ *   "openhands-tools==1.39.1"
+ *   "openhands-workspace (>=1.39.1)"
  */
 function parseSdkVersionsFromRequiresDist(requiresDist) {
   const versions = {};
@@ -276,7 +276,7 @@ function parseSdkVersionsFromRequiresDist(requiresDist) {
       }
 
       // Extract the version number - look for patterns like:
-      // ">=1.38.0", "==1.38.0", "(>=1.38.0)", "~=1.38.0"
+      // ">=1.39.1", "==1.39.1", "(>=1.39.1)", "~=1.39.1"
       // After the package name and before any comma or closing paren
       const versionPattern = /[><=~!]+\s*([0-9]+(?:\.[0-9]+)*)/;
       const match = dep.match(versionPattern);

package/scripts/check-translation-completeness.cjs

@@ -53,6 +53,7 @@ const IDENTICAL_VALUE_ALLOWLIST = new Set([
   'SETTINGS$SKILLS_VERSION',
   'SETTINGS$SLACK',
   'SETTINGS$TITLE_GENERATION_PROFILE_OPTION',
+  'SETUP$REPOSITORY_PLACEHOLDER',
   'VSCODE$TITLE',
   'WORKSPACE$JUPYTER_TAB_LABEL',
 ]);

package/scripts/dev-safe.mjs

@@ -48,7 +48,7 @@ const LOCAL_AGENT_SERVER_SUBDIRS = [
   "openhands-workspace",
 ];
 const DEFAULT_AGENT_SERVER_VERSION = SHARED_DEFAULTS.versions.agentServer;
-// Temporary transitive-dep pin: openhands-sdk 1.38.0 leaves agent-client-protocol
+// Temporary transitive-dep pin: openhands-sdk 1.39.1 leaves agent-client-protocol
 // unbounded (>=0.10.1), but acp 0.11.0 reordered the ACP prompt() args and breaks
 // the SDK's ACP client. Hold acp <0.11 until a fixed SDK ships. See config/defaults.json.
 const AGENT_CLIENT_PROTOCOL_CONSTRAINT =
@@ -264,7 +264,9 @@ export async function assertPortsFree(portConfigs, host = "127.0.0.1") {
   const busy = results.filter(({ free }) => !free);
   if (busy.length === 0) return;
 
-  const lines = busy.map(({ name, port }) => `   • ${name}: port ${port}`).join("\n");
+  const lines = busy
+    .map(({ name, port }) => `   • ${name}: port ${port}`)
+    .join("\n");
   throw new Error(
     `Cannot start: the following ports are already in use:\n\n${lines}\n\n` +
       `Another agent-canvas instance may already be running.\n` +
@@ -399,7 +401,7 @@ export function validateFrontendDependencies(
  *   edits are picked up without a manual reinstall. The agent-server itself
  *   is rebuilt from local source on each invocation (--reinstall).
  * - OH_AGENT_SERVER_GIT_REF: Git commit SHA or branch name
- * - OH_AGENT_SERVER_VERSION: Specific PyPI version (e.g., "1.38.0")
+ * - OH_AGENT_SERVER_VERSION: Specific PyPI version (e.g., "1.39.1")
  *
  * If none are set, defaults to the released version specified by
  * DEFAULT_AGENT_SERVER_VERSION. Set OH_AGENT_SERVER_GIT_REF to use a
@@ -619,8 +621,7 @@ function buildConfigFromPorts(ports, cwd, env) {
   // ~/.openhands/agent-canvas/secret-key.txt. Persisting ensures dev mode
   // and Docker mode share the same encryption key when they mount the same
   // ~/.openhands directory (docker/entrypoint.sh reads/writes the same file).
-  const secretKeyPath =
-    env.OH_SECRET_KEY_PATH || DEFAULT_SECRET_KEY_PATH;
+  const secretKeyPath = env.OH_SECRET_KEY_PATH || DEFAULT_SECRET_KEY_PATH;
   const secretKey =
     env.OH_SECRET_KEY || getOrCreatePersistedApiKey(secretKeyPath, "secret");
   // Use the user-provided LOCAL_BACKEND_API_KEY or fall back to a key
@@ -958,10 +959,6 @@ async function main() {
   }
 
   const frontendCommand = buildNpmScriptCommand("dev:frontend");
-  const runtimeServicesInfo = buildRuntimeServicesInfo({
-    mode: "dev:safe",
-    agentServerPort: config.backendPort,
-  });
   frontend = spawnProcess(frontendCommand.command, frontendCommand.args, {
     cwd: config.cwd,
     env: {
@@ -971,9 +968,17 @@ async function main() {
       VITE_WORKING_DIR: config.workingDir,
       // Pass session API key so frontend can authenticate with agent-server
       VITE_SESSION_API_KEY: config.sessionApiKey,
-      // Inform the frontend (and downstream, the agent's system prompt) about
-      // which services are available in this dev stack.
-      VITE_RUNTIME_SERVICES_INFO: JSON.stringify(runtimeServicesInfo),
+      // dev:minimal deliberately does NOT supply runtime-services info (the
+      // frontend here talks straight to the agent-server over
+      // VITE_BACKEND_BASE_URL — there is no ingress or static-server in front
+      // of it to append `runtime_services` to `/server_info`, and the
+      // frontend's own VITE_RUNTIME_SERVICES_INFO env var is no longer read).
+      // It is a bare agent-server + Vite stack with no companion services to
+      // advertise, so `fetchBackendRuntimeServicesInfo()` correctly returns
+      // null and conversations simply omit the <RUNTIME_SERVICES> block.
+      // Stacks with automation/ingress/frontend services should use
+      // `npm run dev` / `dev:static`, which pass runtime-services info through
+      // ingress/static-server instead.
     },
   });
 

package/scripts/dev-static.mjs

@@ -61,6 +61,7 @@ import {
   buildAgentServerAutomationEnv,
   buildAutomationCommand,
   buildAutomationTelemetryEnv,
+  buildAutomationRuntimeServicesInfo,
   buildConfig,
 } from "./dev-with-automation.mjs";
 
@@ -379,6 +380,12 @@ function startStaticServer(config) {
   // is forwarded to the agent-server instead of falling back to the SPA
   // shell). Without this, /server_info on :3001 returns index.html.
   const staticServerScript = join(projectRoot, "scripts", "static-server.mjs");
+  const runtimeServicesInfo = JSON.stringify(
+    buildAutomationRuntimeServicesInfo({
+      ...config,
+      frontendKind: "static",
+    }),
+  );
   spawnService(
     "static",
     "node",
@@ -396,6 +403,8 @@ function startStaticServer(config) {
       ...(config.sessionApiKey
         ? ["--session-api-key", config.sessionApiKey]
         : []),
+      "--runtime-services-info",
+      runtimeServicesInfo,
       "--route",
       `/api/automation=http://localhost:${config.autoBackendPort}`,
       "--route",
@@ -428,6 +437,12 @@ function startIngress(config) {
   logService("ingress", `Starting on port ${config.ingressPort}...`, c.yellow);
 
   const ingressScript = join(projectRoot, "scripts", "ingress.mjs");
+  const runtimeServicesInfo = JSON.stringify(
+    buildAutomationRuntimeServicesInfo({
+      ...config,
+      frontendKind: "static",
+    }),
+  );
 
   spawnService(
     "ingress",
@@ -436,6 +451,8 @@ function startIngress(config) {
       ingressScript,
       "--port",
       config.ingressPort.toString(),
+      "--runtime-services-info",
+      runtimeServicesInfo,
       "--route",
       `/api/automation=http://localhost:${config.autoBackendPort}`,
       "--route",

package/scripts/dev-with-automation.mjs

@@ -958,12 +958,16 @@ function shutdown() {
 
 process.on("SIGINT", shutdown);
 process.on("SIGTERM", shutdown);
+process.on("SIGHUP", shutdown);
 
 function startIngress(config) {
   logService("ingress", `Starting on port ${config.ingressPort}...`, c.yellow);
 
   const ingressScript = join(projectRoot, "scripts", "ingress.mjs");
   const frontendBackend = getFrontendBackend(config);
+  const runtimeServicesInfo = config.launchAgentServer
+    ? JSON.stringify(buildAutomationRuntimeServicesInfo(config))
+    : null;
 
   spawnService(
     "ingress",
@@ -972,6 +976,9 @@ function startIngress(config) {
       ingressScript,
       "--port",
       config.ingressPort.toString(),
+      ...(runtimeServicesInfo
+        ? ["--runtime-services-info", runtimeServicesInfo]
+        : []),
       ...buildRouteArgs(getLocalServiceRoutes(config)),
       ...(frontendBackend ? ["--default", frontendBackend] : []),
     ],
@@ -984,8 +991,8 @@ function startIngress(config) {
 
 /**
  * Build the JSON-serializable runtime services info for an automation
- * stack. Used by both the Vite dev server (dev mode) and static-build.mjs
- * (static mode) so the frontend can populate the agent's
+ * stack. Backend-serving processes append this to `/server_info` so any
+ * frontend connected to the backend can populate the agent's
  * `<RUNTIME_SERVICES>` system-prompt block.
  */
 export function buildAutomationRuntimeServicesInfo(config) {
@@ -1009,9 +1016,6 @@ function startVite(config) {
   logService("vite", `Starting on port ${config.vitePort}...`, c.magenta);
 
   const frontendCommand = buildNpmScriptCommand("dev:frontend");
-  const runtimeServicesInfo = config.launchAgentServer
-    ? buildAutomationRuntimeServicesInfo(config)
-    : null;
 
   const viteEnv = {
     // Full-stack mode points Vite at this launcher's ingress. Frontend-only
@@ -1023,12 +1027,6 @@ function startVite(config) {
     viteEnv.VITE_WORKING_DIR = config.viteWorkingDir;
   }
 
-  if (runtimeServicesInfo) {
-    // Inform the frontend (and downstream, the agent's system prompt) about
-    // which services are available in this dev stack.
-    viteEnv.VITE_RUNTIME_SERVICES_INFO = JSON.stringify(runtimeServicesInfo);
-  }
-
   // In local mode, bake the session key into the frontend so the user
   // never has to paste it. In public mode, omit the key and set
   // VITE_AUTH_REQUIRED so the frontend shows the API key entry screen
@@ -1442,9 +1440,9 @@ function startStaticFrontend(config, staticDir) {
   logService("static", `Starting on port ${config.vitePort}...`, c.magenta);
   logService("static", `Serving from: ${staticDir}`, c.dim);
 
-  // Build the runtime-services info JSON so the pre-built frontend can
-  // populate the agent's <RUNTIME_SERVICES> system-prompt block without
-  // VITE_RUNTIME_SERVICES_INFO baked in at build time.
+  // Build the runtime-services info JSON so static-server can append it to
+  // /server_info. The static-server also injects the old window global for
+  // compatibility with previously built frontend bundles.
   const runtimeServicesInfo = config.launchAgentServer
     ? JSON.stringify(buildAutomationRuntimeServicesInfo(config))
     : null;

package/scripts/ingress.mjs

@@ -13,6 +13,8 @@
  *   INGRESS_PORT          - Port to listen on (default: 8000)
  *   INGRESS_ROUTES        - JSON object of path prefix -> backend URL
  *   INGRESS_DEFAULT       - Default backend for unmatched routes
+ *   INGRESS_RUNTIME_SERVICES_INFO - Runtime services JSON appended to
+ *                                   /server_info
  *
  * Route matching:
  *   - Routes are matched by longest prefix first
@@ -27,6 +29,8 @@ import {
   createProxyHandlers,
   createRouter,
   isBenignSocketError,
+  isServerInfoRequest,
+  proxyServerInfoRequest,
 } from "./proxy-utils.mjs";
 
 // ═══════════════════════════════════════════════════════════════════════════
@@ -39,6 +43,7 @@ function parseArgs() {
     port: 8000,
     routes: {},
     defaultBackend: null,
+    runtimeServicesInfo: null,
   };
 
   for (let i = 0; i < args.length; i++) {
@@ -57,6 +62,9 @@ function parseArgs() {
       case "--default":
         config.defaultBackend = args[++i];
         break;
+      case "--runtime-services-info":
+        config.runtimeServicesInfo = args[++i] || null;
+        break;
       case "-h":
       case "--help":
         showHelp();
@@ -80,12 +88,15 @@ OPTIONS:
   -p, --port <port>           Port to listen on (default: 8000)
   -r, --route <path=url>      Add a route (can be repeated)
   -d, --default <url>         Default backend for unmatched routes
+  --runtime-services-info     Runtime services JSON for /server_info
   -h, --help                  Show this help
 
 ENVIRONMENT VARIABLES:
   INGRESS_PORT                Port to listen on
   INGRESS_ROUTES              JSON object: {"path": "url", ...}
   INGRESS_DEFAULT             Default backend URL
+  INGRESS_RUNTIME_SERVICES_INFO
+                              Runtime services JSON for /server_info
 
 EXAMPLES:
   # Basic setup with agent server and automation
@@ -125,6 +136,8 @@ function buildConfig(args, env = process.env) {
     port: args.port || parseInt(env.INGRESS_PORT, 10) || 8000,
     routes,
     defaultBackend: args.defaultBackend || env.INGRESS_DEFAULT || null,
+    runtimeServicesInfo:
+      args.runtimeServicesInfo || env.INGRESS_RUNTIME_SERVICES_INFO || null,
   };
 }
 
@@ -146,6 +159,15 @@ export function startIngress(config) {
       return;
     }
 
+    if (
+      config.runtimeServicesInfo &&
+      isServerInfoRequest(req) &&
+      (req.method === "GET" || req.method === "HEAD")
+    ) {
+      proxyServerInfoRequest(req, res, backend, config.runtimeServicesInfo);
+      return;
+    }
+
     proxy.proxyHttp(req, res, backend);
   });
 

package/scripts/proxy-utils.mjs

@@ -1,6 +1,9 @@
+import { request as httpRequest } from "node:http";
+import { request as httpsRequest } from "node:https";
 import { createProxyServer } from "httpxy";
 
 const DEFAULT_PROXY_TIMEOUT_MS = 120_000;
+const SERVER_INFO_PATH = "/server_info";
 const BENIGN_SOCKET_ERRORS = new Set([
   "ECONNRESET",
   "EPIPE",
@@ -35,6 +38,152 @@ export function isBenignSocketError(err) {
   return Boolean(err && BENIGN_SOCKET_ERRORS.has(err.code));
 }
 
+function parseBackendUrl(backendUrl) {
+  const url = new URL(backendUrl);
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    throw new Error("Invalid backend URL");
+  }
+  return {
+    hostname: url.hostname,
+    port: Number.parseInt(url.port, 10) || (url.protocol === "https:" ? 443 : 80),
+    protocol: url.protocol,
+  };
+}
+
+function writeInvalidBackendUrlResponse(req, res) {
+  const message = "Invalid backend URL";
+  console.error(`Proxy error for ${req.url}: ${message}`);
+  if (!res.headersSent) {
+    res.writeHead(502, { "Content-Type": "text/plain; charset=utf-8" });
+    res.end(`Bad Gateway: ${message}`);
+  } else {
+    res.destroy();
+  }
+}
+
+export function isServerInfoRequest(req) {
+  const pathname = new URL(req.url ?? "/", "http://localhost").pathname;
+  return pathname === SERVER_INFO_PATH;
+}
+
+export function proxyServerInfoRequest(
+  req,
+  res,
+  backendUrl,
+  runtimeServicesInfo,
+) {
+  let backend;
+  try {
+    backend = parseBackendUrl(backendUrl);
+  } catch {
+    writeInvalidBackendUrlResponse(req, res);
+    return;
+  }
+
+  const request = backend.protocol === "https:" ? httpsRequest : httpRequest;
+  const proxyReq = request(
+    {
+      hostname: backend.hostname,
+      port: backend.port,
+      path: req.url,
+      method: req.method,
+      headers: {
+        ...req.headers,
+        host: `${backend.hostname}:${backend.port}`,
+      },
+    },
+    (proxyRes) => {
+      const chunks = [];
+
+      proxyRes.on("data", (chunk) => {
+        chunks.push(Buffer.from(chunk));
+      });
+
+      proxyRes.on("error", (err) => {
+        if (!isBenignSocketError(err)) {
+          console.error(`Upstream response error for ${req.url}:`, err.message);
+        }
+        if (!res.headersSent) {
+          res.writeHead(502);
+          res.end(`Bad Gateway: ${err.message}`);
+        } else {
+          res.destroy();
+        }
+      });
+
+      proxyRes.on("end", () => {
+        const statusCode = proxyRes.statusCode ?? 502;
+        const headers = { ...proxyRes.headers };
+        const originalBody = Buffer.concat(chunks);
+
+        if (statusCode < 200 || statusCode >= 300 || req.method === "HEAD") {
+          res.writeHead(statusCode, headers);
+          res.end(req.method === "HEAD" ? "" : originalBody);
+          return;
+        }
+
+        try {
+          const serverInfo = JSON.parse(originalBody.toString("utf8"));
+          const runtimeServices =
+            typeof runtimeServicesInfo === "string"
+              ? JSON.parse(runtimeServicesInfo)
+              : runtimeServicesInfo;
+          const body = Buffer.from(
+            JSON.stringify({
+              ...serverInfo,
+              runtime_services: runtimeServices,
+            }),
+            "utf8",
+          );
+
+          delete headers["content-length"];
+          delete headers["transfer-encoding"];
+          headers["content-type"] = "application/json; charset=utf-8";
+          headers["cache-control"] = "no-store";
+          res.writeHead(statusCode, headers);
+          res.end(body);
+        } catch (err) {
+          console.warn(
+            `Could not append runtime_services to ${SERVER_INFO_PATH}: ${
+              err instanceof Error ? err.message : String(err)
+            }`,
+          );
+          res.writeHead(statusCode, headers);
+          res.end(originalBody);
+        }
+      });
+    },
+  );
+
+  proxyReq.on("error", (err) => {
+    if (!isBenignSocketError(err)) {
+      console.error(`Proxy error for ${req.url}:`, err.message);
+    }
+    if (!res.headersSent) {
+      res.writeHead(502);
+      res.end(`Bad Gateway: ${err.message}`);
+    } else {
+      res.destroy();
+    }
+  });
+
+  req.on("error", (err) => {
+    if (!isBenignSocketError(err)) {
+      console.error(`Client request error for ${req.url}:`, err.message);
+    }
+    proxyReq.destroy();
+  });
+
+  res.on("error", (err) => {
+    if (!isBenignSocketError(err)) {
+      console.error(`Client response error for ${req.url}:`, err.message);
+    }
+    proxyReq.destroy();
+  });
+
+  req.pipe(proxyReq, { end: true });
+}
+
 function once(fn) {
   let called = false;
   return (...args) => {
@@ -97,7 +246,7 @@ export function createProxyHandlers({
     res.on("finish", finish);
     res.on("error", finish);
 
-    proxy.web(req, res, { target }).catch((err) => {
+    const handleProxyError = (err) => {
       metrics.totalErrors += 1;
       if (!isBenignSocketError(err)) {
         console.error(
@@ -107,7 +256,13 @@ export function createProxyHandlers({
       }
       writeProxyError(res, err instanceof Error ? err.message : String(err));
       finish();
-    });
+    };
+
+    try {
+      proxy.web(req, res, { target }).catch(handleProxyError);
+    } catch (err) {
+      handleProxyError(err);
+    }
   }
 
   function proxyWebSocket(req, socket, head, target) {

package/scripts/runtime-services-info.mjs

@@ -2,19 +2,19 @@
  * Single source of truth for the `<RUNTIME_SERVICES>` block.
  *
  * Builds a structured description of the services that are reachable from
- * inside the agent's sandbox. The frontend forwards it (verbatim, as a JSON
- * string) and renders it into the system prompt via
- * `AgentContext.system_message_suffix`, so the agent sees a
+ * inside the agent's sandbox. Agent Canvas backend-serving processes attach it
+ * to `/server_info.runtime_services`; the frontend renders that backend value
+ * into `AgentContext.system_message_suffix`, so the agent sees a
  * `<RUNTIME_SERVICES>` block listing what's available without having to probe.
  *
  * Two callers share this one definition:
  *   - the dev launchers (scripts/dev-*.mjs), which know the stack as a set of
- *     ports and bake the result into `VITE_RUNTIME_SERVICES_INFO` at build time;
+ *     ports and pass the result to ingress/static-server for `/server_info`;
  *   - docker/entrypoint.sh, which runs this file as a CLI (see the bottom of
  *     this module) because in a container the URLs are *runtime* config — the
  *     ports and base URLs are overridable at `docker run` and therefore cannot
- *     be baked into the image at build time. The JSON it prints is injected
- *     into index.html at serve time by scripts/static-server.mjs.
+ *     be baked into the image at build time. The JSON it prints is passed to
+ *     scripts/static-server.mjs and exposed through `/server_info`.
  *
  * URLs are written from the *agent's* point of view (i.e. as the agent should
  * curl/fetch them from inside its sandbox), which is deliberately not the

package/scripts/static-build.mjs

@@ -3,7 +3,6 @@ import { existsSync } from "node:fs";
 import { join } from "node:path";
 
 import {
-  buildAutomationRuntimeServicesInfo,
   c,
   logError,
   logService,
@@ -45,12 +44,6 @@ export function buildFrontend(config, args = {}) {
     // Bake the session API key — used by the frontend for both agent-server
     // and automation auth via the `X-Session-API-Key` header.
     VITE_SESSION_API_KEY: config.sessionApiKey,
-    // Bake a description of the runtime services in this dev stack so the
-    // frontend can populate the agent's <RUNTIME_SERVICES> system-prompt
-    // block when creating a conversation.
-    VITE_RUNTIME_SERVICES_INFO: JSON.stringify(
-      buildAutomationRuntimeServicesInfo(config),
-    ),
     // Intentionally do NOT set VITE_BACKEND_BASE_URL: leaving it unset makes
     // the runtime fall back to window.location.origin, which keeps the build
     // portable across localhost, LAN hosts, and tunnels such as ngrok.