@piagent/platform 1.44.3 → 1.45.0

package/docs-site/quickstart.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.3" title="v1.44.3 docs · VI"><span class="dot"></span>v1.44.3</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.45.0" title="v1.45.0 docs · VI"><span class="dot"></span>v1.45.0</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart" aria-current="page">Tài liệu</a>
         <a href="/whats-new">Changelog</a>
@@ -200,7 +200,7 @@ Review diff hiện tại. Chỉ đọc.</code></pre>
   </div>
   <div class="callout">
     <strong>Dùng Herdr?</strong>
-    <p>Cài Herdr <em>trước</em> <code>piagent-setup</code> để được cài luôn tích hợp Pi; cài sau thì chạy lại <code>piagent-setup --global-only</code>. Herdr chỉ điều phối terminal, không phải lớp bảo vệ. Xem <a href="https://github.com/Vt-mmm/piagent/blob/main/docs/herdr-workflow.md">Herdr workflow</a>.</p>
+    <p>Cài Herdr <em>trước</em> <code>piagent-setup</code> để được cài luôn tích hợp Pi; cài sau thì chạy lại <code>piagent-setup --global-only</code>. Trên Windows, cài Herdr trong Ubuntu (WSL2), cùng chỗ với Piagent; trong pane Herdr, <code>piagent studio</code> được mở lại đúng cuộc trò chuyện công ty sau khi Herdr khởi động lại. Herdr chỉ điều phối terminal, không phải lớp bảo vệ. Xem <a href="https://github.com/Vt-mmm/piagent/blob/main/docs/herdr-workflow.md">Herdr workflow</a>.</p>
   </div>
 </section>
 

package/docs-site/releases.json

