@piagent/platform 1.48.1 → 1.48.3

package/CHANGELOG.md

@@ -4,6 +4,38 @@ Every release of Pi Agent Platform (`@piagent/platform`), newest first. Versions
 
 This file is generated from `docs-site/releases.json` by `node scripts/build-docs-site.mjs`, which also renders the [Changelog page](https://piagent.io.vn/en/whats-new). Edit the JSON, not this file. When publishing a tag, copy the version's block into the GitHub Release.
 
+## v1.48.3 - 2026-10-30
+
+**The agent sends pictures and files into the chat; reviews run across several repositories.** Answers show pictures and file cards in place, an SVG opens as a picture, attached images are large and open full size, and a folder of repositories gets its review.
+
+### Added
+
+- The agent sends a picture or file into the chat with ![name](path): a picture is drawn in place and opens full size, any other file is a card to open or download.
+
+### Improved
+
+- An SVG opens as a picture with View code beside it, and every open file has Download.
+- An image attached to a message is a large thumbnail that opens full size, on the new conversation page too.
+
+### Fixed
+
+- Review no longer fails with not_git in a folder holding several repositories: changes made by commands, committed or not, are found in each repository.
+- A review stopped by an update under a running conversation says so and asks to reopen it; an unnamed failure keeps its redacted words in the local log.
+
+## v1.48.2 - 2026-10-30
+
+**Terminals load a new release without closing; only the member waives checks.** After an update every open Terminal moves to the new release when idle and keeps its conversation, and a team's required checks can be skipped only by the member, on a card.
+
+### Added
+
+- piagent reload: every open Terminal (piagent and piagent studio) loads the installed release when idle and keeps its conversation; piagent-update asks for it after installing.
+- Only the member can skip the checks a team requires: the agent asks on an approval card, once, for the code as it is then; later changes are checked again.
+
+### Improved
+
+- A Terminal running a task is never cut off: it loads the new release when the task finishes, and its footer says it is waiting.
+- A turn whose checks the member skipped says so in its status, apart from a turn where no check ran; a push still asks as in every mode.
+
 ## v1.48.1 - 2026-10-30
 
 **Faster first replies on the dashboard and an instant Enter in the Terminal.** New dashboard conversations start on the model and thinking level you use in the Terminal, and sending a message no longer waits on repository checks or disk flushes.

package/README.md

@@ -82,6 +82,8 @@ piagent-update --check             # only check
 piagent-update --version X.Y.Z     # a specific release, newer or older
 ```
 
+Open Terminals (`piagent`, `piagent studio`) load the new release when idle and keep their conversation; a running task finishes first. `piagent reload` asks them again.
+
 It installs the pinned Pi host first, verifies the version on disk, then runs the installer; with `--project` it also migrates the project and runs the doctor. Team pins, rollback and uninstall: [Update & uninstall](https://piagent.io.vn/en/update) and the [release and install policy](docs/release-install-policy.md).
 
 ```bash

package/README.vi.md

@@ -82,6 +82,8 @@ piagent-update --check             # chỉ kiểm tra
 piagent-update --version X.Y.Z     # đúng một bản, mới hơn hay cũ hơn
 ```
 
+Terminal đang mở (`piagent`, `piagent studio`) tự nạp bản mới khi rảnh và giữ nguyên cuộc trò chuyện; task đang chạy thì xong trước. `piagent reload` yêu cầu lại.
+
 Lệnh cài Pi host được pin trước, kiểm tra version trên đĩa rồi mới chạy installer; với `--project` nó migrate project và chạy doctor. Pin cho team, rollback và gỡ cài đặt: [Cập nhật và gỡ](https://piagent.io.vn/update) và [release and install policy](docs/release-install-policy.md).
 
 ```bash

package/docs/command-reference-vietnamese.md

@@ -134,7 +134,7 @@ Các command này đến từ package `piagent-core`; tất cả chạy ngay và
 | `/fast status\|on\|off` | Xem/bật/tắt Fast service tier cho session OpenAI Codex. | Chạy ngay, 0 model token; giữ nguyên model/thinking. Session trống mặc định tắt, environment override hoặc state đã lưu khi resume có thể được ưu tiên. |
 | `/memory` hoặc `/memory-policy` | Xem memory policy. | Chạy ngay, không gọi model. |
 | `/piagent-mcp` | Xem/quản trị MCP trong Pi. | Menu MCP, không gọi model. |
-| `/piagent-update` | Kiểm tra bản Piagent mới ngay (Terminal tự hỏi mỗi giờ, giữa các lượt). | Hỏi "Cập nhật ngay / Để sau"; cập nhật xong nhắc mở lại `pi` hoặc `piagent studio`. Không gọi model. |
+| `/piagent-update` | Kiểm tra bản Piagent mới ngay (Terminal tự hỏi mỗi giờ, giữa các lượt). | Hỏi "Cập nhật ngay / Để sau"; cập nhật xong Terminal tự nạp bản mới khi rảnh, giữ nguyên cuộc trò chuyện. Không gọi model. |
 | `/share`, `/bug` | Trong `piagent studio`: bị tắt, chỉ báo lý do. | Hai lệnh này đưa hội thoại và code ra ngoài công ty (GitHub Gist, báo cáo cho nhà phát triển Pi). Dùng `/export` để lưu file trên máy. |
 | `/login`, `/logout`, `/model`, `/scoped-models`, `/thinking`, `/settings` | Trong `piagent studio`: chỉ báo "Harness của team quyết định" (Ctrl+L, Ctrl+P, Shift+Tab cũng vậy). | Model, mức suy luận và cài đặt do Harness trong Agent Studio quyết định; tài khoản là của team qua Agent Watch. `/changelog` hiện "Có gì mới" của Piagent. |
 | `/bypass [on\|full\|off\|status]` | Chỉ trong `piagent studio`: chọn Bypass, Toàn quyền hoặc Hỏi trước cho cuộc trò chuyện công ty (giống công tắc trên dashboard). | Bypass: việc làm chạy luôn (internet, Docker, lệnh trên máy, migration), chỉ hỏi việc bàn giao (push, PR, publish, deploy, upload, ssh, MCP ghi ra ngoài) và lệnh đụng thông tin đăng nhập. Toàn quyền: hỏi thêm migration, xoá không rõ đích, sudo và từng lệnh trên máy. Footer hiện chế độ. Không gọi model. |
@@ -477,14 +477,15 @@ Các lệnh này chạy ngoài Pi.
 | Command | Dùng khi nào |
 |---|---|
 | `npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0` | Cài Pi CLI tương thích với release hiện tại. |
-| `npm install -g --ignore-scripts @piagent/platform@1.48.1` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
-| `pi install git:github.com/Vt-mmm/piagent@v1.48.1` | Cài pinned release khi cần reproducible team setup. |
+| `npm install -g --ignore-scripts @piagent/platform@1.48.3` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
+| `pi install git:github.com/Vt-mmm/piagent@v1.48.3` | Cài pinned release khi cần reproducible team setup. |
 | `pi install git:github.com/Vt-mmm/piagent` | Cài latest package platform cho máy cá nhân/sandbox. |
 | `piagent pi-host status` | Xem Pi host Piagent đang chạy: bản pin, `pi` riêng của bạn, bản Pi riêng của Piagent. |
 | `piagent pi` | Mở Pi đúng bản Piagent đã kiểm định (vd `1.3.0`) khi `pi` của bạn là bản mới hơn (vd `1.4.0`); `pi` của bạn giữ nguyên. |
 | `piagent pi-host ensure` | Cài bản Pi pin vào `~/.piagent/pi-host/<version>` khi `pi` trên máy là bản mới hơn. `piagent-setup`, `piagent-install`, `piagent-update` tự làm bước này và không còn hạ cấp `pi` của member. |
 | `piagent skills add mattpocock/skills` | Thêm một repo skill trên GitHub (giữ ở đúng một commit trong `~/.piagent/skill-sources`). Skill dùng được dạng `/skill:<tên>` trong Pi cá nhân (sau `/reload`), Terminal công ty và dashboard. Repo có `.claude-plugin/plugin.json` chỉ nạp skill repo đó công bố. `--ref <branch|tag|commit>` để ghim bản khác. |
 | `piagent skills list` / `update [<owner/repo>]` / `remove <owner/repo>` | Xem skill từng nguồn thêm vào; lên commit mới nhất của ref; gỡ nguồn và xoá bản sao. |
+| `piagent reload` | Mọi Terminal đang mở (`piagent`, `piagent studio`) nạp bản Piagent đã cài khi rảnh, giữ nguyên cuộc trò chuyện; Terminal đang chạy task thì nạp khi task xong. `piagent-update` tự yêu cầu việc này sau khi cài. |
 | `piagent-update --check` | Báo version hiện tại vs version sẽ lên cho cả ba thành phần; không cài gì. |
 | `piagent-update` | Full update global một lệnh cho cả máy: Pi host → npm-global helper → Pi package, đúng thứ tự release yêu cầu. |
 | `piagent-update --version X.Y.Z` | Update tới đúng một release thay vì latest; dùng cho rollout theo lô hoặc rollback. |

package/docs/distribution-standard.md

@@ -15,9 +15,9 @@ Repo này phải chạy được cho nhiều project/domain khác nhau. Vì vậ
 
 | Use case | Package source |
 |---|---|
-| Team pinned release | `git:github.com/Vt-mmm/piagent@v1.48.1` |
+| Team pinned release | `git:github.com/Vt-mmm/piagent@v1.48.3` |
 | Personal/sandbox dev | `git:github.com/Vt-mmm/piagent` |
-| Registry distribution | `npm:@piagent/platform@1.48.1` |
+| Registry distribution | `npm:@piagent/platform@1.48.3` |
 | Enterprise npm (fork under another scope) | `npm:@your-scope/platform@x.y.z` |
 | Local platform dev | `/path/to/piagent` |
 
@@ -54,7 +54,7 @@ Root `package.json` có `pi` manifest trỏ tới:
 Do đó team có thể:
 
 ```bash
-pi install git:github.com/Vt-mmm/piagent@v1.48.1
+pi install git:github.com/Vt-mmm/piagent@v1.48.3
 ```
 
 Không cần biết internal folder `packages/piagent-core`. Source không pin chỉ dành cho personal/sandbox như bảng channel ở trên.
@@ -66,12 +66,12 @@ Team nên install global package một lần:
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0
-npm install -g --ignore-scripts @piagent/platform@1.48.1
+npm install -g --ignore-scripts @piagent/platform@1.48.3
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
 
-`pi install git:github.com/Vt-mmm/piagent@v1.48.1` vẫn hợp lệ nếu chỉ cần cài Pi package. Lệnh đó không tự tạo các binary terminal `piagent-*`; muốn có helper global thì dùng `npm install -g --ignore-scripts @piagent/platform@1.48.1`.
+`pi install git:github.com/Vt-mmm/piagent@v1.48.3` vẫn hợp lệ nếu chỉ cần cài Pi package. Lệnh đó không tự tạo các binary terminal `piagent-*`; muốn có helper global thì dùng `npm install -g --ignore-scripts @piagent/platform@1.48.3`.
 
 Support matrix hiện tại: macOS Apple Silicon + Bash và Linux x64 + Bash đã được verify; macOS Intel + Bash và Linux ARM64 + Bash là supported target cần chạy smoke trước rollout; native Windows chưa phải target rollout team; WSL2 experimental. Chi tiết và version runtime nằm trong [release/install policy](release-install-policy.md).
 
@@ -118,7 +118,7 @@ Nếu muốn commit sẵn `.pi/piagent-profile.json` vào repo hoặc bootstrap
 ```bash
 bash scripts/setup.sh /path/to/project \
   --profile be-readonly-fe \
-  --package-source git:github.com/Vt-mmm/piagent@v1.48.1 \
+  --package-source git:github.com/Vt-mmm/piagent@v1.48.3 \
   --mcp-preset core \
   --subagents-preset safe
 ```

package/docs/harness-conformance.md

@@ -94,10 +94,14 @@ Absent: every step `suggest`, `max_fix_loops` 2. An unknown step value is read a
 
 `suggest` names the repository's checks (AGENTS.md `## Checks`, else what its manifests imply) and never adds a turn. `require` sends a code-changing turn back until a check passes on the final code, at most `max_fix_loops` times, and sends a claim the verify helper marked failed back once before the member decides.
 
+Only the member waives the checks. When the member asks to skip them, the agent calls `waive_checks` with the member's words and the member confirms on an approval card, one time, never for the rest of the conversation. The waiver holds for the code as it is at that moment: the turn is not sent back for checks, and its status reads "no check passed on the final code: the member waived the checks" (outcome `unverified`, `checksWaived` in the status details). Code changed after the waiver needs its checks again. A push still asks the member as in every mode.
+
 - Piagent: `managed-workflow` › required checks and review: the harness sends the agent back until the final patch is checked and clean
 - Piagent: `managed-workflow` › suggested steps never add a turn; a required check that never passes ends the turn as unverified
 - Piagent: `managed-workflow` › a check that fails with an error result is counted as failed, not as passed
 - Piagent: `managed-workflow` › a check that passed before the turn was cut off is still reported as passed
+- Piagent: `managed-check-waiver` › waive_checks asks the member every time and binds the waiver to the current code
+- Piagent: `managed-check-waiver` › the gate stops asking for checks on waived code and reports the waiver; changed code is asked again
 - Piagent: `managed-objections` › under a required verify a failed claim goes back to the agent, is checked again with its answer, and a lasting failure goes to the member
 - Piagent: `managed-objections` › under a suggested verify a failed claim stays the agent's to weigh: no extra turn
 

package/docs/languages.json

@@ -21,8 +21,8 @@
       "en": "README.md",
       "vi": "README.vi.md",
       "consistentAt": {
-        "en": "ee5c4722c566f80160bfa8e9c61954ef305b088f",
-        "vi": "c3cafd3917fc059244d4da4d56026e78d378773c"
+        "en": "bfd3aee2c82c168d74a183fdd75592ea7e57e740",
+        "vi": "8e0fdccb6a575b86492a5f4a66a7d7652e3f738d"
       }
     },
     {

package/docs/operator-manual-vietnamese.md

@@ -19,12 +19,12 @@ Support matrix release hiện tại: macOS Apple Silicon + Bash và Linux x64 +
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0
-npm install -g --ignore-scripts @piagent/platform@1.48.1
+npm install -g --ignore-scripts @piagent/platform@1.48.3
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
 
-Khi seed `.pi/settings.json` cho team/repo cần audit lặp lại, giữ package source dạng pinned tag như `git:github.com/Vt-mmm/piagent@v1.48.1`. Máy cá nhân có thể dùng `git:github.com/Vt-mmm/piagent` để theo latest.
+Khi seed `.pi/settings.json` cho team/repo cần audit lặp lại, giữ package source dạng pinned tag như `git:github.com/Vt-mmm/piagent@v1.48.3`. Máy cá nhân có thể dùng `git:github.com/Vt-mmm/piagent` để theo latest.
 
 Nếu đang ở source checkout của platform, dùng helper theo channel để preview trước khi đổi:
 
@@ -100,7 +100,7 @@ install package once
 
 ```bash
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0
-npm install -g --ignore-scripts @piagent/platform@1.48.1
+npm install -g --ignore-scripts @piagent/platform@1.48.3
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
@@ -285,7 +285,7 @@ Không phải daily default. Dùng khi muốn tạo sẵn `.pi` files cho projec
 bash /path/to/piagent/scripts/setup.sh /path/to/project \
   --project-only \
   --profile auto \
-  --package-source git:github.com/Vt-mmm/piagent@v1.48.1 \
+  --package-source git:github.com/Vt-mmm/piagent@v1.48.3 \
   --mcp-preset core \
   --subagents-preset safe
 ```
@@ -999,8 +999,8 @@ Watchdog là optional adversarial reviewer ở cuối turn, không bật mặc
 
 | Command | Dùng để |
 |---|---|
-| `npm install -g --ignore-scripts @piagent/platform@1.48.1` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
-| `pi install git:github.com/Vt-mmm/piagent@v1.48.1` | Install pinned release cho reproducible team setup. |
+| `npm install -g --ignore-scripts @piagent/platform@1.48.3` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
+| `pi install git:github.com/Vt-mmm/piagent@v1.48.3` | Install pinned release cho reproducible team setup. |
 | `pi install git:github.com/Vt-mmm/piagent` | Install latest platform package cho máy cá nhân/sandbox. |
 | Cài exact Pi host của release, rồi `npm install -g --ignore-scripts @piagent/platform@X.Y.Z` và `piagent-install --stable` | Full update: đồng bộ host, terminal helper và Pi package. Mỗi release pin một Pi host chính xác; lấy đúng version của release đang cài trong [release/install policy](release-install-policy.md). |
 | Cài exact Pi host ghi trong release cũ, rồi helper `vPREVIOUS` và `piagent-install --stable` | Full rollback; đánh giá lại dependency findings của host cũ trước khi hạ version. |
@@ -1096,7 +1096,7 @@ Mở lại Pi session sau khi install.
 Cài lại terminal helper đúng release rồi kiểm tra `PATH`:
 
 ```bash
-npm install -g --ignore-scripts @piagent/platform@1.48.1
+npm install -g --ignore-scripts @piagent/platform@1.48.3
 command -v piagent-install
 ```
 

package/docs/publishing-for-teams.md

@@ -41,6 +41,8 @@ pi install /path/to/piagent
 
 ## Versioning
 
+- `1.48.2`: Terminal nạp bản mới không cần đóng: `piagent reload`, và `piagent-update` tự yêu cầu, để mọi Terminal đang mở (`piagent`, `piagent studio`) nạp bản đã cài khi rảnh, giữ nguyên cuộc trò chuyện, task đang chạy xong trước; chỉ member được bỏ qua kiểm tra bắt buộc của team, trên thẻ duyệt, cho đúng code lúc đó.
+- `1.48.3`: Agent gửi thẳng hình và file vào chat bằng `![tên](đường/dẫn)`; SVG mở ra hình, có nút xem mã và tải về; ảnh đính kèm là thumbnail lớn, bấm xem được; review chạy được trong thư mục chứa nhiều repo.
 - `1.48.1`: Dashboard trả lời nhanh hơn: cuộc trò chuyện mới dùng model và mức suy nghĩ đã chọn ở Terminal, tin nhắn đầu tiên luôn được gửi; Enter trong Terminal hiện tin nhắn ngay vì trạng thái repository được đọc ở nền và sự kiện phiên không còn ép ghi đĩa từng lần.
 - `1.48.0`: Bypass dừng ở bước bàn giao: mọi chế độ hỏi trước khi push, tạo hoặc merge pull request, publish, deploy, chạy `ssh` hay tool cloud, upload, và trước công cụ MCP ghi ra ngoài; lệnh được kiểm tra thêm bằng cây cú pháp shell; thẻ duyệt có bốn lựa chọn (một lần, cả session, từ chối, từ chối và dừng lượt); `autoDeny` trong profile chặn lệnh ở mọi chế độ; dashboard stream mượt hơn.
 - `1.47.0`: phiên công ty dùng các MCP server dev đã cài cho Piagent (cùng login; server do repo khai báo vẫn cần duyệt), thêm preset `atlassian` cho Jira và Confluence Cloud; tool `run_on_simulator` cho agent tự boot simulator iOS/Android, build, cài, mở app, chạy XCUITest, chụp màn hình và đọc log.

package/docs/release-install-policy.md

@@ -155,7 +155,7 @@ Use this flow when the team needs both terminal commands and the Pi package:
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0
-npm install -g --ignore-scripts @piagent/platform@1.48.1
+npm install -g --ignore-scripts @piagent/platform@1.48.3
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
@@ -181,7 +181,7 @@ bash scripts/install-global.sh --stable
 Use this only when terminal commands are not needed:
 
 ```bash
-pi install git:github.com/Vt-mmm/piagent@v1.48.1
+pi install git:github.com/Vt-mmm/piagent@v1.48.3
 ```
 
 Direct `pi install` does not create `piagent-*` commands on `PATH`.

package/docs/team-onboarding.md

@@ -10,7 +10,7 @@ Một thành viên mới không cần biết local path của maintainer. Luồn
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0
-npm install -g --ignore-scripts @piagent/platform@1.48.1
+npm install -g --ignore-scripts @piagent/platform@1.48.3
 piagent-install --stable
 cd /path/to/project
 pi
@@ -45,7 +45,7 @@ Mặc định team dùng stable helper:
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0
-npm install -g --ignore-scripts @piagent/platform@1.48.1
+npm install -g --ignore-scripts @piagent/platform@1.48.3
 piagent-install --stable --dry-run
 piagent-install --stable
 ```

package/docs-site/architecture.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.1" title="v1.48.1 docs · VI"><span class="dot"></span>v1.48.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.3" title="v1.48.3 docs · VI"><span class="dot"></span>v1.48.3</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new">Changelog</a>

package/docs-site/assets/search-en.json

@@ -1 +1 @@
-[{"href":"/en/","icon":"home","group":"Get started","nav":"Overview","title":"Pi Agent Platform","lead":"A coding agent for the whole team: a guard checks every tool call, the team's Harness runs checks and review, one dashboard for Terminal and the browser.","headings":[{"id":"different","text":"The agent works fast. The platform keeps it right."},{"id":"one-turn","text":"You say what you need. The rest is verified."},{"id":"screens","text":"Captured from a running dashboard"},{"id":"two-modes","text":"One dashboard, two ways to use models"},{"id":"install","text":"Running in two minutes"},{"id":"latest-updates","text":"Steady releases, every change written down"}]},{"href":"/en/ecosystem","icon":"network","group":"Get started","nav":"Ecosystem","title":"Piagent, Agent Watch and Agent Studio","lead":"What runs on your machine, what runs on the company server, and when to use your own model or the company's.","headings":[{"id":"overview","text":"One dashboard, two ways to use models"},{"id":"parts","text":"Each part does one job"},{"id":"piagent","text":"Piagent"},{"id":"guard","text":"Guard"},{"id":"agent-watch","text":"Agent Watch"},{"id":"agent-studio","text":"Agent Studio"},{"id":"one-turn","text":"From a message to \"A check passed · Review found no blocking issue\""},{"id":"choose","text":"When to use personal, when to use company"}]},{"href":"/en/quickstart","icon":"rocket","group":"Get started","nav":"Install","title":"Install and run your first turn","lead":"Two commands to install. Open a repository, pick its profile and permissions, then ask in plain language.","headings":[{"id":"install","text":"Install"},{"id":"open-project","text":"Open a project"},{"id":"read-project","text":"Let the agent read the project"},{"id":"profile-and-permission","text":"Pick a profile and permission"},{"id":"ask","text":"Ask in plain language"},{"id":"check","text":"Check the installation"},{"id":"supported","text":"Supported systems"},{"id":"next","text":"Next"}]},{"href":"/en/windows","icon":"windows","group":"Get started","nav":"Windows","title":"Install on Windows with one command","lead":"One PowerShell command installs WSL2, Ubuntu, Piagent and Agent Watch, binds the company key and adds Piagent to the Start menu. Run it again to update.","headings":[{"id":"one-command","text":"Install with one command"},{"id":"every-day","text":"Every day"},{"id":"when-setup-fails","text":"When setup fails"},{"id":"why-wsl2","text":"Why WSL2"}]},{"href":"/en/update","icon":"refresh","group":"Get started","nav":"Update & uninstall","title":"Update, roll back and uninstall","lead":"One command moves to a new release, and the dashboard and Terminal tell you when one is out. Rollback and uninstall both preview first.","headings":[{"id":"update","text":"Update"},{"id":"what-it-does","text":"What it does, in order"},{"id":"options","text":"Common options"},{"id":"pin-for-a-team","text":"Pin one release for a team"},{"id":"rollback","text":"Roll back"},{"id":"uninstall","text":"Uninstall"},{"id":"windows","text":"On Windows"}]},{"href":"/en/whats-new","icon":"sparkles","group":"Get started","nav":"Changelog","title":"Changelog","lead":"Every release: what changed and which Studio or Agent Watch it needs. Newest first.","headings":[{"id":"latest","text":"Latest"},{"id":"v1-48-1-title","text":"Faster first replies on the dashboard and an instant Enter in the Terminal"},{"id":"v1-48-0-title","text":"Bypass stops at the handoff: every mode asks before work leaves the machine"},{"id":"v1-47-0-title","text":"Company sessions use your MCP servers and drive iOS and Android simulators"},{"id":"v1-46-4-title","text":"One subagent instead of a refused request; update reads a commented models.json"},{"id":"v1-46-3-title","text":"One subagent instead of a refused request; update reads a commented models.json not published"},{"id":"v1-46-2-title","text":"A message sent after an answer shows at once; the WebUI streams word by word"},{"id":"v1-46-1-title","text":"Objections on the record, one review per turn, parallel subagents on request"},{"id":"v1-46-0-title","text":"Piagent runs from its own Pi home and your own pi stays stock"},{"id":"v1-45-0-title","text":"Files and images in a prompt follow the read policy, and the terminal stays responsive"},{"id":"v1-44-4-title","text":"Company conversations come back in Herdr panes"},{"id":"v1-44-3-title","text":"Prompt injection cannot quietly read the system"},{"id":"v1-44-2-title","text":"The company harness follows the size of a change"},{"id":"v1-44-1-title","text":"Your own Pi stays, pick a Terminal style, add skill repositories"},{"id":"v1-44-0-title","text":"Your own Pi stays, pick a Terminal style, add skill repositories not published"},{"id":"v1-43-9-title","text":"Every installed skill, and files the agent hands back"},{"id":"v1-43-8-title","text":"Every installed skill, and files the agent hands back not published"},{"id":"v1-43-7-title","text":"Every installed skill, and files the agent hands back not published"},{"id":"v1-43-6-title","text":"Watch the agent's edits while it runs"},{"id":"v1-43-5-title","text":"Image previews and office attachments"},{"id":"v1-43-4-title","text":"Your workflow, with adaptive backend and frontend support"},{"id":"v1-43-3-title","text":"Your workflow, with adaptive backend and frontend support not published"},{"id":"v1-43-2-title","text":"Your workflow, with adaptive backend and frontend support not published"},{"id":"v1-43-1-title","text":"Your workflow, with adaptive backend and frontend support not published"},{"id":"v1-43-0-title","text":"Your workflow, with adaptive backend and frontend support not published"},{"id":"archive","text":"Earlier releases"}]},{"href":"/en/scope","icon":"target","group":"Get started","nav":"Platform scope","title":"What the platform owns","lead":"Every agent has governance primitives. This platform packages one repeatable operating model on Pi for every repository.","headings":[{"id":"not-a-new-agent","text":"This is not a new agent"},{"id":"complementary-layers","text":"The two layers are complementary"},{"id":"lower-layer","text":"The lower layer sees processes"},{"id":"upper-layer","text":"The upper layer sees intent"},{"id":"when-not-needed","text":"When you may not need it"}]},{"href":"/en/profiles","icon":"sliders","group":"Build","nav":"Project profiles","title":"Choose the right profile","lead":"A profile sets protected paths, verification commands and the capabilities a repository is granted.","headings":[]},{"href":"/en/permissions","icon":"key","group":"Build","nav":"Permission modes","title":"Change permissions per task","lead":"Permission modes apply to the current session only. Changing one does not modify the project profile.","headings":[]},{"href":"/en/commands","icon":"terminal","group":"Build","nav":"Command catalog","title":"Short commands, predictable behaviour","lead":"Slash commands package policy and flow, with one inspector for diffs, commands, safety and context.","headings":[{"id":"session-basics","text":"Session basics"},{"id":"project-profile","text":"Project profile"},{"id":"implementation-workflow","text":"Assigning work"},{"id":"git-handoff","text":"Git handoff"},{"id":"fresh-sessions","text":"New sessions"},{"id":"mcp","text":"MCP"},{"id":"subagents","text":"Subagents"},{"id":"product-status-commands","text":"Inspect runtime decisions"},{"id":"skills-and-packages","text":"Audit test quality, run experiment loops"}]},{"href":"/en/workflows","icon":"branch","group":"Build","nav":"Workflows","title":"Day-to-day work","lead":"No workflow launchers: say what you need in plain language. Inspection commands only observe and never start a model turn.","headings":[{"id":"conclusion","text":"No new command is mandatory in the daily flow"},{"id":"command-effects","text":"How far the inspection commands affect a workflow"},{"id":"example-flow","text":"A complete flow can look like this"}]},{"href":"/en/mcp","icon":"plug","group":"MCP","nav":"MCP overview","title":"MCP in Pi Agent Platform","lead":"The platform installs pi-mcp-adapter for token-efficient MCP access and manages servers across four configuration layers.","headings":[{"id":"start","text":"Where to start"},{"id":"three-similar-names","text":"Three similar names that are not connected"},{"id":"four-config-layers","text":"Four configuration layers"},{"id":"presets","text":"Pinned presets"},{"id":"company-sessions","text":"In company sessions"},{"id":"token-efficiency","text":"Token efficiency"}]},{"href":"/en/mcp-servers","icon":"server","group":"MCP","nav":"Server management","title":"Add, inspect and remove MCP servers","lead":"piagent-mcp provides add, remove, get, list, enable and disable across all four scopes.","headings":[{"id":"two-surfaces","text":"Two surfaces for two contexts"},{"id":"commands","text":"Commands"},{"id":"in-session","text":"In a session"},{"id":"add-server","text":"Add a server"},{"id":"inspect","text":"Inspect"},{"id":"disable-remove","text":"Disable and remove"},{"id":"preset-command","text":"Preset"},{"id":"output","text":"Output names the modified file"},{"id":"updates","text":"Custom servers and updates"},{"id":"preserved","text":"Preserved"},{"id":"overwritten","text":"Replaced"}]},{"href":"/en/mcp-auth","icon":"lock","group":"MCP","nav":"Authentication","title":"Authentication and readiness","lead":"The platform stores no tokens and runs no OAuth. It rejects secrets in configuration and reports which servers are actually ready.","headings":[{"id":"no-token-storage","text":"The platform does not store tokens"},{"id":"reject-secrets","text":"Secrets are rejected before configuration is written"},{"id":"field-name","text":"Field-name detection"},{"id":"value-shape","text":"Value-shape detection"},{"id":"readiness","text":"Readiness states"}]},{"href":"/en/mcp-approval","icon":"shield-check","group":"MCP","nav":"Approval gate","title":"Repository servers require approval","lead":"Cloning an untrusted repository must not give its author a process on your machine. Decisions live outside the repository, pinned by digest.","headings":[{"id":"problem","text":"The problem"},{"id":"three-properties","text":"Three properties"},{"id":"outside-repository","text":"The decision lives outside the repository"},{"id":"digest-pinning","text":"Pinned by digest"},{"id":"tool-call-enforcement","text":"Enforced at tool call"},{"id":"limit","text":"Limit"},{"id":"imports","text":"Servers supplied through imports"},{"id":"design-decisions","text":"Design decisions"},{"id":"migration","text":"Migration"}]},{"href":"/en/security","icon":"shield","group":"Operate","nav":"Security model","title":"Policy enforcement, not an OS sandbox","lead":"Controlled tool surfaces fail closed when profiles, integrity locks or permissions are invalid.","headings":[{"id":"protected-paths","text":"Protected paths"},{"id":"shell-hardening","text":"Shell hardening"},{"id":"secret-redaction","text":"Secret redaction"},{"id":"capability-lock","text":"Capability lock"},{"id":"human-action-gate","text":"Human-action gate"},{"id":"verify-evidence","text":"Real checks"}]},{"href":"/en/architecture","icon":"layers","group":"Operate","nav":"Architecture","title":"Repository architecture","lead":"Core holds reusable policy and runtime infrastructure; business logic stays in the project that owns it.","headings":[{"id":"composition","text":"Composition"},{"id":"runtime-adapters","text":"Runtime adapters"},{"id":"core-services","text":"Core services"},{"id":"integrations","text":"Integrations"},{"id":"entrypoints","text":"Entrypoints"},{"id":"product-assets","text":"Product assets"},{"id":"adaptive-runtime","text":"Piagent now separates runtime decisions from Pi wiring"},{"id":"state-ownership","text":"Each state has one source of truth"}]},{"href":"/en/context-engine","icon":"cpu","group":"Operate","nav":"Context Engine","title":"Less context, same model quality","lead":"Local indexing, ranked retrieval, task-driven tool loading, semantic compaction and transparent telemetry.","headings":[{"id":"dynamic-tools","text":"Task-driven tools"},{"id":"local-index","text":"Local index"},{"id":"ranked-context","text":"Ranked context"},{"id":"semantic-compact","text":"Semantic compaction"},{"id":"test-impact","text":"Test impact"},{"id":"agent-watch","text":"Agent Watch"}]},{"href":"/en/benchmark","icon":"chart","group":"Operate","nav":"Benchmark","title":"Quality and efficiency evidence","lead":"Piagent against codex-cli on the same model and thinking level: 18 task families, 108 automatically graded sessions.","headings":[{"id":"benchmark-verdict","text":"Historical fresh-token score: 9.97/10"},{"id":"configuration","text":"Same model, same tasks, automatic grading"},{"id":"scores","text":"Token reduction does not trade away quality"},{"id":"tokens","text":"Measure the fixed workload, not only successful tasks"},{"id":"coverage","text":"Six domains with three families each"},{"id":"benchmark-bands","text":"Use the right suite for the decision"},{"id":"transparency","text":"Interpret results within their measured scope"},{"id":"historical-v1-2-12","text":"v1.2.12 remains historical evidence"}]},{"href":"/en/runtime","icon":"wrench","group":"Operate","nav":"Runtime tools","title":"Terminal commands for operators","lead":"Commands that run outside Pi: setup, updates, doctor, benchmarks, capabilities and MCP.","headings":[]},{"href":"/en/team","icon":"users","group":"Operate","nav":"Team usage","title":"One operating standard for the team","lead":"Each repository links the package, selects a fitting profile and keeps project documentation in its own repository.","headings":[{"id":"do","text":"Do"},{"id":"avoid","text":"Avoid"}]}]
+[{"href":"/en/","icon":"home","group":"Get started","nav":"Overview","title":"Pi Agent Platform","lead":"A coding agent for the whole team: a guard checks every tool call, the team's Harness runs checks and review, one dashboard for Terminal and the browser.","headings":[{"id":"different","text":"The agent works fast. The platform keeps it right."},{"id":"one-turn","text":"You say what you need. The rest is verified."},{"id":"screens","text":"Captured from a running dashboard"},{"id":"two-modes","text":"One dashboard, two ways to use models"},{"id":"install","text":"Running in two minutes"},{"id":"latest-updates","text":"Steady releases, every change written down"}]},{"href":"/en/ecosystem","icon":"network","group":"Get started","nav":"Ecosystem","title":"Piagent, Agent Watch and Agent Studio","lead":"What runs on your machine, what runs on the company server, and when to use your own model or the company's.","headings":[{"id":"overview","text":"One dashboard, two ways to use models"},{"id":"parts","text":"Each part does one job"},{"id":"piagent","text":"Piagent"},{"id":"guard","text":"Guard"},{"id":"agent-watch","text":"Agent Watch"},{"id":"agent-studio","text":"Agent Studio"},{"id":"one-turn","text":"From a message to \"A check passed · Review found no blocking issue\""},{"id":"choose","text":"When to use personal, when to use company"}]},{"href":"/en/quickstart","icon":"rocket","group":"Get started","nav":"Install","title":"Install and run your first turn","lead":"Two commands to install. Open a repository, pick its profile and permissions, then ask in plain language.","headings":[{"id":"install","text":"Install"},{"id":"open-project","text":"Open a project"},{"id":"read-project","text":"Let the agent read the project"},{"id":"profile-and-permission","text":"Pick a profile and permission"},{"id":"ask","text":"Ask in plain language"},{"id":"check","text":"Check the installation"},{"id":"supported","text":"Supported systems"},{"id":"next","text":"Next"}]},{"href":"/en/windows","icon":"windows","group":"Get started","nav":"Windows","title":"Install on Windows with one command","lead":"One PowerShell command installs WSL2, Ubuntu, Piagent and Agent Watch, binds the company key and adds Piagent to the Start menu. Run it again to update.","headings":[{"id":"one-command","text":"Install with one command"},{"id":"every-day","text":"Every day"},{"id":"when-setup-fails","text":"When setup fails"},{"id":"why-wsl2","text":"Why WSL2"}]},{"href":"/en/update","icon":"refresh","group":"Get started","nav":"Update & uninstall","title":"Update, roll back and uninstall","lead":"One command moves to a new release, and the dashboard and Terminal tell you when one is out. Rollback and uninstall both preview first.","headings":[{"id":"update","text":"Update"},{"id":"open-terminals","text":"Open Terminals"},{"id":"what-it-does","text":"What it does, in order"},{"id":"options","text":"Common options"},{"id":"pin-for-a-team","text":"Pin one release for a team"},{"id":"rollback","text":"Roll back"},{"id":"uninstall","text":"Uninstall"},{"id":"windows","text":"On Windows"}]},{"href":"/en/whats-new","icon":"sparkles","group":"Get started","nav":"Changelog","title":"Changelog","lead":"Every release: what changed and which Studio or Agent Watch it needs. Newest first.","headings":[{"id":"latest","text":"Latest"},{"id":"v1-48-3-title","text":"The agent sends pictures and files into the chat; reviews run across several repositories"},{"id":"v1-48-2-title","text":"Terminals load a new release without closing; only the member waives checks"},{"id":"v1-48-1-title","text":"Faster first replies on the dashboard and an instant Enter in the Terminal"},{"id":"v1-48-0-title","text":"Bypass stops at the handoff: every mode asks before work leaves the machine"},{"id":"v1-47-0-title","text":"Company sessions use your MCP servers and drive iOS and Android simulators"},{"id":"v1-46-4-title","text":"One subagent instead of a refused request; update reads a commented models.json"},{"id":"v1-46-3-title","text":"One subagent instead of a refused request; update reads a commented models.json not published"},{"id":"v1-46-2-title","text":"A message sent after an answer shows at once; the WebUI streams word by word"},{"id":"v1-46-1-title","text":"Objections on the record, one review per turn, parallel subagents on request"},{"id":"v1-46-0-title","text":"Piagent runs from its own Pi home and your own pi stays stock"},{"id":"v1-45-0-title","text":"Files and images in a prompt follow the read policy, and the terminal stays responsive"},{"id":"v1-44-4-title","text":"Company conversations come back in Herdr panes"},{"id":"v1-44-3-title","text":"Prompt injection cannot quietly read the system"},{"id":"v1-44-2-title","text":"The company harness follows the size of a change"},{"id":"v1-44-1-title","text":"Your own Pi stays, pick a Terminal style, add skill repositories"},{"id":"v1-44-0-title","text":"Your own Pi stays, pick a Terminal style, add skill repositories not published"},{"id":"v1-43-9-title","text":"Every installed skill, and files the agent hands back"},{"id":"v1-43-8-title","text":"Every installed skill, and files the agent hands back not published"},{"id":"v1-43-7-title","text":"Every installed skill, and files the agent hands back not published"},{"id":"v1-43-6-title","text":"Watch the agent's edits while it runs"},{"id":"v1-43-5-title","text":"Image previews and office attachments"},{"id":"v1-43-4-title","text":"Your workflow, with adaptive backend and frontend support"},{"id":"v1-43-3-title","text":"Your workflow, with adaptive backend and frontend support not published"},{"id":"v1-43-2-title","text":"Your workflow, with adaptive backend and frontend support not published"},{"id":"archive","text":"Earlier releases"}]},{"href":"/en/scope","icon":"target","group":"Get started","nav":"Platform scope","title":"What the platform owns","lead":"Every agent has governance primitives. This platform packages one repeatable operating model on Pi for every repository.","headings":[{"id":"not-a-new-agent","text":"This is not a new agent"},{"id":"complementary-layers","text":"The two layers are complementary"},{"id":"lower-layer","text":"The lower layer sees processes"},{"id":"upper-layer","text":"The upper layer sees intent"},{"id":"when-not-needed","text":"When you may not need it"}]},{"href":"/en/profiles","icon":"sliders","group":"Build","nav":"Project profiles","title":"Choose the right profile","lead":"A profile sets protected paths, verification commands and the capabilities a repository is granted.","headings":[]},{"href":"/en/permissions","icon":"key","group":"Build","nav":"Permission modes","title":"Change permissions per task","lead":"Permission modes apply to the current session only. Changing one does not modify the project profile.","headings":[]},{"href":"/en/commands","icon":"terminal","group":"Build","nav":"Command catalog","title":"Short commands, predictable behaviour","lead":"Slash commands package policy and flow, with one inspector for diffs, commands, safety and context.","headings":[{"id":"session-basics","text":"Session basics"},{"id":"project-profile","text":"Project profile"},{"id":"implementation-workflow","text":"Assigning work"},{"id":"git-handoff","text":"Git handoff"},{"id":"fresh-sessions","text":"New sessions"},{"id":"mcp","text":"MCP"},{"id":"subagents","text":"Subagents"},{"id":"product-status-commands","text":"Inspect runtime decisions"},{"id":"skills-and-packages","text":"Audit test quality, run experiment loops"}]},{"href":"/en/workflows","icon":"branch","group":"Build","nav":"Workflows","title":"Day-to-day work","lead":"No workflow launchers: say what you need in plain language. Inspection commands only observe and never start a model turn.","headings":[{"id":"conclusion","text":"No new command is mandatory in the daily flow"},{"id":"command-effects","text":"How far the inspection commands affect a workflow"},{"id":"example-flow","text":"A complete flow can look like this"}]},{"href":"/en/mcp","icon":"plug","group":"MCP","nav":"MCP overview","title":"MCP in Pi Agent Platform","lead":"The platform installs pi-mcp-adapter for token-efficient MCP access and manages servers across four configuration layers.","headings":[{"id":"start","text":"Where to start"},{"id":"three-similar-names","text":"Three similar names that are not connected"},{"id":"four-config-layers","text":"Four configuration layers"},{"id":"presets","text":"Pinned presets"},{"id":"company-sessions","text":"In company sessions"},{"id":"token-efficiency","text":"Token efficiency"}]},{"href":"/en/mcp-servers","icon":"server","group":"MCP","nav":"Server management","title":"Add, inspect and remove MCP servers","lead":"piagent-mcp provides add, remove, get, list, enable and disable across all four scopes.","headings":[{"id":"two-surfaces","text":"Two surfaces for two contexts"},{"id":"commands","text":"Commands"},{"id":"in-session","text":"In a session"},{"id":"add-server","text":"Add a server"},{"id":"inspect","text":"Inspect"},{"id":"disable-remove","text":"Disable and remove"},{"id":"preset-command","text":"Preset"},{"id":"output","text":"Output names the modified file"},{"id":"updates","text":"Custom servers and updates"},{"id":"preserved","text":"Preserved"},{"id":"overwritten","text":"Replaced"}]},{"href":"/en/mcp-auth","icon":"lock","group":"MCP","nav":"Authentication","title":"Authentication and readiness","lead":"The platform stores no tokens and runs no OAuth. It rejects secrets in configuration and reports which servers are actually ready.","headings":[{"id":"no-token-storage","text":"The platform does not store tokens"},{"id":"reject-secrets","text":"Secrets are rejected before configuration is written"},{"id":"field-name","text":"Field-name detection"},{"id":"value-shape","text":"Value-shape detection"},{"id":"readiness","text":"Readiness states"}]},{"href":"/en/mcp-approval","icon":"shield-check","group":"MCP","nav":"Approval gate","title":"Repository servers require approval","lead":"Cloning an untrusted repository must not give its author a process on your machine. Decisions live outside the repository, pinned by digest.","headings":[{"id":"problem","text":"The problem"},{"id":"three-properties","text":"Three properties"},{"id":"outside-repository","text":"The decision lives outside the repository"},{"id":"digest-pinning","text":"Pinned by digest"},{"id":"tool-call-enforcement","text":"Enforced at tool call"},{"id":"limit","text":"Limit"},{"id":"imports","text":"Servers supplied through imports"},{"id":"design-decisions","text":"Design decisions"},{"id":"migration","text":"Migration"}]},{"href":"/en/security","icon":"shield","group":"Operate","nav":"Security model","title":"Policy enforcement, not an OS sandbox","lead":"Controlled tool surfaces fail closed when profiles, integrity locks or permissions are invalid.","headings":[{"id":"protected-paths","text":"Protected paths"},{"id":"shell-hardening","text":"Shell hardening"},{"id":"secret-redaction","text":"Secret redaction"},{"id":"capability-lock","text":"Capability lock"},{"id":"human-action-gate","text":"Human-action gate"},{"id":"verify-evidence","text":"Real checks"}]},{"href":"/en/architecture","icon":"layers","group":"Operate","nav":"Architecture","title":"Repository architecture","lead":"Core holds reusable policy and runtime infrastructure; business logic stays in the project that owns it.","headings":[{"id":"composition","text":"Composition"},{"id":"runtime-adapters","text":"Runtime adapters"},{"id":"core-services","text":"Core services"},{"id":"integrations","text":"Integrations"},{"id":"entrypoints","text":"Entrypoints"},{"id":"product-assets","text":"Product assets"},{"id":"adaptive-runtime","text":"Piagent now separates runtime decisions from Pi wiring"},{"id":"state-ownership","text":"Each state has one source of truth"}]},{"href":"/en/context-engine","icon":"cpu","group":"Operate","nav":"Context Engine","title":"Less context, same model quality","lead":"Local indexing, ranked retrieval, task-driven tool loading, semantic compaction and transparent telemetry.","headings":[{"id":"dynamic-tools","text":"Task-driven tools"},{"id":"local-index","text":"Local index"},{"id":"ranked-context","text":"Ranked context"},{"id":"semantic-compact","text":"Semantic compaction"},{"id":"test-impact","text":"Test impact"},{"id":"agent-watch","text":"Agent Watch"}]},{"href":"/en/benchmark","icon":"chart","group":"Operate","nav":"Benchmark","title":"Quality and efficiency evidence","lead":"Piagent against codex-cli on the same model and thinking level: 18 task families, 108 automatically graded sessions.","headings":[{"id":"benchmark-verdict","text":"Historical fresh-token score: 9.97/10"},{"id":"configuration","text":"Same model, same tasks, automatic grading"},{"id":"scores","text":"Token reduction does not trade away quality"},{"id":"tokens","text":"Measure the fixed workload, not only successful tasks"},{"id":"coverage","text":"Six domains with three families each"},{"id":"benchmark-bands","text":"Use the right suite for the decision"},{"id":"transparency","text":"Interpret results within their measured scope"},{"id":"historical-v1-2-12","text":"v1.2.12 remains historical evidence"}]},{"href":"/en/runtime","icon":"wrench","group":"Operate","nav":"Runtime tools","title":"Terminal commands for operators","lead":"Commands that run outside Pi: setup, updates, doctor, benchmarks, capabilities and MCP.","headings":[]},{"href":"/en/team","icon":"users","group":"Operate","nav":"Team usage","title":"One operating standard for the team","lead":"Each repository links the package, selects a fitting profile and keeps project documentation in its own repository.","headings":[{"id":"do","text":"Do"},{"id":"avoid","text":"Avoid"}]}]

package/docs-site/assets/search-vi.json

@@ -1 +1 @@
-[{"href":"/","icon":"home","group":"Bắt đầu","nav":"Tổng quan","title":"Pi Agent Platform","lead":"Coding agent cho cả team: guard kiểm tra mọi tool call, Harness của team tự chạy check và review, một dashboard cho Terminal và trình duyệt.","headings":[{"id":"khac-biet","text":"Agent làm nhanh. Platform giữ cho nó làm đúng."},{"id":"mot-luot","text":"Bạn nói việc. Phần còn lại có kiểm chứng."},{"id":"man-hinh","text":"Chụp từ dashboard đang chạy"},{"id":"hai-che-do","text":"Cùng một dashboard, hai cách dùng model"},{"id":"cai-dat","text":"Chạy trong hai phút"},{"id":"moi-cap-nhat","text":"Phát hành đều, ghi rõ từng thay đổi"}]},{"href":"/ecosystem","icon":"network","group":"Bắt đầu","nav":"Hệ sinh thái","title":"Piagent, Agent Watch và Agent Studio","lead":"Phần nào chạy trên máy bạn, phần nào ở máy chủ công ty, và khi nào dùng model cá nhân hay model của công ty.","headings":[{"id":"toan-canh","text":"Một dashboard, hai cách dùng model"},{"id":"thanh-phan","text":"Mỗi phần làm một việc"},{"id":"piagent","text":"Piagent"},{"id":"guard","text":"Guard"},{"id":"agent-watch","text":"Agent Watch"},{"id":"agent-studio","text":"Agent Studio"},{"id":"mot-luot","text":"Từ tin nhắn tới \"Check đã qua · Review không có lỗi chặn\""},{"id":"chon-che-do","text":"Khi nào dùng cá nhân, khi nào dùng công ty"}]},{"href":"/quickstart","icon":"rocket","group":"Bắt đầu","nav":"Cài đặt","title":"Cài đặt và chạy lượt đầu tiên","lead":"Hai lệnh để cài. Mở repo, chọn profile và quyền, rồi nói việc bằng lời thường.","headings":[{"id":"cai-dat","text":"Cài đặt"},{"id":"mo-project","text":"Mở project"},{"id":"doc-project","text":"Cho agent đọc project"},{"id":"profile-va-quyen","text":"Chọn profile và quyền"},{"id":"giao-viec","text":"Giao việc bằng lời thường"},{"id":"kiem-tra","text":"Kiểm tra cài đặt"},{"id":"ho-tro","text":"Hệ điều hành được hỗ trợ"},{"id":"tiep-theo","text":"Tiếp theo"}]},{"href":"/windows","icon":"windows","group":"Bắt đầu","nav":"Cài trên Windows","title":"Cài trên Windows bằng một lệnh","lead":"Một lệnh PowerShell cài WSL2, Ubuntu, Piagent và Agent Watch, nối key công ty và thêm Piagent vào Start menu. Chạy lại để cập nhật.","headings":[{"id":"cai-mot-lenh","text":"Cài bằng một lệnh"},{"id":"dung-hang-ngay","text":"Dùng hằng ngày"},{"id":"khi-cai-bi-loi","text":"Khi cài bị lỗi"},{"id":"vi-sao-wsl2","text":"Vì sao là WSL2"}]},{"href":"/update","icon":"refresh","group":"Bắt đầu","nav":"Cập nhật và gỡ","title":"Cập nhật, rollback và gỡ cài đặt","lead":"Một lệnh để lên bản mới, dashboard và Terminal tự báo khi có bản mới. Rollback và gỡ cài đặt đều có bước xem trước.","headings":[{"id":"cap-nhat","text":"Cập nhật"},{"id":"cap-nhat-lam-gi","text":"Lệnh này làm gì, theo thứ tự"},{"id":"tuy-chon","text":"Tuỳ chọn thường dùng"},{"id":"pin-cho-team","text":"Pin một bản cho cả team"},{"id":"rollback","text":"Rollback"},{"id":"go-cai-dat","text":"Gỡ cài đặt"},{"id":"windows","text":"Trên Windows"}]},{"href":"/whats-new","icon":"sparkles","group":"Bắt đầu","nav":"Changelog","title":"Changelog","lead":"Mỗi bản phát hành: thay đổi gì, cần bản nào của Studio hay Agent Watch. Bản mới nhất ở trên cùng.","headings":[{"id":"latest","text":"Mới nhất"},{"id":"v1-48-1-title","text":"Dashboard trả lời nhanh hơn, Enter trong Terminal hiện tin nhắn ngay"},{"id":"v1-48-0-title","text":"Bypass dừng ở bước bàn giao: mọi chế độ hỏi trước khi việc rời khỏi máy"},{"id":"v1-47-0-title","text":"Phiên công ty dùng MCP server của bạn và điều khiển simulator iOS, Android"},{"id":"v1-46-4-title","text":"Một subagent thay vì bị chặn; bản cập nhật đọc được models.json có comment"},{"id":"v1-46-3-title","text":"Một subagent thay vì bị chặn; bản cập nhật đọc được models.json có comment không phát hành"},{"id":"v1-46-2-title","text":"Tin gửi sau câu trả lời hiện ngay; WebUI hiện chữ dần"},{"id":"v1-46-1-title","text":"Phản biện có sổ ghi, review một nhịp, subagent song song khi được yêu cầu"},{"id":"v1-46-0-title","text":"Piagent chạy trong Pi home riêng, pi của bạn giữ nguyên bản gốc"},{"id":"v1-45-0-title","text":"File và ảnh trong prompt theo đúng quyền đọc, terminal không còn đứng hình"},{"id":"v1-44-4-title","text":"Conversation công ty trở lại trong pane Herdr"},{"id":"v1-44-3-title","text":"Prompt injection không lặng lẽ đọc được hệ thống"},{"id":"v1-44-2-title","text":"Harness công ty theo cỡ thay đổi"},{"id":"v1-44-1-title","text":"Giữ Pi của bạn, chọn giao diện Terminal, thêm repo skill"},{"id":"v1-44-0-title","text":"Giữ Pi của bạn, chọn giao diện Terminal, thêm repo skill không phát hành"},{"id":"v1-43-9-title","text":"Đủ skill đã cài, và mở file agent gửi lại"},{"id":"v1-43-8-title","text":"Đủ skill đã cài, và mở file agent gửi lại không phát hành"},{"id":"v1-43-7-title","text":"Đủ skill đã cài, và mở file agent gửi lại không phát hành"},{"id":"v1-43-6-title","text":"Xem thay đổi của agent ngay khi đang chạy"},{"id":"v1-43-5-title","text":"Xem trước ảnh và đính kèm file văn phòng"},{"id":"v1-43-4-title","text":"Dev chọn workflow, harness hỗ trợ BE/FE theo project"},{"id":"v1-43-3-title","text":"Dev chọn workflow, harness hỗ trợ BE/FE theo project không phát hành"},{"id":"v1-43-2-title","text":"Dev chọn workflow, harness hỗ trợ BE/FE theo project không phát hành"},{"id":"v1-43-1-title","text":"Dev chọn workflow, harness hỗ trợ BE/FE theo project không phát hành"},{"id":"v1-43-0-title","text":"Dev chọn workflow, harness hỗ trợ BE/FE theo project không phát hành"},{"id":"archive","text":"Các bản trước"}]},{"href":"/scope","icon":"target","group":"Bắt đầu","nav":"Phạm vi platform","title":"Platform nhận phần nào về mình","lead":"Agent nào cũng có cơ chế governance riêng. Platform này đóng gói một cách vận hành cụ thể trên Pi để mọi repo dùng lại.","headings":[{"id":"khong-phai-agent-moi","text":"Đây không phải một agent mới"},{"id":"hai-lop-khong-thay-the-nhau","text":"Hai lớp không thay thế nhau"},{"id":"lop-duoi","text":"Lớp dưới thấy process"},{"id":"lop-tren","text":"Lớp trên thấy ý định"},{"id":"khi-nao-khong-can","text":"Khi nào không cần"}]},{"href":"/profiles","icon":"sliders","group":"Sử dụng","nav":"Project profile","title":"Chọn đúng profile cho repo","lead":"Profile quyết định protected path, verify command và capability mà repo được cấp; ghi vào .pi/piagent-profile.json và lock tương ứng.","headings":[]},{"href":"/permissions","icon":"key","group":"Sử dụng","nav":"Permission modes","title":"Đổi quyền theo task bằng một lệnh","lead":"Permission mode chỉ áp dụng cho session hiện tại. Đổi mode không sửa project profile.","headings":[]},{"href":"/commands","icon":"terminal","group":"Sử dụng","nav":"Command catalog","title":"Command ngắn, hành vi rõ","lead":"Slash command gói sẵn policy và flow; một inspector cho diff, command, safety và context.","headings":[{"id":"session-basics","text":"Session basics"},{"id":"project-profile","text":"Project profile"},{"id":"implementation-workflow","text":"Giao việc"},{"id":"git-handoff","text":"Git handoff"},{"id":"fresh-sessions","text":"Session mới"},{"id":"mcp","text":"MCP"},{"id":"subagents","text":"Subagents"},{"id":"product-status-command","text":"Xem runtime đang quyết định gì"},{"id":"skill-va-package","text":"Kiểm tra chất lượng test, chạy vòng thử nghiệm"}]},{"href":"/workflows","icon":"branch","group":"Sử dụng","nav":"Workflows","title":"Làm việc hằng ngày","lead":"Không có launcher workflow: nói việc bằng lời thường. Command xem thêm chỉ quan sát, không mở lượt model.","headings":[{"id":"ket-luan","text":"Không có command bắt buộc mới trong daily flow"},{"id":"command-anh-huong-gi","text":"Command xem thêm ảnh hưởng workflow đến đâu"},{"id":"luong-mau","text":"Một luồng đầy đủ có thể dùng như sau"}]},{"href":"/mcp","icon":"plug","group":"MCP","nav":"Tổng quan MCP","title":"MCP trong Pi Agent Platform","lead":"Platform cài pi-mcp-adapter để dùng MCP tiết kiệm token, và quản lý server trên bốn lớp cấu hình.","headings":[{"id":"bat-dau","text":"Bắt đầu ở đâu"},{"id":"ba-thu-trung-ten","text":"Ba thứ trùng tên, không nối với nhau"},{"id":"bon-layer-config","text":"Bốn layer config"},{"id":"preset","text":"Preset seed sẵn"},{"id":"phien-cong-ty","text":"Trong phiên công ty"},{"id":"token","text":"Token efficiency"}]},{"href":"/mcp-servers","icon":"server","group":"MCP","nav":"Quản lý server","title":"Thêm, xem và gỡ MCP server","lead":"piagent-mcp có đủ add, remove, get, list, enable, disable trên cả bốn scope.","headings":[{"id":"hai-be-mat","text":"Hai bề mặt, chọn theo chỗ đang đứng"},{"id":"lenh","text":"Lệnh"},{"id":"trong-session","text":"Trong session"},{"id":"them-server","text":"Thêm server"},{"id":"xem","text":"Xem"},{"id":"tat-xoa","text":"Tắt và xoá"},{"id":"preset-lenh","text":"Preset"},{"id":"output","text":"Output nói rõ đã sửa file nào"},{"id":"update","text":"Server tự thêm và luồng update"},{"id":"giu-nguyen","text":"Giữ nguyên"},{"id":"bi-ghi-de","text":"Bị ghi đè"}]},{"href":"/mcp-auth","icon":"lock","group":"MCP","nav":"Auth và readiness","title":"Đăng nhập và trạng thái sẵn sàng","lead":"Platform không giữ token và không tự chạy OAuth. Nó từ chối ghi secret vào config và cho biết server nào thật sự gọi được.","headings":[{"id":"khong-giu-token","text":"Platform không giữ token"},{"id":"tu-choi-secret","text":"Secret bị từ chối ngay khi ghi config"},{"id":"theo-ten","text":"Theo tên field"},{"id":"theo-gia-tri","text":"Theo giá trị"},{"id":"trang-thai","text":"Trạng thái sẵn sàng"}]},{"href":"/mcp-approval","icon":"shield-check","group":"MCP","nav":"Approval gate","title":"Server đến từ repo phải được duyệt","lead":"Clone một repo lạ không cho tác giả repo đó chạy process trên máy bạn. Quyết định lưu ngoài repo và pin theo digest.","headings":[{"id":"van-de","text":"Vấn đề"},{"id":"ba-tinh-chat","text":"Ba tính chất"},{"id":"ngoai-repo","text":"Quyết định nằm ngoài repo"},{"id":"pin-digest","text":"Pin theo digest"},{"id":"enforce-tool-call","text":"Enforce ở tool call"},{"id":"gioi-han","text":"Giới hạn"},{"id":"imports","text":"Server đến qua imports"},{"id":"thiet-ke","text":"Bốn quyết định thiết kế"},{"id":"migration","text":"Migration"}]},{"href":"/security","icon":"shield","group":"Vận hành","nav":"Security model","title":"Lớp policy, không phải OS sandbox","lead":"Fail-closed trong bề mặt tool được kiểm soát: lock sai, profile sai hay thiếu quyền thì chặn, không đoán.","headings":[{"id":"protected-paths","text":"Protected paths"},{"id":"shell-hardening","text":"Shell hardening"},{"id":"secret-redaction","text":"Secret redaction"},{"id":"capability-lock","text":"Capability lock"},{"id":"human-action-gate","text":"Human-action gate"},{"id":"verify-evidence","text":"Check thật"}]},{"href":"/architecture","icon":"layers","group":"Vận hành","nav":"Kiến trúc","title":"Kiến trúc repo","lead":"Core chỉ giữ policy, prompt, guard, skill và script dùng lại được; business logic ở lại project của nó.","headings":[{"id":"composition","text":"Composition"},{"id":"runtime-adapters","text":"Runtime adapters"},{"id":"core-services","text":"Core services"},{"id":"integrations","text":"Integrations"},{"id":"entrypoints","text":"Entrypoints"},{"id":"product-assets","text":"Product assets"},{"id":"adaptive-runtime","text":"Piagent tách runtime decision khỏi Pi wiring"},{"id":"state-ownership","text":"Một state chỉ có một source of truth"}]},{"href":"/context-engine","icon":"cpu","group":"Vận hành","nav":"Context Engine","title":"Ít context hơn, giữ nguyên chất lượng","lead":"Index local, retrieval có xếp hạng, tool nạp theo task, compaction theo ngữ nghĩa và telemetry minh bạch.","headings":[{"id":"dynamic-tools","text":"Tool theo task"},{"id":"local-index","text":"Index local"},{"id":"ranked-context","text":"Context có xếp hạng"},{"id":"semantic-compact","text":"Semantic compact"},{"id":"test-impact","text":"Test impact"},{"id":"agent-watch","text":"Agent Watch"}]},{"href":"/benchmark","icon":"chart","group":"Vận hành","nav":"Benchmark","title":"Bằng chứng chất lượng và hiệu suất","lead":"So Piagent với codex-cli trên cùng model, cùng thinking: 18 nhóm bài, 108 session chấm tự động.","headings":[{"id":"benchmark-verdict","text":"Điểm fresh-token lịch sử: 9,97/10"},{"id":"cau-hinh","text":"Cùng model, cùng bài, chấm tự động"},{"id":"diem-so","text":"Không đổi chất lượng lấy token"},{"id":"token","text":"Đo toàn bộ workload cố định, không chỉ task thành công"},{"id":"pham-vi","text":"Sáu domain, mỗi domain ba family"},{"id":"benchmark-bands","text":"Chọn đúng suite theo quyết định cần đưa ra"},{"id":"minh-bach","text":"Đọc kết quả đúng phạm vi"},{"id":"lich-su-v1-2-12","text":"v1.2.12 vẫn được giữ như bằng chứng lịch sử"}]},{"href":"/runtime","icon":"wrench","group":"Vận hành","nav":"Runtime tools","title":"Terminal command cho người vận hành","lead":"Command chạy ngoài slash command: setup, doctor, benchmark, capability và MCP.","headings":[]},{"href":"/team","icon":"users","group":"Vận hành","nav":"Dùng cho team","title":"Một chuẩn vận hành cho cả team","lead":"Mỗi repo link package, chọn profile phù hợp và giữ tài liệu riêng ở repo của dự án đó.","headings":[{"id":"viec-nen-lam","text":"Việc nên làm"},{"id":"viec-nen-tranh","text":"Việc nên tránh"}]}]
+[{"href":"/","icon":"home","group":"Bắt đầu","nav":"Tổng quan","title":"Pi Agent Platform","lead":"Coding agent cho cả team: guard kiểm tra mọi tool call, Harness của team tự chạy check và review, một dashboard cho Terminal và trình duyệt.","headings":[{"id":"khac-biet","text":"Agent làm nhanh. Platform giữ cho nó làm đúng."},{"id":"mot-luot","text":"Bạn nói việc. Phần còn lại có kiểm chứng."},{"id":"man-hinh","text":"Chụp từ dashboard đang chạy"},{"id":"hai-che-do","text":"Cùng một dashboard, hai cách dùng model"},{"id":"cai-dat","text":"Chạy trong hai phút"},{"id":"moi-cap-nhat","text":"Phát hành đều, ghi rõ từng thay đổi"}]},{"href":"/ecosystem","icon":"network","group":"Bắt đầu","nav":"Hệ sinh thái","title":"Piagent, Agent Watch và Agent Studio","lead":"Phần nào chạy trên máy bạn, phần nào ở máy chủ công ty, và khi nào dùng model cá nhân hay model của công ty.","headings":[{"id":"toan-canh","text":"Một dashboard, hai cách dùng model"},{"id":"thanh-phan","text":"Mỗi phần làm một việc"},{"id":"piagent","text":"Piagent"},{"id":"guard","text":"Guard"},{"id":"agent-watch","text":"Agent Watch"},{"id":"agent-studio","text":"Agent Studio"},{"id":"mot-luot","text":"Từ tin nhắn tới \"Check đã qua · Review không có lỗi chặn\""},{"id":"chon-che-do","text":"Khi nào dùng cá nhân, khi nào dùng công ty"}]},{"href":"/quickstart","icon":"rocket","group":"Bắt đầu","nav":"Cài đặt","title":"Cài đặt và chạy lượt đầu tiên","lead":"Hai lệnh để cài. Mở repo, chọn profile và quyền, rồi nói việc bằng lời thường.","headings":[{"id":"cai-dat","text":"Cài đặt"},{"id":"mo-project","text":"Mở project"},{"id":"doc-project","text":"Cho agent đọc project"},{"id":"profile-va-quyen","text":"Chọn profile và quyền"},{"id":"giao-viec","text":"Giao việc bằng lời thường"},{"id":"kiem-tra","text":"Kiểm tra cài đặt"},{"id":"ho-tro","text":"Hệ điều hành được hỗ trợ"},{"id":"tiep-theo","text":"Tiếp theo"}]},{"href":"/windows","icon":"windows","group":"Bắt đầu","nav":"Cài trên Windows","title":"Cài trên Windows bằng một lệnh","lead":"Một lệnh PowerShell cài WSL2, Ubuntu, Piagent và Agent Watch, nối key công ty và thêm Piagent vào Start menu. Chạy lại để cập nhật.","headings":[{"id":"cai-mot-lenh","text":"Cài bằng một lệnh"},{"id":"dung-hang-ngay","text":"Dùng hằng ngày"},{"id":"khi-cai-bi-loi","text":"Khi cài bị lỗi"},{"id":"vi-sao-wsl2","text":"Vì sao là WSL2"}]},{"href":"/update","icon":"refresh","group":"Bắt đầu","nav":"Cập nhật và gỡ","title":"Cập nhật, rollback và gỡ cài đặt","lead":"Một lệnh để lên bản mới, dashboard và Terminal tự báo khi có bản mới. Rollback và gỡ cài đặt đều có bước xem trước.","headings":[{"id":"cap-nhat","text":"Cập nhật"},{"id":"terminal-dang-mo","text":"Terminal đang mở"},{"id":"cap-nhat-lam-gi","text":"Lệnh này làm gì, theo thứ tự"},{"id":"tuy-chon","text":"Tuỳ chọn thường dùng"},{"id":"pin-cho-team","text":"Pin một bản cho cả team"},{"id":"rollback","text":"Rollback"},{"id":"go-cai-dat","text":"Gỡ cài đặt"},{"id":"windows","text":"Trên Windows"}]},{"href":"/whats-new","icon":"sparkles","group":"Bắt đầu","nav":"Changelog","title":"Changelog","lead":"Mỗi bản phát hành: thay đổi gì, cần bản nào của Studio hay Agent Watch. Bản mới nhất ở trên cùng.","headings":[{"id":"latest","text":"Mới nhất"},{"id":"v1-48-3-title","text":"Agent gửi thẳng hình và file vào chat; review chạy được trong thư mục nhiều repo"},{"id":"v1-48-2-title","text":"Terminal nạp bản mới không cần đóng; chỉ member được bỏ qua kiểm tra"},{"id":"v1-48-1-title","text":"Dashboard trả lời nhanh hơn, Enter trong Terminal hiện tin nhắn ngay"},{"id":"v1-48-0-title","text":"Bypass dừng ở bước bàn giao: mọi chế độ hỏi trước khi việc rời khỏi máy"},{"id":"v1-47-0-title","text":"Phiên công ty dùng MCP server của bạn và điều khiển simulator iOS, Android"},{"id":"v1-46-4-title","text":"Một subagent thay vì bị chặn; bản cập nhật đọc được models.json có comment"},{"id":"v1-46-3-title","text":"Một subagent thay vì bị chặn; bản cập nhật đọc được models.json có comment không phát hành"},{"id":"v1-46-2-title","text":"Tin gửi sau câu trả lời hiện ngay; WebUI hiện chữ dần"},{"id":"v1-46-1-title","text":"Phản biện có sổ ghi, review một nhịp, subagent song song khi được yêu cầu"},{"id":"v1-46-0-title","text":"Piagent chạy trong Pi home riêng, pi của bạn giữ nguyên bản gốc"},{"id":"v1-45-0-title","text":"File và ảnh trong prompt theo đúng quyền đọc, terminal không còn đứng hình"},{"id":"v1-44-4-title","text":"Conversation công ty trở lại trong pane Herdr"},{"id":"v1-44-3-title","text":"Prompt injection không lặng lẽ đọc được hệ thống"},{"id":"v1-44-2-title","text":"Harness công ty theo cỡ thay đổi"},{"id":"v1-44-1-title","text":"Giữ Pi của bạn, chọn giao diện Terminal, thêm repo skill"},{"id":"v1-44-0-title","text":"Giữ Pi của bạn, chọn giao diện Terminal, thêm repo skill không phát hành"},{"id":"v1-43-9-title","text":"Đủ skill đã cài, và mở file agent gửi lại"},{"id":"v1-43-8-title","text":"Đủ skill đã cài, và mở file agent gửi lại không phát hành"},{"id":"v1-43-7-title","text":"Đủ skill đã cài, và mở file agent gửi lại không phát hành"},{"id":"v1-43-6-title","text":"Xem thay đổi của agent ngay khi đang chạy"},{"id":"v1-43-5-title","text":"Xem trước ảnh và đính kèm file văn phòng"},{"id":"v1-43-4-title","text":"Dev chọn workflow, harness hỗ trợ BE/FE theo project"},{"id":"v1-43-3-title","text":"Dev chọn workflow, harness hỗ trợ BE/FE theo project không phát hành"},{"id":"v1-43-2-title","text":"Dev chọn workflow, harness hỗ trợ BE/FE theo project không phát hành"},{"id":"archive","text":"Các bản trước"}]},{"href":"/scope","icon":"target","group":"Bắt đầu","nav":"Phạm vi platform","title":"Platform nhận phần nào về mình","lead":"Agent nào cũng có cơ chế governance riêng. Platform này đóng gói một cách vận hành cụ thể trên Pi để mọi repo dùng lại.","headings":[{"id":"khong-phai-agent-moi","text":"Đây không phải một agent mới"},{"id":"hai-lop-khong-thay-the-nhau","text":"Hai lớp không thay thế nhau"},{"id":"lop-duoi","text":"Lớp dưới thấy process"},{"id":"lop-tren","text":"Lớp trên thấy ý định"},{"id":"khi-nao-khong-can","text":"Khi nào không cần"}]},{"href":"/profiles","icon":"sliders","group":"Sử dụng","nav":"Project profile","title":"Chọn đúng profile cho repo","lead":"Profile quyết định protected path, verify command và capability mà repo được cấp; ghi vào .pi/piagent-profile.json và lock tương ứng.","headings":[]},{"href":"/permissions","icon":"key","group":"Sử dụng","nav":"Permission modes","title":"Đổi quyền theo task bằng một lệnh","lead":"Permission mode chỉ áp dụng cho session hiện tại. Đổi mode không sửa project profile.","headings":[]},{"href":"/commands","icon":"terminal","group":"Sử dụng","nav":"Command catalog","title":"Command ngắn, hành vi rõ","lead":"Slash command gói sẵn policy và flow; một inspector cho diff, command, safety và context.","headings":[{"id":"session-basics","text":"Session basics"},{"id":"project-profile","text":"Project profile"},{"id":"implementation-workflow","text":"Giao việc"},{"id":"git-handoff","text":"Git handoff"},{"id":"fresh-sessions","text":"Session mới"},{"id":"mcp","text":"MCP"},{"id":"subagents","text":"Subagents"},{"id":"product-status-command","text":"Xem runtime đang quyết định gì"},{"id":"skill-va-package","text":"Kiểm tra chất lượng test, chạy vòng thử nghiệm"}]},{"href":"/workflows","icon":"branch","group":"Sử dụng","nav":"Workflows","title":"Làm việc hằng ngày","lead":"Không có launcher workflow: nói việc bằng lời thường. Command xem thêm chỉ quan sát, không mở lượt model.","headings":[{"id":"ket-luan","text":"Không có command bắt buộc mới trong daily flow"},{"id":"command-anh-huong-gi","text":"Command xem thêm ảnh hưởng workflow đến đâu"},{"id":"luong-mau","text":"Một luồng đầy đủ có thể dùng như sau"}]},{"href":"/mcp","icon":"plug","group":"MCP","nav":"Tổng quan MCP","title":"MCP trong Pi Agent Platform","lead":"Platform cài pi-mcp-adapter để dùng MCP tiết kiệm token, và quản lý server trên bốn lớp cấu hình.","headings":[{"id":"bat-dau","text":"Bắt đầu ở đâu"},{"id":"ba-thu-trung-ten","text":"Ba thứ trùng tên, không nối với nhau"},{"id":"bon-layer-config","text":"Bốn layer config"},{"id":"preset","text":"Preset seed sẵn"},{"id":"phien-cong-ty","text":"Trong phiên công ty"},{"id":"token","text":"Token efficiency"}]},{"href":"/mcp-servers","icon":"server","group":"MCP","nav":"Quản lý server","title":"Thêm, xem và gỡ MCP server","lead":"piagent-mcp có đủ add, remove, get, list, enable, disable trên cả bốn scope.","headings":[{"id":"hai-be-mat","text":"Hai bề mặt, chọn theo chỗ đang đứng"},{"id":"lenh","text":"Lệnh"},{"id":"trong-session","text":"Trong session"},{"id":"them-server","text":"Thêm server"},{"id":"xem","text":"Xem"},{"id":"tat-xoa","text":"Tắt và xoá"},{"id":"preset-lenh","text":"Preset"},{"id":"output","text":"Output nói rõ đã sửa file nào"},{"id":"update","text":"Server tự thêm và luồng update"},{"id":"giu-nguyen","text":"Giữ nguyên"},{"id":"bi-ghi-de","text":"Bị ghi đè"}]},{"href":"/mcp-auth","icon":"lock","group":"MCP","nav":"Auth và readiness","title":"Đăng nhập và trạng thái sẵn sàng","lead":"Platform không giữ token và không tự chạy OAuth. Nó từ chối ghi secret vào config và cho biết server nào thật sự gọi được.","headings":[{"id":"khong-giu-token","text":"Platform không giữ token"},{"id":"tu-choi-secret","text":"Secret bị từ chối ngay khi ghi config"},{"id":"theo-ten","text":"Theo tên field"},{"id":"theo-gia-tri","text":"Theo giá trị"},{"id":"trang-thai","text":"Trạng thái sẵn sàng"}]},{"href":"/mcp-approval","icon":"shield-check","group":"MCP","nav":"Approval gate","title":"Server đến từ repo phải được duyệt","lead":"Clone một repo lạ không cho tác giả repo đó chạy process trên máy bạn. Quyết định lưu ngoài repo và pin theo digest.","headings":[{"id":"van-de","text":"Vấn đề"},{"id":"ba-tinh-chat","text":"Ba tính chất"},{"id":"ngoai-repo","text":"Quyết định nằm ngoài repo"},{"id":"pin-digest","text":"Pin theo digest"},{"id":"enforce-tool-call","text":"Enforce ở tool call"},{"id":"gioi-han","text":"Giới hạn"},{"id":"imports","text":"Server đến qua imports"},{"id":"thiet-ke","text":"Bốn quyết định thiết kế"},{"id":"migration","text":"Migration"}]},{"href":"/security","icon":"shield","group":"Vận hành","nav":"Security model","title":"Lớp policy, không phải OS sandbox","lead":"Fail-closed trong bề mặt tool được kiểm soát: lock sai, profile sai hay thiếu quyền thì chặn, không đoán.","headings":[{"id":"protected-paths","text":"Protected paths"},{"id":"shell-hardening","text":"Shell hardening"},{"id":"secret-redaction","text":"Secret redaction"},{"id":"capability-lock","text":"Capability lock"},{"id":"human-action-gate","text":"Human-action gate"},{"id":"verify-evidence","text":"Check thật"}]},{"href":"/architecture","icon":"layers","group":"Vận hành","nav":"Kiến trúc","title":"Kiến trúc repo","lead":"Core chỉ giữ policy, prompt, guard, skill và script dùng lại được; business logic ở lại project của nó.","headings":[{"id":"composition","text":"Composition"},{"id":"runtime-adapters","text":"Runtime adapters"},{"id":"core-services","text":"Core services"},{"id":"integrations","text":"Integrations"},{"id":"entrypoints","text":"Entrypoints"},{"id":"product-assets","text":"Product assets"},{"id":"adaptive-runtime","text":"Piagent tách runtime decision khỏi Pi wiring"},{"id":"state-ownership","text":"Một state chỉ có một source of truth"}]},{"href":"/context-engine","icon":"cpu","group":"Vận hành","nav":"Context Engine","title":"Ít context hơn, giữ nguyên chất lượng","lead":"Index local, retrieval có xếp hạng, tool nạp theo task, compaction theo ngữ nghĩa và telemetry minh bạch.","headings":[{"id":"dynamic-tools","text":"Tool theo task"},{"id":"local-index","text":"Index local"},{"id":"ranked-context","text":"Context có xếp hạng"},{"id":"semantic-compact","text":"Semantic compact"},{"id":"test-impact","text":"Test impact"},{"id":"agent-watch","text":"Agent Watch"}]},{"href":"/benchmark","icon":"chart","group":"Vận hành","nav":"Benchmark","title":"Bằng chứng chất lượng và hiệu suất","lead":"So Piagent với codex-cli trên cùng model, cùng thinking: 18 nhóm bài, 108 session chấm tự động.","headings":[{"id":"benchmark-verdict","text":"Điểm fresh-token lịch sử: 9,97/10"},{"id":"cau-hinh","text":"Cùng model, cùng bài, chấm tự động"},{"id":"diem-so","text":"Không đổi chất lượng lấy token"},{"id":"token","text":"Đo toàn bộ workload cố định, không chỉ task thành công"},{"id":"pham-vi","text":"Sáu domain, mỗi domain ba family"},{"id":"benchmark-bands","text":"Chọn đúng suite theo quyết định cần đưa ra"},{"id":"minh-bach","text":"Đọc kết quả đúng phạm vi"},{"id":"lich-su-v1-2-12","text":"v1.2.12 vẫn được giữ như bằng chứng lịch sử"}]},{"href":"/runtime","icon":"wrench","group":"Vận hành","nav":"Runtime tools","title":"Terminal command cho người vận hành","lead":"Command chạy ngoài slash command: setup, doctor, benchmark, capability và MCP.","headings":[]},{"href":"/team","icon":"users","group":"Vận hành","nav":"Dùng cho team","title":"Một chuẩn vận hành cho cả team","lead":"Mỗi repo link package, chọn profile phù hợp và giữ tài liệu riêng ở repo của dự án đó.","headings":[{"id":"viec-nen-lam","text":"Việc nên làm"},{"id":"viec-nen-tranh","text":"Việc nên tránh"}]}]

package/docs-site/benchmark.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.1" title="v1.48.1 docs · VI"><span class="dot"></span>v1.48.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.3" title="v1.48.3 docs · VI"><span class="dot"></span>v1.48.3</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new">Changelog</a>

package/docs-site/commands.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.1" title="v1.48.1 docs · VI"><span class="dot"></span>v1.48.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.3" title="v1.48.3 docs · VI"><span class="dot"></span>v1.48.3</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new">Changelog</a>

package/docs-site/content/en/update.html

@@ -7,6 +7,14 @@
   </div>
   <p>Restart the dashboard afterwards so the new interface takes effect.</p>
 
+  <h3 id="open-terminals">Open Terminals</h3>
+  <p>There is no need to close a Terminal. After an update, every open Terminal (<code>piagent</code> and <code>piagent studio</code>) loads the new release when it is idle and keeps its conversation. A Terminal running a task waits for it to finish, and its footer says so. The personal Terminal reloads Piagent's extensions; the company Terminal starts again in the same window, on the same conversation. To ask again at any time:</p>
+  <div class="command-card">
+    <header><span>Load the installed release in every open Terminal</span><button class="clip-btn" data-clip="piagent reload">Copy</button></header>
+    <pre><code>piagent reload</code></pre>
+  </div>
+  <p>When the new release runs on another Pi version, the personal Terminal says to reopen <code>piagent</code>.</p>
+
   <h3 id="what-it-does">What it does, in order</h3>
   <ol>
     <li>Resolves the target release and the Pi version it pins.</li>

package/docs-site/content/update.html

@@ -7,6 +7,14 @@
   </div>
   <p>Khởi động lại dashboard sau khi cập nhật để giao diện mới có hiệu lực.</p>
 
+  <h3 id="terminal-dang-mo">Terminal đang mở</h3>
+  <p>Không cần đóng Terminal. Sau khi cập nhật, mọi Terminal đang mở (<code>piagent</code> và <code>piagent studio</code>) tự nạp bản mới khi rảnh và giữ nguyên cuộc trò chuyện. Terminal đang chạy task thì chờ task xong rồi mới nạp; footer ghi rõ đang chờ. Terminal cá nhân nạp lại extension của Piagent; Terminal công ty mở lại trong chính cửa sổ đó, trên đúng cuộc trò chuyện. Muốn yêu cầu lại bất cứ lúc nào:</p>
+  <div class="command-card">
+    <header><span>Nạp bản đã cài vào mọi Terminal đang mở</span><button class="clip-btn" data-clip="piagent reload">Lấy lệnh</button></header>
+    <pre><code>piagent reload</code></pre>
+  </div>
+  <p>Bản mới chạy trên một bản Pi khác thì Terminal cá nhân báo cần mở lại <code>piagent</code>.</p>
+
   <h3 id="cap-nhat-lam-gi">Lệnh này làm gì, theo thứ tự</h3>
   <ol>
     <li>Xác định bản đích và bản Pi mà bản đó pin.</li>

package/docs-site/context-engine.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.1" title="v1.48.1 docs · VI"><span class="dot"></span>v1.48.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.3" title="v1.48.3 docs · VI"><span class="dot"></span>v1.48.3</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new">Changelog</a>

package/docs-site/ecosystem.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.1" title="v1.48.1 docs · VI"><span class="dot"></span>v1.48.1</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.48.3" title="v1.48.3 docs · VI"><span class="dot"></span>v1.48.3</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new">Changelog</a>

package/docs-site/en/architecture.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.1" title="v1.48.1 docs · EN"><span class="dot"></span>v1.48.1</a>
+      <a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.3" title="v1.48.3 docs · EN"><span class="dot"></span>v1.48.3</a>
       <nav class="top-nav" aria-label="Documentation">
         <a href="/en/quickstart">Docs</a>
         <a href="/en/whats-new">Changelog</a>

package/docs-site/en/benchmark.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.1" title="v1.48.1 docs · EN"><span class="dot"></span>v1.48.1</a>
+      <a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.3" title="v1.48.3 docs · EN"><span class="dot"></span>v1.48.3</a>
       <nav class="top-nav" aria-label="Documentation">
         <a href="/en/quickstart">Docs</a>
         <a href="/en/whats-new">Changelog</a>