@piagent/platform 1.49.1 → 1.51.0

package/docs-site/releases.json

@@ -1,4 +1,106 @@
 [
+  {
+    "version": "1.51.0",
+    "date": "2026-11-02",
+    "status": "stable",
+    "title": {
+      "en": "Follow every session from outside it, and a new Always bypass access",
+      "vi": "Theo dõi mọi session từ bên ngoài, thêm quyền Always bypass"
+    },
+    "summary": {
+      "en": "With many sessions open, you see which one is processing, paused or failed without opening it, from any terminal and on the Herdr sidebar. Always bypass, a new access you choose yourself, removes the sandbox and asks only about commits, pushes and removing a critical path.",
+      "vi": "Khi mở nhiều session, bạn biết session nào đang chạy, tạm dừng hay bị lỗi mà không cần mở từng cái, từ terminal bất kỳ và ngay trên sidebar Herdr. Always bypass, quyền mới do bạn tự chọn, bỏ sandbox và chỉ hỏi khi commit, push và xoá đường dẫn quan trọng."
+    },
+    "requires": null,
+    "items": [
+      {
+        "kind": "new",
+        "en": "Always bypass: no sandbox for the agent and its helpers; network, MCP, files and deploys run unasked. Only commit, push, gh pr merge and rm on a critical path are asked. It warns you once.",
+        "vi": "Always bypass: agent và helper không còn sandbox; internet, MCP, file và deploy chạy không hỏi. Chỉ hỏi commit, push, gh pr merge và rm đường dẫn quan trọng. Chỉ cảnh báo một lần."
+      },
+      {
+        "kind": "new",
+        "en": "piagent sessions lists every open session as processing, paused, failed, done or idle, company conversations included. Add --watch to keep it refreshed.",
+        "vi": "piagent sessions liệt kê mọi session đang mở: processing, paused, failed, done hoặc idle, gồm cả cuộc trò chuyện công ty. Thêm --watch để tự làm mới."
+      },
+      {
+        "kind": "new",
+        "en": "piagent sessions --setup-herdr shows the state on each space and agent of the Herdr sidebar.",
+        "vi": "piagent sessions --setup-herdr hiện trạng thái ngay trên từng space và agent ở sidebar Herdr."
+      },
+      {
+        "kind": "fixed",
+        "en": "Herdr sees piagent again: since Piagent moved to its own home, every pane read as unknown and the agents list stayed empty.",
+        "vi": "Herdr lại thấy piagent: từ khi Piagent có home riêng, mọi pane đều là unknown và danh sách agent trống."
+      },
+      {
+        "kind": "fixed",
+        "en": "A company Terminal no longer reads idle in Herdr between the rounds of one message, and a question that waits for you reads as blocked.",
+        "vi": "Terminal công ty không còn báo idle trên Herdr giữa các vòng của một tin nhắn, và câu hỏi đang chờ bạn được báo là blocked."
+      },
+      {
+        "kind": "security",
+        "en": "Always bypass gives no protection against prompt injection: a page or file that misleads the agent can send secrets out unasked. Turn it on only where you accept that.",
+        "vi": "Always bypass không chống được prompt injection: trang web hay file lừa được agent thì secret có thể bị gửi ra ngoài mà không hỏi. Chỉ bật khi bạn chấp nhận điều đó."
+      },
+      {
+        "kind": "improved",
+        "en": "A removal of a critical path unanswered for two minutes does not run and the agent carries on; after three, they are refused until your next message.",
+        "vi": "Lệnh xoá đường dẫn quan trọng không được trả lời trong 2 phút sẽ không chạy và agent làm tiếp; sau 3 lần, các lệnh này bị từ chối đến khi bạn nhắn tiếp."
+      }
+    ]
+  },
+  {
+    "version": "1.50.0",
+    "date": "2026-11-01",
+    "status": "stable",
+    "title": {
+      "en": "A push is judged repository by repository and reviewed first",
+      "vi": "Push được xét theo từng repo và review trước"
+    },
+    "summary": {
+      "en": "From feedback on a real three-repository task: the company Harness knows what passed where, says it before a push, and reviews the code before it leaves.",
+      "vi": "Từ góp ý trên một task ba repo thật: Harness công ty biết phần nào đã pass ở đâu, ghi rõ trước khi push và review code trước khi code rời máy."
+    },
+    "requires": null,
+    "items": [
+      {
+        "kind": "improved",
+        "en": "A required review now runs before a push. A finding holds that push until it is fixed or rejected, so it no longer costs an extra release.",
+        "vi": "Review bắt buộc giờ chạy trước push. Ý kiến review giữ push lại tới khi được sửa hoặc bác bỏ, nên không còn tốn thêm một bản phát hành."
+      },
+      {
+        "kind": "improved",
+        "en": "Before a push the question says which repositories passed in full, which only in part, how many files changed and how long the last full run took.",
+        "vi": "Câu hỏi trước push ghi rõ repo nào đã pass toàn bộ, repo nào mới pass một phần, đổi bao nhiêu file và lần chạy toàn bộ gần nhất mất bao lâu."
+      },
+      {
+        "kind": "fixed",
+        "en": "A whole-suite pass counts per repository: a later small run no longer erases it, and a pass in one repository no longer clears a push of another.",
+        "vi": "Kết quả chạy toàn bộ tính theo từng repo: lần chạy nhỏ sau không xóa nó, và pass ở repo này không còn mở khóa push của repo khác."
+      },
+      {
+        "kind": "fixed",
+        "en": "An approval card nobody answered now says it expired instead of reading as a refusal. A push card waits up to 30 minutes instead of 5.",
+        "vi": "Thẻ duyệt không ai trả lời giờ báo là hết hạn, không còn giống bị từ chối. Thẻ push chờ tối đa 30 phút thay vì 5 phút."
+      },
+      {
+        "kind": "fixed",
+        "en": "Findings of a later review in the same turn reach the agent, and the status names any objection left without a decision by its id.",
+        "vi": "Ý kiến của lần review sau trong cùng lượt nay đến được agent, và dòng trạng thái ghi mã của ý kiến chưa có quyết định."
+      },
+      {
+        "kind": "fixed",
+        "en": "Test scope reads go test -p as parallelism, not a package, and a shell function or loop that picks its files as a part of the suite.",
+        "vi": "Phạm vi test hiểu go test -p là số package chạy song song, không phải tên package, và hiểu hàm shell hoặc vòng lặp tự chọn file là chạy một phần."
+      },
+      {
+        "kind": "improved",
+        "en": "The checks the Harness names are those of the repositories that changed. Bypass no longer sends a quick suite another way, and tests may write .env files in their own temporary folder.",
+        "vi": "Harness chỉ nêu check của repo có thay đổi. Bypass không còn bắt đi đường vòng với bộ test chạy nhanh, và test được ghi file .env trong thư mục tạm của chính nó."
+      }
+    ]
+  },
   {
     "version": "1.49.1",
     "date": "2026-11-01",

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.49.1" title="v1.49.1 docs · VI"><span class="dot"></span>v1.49.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.51.0" title="v1.51.0 docs · VI"><span class="dot"></span>v1.51.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.49.1" title="v1.49.1 docs · VI"><span class="dot"></span>v1.49.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.51.0" title="v1.51.0 docs · VI"><span class="dot"></span>v1.51.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.49.1" title="v1.49.1 docs · VI"><span class="dot"></span>v1.49.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.51.0" title="v1.51.0 docs · VI"><span class="dot"></span>v1.51.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.49.1" title="v1.49.1 docs · VI"><span class="dot"></span>v1.49.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.51.0" title="v1.51.0 docs · VI"><span class="dot"></span>v1.51.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.49.1" title="v1.49.1 docs · VI"><span class="dot"></span>v1.49.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.51.0" title="v1.51.0 docs · VI"><span class="dot"></span>v1.51.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>
@@ -153,9 +153,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.49.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.51.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.49.1
+npm install -g --ignore-scripts @piagent/platform@1.51.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.49.1" title="v1.49.1 docs · VI"><span class="dot"></span>v1.49.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.51.0" title="v1.51.0 docs · VI"><span class="dot"></span>v1.51.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,39 @@
 <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-49-1" data-release>
+<article class="release latest" id="v1-51-0" data-release>
+  <div class="release-meta"><a class="release-version" href="#v1-51-0">v1.51.0</a><time class="release-date" datetime="2026-11-02">02/11/2026</time></div>
+  <div class="release-body">
+    <h3 data-toc-skip id="v1-51-0-title">Theo dõi mọi session từ bên ngoài, thêm quyền Always bypass</h3>
+    <p>Khi mở nhiều session, bạn biết session nào đang chạy, tạm dừng hay bị lỗi mà không cần mở từng cái, từ terminal bất kỳ và ngay trên sidebar Herdr. Always bypass, quyền mới do bạn tự chọn, bỏ sandbox và chỉ hỏi khi commit, push và xoá đường dẫn quan trọng.</p>
+    <ul class="release-items">
+      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Always bypass: agent và helper không còn sandbox; internet, MCP, file và deploy chạy không hỏi. Chỉ hỏi commit, push, gh pr merge và rm đường dẫn quan trọng. Chỉ cảnh báo một lần.</span></li>
+      <li data-kind="new"><span class="kind kind-new">Mới</span><span>piagent sessions liệt kê mọi session đang mở: processing, paused, failed, done hoặc idle, gồm cả cuộc trò chuyện công ty. Thêm --watch để tự làm mới.</span></li>
+      <li data-kind="new"><span class="kind kind-new">Mới</span><span>piagent sessions --setup-herdr hiện trạng thái ngay trên từng space và agent ở sidebar Herdr.</span></li>
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Lệnh xoá đường dẫn quan trọng không được trả lời trong 2 phút sẽ không chạy và agent làm tiếp; sau 3 lần, các lệnh này bị từ chối đến khi bạn nhắn tiếp.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Herdr lại thấy piagent: từ khi Piagent có home riêng, mọi pane đều là unknown và danh sách agent trống.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Terminal công ty không còn báo idle trên Herdr giữa các vòng của một tin nhắn, và câu hỏi đang chờ bạn được báo là blocked.</span></li>
+      <li data-kind="security"><span class="kind kind-security">Bảo mật</span><span>Always bypass không chống được prompt injection: trang web hay file lừa được agent thì secret có thể bị gửi ra ngoài mà không hỏi. Chỉ bật khi bạn chấp nhận điều đó.</span></li>
+    </ul>
+  </div>
+</article>
+<article class="release" id="v1-50-0" data-release>
+  <div class="release-meta"><a class="release-version" href="#v1-50-0">v1.50.0</a><time class="release-date" datetime="2026-11-01">01/11/2026</time></div>
+  <div class="release-body">
+    <h3 data-toc-skip id="v1-50-0-title">Push được xét theo từng repo và review trước</h3>
+    <p>Từ góp ý trên một task ba repo thật: Harness công ty biết phần nào đã pass ở đâu, ghi rõ trước khi push và review code trước khi code rời máy.</p>
+    <ul class="release-items">
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Review bắt buộc giờ chạy trước push. Ý kiến review giữ push lại tới khi được sửa hoặc bác bỏ, nên không còn tốn thêm một bản phát hành.</span></li>
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Câu hỏi trước push ghi rõ repo nào đã pass toàn bộ, repo nào mới pass một phần, đổi bao nhiêu file và lần chạy toàn bộ gần nhất mất bao lâu.</span></li>
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Harness chỉ nêu check của repo có thay đổi. Bypass không còn bắt đi đường vòng với bộ test chạy nhanh, và test được ghi file .env trong thư mục tạm của chính nó.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Kết quả chạy toàn bộ tính theo từng repo: lần chạy nhỏ sau không xóa nó, và pass ở repo này không còn mở khóa push của repo khác.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Thẻ duyệt không ai trả lời giờ báo là hết hạn, không còn giống bị từ chối. Thẻ push chờ tối đa 30 phút thay vì 5 phút.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Ý kiến của lần review sau trong cùng lượt nay đến được agent, và dòng trạng thái ghi mã của ý kiến chưa có quyết định.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Phạm vi test hiểu go test -p là số package chạy song song, không phải tên package, và hiểu hàm shell hoặc vòng lặp tự chọn file là chạy một phần.</span></li>
+    </ul>
+  </div>
+</article>
+<article class="release" id="v1-49-1" data-release>
   <div class="release-meta"><a class="release-version" href="#v1-49-1">v1.49.1</a><time class="release-date" datetime="2026-11-01">01/11/2026</time></div>
   <div class="release-body">
     <h3 data-toc-skip id="v1-49-1-title">Lượt chạy nói rõ đang chờ gì</h3>
@@ -398,35 +430,33 @@
     </ul>
   </div>
 </article>
-<article class="release" id="v1-43-7" data-release>
-  <div class="release-meta"><a class="release-version" href="#v1-43-7">v1.43.7</a><time class="release-date" datetime="2026-10-27">27/10/2026</time></div>
-  <div class="release-body">
-    <h3 data-toc-skip id="v1-43-7-title">Đủ skill đã cài, và mở file agent gửi lại <span class="tag">không phát hành</span></h3>
-    <p>Đã tag nhưng chưa publish: kiểm tra wording công khai chặn release vì tên sản phẩm trong ghi chú. Thay bằng 1.43.9.</p>
-    <ul class="release-items">
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>File agent gắn link trong câu trả lời mở ngay trong explorer: code đúng dòng, ảnh hiện hình, PDF và file office hiện nội dung chữ.</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Skill và lệnh trong plugin Claude và Codex của dev được liệt kê và đọc được, lấy bản mới nhất; gõ /plugin:skill cũng được.</span></li>
-      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Chọn thư mục project mở lại được hộp chọn thư mục của Windows, kể cả khi dashboard chạy nền.</span></li>
-    </ul>
-  </div>
-</article>
-<article class="release" id="v1-43-6" data-release>
-  <div class="release-meta"><a class="release-version" href="#v1-43-6">v1.43.6</a><time class="release-date" datetime="2026-10-27">27/10/2026</time></div>
-  <div class="release-body">
-    <h3 data-toc-skip id="v1-43-6-title">Xem thay đổi của agent ngay khi đang chạy</h3>
-    <p>Thay đổi và Review cập nhật theo lượt đang chạy, thấy sai thì dừng sớm được, và lượt còn chạy không còn trông như đã xong.</p>
-    <ul class="release-items">
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Panel Workspace liệt kê file thay đổi và mở được Review khi agent đang chạy, tự làm mới vài giây một lần; Review cũng cập nhật theo.</span></li>
-      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Câu trả lời bị harness trả lại để chạy check được ghi là giữa chừng, và lượt vẫn hiện đang chạy kèm nút Dừng cho tới khi check xong.</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">70</span></summary>
+    <summary><span>Tháng 10/2026</span><span class="archive-count">72</span></summary>
+    <div class="archive-row" id="v1-43-7">
+      <div class="archive-head"><a class="release-version" href="#v1-43-7">v1.43.7</a> <span class="release-date">27/10/2026</span></div>
+      <div class="archive-body">
+        <p><strong>Đủ skill đã cài, và mở file agent gửi lại</strong> <span class="tag">không phát hành</span> — Đã tag nhưng chưa publish: kiểm tra wording công khai chặn release vì tên sản phẩm trong ghi chú. Thay bằng 1.43.9.</p>
+        <ul class="release-items">
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>File agent gắn link trong câu trả lời mở ngay trong explorer: code đúng dòng, ảnh hiện hình, PDF và file office hiện nội dung chữ.</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Skill và lệnh trong plugin Claude và Codex của dev được liệt kê và đọc được, lấy bản mới nhất; gõ /plugin:skill cũng được.</span></li>
+        <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Chọn thư mục project mở lại được hộp chọn thư mục của Windows, kể cả khi dashboard chạy nền.</span></li>
+        </ul>
+      </div>
+    </div>
+    <div class="archive-row" id="v1-43-6">
+      <div class="archive-head"><a class="release-version" href="#v1-43-6">v1.43.6</a> <span class="release-date">27/10/2026</span></div>
+      <div class="archive-body">
+        <p><strong>Xem thay đổi của agent ngay khi đang chạy</strong> — Thay đổi và Review cập nhật theo lượt đang chạy, thấy sai thì dừng sớm được, và lượt còn chạy không còn trông như đã xong.</p>
+        <ul class="release-items">
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Panel Workspace liệt kê file thay đổi và mở được Review khi agent đang chạy, tự làm mới vài giây một lần; Review cũng cập nhật theo.</span></li>
+        <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Câu trả lời bị harness trả lại để chạy check được ghi là giữa chừng, và lượt vẫn hiện đang chạy kèm nút Dừng cho tới khi check xong.</span></li>
+        </ul>
+      </div>
+    </div>
     <div class="archive-row" id="v1-43-5">
       <div class="archive-head"><a class="release-version" href="#v1-43-5">v1.43.5</a> <span class="release-date">27/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.49.1" title="v1.49.1 docs · VI"><span class="dot"></span>v1.49.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.51.0" title="v1.51.0 docs · VI"><span class="dot"></span>v1.51.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.49.1" title="v1.49.1 docs · VI"><span class="dot"></span>v1.49.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.51.0" title="v1.51.0 docs · VI"><span class="dot"></span>v1.51.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>
@@ -210,6 +210,12 @@ Implement frontend support cho endpoint user status mới. Backend chỉ đọc.
     </article>
   </div>
 </section>
+
+<section class="section">
+  <p class="section-kicker">Nhiều session</p>
+  <h2 id="sessions">Xem mọi session mà không cần vào từng space</h2>
+  <p class="section-lead"><span class="inline-code">piagent sessions</span> liệt kê mọi session đang mở: <span class="inline-code">processing</span> đang chạy, <span class="inline-code">paused</span> đang chờ bạn, <span class="inline-code">failed</span> bị lỗi, <span class="inline-code">done</span> đã xong. Thêm <span class="inline-code">--watch</span> để tự làm mới. Dùng Herdr thì chạy <span class="inline-code">piagent sessions --setup-herdr</span> một lần để thấy trạng thái ngay trên từng space.</p>
+</section>
             <nav class="pager" aria-label="Trang kế tiếp">
               <a class="pager-prev" href="/commands">
                 <span class="pager-label">← Trước</span>

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

@@ -256,8 +256,8 @@
     },
     {
       "path": "tests",
-      "fileCount": 648,
-      "sha256": "c71a827c77f6d8a2557cc956bd7cc4b9d1863c81503b584784f130fe466932e7"
+      "fileCount": 651,
+      "sha256": "02e75d8917cda9a4abc8833a33058700d7ee0baf9553b2efc54d894ff845023b"
     }
   ],
   "custodianComparisonRules": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piagent/platform",
