@piagent/platform 1.46.4 → 1.48.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.
- package/CHANGELOG.md +37 -0
- package/README.md +16 -3
- package/README.vi.md +16 -3
- package/docs/command-reference-vietnamese.md +4 -4
- package/docs/company-dev-commands.md +6 -5
- package/docs/distribution-standard.md +6 -6
- package/docs/languages.json +2 -2
- package/docs/mcp-and-tools.md +21 -1
- package/docs/operator-manual-vietnamese.md +7 -7
- package/docs/publishing-for-teams.md +2 -0
- package/docs/release-install-policy.md +2 -2
- package/docs/security-threat-model.md +3 -1
- package/docs/team-onboarding.md +2 -2
- package/docs-site/architecture.html +1 -1
- package/docs-site/assets/search-en.json +1 -1
- package/docs-site/assets/search-vi.json +1 -1
- package/docs-site/benchmark.html +1 -1
- package/docs-site/commands.html +1 -1
- package/docs-site/content/en/mcp.html +8 -0
- package/docs-site/content/mcp.html +8 -0
- package/docs-site/context-engine.html +1 -1
- package/docs-site/ecosystem.html +1 -1
- package/docs-site/en/architecture.html +1 -1
- package/docs-site/en/benchmark.html +1 -1
- package/docs-site/en/commands.html +1 -1
- package/docs-site/en/context-engine.html +1 -1
- package/docs-site/en/ecosystem.html +1 -1
- package/docs-site/en/index.html +15 -15
- package/docs-site/en/mcp-approval.html +1 -1
- package/docs-site/en/mcp-auth.html +1 -1
- package/docs-site/en/mcp-servers.html +1 -1
- package/docs-site/en/mcp.html +9 -1
- package/docs-site/en/permissions.html +1 -1
- package/docs-site/en/profiles.html +1 -1
- package/docs-site/en/quickstart.html +1 -1
- package/docs-site/en/runtime.html +1 -1
- package/docs-site/en/scope.html +1 -1
- package/docs-site/en/security.html +1 -1
- package/docs-site/en/team.html +1 -1
- package/docs-site/en/update.html +3 -3
- package/docs-site/en/whats-new.html +59 -32
- package/docs-site/en/windows.html +1 -1
- package/docs-site/en/workflows.html +1 -1
- package/docs-site/index.html +15 -15
- package/docs-site/mcp-approval.html +1 -1
- package/docs-site/mcp-auth.html +1 -1
- package/docs-site/mcp-servers.html +1 -1
- package/docs-site/mcp.html +9 -1
- package/docs-site/permissions.html +1 -1
- package/docs-site/profiles.html +1 -1
- package/docs-site/quickstart.html +1 -1
- package/docs-site/releases.json +87 -0
- package/docs-site/runtime.html +1 -1
- package/docs-site/scope.html +1 -1
- package/docs-site/security.html +1 -1
- package/docs-site/team.html +1 -1
- package/docs-site/update.html +3 -3
- package/docs-site/whats-new.html +59 -32
- package/docs-site/windows.html +1 -1
- package/docs-site/workflows.html +1 -1
- package/evals/private-holdout-v1/public-exposure.v2.json +2 -2
- package/package.json +2 -1
- package/packages/piagent-core/extensions/guard-types.ts +10 -2
- package/packages/piagent-core/extensions/piagent-guard.ts +106 -169
- package/packages/piagent-core/extensions/policy-core.js +7 -7
- package/packages/piagent-core/extensions/shell-ast.js +85 -0
- package/packages/piagent-core/extensions/shell-command-words.js +19 -0
- package/packages/piagent-core/managed/command-tools.mjs +70 -26
- package/packages/piagent-core/managed/fetch-guard.mjs +3 -3
- package/packages/piagent-core/managed/host-command.mjs +15 -7
- package/packages/piagent-core/managed/member-mcp.mjs +96 -0
- package/packages/piagent-core/managed/memory-lessons.mjs +1 -1
- package/packages/piagent-core/managed/permission.mjs +19 -12
- package/packages/piagent-core/managed/repository-operation.mjs +1 -1
- package/packages/piagent-core/managed/resource-loader.mjs +19 -7
- package/packages/piagent-core/managed/sandbox-diagnostic.mjs +4 -0
- package/packages/piagent-core/managed/session.mjs +4 -4
- package/packages/piagent-core/managed/simulator-commands.mjs +117 -0
- package/packages/piagent-core/mcp/mcp-server-catalog.js +18 -1
- package/packages/piagent-core/package.json +1 -1
- package/packages/piagent-core/runtime/hooks/session-start-hook.ts +1 -1
- package/packages/piagent-core/runtime/inspection/approval-broker.ts +33 -16
- package/packages/piagent-core/runtime/mcp-repository-gate.d.mts +10 -0
- package/packages/piagent-core/runtime/mcp-repository-gate.mjs +150 -0
- package/packages/piagent-core/runtime/policy/handoff-policy.mjs +144 -0
- package/packages/piagent-core/runtime/registration/permission-commands.ts +2 -2
- package/packages/piagent-webui/dist/client/assets/{App-CiwY9VpU.js → App-fZeIRoaD.js} +1 -1
- package/packages/piagent-webui/dist/client/assets/{GatewayApp-DrNJW3v_.js → GatewayApp-CpC4lgYK.js} +17 -15
- package/packages/piagent-webui/dist/client/assets/{InspectionApp-BBiwSaV0.js → InspectionApp-pD-BqBXm.js} +1 -1
- package/packages/piagent-webui/dist/client/assets/{SessionAgentWorkspace-DwyPebIX.js → SessionAgentWorkspace-3tM7Q6HH.js} +1 -1
- package/packages/piagent-webui/dist/client/assets/{SessionInspectorDrawer-CpVzaf_G.js → SessionInspectorDrawer-BJ94aQ6y.js} +2 -2
- package/packages/piagent-webui/dist/client/assets/SettingsNavigation-BFfqMcuL.js +3 -0
- package/packages/piagent-webui/dist/client/assets/SettingsPage-CxpZ7cdM.js +1 -0
- package/packages/piagent-webui/dist/client/assets/{TerminalPanel-B8j_r6-y.js → TerminalPanel-CtZyb0tj.js} +1 -1
- package/packages/piagent-webui/dist/client/assets/{WorkspaceCodeEditor-BDTPvq-0.js → WorkspaceCodeEditor-BS_ZrjPN.js} +1 -1
- package/packages/piagent-webui/dist/client/assets/{WorkspaceExplorer-DVsNU0eu.js → WorkspaceExplorer-CkFBpcM7.js} +3 -3
- package/packages/piagent-webui/dist/client/assets/{index-uhJMXxqD.js → index-CNdhIouM.js} +2 -2
- package/packages/piagent-webui/dist/client/assets/{index-Dqb2hNan.css → index-CjM70M7D.css} +1 -1
- package/packages/piagent-webui/dist/client/assets/transcript-view-model-CpEMY1xb.js +3 -0
- package/packages/piagent-webui/dist/client/index.html +2 -2
- package/packages/piagent-webui/gateway/gateway-events.ts +5 -1
- package/packages/piagent-webui/server/gateway-websocket.ts +5 -1
- package/schemas/piagent-webui/approval-v1.schema.json +3 -1
- package/schemas/project-profile.schema.json +16 -0
- package/scripts/company-terminal.mjs +5 -5
- package/scripts/setup.sh +1 -1
- package/scripts/verify-release-identity.mjs +1 -1
- package/packages/piagent-core/runtime/policy/bypass-policy.mjs +0 -42
- package/packages/piagent-webui/dist/client/assets/SettingsNavigation-C-tO5iXn.js +0 -3
- package/packages/piagent-webui/dist/client/assets/SettingsPage-Ca-qRSZa.js +0 -1
- package/packages/piagent-webui/dist/client/assets/transcript-view-model-Bq0nkxyu.js +0 -3
|
@@ -1 +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-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":"v1-42-1-title","text":"Dashboard tải nhanh hơn, hash workspace dùng ít bộ nhớ hơn"},{"id":"v1-42-0-title","text":"Dashboard thiết kế lại, tin cũ tải mà không nhảy trang"},{"id":"v1-41-0-title","text":"Báo cáo thay đổi giao diện với ảnh trước/sau"},{"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":"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"}]}]
|
|
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-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":"v1-42-1-title","text":"Dashboard tải nhanh hơn, hash workspace dùng ít bộ nhớ hơn"},{"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
CHANGED
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · VI"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Tài liệu">
|
|
42
42
|
<a href="/quickstart">Tài liệu</a>
|
|
43
43
|
<a href="/whats-new">Changelog</a>
|
package/docs-site/commands.html
CHANGED
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · VI"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Tài liệu">
|
|
42
42
|
<a href="/quickstart">Tài liệu</a>
|
|
43
43
|
<a href="/whats-new">Changelog</a>
|
|
@@ -69,6 +69,7 @@
|
|
|
69
69
|
<tr><td><span class="inline-code">web</span></td><td>Context7, Chrome DevTools, Playwright</td><td>Frontend and web workflows</td></tr>
|
|
70
70
|
<tr><td><span class="inline-code">core</span></td><td>Context7, Chrome DevTools, GitHub</td><td>Default team baseline</td></tr>
|
|
71
71
|
<tr><td><span class="inline-code">popular</span></td><td>core + Playwright + Figma</td><td>A broader development baseline</td></tr>
|
|
72
|
+
<tr><td><span class="inline-code">atlassian</span></td><td>Atlassian Rovo (Jira, Confluence Cloud)</td><td>Jira issues and Confluence pages with the developer's own Atlassian login</td></tr>
|
|
72
73
|
<tr><td><span class="inline-code">all</span></td><td>popular + Figma desktop</td><td>Complete preset</td></tr>
|
|
73
74
|
</tbody>
|
|
74
75
|
</table>
|
|
@@ -80,6 +81,13 @@
|
|
|
80
81
|
</div>
|
|
81
82
|
</section>
|
|
82
83
|
|
|
84
|
+
<section class="section">
|
|
85
|
+
<h2 id="company-sessions">In company sessions</h2>
|
|
86
|
+
<p>Company sessions (<span class="inline-code">piagent studio</span>, the company Terminal and WebUI) use the MCP servers the developer set up for personal Piagent: the same <span class="inline-code">pi-mcp-adapter</span> in <span class="inline-code">~/.piagent/agent</span>, the same configuration and the same logins. Developers add servers themselves; Studio does not manage the list.</p>
|
|
87
|
+
<p>For Jira: <span class="inline-code">piagent-mcp --preset atlassian</span>, then sign in once with <span class="inline-code">/mcp-auth atlassian</span>.</p>
|
|
88
|
+
<p>Two protections stay: a server a repository defines runs only after someone on the machine approves it, and what a server returns reaches the agent as fenced data, never as instructions.</p>
|
|
89
|
+
</section>
|
|
90
|
+
|
|
83
91
|
<section class="section">
|
|
84
92
|
<h2 id="token-efficiency">Token efficiency</h2>
|
|
85
93
|
<p><span class="inline-code">pi-mcp-adapter</span> exposes all servers through one proxy tool named <span class="inline-code">mcp</span> instead of loading every tool schema into startup context. Defaults include <span class="inline-code">directTools: false</span>, <span class="inline-code">outputGuard</span>, and <span class="inline-code">idleTimeout</span>.</p>
|
|
@@ -96,6 +96,7 @@
|
|
|
96
96
|
<tr><td><span class="inline-code">web</span></td><td>Context7, Chrome DevTools, Playwright</td><td>FE/web workflow</td></tr>
|
|
97
97
|
<tr><td><span class="inline-code">core</span></td><td>Context7, Chrome DevTools, GitHub</td><td>Baseline mặc định của team</td></tr>
|
|
98
98
|
<tr><td><span class="inline-code">popular</span></td><td>core + Playwright + Figma</td><td>Baseline nhiều team dev dùng</td></tr>
|
|
99
|
+
<tr><td><span class="inline-code">atlassian</span></td><td>Atlassian Rovo (Jira, Confluence Cloud)</td><td>Issue Jira và trang Confluence, đăng nhập bằng tài khoản Atlassian của dev</td></tr>
|
|
99
100
|
<tr><td><span class="inline-code">all</span></td><td>popular + Figma desktop</td><td>Đầy đủ</td></tr>
|
|
100
101
|
</tbody>
|
|
101
102
|
</table>
|
|
@@ -109,6 +110,13 @@
|
|
|
109
110
|
</div>
|
|
110
111
|
</section>
|
|
111
112
|
|
|
113
|
+
<section class="section">
|
|
114
|
+
<h2 id="phien-cong-ty">Trong phiên công ty</h2>
|
|
115
|
+
<p>Phiên công ty (<span class="inline-code">piagent studio</span>, terminal và WebUI công ty) dùng chính các MCP server dev đã cài cho Piagent cá nhân: cùng <span class="inline-code">pi-mcp-adapter</span> trong <span class="inline-code">~/.piagent/agent</span>, cùng config và cùng login. Dev tự thêm server; Studio không quản lý danh sách này.</p>
|
|
116
|
+
<p>Với Jira: <span class="inline-code">piagent-mcp --preset atlassian</span>, rồi đăng nhập một lần bằng <span class="inline-code">/mcp-auth atlassian</span>.</p>
|
|
117
|
+
<p>Hai lớp bảo vệ vẫn giữ: server do repo khai báo chỉ chạy sau khi có người trên máy duyệt, và kết quả từ server tới agent dưới dạng dữ liệu trong vùng rào, không bao giờ là lệnh.</p>
|
|
118
|
+
</section>
|
|
119
|
+
|
|
112
120
|
<section class="section">
|
|
113
121
|
<h2 id="token">Token efficiency</h2>
|
|
114
122
|
<p><span class="inline-code">pi-mcp-adapter</span> đưa mọi server qua một proxy tool duy nhất tên <span class="inline-code">mcp</span>, thay vì nạp toàn bộ tool schema vào context lúc start. Mặc định <span class="inline-code">directTools: false</span>, cộng với <span class="inline-code">outputGuard</span> và <span class="inline-code">idleTimeout</span>.</p>
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · VI"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Tài liệu">
|
|
42
42
|
<a href="/quickstart">Tài liệu</a>
|
|
43
43
|
<a href="/whats-new">Changelog</a>
|
package/docs-site/ecosystem.html
CHANGED
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · VI"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Tài liệu">
|
|
42
42
|
<a href="/quickstart">Tài liệu</a>
|
|
43
43
|
<a href="/whats-new">Changelog</a>
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
package/docs-site/en/index.html
CHANGED
|
@@ -36,7 +36,7 @@
|
|
|
36
36
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
37
37
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
38
38
|
</a>
|
|
39
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
39
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
40
40
|
<nav class="top-nav" aria-label="Documentation">
|
|
41
41
|
<a href="/en/quickstart">Docs</a>
|
|
42
42
|
<a href="/en/whats-new">Changelog</a>
|
|
@@ -56,7 +56,7 @@
|
|
|
56
56
|
<div class="hero-bg" aria-hidden="true"></div>
|
|
57
57
|
<div class="hero-glow" aria-hidden="true"></div>
|
|
58
58
|
<div class="home-wrap">
|
|
59
|
-
<a class="hero-pill" href="/en/whats-new#v1-
|
|
59
|
+
<a class="hero-pill" href="/en/whats-new#v1-48-0"><b>v1.48.0</b><span>Bypass stops at the handoff: every mode asks before work leaves the machine</span><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-arrow-right"/></svg></a>
|
|
60
60
|
<h1>A coding agent for the whole team, <span class="grad">checked at every step.</span></h1>
|
|
61
61
|
<p class="hero-sub">A guard stops risky tool calls before they run. The team's Harness runs checks and has a subagent review the change. One dashboard for Terminal and the browser, with your model or the company's.</p>
|
|
62
62
|
<div class="hero-cta">
|
|
@@ -99,7 +99,7 @@
|
|
|
99
99
|
<div><strong><span data-count="54">54</span><em>/54</em></strong><span>tasks resolved in the production benchmark</span><small>codex-cli, same model: 48/54</small></div>
|
|
100
100
|
<div><strong>−<span data-count="61">61</span><em>%</em></strong><span>fresh tokens on the same workload</span><small>95% confidence: at least −51.6%</small></div>
|
|
101
101
|
<div><strong><span data-count="52">52</span><em>/52</em></strong><span>secret patterns redacted from output</span><small>0/30 ordinary texts redacted by mistake</small></div>
|
|
102
|
-
<div><strong><span data-count="
|
|
102
|
+
<div><strong><span data-count="131">131</span></strong><span>releases since 2026-07-21</span><small>4,400+ automated tests on macOS and Linux</small></div>
|
|
103
103
|
</div>
|
|
104
104
|
</div>
|
|
105
105
|
</section>
|
|
@@ -280,22 +280,22 @@ pi # Terminal</code></pre></div></div>
|
|
|
280
280
|
<p>Each release says what changed and which Studio or Agent Watch it needs. <a href="/en/whats-new">See the full changelog</a>.</p>
|
|
281
281
|
</div>
|
|
282
282
|
<div class="updates">
|
|
283
|
-
<a class="update" href="/en/whats-new#v1-
|
|
284
|
-
<span class="update-meta"><span class="release-version">v1.
|
|
285
|
-
<h3>
|
|
286
|
-
<p>
|
|
283
|
+
<a class="update" href="/en/whats-new#v1-48-0" data-reveal>
|
|
284
|
+
<span class="update-meta"><span class="release-version">v1.48.0</span>Oct 30, 2026</span>
|
|
285
|
+
<h3>Bypass stops at the handoff: every mode asks before work leaves the machine</h3>
|
|
286
|
+
<p>Pushes, pull requests, publishes and deploys are always approved by you, commands are checked against a full shell syntax tree, approvals gain session and stop answers, and the dashboard streams more smoothly.</p>
|
|
287
287
|
<span class="update-more">Read more <svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-arrow-right"/></svg></span>
|
|
288
288
|
</a>
|
|
289
|
-
<a class="update" href="/en/whats-new#v1-
|
|
290
|
-
<span class="update-meta"><span class="release-version">v1.
|
|
291
|
-
<h3>
|
|
292
|
-
<p>
|
|
289
|
+
<a class="update" href="/en/whats-new#v1-47-0" data-reveal>
|
|
290
|
+
<span class="update-meta"><span class="release-version">v1.47.0</span>Oct 29, 2026</span>
|
|
291
|
+
<h3>Company sessions use your MCP servers and drive iOS and Android simulators</h3>
|
|
292
|
+
<p>Jira, GitHub and every MCP server you set up for Piagent now work in company sessions, and the agent builds, runs, screenshots and tests mobile apps on simulators itself.</p>
|
|
293
293
|
<span class="update-more">Read more <svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-arrow-right"/></svg></span>
|
|
294
294
|
</a>
|
|
295
|
-
<a class="update" href="/en/whats-new#v1-46-
|
|
296
|
-
<span class="update-meta"><span class="release-version">v1.46.
|
|
297
|
-
<h3>
|
|
298
|
-
<p>
|
|
295
|
+
<a class="update" href="/en/whats-new#v1-46-4" data-reveal>
|
|
296
|
+
<span class="update-meta"><span class="release-version">v1.46.4</span>Oct 29, 2026</span>
|
|
297
|
+
<h3>One subagent instead of a refused request; update reads a commented models.json</h3>
|
|
298
|
+
<p>Company sessions no longer loop on a refused subagent call, and the update no longer stops when the Pi model list file has comments.</p>
|
|
299
299
|
<span class="update-more">Read more <svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-arrow-right"/></svg></span>
|
|
300
300
|
</a>
|
|
301
301
|
</div>
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
package/docs-site/en/mcp.html
CHANGED
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
|
@@ -176,6 +176,7 @@
|
|
|
176
176
|
<tr><td><span class="inline-code">web</span></td><td>Context7, Chrome DevTools, Playwright</td><td>Frontend and web workflows</td></tr>
|
|
177
177
|
<tr><td><span class="inline-code">core</span></td><td>Context7, Chrome DevTools, GitHub</td><td>Default team baseline</td></tr>
|
|
178
178
|
<tr><td><span class="inline-code">popular</span></td><td>core + Playwright + Figma</td><td>A broader development baseline</td></tr>
|
|
179
|
+
<tr><td><span class="inline-code">atlassian</span></td><td>Atlassian Rovo (Jira, Confluence Cloud)</td><td>Jira issues and Confluence pages with the developer's own Atlassian login</td></tr>
|
|
179
180
|
<tr><td><span class="inline-code">all</span></td><td>popular + Figma desktop</td><td>Complete preset</td></tr>
|
|
180
181
|
</tbody>
|
|
181
182
|
</table>
|
|
@@ -187,6 +188,13 @@
|
|
|
187
188
|
</div>
|
|
188
189
|
</section>
|
|
189
190
|
|
|
191
|
+
<section class="section">
|
|
192
|
+
<h2 id="company-sessions">In company sessions</h2>
|
|
193
|
+
<p>Company sessions (<span class="inline-code">piagent studio</span>, the company Terminal and WebUI) use the MCP servers the developer set up for personal Piagent: the same <span class="inline-code">pi-mcp-adapter</span> in <span class="inline-code">~/.piagent/agent</span>, the same configuration and the same logins. Developers add servers themselves; Studio does not manage the list.</p>
|
|
194
|
+
<p>For Jira: <span class="inline-code">piagent-mcp --preset atlassian</span>, then sign in once with <span class="inline-code">/mcp-auth atlassian</span>.</p>
|
|
195
|
+
<p>Two protections stay: a server a repository defines runs only after someone on the machine approves it, and what a server returns reaches the agent as fenced data, never as instructions.</p>
|
|
196
|
+
</section>
|
|
197
|
+
|
|
190
198
|
<section class="section">
|
|
191
199
|
<h2 id="token-efficiency">Token efficiency</h2>
|
|
192
200
|
<p><span class="inline-code">pi-mcp-adapter</span> exposes all servers through one proxy tool named <span class="inline-code">mcp</span> instead of loading every tool schema into startup context. Defaults include <span class="inline-code">directTools: false</span>, <span class="inline-code">outputGuard</span>, and <span class="inline-code">idleTimeout</span>.</p>
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart" aria-current="page">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
package/docs-site/en/scope.html
CHANGED
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
package/docs-site/en/team.html
CHANGED
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
package/docs-site/en/update.html
CHANGED
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
<span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
|
|
38
38
|
<span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
|
|
39
39
|
</a>
|
|
40
|
-
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.
|
|
40
|
+
<a class="version-badge" href="/en/whats-new" data-docs-version="v1.48.0" title="v1.48.0 docs · EN"><span class="dot"></span>v1.48.0</a>
|
|
41
41
|
<nav class="top-nav" aria-label="Documentation">
|
|
42
42
|
<a href="/en/quickstart">Docs</a>
|
|
43
43
|
<a href="/en/whats-new">Changelog</a>
|
|
@@ -145,9 +145,9 @@
|
|
|
145
145
|
<h2 id="pin-for-a-team">Pin one release for a team</h2>
|
|
146
146
|
<p>For a team rollout, install the exact Pi host and platform release, then run the installer in stable mode. The <code>--dry-run</code> step prints what would change.</p>
|
|
147
147
|
<div class="command-card">
|
|
148
|
-
<header><span>Pinned install</span><button class="clip-btn" data-clip="npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0 npm install -g --ignore-scripts @piagent/platform@1.
|
|
148
|
+
<header><span>Pinned install</span><button class="clip-btn" data-clip="npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0 npm install -g --ignore-scripts @piagent/platform@1.48.0 piagent-install --stable --dry-run piagent-install --stable">Copy</button></header>
|
|
149
149
|
<pre><code>npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0
|
|
150
|
-
npm install -g --ignore-scripts @piagent/platform@1.
|
|
150
|
+
npm install -g --ignore-scripts @piagent/platform@1.48.0
|
|
151
151
|
piagent-install --stable --dry-run
|
|
152
152
|
piagent-install --stable</code></pre>
|
|
153
153
|
</div>
|