@tt-a1i/openpi 0.6.1 → 0.7.0

package/THIRD_PARTY_NOTICES.md

@@ -29,3 +29,245 @@ The upstream project is distributed under the MIT License. Its notice states
 OpenPI is distributed under the MIT License; see [`LICENSE`](LICENSE). Portions
 identified in this notice retain their original copyright notices and license
 terms. The project-wide MIT license does not replace or remove those notices.
+
+## Web production bundle
+
+`web/dist/app.js` and `web/dist/styles.css` contain code from the packages
+listed below. This inventory was taken from the Vite production module graph;
+build-only packages are not included.
+
+### MIT-licensed packages
+
+Copyright (c) 2026 Meta Platforms, Inc.:
+
+- `@astryxdesign/core@0.5.2`
+- `@astryxdesign/theme-neutral@0.5.2`
+
+Copyright (c) Meta Platforms, Inc. and affiliates:
+
+- `@stylexjs/stylex@0.19.0`
+- `react@19.2.8`
+- `react-dom@19.2.8`
+- `scheduler@0.27.0`
+- `use-sync-external-store@1.6.0`
+
+Copyright (c) 2023 FormatJS:
+
+- `@formatjs/fast-memoize@3.1.7`
+- `@formatjs/icu-messageformat-parser@3.5.17`
+- `@formatjs/icu-skeleton-parser@2.1.11`
+
+Copyright (c) 2011-present i18next:
+
+- `i18next@26.4.1`
+
+Copyright (c) 2015-present i18next:
+
+- `react-i18next@17.0.13`
+
+Copyright (c) 2026 Espen Hovlandsdal <espen@hovlandsdal.com>:
+
+- `eventsource-parser@4.1.0`
+
+Copyright (c) Espen Hovlandsdal:
+
+- `react-markdown@10.1.0`
+
+Copyright (c) 2019 Paul Henschel:
+
+- `zustand@5.0.15`
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com>
+(<https://sindresorhus.com>):
+
+- `escape-string-regexp@5.0.0`
+- `is-plain-obj@4.1.0`
+
+Copyright (c) 2012 TJ Holowaychuk <tj@vision-media.ca>:
+
+- `inline-style-parser@0.2.7`
+
+Copyright (c) 2014 Stefan Thomas:
+
+- `extend@3.0.2`
+
+Copyright (c) 2017 Menglin "Mark" Xu <mark@remarkablemark.org>:
+
+- `style-to-object@1.0.14`
+
+Copyright (c) 2020 Menglin "Mark" Xu <mark@remarkablemark.org>:
+
+- `style-to-js@1.1.21`
+
+Copyright (c) 2014 Titus Wormer <tituswormer@gmail.com>:
+
+- `remark-parse@11.0.0`
+
+Copyright (c) 2015 Titus Wormer <tituswormer@gmail.com>:
+
+- `bail@2.0.2`, `ccount@2.0.1`, `mdast-util-to-string@4.0.0`
+- `unified@11.0.5`, `unist-util-is@6.0.1`, `unist-util-position@5.0.0`
+- `unist-util-visit@5.1.0`, `vfile@6.0.3`
+
+Copyright (c) 2015 Titus Wormer <mailto:tituswormer@gmail.com>:
+
+- `longest-streak@3.1.0`, `trim-lines@3.0.1`
+
+Copyright (c) 2016 Titus Wormer <tituswormer@gmail.com>:
+
+- `comma-separated-tokens@2.0.3`, `hast-util-whitespace@3.0.0`
+- `mdast-util-to-hast@13.2.1`, `rehype-sanitize@6.0.0`
+- `space-separated-tokens@2.0.2`, `trough@2.2.0`
+- `unist-util-stringify-position@4.0.0`, `unist-util-visit-parents@6.0.2`
+
+Copyright (c) 2017 Titus Wormer <tituswormer@gmail.com>:
+
+- `mdast-util-newline-to-break@2.0.0`, `remark-breaks@4.0.0`
+
+Copyright (c) 2020 Titus Wormer <tituswormer@gmail.com>:
+
+- `estree-util-is-identifier-name@3.0.0`
+- `mdast-util-gfm-autolink-literal@2.0.1`
+- `mdast-util-gfm-strikethrough@2.0.0`, `mdast-util-gfm-table@2.0.0`
+- `mdast-util-gfm-task-list-item@2.0.0`, `micromark-extension-gfm@3.0.0`
+- `micromark-extension-gfm-autolink-literal@2.1.0`
+- `micromark-extension-gfm-strikethrough@2.1.0`
+- `micromark-extension-gfm-task-list-item@2.1.0`
+
+Copyright (c) 2021 Titus Wormer <tituswormer@gmail.com>:
+
+- `micromark-extension-gfm-footnote@2.1.0`
+
+Copyright (c) 2023 Titus Wormer <tituswormer@gmail.com>:
+
+- `devlop@1.1.0`
+
+Copyright (c) Titus Wormer <tituswormer@gmail.com>:
+
+- `decode-named-character-reference@1.3.0`, `hast-util-sanitize@5.0.2`
+- `hast-util-to-jsx-runtime@2.3.6`, `markdown-table@3.0.4`
+- `mdast-util-find-and-replace@3.0.2`, `mdast-util-from-markdown@2.0.3`
+- `mdast-util-gfm@3.1.0`, `mdast-util-gfm-footnote@2.1.0`
+- `mdast-util-to-markdown@2.1.2`, `micromark@4.0.2`
+- `micromark-core-commonmark@2.0.3`, `micromark-extension-gfm-table@2.1.1`
+- `micromark-factory-destination@2.0.1`, `micromark-factory-label@2.0.1`
+- `micromark-factory-space@2.0.1`, `micromark-factory-title@2.0.1`
+- `micromark-factory-whitespace@2.0.1`, `micromark-util-character@2.1.1`
+- `micromark-util-chunked@2.0.1`, `micromark-util-classify-character@2.0.1`
+- `micromark-util-combine-extensions@2.0.1`
+- `micromark-util-decode-numeric-character-reference@2.0.2`
+- `micromark-util-decode-string@2.0.1`, `micromark-util-html-tag-name@2.0.1`
+- `micromark-util-normalize-identifier@2.0.1`
+- `micromark-util-resolve-all@2.0.1`, `micromark-util-sanitize-uri@2.0.1`
+- `micromark-util-subtokenize@2.1.0`, `remark-gfm@4.0.1`
+- `remark-rehype@11.1.2`, `vfile-message@4.0.3`
+
+Copyright (c) Titus Wormer:
+
+- `html-url-attributes@3.0.1`
+
+Copyright (c) Titus Wormer <mailto:tituswormer@gmail.com>:
+
+- `property-information@7.2.0`
+
+`mdast-util-phrasing@4.1.0` retains both of its notices:
+
+- Copyright (c) 2017 Titus Wormer <tituswormer@gmail.com>
+- Copyright (c) 2017 Victor Felder <victor@draft.li>
+
+The MIT terms for the packages above are:
+
+> Permission is hereby granted, free of charge, to any person obtaining a copy
+> of this software and associated documentation files (the "Software"), to deal
+> in the Software without restriction, including without limitation the rights
+> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+> copies of the Software, and to permit persons to whom the Software is
+> furnished to do so, subject to the following conditions:
+>
+> The above copyright notice and this permission notice shall be included in
+> all copies or substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+> SOFTWARE.
+
+### ISC-licensed packages
+
+Copyright (c) 2021, Andrea Giammarchi, @WebReflection:
+
+- `@ungap/structured-clone@1.4.0`
+
+Copyright (c) 2026 Lucide Icons and Contributors:
+
+- `lucide-react@1.39.0`
+
+The ISC terms for these packages are:
+
+> Permission to use, copy, modify, and/or distribute this software for any
+> purpose with or without fee is hereby granted, provided that the above
+> copyright notice and this permission notice appear in all copies.
+>
+> THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+> REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+> AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+> INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+> LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+> OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+> PERFORMANCE OF THIS SOFTWARE.
+
+Some Lucide icons are derived from Feather and retain this additional notice:
+
+> Copyright (c) 2013-present Cole Bemis
+>
+> Permission is hereby granted, free of charge, to any person obtaining a copy
+> of this software and associated documentation files (the "Software"), to deal
+> in the Software without restriction, including without limitation the rights
+> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+> copies of the Software, and to permit persons to whom the Software is
+> furnished to do so, subject to the following conditions:
+>
+> The above copyright notice and this permission notice shall be included in
+> all copies or substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+> SOFTWARE.
+
+### BSD-3-Clause package
+
+`intl-messageformat@11.2.14` retains this notice:
+
+> Copyright (c) 2023, Oath Inc.
+>
+> Redistribution and use of this software in source and binary forms, with or
+> without modification, are permitted provided that the following conditions
+> are met:
+>
+> - Redistributions of source code must retain the above copyright notice,
+>   this list of conditions and the following disclaimer.
+> - Redistributions in binary form must reproduce the above copyright notice,
+>   this list of conditions and the following disclaimer in the documentation
+>   and/or other materials provided with the distribution.
+> - Neither the name of Oath Inc. nor the names of its contributors may be used
+>   to endorse or promote products derived from this software without specific
+>   prior written permission.
+>
+> THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+> AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+> IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+> ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+> LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+> CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+> SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+> INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+> CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+> ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+> POSSIBILITY OF SUCH DAMAGE.

package/extensions/ai-providers/cursor/connect-frame-reader.ts

@@ -0,0 +1,76 @@
+/** Incremental Cursor Connect framing; callbacks consume complete frames synchronously. */
+export class ConnectFrameReader {
+  private readonly maxBytes: number;
+  private readonly header = Buffer.alloc(5);
+  private headerBytes = 0;
+  private payload: Buffer | undefined;
+  private payloadBytes = 0;
+
+  constructor(maxBytes: number) {
+    this.maxBytes = maxBytes;
+  }
+
+  get incomplete() {
+    return this.headerBytes !== 0;
+  }
+
+  get awaitingPayload() {
+    return this.payload !== undefined;
+  }
+
+  push(chunk: Buffer, onFrame: (flags: number, data: Buffer) => void) {
+    let offset = 0;
+    while (offset < chunk.length) {
+      if (this.payload) {
+        const copied = chunk.copy(
+          this.payload,
+          this.payloadBytes,
+          offset,
+          offset +
+            Math.min(
+              chunk.length - offset,
+              this.payload.length - this.payloadBytes,
+            ),
+        );
+        offset += copied;
+        this.payloadBytes += copied;
+      } else {
+        if (this.headerBytes < 5) {
+          const copied = chunk.copy(
+            this.header,
+            this.headerBytes,
+            offset,
+            offset + Math.min(5 - this.headerBytes, chunk.length - offset),
+          );
+          offset += copied;
+          this.headerBytes += copied;
+          if (this.headerBytes < 5) return;
+        }
+        const size = this.header.readUInt32BE(1);
+        if (size > this.maxBytes)
+          throw new Error(
+            `Cursor Connect frame exceeds ${this.maxBytes} bytes`,
+          );
+        if (chunk.length - offset >= size) {
+          const data = chunk.subarray(offset, offset + size);
+          const flags = this.header[0]!;
+          offset += size;
+          this.headerBytes = 0;
+          onFrame(flags, data);
+          continue;
+        }
+        this.payload = Buffer.allocUnsafe(size);
+        this.payloadBytes = 0;
+        continue;
+      }
+      if (this.payloadBytes === this.payload.length) {
+        const data = this.payload;
+        const flags = this.header[0]!;
+        this.payload = undefined;
+        this.payloadBytes = 0;
+        this.headerBytes = 0;
+        onFrame(flags, data);
+      }
+    }
+  }
+}

package/extensions/ai-providers/cursor/provider.ts

@@ -14,6 +14,7 @@ import type {
 } from "@earendil-works/pi-ai/compat";
 import { createAssistantMessageEventStream } from "@earendil-works/pi-ai/compat";
 import { emptyUsage } from "../usage.ts";
+import { ConnectFrameReader } from "./connect-frame-reader.ts";
 import {
   CURSOR_API_URL,
   CURSOR_CLIENT_VERSION,
@@ -833,7 +834,7 @@ export function streamCursor(
           h2Request?.close(http2.constants.NGHTTP2_CANCEL);
         }, requestTimeoutMs);
       };
