@piagent/platform 1.33.0 → 1.34.1

package/docs-site/en/security.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/security" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/security" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/team.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/team" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/team" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/whats-new.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/whats-new" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/whats-new" hreflang="en" lang="en" aria-current="true">EN</a>
@@ -104,6 +104,12 @@
               <h1>1.9.0: ask in plain language, the team's Harness checks</h1>
               <p>The task contract and workflow commands are gone. Company mode asks for checks and a review on its own; Stop, network commands on approval and clearer approval cards.</p>
             </div>
+<section class="section">
+  <p class="section-kicker">v1.34.1 · 2026-10-20</p>
+  <h2 id="v1-34-1">Helpers report how their work ended, Agent Watch tells you when you are needed</h2>
+  <p class="section-lead">Every subagent run reports how it ended: done, failed, stopped or unverifiable (for example a verify with no verdicts), and Studio shows it in Logs → Lượt agent. When it hands work to a subagent, the agent can state the target, the change, the constraints, what the subagent may touch and the evidence it needs. Agent Watch (macOS 0.15.9, Windows 0.1.15) tells you when a conversation waits for your approval or your answer, or when the agent is done; the state file holds only the conversation's title and project name. In Source Changes you can comment any line of the diff and send all comments to the agent as one message with each file and line; the review subagent's findings show under the line they are about. Piagent asks Studio what it serves before using a newer feature (Agent Studio 0.34).</p>
+</section>
+
 <section class="section">
   <p class="section-kicker">v1.33.0 · 2026-10-20</p>
   <h2 id="v1-33-0">Runs on Pi 1.3.0</h2>

package/docs-site/en/windows.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/windows" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/windows" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/workflows.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/workflows" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/workflows" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/index.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/" hreflang="en" lang="en">EN</a>
@@ -94,7 +94,7 @@
       <main>
         <div class="content-shell" data-article>
 <section class="hero">
-  <p class="eyebrow">Piagent 1.33.0</p>
+  <p class="eyebrow">Piagent 1.34.1</p>
   <h1>Coding agent cho cả team, kiểm tra từng bước.</h1>
   <p>
     Một dashboard cho Terminal và trình duyệt. Dùng model bằng tài khoản của bạn, hoặc model của công ty qua Agent Watch và Agent Studio. Guard kiểm tra từng tool call; ở chế độ công ty, Harness của team tự yêu cầu chạy check, cho subagent review và báo kết quả ngay dưới câu trả lời.
@@ -108,7 +108,7 @@
   <div class="hero-actions">
     <a class="button primary" href="/quickstart">Bắt đầu</a>
     <a class="button" href="/ecosystem">Hệ sinh thái</a>
-    <a class="button" href="/whats-new">Có gì mới trong 1.33.0</a>
+    <a class="button" href="/whats-new">Có gì mới trong 1.34.1</a>
     <a class="button" href="/commands">Xem command</a>
   </div>
 </section>
@@ -184,9 +184,9 @@ piagent-setup</code></pre>
   <h2 id="bat-dau-tu-dau">Bắt đầu từ đâu</h2>
   <div class="card-grid">
     <a class="doc-card" href="/whats-new">
-      <span class="card-kicker">Bản 1.33.0</span>
+      <span class="card-kicker">Bản 1.34.1</span>
       <h3>Có gì mới</h3>
