@piagent/platform 1.28.0 → 1.28.1

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.28.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.1 · 2026-10-18</p>
+  <h2 id="v1-28-1">The company Terminal and personal Pi stop stepping on each other</h2>
+  <p class="section-lead">Personal Pi no longer fails to start when Piagent is loaded twice (an extension pointing into another Piagent copy): <span class="inline-code">piagent-update</span> and the installer remove it (with a backup) and <span class="inline-code">piagent-doctor</span> reports it. Old Agent Watch company entries in personal Pi (<span class="inline-code">agent_watch_*</span> providers, a default model naming them) are cleaned up once the machine has a company binding. Personal Pi no longer continues a company conversation and says to open it with <span class="inline-code">piagent studio</span>; the company Terminal says how to reopen it, answers <span class="inline-code">/help</span> itself (no model request) and stops fully when stopped from outside.</p>
+</section>
+
 <section class="section">
   <p class="section-kicker">v1.28.0 · 2026-10-17</p>
   <h2 id="v1-28-0">Team memory v2: each round once, a fresh brief after compaction</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.28.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.0</p>
+  <p class="eyebrow">Piagent 1.28.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.28.0</a>
+    <a class="button" href="/whats-new">Có gì mới trong 1.28.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.28.0</span>
+      <span class="card-kicker">Bản 1.28.1</span>
       <h3>Có gì mới</h3>
-      <p>Team memory v2: mỗi lượt vào memory đúng một lần, tóm tắt lại sau compaction, ghi nhận check fail → pass; ở 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>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.28.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.1 · 2026-10-18</p>
+  <h2 id="v1-28-1">Terminal công ty và Pi cá nhân không còn giẫm chân nhau</h2>
+  <p class="section-lead">Pi cá nhân không còn chết khi Piagent bị nạp hai lần (extension trỏ vào một bản Piagent khác): <span class="inline-code">piagent-update</span> và installer tự gỡ (có backup), <span class="inline-code">piagent-doctor</span> báo lỗi. Các mục công ty cũ của Agent Watch trong Pi cá nhân (provider <span class="inline-code">agent_watch_*</span>, model mặc định trỏ vào đó) được dọn khi máy đã dùng binding công ty. Pi cá nhân không tiếp tục cuộc trò chuyện công ty nữa và chỉ cách mở bằng <span class="inline-code">piagent studio</span>; Terminal công ty cũng hướng dẫn mở lại đúng cách, trả lời <span class="inline-code">/help</span> tại chỗ (không gửi model), và dừng hẳn khi bị dừng từ bên ngoài.</p>
+</section>
+
 <section class="section">
   <p class="section-kicker">v1.28.0 · 2026-10-17</p>
   <h2 id="v1-28-0">Team memory v2: ghi mỗi lượt đúng một lần, tóm tắt lại sau compaction</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.28.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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.28.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.28.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": 552,
