@piagent/platform 1.48.1 → 1.48.2

package/docs-site/whats-new.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.1" title="v1.48.1 docs · VI"><span class="dot"></span>v1.48.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.2" title="v1.48.2 docs · VI"><span class="dot"></span>v1.48.2</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new" aria-current="page">Changelog</a>
@@ -108,7 +108,20 @@
 <div class="release-filter" role="toolbar" aria-label="Lọc theo loại thay đổi"><button type="button" data-filter-kind="all" aria-pressed="true">Tất cả</button><button type="button" data-filter-kind="new" aria-pressed="false">Mới</button><button type="button" data-filter-kind="improved" aria-pressed="false">Cải thiện</button><button type="button" data-filter-kind="fixed" aria-pressed="false">Sửa lỗi</button><button type="button" data-filter-kind="security" aria-pressed="false">Bảo mật</button></div>
 <section class="section releases" data-releases>
 <h2 id="latest" class="sr-only">Mới nhất</h2>
-<article class="release latest" id="v1-48-1" data-release>
+<article class="release latest" id="v1-48-2" data-release>
+  <div class="release-meta"><a class="release-version" href="#v1-48-2">v1.48.2</a><time class="release-date" datetime="2026-10-30">30/10/2026</time></div>
+  <div class="release-body">
+    <h3 data-toc-skip id="v1-48-2-title">Terminal nạp bản mới không cần đóng; chỉ member được bỏ qua kiểm tra</h3>
+    <p>Sau khi cập nhật, mọi Terminal đang mở tự nạp bản mới khi rảnh và giữ nguyên cuộc trò chuyện; kiểm tra bắt buộc của team chỉ được bỏ qua khi member xác nhận trên thẻ.</p>
+    <ul class="release-items">
+      <li data-kind="new"><span class="kind kind-new">Mới</span><span>piagent reload: mọi Terminal đang mở (piagent và piagent studio) nạp bản đã cài khi rảnh, giữ nguyên cuộc trò chuyện; piagent-update tự yêu cầu sau khi cài.</span></li>
+      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Chỉ member được bỏ qua kiểm tra mà team bắt buộc: agent hỏi trên thẻ duyệt, một lần, cho đúng code lúc đó; code đổi sau đó phải kiểm tra lại.</span></li>
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Terminal đang chạy task không bị cắt ngang: nạp bản mới khi task xong, footer ghi rõ đang chờ.</span></li>
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Lượt được member bỏ qua kiểm tra ghi rõ trong trạng thái, tách khỏi lượt không có kiểm tra nào chạy; push vẫn hỏi như mọi chế độ.</span></li>
+    </ul>
+  </div>
+</article>
+<article class="release" id="v1-48-1" data-release>
   <div class="release-meta"><a class="release-version" href="#v1-48-1">v1.48.1</a><time class="release-date" datetime="2026-10-30">30/10/2026</time></div>
   <div class="release-body">
     <h3 data-toc-skip id="v1-48-1-title">Dashboard trả lời nhanh hơn, Enter trong Terminal hiện tin nhắn ngay</h3>
@@ -407,24 +420,23 @@
     </ul>
   </div>
 </article>
-<article class="release" id="v1-43-0" data-release>
-  <div class="release-meta"><a class="release-version" href="#v1-43-0">v1.43.0</a><time class="release-date" datetime="2026-10-26">26/10/2026</time></div>
-  <div class="release-body">
-    <h3 data-toc-skip id="v1-43-0-title">Dev chọn workflow, harness hỗ trợ BE/FE theo project <span class="tag">không phát hành</span></h3>
-    <p>Đã tag nhưng chưa publish: gate wording tài liệu chặn phát hành. Thay bằng 1.43.4.</p>
-    <ul class="release-items">
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Tự nhận diện repo/package FE, BE trong thư mục hội thoại và gợi ý checks phù hợp, làm mới theo task.</span></li>
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Context workflow tùy chọn nhớ nguồn requirement, plan và tasks của công việc khi mở lại hội thoại, truyền chỉ đọc cho helper và hỗ trợ đổi hoặc xóa.</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Lifecycle là hướng dẫn theo workflow và điểm dừng Dev chọn, không ép file spec hoặc tự tạo gate release. Skill được chọn không cấp quyền hay bỏ qua kiểm chứng, review và duyệt deploy.</span></li>
-    </ul>
-  </div>
-</article>
 </section>
 <section class="section archive">
   <h2 id="archive">Các bản trước</h2>
   <p class="section-lead">Bản cũ hơn, gom theo tháng. Mở một tháng để xem từng thay đổi.</p>
   <details class="release-archive">
