@piagent/platform 1.48.1 → 1.48.3

package/packages/piagent-webui/dist/client/assets/{workspace-api-D8sJkiZB.js → workspace-api-CFBR73lU.js}

@@ -1 +1 @@
-import{o as e}from"./bootstrap-CedkNtRG.js";async function t(t,n,r,i){let a=new URLSearchParams({path:r}),o=await fetch(`/api/v1/sessions/${encodeURIComponent(t)}/inspection/workspace/${n}?${a}`,{credentials:`same-origin`,headers:{Accept:`application/json`},signal:i});if(o.status===401&&e(),!o.ok)throw Error(`workspace-read-failed`);return await o.json()}var n=(e,n,r)=>t(e,`tree`,n,r),r=(e,n,r)=>t(e,`file`,n,r),i=(e,n,r)=>t(e,`media`,n,r);async function a(t,n,r){let i=await fetch(`/api/v1/sessions/${encodeURIComponent(t)}/inspection/workspace/paths?${new URLSearchParams({query:n})}`,{credentials:`same-origin`,headers:{Accept:`application/json`},signal:r});if(i.status===401&&e(),!i.ok)throw Error(`workspace-read-failed`);return await i.json()}async function o(t,n,r){let i=await fetch(`/api/v1/sessions/${encodeURIComponent(t)}/inspection/workspace/search?${new URLSearchParams({query:n})}`,{credentials:`same-origin`,headers:{Accept:`application/json`},signal:r});if(i.status===401&&e(),!i.ok)throw Error(`workspace-read-failed`);return await i.json()}export{o as a,n as i,i as n,a as r,r as t};
+import{o as e}from"./bootstrap-CedkNtRG.js";async function t(t,n,r,i){let a=new URLSearchParams({path:r}),o=await fetch(`/api/v1/sessions/${encodeURIComponent(t)}/inspection/workspace/${n}?${a}`,{credentials:`same-origin`,headers:{Accept:`application/json`},signal:i});if(o.status===401&&e(),!o.ok)throw Error(`workspace-read-failed`);return await o.json()}var n=(e,n,r)=>t(e,`tree`,n,r),r=(e,n,r)=>t(e,`file`,n,r),i=(e,n,r)=>t(e,`media`,n,r);async function a(t,n,r){let i=await fetch(`/api/v1/sessions/${encodeURIComponent(t)}/inspection/workspace/paths?${new URLSearchParams({query:n})}`,{credentials:`same-origin`,headers:{Accept:`application/json`},signal:r});if(i.status===401&&e(),!i.ok)throw Error(`workspace-read-failed`);return await i.json()}async function o(t,n,r){let i=await fetch(`/api/v1/sessions/${encodeURIComponent(t)}/inspection/workspace/search?${new URLSearchParams({query:n})}`,{credentials:`same-origin`,headers:{Accept:`application/json`},signal:r});if(i.status===401&&e(),!i.ok)throw Error(`workspace-read-failed`);return await i.json()}async function s(e,t){let n=t.split(`/`).at(-1)??`file`,a=await i(e,t).catch(()=>null),o=a?.data&&a.mime?`data:${a.mime};base64,${a.data}`:null,s=!1;if(!o){let n=await r(e,t).catch(()=>null);if(typeof n?.content!=`string`)return!1;o=URL.createObjectURL(new Blob([n.content],{type:`text/plain`})),s=!0}let c=document.createElement(`a`);return c.href=o,c.download=n,document.body.append(c),c.click(),c.remove(),s&&setTimeout(()=>URL.revokeObjectURL(o),1e4),!0}export{s as a,n as i,i as n,o,a as r,r as t};

package/packages/piagent-webui/dist/client/assets/workspace-navigation-DW8zhH6U.js