-      <p>Chạy trên Pi 1.3.0; ở 1.32.1: Bypass được giữ sau khi tải lại, tab đang dùng không còn bị đăng xuất sau 8 giờ; ở 1.32.0: lượt lỗi hoặc bấm Stop được dừng cả ở Studio; ở 1.31.1: <code>memory_ask</code> có ngay sau khi cập nhật; ở 1.31.0: Memory của team đi theo branch và luật của team, có <code>memory_ask</code>; ở 1.30.1: Terminal công ty không còn hiện tên model, mở <code>piagent studio</code> ở thư mục home báo rõ cần vào thư mục dự án; ở 1.30.0: context lớn đi qua mạng chậm, Terminal công ty gọn như dashboard; ở 1.29.0: Terminal công ty có giao diện riêng, dừng lượt không còn làm hỏng cuộc trò chuyện; ở 1.28.3: Agent Watch tự cập nhật không còn làm gián đoạn Terminal công ty; ở 1.28.2: không còn lỗi “binding changed” ngay sau khi cập nhật; ở 1.28.1: Terminal công ty và Pi cá nhân không còn giẫm chân nhau (không nạp Piagent hai lần, dọn cấu hình công ty cũ, cuộc trò chuyện công ty chỉ mở bằng piagent studio); ở 1.28.0: team memory v2; ở 1.27.1: team memory chạy ổn cả khi agent đang gọi model; ở 1.27.0: team memory, agent công ty nhớ quyết định và quy tắc của team trong từng repo; ở 1.26.1: đổi tên cuộc trò chuyện được cả khi lượt đang chạy; ở 1.26.0: lệnh / và phím tắt của Terminal ngay trên dashboard, /undo hoàn tác lượt trước của agent, dev server chạy qua nhiều lượt; ở 1.25.0: thiếu môi trường thì agent xin quyền và chạy được sau khi bạn duyệt (run_on_host ngoài sandbox, start_docker mở Docker ngay trong cuộc trò chuyện); ở 1.24.0: chọn Fast ngay trên trang tạo cuộc trò chuyện công ty, nút Fast đổi màu vàng khi đang bật; ở 1.23.1: câu hỏi của agent luôn nằm cuối cuộc trò chuyện, ngay trên ô nhập, và dễ đọc hơn; ở 1.23.0: nút Fast cho cuộc trò chuyện công ty khi Harness cho phép, tool lỗi được báo về Studio (Logs → Tool lỗi), cuộc trò chuyện mới gửi được tin nhắn đầu sau khi Harness đổi; ở 1.22.1: dashboard không còn quay mãi khi project nằm trên ổ Windows nhìn từ WSL (/mnt/d…) hoặc phiên công ty không trả lời; ở 1.22.0: đính kèm được mọi file code và văn bản (.html, .css, .ts, .py, Dockerfile…); ở 1.21.1: bật Bypass được cả khi lượt đang chạy và được giữ sau khi tải lại; ở 1.21.0: câu hỏi và yêu cầu duyệt hiện từng cái một (main agent trước), thông báo góc phải khi cuộc trò chuyện khác xong hay đang chờ bạn, Studio ghi lại mỗi lần compact; ở 1.20.0: cài package trong sandbox công ty không phải duyệt (npm, PyPI, Go, Maven, Gradle… qua proxy chỉ cho registry); ở 1.19.0: task công ty có checklist được làm đến hết, cuối mỗi lượt báo rõ xong, dừng giữa chừng hay lỗi, Docker trong sandbox công ty, folder chứa nhiều repo; ở 1.18.0: đổi nhánh Git trên dashboard, tự thử lại khi lỗi tạm thời, Claude Haiku 5.5; ở 1.17.0: dashboard hiện nhánh Git của project; ở 1.16.3: dashboard cập nhật xong vẫn tự kiểm tra bản mới; ở 1.16.2: Terminal nói giống dashboard: hỏi cập nhật, /bypass, lỗi và ghi chú Harness bằng tiếng Việt; ở 1.16.1: bản mới được báo bằng dialog và kiểm tra mỗi giờ, tab dashboard không còn mất đăng nhập; ở 1.16.0: Bypass cho cuộc trò chuyện công ty, đổi Harness không làm gián đoạn; ở 1.15.2: cuộc trò chuyện dài tự thu gọn trở lại; ở 1.15.1: Studio thấy mỗi call của model dùng để làm gì, nhiều cuộc trò chuyện trong một folder không nhận nhầm thay đổi của nhau; ở 1.15.0: subagent bị từ chối nói đúng lý do; ở 1.14: cập nhật giữ model bạn đã chọn; ở 1.13: cuộc trò chuyện giữ chỗ đang đọc, chữ của agent có định dạng, Piagent trên Windows qua WSL2: sandbox công ty bằng bubblewrap và Agent Watch cho Windows; ở 1.12: @ chọn file và folder trên máy, skill và command dùng bằng /, nhánh cuộc trò chuyện công ty gửi được tin nhắn.</p>
+      <p>Helper báo kết quả, Agent Watch báo khi cần bạn; ở 1.33.0: chạy trên Pi 1.3.0; ở 1.32.1: Bypass được giữ sau khi tải lại, tab đang dùng không còn bị đăng xuất sau 8 giờ; ở 1.32.0: lượt lỗi hoặc bấm Stop được dừng cả ở Studio; ở 1.31.1: <code>memory_ask</code> có ngay sau khi cập nhật; ở 1.31.0: Memory của team đi theo branch và luật của team, có <code>memory_ask</code>; ở 1.30.1: Terminal công ty không còn hiện tên model, mở <code>piagent studio</code> ở thư mục home báo rõ cần vào thư mục dự án; ở 1.30.0: context lớn đi qua mạng chậm, Terminal công ty gọn như dashboard; ở 1.29.0: Terminal công ty có giao diện riêng, dừng lượt không còn làm hỏng cuộc trò chuyện; ở 1.28.3: Agent Watch tự cập nhật không còn làm gián đoạn Terminal công ty; ở 1.28.2: không còn lỗi “binding changed” ngay sau khi cập nhật; ở 1.28.1: Terminal công ty và Pi cá nhân không còn giẫm chân nhau (không nạp Piagent hai lần, dọn cấu hình công ty cũ, cuộc trò chuyện công ty chỉ mở bằng piagent studio); ở 1.28.0: team memory v2; ở 1.27.1: team memory chạy ổn cả khi agent đang gọi model; ở 1.27.0: team memory, agent công ty nhớ quyết định và quy tắc của team trong từng repo; ở 1.26.1: đổi tên cuộc trò chuyện được cả khi lượt đang chạy; ở 1.26.0: lệnh / và phím tắt của Terminal ngay trên dashboard, /undo hoàn tác lượt trước của agent, dev server chạy qua nhiều lượt; ở 1.25.0: thiếu môi trường thì agent xin quyền và chạy được sau khi bạn duyệt (run_on_host ngoài sandbox, start_docker mở Docker ngay trong cuộc trò chuyện); ở 1.24.0: chọn Fast ngay trên trang tạo cuộc trò chuyện công ty, nút Fast đổi màu vàng khi đang bật; ở 1.23.1: câu hỏi của agent luôn nằm cuối cuộc trò chuyện, ngay trên ô nhập, và dễ đọc hơn; ở 1.23.0: nút Fast cho cuộc trò chuyện công ty khi Harness cho phép, tool lỗi được báo về Studio (Logs → Tool lỗi), cuộc trò chuyện mới gửi được tin nhắn đầu sau khi Harness đổi; ở 1.22.1: dashboard không còn quay mãi khi project nằm trên ổ Windows nhìn từ WSL (/mnt/d…) hoặc phiên công ty không trả lời; ở 1.22.0: đính kèm được mọi file code và văn bản (.html, .css, .ts, .py, Dockerfile…); ở 1.21.1: bật Bypass được cả khi lượt đang chạy và được giữ sau khi tải lại; ở 1.21.0: câu hỏi và yêu cầu duyệt hiện từng cái một (main agent trước), thông báo góc phải khi cuộc trò chuyện khác xong hay đang chờ bạn, Studio ghi lại mỗi lần compact; ở 1.20.0: cài package trong sandbox công ty không phải duyệt (npm, PyPI, Go, Maven, Gradle… qua proxy chỉ cho registry); ở 1.19.0: task công ty có checklist được làm đến hết, cuối mỗi lượt báo rõ xong, dừng giữa chừng hay lỗi, Docker trong sandbox công ty, folder chứa nhiều repo; ở 1.18.0: đổi nhánh Git trên dashboard, tự thử lại khi lỗi tạm thời, Claude Haiku 5.5; ở 1.17.0: dashboard hiện nhánh Git của project; ở 1.16.3: dashboard cập nhật xong vẫn tự kiểm tra bản mới; ở 1.16.2: Terminal nói giống dashboard: hỏi cập nhật, /bypass, lỗi và ghi chú Harness bằng tiếng Việt; ở 1.16.1: bản mới được báo bằng dialog và kiểm tra mỗi giờ, tab dashboard không còn mất đăng nhập; ở 1.16.0: Bypass cho cuộc trò chuyện công ty, đổi Harness không làm gián đoạn; ở 1.15.2: cuộc trò chuyện dài tự thu gọn trở lại; ở 1.15.1: Studio thấy mỗi call của model dùng để làm gì, nhiều cuộc trò chuyện trong một folder không nhận nhầm thay đổi của nhau; ở 1.15.0: subagent bị từ chối nói đúng lý do; ở 1.14: cập nhật giữ model bạn đã chọn; ở 1.13: cuộc trò chuyện giữ chỗ đang đọc, chữ của agent có định dạng, Piagent trên Windows qua WSL2: sandbox công ty bằng bubblewrap và Agent Watch cho Windows; ở 1.12: @ chọn file và folder trên máy, skill và command dùng bằng /, nhánh cuộc trò chuyện công ty gửi được tin nhắn.</p>
     </a>
     <a class="doc-card" href="/ecosystem">
       <span class="card-kicker">Get started</span>