-    <summary><span>Tháng 10/2026</span><span class="archive-count">64</span></summary>
+    <summary><span>Tháng 10/2026</span><span class="archive-count">65</span></summary>
+    <div class="archive-row" id="v1-43-0">
+      <div class="archive-head"><a class="release-version" href="#v1-43-0">v1.43.0</a> <span class="release-date">26/10/2026</span></div>
+      <div class="archive-body">
+        <p><strong>Dev chọn workflow, harness hỗ trợ BE/FE theo project</strong> <span class="tag">không phát hành</span> — Đã tag nhưng chưa publish: gate wording tài liệu chặn phát hành. Thay bằng 1.43.4.</p>
+        <ul class="release-items">
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Tự nhận diện repo/package FE, BE trong thư mục hội thoại và gợi ý checks phù hợp, làm mới theo task.</span></li>
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Context workflow tùy chọn nhớ nguồn requirement, plan và tasks của công việc khi mở lại hội thoại, truyền chỉ đọc cho helper và hỗ trợ đổi hoặc xóa.</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Lifecycle là hướng dẫn theo workflow và điểm dừng Dev chọn, không ép file spec hoặc tự tạo gate release. Skill được chọn không cấp quyền hay bỏ qua kiểm chứng, review và duyệt deploy.</span></li>
+        </ul>
+      </div>
+    </div>
     <div class="archive-row" id="v1-42-1">
       <div class="archive-head"><a class="release-version" href="#v1-42-1">v1.42.1</a> <span class="release-date">25/10/2026</span></div>
       <div class="archive-body">

package/docs-site/windows.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.1" title="v1.48.1 docs · VI"><span class="dot"></span>v1.48.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.2" title="v1.48.2 docs · VI"><span class="dot"></span>v1.48.2</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new">Changelog</a>

package/docs-site/workflows.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.1" title="v1.48.1 docs · VI"><span class="dot"></span>v1.48.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.2" title="v1.48.2 docs · VI"><span class="dot"></span>v1.48.2</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new">Changelog</a>

package/evals/private-holdout-v1/public-exposure.v2.json

@@ -256,8 +256,8 @@
     },
     {
       "path": "tests",
-      "fileCount": 641,
-      "sha256": "b39f3983ab8feac820d9e23dffd2841a9b11a9b3b85fb997e36681b1aeadbff1"
+      "fileCount": 643,
+      "sha256": "da53dba99cba2d0d9f5adc6101fb1a49d058038cb5eca770de3bf8785de3290c"
     }
   ],
   "custodianComparisonRules": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piagent/platform",
