@piagent/platform 1.44.4 → 1.46.0

package/docs-site/releases.json

@@ -1,4 +1,79 @@
 [
+  {
+    "version": "1.46.0",
+    "date": "2026-10-28",
+    "status": "stable",
+    "title": {
+      "en": "Piagent runs from its own Pi home and your own pi stays stock",
+      "vi": "Piagent chạy trong Pi home riêng, pi của bạn giữ nguyên bản gốc"
+    },
+    "summary": {
+      "en": "Piagent installs into ~/.piagent/agent and opens with `piagent`. Plain `pi` no longer loads Piagent, its add-ons, model list or footer panel.",
+      "vi": "Piagent cài vào ~/.piagent/agent và mở bằng `piagent`. `pi` thường không còn nạp Piagent, add-on, danh sách model hay panel footer."
+    },
+    "items": [
+      {
+        "kind": "breaking",
+        "en": "Piagent installs into its own Pi home, ~/.piagent/agent, and opens with `piagent`. Plain `pi` in ~/.pi/agent stays stock.",
+        "vi": "Piagent cài vào Pi home riêng ~/.piagent/agent và mở bằng `piagent`. `pi` thường trong ~/.pi/agent giữ nguyên bản gốc."
+      },
+      {
+        "kind": "new",
+        "en": "A first install in a terminal asks which add-ons to install and whether to reuse your pi login; flags answer up front.",
+        "vi": "Lần cài đầu trong terminal hỏi cài add-on nào và có dùng lại login của pi không; cờ dòng lệnh trả lời trước được."
+      },
+      {
+        "kind": "new",
+        "en": "`piagent restore-pi --apply` moves an older install out of ~/.pi/agent with backups; the installer does it on update.",
+        "vi": "`piagent restore-pi --apply` dời bản cài cũ khỏi ~/.pi/agent, có sao lưu; installer tự làm khi cập nhật."
+      },
+      {
+        "kind": "fixed",
+        "en": "Pi's built-in mcp is turned off in Piagent's home when pi-mcp-adapter is installed, so /mcp no longer clashes.",
+        "vi": "Khi cài pi-mcp-adapter, Piagent tắt mcp có sẵn của Pi trong home của mình nên /mcp không còn xung đột."
+      }
+    ],
+    "requires": {
+      "en": "Agent Watch 0.15.16 to list Piagent's personal sessions",
+      "vi": "Agent Watch 0.15.16 để thấy session cá nhân của Piagent"
+    }
+  },
+  {
+    "version": "1.45.0",
+    "date": "2026-10-28",
+    "status": "stable",
+    "title": {
+      "en": "Files and images in a prompt follow the read policy, and the terminal stays responsive",
+      "vi": "File và ảnh trong prompt theo đúng quyền đọc, terminal không còn đứng hình"
+    },
+    "summary": {
+      "en": "pi @file can no longer send a protected file to the model, images attach the way you add them, and a prompt in a folder of repositories no longer freezes the terminal.",
+      "vi": "pi @file không còn gửi file được bảo vệ cho model, ảnh được đính kèm theo mọi cách thêm vào, và prompt trong thư mục nhiều repo không còn làm terminal đứng hình."
+    },
+    "items": [
+      {
+        "kind": "security",
+        "en": "pi @file arguments follow the read policy: a protected file (.env) or one outside the project reaches the model as a withheld note, and its image is dropped.",
+        "vi": "Tham số pi @file theo quyền đọc: file được bảo vệ (.env) hoặc ngoài project chỉ tới model dưới dạng ghi chú bị giữ lại, ảnh của nó bị bỏ."
+      },
+      {
+        "kind": "new",
+        "en": "Images attach when named with @path or @\"path\", pasted with Ctrl+V, or dropped on the terminal; a skipped image says why and how to grant its folder.",
+        "vi": "Ảnh được đính kèm khi gọi bằng @path hoặc @\"path\", dán bằng Ctrl+V hay kéo thả vào terminal; ảnh bị bỏ qua nói rõ lý do và cách cấp quyền thư mục."
+      },
+      {
+        "kind": "fixed",
+        "en": "An image passed as pi @image.png is attached once, not twice.",
+        "vi": "Ảnh truyền bằng pi @image.png chỉ được đính kèm một lần, không còn hai lần."
+      },
+      {
+        "kind": "improved",
+        "en": "In a folder of repositories a prompt no longer freezes the terminal for seconds: the change check asks Git and the inspector scans in the background.",
+        "vi": "Trong thư mục nhiều repo, prompt không còn làm terminal đứng hình vài giây: kiểm tra thay đổi hỏi Git, inspector quét ở nền."
+      }
+    ],
+    "requires": null
+  },
   {
     "version": "1.44.4",
     "date": "2026-10-28",

package/docs-site/runtime.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.44.4" title="v1.44.4 docs · VI"><span class="dot"></span>v1.44.4</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.0" title="v1.46.0 docs · VI"><span class="dot"></span>v1.46.0</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/scope.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.44.4" title="v1.44.4 docs · VI"><span class="dot"></span>v1.44.4</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.0" title="v1.46.0 docs · VI"><span class="dot"></span>v1.46.0</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/security.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.44.4" title="v1.44.4 docs · VI"><span class="dot"></span>v1.44.4</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.0" title="v1.46.0 docs · VI"><span class="dot"></span>v1.46.0</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/team.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.44.4" title="v1.44.4 docs · VI"><span class="dot"></span>v1.44.4</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.0" title="v1.46.0 docs · VI"><span class="dot"></span>v1.46.0</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/update.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.44.4" title="v1.44.4 docs · VI"><span class="dot"></span>v1.44.4</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.0" title="v1.46.0 docs · VI"><span class="dot"></span>v1.46.0</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>
@@ -145,9 +145,9 @@
   <h2 id="pin-cho-team">Pin một bản cho cả team</h2>
   <p>Khi rollout cho team, cài đúng bản Pi host và đúng bản platform, rồi chạy installer ở chế độ stable. Bước <code>--dry-run</code> in ra những gì sẽ đổi.</p>
   <div class="command-card">
-    <header><span>Cài pin theo bản</span><button class="clip-btn" data-clip="npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0&#10;npm install -g --ignore-scripts @piagent/platform@1.44.4&#10;piagent-install --stable --dry-run&#10;piagent-install --stable">Lấy lệnh</button></header>
+    <header><span>Cài pin theo bản</span><button class="clip-btn" data-clip="npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0&#10;npm install -g --ignore-scripts @piagent/platform@1.46.0&#10;piagent-install --stable --dry-run&#10;piagent-install --stable">Lấy lệnh</button></header>
     <pre><code>npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0
-npm install -g --ignore-scripts @piagent/platform@1.44.4
+npm install -g --ignore-scripts @piagent/platform@1.46.0
 piagent-install --stable --dry-run
 piagent-install --stable</code></pre>
   </div>

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.44.4" title="v1.44.4 docs · VI"><span class="dot"></span>v1.44.4</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.0" title="v1.46.0 docs · VI"><span class="dot"></span>v1.46.0</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,34 @@
 <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-44-4" data-release>
+<article class="release latest" id="v1-46-0" data-release>
+  <div class="release-meta"><a class="release-version" href="#v1-46-0">v1.46.0</a><time class="release-date" datetime="2026-10-28">28/10/2026</time></div>
+  <div class="release-body">
+    <h3 data-toc-skip id="v1-46-0-title">Piagent chạy trong Pi home riêng, pi của bạn giữ nguyên bản gốc</h3>
+    <p>Piagent cài vào ~/.piagent/agent và mở bằng <code>piagent</code>. <code>pi</code> thường không còn nạp Piagent, add-on, danh sách model hay panel footer.</p>
+    <ul class="release-items">
+      <li data-kind="breaking"><span class="kind kind-breaking">Thay đổi lớn</span><span>Piagent cài vào Pi home riêng ~/.piagent/agent và mở bằng <code>piagent</code>. <code>pi</code> thường trong ~/.pi/agent giữ nguyên bản gốc.</span></li>
+      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Lần cài đầu trong terminal hỏi cài add-on nào và có dùng lại login của pi không; cờ dòng lệnh trả lời trước được.</span></li>
+      <li data-kind="new"><span class="kind kind-new">Mới</span><span><code>piagent restore-pi --apply</code> dời bản cài cũ khỏi ~/.pi/agent, có sao lưu; installer tự làm khi cập nhật.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Khi cài pi-mcp-adapter, Piagent tắt mcp có sẵn của Pi trong home của mình nên /mcp không còn xung đột.</span></li>
+    </ul>
+    <p class="release-requires"><strong>Cần:</strong> Agent Watch 0.15.16 để thấy session cá nhân của Piagent</p>
+  </div>
+</article>
+<article class="release" id="v1-45-0" data-release>
+  <div class="release-meta"><a class="release-version" href="#v1-45-0">v1.45.0</a><time class="release-date" datetime="2026-10-28">28/10/2026</time></div>
+  <div class="release-body">
+    <h3 data-toc-skip id="v1-45-0-title">File và ảnh trong prompt theo đúng quyền đọc, terminal không còn đứng hình</h3>
+    <p>pi @file không còn gửi file được bảo vệ cho model, ảnh được đính kèm theo mọi cách thêm vào, và prompt trong thư mục nhiều repo không còn làm terminal đứng hình.</p>
+    <ul class="release-items">
+      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Ảnh được đính kèm khi gọi bằng @path hoặc @&quot;path&quot;, dán bằng Ctrl+V hay kéo thả vào terminal; ảnh bị bỏ qua nói rõ lý do và cách cấp quyền thư mục.</span></li>
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Trong thư mục nhiều repo, prompt không còn làm terminal đứng hình vài giây: kiểm tra thay đổi hỏi Git, inspector quét ở nền.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Ảnh truyền bằng pi @image.png chỉ được đính kèm một lần, không còn hai lần.</span></li>
+      <li data-kind="security"><span class="kind kind-security">Bảo mật</span><span>Tham số pi @file theo quyền đọc: file được bảo vệ (.env) hoặc ngoài project chỉ tới model dưới dạng ghi chú bị giữ lại, ảnh của nó bị bỏ.</span></li>
+    </ul>
+  </div>
+</article>
+<article class="release" id="v1-44-4" data-release>
   <div class="release-meta"><a class="release-version" href="#v1-44-4">v1.44.4</a><time class="release-date" datetime="2026-10-28">28/10/2026</time></div>
   <div class="release-body">
     <h3 data-toc-skip id="v1-44-4-title">Conversation công ty trở lại trong pane Herdr</h3>
@@ -394,44 +421,40 @@
     </ul>
   </div>
 </article>
-<article class="release" id="v1-38-0" data-release>
-  <div class="release-meta"><a class="release-version" href="#v1-38-0">v1.38.0</a><time class="release-date" datetime="2026-10-23">23/10/2026</time></div>
-  <div class="release-body">
-    <h3 data-toc-skip id="v1-38-0-title">Piagent thành editor, Bypass không hỏi gì <span class="tag">không phát hành</span></h3>
-    <p>Dashboard có file, terminal, review inline và checkpoint, cùng chế độ Bypass không hỏi gì, cả trong cuộc trò chuyện công ty khi Harness cho phép.</p>
-    <ul class="release-items">
-      <li data-kind="breaking"><span class="kind kind-breaking">Thay đổi lớn</span><span>Cuộc trò chuyện công ty có Hỏi trước, Toàn quyền (trước đây gọi là Bypass) và Bypass, chỉ có khi Harness cho phép.</span></li>
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Chế độ <code>bypass</code> (<code>/permission bypass</code>, <code>piagent-auto --bypass</code>) tắt mọi bước chặn; output vẫn được che secret và <code>/undo</code> vẫn hoàn tác được.</span></li>
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Dashboard mở, sửa, lưu, đổi tên và xóa file của project, có Cmd/Ctrl+P, tìm kiếm và báo xung đột khi file đã đổi trên đĩa.</span></li>
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Terminal của project ngay trên dashboard; terminal của cuộc trò chuyện công ty chạy trong sandbox, cả trên macOS, không bao giờ chạy trên host.</span></li>
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Review inline từng hunk agent sửa với Giữ và Hoàn tác, và khôi phục trong Timeline có xem trước, dùng chung checkpoint với <code>/undo</code>.</span></li>
-      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Checkpoint không tạo được từng chặn mọi lần sửa; giờ thì không, và snapshot mất khoảng 0,5 s thay vì 35 s trên repo 4.000 file.</span></li>
-    </ul>
-    <p class="release-requires"><strong>Cần:</strong> Agent Studio 0.38.0 và Agent Watch 0.15.14 (Windows 0.1.17) cho mức Bypass ở chế độ công ty</p>
-  </div>
-</article>
-<article class="release" id="v1-37-1" data-release>
-  <div class="release-meta"><a class="release-version" href="#v1-37-1">v1.37.1</a><time class="release-date" datetime="2026-10-22">22/10/2026</time></div>
-  <div class="release-body">
-    <h3 data-toc-skip id="v1-37-1-title">Đóng run và báo cáo helper mà Studio tin được</h3>
-    <p>Lần đóng run hỏi lại chỉ được tính khi tới Studio, helper giữ câu trả lời, và yêu cầu ra ngoài chặn mọi dạng IPv6 của địa chỉ nội bộ.</p>
-    <ul class="release-items">
-      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Lần đóng run hỏi lại sau lỗi thoáng qua có thể được ghi nhận dù không tới Studio; giờ chỉ được tính khi Studio nhận được.</span></li>
-      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Helper đóng lỗi trong chốc lát từng bị coi là thất bại; giờ nó giữ câu trả lời, và báo cáo được gửi lại sau lỗi thoáng qua.</span></li>
-      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Team memory từng gộp lỗi của hai lệnh khác nhau cùng một chương trình thành một bài học; giờ khóa là cả câu lệnh.</span></li>
-      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Phản hồi skill từng trộn các skill có tên giống nhau như <code>a/b</code> và <code>a_b</code>; giờ mỗi tên skill có file riêng.</span></li>
-      <li data-kind="security"><span class="kind kind-security">Bảo mật</span><span>Tool <code>web_fetch</code> và package proxy từng cho qua một số dạng IPv6 của địa chỉ nội bộ; giờ mọi dạng như vậy đều bị chặn.</span></li>
-      <li data-kind="security"><span class="kind kind-security">Bảo mật</span><span>Khi có upstream proxy của công ty (<code>HTTPS_PROXY</code>), package proxy giờ tự kiểm tra từng đích kết nối thay vì để upstream tự xử lý.</span></li>
-    </ul>
-    <p class="release-requires"><strong>Cần:</strong> Agent Watch 0.15.11 (Windows 0.1.16)</p>
-  </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">55</span></summary>
+    <summary><span>Tháng 10/2026</span><span class="archive-count">57</span></summary>
+    <div class="archive-row" id="v1-38-0">
+      <div class="archive-head"><a class="release-version" href="#v1-38-0">v1.38.0</a> <span class="release-date">23/10/2026</span></div>
+      <div class="archive-body">
+        <p><strong>Piagent thành editor, Bypass không hỏi gì</strong> <span class="tag">không phát hành</span> — Dashboard có file, terminal, review inline và checkpoint, cùng chế độ Bypass không hỏi gì, cả trong cuộc trò chuyện công ty khi Harness cho phép.</p>
+        <ul class="release-items">
+        <li data-kind="breaking"><span class="kind kind-breaking">Thay đổi lớn</span><span>Cuộc trò chuyện công ty có Hỏi trước, Toàn quyền (trước đây gọi là Bypass) và Bypass, chỉ có khi Harness cho phép.</span></li>
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Chế độ <code>bypass</code> (<code>/permission bypass</code>, <code>piagent-auto --bypass</code>) tắt mọi bước chặn; output vẫn được che secret và <code>/undo</code> vẫn hoàn tác được.</span></li>
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Dashboard mở, sửa, lưu, đổi tên và xóa file của project, có Cmd/Ctrl+P, tìm kiếm và báo xung đột khi file đã đổi trên đĩa.</span></li>
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Terminal của project ngay trên dashboard; terminal của cuộc trò chuyện công ty chạy trong sandbox, cả trên macOS, không bao giờ chạy trên host.</span></li>
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Review inline từng hunk agent sửa với Giữ và Hoàn tác, và khôi phục trong Timeline có xem trước, dùng chung checkpoint với <code>/undo</code>.</span></li>
+        <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Checkpoint không tạo được từng chặn mọi lần sửa; giờ thì không, và snapshot mất khoảng 0,5 s thay vì 35 s trên repo 4.000 file.</span></li>
+        </ul>
+      </div>
+    </div>
+    <div class="archive-row" id="v1-37-1">
+      <div class="archive-head"><a class="release-version" href="#v1-37-1">v1.37.1</a> <span class="release-date">22/10/2026</span></div>
+      <div class="archive-body">
+        <p><strong>Đóng run và báo cáo helper mà Studio tin được</strong> — Lần đóng run hỏi lại chỉ được tính khi tới Studio, helper giữ câu trả lời, và yêu cầu ra ngoài chặn mọi dạng IPv6 của địa chỉ nội bộ.</p>
+        <ul class="release-items">
+        <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Lần đóng run hỏi lại sau lỗi thoáng qua có thể được ghi nhận dù không tới Studio; giờ chỉ được tính khi Studio nhận được.</span></li>
+        <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Helper đóng lỗi trong chốc lát từng bị coi là thất bại; giờ nó giữ câu trả lời, và báo cáo được gửi lại sau lỗi thoáng qua.</span></li>
+        <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Team memory từng gộp lỗi của hai lệnh khác nhau cùng một chương trình thành một bài học; giờ khóa là cả câu lệnh.</span></li>
+        <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Phản hồi skill từng trộn các skill có tên giống nhau như <code>a/b</code> và <code>a_b</code>; giờ mỗi tên skill có file riêng.</span></li>
+        <li data-kind="security"><span class="kind kind-security">Bảo mật</span><span>Tool <code>web_fetch</code> và package proxy từng cho qua một số dạng IPv6 của địa chỉ nội bộ; giờ mọi dạng như vậy đều bị chặn.</span></li>
+        <li data-kind="security"><span class="kind kind-security">Bảo mật</span><span>Khi có upstream proxy của công ty (<code>HTTPS_PROXY</code>), package proxy giờ tự kiểm tra từng đích kết nối thay vì để upstream tự xử lý.</span></li>
+        </ul>
+      </div>
+    </div>
     <div class="archive-row" id="v1-37-0">
       <div class="archive-head"><a class="release-version" href="#v1-37-0">v1.37.0</a> <span class="release-date">22/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.44.4" title="v1.44.4 docs · VI"><span class="dot"></span>v1.44.4</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.0" title="v1.46.0 docs · VI"><span class="dot"></span>v1.46.0</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.44.4" title="v1.44.4 docs · VI"><span class="dot"></span>v1.44.4</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.0" title="v1.46.0 docs · VI"><span class="dot"></span>v1.46.0</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": 632,
-      "sha256": "32e1a1de9bc5896285ea16a4ad1d0c817e036f1b1877da60b11f406579b5356a"
+      "fileCount": 635,
+      "sha256": "e192ed7528a5d5a992cd33c3837ee6f779b404e45cedc06f79978e2bfa9272eb"
     }
   ],
   "custodianComparisonRules": {

package/package.json

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

package/packages/piagent-core/benchmark/benchmark-bootstrap.js

@@ -494,7 +494,9 @@ function requestedPiProvider(model, configRoot, credentials) {
 }
 
 function snapshotPiAgentHome(temporaryRoot, runtimeParent, argv, cwd, replay, { providerFreeFinalization = false } = {}) {
-  const sourceRoot = path.resolve(process.env.PI_CODING_AGENT_DIR || path.join(os.homedir(), ".pi", "agent"));
+  // Piagent's own Pi home holds the login benchmarks borrow (see extensions/agent-home.js).
+  const personal = path.resolve(os.homedir(), ".pi", "agent"), configured = process.env.PI_CODING_AGENT_DIR;
+  const sourceRoot = path.resolve(process.env.PIAGENT_AGENT_DIR || (configured && path.resolve(configured) !== personal ? configured : path.join(os.homedir(), ".piagent", "agent")));
   const configRoot = path.join(temporaryRoot, "pi-agent-config");
   fs.mkdirSync(configRoot, { recursive: true, mode: 0o700 });
   const copied = [];

package/packages/piagent-core/extensions/agent-home.d.ts

@@ -0,0 +1,4 @@
+export function personalPiAgentDir(home?: string): string;
+export function piagentAgentDir(env?: NodeJS.ProcessEnv, home?: string): string;
+export function agentWatchControlDir(home?: string): string;
+export function dormantInPersonalPi(env?: NodeJS.ProcessEnv, home?: string, argv?: string[]): boolean;

package/packages/piagent-core/extensions/agent-home.js

@@ -0,0 +1,52 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+// Piagent runs Pi from its own home (~/.piagent/agent) so the member's
+// personal `pi` stays the stock host: no Piagent package, add-ons, model scope
+// or footer panel lands in ~/.pi/agent. Agent Watch still reads its control
+// files (runtime record, managed binding, status) from ~/.pi/agent, so those
+// stay where Watch looks; Pi itself ignores them.
+
+/** The stock Pi home, the member's personal `pi`. */
+export function personalPiAgentDir(home = os.homedir()) {
+  return path.resolve(home, ".pi", "agent");
+}
+
+/**
+ * Where Piagent's Pi keeps settings, packages, login and sessions. An explicit
+ * PIAGENT_AGENT_DIR wins; a PI_CODING_AGENT_DIR that points anywhere but the
+ * personal home is honoured (tests, benchmarks, custom setups); otherwise
+ * ~/.piagent/agent.
+ */
+export function piagentAgentDir(env = process.env, home = os.homedir()) {
+  const own = env.PIAGENT_AGENT_DIR?.trim();
+  if (own) return path.resolve(own);
+  const configured = env.PI_CODING_AGENT_DIR?.trim();
+  if (configured && path.resolve(configured) !== personalPiAgentDir(home)) return path.resolve(configured);
+  return path.resolve(home, ".piagent", "agent");
+}
+
+/** Agent Watch's files: the runtime record, the managed binding and status. */
+export function agentWatchControlDir(home = os.homedir()) {
+  return personalPiAgentDir(home);
+}
+
+function realpath(file) {
+  try { return fs.realpathSync(file); } catch { return path.resolve(file); }
+}
+
+/**
+ * True when this process is the stock `pi` command running from the personal
+ * home: Piagent was registered there by an older release or a project's
+ * .pi/settings.json, and it stays out of the member's way. Hosts that embed Pi
+ * (studio, dashboard gateway, benchmarks) and `piagent` itself are never
+ * dormant; PIAGENT_ACTIVE=1 opts a personal `pi` back in.
+ */
+export function dormantInPersonalPi(env = process.env, home = os.homedir(), argv = process.argv) {
+  if (env.PIAGENT_ACTIVE === "1") return false;
+  const configured = env.PI_CODING_AGENT_DIR?.trim();
+  if (configured && path.resolve(configured) !== personalPiAgentDir(home)) return false;
+  const entry = argv[1] ? realpath(argv[1]) : "";
+  return /[\\/]@earendil-works[\\/]pi-coding-agent[\\/]/.test(entry);
+}

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

@@ -37,6 +37,7 @@ import {
 } from "./redaction-core.js";
 import { detectProfileName } from "./project-shape.js";
 import { evaluateUpdateCheck, isInstalledPlatform, readUpdateCache, startUpdateProbe } from "./update-check.js";
+import { dormantInPersonalPi, personalPiAgentDir } from "./agent-home.js";
 import {
   REPOSITORY_SCOPES,
   collectServers,
@@ -366,7 +367,7 @@ const PLATFORM_ROOT = findPlatformRoot(path.dirname(fileURLToPath(import.meta.ur
 // package's and the user's (also those kept for other coding agents, such as
 // ~/.claude/skills). Reading them is allowed; writes stay in the project.
 const SKILL_READ_ROOTS = [path.join(PLATFORM_ROOT, "packages", "piagent-core", "skills"),
-  path.join(process.env.PI_CODING_AGENT_DIR || path.join(os.homedir(), ".pi", "agent"), "skills"), ...userSkillFolders()]
+  path.join(process.env.PI_CODING_AGENT_DIR || personalPiAgentDir(), "skills"), path.join(personalPiAgentDir(), "skills"), ...userSkillFolders()]
   .flatMap((root) => { try { return [fs.realpathSync.native(root)]; } catch { return []; } });
 const UPDATE_CHECK_MODULE = fileURLToPath(new URL("./update-check.js", import.meta.url));
 // The installed version, read from the package this file ships in. A maintainer
@@ -3452,6 +3453,9 @@ function activeSessionTask(_cwd: string, _sessionId: string): TaskContract | und
 const noTask = (..._args: unknown[]): undefined => undefined;
 
 export default function piagentGuard(pi: ExtensionAPI) {
+  // The member's own `pi` stays stock even when an older install or a project
+  // still registers this package there; Piagent runs through `piagent`.
+  if (dormantInPersonalPi()) return;
   const extensionDir = path.dirname(fileURLToPath(import.meta.url));
   const policy = loadPolicy(extensionDir);
   const bashResults = createBashResultLedger({ maxEntries: 300 });

package/packages/piagent-core/extensions/working-tree-snapshot-worker.mjs

@@ -0,0 +1,9 @@
+import { parentPort, workerData } from 'node:worker_threads';
+import { matchesProtectedPath } from './policy-core.js';
+import { workingTreeSnapshot } from './task-state.js';
+// Hash the working tree away from the thread that draws the terminal.
+const { cwd, gitTimeoutMs, protectedPaths } = workerData;
+parentPort.postMessage(workingTreeSnapshot(cwd, {
+  gitTimeoutMs,
+  isProtectedProjectPath: (projectPath) => Boolean(matchesProtectedPath(projectPath, protectedPaths))
+}));

package/packages/piagent-core/extensions/workspace-evidence-roots.js

@@ -104,11 +104,17 @@ function directChildGitEvidenceRootDetails(cwd) {
         complete = false;
         continue;
       }
-      if (!isGitWorkingTree(child)) {
+      // One Git process per child: a parent of thirty repositories ran sixty.
+      let inside, topLevel;
+      try {
+        [inside, topLevel] = gitOutput(child, ["rev-parse", "--is-inside-work-tree", "--show-toplevel"]).trim().split("\n");
+      } catch {
+        inside = "false";
+      }
+      if (inside !== "true" || !topLevel) {
         complete = false;
         continue;
       }
-      const topLevel = gitOutput(child, ["rev-parse", "--show-toplevel"]).trim();
       if (fs.realpathSync(topLevel) !== fs.realpathSync(child)) {
         complete = false;
         continue;
@@ -143,6 +149,26 @@ export function gitEvidenceRoots(cwd) {
   return gitEvidenceRootDetails(cwd).roots;
 }
 
+// Whether the working tree differs from HEAD, without reading any file: the
+// same answer as a non-empty workingTreeSnapshot, which hashes every changed
+// and loose file and blocked the terminal for seconds on each prompt in a
+// folder of repositories. Unknown counts as changed, as it does there.
+export function workingTreeHasChanges(cwd, details = gitEvidenceRootDetails(cwd)) {
+  if (!details.complete) return true;
+  for (const root of details.roots) {
+    try {
+      const status = gitOutput(root.cwd, ["status", "--porcelain", "-z", "--untracked-files=normal",
+        "--", ".", ":(exclude).pi/piagent-state"]);
+      if (status) return true;
+    } catch {
+      return true;
+    }
+  }
+  if (details.roots.length === 0 || details.roots.some((root) => root.prefix === "")) return false;
+  const loose = nonGitWorkspaceFileDetails(cwd, details.roots.map((root) => root.prefix), 1);
+  return loose.files.length > 0 || !loose.complete;
+}
+
 function workspaceEvidenceFileLimit(value) {
   return Number.isInteger(value)
     ? Math.max(1, Math.min(WORKSPACE_EVIDENCE_MAX_FILES, value))

package/packages/piagent-core/mcp/mcp-config-layers.js

@@ -44,7 +44,10 @@ export function configPathForScope(scope, options = {}) {
     case "global":
       return path.join(env.XDG_CONFIG_HOME || path.join(home, ".config"), "mcp", "mcp.json");
     case "pi-global":
-      return path.join(env.PI_CODING_AGENT_DIR || path.join(home, ".pi", "agent"), "mcp.json");
+      // Piagent's own Pi home, not the member's personal pi (see extensions/agent-home.js).
+      if (env.PIAGENT_AGENT_DIR) return path.join(env.PIAGENT_AGENT_DIR, "mcp.json");
+      if (env.PI_CODING_AGENT_DIR && path.resolve(env.PI_CODING_AGENT_DIR) !== path.resolve(home, ".pi", "agent")) return path.join(env.PI_CODING_AGENT_DIR, "mcp.json");
+      return path.join(home, ".piagent", "agent", "mcp.json");
     case "project":
       return path.join(projectPath, ".mcp.json");
     case "pi-project":

package/packages/piagent-core/package.json

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

package/packages/piagent-core/runtime/hooks/input-hook.ts

@@ -1,3 +1,5 @@
+import path from "node:path";
+
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 
 import { classifyContextTask } from "../../extensions/context-engine.js";
@@ -5,6 +7,7 @@ import { matchesProtectedPath } from "../../extensions/policy-core.js";
 import type { TaskContract } from "../../extensions/guard-types.js";
 import { attachLocalImagesFromText, extractLocalImagePathCandidates } from "../input/chat-images.ts";
 import type { ChatImageAccessPolicy } from "../input/chat-images.ts";
+import { reviewFileArguments } from "../input/file-arguments.ts";
 import type { AuthorityResumeDecision } from "../policy/authority-resume-policy.ts";
 import { registerAdaptiveContextGovernor } from "../session/adaptive-context-governor.ts";
 import { toolGroupsForPrompt, PIAGENT_TOOL_NAMES, PIAGENT_TOOL_ORDER, PIAGENT_TOOL_GROUPS } from "../tools/tool-groups.ts";
@@ -74,10 +77,21 @@ export function registerInputHook(pi: ExtensionAPI, dependencies: InputHookDepen
       .filter((group) => !["intake", "task", "recovery"].includes(group)));
     dependencies.telemetry(ctx, { event: "user_input", turnId: turn.turnId, source: event.source,
       promptHash: signal.promptHash, promptChars: text.length, inputMode: "freeform" });
-    const attachment = attachLocalImagesFromText(text, event.images, ctx.cwd, () => dependencies.imageAccess(ctx));
+    const reviewed = reviewFileArguments(text, event.images, ctx.cwd, () => dependencies.imageAccess(ctx));
+    if (reviewed && !reviewed.text) {
+      ctx.ui.notify("Not sent: a file changed while Pi was reading the @file arguments. Run the command again.", "error");
+      return { action: "handled" };
+    }
+    if (reviewed) ctx.ui.notify(`Withheld ${reviewed.withheld.map((item) => `${path.basename(item.path)} (${item.reason})`).join(", ")}`, "warning");
+    const nextText = reviewed?.text ?? text;
+    const nextImages = reviewed ? reviewed.images as typeof event.images : event.images;
+    const attachment = attachLocalImagesFromText(nextText, nextImages, ctx.cwd, () => dependencies.imageAccess(ctx));
+    if (attachment?.skipped.length) {
+      ctx.ui.notify(`Skipped ${attachment.skipped.map((item) => `${path.basename(item.path)} (${item.reason})`).join(", ")}`, "warning");
+    }
     if (attachment?.attached.length) return { action: "transform", text: attachment.text,
-      images: [...(event.images ?? []), ...attachment.images] };
-    if (attachment?.skipped.length) ctx.ui.notify(`Skipped ${attachment.skipped.length} inaccessible image(s)`, "warning");
+      images: [...(nextImages ?? []), ...attachment.images] };
+    if (reviewed) return { action: "transform", text: nextText, images: nextImages };
     return { action: "continue" };
   });
 }