@piagent/platform 1.26.0 → 1.27.0

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.26.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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,18 @@
               <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.27.0 · 2026-10-17</p>
+  <h2 id="v1-27-0">Team memory: company agents remember what the team settled in each repository</h2>
+  <p class="section-lead">With team memory turned on in Agent Studio 0.27.0, a new company conversation opens with a short brief from the team's memory of the repository (decisions, rules, work in progress from earlier conversations and commits). Every round is kept for the team (secrets redacted); the agent and its helpers search it with <span class="inline-code">memory_search</span>. A memory outage or a team without memory never fails or slows a turn.</p>
+</section>
+
+<section class="section">
+  <p class="section-kicker">v1.26.1 · 2026-10-16</p>
+  <h2 id="v1-26-1">A conversation is renamed while its turn runs</h2>
+  <p class="section-lead">Renaming a conversation from its menu while a turn ran (a company conversation in particular) showed <span class="inline-code">session-revision-stale</span> and kept the old name. The new name now lands mid-turn; when a rename, fork or archive still fails, the dialog says why in words.</p>
+</section>
+
 <section class="section">
   <p class="section-kicker">v1.26.0 · 2026-10-15</p>
   <h2 id="v1-26-0">Dashboard / commands and shortcuts, /undo, dev servers across turns</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.26.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0</p>
+  <p class="eyebrow">Piagent 1.27.0</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.26.0</a>
+    <a class="button" href="/whats-new">Có gì mới trong 1.27.0</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.26.0</span>
+      <span class="card-kicker">Bản 1.27.0</span>
       <h3>Có gì mới</h3>
-      <p>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>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.26.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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,18 @@
               <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.27.0 · 2026-10-17</p>
+  <h2 id="v1-27-0">Team memory: agent công ty nhớ những gì team đã chốt trong từng repo</h2>
+  <p class="section-lead">Khi team bật memory trên Agent Studio 0.27.0, cuộc trò chuyện công ty mới mở đầu bằng một bản tóm tắt ngắn từ memory của team về repo (quyết định, quy tắc, việc đang làm, rút từ hội thoại và commit trước đó). Mỗi lượt được lưu lại cho team (đã lọc secret); agent và subagent tìm được trong memory bằng <span class="inline-code">memory_search</span>. Memory lỗi hay tắt không bao giờ làm hỏng hay chậm một lượt.</p>
+</section>
+
+<section class="section">
+  <p class="section-kicker">v1.26.1 · 2026-10-16</p>
+  <h2 id="v1-26-1">Đổi tên cuộc trò chuyện được cả khi lượt đang chạy</h2>
+  <p class="section-lead">Đổi tên từ menu của cuộc trò chuyện trong lúc lượt đang chạy (nhất là cuộc trò chuyện công ty) từng hiện <span class="inline-code">session-revision-stale</span> và giữ tên cũ. Giờ tên mới được ghi ngay giữa lượt; nếu đổi tên, tạo nhánh hay lưu trữ vẫn không được, hộp thoại nói lý do bằng lời.</p>
+</section>
+
 <section class="section">
   <p class="section-kicker">v1.26.0 · 2026-10-15</p>
   <h2 id="v1-26-0">Lệnh / và phím tắt trên dashboard, /undo, dev server chạy qua nhiều lượt</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.26.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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.26.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.27.0 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": 547,
-      "sha256": "845f7c2abbea50453be655a8c88710ca49a8f62f2e58d0a02e29ab5c7319f92e"
+      "fileCount": 549,
+      "sha256": "f3d91ca724e78ae57b53be7433fa432d4b5d13844aab81b5635a39564ca133bf"
     }
   ],
   "custodianComparisonRules": {

package/package.json

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

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

@@ -13,6 +13,7 @@ import { reviewFindings, briefIssues } from './workflow.mjs';
 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 } from './memory.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
