@piagent/platform 1.13.1 → 1.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (78) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +2 -2
  3. package/README.vi.md +2 -2
  4. package/docs/command-reference-vietnamese.md +2 -2
  5. package/docs/distribution-standard.md +6 -6
  6. package/docs/en/windows.md +20 -1
  7. package/docs/languages.json +4 -4
  8. package/docs/model-options.md +16 -0
  9. package/docs/operator-manual-vietnamese.md +7 -7
  10. package/docs/publishing-for-teams.md +2 -0
  11. package/docs/release-install-policy.md +2 -2
  12. package/docs/team-onboarding.md +2 -2
  13. package/docs/vi/windows.md +20 -1
  14. package/docs-site/architecture.html +2 -1
  15. package/docs-site/benchmark.html +2 -1
  16. package/docs-site/commands.html +2 -1
  17. package/docs-site/content/en/index.html +4 -4
  18. package/docs-site/content/en/quickstart.html +1 -1
  19. package/docs-site/content/en/whats-new.html +23 -0
  20. package/docs-site/content/en/windows.html +76 -0
  21. package/docs-site/content/index.html +4 -4
  22. package/docs-site/content/quickstart.html +2 -2
  23. package/docs-site/content/whats-new.html +23 -0
  24. package/docs-site/content/windows.html +76 -0
  25. package/docs-site/context-engine.html +2 -1
  26. package/docs-site/ecosystem.html +2 -1
  27. package/docs-site/en/architecture.html +2 -1
  28. package/docs-site/en/benchmark.html +2 -1
  29. package/docs-site/en/commands.html +2 -1
  30. package/docs-site/en/context-engine.html +2 -1
  31. package/docs-site/en/ecosystem.html +2 -1
  32. package/docs-site/en/index.html +6 -5
  33. package/docs-site/en/mcp-approval.html +2 -1
  34. package/docs-site/en/mcp-auth.html +2 -1
  35. package/docs-site/en/mcp-servers.html +2 -1
  36. package/docs-site/en/mcp.html +2 -1
  37. package/docs-site/en/permissions.html +2 -1
  38. package/docs-site/en/profiles.html +2 -1
  39. package/docs-site/en/quickstart.html +5 -4
  40. package/docs-site/en/runtime.html +2 -1
  41. package/docs-site/en/scope.html +2 -1
  42. package/docs-site/en/security.html +2 -1
  43. package/docs-site/en/team.html +2 -1
  44. package/docs-site/en/whats-new.html +27 -3
  45. package/docs-site/en/windows.html +216 -0
  46. package/docs-site/en/workflows.html +2 -1
  47. package/docs-site/index.html +6 -5
  48. package/docs-site/mcp-approval.html +2 -1
  49. package/docs-site/mcp-auth.html +2 -1
  50. package/docs-site/mcp-servers.html +2 -1
  51. package/docs-site/mcp.html +2 -1
  52. package/docs-site/permissions.html +2 -1
  53. package/docs-site/profiles.html +2 -1
  54. package/docs-site/quickstart.html +6 -5
  55. package/docs-site/runtime.html +2 -1
  56. package/docs-site/scope.html +2 -1
  57. package/docs-site/security.html +2 -1
  58. package/docs-site/team.html +2 -1
  59. package/docs-site/whats-new.html +27 -3
  60. package/docs-site/windows.html +216 -0
  61. package/docs-site/workflows.html +2 -1
  62. package/evals/private-holdout-v1/public-exposure.v2.json +2 -2
  63. package/package.json +1 -1
  64. package/packages/piagent-core/managed/broker-client.mjs +7 -1
  65. package/packages/piagent-core/managed/helper-run.mjs +2 -2
  66. package/packages/piagent-core/managed/sandbox-diagnostic.mjs +3 -0
  67. package/packages/piagent-core/managed/session.mjs +2 -2
  68. package/packages/piagent-core/managed/tool-boundary.mjs +5 -1
  69. package/packages/piagent-core/package.json +1 -1
  70. package/packages/piagent-core/runtime/managed-failure.mjs +9 -1
  71. package/packages/piagent-webui/dist/client/assets/{MarkdownMessage-CyT2G1H2.js → MarkdownMessage-PIk4Femi.js} +1 -1
  72. package/packages/piagent-webui/dist/client/assets/{index-BBEa7Ger.js → index-DeCt-FaN.js} +12 -12
  73. package/packages/piagent-webui/dist/client/index.html +1 -1
  74. package/packages/piagent-webui/gateway/pi-host.ts +16 -2
  75. package/scripts/build-docs-site.mjs +11 -0
  76. package/scripts/configure-model-scope.sh +37 -8
  77. package/scripts/install-global.sh +22 -4
  78. package/scripts/update-global.mjs +7 -1
package/CHANGELOG.md CHANGED
@@ -2,6 +2,33 @@
2
2
 
3
3
  This file records release-facing changes for Pi Agent Platform. Copy the relevant version block into GitHub Releases when publishing a tag.
4
4
 