-  "version": "1.48.1",
+  "version": "1.48.2",
   "license": "MIT",
   "publishConfig": {
     "access": "public",

package/packages/piagent-core/extensions/piagent-guard.ts

@@ -166,6 +166,7 @@ import { prefixCompletions, registerPiagentTool as registerToolDefinition, regis
 import { registerTaskEvidenceTools } from "../runtime/registration/task-evidence-tools.ts";
 import { registerAgentResources } from "../runtime/registration/agent-resources.ts";
 import { registerTerminalUpdateOffer } from "../runtime/update/terminal-update-offer.mjs";
+import { registerPersonalTerminalReload } from "../runtime/update/terminal-reload.mjs";
 import { registerStyleCommand } from "../runtime/terminal/terminal-style.mjs";
 import { userSkillFolders } from "../runtime/resources/agent-resources.mjs";
 import { FRESH_COMMAND_ACTIONS, FRESH_COMMAND_HELP, ONBOARDING_COMMAND_ACTIONS, WORKFLOW_COMMAND_EXCLUSIONS } from "../runtime/registration/operator-catalogs.ts";
@@ -4052,7 +4053,7 @@ export default function piagentGuard(pi: ExtensionAPI) {
     }
 
     const grants = sessionGrants.get(ctx.sessionManager.getSessionId()) ?? new Set<string>();
-    const grantable = Boolean(pendingHumanApproval) && !/handoff/.test(String(pendingHumanApproval!.action.requestedScope));
+    const grantable = Boolean(pendingHumanApproval) && !/handoff|waiver/.test(String(pendingHumanApproval!.action.requestedScope));
     const grant = grantKey(event.toolName, typeof pendingHumanApproval?.action.commandPreview === "string" ? pendingHumanApproval.action.commandPreview : null, preparedInput.input);
     if (pendingHumanApproval && grantable && grants.has(grant)) pendingHumanApproval = null;
     if (pendingHumanApproval) {
@@ -4192,6 +4193,8 @@ export default function piagentGuard(pi: ExtensionAPI) {
   registerAgentResources(pi);
   // A new release is asked about in the Terminal, as the dashboard does.
   registerTerminalUpdateOffer(pi, { installed: installedPlatformVersion(), packageRoot: PLATFORM_ROOT, restart: "pi" });
+  // `piagent reload` and a finished update reach this Terminal: it reloads when idle.
+  registerPersonalTerminalReload(pi, { installed: readJsonFile<{ version?: string }>(path.join(PLATFORM_ROOT, "package.json"))?.version });
   // The Terminal's look (/style): Pi keeps the pick in its own settings.
   registerStyleCommand(pi);
   registerSessionCommands(pi, { ...registrationDeps, ...contextCommandApi });

package/packages/piagent-core/managed/check-waiver.mjs

@@ -0,0 +1,35 @@
+// The member, never the agent, may waive the repository checks the Harness
+// asks for ("bỏ qua test, đẩy luôn"). Before, the member's words changed
+// nothing: under verify "require" the harness sent the agent back
+// max_fix_loops times anyway, while the delivery prompt already said checks
+// may be "explicitly human-waived". The agent now asks with waive_checks; the
+// member answers on an approval card, once, for the code as it is then. A
+// later change needs its checks again. The turn still reports that no check
+// passed, and says the member waived them.
+import { approve } from './command-tools.mjs';
+
+const PARAMETERS = { type: 'object', properties: {
+  member_words: { type: 'string', minLength: 1, maxLength: 300, description: 'What the member said, quoted: the request to skip the checks.' },
+  reason: { type: 'string', minLength: 1, maxLength: 300, description: 'Which checks are skipped and what is left unverified.' } },
+required: ['member_words', 'reason'], additionalProperties: false };
+
+const text = value => ({ content: [{ type: 'text', text: value }], details: {} });
+
+export function waiveChecksTool(self) {
+  return { name: 'waive_checks', label: 'Waive checks', parameters: PARAMETERS,
+    description: 'Ask the member to confirm that the repository checks are skipped for the code as it is now. Call it only when the member asked in this conversation to skip the tests or checks (quote them in member_words); never to end a turn sooner, never on your own judgment. The member answers on an approval card. Approved: the harness stops asking for checks on this exact code, and the turn reports that no check passed and that the member waived them. Change the code after it and the checks are required again. Pushing still asks the member as always.',
+    execute: async (id, args, signal, _onUpdate, ctx) => {
+      const run = self.run;
+      if (!run) throw Error('managed-checks-waiver-no-run: no member request is running.');
+      if (run.policy?.verify === 'off') return text('The Harness asks for no checks here: nothing to waive.');
+      const digest = await self.digest();
+      if (digest === null) throw Error('managed-checks-waiver-unreadable: the current code cannot be read, so a waiver could not be bound to it.');
+      await approve(self, id, signal, ctx, { toolName: 'waive_checks', rawAction: { digest }, commandPreview: `waive checks: ${args.member_words}`,
+        provider: 'harness', requestedScope: 'checks-waiver-once', reason: String(args.reason).slice(0, 300), riskClass: 'medium',
+        allowConsequence: 'The harness stops asking for checks on this exact code; the turn reports that no check passed and that you waived them.',
+        denyConsequence: 'The checks stay required; the agent runs them before it finishes.' },
+      { title: 'Bỏ qua kiểm tra?', body: `Bạn đã nói: "${args.member_words}"\n\nBỏ qua: ${args.reason}\n\nĐồng ý: Harness không yêu cầu chạy kiểm tra cho đúng code hiện tại; lượt này ghi là chưa có kiểm tra nào qua và bạn đã miễn. Sửa code sau đó thì phải kiểm tra lại. Push vẫn hỏi bạn như thường.\nTừ chối: vẫn phải chạy kiểm tra trước khi xong.` });
+      run.waivedDigest = digest;
+      return text('The member waived the checks for the code as it is now. Do not run them again unless the member asks; say in your answer that the change is unverified.');
+    } };
+}

package/packages/piagent-core/managed/command-tools.mjs

@@ -75,11 +75,11 @@ export function stillAsks(self, reason) {
 
 // One approval of the member (the dashboard card, else the Terminal). The
 // member may allow it once, allow the same exact action for the rest of the
-// conversation (never a handoff: its scope names it), deny it, or deny it and
+// conversation (never a handoff or a waiver of checks: its scope names it), deny it, or deny it and
 // stop the turn so the agent does not try again.
 const CHOICES = { once: 'Đồng ý một lần', session: 'Đồng ý cho cả cuộc trò chuyện (đúng lệnh này)', deny: 'Từ chối', stop: 'Từ chối và dừng lượt này' };
 export async function approve(self, id, signal, ctx, action, { title, body }) {
-  const grantable = !/handoff/.test(String(action.requestedScope ?? '')), key = `${action.toolName}\u0000${action.commandPreview ?? JSON.stringify(action.rawAction ?? {})}`;
+  const grantable = !/handoff|waiver/.test(String(action.requestedScope ?? '')), key = `${action.toolName}\u0000${action.commandPreview ?? JSON.stringify(action.rawAction ?? {})}`;
   if (grantable && self.sessionApprovals?.has(key)) return;
   const { piApprovalBroker } = await import('../runtime/inspection/approval-broker.ts');
   const choices = ['once', ...(grantable ? ['session'] : []), 'deny', 'stop'];

package/packages/piagent-core/managed/session.mjs

@@ -29,7 +29,7 @@ import { HELPER_CALLS, HELPER_ROLES, helperRoles, helperPrompt, webPrompt, deleg
 import { loadAgentResources } from './agent-skills.mjs';
 import { loadPiagentThemes } from '../runtime/terminal/terminal-style.mjs';
 import { restorePermission, recordBypass, permissionSetter } from './permission.mjs';
-import { commandTools, servicesPrompt } from './command-tools.mjs'; import { attachMemory, memoryToolsFor, openRound, closeRound, prepareMemoryContext, trackMemoryLessons } from './memory.mjs';
+import { commandTools, servicesPrompt } from './command-tools.mjs'; import { waiveChecksTool } from './check-waiver.mjs'; import { attachMemory, memoryToolsFor, openRound, closeRound, prepareMemoryContext, trackMemoryLessons } from './memory.mjs';
 
 const PROVIDER = 'agent_watch_managed';
 export const HELPER_BEAT_MS = 60_000;
@@ -129,7 +129,7 @@ export class ManagedSession {
     if (roles.length) customTools.push({ name: 'delegate', label: 'Subagent', description: delegateDescription(roles) + SPEC_PROMPT,
       parameters: delegateParameters(), // the brief and its structured fields (helper-settlement.mjs)
       execute: (_id, args, signal) => self.delegate(delegateArgs(self, args), signal) });
-    customTools.push(sessionPlanTool(self), ...(roles.length ? [resolveTool(self)] : [])); // the objection ledger's decisions (ledger.mjs)
+    customTools.push(sessionPlanTool(self), waiveChecksTool(self), ...(roles.length ? [resolveTool(self)] : [])); // the member's waiver of checks (check-waiver.mjs), the objection ledger's decisions (ledger.mjs)
     // The member decides what the request leaves open: numbered options, or their own words.
     customTools.push(workflowContextTool(() => self.session.sessionManager));
     customTools.push(askTool(self), ...memoryToolsFor(self, agentDir)); // team memory's tools, once Studio answered memory here (memory.mjs)

package/packages/piagent-core/managed/workflow.mjs

@@ -148,7 +148,7 @@ export function workflowPrompt(policy, checks) {
   if (policy.plan !== 'off') lines.push(`- Plan: for work with several steps keep a checklist with update_plan and update it as you go. When the member asks for several items (plans, files, tickets), put every item in the checklist and work through all of them; do not end your turn to report between items.${policy.plan === 'require' ? ' For a complex task, file edits are refused until a plan exists. A checklist left with pending steps sends you back to the next one until every step is completed or deferred: if you cannot go on without the member, ask with ask_user. Mark a step deferred only when the member asked to leave it for later or it is no longer needed; never mark completed a step you did not do.' : ''}`);
   if (policy.verify !== 'off') {
     const list = checks.commands.length ? `${checks.commands.map(c => '`' + c + '`').join(', ')}${checks.source === 'detected' ? ' (detected; the repository declares none in AGENTS.md "## Checks")' : ''}` : 'none declared: choose the tests, type check or build that cover the change';
-    lines.push(`- Verify: after changing code, run the repository checks that cover the change and fix failures before you finish. Repository checks: ${list}.${policy.verify === 'require' ? ' The turn does not end until a check has passed on the final code.' : ''}`);
+    lines.push(`- Verify: after changing code, run the repository checks that cover the change and fix failures before you finish. Repository checks: ${list}.${policy.verify === 'require' ? ' The turn does not end until a check has passed on the final code.' : ''} Only the member may skip the checks: when they ask to, call waive_checks with their words; never skip them on your own.`);
   }
   // What each severity asks: blocking is fixed or argued, major decided, minor only listed.
   const severities = ' Blocking findings: fix them, or reject one with resolve_objection and the reviewer judges your reason; a disagreement that remains goes to the member. Major findings: fix them or reject them with resolve_objection; no new review follows. Minor findings are listed for the member and need nothing.';
@@ -350,7 +350,7 @@ export async function completionGate(managed, run, signal) {
       // The member declined the approval a check needed (a JDK, Docker, the
       // network): asking again would only repeat the same answer.
       if (policy.verify === 'require' && !run.verified && run.approvalDeclined && run.fixLoops > 0) verifyGaveUp = true;
-      if (policy.verify === 'require' && !run.verified && !run.docsOnly && !verifyGaveUp) {
+      if (policy.verify === 'require' && !run.verified && !run.docsOnly && !verifyGaveUp && run.waivedDigest !== digest) {
         run.fixLoops += 1;
         const list = run.checks.commands.length ? run.checks.commands.map(c => '`' + c + '`').join(', ') : 'the tests, type check or build that cover the change';
         await send(`Harness process check: code changed in this turn, but no check has passed on the current code. Run the checks that cover your change (${list}) and fix what fails. If a check cannot run because the machine lacks something (a runtime such as a JDK, Docker, a database or another service, the network), request the approval that makes it run (run_with_network, run_with_docker, start_docker, run_on_host) or ask the member with ask_user, then run it; install or start nothing without that approval. If it fails for a reason unrelated to your change, say so plainly.`,
@@ -441,8 +441,8 @@ export async function completionGate(managed, run, signal) {
   if (!run.changed && !run.disputes.length && !ledgerOf(run).length) return;
   const finalPlan = currentPlan(session.sessionManager), planOpen = run.planUpdated ? finalPlan?.plan?.filter(p => p.status === 'pending' || p.status === 'in_progress').length ?? 0 : 0;
   const status = { verified: run.verified, reviewed: run.reviewed, blockingOpen: run.blockingOpen, checks: run.checksRun, fixLoops: run.fixLoops,
-    ...(planOpen ? { planOpen } : {}), ...(run.planSkipped ? { planSkipped: true } : {}), ...(run.disputes.length ? { disputes: run.disputes.length } : {}), ...(run.changed ? {} : { unchanged: true }) };
-  const words = [...(run.changed ? [run.verified ? 'a check passed on the final code' : policy.verify === 'off' ? null : run.docsOnly ? 'only documentation changed: no check needed' : 'no check passed on the final code',
+    ...(planOpen ? { planOpen } : {}), ...(run.planSkipped ? { planSkipped: true } : {}), ...(!run.verified && run.waivedDigest === digest ? { checksWaived: true } : {}), ...(run.disputes.length ? { disputes: run.disputes.length } : {}), ...(run.changed ? {} : { unchanged: true }) };
+  const words = [...(run.changed ? [run.verified ? 'a check passed on the final code' : policy.verify === 'off' ? null : run.docsOnly ? 'only documentation changed: no check needed' : run.waivedDigest === digest ? 'no check passed on the final code: the member waived the checks' : 'no check passed on the final code',
     run.reviewed ? (run.blockingOpen ? `review: ${run.blockingOpen} blocking issue(s) still open` : 'review: no blocking issue') : policy.review === 'off' ? null : run.reviewUnavailable ? `review could not run (${run.reviewUnavailableReason})` : 'not reviewed',
     run.planSkipped ? 'code was changed before the required plan existed' : null, planOpen ? `plan: ${planOpen} step(s) not completed` : null] : []),
     run.disputes.length ? `${run.disputes.length} disagreement(s) between the main agent and a subagent go to the member` : null, ledgerWords(run)].filter(Boolean);

package/packages/piagent-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piagent/core",
-  "version": "1.48.1",
+  "version": "1.48.2",
   "type": "module",
   "private": true,
   "license": "MIT",

package/packages/piagent-core/runtime/update/terminal-reload.mjs

@@ -0,0 +1,122 @@
+// Every open Terminal moves to a new Piagent release without being closed.
+//
+// `piagent reload` (and `piagent-update` once it installed a release) writes
+// one request file. Each Terminal started before that request takes it when it
+// is idle: no run going, nothing queued, nothing typed in the editor. A run in
+// progress is never cut: the footer says the reload waits, and it happens when
+// the run settles. How a Terminal reloads is its own: the personal Terminal
+// runs Pi's /reload (Piagent's extensions are read again from disk), the
+// company Terminal starts again in place on the same conversation, since its
+// company code is loaded once per process.
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+const REQUEST_FILE = "piagent-reload.json";
+const POLL_MS = 2_000;
+const STATUS_KEY = "piagent-reload";
+
+const requestPath = (home) => path.join(home ?? os.homedir(), ".pi", REQUEST_FILE);
+
+export function requestTerminalReload({ home, version = null, piHost = null, now = Date.now() } = {}) {
+  const file = requestPath(home);
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  const temporary = `${file}.${process.pid}.tmp`;
+  fs.writeFileSync(temporary, `${JSON.stringify({ version, piHost, at: now })}\n`, { mode: 0o600 });
+  fs.renameSync(temporary, file);
+  return { version, piHost, at: now };
+}
+
+export function readReloadRequest(home) {
+  try {
+    const value = JSON.parse(fs.readFileSync(requestPath(home), "utf8"));
+    if (!Number.isFinite(value?.at)) return null;
+    return { at: value.at, version: typeof value.version === "string" ? value.version : null, piHost: typeof value.piHost === "string" ? value.piHost : null };
+  } catch { return null; }
+}
+
+// Whether this Terminal may reload now without losing anything the member did.
+function idle(ctx) {
+  try {
+    if (typeof ctx?.isIdle === "function" && !ctx.isIdle()) return false;
+    if (typeof ctx?.hasPendingMessages === "function" && ctx.hasPendingMessages()) return false;
+    const typed = typeof ctx?.ui?.getEditorText === "function" ? ctx.ui.getEditorText() : "";
+    return !String(typed ?? "").trim();
+  } catch { return false; }
+}
+
+// `apply(ctx, request)` reloads this Terminal; it runs at most once per
+// process. Only Terminals with a UI take requests: scripted runs keep theirs.
+export function watchTerminalReload(pi, { apply, home, startedAt = Date.now(), pollMs = POLL_MS }) {
+  let ctx = null, applied = false, waiting = false, timer = null;
+  // A ctx kept from an earlier session (replaced, reloaded) throws on any use:
+  // a check that meets one does nothing, and the next session_start brings a new one.
+  const check = async () => {
+    let request;
+    try {
+      if (applied || !ctx?.hasUI) return;
+      request = readReloadRequest(home);
+      if (!request || request.at <= startedAt) return;
+      if (!idle(ctx)) {
+        if (!waiting) { waiting = true; ctx.ui?.setStatus?.(STATUS_KEY, `⟳ Nạp Piagent${request.version ? ` ${request.version}` : " mới"} khi xong lượt này`); }
+        return;
+      }
+      applied = true;
+      ctx.ui?.setStatus?.(STATUS_KEY, undefined);
+    } catch { return; }
+    try { await apply(ctx, request); }
+    catch (error) {
+      applied = false;
+      try { ctx.ui?.notify?.(`Chưa nạp được Piagent mới: ${error instanceof Error ? error.message : String(error)}`, "warning"); } catch { /* the session is gone */ }
+    }
+  };
+  const keep = (_event, next) => { ctx = next; };
+  pi.on("session_start", (event, next) => {
+    keep(event, next);
+    if (!timer) { timer = setInterval(() => { void check(); }, pollMs); timer.unref?.(); }
+  });
+  pi.on("agent_start", keep);
+  // The moment a run settles is the moment a waiting reload can happen.
+  pi.on("agent_settled", (event, next) => { keep(event, next); setTimeout(() => { void check(); }, 300).unref?.(); });
+  pi.on("session_shutdown", () => { if (timer) clearInterval(timer); timer = null; ctx = null; });
+  return { check };
+}
+
+// The personal Terminal: Pi's /reload reads Piagent's extensions again from
+// disk and keeps the conversation. A request naming another Pi host than the
+// one running cannot be met that way: the member is told to open it again.
+const RELOADED_FROM = "PIAGENT_RELOADED_FROM";
+// The Pi this process runs: the package of the CLI that started it.
+function runningPiVersion() {
+  try {
+    for (let dir = path.dirname(fs.realpathSync(process.argv[1])), depth = 0; depth < 6; depth += 1, dir = path.dirname(dir)) {
+      try { const manifest = JSON.parse(fs.readFileSync(path.join(dir, "package.json"), "utf8")); if (manifest.name === "@earendil-works/pi-coding-agent") return manifest.version; } catch { /* keep walking up */ }
+    }
+  } catch { /* unknown */ }
+  return null;
+}
+export function registerPersonalTerminalReload(pi, { installed, home = undefined }) {
+  pi.registerCommand("piagent-reload", { description: "Nạp lại Piagent (bản vừa cập nhật) mà không đóng Terminal",
+    handler: async (_args, ctx) => {
+      await ctx.waitForIdle();
+      process.env[RELOADED_FROM] = installed ?? "?";
+      await ctx.reload();
+    } });
+  pi.on("session_start", (_event, ctx) => {
+    const from = process.env[RELOADED_FROM];
+    if (from === undefined) return;
+    delete process.env[RELOADED_FROM];
+    // Said once the reloaded Terminal has drawn itself: a notice during the reload is lost.
+    const text = from === installed ? `Đã nạp lại Piagent ${installed}.` : `Đã nạp Piagent ${installed} (trước đó ${from}).`;
+    setTimeout(() => { try { ctx.ui?.notify?.(text, "info"); } catch { /* the Terminal closed meanwhile */ } }, 300).unref?.();
+  });
+  watchTerminalReload(pi, { home, apply: async (ctx, request) => {
+    if (ctx.mode !== "tui") return;
+    const VERSION = runningPiVersion();
+    if (request.piHost && VERSION && request.piHost !== VERSION) {
+      ctx.ui.notify(`Piagent ${request.version ?? "mới"} chạy trên Pi ${request.piHost}, Terminal này đang dùng Pi ${VERSION}: thoát rồi mở lại \`piagent\` để dùng bản mới.`, "warning");
+      return;
+    }
+    await pi.sendUserMessage("/piagent-reload", { expandPromptTemplates: true });
+  } });
+}

package/packages/piagent-core/runtime/update/terminal-update-offer.mjs

@@ -88,7 +88,7 @@ export function registerTerminalUpdateOffer(pi, { installed, packageRoot, restar
     if (!result.ok) { ctx.ui.notify(`Chưa cập nhật được Piagent. Chi tiết trong ${result.log}. Có thể chạy \`piagent-update\` trong terminal.`, "error"); return; }
     updated = version; status(undefined);
     const extra = afterUpdate();
-    ctx.ui.notify(`Đã cập nhật Piagent ${installed} → ${version}. Thoát rồi mở lại \`${restart}\` để dùng bản mới.${extra ? ` ${extra}` : ""}`, "info");
+    ctx.ui.notify(`Đã cập nhật Piagent ${installed} → ${version}. Terminal này tự nạp bản mới khi rảnh và giữ nguyên cuộc trò chuyện (hoặc thoát rồi mở lại \`${restart}\`).${extra ? ` ${extra}` : ""}`, "info");
   };
   const offer = async (ctx, { force = false } = {}) => {
     if (asking || updated || !ctx?.hasUI || ctx.ui?.[GATEWAY_UI] || !ctx.ui?.select) return;