@@ -74,7 +75,7 @@ async function helperAttempt(managed, role, task, signal, harness, snapshot, par
     const model = managed.installModel(runtime, grant); managed.wrapStreams(runtime, role);
     // Studio's logs name the job by its title (the brief's first line without one).
     (managed.jobTitles ??= new WeakMap()).set(runtime, jobTitle(task, title));
-    const setup = HELPER_SETUP[role];
+    const setup = HELPER_SETUP[role], memory = helperMemoryTools(managed, () => grant);
     boundary = new ManagedToolBoundary({ cwd: managed.cwd, sdkRoot: managed.sdk, protectedRoots: managed.protectedRoots, readOnly: true, commands: setup.commands });
     const checks = role === 'verify' ? `\n\nRepository checks: ${managed.checks.commands.length ? managed.checks.commands.map(c => '`' + c + '`').join(', ') : 'none declared or detected; choose the tests, type check or build that cover the claims'}.` : '';
     // One helper session answers the brief (with one part of the patch for a
@@ -83,9 +84,9 @@ async function helperAttempt(managed, role, task, signal, harness, snapshot, par
     const ask = async extra => {
       const { session } = await managed.api.createAgentSession({ cwd: managed.cwd, model, modelRuntime: runtime, thinkingLevel: grant.effort || 'off',
         settingsManager: managed.api.SettingsManager.inMemory({ retry: { enabled: false, provider: { maxRetries: 0 } }, cacheWarming: 'off' }),
-        sessionManager: managed.api.SessionManager.inMemory(managed.cwd), noTools: 'builtin', tools: [...READ_TOOLS, ...(setup.commands ? ['bash'] : []), ...(setup.web ? ['web_search', 'web_fetch'] : [])],
+        sessionManager: managed.api.SessionManager.inMemory(managed.cwd), noTools: 'builtin', tools: [...READ_TOOLS, ...(setup.commands ? ['bash'] : []), ...(setup.web ? ['web_search', 'web_fetch'] : []), ...memory.map(tool => tool.name)],
         customTools: [...boundary.tools(managed.api).filter(tool => READ_TOOLS.includes(tool.name) || setup.commands && tool.name === 'bash').map(tool => countedCheck(managed, tool)),
-          ...(setup.web ? managed.webTools(runtime, role) : [])], resourceLoader: managedResourceLoader(managed.api, { systemPrompt: setup.prompt }) });
+          ...(setup.web ? managed.webTools(runtime, role) : []), ...memory], resourceLoader: managedResourceLoader(managed.api, { systemPrompt: setup.prompt }) });
       sessions.add(session); trackToolFailures(managed, session, role);
       const abort = () => void session.abort(); signal?.addEventListener('abort', abort, { once: true });
       try { if (signal?.aborted) throw Error('managed-helper-cancelled'); await session.prompt(anchorText(managed.session.sessionManager, harness) + task + checks + extra, { expandPromptTemplates: false }); }

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