5
+ ## v1.15.0 - 2026-10-07
6
+
7
+ A refused subagent says why; long noisy commands finish.
8
+
9
+ ### Fixes
10
+
11
+ - A company subagent that Studio refuses now says Studio's reason, which Agent Watch 0.15.0 passes along, instead of "the key, harness or run changed in Studio" for every refusal. With Studio 0.19.0, a subagent whose role had no AI account when the run started takes a model that serves when it is called; when none serves, the member reads that no company AI account serves the role's model and an administrator has to link or enable one.
12
+ - A company command that printed for more than about 25 seconds (a test suite, a build) stopped as `managed-tool-output-too-large`, although its result was about 50 KB: the 12 MB limit counted every progress update. The limit now applies to each message.
13
+ - A company command that writes to `/tmp` (read-only on macOS in company mode) is told to use `$TMPDIR` or the project, instead of the general notice about credentials and the network.
14
+ - `piagent-update` started from `npm exec` installs a lasting helper even when the version already matches, and `--no-host` with an incompatible Pi stops before changing either global package. On Windows, Pi is found in custom npm prefixes.
15
+
16
+ ## v1.14.0 - 2026-10-06
17
+
18
+ Updates keep each member's Pi model choices.
19
+
20
+ ### Features
21
+
22
+ - `piagent-update`, the dashboard's update and `piagent-setup` set Pi's default model and model list (`enabledModels`) only on a first install. Later they keep the member's default model and list, and add only models the release offers for the first time; a model the member removed is not added back. What Piagent offered is kept in `~/.pi/agent/piagent-model-scope.json`. `piagent-update -- --reset-model-scope` applies the preset over the member's choices as every update did before; `piagent-model-scope` run by hand still applies it.
23
+
24
+ ### Fixes
25
+
26
+ - `piagent-update` in WSL2 no longer warns that WSL2 is experimental and not release-gated: since 1.13.0 it is how Windows runs Piagent, and the Windows setup and the bubblewrap sandbox run in CI.
27
+
28
+ ### Docs
29
+
30
+ - Windows installs with one PowerShell command (`irm https://raw.githubusercontent.com/Vt-mmm/agentwatch/main/windows/setup.ps1 | iex`): WSL2 and Ubuntu when missing, Piagent in Ubuntu, Agent Watch and the company key, and a Piagent Start-menu entry; running it again updates. The docs site has a "Cài trên Windows" page with the fixes for failed installs, and the Windows guide leads with the command.
31
+
5
32
  ## v1.13.1 - 2026-10-06
6
33
 
7
34
  ### Fixes
package/README.md CHANGED
@@ -34,7 +34,7 @@ Because it runs from an installed package, the source it writes into `.pi/settin
34
34
  | Linux x64 + Bash | Verified in CI for this release. |
35
35
  | macOS Intel (`darwin/x64`) + Bash | Supported target, but run `piagent-doctor` and project smoke tests before wide rollout. |
36
36
  | Linux ARM64 + Bash | Supported target, but run `piagent-doctor` and project smoke tests before wide rollout. |
37
- | WSL2 (Windows) | The way to run Piagent on Windows: company mode with the bubblewrap sandbox and Agent Watch for Windows, and personal mode. The Linux sandbox is checked in CI. See [Windows](docs/en/windows.md). |
37
+ | WSL2 (Windows) | The way to run Piagent on Windows: company mode with the bubblewrap sandbox and Agent Watch for Windows, and personal mode. One PowerShell command installs everything; the Linux sandbox is checked in CI. See [Windows](docs/en/windows.md). |
38
38
  | Native Windows | Preview of personal mode: the guard, path and dashboard tests run in CI on Windows; `piagent-update` does not run there yet. See [Windows](docs/en/windows.md). |
39
39
 
40
40
  Pinned step-by-step rollouts, updates, rollback, and the fast-moving `--dev` channel are in [Release and install policy](docs/release-install-policy.md).
@@ -346,7 +346,7 @@ This repository intentionally excludes:
346
346
 
347
347
  ## Maturity
348
348
 
349
- The current package version is read from package metadata and release tags. Personal machines may follow the unpinned package source when accepting ongoing updates; production/team quickstarts and committed project settings should pin an explicit tag such as `v1.13.1` or a reviewed commit.
349
+ The current package version is read from package metadata and release tags. Personal machines may follow the unpinned package source when accepting ongoing updates; production/team quickstarts and committed project settings should pin an explicit tag such as `v1.15.0` or a reviewed commit.
350
350
 
351
351
  Ready for:
352
352
 
package/README.vi.md CHANGED
@@ -36,7 +36,7 @@ Bản local này chưa phải bản phát hành có Developer ID. [Trạng thái
36
36
 
37
37
  ## Windows
38
38
 
39
- Trên Windows, Piagent chạy trong WSL2 (Ubuntu): chế độ công ty với sandbox bubblewrap và Agent Watch cho Windows, và cả chế độ cá nhân. Chạy thẳng trên Windows mới là bản xem trước cho chế độ cá nhân. Cài đặt từng bước: [Windows](docs/vi/windows.md).
39
+ Trên Windows, Piagent chạy trong WSL2 (Ubuntu): chế độ công ty với sandbox bubblewrap và Agent Watch cho Windows, và cả chế độ cá nhân. Một lệnh PowerShell cài tất cả. Chạy thẳng trên Windows mới là bản xem trước cho chế độ cá nhân. Cài đặt từng bước: [Windows](docs/vi/windows.md).
40
40
 
41
41
  ## Web search và vision
42
42
 
@@ -179,7 +179,7 @@ Xem [bằng chứng benchmark](https://piagent.io.vn/benchmark) và
179
179
 
180
180
  Gate này chạy architecture check, test, typecheck, capability validation, runtime smoke và docs consistency trước khi release.
181
181
 
182
- Bản phát hành hiện tại là `v1.13.1`. Với team hoặc production, hãy pin tag này
182
+ Bản phát hành hiện tại là `v1.15.0`. Với team hoặc production, hãy pin tag này
183
183
  hoặc một commit đã review thay vì dựa vào nguồn package không cố định.
184
184
 
185
185
  ## Security
@@ -473,8 +473,8 @@ Các lệnh này chạy ngoài Pi.
473
473
  | Command | Dùng khi nào |
474
474
  |---|---|
475
475
  | `npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1` | Cài Pi CLI tương thích với release hiện tại. |
476
- | `npm install -g --ignore-scripts @piagent/platform@1.13.1` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
477
- | `pi install git:github.com/Vt-mmm/piagent@v1.13.1` | Cài pinned release khi cần reproducible team setup. |
476
+ | `npm install -g --ignore-scripts @piagent/platform@1.15.0` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
477
+ | `pi install git:github.com/Vt-mmm/piagent@v1.15.0` | Cài pinned release khi cần reproducible team setup. |
478
478
  | `pi install git:github.com/Vt-mmm/piagent` | Cài latest package platform cho máy cá nhân/sandbox. |
479
479
  | `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ì. |
