@piagent/platform 1.40.0 → 1.41.0

package/docs-site/en/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.40.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.0 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/mcp" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/mcp" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/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.40.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.0 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/permissions" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/permissions" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/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.40.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.0 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/profiles" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/profiles" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/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.40.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.0 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/quickstart" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/quickstart" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/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.40.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.0 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/runtime" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/runtime" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/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.40.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.0 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/scope" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/scope" hreflang="en" lang="en" aria-current="true">EN</a>

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.40.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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,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.41.0 · 2026-10-24</p>
+  <h2 id="v1-41-0">Front-end change reports</h2>
+  <p class="section-lead">The <code>fe-change-report</code> skill: for a front-end task that asks for a report, the agent captures the old and new versions of the affected pages (headless, same data), frames each change with a numbered red box on both screenshots, runs the checks and the full E2E suite headless, and writes what changed for the business, in the logic, and on screen. The scripts use the project's own Playwright, add no dependency, and write one <code>report.html</code> with no scripts to send to anyone. The dashboard draws the same report in Documents from <code>reports/fe-change/&lt;slug&gt;/report.json</code>, with a full-screen view; it is drawn from data, so the WebUI still renders no model markup.</p>
+</section>
+
 <section class="section">
   <p class="section-kicker">v1.40.0 · 2026-10-24</p>
   <h2 id="v1-40-0">Local projects are reported to Studio too</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.40.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0</p>
+  <p class="eyebrow">Piagent 1.41.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.40.0</a>
+    <a class="button" href="/whats-new">Có gì mới trong 1.41.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.40.0</span>
+      <span class="card-kicker">Bản 1.41.0</span>
       <h3>Có gì mới</h3>
-      <p>Project local không có remote cũng được báo cho Studio, member thấy mọi loại cảnh báo sai project (Studio 0.40.0); ở 1.39.0: cảnh báo key dùng sai project (Studio 0.39.0), dashboard giữ ngôn ngữ và theme sau khi khởi động lại; ở 1.38.2: cây thư mục như VS Code, theme màu (Dracula, Nord…), editor và terminal đứng yên khi cuộn; ở 1.38.1: dashboard thành editor: sửa file, terminal, review hunk, khôi phục lượt; Bypass không hỏi gì, cả cuộc trò chuyện công ty khi Harness bật; ở 1.37.1: run Studio chưa xác nhận đóng không còn bị ghi là đã đóng, helper đóng lỗi vẫn giữ câu trả lời, bài học team memory ghi đúng lệnh; ở 1.37.0: câu trả lời bị cắt giữa chừng không còn làm dừng task dài, có <code>piagent studio --rpc</code>; ở 1.36.1: Agent Watch mất kết nối tới Studio trong chốc lát không còn làm dừng task; ở 1.36.0: team memory học từ chỗ làm sai: Studio chấm những gì memory đã đưa, lệnh lỗi lặp lại thành bài học; ở 1.35: task dài không dừng khi Studio cập nhật hay model báo lỗi tạm thời; ở 1.34: 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>
+      <p>Báo cáo thay đổi giao diện: ảnh cũ/mới khoanh đỏ, business, logic và kết quả check, xem ngay trong Tài liệu; ở 1.40.0: project local không có remote cũng được báo cho Studio, member thấy mọi loại cảnh báo sai project (Studio 0.40.0); ở 1.39.0: cảnh báo key dùng sai project (Studio 0.39.0), dashboard giữ ngôn ngữ và theme sau khi khởi động lại; ở 1.38.2: cây thư mục như VS Code, theme màu (Dracula, Nord…), editor và terminal đứng yên khi cuộn; ở 1.38.1: dashboard thành editor: sửa file, terminal, review hunk, khôi phục lượt; Bypass không hỏi gì, cả cuộc trò chuyện công ty khi Harness bật; ở 1.37.1: run Studio chưa xác nhận đóng không còn bị ghi là đã đóng, helper đóng lỗi vẫn giữ câu trả lời, bài học team memory ghi đúng lệnh; ở 1.37.0: câu trả lời bị cắt giữa chừng không còn làm dừng task dài, có <code>piagent studio --rpc</code>; ở 1.36.1: Agent Watch mất kết nối tới Studio trong chốc lát không còn làm dừng task; ở 1.36.0: team memory học từ chỗ làm sai: Studio chấm những gì memory đã đưa, lệnh lỗi lặp lại thành bài học; ở 1.35: task dài không dừng khi Studio cập nhật hay model báo lỗi tạm thời; ở 1.34: 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.40.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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,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.41.0 · 2026-10-24</p>
+  <h2 id="v1-41-0">Báo cáo thay đổi giao diện</h2>
+  <p class="section-lead">Skill <code>fe-change-report</code>: với task front-end cần báo cáo, agent chụp bản cũ và bản mới của các trang bị ảnh hưởng (chạy nền, cùng dữ liệu), khoanh từng thay đổi bằng khung đỏ đánh số trên cả hai ảnh, chạy check và toàn bộ E2E headless, rồi ghi lại business, logic và giao diện đã đổi. Script dùng Playwright có sẵn trong project, không thêm dependency, xuất một file <code>report.html</code> không có script để gửi cho người khác. Dashboard vẽ cùng báo cáo đó trong Tài liệu từ <code>reports/fe-change/&lt;slug&gt;/report.json</code>, có chế độ toàn màn hình; báo cáo được vẽ từ dữ liệu nên WebUI vẫn không hiển thị markup do model tạo.</p>
+</section>
+
 <section class="section">
   <p class="section-kicker">v1.40.0 · 2026-10-24</p>
   <h2 id="v1-40-0">Project local cũng được báo cho Studio</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.40.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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.40.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.41.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/fixtures/piagent-webui/document-asset-v1.invalid.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-webui-document-asset-v1",