package/docs-site/mcp-approval.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/mcp-approval" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/mcp-approval" hreflang="en" lang="en">EN</a>

package/docs-site/mcp-auth.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/mcp-auth" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/mcp-auth" hreflang="en" lang="en">EN</a>

package/docs-site/mcp-servers.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/mcp-servers" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/mcp-servers" hreflang="en" lang="en">EN</a>

package/docs-site/mcp.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/mcp" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/mcp" hreflang="en" lang="en">EN</a>

package/docs-site/permissions.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/permissions" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/permissions" hreflang="en" lang="en">EN</a>

package/docs-site/profiles.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/profiles" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/profiles" hreflang="en" lang="en">EN</a>

package/docs-site/quickstart.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/quickstart" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/quickstart" hreflang="en" lang="en">EN</a>

package/docs-site/runtime.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/runtime" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/runtime" hreflang="en" lang="en">EN</a>

package/docs-site/scope.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/scope" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/scope" hreflang="en" lang="en">EN</a>

package/docs-site/security.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/security" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/security" hreflang="en" lang="en">EN</a>

package/docs-site/team.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/team" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/team" hreflang="en" lang="en">EN</a>

package/docs-site/whats-new.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/whats-new" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/whats-new" hreflang="en" lang="en">EN</a>
@@ -104,6 +104,12 @@
               <h1>Bản 1.9.0: nói việc bằng lời, Harness của team kiểm tra</h1>
               <p>Bỏ task contract và lệnh workflow. Chế độ công ty tự yêu cầu check và review; nút Dừng, lệnh có mạng theo lần duyệt và thẻ duyệt dễ đọc hơn.</p>
             </div>