480
480
  | `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. |
@@ -15,9 +15,9 @@ Repo này phải chạy được cho nhiều project/domain khác nhau. Vì vậ
15
15
 
16
16
  | Use case | Package source |
17
17
  |---|---|
18
- | Team pinned release | `git:github.com/Vt-mmm/piagent@v1.13.1` |
18
+ | Team pinned release | `git:github.com/Vt-mmm/piagent@v1.15.0` |
19
19
  | Personal/sandbox dev | `git:github.com/Vt-mmm/piagent` |
20
- | Registry distribution | `npm:@piagent/platform@1.13.1` |
20
+ | Registry distribution | `npm:@piagent/platform@1.15.0` |
21
21
  | Enterprise npm (fork under another scope) | `npm:@your-scope/platform@x.y.z` |
22
22
  | Local platform dev | `/path/to/piagent` |
23
23
 
@@ -54,7 +54,7 @@ Root `package.json` có `pi` manifest trỏ tới:
54
54
  Do đó team có thể:
55
55
 
56
56
  ```bash
57
- pi install git:github.com/Vt-mmm/piagent@v1.13.1
57
+ pi install git:github.com/Vt-mmm/piagent@v1.15.0
58
58
  ```
59
59
 
60
60
  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:
66
66
  ```bash
67
67
  node --version # >= 22.19.0
68
68
  npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
69
- npm install -g --ignore-scripts @piagent/platform@1.13.1
69
+ npm install -g --ignore-scripts @piagent/platform@1.15.0
70
70
  piagent-install --stable --dry-run
71
71
  piagent-install --stable
72
72
  ```
73
73
 
74
- `pi install git:github.com/Vt-mmm/piagent@v1.13.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.13.1`.
74
+ `pi install git:github.com/Vt-mmm/piagent@v1.15.0` 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.15.0`.
75
75
 
76
76
  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).
77
77
 
@@ -118,7 +118,7 @@ Nếu muốn commit sẵn `.pi/piagent-profile.json` vào repo hoặc bootstrap
118
118
  ```bash
119
119
  bash scripts/setup.sh /path/to/project \
120
120
  --profile be-readonly-fe \
121
- --package-source git:github.com/Vt-mmm/piagent@v1.13.1 \
121
+ --package-source git:github.com/Vt-mmm/piagent@v1.15.0 \
122
122
  --mcp-preset core \
123
123
  --subagents-preset safe
124
124
  ```
@@ -11,7 +11,26 @@ On Windows, run Piagent in **WSL2** (Ubuntu), for company and personal conversat
11
11
 
12
12
  Company mode needs an operating-system sandbox around every command the agent runs. On macOS that is Seatbelt; on Linux and WSL2 it is bubblewrap. Windows has no equivalent sandbox an agent can use yet, so company mode runs in WSL2.
13
13
 
14
- ## Company mode in WSL2
14
+ ## Install with one command
15
+
16
+ Open **PowerShell** and run:
17
+
18
+ ```powershell
19
+ irm https://raw.githubusercontent.com/Vt-mmm/agentwatch/main/windows/setup.ps1 | iex
20
+ ```
21
+
22
+ It:
23
+ - installs WSL2 and Ubuntu when they are missing (the first time needs a restart; setup continues when you sign in);
24
+ - creates an Ubuntu user and installs Piagent inside Ubuntu;
25
+ - asks for the connection code: with one it installs Agent Watch and binds the company key; press Enter to skip for personal mode only;
26
+ - adds a **Piagent** Start-menu entry that opens the dashboard.
27
+
28
+ Run the same command again to update. The full guide and fixes for failed installs: the docs page [Windows](https://piagent.io.vn/en/windows).
29
+
30
+ ## Step by step (company mode in WSL2)
31
+
32
+ What the one-line command does, when you need to do it by hand:
33
+
15
34
 
16
35
  1. Install WSL2 with Ubuntu (PowerShell): `wsl --install -d Ubuntu`.
17
36
  2. In Ubuntu:
@@ -21,8 +21,8 @@
21
21
  "en": "README.md",
22
22
  "vi": "README.vi.md",
23
23
  "consistentAt": {
24
- "en": "0982471f4c77a8443d8932a95bafc11ea8bd788c",
25
- "vi": "e18944424d48bf60818eeaa2b2d39be3e0175c25"
24
+ "en": "bdfdcb77a243f118393189d77d91a0ecfa893a1b",
25
+ "vi": "f28098d5da80ac59252d7ba6dd85b090ee0d34cc"
26
26
  }
27
27
  },
28
28
  {
@@ -57,8 +57,8 @@
57
57
  "en": "docs/en/windows.md",
58
58
  "vi": "docs/vi/windows.md",
59
59
  "consistentAt": {
60
- "en": "7e6fdf152b4767e33861c94f3af98c75c98850e8",
61
- "vi": "23513b75db9854ab41c4f485b69121b1cdb31d0f"
60
+ "en": "8bf18c59e1a99a57747a1d68775f43379d24e7af",
61
+ "vi": "b6681a5be29c2891568d0cdbc26890b3b8f9570f"
62
62
  }
63
63
  }
64
64
  ]
@@ -188,6 +188,22 @@ piagent-model-scope --preset full --default-model openai-codex/gpt-6-sol:high
188
188
  piagent-model-scope --preset full --default-model anthropic/claude-sonnet-5:xhigh