@@ -1,4 +1,71 @@
 [
+  {
+    "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",
+    "status": "stable",
+    "title": {
+      "en": "Company conversations come back in Herdr panes",
+      "vi": "Conversation công ty trở lại trong pane Herdr"
+    },
+    "summary": {
+      "en": "In Herdr (on Windows: inside WSL), a company pane reports its state and reopens the same conversation after Herdr restarts, with piagent studio --session.",
+      "vi": "Trong Herdr (Windows: cài trong WSL), pane công ty báo trạng thái và mở lại đúng conversation sau khi Herdr khởi động lại, bằng piagent studio --session."
+    },
+    "items": [
+      {
+        "kind": "new",
+        "en": "piagent studio --session <file> reopens a company conversation; only a file of the member’s own store is accepted (managed-session-outside-store otherwise).",
+        "vi": "piagent studio --session <file> mở lại một conversation công ty; chỉ nhận file trong kho của chính member (ngoài kho báo managed-session-outside-store)."
+      },
+      {
+        "kind": "new",
+        "en": "A company conversation in a Herdr pane reports working, waiting or idle to Herdr, which resumes it with piagent studio, not personal pi. Needs Herdr 0.9.2+.",
+        "vi": "Conversation công ty trong pane Herdr báo đang chạy, chờ hay rảnh cho Herdr, và Herdr resume bằng piagent studio, không phải pi cá nhân. Cần Herdr 0.9.2+."
+      },
+      {
+        "kind": "fixed",
+        "en": "WSL/Linux: personal Pi no longer opens a company conversation that has no turn yet, and piagent studio --web opens the browser (wslview/explorer.exe).",
+        "vi": "WSL/Linux: Pi cá nhân không còn mở được conversation công ty chưa có lượt nào, và piagent studio --web mở được trình duyệt (wslview/explorer.exe)."
+      }
+    ],
+    "requires": null
+  },
   {
     "version": "1.44.3",
     "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.3" title="v1.44.3 docs · VI"><span class="dot"></span>v1.44.3</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.45.0" title="v1.45.0 docs · VI"><span class="dot"></span>v1.45.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.3" title="v1.44.3 docs · VI"><span class="dot"></span>v1.44.3</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.45.0" title="v1.45.0 docs · VI"><span class="dot"></span>v1.45.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.3" title="v1.44.3 docs · VI"><span class="dot"></span>v1.44.3</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.45.0" title="v1.45.0 docs · VI"><span class="dot"></span>v1.45.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.3" title="v1.44.3 docs · VI"><span class="dot"></span>v1.44.3</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.45.0" title="v1.45.0 docs · VI"><span class="dot"></span>v1.45.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.3" title="v1.44.3 docs · VI"><span class="dot"></span>v1.44.3</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.45.0" title="v1.45.0 docs · VI"><span class="dot"></span>v1.45.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.3&#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.45.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.3
+npm install -g --ignore-scripts @piagent/platform@1.45.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.3" title="v1.44.3 docs · VI"><span class="dot"></span>v1.44.3</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.45.0" title="v1.45.0 docs · VI"><span class="dot"></span>v1.45.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,32 @@
 <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-3" data-release>
+<article class="release latest" 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>
+    <p>Trong Herdr (Windows: cài trong WSL), pane công ty báo trạng thái và mở lại đúng conversation sau khi Herdr khởi động lại, bằng piagent studio --session.</p>
+    <ul class="release-items">
+      <li data-kind="new"><span class="kind kind-new">Mới</span><span>piagent studio --session &lt;file&gt; mở lại một conversation công ty; chỉ nhận file trong kho của chính member (ngoài kho báo managed-session-outside-store).</span></li>
+      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Conversation công ty trong pane Herdr báo đang chạy, chờ hay rảnh cho Herdr, và Herdr resume bằng piagent studio, không phải pi cá nhân. Cần Herdr 0.9.2+.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>WSL/Linux: Pi cá nhân không còn mở được conversation công ty chưa có lượt nào, và piagent studio --web mở được trình duyệt (wslview/explorer.exe).</span></li>
+    </ul>
+  </div>
+</article>
+<article class="release" id="v1-44-3" data-release>
   <div class="release-meta"><a class="release-version" href="#v1-44-3">v1.44.3</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-3-title">Prompt injection không lặng lẽ đọc được hệ thống</h3>
@@ -398,41 +423,38 @@
     <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>
-<article class="release" id="v1-37-0" data-release>
-  <div class="release-meta"><a class="release-version" href="#v1-37-0">v1.37.0</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-0-title">Câu trả lời bị cắt không còn làm dừng task dài</h3>
-    <p>Câu trả lời bị cắt giữa chừng phía sau Studio được hỏi lại và task tự làm tiếp; <code>piagent studio --rpc</code> cho script điều khiển cuộc trò chuyện công ty.</p>
-    <ul class="release-items">
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Lệnh mới <code>piagent studio --rpc</code> chạy một cuộc trò chuyện công ty qua giao thức RPC của Pi trên stdin/stdout, nhiều tin nhắn và có <code>ask_user</code>.</span></li>
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Repository có lane soak cho task dài: một member giả lập điều khiển agent công ty thật qua các task 45–150 phút.</span></li>
-      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Câu trả lời bị cắt giữa chừng từng hiện &quot;không gửi được yêu cầu&quot; và dừng task dài; giờ Piagent hỏi lại và task tự làm tiếp.</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 thoát với lỗi khi cuộc trò chuyện đóng ngay sau một lượt trong lúc Git vẫn đang trả trạng thái branch.</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">54</span></summary>
+    <summary><span>Tháng 10/2026</span><span class="archive-count">56</span></summary>
+    <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">
+        <p><strong>Câu trả lời bị cắt không còn làm dừng task dài</strong> — Câu trả lời bị cắt giữa chừng phía sau Studio được hỏi lại và task tự làm tiếp; <code>piagent studio --rpc</code> cho script điều khiển cuộc trò chuyện công ty.</p>
+        <ul class="release-items">
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Lệnh mới <code>piagent studio --rpc</code> chạy một cuộc trò chuyện công ty qua giao thức RPC của Pi trên stdin/stdout, nhiều tin nhắn và có <code>ask_user</code>.</span></li>
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Repository có lane soak cho task dài: một member giả lập điều khiển agent công ty thật qua các task 45–150 phút.</span></li>
+        <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Câu trả lời bị cắt giữa chừng từng hiện &quot;không gửi được yêu cầu&quot; và dừng task dài; giờ Piagent hỏi lại và task tự làm tiếp.</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 thoát với lỗi khi cuộc trò chuyện đóng ngay sau một lượt trong lúc Git vẫn đang trả trạng thái branch.</span></li>
+        </ul>
+      </div>
+    </div>
     <div class="archive-row" id="v1-36-1">
       <div class="archive-head"><a class="release-version" href="#v1-36-1">v1.36.1</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.3" title="v1.44.3 docs · VI"><span class="dot"></span>v1.44.3</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.45.0" title="v1.45.0 docs · VI"><span class="dot"></span>v1.45.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.3" title="v1.44.3 docs · VI"><span class="dot"></span>v1.44.3</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.45.0" title="v1.45.0 docs · VI"><span class="dot"></span>v1.45.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": 631,
-      "sha256": "37750935b5a593d52607baf8fa6b3faba03105501289fa83f4677504ed05e3d3"
+      "fileCount": 634,
+      "sha256": "a3731ca8ba76de242f6ce801a4bd1e9a1e61951fe6dcada375503ab9976197be"
     }
   ],
   "custodianComparisonRules": {

package/package.json

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

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

@@ -7,11 +7,13 @@ import path from "node:path";
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 
 const COMPANY_PROVIDER = "agent_watch_managed";
-const STORE = "/AgentWatch/ManagedSessions/";
+// Agent Watch's store: the macOS app's support folder, or the XDG data folder
+// on Linux and WSL (managed/store.mjs).
+const STORE = /\/(AgentWatch|agentwatch)\/ManagedSessions\//;
 
 export function isCompanySession(ctx: Pick<ExtensionContext, "sessionManager">): boolean {
   const file = String(ctx.sessionManager?.getSessionFile?.() ?? "").split(path.sep).join("/");
-  if (file.includes(STORE)) return true;
+  if (STORE.test(file)) return true;
   try {
     return ctx.sessionManager.getEntries().some((entry: any) => typeof entry?.customType === "string" && entry.customType.startsWith("agent-watch-run"));
   } catch {

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/managed/herdr-reporter.mjs

@@ -0,0 +1,85 @@
+import net from 'node:net';
+
+// Herdr (herdr.dev) keeps panes of agents and resumes each one's session after
+// its server restarts. Its own Pi extension lives in ~/.pi/agent/extensions,
+// which a company conversation never loads, and `piagent studio` starts from a
+// clean environment, so Herdr would see no state and resume nothing. This is
+// 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';
+
+// What a Herdr pane gives its processes, read before the environment is
+// cleared; null outside Herdr. Nothing else of it reaches the conversation.
+export function herdrEnvironment(environment = process.env) {
+  const socket = environment.HERDR_SOCKET_PATH, pane = environment.HERDR_PANE_ID;
+  if (environment.HERDR_ENV !== '1' || !socket || !pane) return null;
+  return { socket: process.platform === 'win32' ? `\\\\.\\pipe\\${socket}` : socket, pane };
+}
+
+// Herdr types this into the restored pane's shell. It refuses apostrophes and
+// 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;
+}
+
+// One request, delivered when Herdr answers; a second, longer try when the
+// first is lost. A Herdr that is gone costs the conversation nothing.
+function sendOnce(socketPath, request, timeoutMs) {
+  return new Promise(resolve => {
+    let done = false;
+    const socket = net.createConnection(socketPath);
+    const finish = delivered => { if (done) return; done = true; clearTimeout(timer); socket.destroy(); resolve(delivered); };
+    const timer = setTimeout(() => finish(false), timeoutMs); timer.unref?.();
+    socket.on('error', () => finish(false));
+    socket.on('connect', () => socket.write(`${JSON.stringify(request)}\n`));
+    socket.on('data', () => finish(true));
+    socket.on('end', () => finish(false));
+  });
+}
+export async function sendHerdrRequest(socketPath, request) {
+  if (!await sendOnce(socketPath, request, 500)) await sendOnce(socketPath, request, 1500);
+}
+
+// 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 } = {}) {
+  return (pi) => {
+    let 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;
+      sending = true;
+      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 } : {}) } });
+        }
+      } finally { sending = false; if (queued) void drain(); }
+    };
+    const publish = (force = false) => {
+      const next = desired();
+      if (!force && next.state === last?.state && next.message === last?.message) return;
+      last = next; queued = { ...next, seq: ++seq }; void drain();
+    };
+    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 changed = JSON.stringify(argv) !== JSON.stringify(resumeArgv);
+      resumeArgv = argv ?? undefined;
+      return changed;
+    };
+    pi.events?.on?.('herdr:blocked', data => {
+      if (data?.active) { blocked += 1; label = data.label; } else { blocked = Math.max(0, blocked - 1); if (!blocked) label = undefined; }
+      publish();
+    });
+    // /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('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(); });
+  };
+}