+<section class="section">
+  <p class="section-kicker">v1.34.1 · 2026-10-20</p>
+  <h2 id="v1-34-1">Helper báo kết quả, Agent Watch báo khi cần bạn</h2>
+  <p class="section-lead">Mỗi lần subagent chạy xong đều báo rõ kết quả: xong, lỗi, đã dừng hay chưa rõ (ví dụ verify không trả về kết luận), và Studio hiện kết quả đó trong Logs → Lượt agent. Khi giao việc cho subagent, agent có thể ghi rõ phạm vi, việc cần làm, ràng buộc, phần được phép đụng và bằng chứng cần có. Agent Watch (macOS 0.15.9, Windows 0.1.15) báo khi một cuộc trò chuyện đang chờ bạn duyệt, đang hỏi bạn, hoặc khi agent xong việc; file trạng thái chỉ có tên cuộc trò chuyện và tên project. Trong Source Changes, bạn bấm số dòng để comment trên diff rồi gửi tất cả cho agent thành một tin nhắn có đúng file và dòng; kết quả của subagent review hiện ngay dưới dòng nó nói tới. Piagent hỏi Studio những gì nó hỗ trợ trước khi dùng tính năng mới (cần Agent Studio 0.34).</p>
+</section>
+
 <section class="section">
   <p class="section-kicker">v1.33.0 · 2026-10-20</p>
   <h2 id="v1-33-0">Chạy trên Pi 1.3.0</h2>

package/docs-site/windows.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/windows" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/windows" hreflang="en" lang="en">EN</a>

package/docs-site/workflows.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.33.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.34.1 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/workflows" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/workflows" hreflang="en" lang="en">EN</a>

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

@@ -256,8 +256,8 @@
     },
     {
       "path": "tests",
-      "fileCount": 557,
-      "sha256": "136770e85747449c937965d34d5dbb27028732604c7856547c57234484d00738"
+      "fileCount": 561,
+      "sha256": "ceda4bf84ab79c6b4c921c5827917351f38abe0524f76008ad224de1197fdada"
     }
   ],
   "custodianComparisonRules": {

package/package.json

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

package/packages/piagent-core/managed/helper-run.mjs

@@ -14,6 +14,7 @@ import { anchorText, relayObjection, recordVerdicts } from './objections.mjs';
 import { HELPER_CALLS, HELPER_SETUP, READ_TOOLS, countedCheck } from './helper-roles.mjs';
 import { trackToolFailures } from './tool-failures.mjs';
 import { helperMemoryTools, renewer } from './memory.mjs';
+import { answeredSettlement, failedSettlement, settleHelper, OUTCOME_WORDS } from './helper-settlement.mjs';
 
 const textContent = result => result.content?.filter(p => p.type === 'text').map(p => p.text).join('\n') ?? '';
 // A helper failure that another model of its role may not have: the model's
@@ -68,8 +69,8 @@ async function helperAttempt(managed, role, task, signal, harness, snapshot, par
     try { verifyGrant(grant, managed.manifest, role); }
     catch (error) { try { await managed.broker.request('close', { role }); } catch { /* closes with the run */ } throw error; }
   } catch (error) { throw Error(`managed-helper-failed: ${describeFailure(role, failureText(error))}`); }
-  let boundary;
-  const sessions = new Set();
+  let boundary, report = null;
+  const sessions = new Set(), spec = managed.helperSpecs?.get(role) ?? {};
   try {
     const runtime = await managed.api.ModelRuntime.create({ credentials: new managed.ai.InMemoryCredentialStore(), modelsPath: null, refreshOnCreate: false, allowModelNetwork: false });
     const model = managed.installModel(runtime, grant); managed.wrapStreams(runtime, role);
@@ -130,10 +131,17 @@ async function helperAttempt(managed, role, task, signal, harness, snapshot, par
       managed.session.sessionManager.appendCustomEntry('agent-watch-review', details);
     }
     const verdicts = role === 'verify' ? recordVerdicts(managed.run, reply, harness, details) : '';
+    report = answeredSettlement(role, reply, details, spec); details.outcome = report.outcome;
     await managed.session.sendCustomMessage({ customType: 'agent-watch-helper-receipt', display: true,
-      content: `${setup.label}: ${usage.toLocaleString('en-US')} tokens${verdicts}${review ? ` · ${parts.parts.length} parts` : ''}${snapshot ? (stale ? ' · review is stale' : ' · patch ' + snapshot.digest.slice(0, 12)) : ''}.`, details }, { triggerTurn: false });
+      content: `${setup.label}: ${usage.toLocaleString('en-US')} tokens${verdicts}${review ? ` · ${parts.parts.length} parts` : ''}${snapshot ? (stale ? ' · review is stale' : ' · patch ' + snapshot.digest.slice(0, 12)) : ''} · ${OUTCOME_WORDS[report.outcome]}.`, details }, { triggerTurn: false });
     // An objection to the brief comes with the answer; a stale review has none to act on.
     const objection = stale ? '' : await relayObjection(managed, role, reply, harness);