189
189
  ```
190
190
 
191
+ ### Cập nhật giữ lựa chọn của bạn
192
+
193
+ Từ 1.14.0, `piagent-update`, nút cập nhật trong dashboard và `piagent-setup` chỉ đặt default model và danh sách model (`enabledModels`) ở **lần cài đầu**. Ở các lần sau:
194
+
195
+ - Default model bạn đã chọn và danh sách model của bạn được giữ nguyên.
196
+ - Model mà bản mới **lần đầu** đưa vào được thêm vào cuối danh sách. Model bạn đã bỏ ra không bị thêm lại.
197
+ - Piagent nhớ những model nó đã từng đưa ra trong `~/.pi/agent/piagent-model-scope.json`.
198
+
199
+ Muốn áp lại preset của Piagent lên máy (đè lựa chọn hiện tại):
200
+
201
+ ```bash
202
+ piagent-update -- --reset-model-scope
203
+ ```
204
+
205
+ Hoặc chạy `piagent-model-scope` như trên: lệnh gõ tay luôn áp preset.
206
+
191
207
  ## Benchmark rule
192
208
 
193
209
  Không claim “Pi + provider X tiết kiệm hơn provider Y” bằng cảm giác. Pin model
@@ -19,12 +19,12 @@ Support matrix release hiện tại: macOS Apple Silicon + Bash và Linux x64 +
19
19
  ```bash
20
20
  node --version # >= 22.19.0
21
21
  npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
22
- npm install -g --ignore-scripts @piagent/platform@1.13.1
22
+ npm install -g --ignore-scripts @piagent/platform@1.15.0
23
23
  piagent-install --stable --dry-run
24
24
  piagent-install --stable
25
25
  ```
26
26
 
27
- 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.13.1`. Máy cá nhân có thể dùng `git:github.com/Vt-mmm/piagent` để theo latest.
27
+ 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.15.0`. Máy cá nhân có thể dùng `git:github.com/Vt-mmm/piagent` để theo latest.
28
28
 
29
29
  Nếu đang ở source checkout của platform, dùng helper theo channel để preview trước khi đổi:
30
30
 
@@ -100,7 +100,7 @@ install package once
100
100
 
101
101
  ```bash
102
102
  npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
103
- npm install -g --ignore-scripts @piagent/platform@1.13.1
103
+ npm install -g --ignore-scripts @piagent/platform@1.15.0
104
104
  piagent-install --stable --dry-run
105
105
  piagent-install --stable
106
106
  ```
@@ -285,7 +285,7 @@ Không phải daily default. Dùng khi muốn tạo sẵn `.pi` files cho projec
285
285
  bash /path/to/piagent/scripts/setup.sh /path/to/project \
286
286
  --project-only \
287
287
  --profile auto \
288
- --package-source git:github.com/Vt-mmm/piagent@v1.13.1 \
288
+ --package-source git:github.com/Vt-mmm/piagent@v1.15.0 \
289
289
  --mcp-preset core \
290
290
  --subagents-preset safe
291
291
  ```
@@ -999,8 +999,8 @@ Watchdog là optional adversarial reviewer ở cuối turn, không bật mặc
999
999
 
1000
1000
  | Command | Dùng để |
1001
1001
  |---|---|
1002
- | `npm install -g --ignore-scripts @piagent/platform@1.13.1` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
1003
- | `pi install git:github.com/Vt-mmm/piagent@v1.13.1` | Install pinned release cho reproducible team setup. |
1002
+ | `npm install -g --ignore-scripts @piagent/platform@1.15.0` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
1003
+ | `pi install git:github.com/Vt-mmm/piagent@v1.15.0` | Install pinned release cho reproducible team setup. |
1004
1004
  | `pi install git:github.com/Vt-mmm/piagent` | Install latest platform package cho máy cá nhân/sandbox. |
1005
1005
  | 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). |
1006
1006
  | 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.
1096
1096
  Cài lại terminal helper đúng release rồi kiểm tra `PATH`:
1097
1097
 
1098
1098
  ```bash
1099
- npm install -g --ignore-scripts @piagent/platform@1.13.1
1099
+ npm install -g --ignore-scripts @piagent/platform@1.15.0
1100
1100
  command -v piagent-install
1101
1101
  ```
1102
1102
 
@@ -41,6 +41,8 @@ pi install /path/to/piagent
41
41
 
42
42
  ## Versioning
43
43
 
44
+ - `1.15.0`: subagent bị Studio từ chối nói đúng lý do (cần Agent Watch 0.15.0); lệnh in nhiều và chạy lâu không còn bị dừng vì `managed-tool-output-too-large`; ghi vào `/tmp` được chỉ sang `$TMPDIR`.
45
+ - `1.14.0`: cập nhật Piagent giữ model mặc định và danh sách model thành viên đã chọn, chỉ thêm model mới của bản phát hành; trên Windows, WSL2 không còn bị báo là thử nghiệm.
44
46
  - `1.13.1`: mở lại cuộc trò chuyện giữ đúng chỗ đang đọc (lần đầu mở ở tin mới nhất); chữ agent viết giữa các tool call hiển thị có định dạng thay vì markdown thô.
45
47
  - `1.13.0`: Piagent trên Windows qua WSL2 (sandbox bubblewrap, Agent Watch cho Windows); sau khi cập nhật, mỗi thành viên nhập lại cấu hình Piagent trong Agent Watch.
46
48
  - `1.12.1`: nhánh (fork) của cuộc trò chuyện công ty gửi được tin nhắn; nhánh tạo trước bản này cần tạo lại.
@@ -153,7 +153,7 @@ Use this flow when the team needs both terminal commands and the Pi package:
153
153
  ```bash
154
154
  node --version # >= 22.19.0
155
155
  npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
156
- npm install -g --ignore-scripts @piagent/platform@1.13.1
156
+ npm install -g --ignore-scripts @piagent/platform@1.15.0
157
157
  piagent-install --stable --dry-run
158
158
  piagent-install --stable
159
159
  ```