-  "version": "1.49.1",
+  "version": "1.51.0",
   "license": "MIT",
   "publishConfig": {
     "access": "public",
@@ -72,6 +72,7 @@
   "bin": {
     "piagent": "scripts/piagent-cli.mjs",
     "piagent-dashboard": "scripts/piagent-cli.mjs",
+    "piagent-sessions": "scripts/piagent-cli.mjs",
     "piagent-setup": "scripts/piagent-cli.mjs",
     "piagent-install": "scripts/piagent-cli.mjs",
     "piagent-update": "scripts/piagent-cli.mjs",

package/packages/piagent-core/extensions/fallback-base-policy.ts

@@ -31,7 +31,7 @@ export function fallbackBasePolicy(
     defaultRequiredContext: ["AGENTS.md", "README.md"],
     permissionProfiles: {
       defaultMode: "workspace-write",
-      allowedModes: ["read-only", "workspace-write", "trusted-full-access", "bypass"]
+      allowedModes: ["read-only", "workspace-write", "trusted-full-access", "bypass", "always-bypass"]
     },
     execPolicy: {
       defaultMode: "enforce",

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

@@ -326,7 +326,10 @@ export type ResolvedOrchestrationPolicy = {
 // "bypass": personal sessions only; no Piagent gate asks or blocks the work. The
 // handoff (runtime/policy/handoff-policy.mjs) is still asked; output redaction
 // and turn checkpoints still run.
-export type PermissionProfileMode = "read-only" | "workspace-write" | "trusted-full-access" | "bypass";
+// "always-bypass": only committing and pushing code and an rm on a critical path
+// are asked (critical-removal.mjs);
+// the project's autoDeny rules, output redaction and turn checkpoints remain.
+export type PermissionProfileMode = "read-only" | "workspace-write" | "trusted-full-access" | "bypass" | "always-bypass";
 
 export type PermissionProfilesConfig = {
   defaultMode?: PermissionProfileMode;

package/packages/piagent-core/{managed/herdr-reporter.mjs → extensions/herdr-reporter.js}

@@ -7,7 +7,7 @@ import net from 'node:net';
 // the company Terminal's own reporter: the same socket requests (newline JSON,
 // pane.report_agent), with the command that reopens this conversation in
 // `piagent studio` instead of personal Pi.
-const SOURCE = 'custom:piagent-studio', AGENT = 'piagent';
+const COMPANY_SOURCE = 'custom:piagent-studio', AGENT = 'piagent';
 
 // What a Herdr pane gives its processes, read before the environment is
 // cleared; null outside Herdr. Nothing else of it reaches the conversation.
@@ -21,7 +21,7 @@ export function herdrEnvironment(environment = process.env) {
 // control characters (its POSIX quoting), so such a path is not offered.
 export function herdrResumeArgv(cwd, sessionFile) {
   const argv = ['piagent', 'studio', '--project', cwd, ...(sessionFile ? ['--session', sessionFile] : [])];
-  return argv.every(part => typeof part === 'string' && part && !part.includes("'") && !/\p{Cc}/u.test(part)) ? argv : null;
+  return safeArgv(argv);
 }
 
 // One request, delivered when Herdr answers; a second, longer try when the
@@ -42,12 +42,15 @@ export async function sendHerdrRequest(socketPath, request) {
   if (!await sendOnce(socketPath, request, 500)) await sendOnce(socketPath, request, 1500);
 }
 
+// Herdr refuses a resume command with an apostrophe or control characters.
+const safeArgv = argv => argv && argv.every(part => typeof part === 'string' && part && !part.includes("'") && !/\p{Cc}/u.test(part)) ? argv : null;
+
 // working while a turn runs, blocked while the conversation waits for the
-// member (Pi's `herdr:blocked` events), idle otherwise. Reports go out one at a
-// time, the newest state winning.
-export function companyHerdrExtension(herdr, { send = sendHerdrRequest } = {}) {
+// member (Pi's blocking dialogs, or `herdr:blocked` events), idle otherwise.
+// Reports go out one at a time, the newest state winning.
+export function herdrReporterExtension(herdr, { source, resume, managed = null, send = sendHerdrRequest }) {
   return (pi) => {
-    let seq = Date.now() * 1000, active = false, blocked = 0, label, last, resumeArgv, queued, sending = false;
+    let unsubscribe, seq = Date.now() * 1000, active = false, blocked = 0, label, last, resumeArgv, queued, sending = false;
     const desired = () => blocked > 0 ? { state: 'blocked', message: label } : { state: active ? 'working' : 'idle', message: undefined };
     const drain = async () => {
       if (sending) return;
@@ -55,8 +58,8 @@ export function companyHerdrExtension(herdr, { send = sendHerdrRequest } = {}) {
       try {
         while (queued) {
           const next = queued; queued = undefined;
-          await send(herdr.socket, { id: `${SOURCE}:${next.seq}`, method: 'pane.report_agent',
-            params: { pane_id: herdr.pane, source: SOURCE, agent: AGENT, state: next.state, message: next.message, seq: next.seq, ...(resumeArgv ? { resume_argv: resumeArgv } : {}) } });
+          await send(herdr.socket, { id: `${source}:${next.seq}`, method: 'pane.report_agent',
+            params: { pane_id: herdr.pane, source, agent: AGENT, state: next.state, message: next.message, seq: next.seq, ...(resumeArgv ? { resume_argv: resumeArgv } : {}) } });
         }
       } finally { sending = false; if (queued) void drain(); }
     };
@@ -68,18 +71,31 @@ export function companyHerdrExtension(herdr, { send = sendHerdrRequest } = {}) {
     const follow = ctx => {
       let file;
       try { file = ctx?.sessionManager?.getSessionFile?.(); } catch { file = undefined; }
-      const argv = herdrResumeArgv(ctx?.cwd, typeof file === 'string' && file ? file : undefined);
+      const argv = safeArgv(resume(ctx?.cwd, typeof file === 'string' && file ? file : undefined));
       const changed = JSON.stringify(argv) !== JSON.stringify(resumeArgv);
       resumeArgv = argv ?? undefined;
       return changed;
     };
-    pi.events?.on?.('herdr:blocked', data => {
+    const wait = data => {
       if (data?.active) { blocked += 1; label = data.label; } else { blocked = Math.max(0, blocked - 1); if (!blocked) label = undefined; }
       publish();
-    });
+    };
+    pi.events?.on?.('herdr:blocked', wait);
+    // A long list as a title is not a label Herdr can show.
+    pi.on('ui_prompt_start', event => wait({ active: true, label: event?.title?.slice(0, 80) }));
+    pi.on('ui_prompt_end', () => wait({ active: false }));
     // /new, /resume and /fork start another session: Herdr follows it.
-    pi.on('session_start', async (_event, ctx) => { follow(ctx); active = ctx?.isIdle?.() === false; publish(true); });
+    pi.on('session_start', async (_event, ctx) => {
+      follow(ctx); active = ctx?.isIdle?.() === false || !!managed?.()?.activePrompt; publish(true);
+      // One company message is many rounds: it is idle when the turn itself ends.
+      unsubscribe?.();
+      unsubscribe = managed?.()?.session?.subscribe?.(event => { if (event?.type === 'agent_settled' && !managed()?.activePrompt) { active = false; publish(); } });
+    });
     pi.on('agent_start', (_event, ctx) => { const changed = follow(ctx); active = true; publish(changed); });
-    pi.on('agent_settled', (_event, ctx) => { if (ctx?.isIdle?.() !== true) return; active = false; publish(); });
+    pi.on('agent_settled', (_event, ctx) => { if (ctx?.isIdle?.() !== true || managed?.()?.activePrompt) return; active = false; publish(); });
   };
 }
+
+export function companyHerdrExtension(herdr, { send, managed } = {}) {
+  return herdrReporterExtension(herdr, { source: COMPANY_SOURCE, resume: herdrResumeArgv, managed, ...(send ? { send } : {}) });
+}

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

@@ -38,6 +38,7 @@ import {
 import { detectProfileName } from "./project-shape.js";
 import { evaluateUpdateCheck, isInstalledPlatform, readUpdateCache, startUpdateProbe } from "./update-check.js";
 import { dormantInPersonalPi, personalPiAgentDir } from "./agent-home.js";
+import { registerTerminalSessionStatus } from "./session-status.js";
 import { collectServers } from "../mcp/mcp-config-layers.js";
 import { evaluateMcpApproval, mcpApprovalCache } from "../runtime/mcp-repository-gate.mjs";
 import { evaluateServerReadiness, readinessNotice } from "../mcp/mcp-auth-readiness.js";
@@ -88,7 +89,8 @@ import { ensurePrivateStateDirectory, resolveLocalStatePath } from "./local-stat
 import { hasDurableContextEvidence } from "./context-evidence.js";
 import { piApprovalBroker, type ApprovalActionDraft, type ApprovalChoice, type ApprovalUnavailableFallback } from "../runtime/inspection/approval-broker.ts";
 import { createSourceMutationGuardBindings } from "../runtime/policy/source-mutation-guard-binding.ts";
-import { FULL_ACCESS_RUNS, handoffReason, mcpWriteAction, treeExecFinding } from "../runtime/policy/handoff-policy.mjs";
+import { REMOVAL_EXPIRED, REMOVAL_TTL_MS, criticalRemovalReason, noteRemovalExpired, removalsHeld } from "../runtime/policy/critical-removal.mjs";
+import { FULL_ACCESS_RUNS, codeHandoffReason, handoffReason, mcpWriteAction, treeExecFinding } from "../runtime/policy/handoff-policy.mjs";
 import { createWorkspaceWriteAuthorityBindings } from "../runtime/policy/workspace-write-authority.ts";
 import { registerWorkspaceMemberEdits } from "../runtime/session/workspace-member-edits.mjs";
 import {
@@ -343,6 +345,8 @@ const PERMISSION_PROFILE_ALIASES: Record<string, PermissionProfileMode> = {
   "trusted_full_access": "trusted-full-access",
   "danger-full-access": "trusted-full-access",
   "danger_full_access": "trusted-full-access",
+  "always-bypass": "always-bypass",
+  "always_bypass": "always-bypass",
   bypass: "bypass",
   yolo: "bypass",
   "dangerously-bypass": "bypass",
@@ -1160,6 +1164,7 @@ function runtimeEquivalentForPermissionProfile(mode: PermissionProfileMode): str
   // checks are the boundary.
   if (mode === "read-only") return "like sandbox_mode=read-only, enforced by Piagent policy (no OS sandbox)";
   if (mode === "trusted-full-access") return "like sandbox_mode=danger-full-access; protected paths, destructive steps and the handoff (push, PR, publish, deploy, remote tools) are still asked";
+  if (mode === "always-bypass") return "like sandbox_mode=danger-full-access + approval_policy=never except committing and pushing code and removing a critical path; the project's autoDeny rules, output redaction and turn checkpoints remain";
   if (mode === "bypass") return "like sandbox_mode=danger-full-access + approval_policy=never for the work; the handoff (push, PR, publish, deploy, remote tools, MCP writes) is still asked, and output redaction and turn checkpoints remain";
   return "like sandbox_mode=workspace-write + approval_policy=on-request, enforced by Piagent policy (no OS sandbox)";
 }
@@ -1239,7 +1244,7 @@ function isPiagentTool(toolName: string): boolean {
 }
 
 // Full access or more: the profile does not narrow reads or the tool registry.
-const broadAccess = (mode: PermissionProfileMode) => mode === "trusted-full-access" || mode === "bypass";
+const broadAccess = (mode: PermissionProfileMode) => mode === "trusted-full-access" || mode === "bypass" || mode === "always-bypass";
 
 function evaluatePermissionProfileToolAccess(
   toolName: string,
@@ -3346,6 +3351,7 @@ 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;
+  registerTerminalSessionStatus(pi);
   const extensionDir = path.dirname(fileURLToPath(import.meta.url));
   const policy = loadPolicy(extensionDir);
   const bashResults = createBashResultLedger({ maxEntries: 300 });
@@ -3754,8 +3760,9 @@ export default function piagentGuard(pi: ExtensionAPI) {
   });
 
   // Bypass is for personal sessions only: a company session keeps Studio's rules.
-  const bypassActive = (ctx: ExtensionContext) => !isCompanySession(ctx) && ctx.model?.provider !== "agent_watch_managed"
-    && resolvePermissionProfile(loadProfileFromContext(ctx), policy, permissionOverrideFromContext(ctx)).mode === "bypass";
+  const bypassMode = (ctx: ExtensionContext) => !isCompanySession(ctx) && ctx.model?.provider !== "agent_watch_managed"
+    ? resolvePermissionProfile(loadProfileFromContext(ctx), policy, permissionOverrideFromContext(ctx)).mode : null;
+  const bypassActive = (ctx: ExtensionContext) => ["bypass", "always-bypass"].includes(String(bypassMode(ctx)));
   // Bypass runs the work without asking and stops at the handoff: a push, a
   // PR or merge, a publish or deploy, a remote or cloud tool, an upload or an
   // MCP tool that writes outside is asked about, as in every other mode.
@@ -3770,8 +3777,11 @@ export default function piagentGuard(pi: ExtensionAPI) {
       const refused = evaluateExecPolicyCore(command, { policy: { execPolicy: { defaultMode: "enforce", bannedPrefixSuggestions: [], rules: projectRules } }, mode: "enforce" });
       if (refused.decision === "forbid") return execRefusal(refused);
     }
-    let reason = command ? await handoffReason(command) : null;
-    if (!reason && !command && prepared && classifyExternalAction(event.toolName, prepared.input, policy).decision === "confirm") {
+    const always = bypassMode(ctx) === "always-bypass", modeName = always ? "Always bypass" : "Bypass";
+    const removal = always && command ? criticalRemovalReason(command, { cwd: ctx.cwd, home: os.homedir() }) : null;
+    let reason = !command ? null : always ? removal ?? codeHandoffReason(command) : await handoffReason(command);
+    if (removal && removalsHeld(ctx.sessionManager.getSessionId(), ctx.sessionManager)) return { block: true, reason: `${removal}. ${REMOVAL_EXPIRED}` };
+    if (!always && !reason && !command && prepared && classifyExternalAction(event.toolName, prepared.input, policy).decision === "confirm") {
       const action = await mcpWriteAction(prepared.proxyTool ?? event.toolName);
       if (action) reason = `${prepared.proxyToolName ?? event.toolName} writes outside this machine (${action})`;
     }
@@ -3780,10 +3790,11 @@ export default function piagentGuard(pi: ExtensionAPI) {
     const approval = await piApprovalBroker.request({ cwd: ctx.cwd, rawSessionId: ctx.sessionManager.getSessionId(), toolCallId: String(event.toolCallId), expectedTask: null,
       action: { kind: "external-provider-action", preconditionClass: "runtime-only", treePrecondition: null, toolName: event.toolName, rawAction: { toolName: event.toolName, command, input },
         commandPreview: command, parameterPreview: preview, targetPaths: [], targetSummaries: [reason], provider: command ? "shell-external" : String(prepared?.proxyToolName ?? event.toolName),
-        urlOrigin: null, requestedScope: "one-handoff", reason: `Bypass still asks before a handoff: ${reason}`, riskClass: "high",
+        urlOrigin: null, requestedScope: "one-handoff", reason: `${modeName} still asks before a handoff: ${reason}`, riskClass: "high",
         allowConsequence: "Run this exact step once; the work leaves this machine.", denyConsequence: "The step does not run; the agent is told you declined." },
-      terminalConfirm: () => ctx.ui.confirm(`Bypass still asks before a handoff.\n\n${reason}\n\n${preview}\n\nAllow?`, "Piagent handoff confirmation"),
-      terminalChoose: terminalChooser(ctx, "Piagent handoff confirmation", `Bypass still asks before a handoff.\n\n${reason}\n\n${preview}`, false), unavailableFallback: approvalUnavailableFallback(ctx) });
+      terminalConfirm: () => ctx.ui.confirm(`${modeName} still asks before a handoff.\n\n${reason}\n\n${preview}\n\nAllow?`, "Piagent handoff confirmation"),
+      terminalChoose: terminalChooser(ctx, "Piagent handoff confirmation", `${modeName} still asks before a handoff.\n\n${reason}\n\n${preview}`, false), unavailableFallback: approvalUnavailableFallback(ctx), ...(removal ? { ttlMs: REMOVAL_TTL_MS } : {}) });
+    if (removal && approval.receipt?.state === "expired") { noteRemovalExpired(ctx.sessionManager.getSessionId(), ctx.sessionManager); return { block: true, reason: `${removal}. ${REMOVAL_EXPIRED}` }; }
     if (!approval.allowed) return approval.choice === "stop" ? { block: true, terminate: true, reason: `User denied the handoff and stopped the turn: ${reason}. Do not retry; wait for the member.` } : { block: true, reason: `User denied the handoff: ${reason}` };
     if (!approval.consume()) return { block: true, reason: "Approval became stale before tool start; the action was blocked." };
     return undefined;

package/packages/piagent-core/extensions/session-status.d.ts

@@ -0,0 +1 @@
+export function registerTerminalSessionStatus(pi: unknown, env?: NodeJS.ProcessEnv): void;