package/packages/piagent-core/managed/store.d.mts

@@ -3,3 +3,4 @@ export function storedSlot(root: string, slot: string): string | null;
 export function resolveStore(root: string, slot: string, identity: { origin: unknown; userId: unknown }): string;
 export function agentWatchDataDirectory(home: string, environment?: Readonly<Record<string, string | undefined>>): string;
 export function interopEnvironment(environment?: Readonly<Record<string, string | undefined>>): Record<string, string>;
+export function companySessionFile(sessionsDir: string, file: string): string | null;

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

@@ -74,3 +74,16 @@ export function resolveStore(root, slot, { origin, userId }) {
   for (const name of new Set([slot, store])) { write(path.join(root, name, 'member'), member); write(path.join(root, name, 'store'), store); }
   return store;
 }
+
+// A conversation `piagent studio --session` reopens (Herdr's restore names
+// one): only a file of this store's sessions folder. Null when the file was
+// never written (a conversation with no message yet): a new one starts.
+export function companySessionFile(sessionsDir, file) {
+  const target = path.resolve(String(file));
+  if (!target.endsWith('.jsonl')) throw Error('managed-session-outside-store');
+  const real = candidate => { try { return fs.realpathSync(candidate); } catch { return null; } };
+  const found = real(target), root = real(sessionsDir) ?? path.resolve(sessionsDir);
+  const resolved = found ?? path.join(real(path.dirname(target)) ?? path.dirname(target), path.basename(target));
+  if (!resolved.startsWith(root + path.sep)) throw Error('managed-session-outside-store');
+  return found && fs.statSync(found).isFile() ? found : null;
+}

package/packages/piagent-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piagent/core",
-  "version": "1.44.3",
+  "version": "1.45.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" };
   });
 }