-      let frameBuffer: Buffer<ArrayBufferLike> = Buffer.alloc(0);
+      const frames = new ConnectFrameReader(MAX_CONNECT_FRAME_BYTES);
       const processFrame = (flags: number, bytes: Uint8Array) => {
         if (handingOffTools) return;
         if ((flags & CONNECT_COMPRESSED_FLAG) !== 0) {
@@ -1033,23 +1034,9 @@ export function streamCursor(
         );
       };
       const processData = (chunk: Buffer) => {
-        frameBuffer =
-          frameBuffer.length === 0
-            ? chunk
-            : Buffer.concat([frameBuffer, chunk]);
-        while (frameBuffer.length >= 5) {
-          const size = frameBuffer.readUInt32BE(1);
-          if (size > MAX_CONNECT_FRAME_BYTES) {
-            throw new Error(
-              `Cursor Connect frame exceeds ${MAX_CONNECT_FRAME_BYTES} bytes`,
-            );
-          }
-          if (frameBuffer.length < size + 5) return;
-          const flags = frameBuffer[0]!;
-          const data = frameBuffer.subarray(5, size + 5);
-          frameBuffer = frameBuffer.subarray(size + 5);
-          processFrame(flags, data);
-        }
+        frames.push(chunk, processFrame);
+        // Preserve tool batching while a complete header awaits its body.
+        if (frames.awaitingPayload) return;
         if (pendingCalls.size > 0 && !handingOffTools) {
           if (terminalError) throw terminalError;
           if (options?.signal?.aborted)
@@ -1158,7 +1145,7 @@ export function streamCursor(
           .then(() => {
             if (!responseSeen)
               throw new Error("Cursor response headers were not received");
-            if (frameBuffer.length !== 0)
+            if (frames.incomplete)
               throw new Error("Incomplete Cursor Connect frame");
             settle();
           })

package/extensions/file-mutation-display/index.ts

@@ -27,15 +27,19 @@ function compact<TParams extends TSchema, TDetails, TState>(
 export default function fileMutationDisplay(pi: ExtensionAPI) {
   pi.on("session_start", (_event, ctx) => {
     const display = loadSetupConfig().ui;
-    if (ctx.mode === "tui") {
-      // Ctrl+O remains a temporary override. A new/reloaded session starts from
-      // the persisted defaults instead of inheriting an old expanded toggle.
-      ctx.ui.setToolsExpanded(
-        display.subagentResultDisplay === "full" &&
-          display.bashToolDisplay === "full" &&
-          display.fileMutationDisplay === "full",
-      );
-    }
+    // This extension changes only the interactive TUI projection. Headless
+    // sessions must keep Pi's native definitions, especially bash: replacing
+    // it here would drop the SettingsManager-provided shellPath and can make
+    // Windows resolve the WSL System32 stub instead of the configured shell.
+    if (ctx.mode !== "tui") return;
+
+    // Ctrl+O remains a temporary override. A new/reloaded session starts from
+    // the persisted defaults instead of inheriting an old expanded toggle.
+    ctx.ui.setToolsExpanded(
+      display.subagentResultDisplay === "full" &&
+        display.bashToolDisplay === "full" &&
+        display.fileMutationDisplay === "full",
+    );
 
     pi.registerTool(
       compact(

package/extensions/shared/agent-transcript.ts

@@ -409,7 +409,7 @@ function findResult(
 }
 
 /**
- * Caches finalized transcript items by identity and width. Live state remains
+ * Caches finalized transcript items by identity, width, and cwd. Live state remains
  * uncached because it changes on every stream tick; callers clear this cache
  * from their component's invalidate() when Pi changes theme.
  */
@@ -434,7 +434,8 @@ export class AgentTranscriptRenderer {
     for (let index = 0; index < document.items.length; index++) {
       const item = document.items[index];
       const context = itemContext(document.items, index, liveIds, pairing);
-      const key = `${width}|${context.token}`;
+      // Fallback tool rows relativize paths against the document's cwd.
+      const key = JSON.stringify([width, context.token, document.cwd]);
       const cacheable = !document.toolRenderer || !itemHasTool(item);
       const cached = cacheable ? this.itemCache.get(item)?.get(key) : undefined;
       const lines =

package/extensions/web/index.ts

@@ -10,12 +10,23 @@ import {
   PI_CODING_AGENT_ENTRY_ENV,
   resolvePiCodingAgentEntry,
 } from "../../web/host/pi-coding-agent-entry.ts";
+import { TerminalTextSanitizer } from "../shared/terminal-text.ts";
 
 const DEFAULT_SHUTDOWN_TIMEOUT_MS = 5_000;
+const WEB_ERROR_TAIL_MAX_BYTES = 8 * 1024;
+
+interface WebProcessErrorStream {
+  on(event: "data", listener: (chunk: Buffer | string) => void): this;
+  removeListener(
+    event: "data",
+    listener: (chunk: Buffer | string) => void,
+  ): this;
+}
 
 export interface WebProcess {
   readonly exitCode: number | null;
   readonly signalCode: NodeJS.Signals | null;
+  readonly stderr: WebProcessErrorStream | null;
   once(event: "error", listener: (error: Error) => void): this;
   once(
     event: "close",
@@ -28,7 +39,7 @@ interface SpawnWebOptions {
   cwd: string;
   env: NodeJS.ProcessEnv;
   shell: false;
-  stdio: "inherit";
+  stdio: ["inherit", "inherit", "pipe"];
 }
 
 function webProcessEnvironment(
@@ -51,6 +62,7 @@ function webProcessEnvironment(
 export interface WebCommandDependencies {
   entrypoint: string;
   spawn(command: string, args: string[], options: SpawnWebOptions): WebProcess;
+  writeStderr(chunk: Buffer | string): void;
   clearTerminal(): void;
   holdParentSigint(): () => void;
   resolvePiCodingAgentEntry(): string | undefined;
@@ -58,7 +70,12 @@ export interface WebCommandDependencies {
 }
 
 type WebExit =
-  | { kind: "close"; code: number | null; signal: NodeJS.Signals | null }
+  | {
+      kind: "close";
+      code: number | null;
+      signal: NodeJS.Signals | null;
+      errorDetail?: string;
+    }
   | { kind: "error"; error: Error };
 
 interface ActiveWebProcess {
@@ -71,6 +88,9 @@ const defaultDependencies: WebCommandDependencies = {
   spawn(command, args, options) {
     return nodeSpawn(command, args, options);
   },
+  writeStderr(chunk) {
+    process.stderr.write(chunk);
+  },
   clearTerminal() {
     process.stdout.write("\u001b[2J\u001b[H");
   },
@@ -91,6 +111,31 @@ function delay(milliseconds: number) {
   });
 }
 
+function boundedUtf8Tail(text: string, maxBytes: number) {
+  let bytes = 0;
+  let start = text.length;
+  for (const character of Array.from(text).reverse()) {
+    const characterBytes = Buffer.byteLength(character, "utf8");
+    if (bytes + characterBytes > maxBytes) break;
+    bytes += characterBytes;
+    start -= character.length;
+  }
+  return text.slice(start);
+}
+
+function actionableWebError(stderr: string) {
+  const lines = stderr
+    .split(/\r?\n/u)
+    .map((line) => line.trim())
+    .filter(Boolean);
+  const newestFirst = [...lines].reverse();
+  return (
+    newestFirst.find((line) =>
+      line.includes("Failed to start OpenPI Web Workbench:"),
+    ) ?? newestFirst.find((line) => /^(?:Error|Failed):/u.test(line))
+  );
+}
+
 async function stopWebProcess(active: ActiveWebProcess, timeoutMs: number) {
   if (active.child.exitCode !== null || active.child.signalCode !== null)
     return;
@@ -116,15 +161,26 @@ function runWebInForeground(
   return ctx.ui.custom<WebExit>((tui, _theme, _keybindings, done) => {
     let finished = false;
     let tuiStopped = false;
+    let stderrTail = "";
+    let childStderr: WebProcessErrorStream | null | undefined;
     let resolveClosed = () => {};
     const closed = new Promise<void>((resolve) => {
       resolveClosed = resolve;
     });
     const releaseParentSigint = dependencies.holdParentSigint();
+    const sanitizer = new TerminalTextSanitizer();
+    const captureStderr = (chunk: Buffer | string) => {
+      dependencies.writeStderr(chunk);
+      stderrTail = boundedUtf8Tail(
+        `${stderrTail}${sanitizer.push(String(chunk))}`,
+        WEB_ERROR_TAIL_MAX_BYTES,
+      );
+    };
 
     const finish = (result: WebExit) => {
       if (finished) return;
       finished = true;
+      childStderr?.removeListener("data", captureStderr);
       releaseParentSigint();
       setActive(undefined);
       resolveClosed();
@@ -147,13 +203,20 @@ function runWebInForeground(
           cwd: childCwd,
           env: webProcessEnvironment(childCwd, piCodingAgentEntry),
           shell: false,
-          stdio: "inherit",
+          stdio: ["inherit", "inherit", "pipe"],
         },
       );
+      childStderr = child.stderr;
+      childStderr?.on("data", captureStderr);
       setActive({ child, closed });
       child.once("error", (error) => finish({ kind: "error", error }));
       child.once("close", (code, signal) =>
-        finish({ kind: "close", code, signal }),
+        finish({
+          kind: "close",
+          code,
+          signal,
+          errorDetail: actionableWebError(stderrTail),
+        }),
       );
     } catch (error) {
       finish({
@@ -242,7 +305,8 @@ export default function web(
         }
         if (result.code !== 0) {
           ctx.ui.notify(
-            `OpenPI Web Workbench exited with code ${result.code ?? "unknown"}.`,
+            result.errorDetail ??
+              `OpenPI Web Workbench exited with code ${result.code ?? "unknown"}.`,
             "error",
           );
           return;