@@ -0,0 +1,221 @@
+// Team memory for company conversations (Studio docs/team-memory/PLAN.md):
+// Studio keeps one memory per team and repository. On a conversation's first
+// round the agent gets a brief of what the team's earlier conversations and
+// commits say about the member's request; every round is sent back to grow
+// it; new commits are sent when HEAD moved. Everything goes through Studio on
+// the round's run token, and nothing here may fail or slow a turn: every call
+// is bounded, a failed write waits in a small outbox for the next round, and
+// Studio's 204 (memory off for the team) turns memory off for a while.
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFile } from 'node:child_process';
+import { CLIENT_AGENT } from './client-agent.mjs';
+import { redactedText } from '../runtime/managed-failure.mjs';
+
+export const MEMORY_ENTRY = 'agent-watch-memory';
+const BRIEF_MS = 5_000, WRITE_MS = 4_000, GIT_MS = 6_000, TOOL_MS = 10_000;
+const OFF_MS = 30 * 60_000, KNOWN_MS = 7 * 24 * 3600_000;
+const MAX_TURN = 30 * 1024, MAX_OUTBOX = 2 * 1024 * 1024, MAX_COMMITS = 300, MAX_GIT_BODY = 60 * 1024, MAX_COMMIT_BODY = 2_000;
+
+// The repository's identity: its origin remote without scheme, user, port
+// or ".git", lower case ("github.com/acme/shop"). null: no memory here.
+export function repoKey(remote) {
+  let s = String(remote ?? '').trim();
+  if (!s) return null;
+  const scp = /^[\w.-]+@([^:/]+):(.+)$/.exec(s); // git@github.com:acme/shop.git
+  if (scp) s = `${scp[1]}/${scp[2]}`;
+  else {
+    try { const u = new URL(s); if (!['http:', 'https:', 'ssh:', 'git:'].includes(u.protocol)) return null; s = `${u.hostname}${u.pathname}`; }
+    catch { return null; }
+  }
+  s = s.toLowerCase().replace(/\.git\/?$/, '').replace(/\/+$/, '').replace(/\/{2,}/g, '/');
+  return /^[a-z0-9][a-z0-9._-]*\/[a-z0-9._/-]+$/.test(s) && s.length <= 200 && !s.includes('..') ? s : null;
+}
+
+const git = (cwd, args, timeout = 3_000) => new Promise(resolve => execFile('git', ['-C', cwd, ...args], { timeout, maxBuffer: 4 << 20, encoding: 'utf8' },
+  (error, stdout) => resolve(error ? null : stdout)));
+
+const textOf = content => typeof content === 'string' ? content : Array.isArray(content) ? content.filter(p => p?.type === 'text').map(p => p.text).join('\n') : '';
+
+// One round as memory keeps it: what the member asked, the agent's final
+// answer and the files the conversation changed. Tool calls and their output
+// are left out.
+export function turnRecord(messages, changedFiles = []) {
+  const asked = messages.filter(m => m.role === 'user').map(m => textOf(m.content).trim()).filter(Boolean);
+  const answer = textOf(messages.findLast(m => m.role === 'assistant' && textOf(m.content).trim())?.content).trim();
+  if (!asked.length && !answer) return '';
+  const parts = [];
+  for (const a of asked) parts.push(`Member: ${a}`);
+  if (answer) parts.push(`${asked.length ? 'Agent' : 'Agent (continuing)'}: ${answer}`);
+  const files = [...changedFiles].slice(0, 40);
+  if (files.length) parts.push(`Files changed in this conversation: ${files.join(', ')}`);
+  // Studio redacts again; its own keys are not in the general patterns.
+  let text = redactedText(parts.join('\n\n')).replace(/\bas_(?:live|run)_[A-Za-z0-9_-]{8,}/g, '[REDACTED_SECRET]');
+  return Buffer.byteLength(text) > MAX_TURN ? Buffer.from(text).subarray(0, MAX_TURN - 3).toString('utf8').replace(/�*$/, '') + '…' : text;
+}
+
+export class TeamMemory {
+  constructor({ origin, cwd, stateDir, conversationId, fetchImpl = fetch, now = () => Date.now() }) {
+    Object.assign(this, { origin, cwd, stateDir, conversationId, fetchImpl, now, repo: undefined, offUntil: 0, retain: true, pendingGit: null, briefed: false });
+    this.outboxPath = stateDir ? path.join(stateDir, 'memory-outbox.jsonl') : null;
+    this.knownPath = stateDir ? path.join(stateDir, 'memory-known.json') : null;
+  }
+
+  // Memory answered for this Studio recently: the conversation gets the
+  // memory tools (their schema is fixed when it opens).
+  static known(stateDir, origin, now = Date.now()) {
+    try { const k = JSON.parse(fs.readFileSync(path.join(stateDir, 'memory-known.json'), 'utf8')); return k.origin === origin && now - k.at < KNOWN_MS; }
+    catch { return false; }
+  }
+  #remember(on) {
+    if (!this.knownPath) return;
+    try { if (on) fs.writeFileSync(this.knownPath, JSON.stringify({ origin: this.origin, at: this.now() })); else fs.rmSync(this.knownPath, { force: true }); } catch { /* best effort */ }
+  }
+
+  async repository() {
+    if (this.repo === undefined) this.repo = repoKey(await git(this.cwd, ['remote', 'get-url', 'origin']));
+    return this.repo;
+  }
+  get active() { return this.now() >= this.offUntil; }
+
+  async #post(grant, op, body, timeout) {
+    const response = await this.fetchImpl(`${this.origin}/v1/memory/${op}`, { method: 'POST', signal: AbortSignal.timeout(timeout),
+      headers: { Authorization: `Bearer ${grant.token}`, 'Content-Type': 'application/json', 'User-Agent': CLIENT_AGENT, 'X-Session-Id': grant.role_id },
+      body: JSON.stringify(body) });
+    // 204: memory is off for the team; 404: a Studio without team memory.
+    if (response.status === 204 || response.status === 404) { this.offUntil = this.now() + OFF_MS; this.#remember(false); return null; }
+    if (!response.ok) throw Error(`memory-${op}-${response.status}`);
+    this.#remember(true);
+    return response.json();
+  }
+
+  // The round's start: send what waited, and on a conversation's first
+  // round the brief (returned for the caller to add to the conversation).
+  async beforeRound(grant, prompt, hasBrief) {
+    if (!grant || !this.active || !(await this.repository())) return null;
+    await this.#drain(grant);
+    if (hasBrief || this.briefed || !this.active) return null;
+    this.briefed = true;
+    let brief;
+    try { brief = await this.#post(grant, 'brief', { repo_key: this.repo, prompt: String(prompt ?? '').slice(0, 2000) }, BRIEF_MS); }
+    catch { return null; }
+    if (!brief) return null;
+    this.retain = brief.retain_sessions !== false;
+    this.pendingGit = this.#sendGit(grant, brief.git_head ?? null).catch(() => {});
+    return { text: typeof brief.text === 'string' ? brief.text : '', facts: brief.facts ?? 0, pages: Array.isArray(brief.pages) ? brief.pages : [] };
+  }
+
+  async #sendGit(grant, known) {
+    const head = (await git(this.cwd, ['rev-parse', 'HEAD']))?.trim();
+    if (!/^[0-9a-f]{40}$/.test(head ?? '') || head === known) return;
+    const range = known && (await git(this.cwd, ['merge-base', '--is-ancestor', known, head]).then(out => out !== null)) ? [`${known}..${head}`] : [head];
+    const log = await git(this.cwd, ['log', `-n${MAX_COMMITS}`, '--no-merges', '--format=%H%x1f%cI%x1f%s%x1f%b%x1e', ...range], 5_000);
+    if (!log) return;
+    const commits = log.split('\x1e').map(r => r.trim()).filter(Boolean).map(r => { const [sha, date, subject, body = ''] = r.split('\x1f'); return { sha, date, subject, body: body.trim().slice(0, MAX_COMMIT_BODY) }; })
+      .filter(c => /^[0-9a-f]{40}$/.test(c.sha) && c.subject?.trim() && c.date);
+    if (!commits.length) return;
+    // Oldest first, in calls under the body cap; the head is recorded with the last.
+    commits.reverse();
+    for (let i = 0; i < commits.length;) {
+      const batch = []; let bytes = 0;
+      while (i < commits.length && (bytes += Buffer.byteLength(JSON.stringify(commits[i]))) < MAX_GIT_BODY) batch.push(commits[i++]);
+      if (!batch.length) batch.push(commits[i++]);
+      const last = i >= commits.length;
+      if (!(await this.#post(grant, 'git', { repo_key: this.repo, head: last ? head : batch.at(-1).sha, commits: batch }, GIT_MS))) return;
+    }
+  }
+
+  // The round's end, before its run closes: the round goes to memory, or to
+  // the outbox when Studio did not take it.
+  async afterRound(grant, messages, changedFiles) {
+    if (this.pendingGit) { await this.pendingGit; this.pendingGit = null; }
+    if (!grant || !this.active || !this.retain || !(await this.repository())) return;
+    const text = turnRecord(messages, changedFiles);
+    if (!text) return;
+    const item = { repo_key: this.repo, conversation_id: this.conversationId, text };
+    try { await this.#post(grant, 'retain', item, WRITE_MS); }
+    catch { this.#queue(item); }
+  }
+
+  #queue(item) {
+    if (!this.outboxPath) return;
+    try {
+      const size = fs.existsSync(this.outboxPath) ? fs.statSync(this.outboxPath).size : 0;
+      if (size + Buffer.byteLength(JSON.stringify(item)) > MAX_OUTBOX) return;
+      fs.mkdirSync(path.dirname(this.outboxPath), { recursive: true });
+      fs.appendFileSync(this.outboxPath, JSON.stringify(item) + '\n', { mode: 0o600 });
+    } catch { /* memory is optional */ }
+  }
+
+  async #drain(grant) {
+    if (!this.outboxPath || !fs.existsSync(this.outboxPath)) return;
+    let items;
+    try { items = fs.readFileSync(this.outboxPath, 'utf8').split('\n').filter(Boolean).map(l => JSON.parse(l)); fs.rmSync(this.outboxPath, { force: true }); }
+    catch { return; }
+    const left = [];
+    for (const [i, item] of items.entries()) {
+      if (i >= 5 || !this.active) { left.push(item); continue; }
+      try { await this.#post(grant, 'retain', item, WRITE_MS); } catch { left.push(item); }
+    }
+    for (const item of left) if (this.active) this.#queue(item);
+  }
+
+  async search(grant, query) {
+    if (!grant || !(await this.repository())) return 'Team memory is not available for this folder (no origin remote).';
+    try { return (await this.#post(grant, 'search', { repo_key: this.repo, query }, TOOL_MS))?.text ?? 'Team memory is off for this team.'; }
+    catch { return 'Team memory did not answer; go on without it.'; }
+  }
+  async page(grant, name) {
+    if (!grant || !(await this.repository())) return 'Team memory is not available for this folder (no origin remote).';
+    try {
+      const page = await this.#post(grant, 'page', { repo_key: this.repo, name }, TOOL_MS);
+      return page ? (page.markdown?.trim() || `The page "${name}" has no content yet.`) : 'Team memory is off for this team.';
+    } catch { return `No knowledge page named "${name}", or team memory did not answer.`; }
+  }
+}
+
+export const PAGE_NAMES = ['Component map', 'Core concepts', 'Conventions and patterns', 'Key decisions and rationale', 'Initiatives and work in progress'];
+
+// The agent's memory tools; helpers get only the search, on their own run.
+export function memoryTools(self, { pages = true, grant = () => self.grant } = {}) {
+  const tools = [{ name: 'memory_search', label: 'Team memory',
+    description: 'Search the team memory of this repository: decisions, rules and conventions from the team\'s earlier conversations and commits, and its knowledge pages. Use it before asking the member something the team may already have settled. Memory is a record of the past: check what it says against the code.',
+    parameters: { type: 'object', properties: { query: { type: 'string', minLength: 1, maxLength: 2000 } }, required: ['query'], additionalProperties: false },
+    execute: async (_id, args) => ({ content: [{ type: 'text', text: await self.memory.search(grant(), args.query) }], details: {} }) }];
+  if (pages) tools.push({ name: 'memory_page', label: 'Team knowledge page',
+    description: `Read one knowledge page the team memory keeps for this repository: ${PAGE_NAMES.join(', ')}.`,
+    parameters: { type: 'object', properties: { name: { type: 'string', enum: PAGE_NAMES } }, required: ['name'], additionalProperties: false },
+    execute: async (_id, args) => ({ content: [{ type: 'text', text: await self.memory.page(grant(), args.name) }], details: {} }) });
+  return tools;
+}
+
+// The brief as the conversation keeps it: a custom message the member does
+// not see; the model reads it as context before the member's message.
+export function briefMessage(brief) {
+  const pages = brief.pages.length ? `\n\nKnowledge pages (read with memory_page): ${brief.pages.join(', ')}.` : '';
+  return { customType: MEMORY_ENTRY, content: brief.text + pages, display: false, details: { facts: brief.facts } };
+}
+export const hasBrief = manager => manager.getEntries().some(e => (e.type === 'custom_message' || e.type === 'custom') && e.customType === MEMORY_ENTRY);
+
+// The managed session's three hooks (session.mjs): the memory and its tools
+// when the conversation opens, a round's start once its run is granted, and
+// a round's end while its run token is still valid. None can fail a turn.
+export function attachMemory(self, manager, agentDir) {
+  self.memory = new TeamMemory({ origin: self.origin, cwd: self.cwd, stateDir: agentDir ?? null, conversationId: manager.getSessionId() });
+  return self.memory;
+}
+export const memoryToolsFor = (self, agentDir) => agentDir && TeamMemory.known(agentDir, self.origin) ? memoryTools(self) : [];
+// A helper (scout, research, verify, review) reads the team memory with its own run token; it never writes.
+export const helperMemoryTools = (managed, grant) => managed.memory?.stateDir && TeamMemory.known(managed.memory.stateDir, managed.origin)
+  ? memoryTools(managed, { pages: false, grant }) : [];
+export async function openRound(self, manager, text) {
+  self.roundStart = self.session.messages.length;
+  try {
+    const brief = await self.memory?.beforeRound(self.grant, text, hasBrief(manager));
+    if (brief?.text) await self.session.sendCustomMessage(briefMessage(brief), { triggerTurn: false });
+  } catch { /* memory is optional */ }
+}
+export async function closeRound(self) {
+  if (!self.grant || self.preflight || !self.memory) return;
+  try { await self.memory.afterRound(self.grant, self.session.messages.slice(self.roundStart ?? 0), self.ownPaths); } catch { /* memory is optional */ }
+}

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

@@ -27,7 +27,7 @@ import { beforeDelegate } from './objections.mjs';
 import { HELPER_CALLS, HELPER_ROLES, helperRoles, helperPrompt, webPrompt, delegateDescription } from './helper-roles.mjs';
 import { loadAgentResources } from './agent-skills.mjs';
 import { restorePermission, permissionSetter } from './permission.mjs';
-import { commandTools, servicesPrompt } from './command-tools.mjs';
+import { commandTools, servicesPrompt } from './command-tools.mjs'; import { attachMemory, memoryToolsFor, openRound, closeRound } from './memory.mjs';
 
 const PROVIDER = 'agent_watch_managed';
 export const HELPER_BEAT_MS = 60_000;
@@ -132,14 +132,14 @@ export class ManagedSession {
       return { content: [{ type: 'text', text: `Plan updated: ${plan.plan.filter(p => p.status === 'completed').length}/${plan.plan.length} steps completed.` }], details: { plan: plan.plan } };
     }));
     // The member decides what the request leaves open: numbered options, or their own words.
-    customTools.push(askTool(self));
+    customTools.push(askTool(self), ...memoryToolsFor(self, agentDir)); // team memory's tools, once Studio answered memory here (memory.mjs)
     const agentsFiles = projectInstructions(self.cwd, self.boundary.repositoryTop);
     self.checks = repositoryChecks(agentsFiles, self.cwd, self.boundary.repositoryTop);
     // The Harness workflow (possibly changed on a later enrollment) adds its process to the prompt.
     const loader = managedResourceLoader(api, { systemPrompt: () => BASE_PROMPT + referencePrompt(self.boundary.userHome) + TEST_PROMPT + servicesPrompt(self.boundary) + webPrompt(helperRoles(manifest)) + helperPrompt(helperRoles(self.manifest)) + workflowPrompt(workflowPolicy(self.manifest), self.checks), agentsFiles,
       skills: self.resources.skills, prompts: self.resources.prompts, ...await inlineExtensions(api, sdk, self.cwd, terminalExtensions) });
     const settings = api.SettingsManager.inMemory({ retry: { enabled: false, provider: { maxRetries: 0 } }, cacheWarming: 'off', enableInstallTelemetry: false, enableAnalytics: false, enableSkillCommands: true });
-    const manager = sessionManager ?? api.SessionManager.inMemory(self.cwd);
+    const manager = sessionManager ?? api.SessionManager.inMemory(self.cwd); attachMemory(self, manager, agentDir);
     const scope = scopeOf(self.origin, manifest);
     const prior = manager.getEntries().filter(e => e.type === 'custom' && e.customType === 'agent-watch-scope').at(-1)?.data;
     // Under another member or another Studio a conversation still opens and
@@ -263,7 +263,7 @@ export class ManagedSession {
           const pending = pendingBaseline(manager);
           self.ownPaths = new Set(pending !== null ? pendingPaths(manager) : []);
           self.base = (pending !== null ? pendingHead(manager) : null) ?? await readHead(self.boundary);
-          self.run.startDigest = pending ?? await self.digest();
+          self.run.startDigest = pending ?? await self.digest(); await openRound(self, manager, text); // sends what waited; a new conversation gets the team brief
         } catch (error) { self.preflight = describeFailure('main', failureText(error)); }
         self.activePrompt = true;
       })();
@@ -286,7 +286,7 @@ export class ManagedSession {
         // The round's model work is over: a member message now waits for the next round.
         self.between = true;
         Object.assign(round, { planUpdated: !!self.run?.planUpdated, changed: !!self.run?.changed });
-        await Promise.allSettled([...self.helpers.values()]);
+        await Promise.allSettled([...self.helpers.values()]); await closeRound(self); // the round goes to team memory while its run token is valid
         // What a command left running in the background ends with the turn.
         try { await self.boundary.stopStrays(); } catch { /* best effort; the boundary stops them on close */ }
         await self.refreshReview();