@@ -0,0 +1 @@
+import{r as e}from"./rolldown-runtime-hePW80VL.js";import{An as t,Rn as n,Ut as r,zt as i}from"./vendor-DNZbaWhT.js";import{i as a,n as o}from"./ui-preferences-OfS30-ZV.js";import{h as s}from"./api-BQS4Dtrr.js";var c=e(n(),1);function l(e,t=1){let n=/^(.+?)(?::(\d+)(?::\d+)?)?$/.exec(e.replace(/^@/,``)),r=n?.[1];return!r||r.length>4096||/^[~/]/.test(r)||/[\\\x00-\x1f\x7f:]/.test(r)||r.split(`/`).some(e=>!e||e===`.`||e===`..`)?null:{path:r,line:Math.max(1,Math.min(1e6,Number(n?.[2])||t||1))}}function u(e){let t=e.trim();if(!t||t.length>4096||/^(?:https?|mailto|data|javascript):/i.test(t)||t.startsWith(`#`))return null;if(/^file:/i.test(t))try{t=new URL(t).pathname}catch{return null}try{t=decodeURIComponent(t)}catch{}let n=/#L(\d+)(?:-L?\d+)?$/.exec(t),r=n?Number(n[1]):void 0;if(n&&(t=t.slice(0,n.index)),t=t.replace(/^\.\//,``),t.startsWith(`/`)){let e=/^(\/.+?)(?::(\d+)(?::\d+)?)?$/.exec(t),n=e?.[1]??``;return!n||/[\x00-\x1f\x7f]/.test(n)||n.split(`/`).slice(1).some(e=>!e||e===`.`||e===`..`)?null:{path:n,line:Math.max(1,Math.min(1e6,r??(Number(e?.[2])||1))),absolute:!0}}let i=l(t,r);return i?{...i,absolute:!1}:null}var d=t(),f=`piagent-workspace-open`;async function p(e,t){let n=(await s(e)).roots.find(e=>e.source===`project`&&t.startsWith(`${e.path.replace(/\/+$/,``)}/`));return n?t.slice(n.path.replace(/\/+$/,``).length+1):null}async function m(e,t){return t.absolute?p(e,t.path):t.path}var h=(0,c.createContext)(null);function g(){return(0,c.useContext)(h)}var _=(0,c.createContext)(null);function v({sessionRef:e,onOpen:t,children:n}){let r=n=>{t(),window.dispatchEvent(new CustomEvent(f,{detail:{sessionRef:e,...n}}))};return(0,d.jsx)(_.Provider,{value:e?t=>{if(!(`absolute`in t)||!t.absolute){r({path:t.path,line:t.line});return}p(e,t.path).then(e=>{e&&r({path:e,line:t.line})},()=>void 0)}:null,children:(0,d.jsx)(h.Provider,{value:e??null,children:n})})}function y({path:e,line:t,children:n}){let i=(0,c.useContext)(_),{locale:s}=a(),u=l(e,t);return!i||!u?n?(0,d.jsx)(d.Fragment,{children:n}):null:(0,d.jsx)(r,{size:`small`,onClick:()=>i(u),sx:{textTransform:`none`,verticalAlign:`baseline`},children:n??o(s,`Mở trong editor`,`Open in editor`)})}function b({link:e,children:t}){let n=(0,c.useContext)(_),{locale:r}=a();return n?(0,d.jsx)(i,{component:`button`,type:`button`,underline:`hover`,onClick:()=>n(e),title:o(r,`Mở ${e.path}`,`Open ${e.path}`),sx:{font:`inherit`,verticalAlign:`baseline`,textAlign:`left`},children:t}):(0,d.jsx)(d.Fragment,{children:t})}function x({children:e}){return(0,d.jsx)(d.Fragment,{children:c.Children.map(e,e=>typeof e==`string`?e.split(/((?<![\w@])@[\w./-]+\.[\w]+(?::\d+)?)/g).map((e,t)=>e.startsWith(`@`)&&l(e)?(0,d.jsx)(y,{path:e,children:e},t):e):e)})}export{v as a,u as c,x as i,l,y as n,m as o,b as r,g as s,f as t};

package/packages/piagent-webui/dist/client/index.html

@@ -7,10 +7,10 @@
     <meta name="csp-nonce" content="__PIAGENT_CSP_NONCE__" />
     <meta name="piagent-webui-mode" content="__PIAGENT_WEBUI_MODE__" />
     <title>Piagent WebUI</title>
-    <script type="module" crossorigin src="/assets/index-CNdhIouM.js"></script>
+    <script type="module" crossorigin src="/assets/index-DcrpSyBK.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-hePW80VL.js">
-    <link rel="modulepreload" crossorigin href="/assets/vendor-CSDKB7mU.js">
-    <link rel="modulepreload" crossorigin href="/assets/ui-preferences-0waeSO-S.js">
+    <link rel="modulepreload" crossorigin href="/assets/vendor-DNZbaWhT.js">
+    <link rel="modulepreload" crossorigin href="/assets/ui-preferences-OfS30-ZV.js">
     <link rel="stylesheet" crossorigin href="/assets/index-CjM70M7D.css">
   </head>
   <body>

package/packages/piagent-webui/shared/process-copy.ts

@@ -15,7 +15,8 @@ const SEVERITY: Record<string, [string, string]> = { blocking: ["blocking", "blo
 const KIND: Record<string, [string, string]> = { wrong_premise: ["sai giả định", "wrong premise"], conflicts_with_request: ["conflict với yêu cầu", "conflicts with the request"],
   ambiguous: ["chưa rõ ràng", "ambiguous"], out_of_scope: ["out of scope", "out of scope"] };
 const UNAVAILABLE: Record<string, [string, string]> = { too_large: ["patch quá lớn", "the patch is too large"], not_git: ["thư mục không phải git", "not a git repository"],
-  limit: ["subagent đã hết lượt gọi", "the subagent ran out of calls"], failed: ["subagent lỗi", "the subagent failed"] };
+  limit: ["subagent đã hết lượt gọi", "the subagent ran out of calls"], failed: ["subagent lỗi", "the subagent failed"],
+  runtime_changed: ["Piagent vừa được cập nhật, hãy mở lại cuộc trò chuyện", "Piagent was just updated; reopen the conversation"] };
 
 // How a code-changing turn ended against the Harness workflow, in a few words.
 export function outcomeText(process: ProcessCopyInput, locale: CopyLocale): string {

package/schemas/piagent-webui/workspace-media-v1.schema.json

@@ -40,6 +40,12 @@
         "image/bmp",
         "image/x-icon",
         "image/avif",
+        "image/svg+xml",
+        "application/pdf",
+        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+        "application/zip",
         null
       ]
     },

package/scripts/company-terminal.mjs

@@ -9,6 +9,7 @@ import { execFile } from 'node:child_process';
 import { pathToFileURL } from 'node:url';
 
 import { registerTerminalUpdateOffer } from '../packages/piagent-core/runtime/update/terminal-update-offer.mjs';
+import { watchTerminalReload } from '../packages/piagent-core/runtime/update/terminal-reload.mjs';
 import { registerStyleCommand } from '../packages/piagent-core/runtime/terminal/terminal-style.mjs';
 import { parseFailure } from '../packages/piagent-core/runtime/managed-failure.mjs';
 import { checkpointsOf } from '../packages/piagent-core/managed/checkpoints.mjs';
@@ -258,6 +259,16 @@ export function companyMode(Base, { summary, whatsNew, components }) {
   const say = (mode, name, tone = 'warning') => mode.showExtensionNotify(companyCommandText(name, summary()), tone);
   return class CompanyInteractiveMode extends Base {
     async handleShareCommand() { say(this, 'share'); }
+    // Pi's own shutdown without its process.exit: the Terminal is restored and
+    // the session closed, then piagent-studio.mjs hands over to the new release.
+    async stopForRestart() {
+      if (this.isShuttingDown) return;
+      this.isShuttingDown = true;
+      this.themeController?.disableAutoSync?.();
+      await this.ui.terminal.drainInput(1000);
+      this.stop();
+      await this.runtimeHost.dispose();
+    }
     async handleBugCommand() { say(this, 'bug'); }
     suggestBugReport() {}
     crashReportInstructions() { return 'Lần sau mở lại: piagent studio, rồi /resume. Gửi admin của team giờ xảy ra lỗi.'; }
@@ -285,7 +296,7 @@ export function companyMode(Base, { summary, whatsNew, components }) {
   };
 }
 
-export function companyTerminalExtension({ managed, packageRoot, sdkRoot, bindingChanged = () => false }) {
+export function companyTerminalExtension({ managed, packageRoot, sdkRoot, bindingChanged = () => false, restartInPlace = null }) {
   const require = createRequire(path.join(sdkRoot, 'package.json'));
   let tui;
   const components = async () => (tui ??= await import(pathToFileURL(require.resolve('@earendil-works/pi-tui')).href));
@@ -302,6 +313,15 @@ export function companyTerminalExtension({ managed, packageRoot, sdkRoot, bindin
     registerTerminalUpdateOffer(pi, { installed, packageRoot, restart: 'piagent studio',
       afterUpdate: () => bindingChanged() ? 'Bản mới đổi trình khởi chạy công ty: Agent Watch tự cập nhật cấu hình (cần Agent Watch đang chạy); piagent studio chờ việc này khi mở lại.' : null });
 
+    // `piagent reload` and a finished update: the company code is loaded once
+    // per process, so this Terminal starts again in place on the same
+    // conversation (piagent-studio.mjs), when idle. A Terminal opened by an
+    // older launcher cannot be started again for the member: it says so.
+    watchTerminalReload(pi, { apply: async (ctx, request) => {
+      if (!restartInPlace) { ctx.ui.notify(`Có Piagent ${request.version ?? 'mới'}: thoát rồi mở lại \`piagent studio\`, rồi /resume, để dùng bản mới.`, 'warning'); return; }
+      setTimeout(() => { void restartInPlace(); }, 0);
+    } });
+
     // The member's pick of look (/style); /settings is not offered here.
     registerStyleCommand(pi, { remember: true });
 

package/scripts/piagent-cli.mjs

@@ -29,7 +29,8 @@ const scriptByCommand = {
   "piagent-dashboard": "scripts/piagent-dashboard.mjs",
   "piagent-pi-host": "scripts/pi-host.mjs",
   "piagent-skills": "scripts/skill-sources.mjs",
-  "piagent-restore-pi": "scripts/personal-pi-restore.mjs"
+  "piagent-restore-pi": "scripts/personal-pi-restore.mjs",
+  "piagent-reload": "scripts/terminal-reload.mjs"
 };
 
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
@@ -93,6 +94,7 @@ if (invokedAs === "piagent") {
     console.log("  dashboard   Open and manage the local session hub");
     console.log("  studio      Open the managed company agent imported by Agent Watch");
     console.log("  pi          Same as `piagent`: Pi on the release Piagent is qualified on, in Piagent's home");
+    console.log("  reload      Move every open Piagent Terminal to the installed release, without closing them");
     console.log("  restore-pi  Take an older Piagent install out of your own pi (~/.pi/agent)");
     console.log("  pi-host     Show or install the Pi host Piagent runs");
     console.log("  skills      Add, list or remove skill sources such as mattpocock/skills");
@@ -196,18 +198,48 @@ const runner = target.endsWith(".mjs") ? process.execPath : "bash";
 const runnerArgs = target.endsWith(".mjs")
   ? ["--disable-warning=ExperimentalWarning", "--import", pathToFileURL(path.join(sourceRoot, "scripts", "register-typescript-loader.mjs")).href, target]
   : [target];
-const child = spawn(runner, [...runnerArgs, ...forwardedArgs], {
-  cwd: process.cwd(),
-  env: script === "scripts/piagent-studio.mjs" ? { PATH: "/usr/bin:/bin", HOME: os.homedir(), TERM: process.env.TERM || "xterm-256color", LANG: "en_US.UTF-8" }
-    : { ...process.env, PI_CODING_AGENT_DIR: piagentHome(), ...(terminal ? { PIAGENT_ACTIVE: "1" } : {}) },
-  stdio: "inherit"
-});
+// The company Terminal can start again in place on a new release (`piagent
+// reload`, or after `piagent-update`): it writes the arguments that reopen its
+// conversation to this file and exits with RESTART_CODE; the files of the
+// installed release are run again with them, in the same terminal window.
+const RESTART_CODE = 75;
+const restartFile = script === "scripts/piagent-studio.mjs" ? path.join(os.homedir(), ".pi", "piagent-restart", `${process.pid}.json`) : null;
+function takeRestart() {
+  if (!restartFile) return null;
+  try {
+    const value = JSON.parse(fs.readFileSync(restartFile, "utf8"));
+    fs.rmSync(restartFile, { force: true });
+    return Array.isArray(value?.args) && value.args.every((arg) => typeof arg === "string") ? value.args : null;
+  } catch { return null; }
+}
 
-child.once("error", (error) => {
-  const code = error && typeof error === "object" && "code" in error ? ` (${error.code})` : "";
-  console.error(`Pi Agent command could not start ${runner}${code}. Ensure it is installed and available on PATH.`);
-  process.exit(1);
-});
+let child;
+function launch(args) {
+  child = spawn(runner, [...runnerArgs, ...args], {
+    cwd: process.cwd(),
+    env: script === "scripts/piagent-studio.mjs" ? { PATH: "/usr/bin:/bin", HOME: os.homedir(), TERM: process.env.TERM || "xterm-256color", LANG: "en_US.UTF-8", PIAGENT_RESTART_FILE: restartFile }
+      : { ...process.env, PI_CODING_AGENT_DIR: piagentHome(), ...(terminal ? { PIAGENT_ACTIVE: "1" } : {}) },
+    stdio: "inherit"
+  });
+
+  child.once("error", (error) => {
+    const code = error && typeof error === "object" && "code" in error ? ` (${error.code})` : "";
+    console.error(`Pi Agent command could not start ${runner}${code}. Ensure it is installed and available on PATH.`);
+    process.exit(1);
+  });
+
+  child.once("exit", (code, signal) => {
+    if (signal) {
+      process.removeAllListeners(signal);
+      process.kill(process.pid, signal);
+      return;
+    }
+    const again = code === RESTART_CODE ? takeRestart() : null;
+    if (again) { launch(again); return; }
+    process.exit(code ?? 1);
+  });
+}
+launch(forwardedArgs);
 
 // A command stopped from outside (a script, an editor, a timeout) stops its
 // child too, rather than leaving a company run going in the background. A
@@ -215,12 +247,3 @@ child.once("error", (error) => {
 // stays until the child has finished.
 for (const signal of ["SIGTERM", "SIGHUP"]) process.on(signal, () => { try { child.kill(signal); } catch { /* already gone */ } });
 process.on("SIGINT", () => {});
-
-child.once("exit", (code, signal) => {
-  if (signal) {
-    process.removeAllListeners(signal);
-    process.kill(process.pid, signal);
-    return;
-  }
-  process.exit(code ?? 1);
-});

package/scripts/piagent-studio.mjs

@@ -30,6 +30,11 @@ const home = os.homedir();
 // Read before the environment is cleared: a Herdr pane's socket for the
 // Terminal's reporter, and the PATH that finds the Windows browser from WSL.
 const herdr = herdrEnvironment(), ambientPath = process.env.PATH;
+// The launcher (piagent-cli.mjs) names a file for a restart in place: the
+// Terminal writes the arguments that reopen this conversation there and exits
+// with RESTART_CODE, and the launcher starts the installed release with them.
+const RESTART_CODE = 75, restartFile = /\/\.pi\/piagent-restart\/\d+\.json$/.test(process.env.PIAGENT_RESTART_FILE ?? '') ? process.env.PIAGENT_RESTART_FILE : null;
+let relaunch = null;
 // Joining Agent Watch takes a few seconds; keys typed before the Terminal draws are lost, so say so.
 if (!['--check', '--prompt', '--serve', '--doctor', '--web', '--rpc'].some((f) => flags.has(f)) && process.stderr.isTTY) process.stderr.write('Piagent công ty: đang kết nối Agent Watch, chờ ô nhập hiện ra rồi gõ…\n');
 // Do this before importing the SDK: it must not discover personal keys, Node
@@ -148,7 +153,8 @@ try {
   const { companyTerminalExtension, companyToolRenderers, companyInteractiveMode, harnessSummary } = await import('./company-terminal.mjs');
   const toolRenderers = await companyToolRenderers(config.sdk_root);
   const packageRoot = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
-  const terminal = companyTerminalExtension({ managed: () => current, packageRoot, sdkRoot: config.sdk_root,
+  const restart = { request: null };
+  const terminal = companyTerminalExtension({ managed: () => current, packageRoot, sdkRoot: config.sdk_root, restartInPlace: restartFile ? () => restart.request?.() : null,
     bindingChanged: () => { try { return digest(config.entrypoint) !== config.entrypoint_sha256; } catch { return true; } } });
   // Herdr shows the Terminal's state and reopens it after a restart; scripted runs have no pane to show.
   const reportToHerdr = herdr && !['--check', '--prompt', '--rpc'].some((f) => flags.has(f));
@@ -216,7 +222,15 @@ try {
       : write(typeof chunk === 'string' && chunk.includes('To resume this session:') ? `Mở lại cuộc trò chuyện này: piagent studio --project ${project}, rồi /resume\n` : chunk, ...rest);
     // /share, /bug, /login, /model, /thinking, /settings and /changelog: company-terminal.mjs.
     const CompanyMode = await companyInteractiveMode(api, { sdkRoot: config.sdk_root, packageRoot, summary: () => harnessSummary(current) });
-    await new CompanyMode(host, { verbose: false }).run();
+    const mode = new CompanyMode(host, { verbose: false });
+    const restarting = new Promise((resolve) => { restart.request = async () => {
+      if (relaunch) return;
+      const file = current?.session.sessionManager.getSessionFile?.(), saved = file && fs.existsSync(file) ? file : null;
+      const kept = []; for (let i = 0; i < args.length; i++) { if (args[i] === '--session') { i++; continue; } kept.push(args[i]); }
+      relaunch = [...kept, ...(saved ? ['--session', saved] : [])];
+      await mode.stopForRestart(); resolve();
+    }; });
+    await Promise.race([mode.run(), restarting]);
   }
   }
 } catch (error) {
@@ -229,3 +243,9 @@ try {
     : process.platform === 'linux' ? 'Trong Agent Watch cho Windows, chọn lại Kết nối Piagent trong WSL.' : 'Mở Agent Watch → Studio, nhập lại cấu hình cho Piagent, hoặc kiểm tra quyền Keychain.');
   process.stderr.write(`Agent Watch: ${code}. ${hint}\n`); process.exitCode = 1;
 } finally { await gateway?.close(); if (current) await current.dispose(); else await broker?.dispose(); hold?.release(); }
+if (relaunch && restartFile) {
+  fs.mkdirSync(path.dirname(restartFile), { recursive: true, mode: 0o700 });
+  fs.writeFileSync(restartFile, JSON.stringify({ args: relaunch }), { mode: 0o600 });
+  process.stderr.write('Piagent công ty: đang mở lại với bản mới, giữ nguyên cuộc trò chuyện…\n');
+  process.exit(RESTART_CODE);
+}

package/scripts/terminal-reload.mjs

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+// `piagent reload`: every open Piagent Terminal on this machine (`piagent`
+// and `piagent studio`) loads the installed release when it is idle; a task
+// running in one finishes first. The conversation stays open. piagent-update
+// asks the same once it installed a release.
+import fs from "node:fs";
+import { requestTerminalReload } from "../packages/piagent-core/runtime/update/terminal-reload.mjs";
+
+if (process.argv.slice(2).some((arg) => ["--help", "-h"].includes(arg))) {
+  console.log("Usage: piagent reload\n\nEvery open Piagent Terminal (piagent, piagent studio) loads the installed release when it is idle.\nA task running in one finishes first; the conversation stays open.");
+  process.exit(0);
+}
+const manifest = JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+requestTerminalReload({ version: manifest.version, piHost: manifest.peerDependencies?.["@earendil-works/pi-coding-agent"] ?? null });
+console.log(`Piagent ${manifest.version}: các Terminal đang mở (piagent, piagent studio) sẽ nạp bản này khi rảnh; Terminal đang chạy task thì nạp khi task xong. Cuộc trò chuyện giữ nguyên.`);

package/scripts/update-global.mjs

@@ -552,6 +552,16 @@ function main() {
     : `\nPASS: updated to v${targetHelper}.`);
   // A dashboard started before the update still serves the earlier release.
   if (!options.dryRun && helperNeedsChange) console.log("Open the dashboard with `piagent dashboard`: one still running an earlier release is restarted on the new one.");
+  // Open Terminals move to the new release when they are idle (a run in
+  // progress finishes first): the same request as `piagent reload`.
+  if (!options.dryRun && (helperNeedsChange || packageNeedsChange)) {
+    import("../packages/piagent-core/runtime/update/terminal-reload.mjs")
+      .then(({ requestTerminalReload }) => {
+        requestTerminalReload({ version: targetHelper, piHost: targetHost });
+        console.log("Open Terminals (piagent, piagent studio) load the new release when idle; a running task finishes first.");
+      })
+      .catch(() => console.log("Open Terminals keep the earlier release until reopened (`piagent reload` asks them again)."));
+  }
 }
 
 main();