+  "generatedAt": "2026-10-24T09:00:00.000Z",
+  "documentRef": "document_01",
+  "name": "../../.env",
+  "state": "unavailable",
+  "mediaType": null,
+  "sizeBytes": null,
+  "base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJ",
+  "reasonCode": "document-asset-name-invalid"
+}

package/evals/fixtures/piagent-webui/document-asset-v1.valid.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": 1,
+  "version": "piagent-webui-document-asset-v1",
+  "generatedAt": "2026-10-24T09:00:00.000Z",
+  "documentRef": "document_01",
+  "name": "after-listings-desktop.png",
+  "state": "ready",
+  "mediaType": "image/png",
+  "sizeBytes": 67,
+  "base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==",
+  "reasonCode": null
+}

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

@@ -256,8 +256,8 @@
     },
     {
       "path": "tests",
-      "fileCount": 622,
-      "sha256": "129f4a1168fef5a3b5a0cae16d338d1135ab8579cf71d5777f619a550def2846"
+      "fileCount": 623,
+      "sha256": "2ae5b959709ea68e1a3e577b6c89b3e402a3bec04251f4852719a29ac17d7701"
     }
   ],
   "custodianComparisonRules": {

package/package.json

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

package/packages/piagent-core/package.json

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

package/packages/piagent-core/runtime/inspection/document-workspace-projection.ts

@@ -142,6 +142,10 @@ function walkRoot(root: DocumentRoot, budget: { remaining: number }, isProtected
     // an operator keeps documents, and reading all of it is what makes a listing
     // take seconds.
     if (entries.length > DOCUMENT_WORKSPACE_LIMITS.entriesPerDirectory) continue;
+    // A change report's shots/ folder holds screenshots and the capture
+    // bookkeeping (meta.json, regions.json). The report opens them itself, so
+    // listing them would only bury report.json among its own working files.
+    const changeReport = entries.some((entry) => entry.isFile() && entry.name === "report.json");
     for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
       if (budget.remaining <= 0) break;
       // A Dirent already reports a link as a link, so the isFile and isDirectory
@@ -151,7 +155,7 @@ function walkRoot(root: DocumentRoot, budget: { remaining: number }, isProtected
       const absolute = path.join(current.directory, entry.name);
       const relative = path.relative(root.path, absolute).split(path.sep).join("/");
       if (entry.isDirectory()) {
-        if (entry.name.startsWith(".") || SKIPPED_DIRECTORIES.has(entry.name)) continue;
+        if (entry.name.startsWith(".") || SKIPPED_DIRECTORIES.has(entry.name) || (changeReport && entry.name === "shots")) continue;
         if (current.depth + 1 > DOCUMENT_WORKSPACE_LIMITS.depth) continue;
         if (isProtected(relative, absolute)) continue;
         queue.push({ directory: absolute, depth: current.depth + 1 });
@@ -223,39 +227,50 @@ export function projectDocumentWorkspaceListing(input: DocumentWorkspaceInput):
   return collectDocuments(input).listing;
 }
 
-export function projectDocumentWorkspaceDocument(input: DocumentWorkspaceInput & { documentRef: string }): DocumentWorkspaceDocument {
-  const now = (input.now ?? (() => new Date()))();
-  const base = { schemaVersion: 1 as const, version: "piagent-webui-document-workspace-v1" as const,
-    messageType: "document" as const, generatedAt: timestamp(now), documentRef: input.documentRef };
-  const unavailable = (reasonCode: string): DocumentWorkspaceDocument => ({ ...base, state: "unavailable", name: null, relativePath: null,
-    rootRef: null, format: null, text: null, sizeBytes: null, truncated: false, redacted: false, reasonCode });
-
+// A read names a document only by the ref a listing handed out, so every read
+// goes through this: re-list, match, resolve, and re-prove the ref.
+function locateListedDocument(input: DocumentWorkspaceInput, documentRef: string): { reasonCode: string }
+  | { entry: DocumentWorkspaceEntry; resolved: Extract<ReturnType<typeof resolveDocumentPath>, { status: "ok" }>;
+    isProtected: (relative: string, absolute: string) => boolean } {
   // The ref is matched against a listing taken now, so opening a document proves
   // it is still listable rather than trusting a ref the browser has been holding.
   const { listing, roots, paths } = collectDocuments(input);
-  if (listing.state !== "ready") return unavailable(listing.reasonCode ?? "document-roots-unavailable");
-  const entry = listing.documents.find((candidate) => candidate.documentRef === input.documentRef);
-  const absolute = paths.get(input.documentRef);
-  if (!entry || !absolute) return unavailable("document-not-listed");
+  if (listing.state !== "ready") return { reasonCode: listing.reasonCode ?? "document-roots-unavailable" };
+  const entry = listing.documents.find((candidate) => candidate.documentRef === documentRef);
+  const absolute = paths.get(documentRef);
+  if (!entry || !absolute) return { reasonCode: "document-not-listed" };
 
   // Resolution runs against the same roots the walk used, so the extension gate,
   // the size cap, the symlink canonicalisation and the containment check are the
   // ones the document tool applies — including the identity that extractDocument
   // re-proves when it opens the file.
   const resolved = resolveDocumentPath(absolute, roots, { cwd: input.cwd, home: input.home });
-  if (resolved.status === "error") return unavailable("document-unavailable");
+  if (resolved.status === "error") return { reasonCode: "document-unavailable" };
   // The walk above already dropped protected documents, so a protected ref fails
   // to match a listing entry before it reaches here. Both of the next two checks
   // are the invariant stated rather than assumed: they hold the guarantee in
   // place if the listing filter is ever loosened or the ref scheme changes.
   const isProtected = protectedPredicate(input);
   const relative = path.relative(resolved.root.path, resolved.absolutePath).split(path.sep).join("/");
-  if (isProtected(relative, resolved.absolutePath)) return unavailable("document-protected");
+  if (isProtected(relative, resolved.absolutePath)) return { reasonCode: "document-protected" };
   // Roots are canonical and the walk never traverses a link, so the listed path
   // is already the canonical one and this equality holds by construction. It is
   // re-derived anyway: the cost is a hash, and what it protects is the rule that
   // the browser can only ever name a document the listing chose to expose.
-  if (ref("document", resolved.absolutePath) !== input.documentRef) return unavailable("document-changed");
+  if (ref("document", resolved.absolutePath) !== documentRef) return { reasonCode: "document-changed" };
+  return { entry, resolved, isProtected };
+}
+
+export function projectDocumentWorkspaceDocument(input: DocumentWorkspaceInput & { documentRef: string }): DocumentWorkspaceDocument {
+  const now = (input.now ?? (() => new Date()))();
+  const base = { schemaVersion: 1 as const, version: "piagent-webui-document-workspace-v1" as const,
+    messageType: "document" as const, generatedAt: timestamp(now), documentRef: input.documentRef };
+  const unavailable = (reasonCode: string): DocumentWorkspaceDocument => ({ ...base, state: "unavailable", name: null, relativePath: null,
+    rootRef: null, format: null, text: null, sizeBytes: null, truncated: false, redacted: false, reasonCode });
+
+  const located = locateListedDocument(input, input.documentRef);
+  if ("reasonCode" in located) return unavailable(located.reasonCode);
+  const { entry, resolved } = located;
 
   const extracted = extractDocument(resolved);
   if (extracted.status === "error") {
@@ -274,3 +289,51 @@ export function projectDocumentWorkspaceDocument(input: DocumentWorkspaceInput &
     format: extracted.kind, text: capped.text, sizeBytes: entry.sizeBytes,
     truncated: extracted.truncated || capped.truncated, redacted: safe.redacted, reasonCode: null };
 }
+
+// Screenshots of a front-end change report. The report itself is a listed
+// `report.json`; its images are never listed and are named only relative to it,
+// so the browser still cannot point at an arbitrary file. Images cross as base64
+// inside JSON: the read model, the session IPC and the company relay already
+// carry JSON, and a PNG drawn into an <img> runs nothing.
+export const DOCUMENT_ASSET_NAME = /^(before|after|diff)-[a-z0-9][a-z0-9-]{0,100}\.png$/;
+const MAX_DOCUMENT_ASSET_BYTES = 8 * 1024 * 1024;
+const PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+
+export type DocumentWorkspaceAsset = {
+  schemaVersion: 1;
+  version: "piagent-webui-document-asset-v1";
+  generatedAt: string;
+  documentRef: string;
+  // Null when the requested name was refused: a refusal never echoes it back.
+  name: string | null;
+  state: "ready" | "unavailable";
+  mediaType: "image/png" | null;
+  sizeBytes: number | null;
+  base64: string | null;
+  reasonCode: string | null;
+};
+
+export function projectDocumentWorkspaceAsset(input: DocumentWorkspaceInput & { documentRef: string; name: string }): DocumentWorkspaceAsset {
+  const base = { schemaVersion: 1 as const, version: "piagent-webui-document-asset-v1" as const,
+    generatedAt: timestamp((input.now ?? (() => new Date()))()), documentRef: input.documentRef,
+    name: DOCUMENT_ASSET_NAME.test(input.name) ? input.name : null };
+  const unavailable = (reasonCode: string): DocumentWorkspaceAsset => ({ ...base, state: "unavailable", mediaType: null, sizeBytes: null, base64: null, reasonCode });
+  if (base.name === null) return unavailable("document-asset-name-invalid");
+  const located = locateListedDocument(input, input.documentRef);
+  if ("reasonCode" in located) return unavailable(located.reasonCode);
+  if (path.basename(located.resolved.absolutePath) !== "report.json") return unavailable("document-asset-not-a-report");
+  const directory = path.join(path.dirname(located.resolved.absolutePath), "shots"), absolute = path.join(directory, input.name);
+  const relative = path.relative(located.resolved.root.path, absolute).split(path.sep).join("/");
+  if (located.isProtected(relative, absolute)) return unavailable("document-protected");
+  let bytes: Buffer;
+  try {
+    // lstat on both levels: a linked shots folder or image could lead out of the root.
+    if (!fs.lstatSync(directory).isDirectory()) return unavailable("document-asset-unavailable");
+    const stat = fs.lstatSync(absolute);
+    if (!stat.isFile()) return unavailable("document-asset-unavailable");
+    if (stat.size > MAX_DOCUMENT_ASSET_BYTES) return unavailable("document-asset-too-large");
+    bytes = fs.readFileSync(absolute);
+  } catch { return unavailable("document-asset-unavailable"); }
+  if (bytes.length > MAX_DOCUMENT_ASSET_BYTES || !bytes.subarray(0, 8).equals(PNG_SIGNATURE)) return unavailable("document-asset-unreadable");
+  return { ...base, state: "ready", mediaType: "image/png", sizeBytes: bytes.length, base64: bytes.toString("base64"), reasonCode: null };
+}