@@ -179,7 +179,7 @@ bash scripts/install-global.sh --stable
179
179
  Use this only when terminal commands are not needed:
180
180
 
181
181
  ```bash
182
- pi install git:github.com/Vt-mmm/piagent@v1.13.1
182
+ pi install git:github.com/Vt-mmm/piagent@v1.15.0
183
183
  ```
184
184
 
185
185
  Direct `pi install` does not create `piagent-*` commands on `PATH`.
@@ -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
10
10
  ```bash
11
11
  node --version # >= 22.19.0
12
12
  npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
13
- npm install -g --ignore-scripts @piagent/platform@1.13.1
13
+ npm install -g --ignore-scripts @piagent/platform@1.15.0
14
14
  piagent-install --stable
15
15
  cd /path/to/project
16
16
  pi
@@ -45,7 +45,7 @@ Mặc định team dùng stable helper:
45
45
  ```bash
46
46
  node --version # >= 22.19.0
47
47
  npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
48
- npm install -g --ignore-scripts @piagent/platform@1.13.1
48
+ npm install -g --ignore-scripts @piagent/platform@1.15.0
49
49
  piagent-install --stable --dry-run
50
50
  piagent-install --stable
51
51
  ```
@@ -11,7 +11,26 @@ Trên Windows, chạy Piagent trong **WSL2** (Ubuntu), cho cả cuộc trò chuy
11
11
 
12
12
  Chế độ công ty cần sandbox của hệ điều hành cho mọi lệnh agent chạy. Trên macOS đó là Seatbelt; trên Linux và WSL2 là bubblewrap. Windows chưa có sandbox tương đương dùng được cho agent, nên chế độ công ty chạy trong WSL2.
13
13
 
14
- ## Chế độ công ty trong WSL2
14
+ ## Cài bằng một lệnh
15
+
16
+ Mở **PowerShell** và chạy:
17
+
18
+ ```powershell
19
+ irm https://raw.githubusercontent.com/Vt-mmm/agentwatch/main/windows/setup.ps1 | iex
20
+ ```
21
+
22
+ Lệnh này:
23
+ - cài WSL2 và Ubuntu nếu thiếu (lần đầu cần khởi động lại, cài đặt tự chạy tiếp khi đăng nhập);
24
+ - tạo user Ubuntu và cài Piagent trong Ubuntu;
25
+ - hỏi mã kết nối: dán vào thì cài Agent Watch và nối key công ty; Enter để bỏ qua nếu chỉ dùng chế độ cá nhân;
26
+ - thêm mục **Piagent** vào Start menu để mở dashboard.
27
+
28
+ Chạy lại đúng lệnh để cập nhật. Hướng dẫn đầy đủ và cách xử lý lỗi cài đặt: trang [Cài trên Windows](https://piagent.io.vn/windows) của docs.
29
+
30
+ ## Cài từng bước (chế độ công ty trong WSL2)
31
+
32
+ Những bước lệnh một dòng ở trên tự làm, khi cần làm tay:
33
+
15
34
 
16
35
  1. Cài WSL2 với Ubuntu (PowerShell): `wsl --install -d Ubuntu`.
17
36
  2. Trong Ubuntu:
@@ -30,7 +30,7 @@
30
30
  <span>Pi Agent Platform</span>
31
31
  </a>
32
32
  <div class="top-actions">
33
- <span class="pill"><span class="pill-dot"></span>v1.13.1 docs · VI</span>
33
+ <span class="pill"><span class="pill-dot"></span>v1.15.0 docs · VI</span>
34
34
  <nav class="language-switch" aria-label="Ngôn ngữ">
35
35
  <a class="language-option current" href="/architecture" hreflang="vi" lang="vi" aria-current="true">VI</a>
36
36
  <a class="language-option" href="/en/architecture" hreflang="en" lang="en">EN</a>
@@ -61,6 +61,7 @@
61
61
  <a class="nav-link" href="/">Overview</a>
62
62
  <a class="nav-link" href="/ecosystem">Hệ sinh thái</a>
63
63
  <a class="nav-link" href="/quickstart">Quickstart</a>
64
+ <a class="nav-link" href="/windows">Cài trên Windows</a>
64
65
  <a class="nav-link" href="/whats-new">Có gì mới</a>
65
66
  <a class="nav-link" href="/scope">Phạm vi platform</a>
66
67
  </div>
@@ -30,7 +30,7 @@
30
30
  <span>Pi Agent Platform</span>
31
31
  </a>
32
32
  <div class="top-actions">
33
- <span class="pill"><span class="pill-dot"></span>v1.13.1 docs · VI</span>
33
+ <span class="pill"><span class="pill-dot"></span>v1.15.0 docs · VI</span>
34
34
  <nav class="language-switch" aria-label="Ngôn ngữ">
35
35
  <a class="language-option current" href="/benchmark" hreflang="vi" lang="vi" aria-current="true">VI</a>
36
36
  <a class="language-option" href="/en/benchmark" hreflang="en" lang="en">EN</a>
@@ -61,6 +61,7 @@
61
61
  <a class="nav-link" href="/">Overview</a>
62
62
  <a class="nav-link" href="/ecosystem">Hệ sinh thái</a>
63
63
  <a class="nav-link" href="/quickstart">Quickstart</a>
64
+ <a class="nav-link" href="/windows">Cài trên Windows</a>
64
65
  <a class="nav-link" href="/whats-new">Có gì mới</a>
65
66
  <a class="nav-link" href="/scope">Phạm vi platform</a>
66
67
  </div>
@@ -30,7 +30,7 @@
30
30
  <span>Pi Agent Platform</span>
31
31
  </a>
32
32
  <div class="top-actions">
33
- <span class="pill"><span class="pill-dot"></span>v1.13.1 docs · VI</span>
33
+ <span class="pill"><span class="pill-dot"></span>v1.15.0 docs · VI</span>
34
34
  <nav class="language-switch" aria-label="Ngôn ngữ">
35
35
  <a class="language-option current" href="/commands" hreflang="vi" lang="vi" aria-current="true">VI</a>
36
36
  <a class="language-option" href="/en/commands" hreflang="en" lang="en">EN</a>
@@ -61,6 +61,7 @@
61
61
  <a class="nav-link" href="/">Overview</a>
62
62
  <a class="nav-link" href="/ecosystem">Hệ sinh thái</a>
63
63
  <a class="nav-link" href="/quickstart">Quickstart</a>
64
+ <a class="nav-link" href="/windows">Cài trên Windows</a>
64
65
  <a class="nav-link" href="/whats-new">Có gì mới</a>
65
66
  <a class="nav-link" href="/scope">Phạm vi platform</a>
66
67
  </div>
@@ -1,5 +1,5 @@
1
1
  <section class="hero">
2
- <p class="eyebrow">Piagent 1.13.1</p>
2
+ <p class="eyebrow">Piagent 1.15.0</p>
3
3
  <h1>A coding agent for the whole team, checked at every step.</h1>
4
4
  <p>
5
5
  One dashboard for Terminal and the browser. Use models with your own account, or the company's models through Agent Watch and Agent Studio. The guard checks every tool call; in company mode the team's Harness asks for checks, has a subagent review the change and reports the outcome right under the answer.
@@ -13,7 +13,7 @@
13
13
  <div class="hero-actions">
14
14
  <a class="button primary" href="/en/quickstart">Get started</a>
15
15
  <a class="button" href="/en/ecosystem">Ecosystem</a>
16
- <a class="button" href="/en/whats-new">What’s new in 1.13.1</a>
16
+ <a class="button" href="/en/whats-new">What’s new in 1.15.0</a>
17
17
  <a class="button" href="/en/commands">View commands</a>
18
18
  </div>
19
19
  </section>
@@ -89,9 +89,9 @@ piagent-setup</code></pre>
89
89
  <h2 id="where-to-start">Where to start</h2>
90
90
  <div class="card-grid">
91
91
  <a class="doc-card" href="/en/whats-new">
92
- <span class="card-kicker">Release 1.13.1</span>
92
+ <span class="card-kicker">Release 1.15.0</span>
93
93
  <h3>What’s new</h3>
94
- <p>Conversations keep their place and the agent's notes are formatted; in 1.13.0: Piagent on Windows through WSL2: a bubblewrap sandbox for company conversations and Agent Watch for Windows; in 1.12: @ picks files and folders on the Mac, skills and commands run from /, and forked company conversations take messages.</p>
94
+ <p>A refused subagent says why, long commands finish; in 1.14: updates keep the models you chose; in 1.13: conversations keep their place, the agent's notes are formatted, Piagent on Windows through WSL2: a bubblewrap sandbox for company conversations and Agent Watch for Windows; in 1.12: @ picks files and folders on the Mac, skills and commands run from /, and forked company conversations take messages.</p>
95
95
  </a>
96
96
  <a class="doc-card" href="/en/ecosystem">
97
97
  <span class="card-kicker">Get started</span>
@@ -11,7 +11,7 @@
11
11
  <tr><td>macOS Apple Silicon + Bash</td><td>Verified for this release.</td></tr>
12
12
  <tr><td>Linux x64 + Bash</td><td>Verified in CI.</td></tr>
13
13
  <tr><td>macOS Intel / Linux ARM64 + Bash</td><td>Supported target; run doctor and smoke tests before broad rollout.</td></tr>
14
- <tr><td>Native Windows / WSL2</td><td>Not a team rollout target; WSL2 remains experimental.</td></tr>
14
+ <tr><td>Windows (WSL2)</td><td>One PowerShell command installs everything: see <a href="/en/windows">Windows</a>. Running on Windows itself is a preview of personal mode.</td></tr>
15
15
  </tbody>
16
16
  </table>
17
17
  </div>
@@ -1,3 +1,26 @@
1
+ <section class="section">
2
+ <p class="section-kicker">v1.15.0 · 2026-10-07</p>
3
+ <h2 id="v1-15-0">A refused subagent says why</h2>
4
+ <p class="section-lead">When Studio refuses a company subagent, Piagent now gives Studio's reason instead of always saying the configuration changed. For example: no company AI account serves this role's model, and an administrator has to link or enable one. Needs Agent Watch 0.15.0; with Studio 0.19.0, a subagent that had no account when the run started takes a model that serves when it is called.</p>
5
+ <ul>
6
+ <li>Long commands that print a lot (test suites, builds) no longer stop with <span class="inline-code">managed-tool-output-too-large</span>.</li>
7
+ <li>A company command that writes to <span class="inline-code">/tmp</span> is pointed to <span class="inline-code">$TMPDIR</span> or the project.</li>
8
+ <li><span class="inline-code">piagent-update</span> started from <span class="inline-code">npm exec</span> installs a lasting helper; on Windows, Pi is found in custom npm prefixes.</li>
9
+ </ul>
10
+ <p>Updating from 1.14.x needs no new import in Agent Watch.</p>
11
+ </section>
12
+
13
+ <section class="section">
14
+ <p class="section-kicker">v1.14.0 · 2026-10-06</p>
15
+ <h2 id="v1-14-0">Updates keep your model choices</h2>
16
+ <p class="section-lead"><span class="inline-code">piagent-update</span>, the dashboard’s update and <span class="inline-code">piagent-setup</span> set Pi’s default model and model list only on a first install. From this release, every update keeps the model you chose and your list, adding only models the release offers for the first time; a model you removed is not added back. To apply Piagent’s preset again: <span class="inline-code">piagent-update -- --reset-model-scope</span>.</p>
17
+ <ul>
18
+ <li>On Windows (WSL2), updates no longer call WSL2 experimental: it is how Piagent runs on Windows since 1.13.0.</li>
19
+ <li>Windows installs with one PowerShell command: see <a href="/en/windows">Windows</a>.</li>
20
+ </ul>
21
+ <p>Updating from 1.13.x needs no new import in Agent Watch.</p>
22
+ </section>
23
+
1
24
  <section class="section">
2
25
  <p class="section-kicker">v1.13.1 · 2026-10-06</p>
3
26
  <h2 id="v1-13-1">Conversations keep their place, the agent's notes are formatted</h2>
@@ -0,0 +1,76 @@
1
+ <section class="section">
2
+
3
+ <div class="steps">
4
+ <article class="step">
5
+ <div>
6
+ <h3 id="one-command">Install with one command</h3>
7
+ <p>Open <strong>PowerShell</strong> (Start → type PowerShell) and run:</p>
8
+ <div class="command-card">
9
+ <header><span>One command</span><button class="clip-btn" data-clip="irm https://raw.githubusercontent.com/Vt-mmm/agentwatch/main/windows/setup.ps1 | iex">Copy</button></header>
10
+ <pre><code>irm https://raw.githubusercontent.com/Vt-mmm/agentwatch/main/windows/setup.ps1 | iex</code></pre>
11
+ </div>
12
+ <p>It goes through these steps:</p>
13
+ <ol>
14
+ <li>Installs <strong>WSL2</strong> when it is missing. Windows asks for administrator approval; the first time a restart is needed, and setup continues when you sign in again.</li>
15
+ <li>Installs <strong>Ubuntu</strong>, creates an Ubuntu user named after your Windows user and asks for its password (used for <span class="inline-code">sudo</span>).</li>
16
+ <li>Installs <strong>Piagent inside Ubuntu</strong>: system packages, the bubblewrap sandbox, Node 24, Piagent and the Pi version the release pins.</li>
17
+ <li>Asks for the <strong>connection code</strong> your admin sent. With a code it installs Agent Watch, connects the company key and binds Piagent in Ubuntu to it. Press Enter to skip if you only use your own AI account.</li>
18
+ <li>Adds a <strong>Piagent</strong> entry to the Start menu and opens the dashboard in the browser.</li>
19
+ </ol>
20
+ <p><strong>Updating:</strong> run the same command again. Finished steps are skipped; Piagent and Agent Watch are updated and the company key is bound again.</p>
21
+ <p>Agent Watch is an internal build without a code signature: if Windows SmartScreen warns, choose <em>More info → Run anyway</em>.</p>
22
+ </div>
23
+ </article>
24
+
25
+ <article class="step">
26
+ <div>
27
+ <h3 id="every-day">Every day</h3>
28
+ <p>Open <strong>Piagent</strong> from the Start menu: an Ubuntu window opens the dashboard in the Windows browser. Keep that window open while you work.</p>
29
+ <p>Keep projects on the Ubuntu disk (for example <span class="inline-code">~/projects</span>) for speed; Windows folders (<span class="inline-code">/mnt/c/...</span>) work but are much slower for npm and git. VS Code on Windows opens folders inside Ubuntu through its WSL extension.</p>
30
+ </div>
31
+ </article>
32
+
33
+ <article class="step">
34
+ <div>
35
+ <h3 id="when-setup-fails">When setup fails</h3>
36
+ <div class="table-wrap compact-table">
37
+ <table>
38
+ <thead>
39
+ <tr>
40
+ <th>Symptom</th>
41
+ <th>What to do</th>
42
+ </tr>
43
+ </thead>
44
+ <tbody>
45
+ <tr>
46
+ <td>Setup asks for a restart after every restart, or Ubuntu fails with <span class="inline-code">0x80370114</span></td>
47
+ <td>Windows reads <em>Virtual Machine Platform</em> as enabled but lacks its VM service. If <span class="inline-code">Test-Path C:\Windows\System32\vmcompute.exe</span> prints <span class="inline-code">False</span>: in PowerShell opened with <em>Run as administrator</em> run <span class="inline-code">DISM /Online /Cleanup-Image /RestoreHealth</span> and <span class="inline-code">sfc /scannow</span>, then turn <em>VirtualMachinePlatform</em> off and on again with <span class="inline-code">dism.exe</span> (restart each time). Still missing: repair-install Windows 11 with the Installation Assistant, keeping files and apps.</td>
48
+ </tr>
49
+ <tr>
50
+ <td><span class="inline-code">0x80370102</span> or a virtualization error</td>
51
+ <td>Turn on virtualization (Intel VT-x / AMD SVM) in the BIOS.</td>
52
+ </tr>
53
+ <tr>
54
+ <td>Downloading Ubuntu fails</td>
55
+ <td><span class="inline-code">wsl --install -d Ubuntu --web-download</span>, then run setup again.</td>
56
+ </tr>
57
+ <tr>
58
+ <td>The dashboard says Agent Watch or Piagent changed</td>
59
+ <td>Run setup again, or choose <strong>Kết nối Piagent trong WSL</strong> (Connect Piagent in WSL) in Agent Watch.</td>
60
+ </tr>
61
+ </tbody>
62
+ </table>
63
+ </div>
64
+ <p>Check the machine with <span class="inline-code">piagent studio --doctor</span> inside Ubuntu. When Windows still lacks the VM service after a restart, setup prints the repair steps above instead of asking for another restart.</p>
65
+ </div>
66
+ </article>
67
+
68
+ <article class="step">
69
+ <div>
70
+ <h3 id="why-wsl2">Why WSL2</h3>
71
+ <p>Ubuntu in WSL2 runs inside Windows as a lightweight virtual machine that Windows manages; it is not a second operating system to boot. Company mode needs an operating-system sandbox around every command the agent runs: Seatbelt on macOS, bubblewrap on Linux and WSL2. Windows has no equivalent sandbox yet, so Piagent runs in WSL2.</p>
72
+ <p>Running on Windows itself (without WSL) is a preview of personal mode. Manual steps and sandbox details: <a href="https://github.com/Vt-mmm/piagent/blob/main/docs/en/windows.md">Piagent on Windows</a>.</p>
73
+ </div>
74
+ </article>
75
+ </div>
76
+ </section>
@@ -1,5 +1,5 @@
1
1
  <section class="hero">
2
- <p class="eyebrow">Piagent 1.13.1</p>
2
+ <p class="eyebrow">Piagent 1.15.0</p>
3
3
  <h1>Coding agent cho cả team, kiểm tra từng bước.</h1>
4
4
  <p>
5
5
  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.
@@ -13,7 +13,7 @@
13
13
  <div class="hero-actions">
14
14
  <a class="button primary" href="/quickstart">Bắt đầu</a>
15
15
  <a class="button" href="/ecosystem">Hệ sinh thái</a>
16
- <a class="button" href="/whats-new">Có gì mới trong 1.13.1</a>
16
+ <a class="button" href="/whats-new">Có gì mới trong 1.15.0</a>
17
17
  <a class="button" href="/commands">Xem command</a>
18
18
  </div>
19
19
  </section>
@@ -89,9 +89,9 @@ piagent-setup</code></pre>
89
89
  <h2 id="bat-dau-tu-dau">Bắt đầu từ đâu</h2>
90
90
  <div class="card-grid">
91
91
  <a class="doc-card" href="/whats-new">
92
- <span class="card-kicker">Bản 1.13.1</span>
92
+ <span class="card-kicker">Bản 1.15.0</span>
93
93
  <h3>Có gì mới</h3>
94
- <p>Cuộc trò chuyện giữ chỗ đang đọc, chữ của agent có định dạng; ở 1.13.0: 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>
94
+ <p>Subagent bị từ chối nói đúng lý do, lệnh chạy lâu không bị dừng; ở 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>
95
95
  </a>
96
96
  <a class="doc-card" href="/ecosystem">
97
97
  <span class="card-kicker">Get started</span>
@@ -27,8 +27,8 @@
27
27
  <td>Supported target; chạy doctor + smoke test trước khi rollout rộng.</td>
28
28
  </tr>
29
29
  <tr>
30
- <td>Native Windows / WSL2</td>
31
- <td>Chưa là target rollout team; WSL2 chỉ experimental.</td>
30
+ <td>Windows (WSL2)</td>
31
+ <td>Một lệnh PowerShell cài tất cả: xem <a href="/windows">Cài trên Windows</a>. Chạy thẳng trên Windows mới là bản xem trước cho chế độ cá nhân.</td>
32
32
  </tr>
33
33
  </tbody>
34
34
  </table>
@@ -1,3 +1,26 @@
1
+ <section class="section">
2
+ <p class="section-kicker">v1.15.0 · 2026-10-07</p>
3
+ <h2 id="v1-15-0">Subagent bị từ chối nói đúng lý do</h2>
4
+ <p class="section-lead">Khi Studio từ chối một subagent công ty, Piagent nay báo lý do của Studio thay vì luôn báo "cấu hình vừa thay đổi". Ví dụ: không tài khoản AI nào của công ty phục vụ model của vai trò này, và quản trị viên cần gắn hoặc bật một tài khoản. Cần Agent Watch 0.15.0; với Studio 0.19.0, subagent thiếu tài khoản lúc bắt đầu lượt sẽ tự lấy model đang phục vụ khi được gọi.</p>
5
+ <ul>
6
+ <li>Lệnh in nhiều và chạy lâu (bộ test, build) không còn bị dừng với <span class="inline-code">managed-tool-output-too-large</span>.</li>
7
+ <li>Lệnh ghi vào <span class="inline-code">/tmp</span> ở chế độ công ty được chỉ sang <span class="inline-code">$TMPDIR</span> hoặc thư mục project.</li>
8
+ <li><span class="inline-code">piagent-update</span> chạy từ <span class="inline-code">npm exec</span> cài helper lâu dài; trên Windows, Pi được tìm thấy trong npm prefix tùy chỉnh.</li>
9
+ </ul>
10
+ <p>Cập nhật từ 1.14.x không cần nhập lại cấu hình trong Agent Watch.</p>
11
+ </section>
12
+
13
+ <section class="section">
14
+ <p class="section-kicker">v1.14.0 · 2026-10-06</p>
15
+ <h2 id="v1-14-0">Cập nhật giữ lựa chọn model của bạn</h2>
16
+ <p class="section-lead"><span class="inline-code">piagent-update</span>, nút cập nhật trong dashboard và <span class="inline-code">piagent-setup</span> chỉ đặt default model và danh sách model của Pi ở lần cài đầu. Từ bản này, mỗi lần cập nhật giữ nguyên model bạn đã chọn và danh sách của bạn, chỉ thêm model bản mới lần đầu đưa vào; model bạn đã bỏ ra không bị thêm lại. Muốn áp lại preset của Piagent: <span class="inline-code">piagent-update -- --reset-model-scope</span>.</p>
17
+ <ul>
18
+ <li>Trên Windows (WSL2), cập nhật không còn báo WSL2 là thử nghiệm: đó là cách Piagent chạy trên Windows từ 1.13.0.</li>
19
+ <li>Windows cài bằng một lệnh PowerShell: xem trang <a href="/windows">Cài trên Windows</a>.</li>
20
+ </ul>
21
+ <p>Cập nhật từ 1.13.x không cần nhập lại cấu hình trong Agent Watch.</p>
22
+ </section>
23
+
1
24
  <section class="section">
2
25
  <p class="section-kicker">v1.13.1 · 2026-10-06</p>
3
26
  <h2 id="v1-13-1">Cuộc trò chuyện giữ chỗ đang đọc, chữ của agent có định dạng</h2>