@qt4798/pi-web 0.17.4 → 0.17.6

package/README.ru.md

@@ -1,134 +1,134 @@
-# Pi Web
-
-[English](./README.en.md) | [中文文档](./README.md) | [日本語](./README.ja.md)
-
-Локальный браузерный интерфейс для [pi coding agent](https://github.com/earendil-works/pi). Pi Web использует те же локальные настройки и файлы сессий, что и pi, поэтому в браузере можно находить и продолжать диалоги, запускать агента, настраивать модели и ресурсы, а также просматривать файлы проекта.
-
-![Pi Web показывает сессию pi со структурированным Markdown, вызовами инструментов и навигацией по проекту](https://raw.githubusercontent.com/agegr/pi-web/main/docs/screenshot2.png)
-
-## Возможности
-
-- **Рабочее пространство сессий**: просмотр, продолжение, переименование, экспорт и удаление диалогов, сгруппированных по проектам, с отображением состояния выполнения, использования контекста, стоимости и сведений о сжатии.
-- **Два способа создать ветку**: **New session** создаёт независимый файл сессии из более раннего сообщения, а **Edit from here** создаёт ветку внутри текущей сессии.
-- **Инструменты для файлов проекта**: просмотр и загрузка файлов, проверка Git Diff, предпросмотр исходного кода, Markdown, изображений, аудио, PDF и DOCX с автоматическим обновлением.
-- **Git worktree**: переключение рабочих деревьев в боковой панели с сохранением общей группы сессий одного репозитория.
-- **Настройка через Web**: управление входом в Provider и API Key, моделями, тестами моделей, пакетами плагинов и навыками без выхода из Pi Web.
-- **Интерфейс на английском, упрощённом и традиционном китайском**: при первом запуске Pi Web учитывает язык браузера, а затем язык можно переключить в верхней панели.
-
-## Быстрый старт
-
-Для работы Pi Web требуется Node.js 22.19.0 или новее. Проверьте версию командой `node --version`, затем выполните:
-
-```bash
-npx @agegr/pi-web@latest
-```
-
-Когда сервер будет готов, CLI попытается открыть браузер автоматически. Если этого не произошло, откройте [http://127.0.0.1:30141](http://127.0.0.1:30141). По умолчанию Pi Web прослушивает только `127.0.0.1`.
-
-Если Provider модели ещё не настроен, откройте панель **Models**, войдите в учётную запись или добавьте API Key.
-
-Чтобы установить команду `pi-web` глобально:
-
-```bash
-npm install -g @agegr/pi-web@latest
-pi-web
-```
-
-Для обновления остановите запущенный процесс с помощью `Ctrl+C` и повторите ту же команду установки. Для удаления выполните `npm uninstall -g @agegr/pi-web`.
-
-## Настройка
-
-Для порта и имени хоста параметры командной строки имеют приоритет над соответствующими переменными окружения. И `--no-open`, и `PI_WEB_NO_OPEN=1` отключают автоматическое открытие браузера независимо друг от друга. `pi-web --help` (или `-h`) выводит параметры запуска и завершает работу без старта сервера. Неизвестные параметры завершают процесс с ошибкой.
-
-| Параметр или переменная окружения | Назначение | Значение по умолчанию |
-| --- | --- | --- |
-| `--help`, `-h` | Показать параметры запуска и выйти | — |
-| `--port <port>`, `-p <port>` или `PORT` | Порт сервера | `30141` |
-| `--hostname <host>`, `-H <host>` или `PI_WEB_HOSTNAME` | Имя хоста для привязки | `127.0.0.1` |
-| `--no-open` или `PI_WEB_NO_OPEN=1` | Не открывать браузер автоматически | Браузер открывается |
-| `PI_WEB_ALLOWED_HOSTS` | Дополнительные точные имена прокси или пользовательских хостов через запятую | Не задано |
-| `PI_WEB_PASSWORD` | Включить HTTP Basic Auth; имя пользователя всегда `pi` | Аутентификация отключена |
-
-Пример:
-
-```bash
-pi-web --help
-pi-web -p 8080 -H 0.0.0.0 --no-open
-```
-
-### Удалённый доступ
-
-Привязка к адресу, отличному от loopback, открывает сетевой доступ к агенту, способному выполнять операции с широкими полномочиями. Даже в доверенной локальной сети используйте длинный случайный пароль:
-
-```bash
-PI_WEB_PASSWORD='длинный-случайный-пароль' pi-web --hostname 0.0.0.0
-```
-
-Basic Auth не шифрует пароль при передаче. Не публикуйте Pi Web в интернете по обычному HTTP; используйте HTTPS через доверенный обратный прокси или надёжное VPN-подключение. Если обратный прокси передаёт внешнее имя хоста, добавьте это точное имя в `PI_WEB_ALLOWED_HOSTS`. Этот список разрешённых имён не меняет адрес, к которому привязывается Pi Web.
-
-### HTTP-прокси
-
-Для серверных запросов к моделям и API используются стандартные переменные окружения `HTTP_PROXY`, `HTTPS_PROXY` и `NO_PROXY`.
-
-В macOS и Linux:
-
-```bash
-HTTP_PROXY=http://127.0.0.1:7890 \
-HTTPS_PROXY=http://127.0.0.1:7890 \
-NO_PROXY=localhost,127.0.0.1 \
-npx @agegr/pi-web@latest
-```
-
-В Windows PowerShell:
-
-```powershell
-$env:HTTP_PROXY = "http://127.0.0.1:7890"
-$env:HTTPS_PROXY = "http://127.0.0.1:7890"
-$env:NO_PROXY = "localhost,127.0.0.1"
-npx @agegr/pi-web@latest
-```
-
-## Примечания
-
-- **Данные агента**: по умолчанию Pi Web читает данные pi из `~/.pi/agent`, включая файлы сессий в `sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl`. Чтобы использовать другой каталог агента pi, задайте `PI_CODING_AGENT_DIR`.
-- **Доступ к файловой системе**: Pi Web должен иметь доступ для чтения к каталогу данных агента и рабочим каталогам, записанным в сессиях. При совместном использовании существующих сессий запускайте Pi Web в той же файловой среде, что и pi.
-- **Общие настройки**: панель Models использует хранилища моделей, настроек и учётных данных pi, поэтому изменения видны в обоих интерфейсах.
-- **Граница доступа к файлам**: файловый браузер ограничен рабочими каталогами, выбранными в Pi Web, и уже известными корнями проектов или сессий; это не универсальный файловый менеджер.
-- **Git worktree**: условия отображения переключателя, создание рабочих деревьев и их удаление описаны в документе [Worktrees in Pi Web](./docs/worktrees.md).
-
-## Разработка
-
-```bash
-npm install
-npm run dev
-```
-
-Сервер разработки доступен по адресу [http://127.0.0.1:30141](http://127.0.0.1:30141). Основные проверки запускаются командами:
-
-```bash
-npm test
-node_modules/.bin/tsc --noEmit
-npm run lint
-```
-
-Не запускайте `next build` или `npm run build` во время обычной разработки. Эти команды записывают данные в `.next/` и могут помешать работе сервера разработки; выполняйте сборку только при подготовке релиза.
-
-Руководства для участников: [Internationalization](./docs/i18n.md) и [Release process](./docs/release.md).
-
-## Структура репозитория
-
-```text
-app/             UI Next.js и маршруты API
-components/      Компоненты интерфейса React
-hooks/           Состояние клиента и обработчики взаимодействий
-lib/             Логика сессий, агента, моделей, файлов, Git и безопасности
-public/          Статические ресурсы и файлы PWA
-bin/             Точка входа npm CLI и разбор параметров запуска
-docs/            Тематические руководства для пользователей и участников
-```
-
-Описание архитектуры и подробная карта файлов приведены в [AGENTS.md](./AGENTS.md).
-
-## Лицензия
-
-[MIT](./LICENSE)
+# Pi Web
+
+[English](./README.en.md) | [中文文档](./README.md) | [日本語](./README.ja.md)
+
+Локальный браузерный интерфейс для [pi coding agent](https://github.com/earendil-works/pi). Pi Web использует те же локальные настройки и файлы сессий, что и pi, поэтому в браузере можно находить и продолжать диалоги, запускать агента, настраивать модели и ресурсы, а также просматривать файлы проекта.
+
+![Pi Web показывает сессию pi со структурированным Markdown, вызовами инструментов и навигацией по проекту](https://raw.githubusercontent.com/agegr/pi-web/main/docs/screenshot2.png)
+
+## Возможности
+
+- **Рабочее пространство сессий**: просмотр, продолжение, переименование, экспорт и удаление диалогов, сгруппированных по проектам, с отображением состояния выполнения, использования контекста, стоимости и сведений о сжатии.
+- **Два способа создать ветку**: **New session** создаёт независимый файл сессии из более раннего сообщения, а **Edit from here** создаёт ветку внутри текущей сессии.
+- **Инструменты для файлов проекта**: просмотр и загрузка файлов, проверка Git Diff, предпросмотр исходного кода, Markdown, изображений, аудио, PDF и DOCX с автоматическим обновлением.
+- **Git worktree**: переключение рабочих деревьев в боковой панели с сохранением общей группы сессий одного репозитория.
+- **Настройка через Web**: управление входом в Provider и API Key, моделями, тестами моделей, пакетами плагинов и навыками без выхода из Pi Web.
+- **Интерфейс на английском, упрощённом и традиционном китайском**: при первом запуске Pi Web учитывает язык браузера, а затем язык можно переключить в верхней панели.
+
+## Быстрый старт
+
+Для работы Pi Web требуется Node.js 22.19.0 или новее. Проверьте версию командой `node --version`, затем выполните:
+
+```bash
+npx @agegr/pi-web@latest
+```
+
+Когда сервер будет готов, CLI попытается открыть браузер автоматически. Если этого не произошло, откройте [http://127.0.0.1:30141](http://127.0.0.1:30141). По умолчанию Pi Web прослушивает только `127.0.0.1`.
+
+Если Provider модели ещё не настроен, откройте панель **Models**, войдите в учётную запись или добавьте API Key.
+
+Чтобы установить команду `pi-web` глобально:
+
+```bash
+npm install -g @agegr/pi-web@latest
+pi-web
+```
+
+Для обновления остановите запущенный процесс с помощью `Ctrl+C` и повторите ту же команду установки. Для удаления выполните `npm uninstall -g @agegr/pi-web`.
+
+## Настройка
+
+Для порта и имени хоста параметры командной строки имеют приоритет над соответствующими переменными окружения. И `--no-open`, и `PI_WEB_NO_OPEN=1` отключают автоматическое открытие браузера независимо друг от друга. `pi-web --help` (или `-h`) выводит параметры запуска и завершает работу без старта сервера. Неизвестные параметры завершают процесс с ошибкой.
+
+| Параметр или переменная окружения | Назначение | Значение по умолчанию |
+| --- | --- | --- |
+| `--help`, `-h` | Показать параметры запуска и выйти | — |
+| `--port <port>`, `-p <port>` или `PORT` | Порт сервера | `30141` |
+| `--hostname <host>`, `-H <host>` или `PI_WEB_HOSTNAME` | Имя хоста для привязки | `127.0.0.1` |
+| `--no-open` или `PI_WEB_NO_OPEN=1` | Не открывать браузер автоматически | Браузер открывается |
+| `PI_WEB_ALLOWED_HOSTS` | Дополнительные точные имена прокси или пользовательских хостов через запятую | Не задано |
+| `PI_WEB_PASSWORD` | Включить HTTP Basic Auth; имя пользователя всегда `pi` | Аутентификация отключена |
+
+Пример:
+
+```bash
+pi-web --help
+pi-web -p 8080 -H 0.0.0.0 --no-open
+```
+
+### Удалённый доступ
+
+Привязка к адресу, отличному от loopback, открывает сетевой доступ к агенту, способному выполнять операции с широкими полномочиями. Даже в доверенной локальной сети используйте длинный случайный пароль:
+
+```bash
+PI_WEB_PASSWORD='длинный-случайный-пароль' pi-web --hostname 0.0.0.0
+```
+
+Basic Auth не шифрует пароль при передаче. Не публикуйте Pi Web в интернете по обычному HTTP; используйте HTTPS через доверенный обратный прокси или надёжное VPN-подключение. Если обратный прокси передаёт внешнее имя хоста, добавьте это точное имя в `PI_WEB_ALLOWED_HOSTS`. Этот список разрешённых имён не меняет адрес, к которому привязывается Pi Web.
+
+### HTTP-прокси
+
+Для серверных запросов к моделям и API используются стандартные переменные окружения `HTTP_PROXY`, `HTTPS_PROXY` и `NO_PROXY`.
+
+В macOS и Linux:
+
+```bash
+HTTP_PROXY=http://127.0.0.1:7890 \
+HTTPS_PROXY=http://127.0.0.1:7890 \
+NO_PROXY=localhost,127.0.0.1 \
+npx @agegr/pi-web@latest
+```
+
+В Windows PowerShell:
+
+```powershell
+$env:HTTP_PROXY = "http://127.0.0.1:7890"
+$env:HTTPS_PROXY = "http://127.0.0.1:7890"
+$env:NO_PROXY = "localhost,127.0.0.1"
+npx @agegr/pi-web@latest
+```
+
+## Примечания
+
+- **Данные агента**: по умолчанию Pi Web читает данные pi из `~/.pi/agent`, включая файлы сессий в `sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl`. Чтобы использовать другой каталог агента pi, задайте `PI_CODING_AGENT_DIR`.
+- **Доступ к файловой системе**: Pi Web должен иметь доступ для чтения к каталогу данных агента и рабочим каталогам, записанным в сессиях. При совместном использовании существующих сессий запускайте Pi Web в той же файловой среде, что и pi.
+- **Общие настройки**: панель Models использует хранилища моделей, настроек и учётных данных pi, поэтому изменения видны в обоих интерфейсах.
+- **Граница доступа к файлам**: файловый браузер ограничен рабочими каталогами, выбранными в Pi Web, и уже известными корнями проектов или сессий; это не универсальный файловый менеджер.
+- **Git worktree**: условия отображения переключателя, создание рабочих деревьев и их удаление описаны в документе [Worktrees in Pi Web](./docs/worktrees.md).
+
+## Разработка
+
+```bash
+npm install
+npm run dev
+```
+
+Сервер разработки доступен по адресу [http://127.0.0.1:30141](http://127.0.0.1:30141). Основные проверки запускаются командами:
+
+```bash
+npm test
+node_modules/.bin/tsc --noEmit
+npm run lint
+```
+
+Не запускайте `next build` или `npm run build` во время обычной разработки. Эти команды записывают данные в `.next/` и могут помешать работе сервера разработки; выполняйте сборку только при подготовке релиза.
+
+Руководства для участников: [Internationalization](./docs/i18n.md) и [Release process](./docs/release.md).
+
+## Структура репозитория
+
+```text
+app/             UI Next.js и маршруты API
+components/      Компоненты интерфейса React
+hooks/           Состояние клиента и обработчики взаимодействий
+lib/             Логика сессий, агента, моделей, файлов, Git и безопасности
+public/          Статические ресурсы и файлы PWA
+bin/             Точка входа npm CLI и разбор параметров запуска
+docs/            Тематические руководства для пользователей и участников
+```
+
+Описание архитектуры и подробная карта файлов приведены в [AGENTS.md](./AGENTS.md).
+
+## Лицензия
+
+[MIT](./LICENSE)

package/bin/fix-pi-agent-undici.js

@@ -1,122 +1,122 @@
-"use strict";
-
-// Fix: @earendil-works/pi-coding-agent@0.83.0 ships with an npm-shrinkwrap.json
-// that pins undici to 8.5.0, which has 7+ known CVEs. npm overrides cannot
-// penetrate shrinkwrap. This script:
-//   1. Removes the shrinkwrap (so future reinstalls respect overrides)
-//   2. Replaces the nested undici with the top-level undici@^8.10.0
-//
-// Two modes:
-//   - applyUndiciFix (runtime, dev/CLI): replaces the nested undici with a
-//     **symlink** to the top-level undici. The dir is writable here, and a
-//     symlink keeps future reinstalls pointing at the fixed version.
-//   - solidifyUndiciFix (build time, packaging): replaces the nested undici
-//     (whether a real dir or a symlink) with a **physical copy** of the fixed
-//     version so the standalone output (`.next/standalone`) is fully
-//     self-contained with no symlinks — the installed, read-only bundle never
-//     needs to write anything at runtime and survives NSIS/macOS bundle copying.
-//
-// Note: npm audit will still report undici CVEs because the lockfile
-// references the old version. This is a cosmetic false positive — the
-// code loaded at runtime is undici@^8.10.0.
-//
-// The fix used to run as a `postinstall` hook. It now runs lazily at
-// `pi-web` startup (bin/pi-web.js) and before the repo's dev/start scripts.
-// Moving it out of postinstall keeps `npm install` output quiet under
-// npm >= 11.16's allow-scripts policy and guarantees the fix applies even on
-// installs where lifecycle scripts are blocked or skipped.
-
-const fs = require("fs");
-const path = require("path");
-
-/**
- * Apply the undici fix under `rootDir`.
- * @param {string} [rootDir] package root (contains node_modules/)
- * @param {{copy?: boolean, topUndici?: string}} [opts]
- *   - copy: when true, copy the fixed undici into place instead of symlinking
- *   - topUndici: explicit path to the fixed undici directory (defaults to
- *     <rootDir>/node_modules/undici)
- */
-function applyUndiciFix(rootDir = path.join(__dirname, ".."), opts = {}) {
-  const copy = opts.copy === true;
-  const agentDir = path.join(
-    rootDir,
-    "node_modules",
-    "@earendil-works",
-    "pi-coding-agent",
-  );
-  if (!fs.existsSync(agentDir)) return; // not installed here — nothing to fix
-
-  const shrinkwrap = path.join(agentDir, "npm-shrinkwrap.json");
-  const nestedUndici = path.join(agentDir, "node_modules", "undici");
-  const topUndici = opts.topUndici || path.join(rootDir, "node_modules", "undici");
-
-  // 1. Remove shrinkwrap
-  if (fs.existsSync(shrinkwrap)) {
-    console.log("[pi-web] Removing pi-coding-agent shrinkwrap…");
-    fs.rmSync(shrinkwrap);
-  }
-
-  // 2. Inspect the nested undici (may be a real dir or an existing symlink)
-  let nestedIsSymlink = false;
-  let nestedIsDir = false;
-  try {
-    const st = fs.lstatSync(nestedUndici);
-    nestedIsSymlink = st.isSymbolicLink();
-    nestedIsDir = st.isDirectory();
-  } catch {
-    return; // nested undici missing — nothing to replace
-  }
-  if (!nestedIsSymlink && !nestedIsDir) return;
-  // Runtime symlink mode is idempotent: an existing symlink means already fixed.
-  if (nestedIsSymlink && !copy) return;
-  if (!fs.existsSync(topUndici)) return;
-
-  try {
-    const nestedVersion = require(path.join(nestedUndici, "package.json")).version;
-    const topVersion = require(path.join(topUndici, "package.json")).version;
-    // Already a real dir with the correct version → nothing to do.
-    if (!nestedIsSymlink && nestedVersion === topVersion) return;
-
-    fs.rmSync(nestedUndici, { recursive: true, force: true });
-
-    if (copy) {
-      fs.cpSync(topUndici, nestedUndici, { recursive: true });
-      console.log(
-        `[pi-web] Copied undici@${topVersion} into pi-coding-agent (solidified)`,
-      );
-    } else {
-      const rel = path.relative(path.dirname(nestedUndici), topUndici);
-      fs.symlinkSync(
-        rel,
-        nestedUndici,
-        process.platform === "win32" ? "junction" : "dir",
-      );
-      console.log(
-        `[pi-web] Replacing pi-coding-agent's undici@${nestedVersion} ` +
-          `→ symlink to undici@${topVersion}`,
-      );
-    }
-  } catch (err) {
-    console.warn("[pi-web] undici fix skipped:", err.message);
-  }
-}
-
-/**
- * Build-time solidification for packaging: physically copy the fixed undici
- * into the standalone output so the read-only installed bundle needs no
- * runtime writes and contains no symlinks.
- * @param {string} [rootDir] standalone root (contains node_modules/)
- * @param {string} [topUndiciDir] path to the fixed undici to copy in
- */
-function solidifyUndiciFix(rootDir = path.join(__dirname, ".."), topUndiciDir) {
-  const source = topUndiciDir || path.join(rootDir, "node_modules", "undici");
-  if (!fs.existsSync(source)) return; // nothing to copy from
-  applyUndiciFix(rootDir, { copy: true, topUndici: source });
-}
-
-module.exports = { applyUndiciFix, solidifyUndiciFix };
-
-if (require.main === module) {
-  applyUndiciFix();
-}
+"use strict";
+
+// Fix: @earendil-works/pi-coding-agent@0.83.0 ships with an npm-shrinkwrap.json
+// that pins undici to 8.5.0, which has 7+ known CVEs. npm overrides cannot
+// penetrate shrinkwrap. This script:
+//   1. Removes the shrinkwrap (so future reinstalls respect overrides)
+//   2. Replaces the nested undici with the top-level undici@^8.10.0
+//
+// Two modes:
+//   - applyUndiciFix (runtime, dev/CLI): replaces the nested undici with a
+//     **symlink** to the top-level undici. The dir is writable here, and a
+//     symlink keeps future reinstalls pointing at the fixed version.
+//   - solidifyUndiciFix (build time, packaging): replaces the nested undici
+//     (whether a real dir or a symlink) with a **physical copy** of the fixed
+//     version so the standalone output (`.next/standalone`) is fully
+//     self-contained with no symlinks — the installed, read-only bundle never
+//     needs to write anything at runtime and survives NSIS/macOS bundle copying.
+//
+// Note: npm audit will still report undici CVEs because the lockfile
+// references the old version. This is a cosmetic false positive — the
+// code loaded at runtime is undici@^8.10.0.
+//
+// The fix used to run as a `postinstall` hook. It now runs lazily at
+// `pi-web` startup (bin/pi-web.js) and before the repo's dev/start scripts.
+// Moving it out of postinstall keeps `npm install` output quiet under
+// npm >= 11.16's allow-scripts policy and guarantees the fix applies even on
+// installs where lifecycle scripts are blocked or skipped.
+
+const fs = require("fs");
+const path = require("path");
+
+/**
+ * Apply the undici fix under `rootDir`.
+ * @param {string} [rootDir] package root (contains node_modules/)
+ * @param {{copy?: boolean, topUndici?: string}} [opts]
+ *   - copy: when true, copy the fixed undici into place instead of symlinking
+ *   - topUndici: explicit path to the fixed undici directory (defaults to
+ *     <rootDir>/node_modules/undici)
+ */
+function applyUndiciFix(rootDir = path.join(__dirname, ".."), opts = {}) {
+  const copy = opts.copy === true;
+  const agentDir = path.join(
+    rootDir,
+    "node_modules",
+    "@earendil-works",
+    "pi-coding-agent",
+  );
+  if (!fs.existsSync(agentDir)) return; // not installed here — nothing to fix
+
+  const shrinkwrap = path.join(agentDir, "npm-shrinkwrap.json");
+  const nestedUndici = path.join(agentDir, "node_modules", "undici");
+  const topUndici = opts.topUndici || path.join(rootDir, "node_modules", "undici");
+
+  // 1. Remove shrinkwrap
+  if (fs.existsSync(shrinkwrap)) {
+    console.log("[pi-web] Removing pi-coding-agent shrinkwrap…");
+    fs.rmSync(shrinkwrap);
+  }
+
+  // 2. Inspect the nested undici (may be a real dir or an existing symlink)
+  let nestedIsSymlink = false;
+  let nestedIsDir = false;
+  try {
+    const st = fs.lstatSync(nestedUndici);
+    nestedIsSymlink = st.isSymbolicLink();
+    nestedIsDir = st.isDirectory();
+  } catch {
+    return; // nested undici missing — nothing to replace
+  }
+  if (!nestedIsSymlink && !nestedIsDir) return;
+  // Runtime symlink mode is idempotent: an existing symlink means already fixed.
+  if (nestedIsSymlink && !copy) return;
+  if (!fs.existsSync(topUndici)) return;
+
+  try {
+    const nestedVersion = require(path.join(nestedUndici, "package.json")).version;
+    const topVersion = require(path.join(topUndici, "package.json")).version;
+    // Already a real dir with the correct version → nothing to do.
+    if (!nestedIsSymlink && nestedVersion === topVersion) return;
+
+    fs.rmSync(nestedUndici, { recursive: true, force: true });
+
+    if (copy) {
+      fs.cpSync(topUndici, nestedUndici, { recursive: true });
+      console.log(
+        `[pi-web] Copied undici@${topVersion} into pi-coding-agent (solidified)`,
+      );
+    } else {
+      const rel = path.relative(path.dirname(nestedUndici), topUndici);
+      fs.symlinkSync(
+        rel,
+        nestedUndici,
+        process.platform === "win32" ? "junction" : "dir",
+      );
+      console.log(
+        `[pi-web] Replacing pi-coding-agent's undici@${nestedVersion} ` +
+          `→ symlink to undici@${topVersion}`,
+      );
+    }
+  } catch (err) {
+    console.warn("[pi-web] undici fix skipped:", err.message);
+  }
+}
+
+/**
+ * Build-time solidification for packaging: physically copy the fixed undici
+ * into the standalone output so the read-only installed bundle needs no
+ * runtime writes and contains no symlinks.
+ * @param {string} [rootDir] standalone root (contains node_modules/)
+ * @param {string} [topUndiciDir] path to the fixed undici to copy in
+ */
+function solidifyUndiciFix(rootDir = path.join(__dirname, ".."), topUndiciDir) {
+  const source = topUndiciDir || path.join(rootDir, "node_modules", "undici");
+  if (!fs.existsSync(source)) return; // nothing to copy from
+  applyUndiciFix(rootDir, { copy: true, topUndici: source });
+}
+
+module.exports = { applyUndiciFix, solidifyUndiciFix };
+
+if (require.main === module) {
+  applyUndiciFix();
+}