@piagent/platform 1.46.1 → 1.46.4

package/docs-site/releases.json

@@ -1,4 +1,97 @@
 [
+  {
+    "version": "1.46.4",
+    "date": "2026-10-29",
+    "status": "stable",
+    "title": {
+      "en": "One subagent instead of a refused request; update reads a commented models.json",
+      "vi": "Một subagent thay vì bị chặn; bản cập nhật đọc được models.json có comment"
+    },
+    "summary": {
+      "en": "Company sessions no longer loop on a refused subagent call, and the update no longer stops when the Pi model list file has comments.",
+      "vi": "Session công ty không còn lặp lại lệnh gọi subagent bị chặn, và bản cập nhật không còn dừng khi file danh sách model của Pi có comment."
+    },
+    "requires": null,
+    "items": [
+      {
+        "kind": "fixed",
+        "en": "An agent asking for 2–3 subagents the member did not ask for was refused, and some models retried until the member stopped the turn. One subagent now runs, and the agent is told why.",
+        "vi": "Agent xin 2–3 subagent mà member không yêu cầu từng bị chặn, và một số model gọi lại liên tục đến khi member phải dừng. Giờ một subagent chạy, và agent được báo lý do."
+      },
+      {
+        "kind": "fixed",
+        "en": "piagent-update failed when models.json had // comments, which Pi allows. It reads the file as Pi does and leaves a commented file unchanged.",
+        "vi": "piagent-update lỗi khi models.json có comment //, dù Pi cho phép. Giờ file được đọc như Pi đọc, và file có comment được giữ nguyên."
+      },
+      {
+        "kind": "improved",
+        "en": "A model-list setup problem no longer stops the whole install: it warns, names the file and gives the command to run again.",
+        "vi": "Lỗi khi cấu hình danh sách model không còn làm dừng cả bản cài: bản cài cảnh báo, nêu tên file và lệnh để chạy lại."
+      }
+    ]
+  },
+  {
+    "version": "1.46.3",
+    "date": "2026-10-29",
+    "status": "unpublished",
+    "title": {
+      "en": "One subagent instead of a refused request; update reads a commented models.json",
+      "vi": "Một subagent thay vì bị chặn; bản cập nhật đọc được models.json có comment"
+    },
+    "summary": {
+      "en": "Tagged but not published: a release title over the page limit failed the release check. Superseded by 1.46.4.",
+      "vi": "Đã tag nhưng chưa publish: tiêu đề bản phát hành dài quá giới hạn của trang nên kiểm tra release fail. Thay bằng 1.46.4."
+    },
+    "requires": null,
+    "items": [
+      {
+        "kind": "fixed",
+        "en": "An agent asking for 2–3 subagents the member did not ask for was refused, and some models retried until the member stopped the turn. One subagent now runs, and the agent is told why.",
+        "vi": "Agent xin 2–3 subagent mà member không yêu cầu từng bị chặn, và một số model gọi lại liên tục đến khi member phải dừng. Giờ một subagent chạy, và agent được báo lý do."
+      },
+      {
+        "kind": "fixed",
+        "en": "piagent-update failed when models.json had // comments, which Pi allows. It reads the file as Pi does and leaves a commented file unchanged.",
+        "vi": "piagent-update lỗi khi models.json có comment //, dù Pi cho phép. Giờ file được đọc như Pi đọc, và file có comment được giữ nguyên."
+      },
+      {
+        "kind": "improved",
+        "en": "A model-list setup problem no longer stops the whole install: it warns, names the file and gives the command to run again.",
+        "vi": "Lỗi khi cấu hình danh sách model không còn làm dừng cả bản cài: bản cài cảnh báo, nêu tên file và lệnh để chạy lại."
+      }
+    ]
+  },
+  {
+    "version": "1.46.2",
+    "date": "2026-10-29",
+    "status": "stable",
+    "title": {
+      "en": "A message sent after an answer shows at once; the WebUI streams word by word",
+      "vi": "Tin gửi sau câu trả lời hiện ngay; WebUI hiện chữ dần"
+    },
+    "summary": {
+      "en": "The terminal takes the next message as soon as an answer ends, and the WebUI shows an answer while the model writes it instead of once its paragraph ends.",
+      "vi": "Terminal nhận tin tiếp theo ngay khi câu trả lời kết thúc, và WebUI hiện câu trả lời trong lúc model đang viết thay vì đợi hết đoạn."
+    },
+    "requires": null,
+    "items": [
+      {
+        "kind": "fixed",
+        "en": "In a folder of repositories, a message sent right after an answer reached the terminal 1–2 s late: Pi waited for the PIAGENT panel's working-tree scan. The panel now refreshes afterwards.",
+        "vi": "Ở thư mục nhiều repo, tin gửi ngay sau câu trả lời hiện trễ 1–2 giây trong terminal: Pi chờ panel PIAGENT quét working tree. Panel giờ làm mới sau khi Pi nhận tin."
+      },
+      {
+        "kind": "improved",
+        "en": "The WebUI shows an answer word by word while the model writes it; a one-paragraph answer appeared only once complete (first text at about 1.5 s, now 0.4 s, measured locally).",
+        "vi": "WebUI hiện câu trả lời từng chữ trong lúc model viết; trước đây câu trả lời một đoạn chỉ hiện khi viết xong (chữ đầu tiên khoảng 1,5 giây, nay 0,4 giây khi đo cục bộ)."
+      },
+      {
+        "kind": "security",
+        "en": "Streaming holds back a line's last words, so a secret written over several words (Authorization: Basic …, password: …, --token …, a quoted value) is redacted whole.",
+        "vi": "Khi hiện chữ dần, vài từ cuối của dòng được giữ lại để bí mật viết qua nhiều từ (Authorization: Basic …, password: …, --token …, giá trị trong ngoặc) được che trọn."
+      }
+    ]
+  },
   {
     "version": "1.46.1",
     "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.46.1" title="v1.46.1 docs · VI"><span class="dot"></span>v1.46.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.4" title="v1.46.4 docs · VI"><span class="dot"></span>v1.46.4</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.46.1" title="v1.46.1 docs · VI"><span class="dot"></span>v1.46.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.4" title="v1.46.4 docs · VI"><span class="dot"></span>v1.46.4</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.46.1" title="v1.46.1 docs · VI"><span class="dot"></span>v1.46.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.4" title="v1.46.4 docs · VI"><span class="dot"></span>v1.46.4</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.46.1" title="v1.46.1 docs · VI"><span class="dot"></span>v1.46.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.4" title="v1.46.4 docs · VI"><span class="dot"></span>v1.46.4</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.46.1" title="v1.46.1 docs · VI"><span class="dot"></span>v1.46.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.4" title="v1.46.4 docs · VI"><span class="dot"></span>v1.46.4</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.46.1&#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.4&#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.46.1
+npm install -g --ignore-scripts @piagent/platform@1.46.4
 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.46.1" title="v1.46.1 docs · VI"><span class="dot"></span>v1.46.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.4" title="v1.46.4 docs · VI"><span class="dot"></span>v1.46.4</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,43 @@
 <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-46-1" data-release>
+<article class="release latest" id="v1-46-4" data-release>
+  <div class="release-meta"><a class="release-version" href="#v1-46-4">v1.46.4</a><time class="release-date" datetime="2026-10-29">29/10/2026</time></div>
+  <div class="release-body">
+    <h3 data-toc-skip id="v1-46-4-title">Một subagent thay vì bị chặn; bản cập nhật đọc được models.json có comment</h3>
+    <p>Session công ty không còn lặp lại lệnh gọi subagent bị chặn, và bản cập nhật không còn dừng khi file danh sách model của Pi có comment.</p>
+    <ul class="release-items">
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Lỗi khi cấu hình danh sách model không còn làm dừng cả bản cài: bản cài cảnh báo, nêu tên file và lệnh để chạy lại.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Agent xin 2–3 subagent mà member không yêu cầu từng bị chặn, và một số model gọi lại liên tục đến khi member phải dừng. Giờ một subagent chạy, và agent được báo lý do.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>piagent-update lỗi khi models.json có comment //, dù Pi cho phép. Giờ file được đọc như Pi đọc, và file có comment được giữ nguyên.</span></li>
+    </ul>
+  </div>
+</article>
+<article class="release" id="v1-46-3" data-release>
+  <div class="release-meta"><a class="release-version" href="#v1-46-3">v1.46.3</a><time class="release-date" datetime="2026-10-29">29/10/2026</time></div>
+  <div class="release-body">
+    <h3 data-toc-skip id="v1-46-3-title">Một subagent thay vì bị chặn; bản cập nhật đọc được models.json có comment <span class="tag">không phát hành</span></h3>
+    <p>Đã tag nhưng chưa publish: tiêu đề bản phát hành dài quá giới hạn của trang nên kiểm tra release fail. Thay bằng 1.46.4.</p>
+    <ul class="release-items">
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Lỗi khi cấu hình danh sách model không còn làm dừng cả bản cài: bản cài cảnh báo, nêu tên file và lệnh để chạy lại.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Agent xin 2–3 subagent mà member không yêu cầu từng bị chặn, và một số model gọi lại liên tục đến khi member phải dừng. Giờ một subagent chạy, và agent được báo lý do.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>piagent-update lỗi khi models.json có comment //, dù Pi cho phép. Giờ file được đọc như Pi đọc, và file có comment được giữ nguyên.</span></li>
+    </ul>
+  </div>
+</article>
+<article class="release" id="v1-46-2" data-release>
+  <div class="release-meta"><a class="release-version" href="#v1-46-2">v1.46.2</a><time class="release-date" datetime="2026-10-29">29/10/2026</time></div>
+  <div class="release-body">
+    <h3 data-toc-skip id="v1-46-2-title">Tin gửi sau câu trả lời hiện ngay; WebUI hiện chữ dần</h3>
+    <p>Terminal nhận tin tiếp theo ngay khi câu trả lời kết thúc, và WebUI hiện câu trả lời trong lúc model đang viết thay vì đợi hết đoạn.</p>
+    <ul class="release-items">
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>WebUI hiện câu trả lời từng chữ trong lúc model viết; trước đây câu trả lời một đoạn chỉ hiện khi viết xong (chữ đầu tiên khoảng 1,5 giây, nay 0,4 giây khi đo cục bộ).</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Ở thư mục nhiều repo, tin gửi ngay sau câu trả lời hiện trễ 1–2 giây trong terminal: Pi chờ panel PIAGENT quét working tree. Panel giờ làm mới sau khi Pi nhận tin.</span></li>
+      <li data-kind="security"><span class="kind kind-security">Bảo mật</span><span>Khi hiện chữ dần, vài từ cuối của dòng được giữ lại để bí mật viết qua nhiều từ (Authorization: Basic …, password: …, --token …, giá trị trong ngoặc) được che trọn.</span></li>
+    </ul>
+  </div>
+</article>
+<article class="release" id="v1-46-1" data-release>
   <div class="release-meta"><a class="release-version" href="#v1-46-1">v1.46.1</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-1-title">Phản biện có sổ ghi, review một nhịp, subagent song song khi được yêu cầu</h3>
@@ -383,55 +419,50 @@
     </ul>
   </div>
 </article>
-<article class="release" id="v1-40-0" data-release>
-  <div class="release-meta"><a class="release-version" href="#v1-40-0">v1.40.0</a><time class="release-date" datetime="2026-10-24">24/10/2026</time></div>
-  <div class="release-body">
-    <h3 data-toc-skip id="v1-40-0-title">Project local cũng được báo cho Studio</h3>
-    <p>Cuộc trò chuyện công ty trong thư mục không có remote báo project local cho Studio, mọi lượt chạy đều báo, và member thấy mọi loại cảnh báo project.</p>
-    <ul class="release-items">
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Thư mục không có remote đọc được được báo như project local, theo commit gốc của Git hoặc theo mã băm; đường dẫn không bao giờ rời khỏi máy.</span></li>
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Key local của project Git giống nhau trên mọi máy có cùng lịch sử, kể cả bản clone và checkout không có remote <code>origin</code>.</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Mọi lượt chạy đều báo project, không chỉ lượt đầu của cuộc trò chuyện, nên Studio đếm được từng lần dùng và biết máy nào chưa bao giờ báo.</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Member thấy một dòng cho mọi cảnh báo: project của team khác, ngoài danh sách của team, chưa đăng ký cho team, hoặc thư mục không đọc được.</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Thư mục chứa nhiều checkout báo từng checkout, tối đa sáu, và project local được gọi theo tên thư mục.</span></li>
-      <li data-kind="security"><span class="kind kind-security">Bảo mật</span><span>Ba cảnh báo bảo mật của dependency trong Pi host được chấp nhận tới 2026-11-07: từ chối dịch vụ và lỗi Pi không dùng tới, không lộ dữ liệu.</span></li>
-    </ul>
-    <p class="release-requires"><strong>Cần:</strong> Agent Studio 0.40.0</p>
-  </div>
-</article>
-<article class="release" id="v1-39-0" data-release>
-  <div class="release-meta"><a class="release-version" href="#v1-39-0">v1.39.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-39-0-title">Cảnh báo khi key của team được dùng ngoài team</h3>
-    <p>Studio biết cuộc trò chuyện công ty làm trong repository nào và cảnh báo khi key của team bị dùng ngoài team; dashboard giữ ngôn ngữ và theme màu.</p>
-    <ul class="release-items">
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Cuộc trò chuyện công ty báo cho Studio các repository đang làm, dùng cùng key <code>host/path</code> mà team memory đã gửi.</span></li>
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Admin thấy cảnh báo trong Logs → &quot;Sai project&quot;; member thấy một dòng nhắc phía trên ô soạn tin và trong <code>piagent studio</code>.</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Không có gì bị chặn, và team memory chạy như cũ.</span></li>
-      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Dashboard trước đây quay về ngôn ngữ và theme màu mặc định sau mỗi lần khởi động lại; giờ nó giữ cả hai.</span></li>
-    </ul>
-    <p class="release-requires"><strong>Cần:</strong> Agent Studio 0.39.0</p>
-  </div>
-</article>
-<article class="release" id="v1-38-2" data-release>
-  <div class="release-meta"><a class="release-version" href="#v1-38-2">v1.38.2</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-2-title">Cây thư mục, theme màu và editor luôn trong tầm nhìn</h3>
-    <p>Khung Tệp thành cây thư mục, có 13 theme màu, và editor cùng terminal đứng yên khi cuộc trò chuyện cuộn.</p>
-    <ul class="release-items">
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Theme màu trong Cài đặt → Giao diện hoặc bảng lệnh (⌘K) đổi màu cả giao diện, cú pháp trong editor và terminal.</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Trên màn hình rộng, editor và terminal đứng yên dưới header khi cuộc trò chuyện cuộn; kéo thanh chia để đổi độ rộng editor.</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Khung Tệp là cây thư mục: thư mục mở ngay tại chỗ, file đang mở được tô sáng, và Tệp mới bắt đầu ở thư mục vừa chọn.</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Nút Tệp/Terminal luôn hiện ở mọi độ rộng; trên điện thoại cây thư mục hẹp hơn và các nút của editor nằm trên một dòng.</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">58</span></summary>
+    <summary><span>Tháng 10/2026</span><span class="archive-count">61</span></summary>
+    <div class="archive-row" id="v1-40-0">
+      <div class="archive-head"><a class="release-version" href="#v1-40-0">v1.40.0</a> <span class="release-date">24/10/2026</span></div>
+      <div class="archive-body">
+        <p><strong>Project local cũng được báo cho Studio</strong> — Cuộc trò chuyện công ty trong thư mục không có remote báo project local cho Studio, mọi lượt chạy đều báo, và member thấy mọi loại cảnh báo project.</p>
+        <ul class="release-items">
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Thư mục không có remote đọc được được báo như project local, theo commit gốc của Git hoặc theo mã băm; đường dẫn không bao giờ rời khỏi máy.</span></li>
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Key local của project Git giống nhau trên mọi máy có cùng lịch sử, kể cả bản clone và checkout không có remote <code>origin</code>.</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Mọi lượt chạy đều báo project, không chỉ lượt đầu của cuộc trò chuyện, nên Studio đếm được từng lần dùng và biết máy nào chưa bao giờ báo.</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Member thấy một dòng cho mọi cảnh báo: project của team khác, ngoài danh sách của team, chưa đăng ký cho team, hoặc thư mục không đọc được.</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Thư mục chứa nhiều checkout báo từng checkout, tối đa sáu, và project local được gọi theo tên thư mục.</span></li>
+        <li data-kind="security"><span class="kind kind-security">Bảo mật</span><span>Ba cảnh báo bảo mật của dependency trong Pi host được chấp nhận tới 2026-11-07: từ chối dịch vụ và lỗi Pi không dùng tới, không lộ dữ liệu.</span></li>
+        </ul>
+      </div>
+    </div>
+    <div class="archive-row" id="v1-39-0">
+      <div class="archive-head"><a class="release-version" href="#v1-39-0">v1.39.0</a> <span class="release-date">23/10/2026</span></div>
+      <div class="archive-body">
+        <p><strong>Cảnh báo khi key của team được dùng ngoài team</strong> — Studio biết cuộc trò chuyện công ty làm trong repository nào và cảnh báo khi key của team bị dùng ngoài team; dashboard giữ ngôn ngữ và theme màu.</p>
+        <ul class="release-items">
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Cuộc trò chuyện công ty báo cho Studio các repository đang làm, dùng cùng key <code>host/path</code> mà team memory đã gửi.</span></li>
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Admin thấy cảnh báo trong Logs → &quot;Sai project&quot;; member thấy một dòng nhắc phía trên ô soạn tin và trong <code>piagent studio</code>.</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Không có gì bị chặn, và team memory chạy như cũ.</span></li>
+        <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Dashboard trước đây quay về ngôn ngữ và theme màu mặc định sau mỗi lần khởi động lại; giờ nó giữ cả hai.</span></li>
+        </ul>
+      </div>
+    </div>
+    <div class="archive-row" id="v1-38-2">
+      <div class="archive-head"><a class="release-version" href="#v1-38-2">v1.38.2</a> <span class="release-date">23/10/2026</span></div>
+      <div class="archive-body">
+        <p><strong>Cây thư mục, theme màu và editor luôn trong tầm nhìn</strong> — Khung Tệp thành cây thư mục, có 13 theme màu, và editor cùng terminal đứng yên khi cuộc trò chuyện cuộn.</p>
+        <ul class="release-items">
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Theme màu trong Cài đặt → Giao diện hoặc bảng lệnh (⌘K) đổi màu cả giao diện, cú pháp trong editor và terminal.</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Trên màn hình rộng, editor và terminal đứng yên dưới header khi cuộc trò chuyện cuộn; kéo thanh chia để đổi độ rộng editor.</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Khung Tệp là cây thư mục: thư mục mở ngay tại chỗ, file đang mở được tô sáng, và Tệp mới bắt đầu ở thư mục vừa chọn.</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Nút Tệp/Terminal luôn hiện ở mọi độ rộng; trên điện thoại cây thư mục hẹp hơn và các nút của editor nằm trên một dòng.</span></li>
+        </ul>
+      </div>
+    </div>
     <div class="archive-row" id="v1-38-1">
       <div class="archive-head"><a class="release-version" href="#v1-38-1">v1.38.1</a> <span class="release-date">23/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.46.1" title="v1.46.1 docs · VI"><span class="dot"></span>v1.46.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.4" title="v1.46.4 docs · VI"><span class="dot"></span>v1.46.4</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.46.1" title="v1.46.1 docs · VI"><span class="dot"></span>v1.46.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.46.4" title="v1.46.4 docs · VI"><span class="dot"></span>v1.46.4</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

@@ -257,7 +257,7 @@
     {
       "path": "tests",
       "fileCount": 636,
-      "sha256": "143847ccd4abfed97f9fc6bc5f7e5d654eb1cf83507ed473f5d2344327b14d8e"
+      "sha256": "7d8a3af48dd9179f3bf3921cae65d3e6d18d17ff87d3454c29247f8cf1b34b63"
     }
   ],
   "custodianComparisonRules": {

package/package.json

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

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

@@ -3756,7 +3756,10 @@ export default function piagentGuard(pi: ExtensionAPI) {
     appendTrace,
     flushObservedTaskContext: noTask,
     onTurnEnd: activityInspector.refresh,
-    onAgentSettled: async ctx => { await personalCheckpoints.finish(ctx); await activityInspector.refresh(ctx); },
+    onAgentSettled: ctx => personalCheckpoints.finish(ctx),
+    // The panel hashes the working tree: seconds in a folder of repositories,
+    // during which a message sent next stayed off the screen.
+    afterAgentSettled: activityInspector.refresh,
     beforeShutdown: async (ctx) => {
       try { await personalCheckpoints.close(ctx); }
       finally {

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

@@ -20,17 +20,27 @@ export function namedCount(words) {
 }
 // The copies a delegate call asks for, checked against the member's words;
 // null for a plain call. `split`: one line per copy naming its share of the work.
+// Copies the member did not ask for come back as `{ dropped }`: one helper runs
+// and the main agent is told why. A refusal here sent agents round in retries,
+// each quoting other words, until the member stopped the turn.
 export function fanOut(manager, role, args, harness) {
   const split = Array.isArray(args?.split) ? args.split.map(s => typeof s === 'string' ? s.trim().slice(0, 500) : '').filter(Boolean) : [];
   const n = split.length || (Number.isInteger(args?.copies) ? args.copies : 1);
-  if (n <= 1 && !args?.member_words) return null;
+  if (n <= 1) return null;
   if (harness) throw Error('managed-copies-invalid: the harness runs one helper per call.');
-  if (n < 2 || n > MAX_COPIES) throw Error(`managed-copies-invalid: ask for 2 to ${MAX_COPIES} ${role} helpers (copies, or one split line per helper).`);
   const words = normal(args?.member_words);
-  if (words.length < 3 || !memberRequest(memberMessages(manager)).some(text => normal(text).includes(words)) || namedCount(words) < n || !HELPER_WORDS.test(words))
-    throw Error(`managed-copies-not-asked: more than one ${role} helper runs only when the member asks for it. Quote in member_words the member's own words that ask for ${n} (verbatim, with the number); otherwise use one helper.`);
+  if (words.length < 3 || !memberRequest(memberMessages(manager)).some(text => normal(text).includes(words)) || namedCount(words) < n || !HELPER_WORDS.test(words)) return { dropped: n };
+  if (n > MAX_COPIES) throw Error(`managed-copies-invalid: ask for 2 to ${MAX_COPIES} ${role} helpers (copies, or one split line per helper).`);
   return { n, split: split.length ? split : null };
 }
+// The helper's answer, with what the main agent reads above it when it asked
+// for helpers the member did not (`asked`: what fanOut returned).
+export function withDroppedNote(result, role, asked) {
+  const n = asked?.dropped, first = result?.content?.[0];
+  if (!n || first?.type !== 'text') return result;
+  const note = `One ${role} helper ran, not ${n}: the member's own words did not ask for ${n} ${role} helpers. Go on with this answer; run several only when the member asks for that many.\n\n`;
+  return { ...result, content: [{ ...first, text: note + first.text }, ...result.content.slice(1)] };
+}
 // What one copy reads under its brief.
 export function copyNote(role, i, fan) {
   return `\n\nThe member asked for ${fan.n} ${role} helpers; you are ${role} helper ${i + 1} of ${fan.n}. ${fan.split ? `Your share of the work: ${fan.split[i]}. The others cover the rest.` : 'The others have the same brief: answer on your own judgement.'}`;

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

@@ -24,7 +24,7 @@ import { readPatchDigest, readPatchSnapshot, readChangedFiles, readHead } from '
 import { memberTurn } from './continuation.mjs';
 import { workflowPolicy, repositoryChecks, sessionPlanTool, currentPlan, workflowPrompt, RunProcess, completionGate, pendingBaseline, pendingPaths, pendingHead, processEditTools } from './workflow.mjs';
 import { workflowContextTool, workflowContextExtension } from './workflow-context.mjs';
-import { beforeDelegate, resolveTool } from './objections.mjs'; import { fanOut } from './copies.mjs';
+import { beforeDelegate, resolveTool } from './objections.mjs'; import { fanOut, withDroppedNote } from './copies.mjs';
 import { HELPER_CALLS, HELPER_ROLES, helperRoles, helperPrompt, webPrompt, delegateDescription, mainWebLookups, limitedWebTools } from './helper-roles.mjs'; import { delegateParameters, delegateArgs, SPEC_PROMPT } from './helper-settlement.mjs';
 import { loadAgentResources } from './agent-skills.mjs';
 import { loadPiagentThemes } from '../runtime/terminal/terminal-style.mjs';
@@ -469,7 +469,7 @@ export class ManagedSession {
     if (!enabled.includes(role)) throw Error(`managed-helper-not-configured: the company Harness has no ${role} subagent${enabled.length ? `; use ${enabled.join(', ')}` : ''}.`);
     // Studio lets each helper role run HELPER_CALLS times per run (one user
     // message), each helper the member asked for counted (copies.mjs). Say so at once.
-    const fan = fanOut(this.session?.sessionManager, role, more, harness);
+    const asked = fanOut(this.session?.sessionManager, role, more, harness), fan = asked?.dropped ? null : asked;
     if ((this.helperCalls.get(role) ?? 0) + (fan?.n ?? 1) > HELPER_CALLS) throw Error(`managed-helper-limit: the ${role} subagent already ran ${HELPER_CALLS} times for this user message. Go on with what it returned, or use it again after the next user message.`);
     beforeDelegate(this.run, role, harness, { since, review: this.review, changed: (this.ownPaths?.size ?? 0) > 0, asked: !!fan });
     const job = this.runHelper(role, task, signal, harness, title, role === 'review' && typeof since === 'string' && since.trim() ? since.trim() : null, fan); this.helpers.set(role, job); this.publishHelpers();
@@ -477,7 +477,7 @@ export class ManagedSession {
     // quiet: a beat each minute tells the dashboard's watchdog, which stops a
     // turn after 15 minutes without an event, that the turn is working.
     const beat = setInterval(() => this.notify({ type: 'managed_helper_progress', role }), this.helperBeatMs ?? HELPER_BEAT_MS); beat.unref?.();
-    try { return await job; } finally { clearInterval(beat); this.helpers.delete(role); this.publishHelpers(); }
+    try { return withDroppedNote(await job, role, asked); } finally { clearInterval(beat); this.helpers.delete(role); this.publishHelpers(); }
   }
   publishHelpers() {
     // One of each enabled helper role can run at a time.

package/packages/piagent-core/package.json

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

package/packages/piagent-core/runtime/hooks/session-hooks.ts

@@ -25,6 +25,9 @@ type SessionHookDependencies = {
   ) => TaskContract | undefined;
   onTurnEnd?: (ctx: ExtensionContext) => void;
   onAgentSettled?: (ctx: ExtensionContext) => void | Promise<void>;
+  // Display-only work after settlement. Pi takes the next message only when
+  // agent_settled handlers return, so this runs without holding the host.
+  afterAgentSettled?: (ctx: ExtensionContext) => void | Promise<void>;
   beforeShutdown?: (ctx: ExtensionContext) => void | Promise<void>;
 };
 
@@ -103,6 +106,9 @@ export function registerSessionHooks(pi: ExtensionAPI, dependencies: SessionHook
       taskOutcome: task?.trace.outcome
     });
     await dependencies.onAgentSettled?.(ctx);
+    if (dependencies.afterAgentSettled) {
+      void Promise.resolve().then(() => dependencies.afterAgentSettled?.(ctx)).catch(() => undefined);
+    }
   });
 
   pi.on("session_compact", async (event, ctx) => {

package/packages/piagent-core/runtime/managed-failure.mjs

@@ -96,7 +96,6 @@ const CODES = {
   'managed-review-by-harness': ['tool', 'the harness reviews the final patch; the agent does not ask for one'],
   'managed-review-once': ['tool', 'this change was reviewed already; ask again only after fixing blocking findings'],
   'managed-copies-invalid': ['tool', 'several helpers of a role run 2 or 3 at a time, at the member\'s request'],
-  'managed-copies-not-asked': ['tool', 'more than one helper of a role runs only when the member asks for it'],
   helper_run_limit_reached: ['tool', 'this subagent already ran 8 times for this message'],
   'managed-helper-cancelled': ['tool', 'the subagent was stopped'],
   'managed-helper-failed': ['failed', 'the subagent ended without an answer'],

package/packages/piagent-webui/gateway/gateway-session-stream.ts

@@ -13,6 +13,16 @@ const MAX_EVENTS = 128;
 const MAX_DELTA = 16_384;
 const PRIVATE_BEGIN = /-----BEGIN [A-Z ]*PRIVATE KEY-----/;
 const PRIVATE_END = /-----END [A-Z ]*PRIVATE KEY-----/;
+// Within a line, text goes out as it arrives except its last words: a secret
+// written over several words ("Authorization: Basic …", "password: …",
+// "--token …") is then whole on one side of every cut.
+const HELD_WORDS = 6;
+// A key whose quoted value has not closed yet (`password = "two words…`).
+const OPEN_QUOTED_VALUE = /(?:(?::=|:|=)\s*|--[A-Za-z][A-Za-z0-9_.-]*\s+)(["'])(?:(?!\1)[^\r\n])*$/;
+// Pieces of a line share MAX_EVENTS with whole lines: they grow as the
+// operation's events are spent, and stop leaving whole lines a reserve.
+const PIECE_EVENTS = 96;
+const PIECE_MIN_CHARS = 24;
 const RUNTIME_DRIFT = /Installed Piagent runtime changed (?:during this session|while the capability lock was being re-pinned)/i;
 const COMPLETION_GATE = /^\[Piagent completion gate: (CONTINUING|NOT APPROVED)\]/i;
 
@@ -327,6 +337,7 @@ export class GatewaySessionStream {
       const space = this.#buffer.search(/\s\S*$/);
       take = space >= 0 ? space + 1 : this.#buffer.length >= 16_384 ? this.#buffer.length : 0;
     }
+    if (take <= 0 && !final) take = this.#pieceEnd();
     if (take <= 0) return;
     const candidate = this.#buffer.slice(0, take), privateStart = candidate.search(PRIVATE_BEGIN);
     if (privateStart >= 0 && !PRIVATE_END.test(candidate.slice(privateStart))) {
@@ -341,6 +352,19 @@ export class GatewaySessionStream {
     this.#emit(redactSensitiveText(clean(source)).text);
   }
 
+  #pieceEnd(): number {
+    if (this.#eventCount >= PIECE_EVENTS) return 0;
+    const line = this.#buffer, words = [...line.matchAll(/\s+(?=\S)/g)];
+    if (words.length < HELD_WORDS) return 0;
+    const word = words[words.length - HELD_WORDS]!, end = word.index + word[0].length;
+    if (end < PIECE_MIN_CHARS * 2 ** Math.floor(this.#eventCount / 32)) return 0;
+    // Wait for the quote to close: its words would otherwise leave the key.
+    if (OPEN_QUOTED_VALUE.test(line)) return 0;
+    const head = line.slice(0, end), tail = line.slice(end);
+    // The cut must not change what redaction finds in the text known so far.
+    return redactSensitiveText(head).text + redactSensitiveText(tail).text === redactSensitiveText(line).text ? end : 0;
+  }
+
   #emit(value: string): void {
     for (let offset = 0; offset < value.length; offset += MAX_DELTA) {
       if (this.#eventCount >= MAX_EVENTS) { this.#truncated = true; break; }

package/scripts/claude-model-additions.mjs

@@ -1,5 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
+import { parsePiModelsJson } from "./pi-models-json.mjs";
 
 const additions = JSON.parse(fs.readFileSync(new URL("../catalog/claude-model-additions.json", import.meta.url), "utf8"));
 const object = value => value !== null && typeof value === "object" && !Array.isArray(value);
@@ -9,7 +10,11 @@ const object = value => value !== null && typeof value === "object" && !Array.is
 export function prepareClaudeModelAdditions(file) {
   if (fs.existsSync(file) && (!fs.lstatSync(file).isFile() || fs.lstatSync(file).isSymbolicLink())) throw new Error("Unsafe model configuration path");
   const before = fs.existsSync(file) ? fs.readFileSync(file, "utf8") : null;
-  const data = before === null ? {} : JSON.parse(before);
+  let data = {}, strict = true;
+  if (before !== null) {
+    try { ({ data, strict } = parsePiModelsJson(before)); }
+    catch (error) { throw new Error(`Cannot read model configuration ${file}: ${error.message}`); }
+  }
   if (!object(data) || (data.providers !== undefined && !object(data.providers))) throw new Error("Unsupported model configuration");
   data.providers ??= {};
   const provider = data.providers.anthropic ?? {};
@@ -19,6 +24,8 @@ export function prepareClaudeModelAdditions(file) {
   const models = provider.models ?? [];
   const missing = additions.models.filter(model => !models.some(existing => existing.id === model.id));
   if (missing.length === 0) return null;
+  // Rewriting would drop the member's comments; leave the file to them.
+  if (!strict) return { skipped: `${file} has comments; not adding ${missing.map(model => model.id).join(", ")} (add them by hand if wanted)`, apply() {} };
   data.providers.anthropic = { ...provider, models: [...models, ...missing] };
   return { apply() {
     const current = fs.existsSync(file) ? fs.readFileSync(file, "utf8") : null;

package/scripts/configure-model-scope.sh

@@ -168,7 +168,11 @@ function parseDefaultModel(input) {
 
 const parsedDefault = parseDefaultModel(defaultModelInput);
 const settingsBefore = fs.existsSync(settingsPath) ? fs.readFileSync(settingsPath, "utf8") : null;
-const settings = settingsBefore === null ? {} : JSON.parse(settingsBefore);
+let settings = {};
+if (settingsBefore !== null) {
+  try { settings = JSON.parse(settingsBefore); }
+  catch (error) { console.error(`FAIL: cannot read Pi settings ${settingsPath}: ${error.message}`); process.exit(1); }
+}
 
 // What Piagent last offered, so an update adds only models new to this
 // release and never puts back one the member removed.
@@ -213,6 +217,7 @@ if (dryRun) {
   console.log(`  preset: ${preset}`);
   console.log(`  default: ${settings.defaultProvider}/${settings.defaultModel}:${settings.defaultThinkingLevel}`);
   console.log(`  enabledModels: ${settings.enabledModels.length}`);
+  if (catalogEdit?.skipped) console.log(`  note: ${catalogEdit.skipped}`);
   for (const note of notes) console.log(`  ${note}`);
 }
 NODE

package/scripts/install-global.sh

@@ -881,10 +881,16 @@ fi
 
 if [[ "$CONFIGURE_MODEL_SCOPE" == true ]]; then
   echo "Configuring Pi model selector scope:"
-  if [[ "$RESET_MODEL_SCOPE" == true ]]; then
-    run_cmd bash "$PLATFORM_ROOT/scripts/configure-model-scope.sh" --preset "$MODEL_SCOPE_PRESET" --default-model "$DEFAULT_MODEL"
-  else
-    run_cmd bash "$PLATFORM_ROOT/scripts/configure-model-scope.sh" --preset "$MODEL_SCOPE_PRESET" --default-model "$DEFAULT_MODEL" --keep-member-choices
+  MODEL_SCOPE_ARGS=(--preset "$MODEL_SCOPE_PRESET" --default-model "$DEFAULT_MODEL")
+  if [[ "$RESET_MODEL_SCOPE" != true ]]; then
+    MODEL_SCOPE_ARGS+=(--keep-member-choices)
+  fi
+  # The model list is a convenience: a member's settings or models.json that the
+  # script cannot read must not stop the install (Pi and the package are already
+  # in place). The script restores settings.json when it fails part way.
+  if ! run_cmd bash "$PLATFORM_ROOT/scripts/configure-model-scope.sh" "${MODEL_SCOPE_ARGS[@]}"; then
+    echo "WARN: the Pi model selector scope was not changed; the install continues." >&2
+    echo "      Fix the file named above, then run: piagent-model-scope ${MODEL_SCOPE_ARGS[*]}" >&2
   fi
 fi