-    return { content: [{ type: 'text', text: stale ? 'Review is stale: the patch changed during review. Obtain a new review for the current patch.' : reply + objection }], details };
-  } finally { for (const session of sessions) session.dispose(); await boundary?.dispose(); await managed.broker.request('close', { role }); }
+    const ending = `Outcome: ${report.outcome}${report.outcome === 'unverifiable' ? ` (${report.summary})` : ''}.\n\n`;
+    return { content: [{ type: 'text', text: ending + (stale ? 'Review is stale: the patch changed during review. Obtain a new review for the current patch.' : reply + objection) }], details };
+  } catch (error) { report = failedSettlement(role, error, signal, spec); throw error; }
+  finally {
+    for (const session of sessions) session.dispose(); await boundary?.dispose();
+    await settleHelper(managed, grant, report); // with the attempt's own token, before its role closes
+    await managed.broker.request('close', { role });
+  }
 }

package/packages/piagent-core/managed/helper-settlement.mjs

@@ -0,0 +1,92 @@
+// How a helper's attempt ended (Agent Studio 0.34+, POST /v1/managed/settle):
+// one report per attempt, sent with the helper's own run token before its
+// role closes. succeeded: the helper did its job and answered in the form its
+// role needs (verify's verdicts, review's findings); failed: it could not
+// (an error); cancelled: the member or the main agent stopped it;
+// unverifiable: it answered without what its role needs, or its review went
+// stale. Studio reads a helper role that closed without a report as
+// unverifiable: absence is never success or failure.
+import { CLIENT_AGENT } from './client-agent.mjs';
+import { hasCapability } from './studio-capabilities.mjs';
+import { HELPER_ROLES } from './helper-roles.mjs';
+
+// The task as the main agent gives it: five optional fields beside the brief.
+export const SPEC_FIELDS = Object.freeze({
+  target: 'The files, component or environment in scope.',
+  change: 'What the helper should find, check or judge.',
+  constraints: 'What must hold, and what is out of bounds.',
+  ownership: 'What the helper may read or run, and what is someone else\'s.',
+  acceptance: 'The evidence that answers the task (for example file:line facts, a passing check, a cited source).',
+});
+const field = description => ({ type: 'string', maxLength: 1000, description });
+export function delegateParameters() {
+  return { type: 'object', properties: { role: { type: 'string', enum: HELPER_ROLES },
+    title: { type: 'string', maxLength: 120, description: 'One line naming the job, for the company logs (for example "Find where login tokens are stored").' },
+    task: { type: 'string', minLength: 1, maxLength: 12000 },
+    ...Object.fromEntries(Object.entries(SPEC_FIELDS).map(([name, description]) => [name, field(description)])),
+    since: { type: 'string', maxLength: 200, description: 'Review only: the commit, branch or HEAD~N the work to review started from (work committed in earlier turns).' } },
+  required: ['role', 'task'], additionalProperties: false };
+}
+export const SPEC_PROMPT = ' Give a helper target and acceptance at least (also change, constraints and ownership when they matter): it answers against them, and its ending is recorded with them.';
+
+// The delegate call as the helper reads it: the structured fields head the
+// brief; the main agent's task follows. The spec is kept for the settlement.
+export function delegateArgs(self, args) {
+  const spec = Object.fromEntries(Object.keys(SPEC_FIELDS).map(k => [k, typeof args?.[k] === 'string' ? args[k].trim().slice(0, 1000) : '']).filter(([, v]) => v));
+  (self.helperSpecs ??= new Map()).set(args?.role, spec);
+  if (!Object.keys(spec).length) return args;
+  const head = Object.entries(spec).map(([k, v]) => `${k[0].toUpperCase()}${k.slice(1)}: ${v}`).join('\n');
+  return { ...args, task: `${head}\n\n${args.task}`.slice(0, 12000) };
+}
+
+const jsonBlock = reply => {
+  const blocks = [...String(reply).matchAll(/```json\s*([\s\S]*?)```/g)].map(m => m[1]);
+  for (const raw of blocks.reverse()) { try { const v = JSON.parse(raw); if (v && typeof v === 'object') return v; } catch { /* next */ } }
+  return null;
+};
+const clip = (s, n) => { const t = String(s ?? '').replace(/\s+/g, ' ').trim(); return t.length > n ? t.slice(0, n - 1) + '…' : t; };
+const FILE_LINE = /(?:^|[\s`("'])((?:[\w@.-]+\/)*[\w@.-]+\.[A-Za-z0-9]+):(\d+)/g;
+
+// The report of an attempt that answered.
+export function answeredSettlement(role, reply, details = {}, spec = {}) {
+  const parsed = jsonBlock(reply);
+  const prose = String(reply).replace(/```[\s\S]*?```/g, ' ').split('\n').map(l => l.replace(/^[#>*\-\s]+/, '').trim()).find(l => l.length > 0) ?? '';
+  const summary = clip(typeof parsed?.summary === 'string' && parsed.summary.trim() ? parsed.summary : prose || `${role} answered.`, 600);
+  const evidence = [], files = new Set();
+  let outcome = 'succeeded';
+  if (role === 'verify') {
+    const verdicts = Array.isArray(parsed?.verdicts) ? parsed.verdicts : null;
+    if (!verdicts) outcome = 'unverifiable';
+    for (const v of verdicts ?? []) evidence.push(clip(`${v?.status ?? '?'}: ${v?.claim ?? ''} — ${v?.evidence ?? ''}`, 300));
+  } else if (role === 'review') {
+    if (details.stale) outcome = 'unverifiable';
+    else if (details.parsed === false) outcome = 'unverifiable';
+    for (const f of details.findings ?? []) { evidence.push(clip(`${f.severity} ${f.file ?? ''}:${f.line ?? ''} ${f.issue ?? ''}`, 300)); if (f.file) files.add(String(f.file)); }
+  }
+  for (const m of String(reply).matchAll(FILE_LINE)) {
+    files.add(m[1].replace(/^\.\//, ''));
+    if (role !== 'verify' && role !== 'review' && evidence.length < 8) evidence.push(clip(`${m[1]}:${m[2]}`, 300));
+  }
+  return { outcome, summary: details.stale ? 'The patch changed during review; this review is stale.' : summary,
+    evidence: [...new Set(evidence.filter(Boolean))].slice(0, 8), files: [...files].filter(f => f.length <= 300).slice(0, 50), ...(Object.keys(spec ?? {}).length ? { spec } : {}) };
+}
+
+// The report of an attempt that ended without an answer.
+export function failedSettlement(role, error, signal, spec = {}) {
+  const cancelled = signal?.aborted || /managed-helper-cancelled/.test(String(error?.message));
+  return { outcome: cancelled ? 'cancelled' : 'failed', summary: clip(cancelled ? `The ${role} subagent was stopped.` : `The ${role} subagent failed: ${String(error?.message ?? 'unknown error').replace(/^managed-helper-failed:\s*/, '')}`, 600),
+    evidence: [], files: [], ...(Object.keys(spec ?? {}).length ? { spec } : {}) };
+}
+
+// Sends the report with the attempt's own token; never fails the helper.
+export async function settleHelper(managed, grant, report, fetchImpl = (...args) => globalThis.fetch(...args)) {
+  if (!report || !grant?.token || !hasCapability(managed, 'managed.settle.v1')) return false;
+  try {
+    const response = await fetchImpl(`${managed.origin}/v1/managed/settle`, { method: 'POST', signal: AbortSignal.timeout(3_000),
+      headers: { Authorization: `Bearer ${grant.token}`, 'Content-Type': 'application/json', 'User-Agent': CLIENT_AGENT }, body: JSON.stringify(report) });
+    void response.body?.cancel?.().catch(() => {});
+    return response.ok;
+  } catch { return false; }
+}
+
+export const OUTCOME_WORDS = { succeeded: 'done', failed: 'failed', cancelled: 'stopped', unverifiable: 'unverifiable' };

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

@@ -7,7 +7,7 @@ import path from 'node:path';
 import { randomUUID } from 'node:crypto';
 import { MemoryOutbox, memoryScope, scopeID } from './memory-outbox.mjs';
 import { CheckLessons } from './memory-lessons.mjs';
-import { CLIENT_AGENT } from './client-agent.mjs';
+import { CLIENT_AGENT } from './client-agent.mjs'; import { knownCapabilities, refreshCapabilities } from './studio-capabilities.mjs';
 import { redactedText } from '../runtime/managed-failure.mjs';
 import { git, repoKey, repositoryAt, findRepositories, topDirs, eventFor, commitChanges } from './memory-repos.mjs';
 import { PAGE_NAMES, renewer, memoryTools } from './memory-tools.mjs';
@@ -452,15 +452,15 @@ export function trackMemoryLessons(self) {
 // Whether this conversation has team memory now: Studio answered memory for
 // this key recently and has not switched it off since (the Terminal's header).
 export const memoryOn = self => !!self?.memory?.stateDir && self.memory.active && TeamMemory.known(self.memory.stateDir, self.origin, memoryScope(self.origin, self.manifest));
-// memory_ask is offered whenever the conversation has team memory. The
-// protocol this Mac last heard was recorded before a Studio upgrade, so it
-// cannot decide; on a Studio without /v1/memory/ask the tool says to use
-// memory_search instead (ask() does not turn memory off on a 404).
-const speaksAsk = () => true;
-export const memoryToolsFor = (self, agentDir) => agentDir && TeamMemory.known(agentDir, self.origin, memoryScope(self.origin, self.manifest)) ? memoryTools(self, { ask: speaksAsk() }) : [];
+// memory_ask is offered unless this Studio listed its capabilities without
+// memory.ask.v1 (studio-capabilities.mjs). With no list heard (a Studio older
+// than 0.34) it is offered; on a Studio without /v1/memory/ask the tool says
+// to use memory_search instead (ask() does not turn memory off on a 404).
+const speaksAsk = (self, agentDir) => knownCapabilities(agentDir ?? self.memory?.stateDir, self.origin, self.manifest)?.has('memory.ask.v1') ?? true;
+export const memoryToolsFor = (self, agentDir) => agentDir && TeamMemory.known(agentDir, self.origin, memoryScope(self.origin, self.manifest)) ? memoryTools(self, { ask: speaksAsk(self, agentDir) }) : [];
 // A helper (scout, research, verify, review) reads the team memory with its own run token; it never writes.
 export const helperMemoryTools = (managed, grant, renew) => managed.memory?.stateDir && TeamMemory.known(managed.memory.stateDir, managed.origin, memoryScope(managed.origin, managed.manifest))
-  ? memoryTools(managed, { pages: false, ask: speaksAsk(), grant, renew }) : [];
+  ? memoryTools(managed, { pages: false, ask: speaksAsk(managed), grant, renew }) : [];
 export async function openRound(self, manager, text) {
   if (!self.memory) return;
   self.memory.stats = {};
@@ -475,7 +475,7 @@ export async function openRound(self, manager, text) {
     if (fresh && !scopedBrief(messages, self.memory.scopeHash)) {
       await self.session.sendCustomMessage({ customType: MEMORY_ENTRY, content: fresh.content, details: fresh.details, display: false }, { triggerTurn: false });
     }
-    self.memory.startBackground(self.grant);
+    self.memory.startBackground(self.grant); if (self.memory.stateDir) void refreshCapabilities(self, self.grant, { agentDir: self.memory.stateDir });
   } catch { /* memory is optional */ }
 }
 export async function closeRound(self) {

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, planTool, currentPlan, PLAN_ENTRY, workflowPrompt, RunProcess, completionGate, pendingBaseline, pendingPaths, pendingHead, processEditTools } from './workflow.mjs';
 import { beforeDelegate } from './objections.mjs';
-import { HELPER_CALLS, HELPER_ROLES, helperRoles, helperPrompt, webPrompt, delegateDescription } from './helper-roles.mjs';
+import { HELPER_CALLS, HELPER_ROLES, helperRoles, helperPrompt, webPrompt, delegateDescription } from './helper-roles.mjs'; import { delegateParameters, delegateArgs, SPEC_PROMPT } from './helper-settlement.mjs';
 import { loadAgentResources } from './agent-skills.mjs';
 import { restorePermission, permissionSetter } from './permission.mjs';
 import { commandTools, servicesPrompt } from './command-tools.mjs'; import { attachMemory, memoryToolsFor, openRound, closeRound, prepareMemoryContext, trackMemoryLessons } from './memory.mjs';
@@ -123,9 +123,9 @@ export class ManagedSession {
     // turn, names the Harness's current helpers; delegate refuses one the
     // Harness does not have.
     const roles = helperRoles(manifest);
-    if (roles.length) customTools.push({ name: 'delegate', label: 'Subagent', description: delegateDescription(roles),
-      parameters: { type: 'object', properties: { role: { type: 'string', enum: HELPER_ROLES }, title: { type: 'string', maxLength: 120, description: 'One line naming the job, for the company logs (for example "Find where login tokens are stored").' }, task: { type: 'string', minLength: 1, maxLength: 12000 }, since: { type: 'string', maxLength: 200, description: 'Review only: the commit, branch or HEAD~N the work to review started from (work committed in earlier turns).' } }, required: ['role', 'task'], additionalProperties: false },
-      execute: (_id, args, signal) => self.delegate(args, signal) });
+    if (roles.length) customTools.push({ name: 'delegate', label: 'Subagent', description: delegateDescription(roles) + SPEC_PROMPT,
+      parameters: delegateParameters(), // the brief and its structured fields (helper-settlement.mjs)
+      execute: (_id, args, signal) => self.delegate(delegateArgs(self, args), signal) });
     customTools.push(planTool(async plan => {
       self.session.sessionManager.appendCustomEntry(PLAN_ENTRY, { ...plan, at: new Date().toISOString() });
       if (self.run) self.run.planUpdated = true;

package/packages/piagent-core/managed/studio-capabilities.mjs

@@ -0,0 +1,60 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { CLIENT_AGENT } from './client-agent.mjs';
+import { memoryScope, scopeID } from './memory-outbox.mjs';
+
+// What this Studio serves beyond the base API (GET /v1/capabilities, Agent
+// Studio 0.34+): one name per contract and version, such as
+// "requests.cancel.v1" or "memory.v3". Piagent uses a newer operation only
+// when its name is listed. A Studio without the route (404, older than
+// 0.34) has no list: callers keep their old behaviour for it. Names Piagent
+// does not know are ignored; a failed read keeps the last answer this Mac
+// had for the same Studio scope. Asked when a round
+// starts, at most once an hour, kept in <agentDir>/studio-capabilities.json.
+const FRESH_MS = 3_600_000, KEEP_MS = 7 * 24 * 3_600_000, TIMEOUT_MS = 3_000;
+const NAME = /^[a-z][a-z0-9-]*(\.[a-z0-9-]+)*\.v[0-9]+$/;
+const FILE = 'studio-capabilities.json';
+
+function read(stateDir, scope, now) {
+  try {
+    const k = JSON.parse(fs.readFileSync(path.join(stateDir, FILE), 'utf8'));
+    if (k.scope !== scopeID(scope) || !k.scope || (k.names !== null && !Array.isArray(k.names)) || now - k.at > KEEP_MS) return null;
+    return k;
+  } catch { return null; }
+}
+
+// The capabilities last heard from this Studio scope on this Mac, or null
+// when there is no list (none heard, long ago, or a Studio older than 0.34).
+export function knownCapabilities(stateDir, origin, manifest, now = Date.now()) {
+  const scope = memoryScope(origin, manifest);
+  const k = stateDir && scope ? read(stateDir, scope, now) : null;
+  return k?.names ? new Set(k.names) : null;
+}
+
+export const hasCapability = (self, name) => !!self?.capabilities?.has(name);
+
+// Refreshes self.capabilities for the round's grant; never fails the round.
+export async function refreshCapabilities(self, grant, { agentDir = self.agentDir, fetchImpl = (...args) => globalThis.fetch(...args), now = Date.now() } = {}) {
+  const scope = memoryScope(self.origin, self.manifest);
+  const known = agentDir && scope ? read(agentDir, scope, now) : null;
+  if (known) self.capabilities = known.names ? new Set(known.names) : null;
+  if (known && now - known.at < FRESH_MS) return self.capabilities ?? null;
+  if (!grant?.token || !self.origin) return self.capabilities ?? null;
+  try {
+    const response = await fetchImpl(`${self.origin}/v1/capabilities`, { signal: AbortSignal.timeout(TIMEOUT_MS),
+      headers: { Authorization: `Bearer ${grant.token}`, Accept: 'application/json', 'User-Agent': CLIENT_AGENT } });
+    let names;
+    if (response.status === 404) { void response.body?.cancel?.().catch(() => {}); names = null; }
+    else if (response.ok) {
+      const answer = await response.json();
+      names = Array.isArray(answer?.capabilities) ? answer.capabilities.filter(n => typeof n === 'string' && NAME.test(n)).slice(0, 200) : [];
+    } else { void response.body?.cancel?.().catch(() => {}); return self.capabilities ?? null; }
+    self.capabilities = names ? new Set(names) : null;
+    if (agentDir && scope) {
+      const file = path.join(agentDir, FILE), temporary = `${file}.${process.pid}.tmp`;
+      fs.writeFileSync(temporary, JSON.stringify({ scope: scopeID(scope), at: now, names }), { mode: 0o600 });
+      fs.renameSync(temporary, file);
+    }
+  } catch { /* the last answer, if any, stays */ }
+  return self.capabilities ?? null;
+}

package/packages/piagent-core/package.json

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