-      "sha256": "138f8245842ea6ca59fcab4650aecab6d6c94b9e5c262438afb55a1cb4dffa61"
+      "fileCount": 553,
+      "sha256": "d948a7a9e0266c7f0cbd453310dd5c7498e1a664620b4696b8f845ebdea5e312"
     }
   ],
   "custodianComparisonRules": {

package/package.json

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

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

@@ -0,0 +1,36 @@
+// A company conversation (Agent Watch's ManagedSessions store, or one that
+// carries its run entries) belongs to `piagent studio`. Opened in personal Pi,
+// for example through Pi's "To resume this session: pi --session-dir …", it
+// would go on with the member's personal models, keys, extensions and
+// settings, outside the team's Harness; personal Pi refuses it instead.
+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/";
+
+export function isCompanySession(ctx: Pick<ExtensionContext, "sessionManager">): boolean {
+  const file = String(ctx.sessionManager?.getSessionFile?.() ?? "").split(path.sep).join("/");
+  if (file.includes(STORE)) return true;
+  try {
+    return ctx.sessionManager.getEntries().some((entry: any) => typeof entry?.customType === "string" && entry.customType.startsWith("agent-watch-run"));
+  } catch {
+    return false;
+  }
+}
+
+const quoted = (value: string) => /^[\w./~:-]+$/.test(value) ? value : `'${value.replaceAll("'", "'\\''")}'`;
+export function companySessionNotice(cwd: string): string {
+  return `Đây là cuộc trò chuyện công ty: mở bằng \`piagent studio --project ${quoted(cwd)}\` rồi gõ /resume. `
+    + "Pi cá nhân không tiếp tục nó, vì sẽ chạy bằng model, key và cấu hình cá nhân thay vì Harness của team.";
+}
+
+export function registerCompanySessionGuard(pi: ExtensionAPI) {
+  pi.on("input", (_event, ctx) => {
+    if (ctx.model?.provider === COMPANY_PROVIDER || !isCompanySession(ctx)) return { action: "continue" };
+    const notice = companySessionNotice(ctx.cwd);
+    if (ctx.hasUI) ctx.ui.notify(notice, "error");
+    else { process.stderr.write(`${notice}\n`); process.exitCode = 1; }
+    return { action: "handled" };
+  });
+}

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

@@ -24,6 +24,7 @@ import { extractShellWritePathCandidates } from "./shell-write-targets.js";
 import { isProjectMutatingShellCommand } from "./readonly-inline-inspection.ts";
 import { commandMatchesVerifyPlan, createBashResultLedger, findMatchingObservedBashResult, readObservedBashResults } from "./runtime-evidence.js";
 import { findPackageRoot, findPlatformRoot, readJsonFile } from "./guard-io.js";
+import { registerCompanySessionGuard } from "./company-session-guard.ts";
 import {
   extractDocument,
   resolveDocumentPath,
@@ -3459,6 +3460,7 @@ export default function piagentGuard(pi: ExtensionAPI) {
   const modelSelectionProvenance = new ModelSelectionProvenanceTracker();
   const serviceTierRuntime = new ServiceTierRuntime({ environmentValue: process.env.PIAGENT_FAST_MODE });
   const trajectoryRuntime = new TrajectoryRuntime();
+  registerCompanySessionGuard(pi);
 
   pi.on("model_select", (event, ctx) => {
     modelSelectionProvenance.observeModelSelection(ctx.sessionManager.getSessionId(), event.source);

package/packages/piagent-core/package.json

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

package/scripts/company-terminal.mjs

@@ -15,6 +15,12 @@ import { headlineText, outcomeText, processItems } from '../packages/piagent-web
 import { turnEndCopy, turnEndOf } from '../packages/piagent-webui/shared/turn-end.ts';
 
 const LOCALE = 'vi';
+export const HELP_TEXT = [
+  'Cuộc trò chuyện công ty: /undo hoàn tác file lượt trước đã sửa · /bypass on|off|status quyền lệnh cần internet · /fast on|off|status (khi Harness cho phép) · /skill:<tên> hoặc /<lệnh> của bạn và của project.',
+  'Pi: /session thông tin cuộc trò chuyện · /resume mở cuộc trò chuyện công ty khác · /new cuộc mới · /compact nén ngữ cảnh · /tree, /fork nhánh · /name đặt tên · /copy, /export · /hotkeys toàn bộ phím tắt · /quit thoát.',
+  'Phím: ! <lệnh> chạy shell · Esc dừng lượt đang chạy · Ctrl+C xoá ô nhập, hai lần để thoát · Ctrl+O xem thêm.',
+  'Mở lại sau: piagent studio --project <thư mục>, rồi /resume. Đừng mở cuộc trò chuyện công ty bằng pi cá nhân.',
+].join('\n');
 const PERMISSION_STATUS = 'agent-watch-permission';
 const ASK = 'Hỏi trước (mặc định)', BYPASS = 'Bypass: chỉ hỏi việc bắt buộc';
 const PERMISSION_TEXT = {
@@ -117,6 +123,12 @@ export function companyTerminalExtension({ managed, packageRoot, sdkRoot, bindin
           : 'Fast đang tắt: các lượt chạy tốc độ thường.', 'info');
       } });
 
+    // /help is answered here, as on the dashboard: no model request (Pi has no
+    // /help of its own, so the text would otherwise go to the agent).
+    pi.registerCommand('help', {
+      description: 'Lệnh và phím tắt của Terminal công ty (không gửi model)',
+      handler: async (_args, ctx) => ctx.ui.notify(HELP_TEXT, 'info') });
+
     // The Harness's notes carry English for the agent; the member reads them in Vietnamese.
     pi.registerMessageRenderer('agent-watch-process', (message, _options, theme) => {
       const lines = processLines(message.details);

package/scripts/install-global.sh

@@ -781,6 +781,17 @@ if [[ "$WITH_HERDR" == true ]]; then
   fi
 fi
 
+# Personal Pi must not load Piagent twice (an extension path into another
+# Piagent copy beside the package) or keep old Agent Watch company providers:
+# Pi refuses to start, or personal Pi reaches Studio outside the Harness.
+echo
+echo "Personal Pi configuration:"
+if [[ "$DRY_RUN" == true ]]; then
+  print_cmd node "$PLATFORM_ROOT/scripts/personal-pi-config.mjs" repair
+else
+  node "$PLATFORM_ROOT/scripts/personal-pi-config.mjs" repair || echo "WARN: could not check the personal Pi configuration; run: node \"$PLATFORM_ROOT/scripts/personal-pi-config.mjs\" check" >&2
+fi
+
 echo
 echo "Installed packages:"
 if [[ "$DRY_RUN" == true ]]; then

package/scripts/personal-pi-config.mjs

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+// What in the member's personal Pi configuration (~/.pi/agent) conflicts with
+// Piagent, and the repair. Personal Pi loads Piagent as a Pi package; an
+// extension path that points into another Piagent copy registers the same
+// tools twice and Pi refuses to start ("Tool … conflicts with …"). Older Agent
+// Watch releases also wrote company providers (agent_watch_*, a direct key
+// read from Agent Watch) and a company default model into personal Pi; with a
+// managed binding (agent-watch-managed.json) the company runs only through
+// `piagent studio`, so those entries are leftovers that send personal Pi to
+// Studio outside the team's Harness, or fail.
+//
+//   personal-pi-config.mjs check [--agent-dir <dir>] [--json]   exit 1 when something conflicts
+//   personal-pi-config.mjs repair [--agent-dir <dir>]           backs up, then removes what conflicts
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const COMPANY_PROVIDER = /^agent_watch_/;
+const SESSION_HEADER_EXTENSION = "agentwatch-studio-session.mjs";
+
+const readJson = (file) => { try { return JSON.parse(fs.readFileSync(file, "utf8")); } catch { return null; } };
+const real = (file) => { try { return fs.realpathSync(file); } catch { return null; } };
+
+// The Piagent package a path belongs to (its root), or null.
+export function piagentRootOf(file) {
+  let dir = real(file);
+  if (!dir) return null;
+  if (!fs.statSync(dir).isDirectory()) dir = path.dirname(dir);
+  for (; dir !== path.dirname(dir); dir = path.dirname(dir)) {
+    const manifest = readJson(path.join(dir, "package.json"));
+    if (manifest?.name === "@piagent/platform") return dir;
+  }
+  return null;
+}
+
+const isPiagentSource = (source) => /^(git:github\.com\/Vt-mmm\/piagent|https:\/\/github\.com\/Vt-mmm\/piagent|npm:@piagent\/platform)(@|$)/.test(String(source));
+
+// The installed Pi package's version (git:… sources live under <agentDir>/git/…).
+export function packageVersion(agentDir, source) {
+  const match = /^git:([^@]+)/.exec(String(source));
+  if (match) return readJson(path.join(agentDir, "git", match[1], "package.json"))?.version ?? null;
+  const npm = /^npm:(@piagent\/platform)/.exec(String(source));
+  if (npm) return readJson(path.join(agentDir, "npm", "node_modules", npm[1], "package.json"))?.version ?? null;
+  return null;
+}
+
+export function inspect(agentDir) {
+  const settingsFile = path.join(agentDir, "settings.json"), modelsFile = path.join(agentDir, "models.json");
+  const settings = readJson(settingsFile) ?? {}, models = readJson(modelsFile) ?? {};
+  const managed = fs.existsSync(path.join(agentDir, "agent-watch-managed.json"));
+  const packages = Array.isArray(settings.packages) ? settings.packages : [];
+  const piagentPackages = packages.filter(isPiagentSource);
+  const extensions = Array.isArray(settings.extensions) ? settings.extensions : [];
+  const findings = [];
+
+  // Extensions inside a Piagent copy load beside the Pi package: duplicate tools.
+  const duplicate = extensions.filter((entry) => piagentRootOf(path.resolve(agentDir, String(entry))) && piagentPackages.length);
+  if (duplicate.length) findings.push({ kind: "duplicate-extensions", file: settingsFile, entries: duplicate,
+    text: `${duplicate.length} extension(s) point into another Piagent copy while the Piagent Pi package is installed: Pi refuses to start (tools registered twice).` });
+  if (piagentPackages.length > 1) findings.push({ kind: "duplicate-packages", file: settingsFile, entries: piagentPackages,
+    text: `${piagentPackages.length} Piagent Pi packages are registered; keep one.` });
+
+  if (managed) {
+    const providers = Object.keys(models.providers ?? {}).filter((name) => COMPANY_PROVIDER.test(name));
+    if (providers.length) findings.push({ kind: "company-providers", file: modelsFile, entries: providers,
+      text: `Old Agent Watch company providers (${providers.join(", ")}) are in personal Pi; company work runs only through \`piagent studio\`.` });
+    const defaults = [];
+    if (COMPANY_PROVIDER.test(String(settings.defaultProvider ?? ""))) defaults.push(`defaultProvider=${settings.defaultProvider}`);
+    for (const entry of Array.isArray(settings.enabledModels) ? settings.enabledModels : []) if (COMPANY_PROVIDER.test(String(entry))) defaults.push(`enabledModels:${entry}`);
+    if (defaults.length) findings.push({ kind: "company-defaults", file: settingsFile, entries: defaults,
+      text: "Personal Pi's default model or model list still names an old company provider." });
+    const header = extensions.filter((entry) => path.basename(String(entry)) === SESSION_HEADER_EXTENSION);
+    if (header.length) findings.push({ kind: "company-extension", file: settingsFile, entries: header,
+      text: "The old Agent Watch session-header extension is still loaded in personal Pi." });
+  }
+  return { agentDir, managed, findings, packages: piagentPackages.map((source) => ({ source, version: packageVersion(agentDir, source) })) };
+}
+
+function backup(file, stamp) {
+  if (!fs.existsSync(file)) return null;
+  const copy = `${file}.before-piagent-repair-${stamp}`;
+  fs.copyFileSync(file, copy);
+  fs.chmodSync(copy, 0o600);
+  return copy;
+}
+
+function writeJson(file, value) {
+  const tmp = `${file}.${process.pid}.tmp`;
+  fs.writeFileSync(tmp, `${JSON.stringify(value, null, 2)}\n`, { mode: 0o600 });
+  fs.renameSync(tmp, file);
+}
+
+// Removes what inspect() found (duplicate packages are left to the installer,
+// which knows the one to keep). Every changed file is backed up first.
+export function repair(agentDir, now = new Date()) {
+  const report = inspect(agentDir);
+  const kinds = new Set(report.findings.map((finding) => finding.kind));
+  const stamp = now.toISOString().replace(/[:.]/g, "-");
+  const changed = [], backups = [];
+  const settingsFile = path.join(agentDir, "settings.json"), modelsFile = path.join(agentDir, "models.json");
+  if (kinds.has("duplicate-extensions") || kinds.has("company-defaults") || kinds.has("company-extension")) {
+    const settings = readJson(settingsFile);
+    const drop = new Set(report.findings.filter((f) => f.kind === "duplicate-extensions" || f.kind === "company-extension").flatMap((f) => f.entries));
+    if (Array.isArray(settings.extensions)) settings.extensions = settings.extensions.filter((entry) => !drop.has(entry));
+    if (Array.isArray(settings.extensions) && !settings.extensions.length) delete settings.extensions;
+    if (COMPANY_PROVIDER.test(String(settings.defaultProvider ?? ""))) { delete settings.defaultProvider; delete settings.defaultModel; }
+    if (Array.isArray(settings.enabledModels)) settings.enabledModels = settings.enabledModels.filter((entry) => !COMPANY_PROVIDER.test(String(entry)));
+    backups.push(backup(settingsFile, stamp)); writeJson(settingsFile, settings); changed.push(settingsFile);
+  }
+  if (kinds.has("company-providers")) {
+    const models = readJson(modelsFile);
+    for (const name of Object.keys(models.providers ?? {})) if (COMPANY_PROVIDER.test(name)) delete models.providers[name];
+    backups.push(backup(modelsFile, stamp)); writeJson(modelsFile, models); changed.push(modelsFile);
+  }
+  return { ...report, changed, backups: backups.filter(Boolean), after: inspect(agentDir) };
+}
+
+const invoked = process.argv[1] && real(process.argv[1]) === real(fileURLToPath(import.meta.url));
+if (invoked) {
+  const args = process.argv.slice(2), command = args[0];
+  const at = args.indexOf("--agent-dir");
+  const agentDir = at >= 0 ? path.resolve(args[at + 1]) : (process.env.PI_CODING_AGENT_DIR || path.join(os.homedir(), ".pi", "agent"));
+  if (!["check", "repair"].includes(command)) { console.error("Usage: personal-pi-config.mjs check|repair [--agent-dir <dir>] [--json]"); process.exit(2); }
+  const result = command === "repair" ? repair(agentDir) : inspect(agentDir);
+  if (args.includes("--json")) console.log(JSON.stringify(result, null, 2));
+  else if (command === "repair") {
+    for (const finding of result.findings) console.log(`fixed: ${finding.text}`);
+    for (const file of result.backups) console.log(`backup: ${file}`);
+    if (!result.findings.length) console.log("personal Pi configuration: nothing to repair");
+  } else {
+    for (const finding of result.findings) console.log(`WARN: ${finding.text}`);
+    if (result.findings.length) console.log("Fix: piagent-update (or node scripts/personal-pi-config.mjs repair)");
+    else console.log("PASS: personal Pi configuration has no Piagent conflicts");
+  }
+  process.exit(command === "check" && result.findings.length ? 1 : 0);
+}

package/scripts/piagent-cli.mjs

@@ -158,8 +158,16 @@ child.once("error", (error) => {
   process.exit(1);
 });
 
+// A command stopped from outside (a script, an editor, a timeout) stops its
+// child too, rather than leaving a company run going in the background. A
+// terminal's Ctrl+C already reaches the whole process group: the launcher just
+// stays until the child has finished.
+for (const signal of ["SIGTERM", "SIGHUP"]) process.on(signal, () => { try { child.kill(signal); } catch { /* already gone */ } });
+process.on("SIGINT", () => {});
+
 child.once("exit", (code, signal) => {
   if (signal) {
+    process.removeAllListeners(signal);
     process.kill(process.pid, signal);
     return;
   }

package/scripts/piagent-studio.mjs

@@ -162,6 +162,10 @@ try {
     // (updating Pi breaks the Agent Watch import), no package-update, catalog or
     // install-telemetry calls. Search tools were provisioned above.
     process.env.PI_OFFLINE = '1'; process.env.PI_SKIP_VERSION_CHECK = '1';
+    // Pi's exit line names `pi --session-dir …`, which would open this company
+    // conversation in personal Pi; name the company Terminal instead.
+    const write = process.stdout.write.bind(process.stdout), project = /^[\w./~:-]+$/.test(cwd) ? cwd : `'${cwd.replaceAll("'", "'\\''")}'`;
+    process.stdout.write = (chunk, ...rest) => write(typeof chunk === 'string' && chunk.includes('To resume this session:') ? `Mở lại cuộc trò chuyện này: piagent studio --project ${project}, rồi /resume\n` : chunk, ...rest);
     await new api.InteractiveMode(host, { verbose: false }).run();
   }
   }

package/scripts/team-doctor.sh

@@ -70,6 +70,10 @@ const warnings = [];
 const { piagentInstallations } = await import(pathToFileURL(path.join(platformRoot, "scripts/piagent-installations.mjs")).href);
 const installations = piagentInstallations();
 if(installations.length>1) warnings.push("Multiple Piagent installations detected. Use the pinned Watch launcher; other PATHs may run an older build: "+installations.map(i=>`${i.version} [${i.fingerprint}] ${i.root}`).join("; "));
+// Personal Pi loading Piagent twice does not start; old company providers send it to Studio outside the Harness.
+const { inspect: inspectPersonalPi } = await import(pathToFileURL(path.join(platformRoot, "scripts/personal-pi-config.mjs")).href);
+for (const finding of inspectPersonalPi(process.env.PI_CODING_AGENT_DIR || path.join(process.env.HOME || "", ".pi", "agent")).findings)
+  (finding.kind === "duplicate-extensions" ? errors : warnings).push(`personal Pi: ${finding.text} Fix: piagent-update`);
 const { verifyCapabilityLock } = await import(pathToFileURL(path.join(platformRoot, "packages", "piagent-core", "capabilities", "capability-core.js")).href);
 
 function exists(rel) {

package/scripts/update-global.mjs

@@ -21,6 +21,7 @@ import os from "node:os";
 import path from "node:path";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
+import { inspect as inspectPersonalPi } from "./personal-pi-config.mjs";
 
 const HELPER_PACKAGE = "@piagent/platform";
 const HOST_PACKAGE = "@earendil-works/pi-coding-agent";
@@ -430,13 +431,19 @@ function main() {
   console.log("Pi Agent Platform update");
   console.log(`  helper:  ${currentHelper} -> ${targetHelper}${helperNeedsChange ? "" : " (already current)"}`);
   console.log(`  host:    ${currentHost ?? "not installed"} -> ${targetHost}${hostNeedsChange ? "" : " (already current)"}`);
-  console.log(`  package: reinstalled from v${targetHelper} as a resolved commit${options.package ? "" : " (skipped)"}`);
+  // The Pi package can lag the helper (installed from an older tag), and
+  // personal Pi can hold conflicting Piagent or old company entries.
+  const personal = inspectPersonalPi(process.env.PI_CODING_AGENT_DIR || path.join(os.homedir(), ".pi", "agent"));
+  const installedPackages = personal.packages.map((item) => item.version ?? "unknown");
+  const packageNeedsChange = options.package && (options.force || installedPackages.length !== 1 || installedPackages[0] !== targetHelper);
+  console.log(`  package: ${installedPackages.join(", ") || "not installed"} -> v${targetHelper}${options.package ? packageNeedsChange ? " (reinstalled as a resolved commit)" : " (already current)" : " (skipped)"}`);
+  for (const finding of personal.findings) console.log(`  personal Pi: ${finding.text}`);
   if (options.project) {
     console.log(`  project: ${path.resolve(options.project)} (${options.migrate ? "migrate + doctor" : "doctor only"})`);
   }
 
   if (options.check) {
-    const pending = [helperNeedsChange && "helper", hostNeedsChange && "host"].filter(Boolean);
+    const pending = [helperNeedsChange && "helper", hostNeedsChange && "host", packageNeedsChange && "package", personal.findings.length && "personal Pi configuration"].filter(Boolean);
     console.log(pending.length ? `\nUpdate available: ${pending.join(", ")}.` : "\nEverything is on the target release.");
     return;
   }