@piagent/platform 1.43.9 → 1.44.1

package/docs-site/security.html

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

package/docs-site/team.html

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

package/docs-site/update.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.43.9" title="v1.43.9 docs · VI"><span class="dot"></span>v1.43.9</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.44.1" title="v1.44.1 docs · VI"><span class="dot"></span>v1.44.1</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new">Changelog</a>
@@ -145,9 +145,9 @@
   <h2 id="pin-cho-team">Pin một bản cho cả team</h2>
   <p>Khi rollout cho team, cài đúng bản Pi host và đúng bản platform, rồi chạy installer ở chế độ stable. Bước <code>--dry-run</code> in ra những gì sẽ đổi.</p>
   <div class="command-card">
-    <header><span>Cài pin theo bản</span><button class="clip-btn" data-clip="npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0&#10;npm install -g --ignore-scripts @piagent/platform@1.43.9&#10;piagent-install --stable --dry-run&#10;piagent-install --stable">Lấy lệnh</button></header>
+    <header><span>Cài pin theo bản</span><button class="clip-btn" data-clip="npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0&#10;npm install -g --ignore-scripts @piagent/platform@1.44.1&#10;piagent-install --stable --dry-run&#10;piagent-install --stable">Lấy lệnh</button></header>
     <pre><code>npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0
-npm install -g --ignore-scripts @piagent/platform@1.43.9
+npm install -g --ignore-scripts @piagent/platform@1.44.1
 piagent-install --stable --dry-run
 piagent-install --stable</code></pre>
   </div>

package/docs-site/whats-new.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.43.9" title="v1.43.9 docs · VI"><span class="dot"></span>v1.43.9</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.44.1" title="v1.44.1 docs · VI"><span class="dot"></span>v1.44.1</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new" aria-current="page">Changelog</a>
@@ -108,7 +108,34 @@
 <div class="release-filter" role="toolbar" aria-label="Lọc theo loại thay đổi"><button type="button" data-filter-kind="all" aria-pressed="true">Tất cả</button><button type="button" data-filter-kind="new" aria-pressed="false">Mới</button><button type="button" data-filter-kind="improved" aria-pressed="false">Cải thiện</button><button type="button" data-filter-kind="fixed" aria-pressed="false">Sửa lỗi</button><button type="button" data-filter-kind="security" aria-pressed="false">Bảo mật</button></div>
 <section class="section releases" data-releases>
 <h2 id="latest" class="sr-only">Mới nhất</h2>
-<article class="release latest" id="v1-43-9" data-release>
+<article class="release latest" id="v1-44-1" data-release>
+  <div class="release-meta"><a class="release-version" href="#v1-44-1">v1.44.1</a><time class="release-date" datetime="2026-10-28">28/10/2026</time></div>
+  <div class="release-body">
+    <h3 data-toc-skip id="v1-44-1-title">Giữ Pi của bạn, chọn giao diện Terminal, thêm repo skill</h3>
+    <p>Dev đang dùng Pi mới hơn giữ nguyên Pi của mình, Piagent chạy bản Pi riêng đúng bản pin; /style chọn giao diện Terminal; piagent skills add thêm repo skill như mattpocock/skills.</p>
+    <ul class="release-items">
+      <li data-kind="new"><span class="kind kind-new">Mới</span><span>/style chọn giao diện Terminal: system, dark, light của Pi hoặc ocean, paper, contrast, focus của Piagent. Terminal công ty nhớ lựa chọn.</span></li>
+      <li data-kind="new"><span class="kind kind-new">Mới</span><span>piagent skills add mattpocock/skills thêm repo skill GitHub ghim một commit; skill dùng được dạng /skill:tên trong Pi, Terminal công ty và dashboard.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Setup, install, update không còn hạ pi mới hơn của dev (vd 1.4.0) về bản pin 1.3.0: Piagent giữ bản riêng trong ~/.piagent/pi-host cho phiên công ty, dashboard và lệnh piagent pi.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>piagent-uninstall --with-host gỡ bản Pi riêng của Piagent và giữ nguyên pi mới hơn của dev.</span></li>
+      <li data-kind="security"><span class="kind kind-security">Bảo mật</span><span>Năm advisory undici công bố ngày 2026-10-27 được chấp nhận tạm tới 2026-11-07: undici 8.10.2 do mọi Pi host ghim cứng, bản vá ở 8.12.2.</span></li>
+    </ul>
+  </div>
+</article>
+<article class="release" id="v1-44-0" data-release>
+  <div class="release-meta"><a class="release-version" href="#v1-44-0">v1.44.0</a><time class="release-date" datetime="2026-10-28">28/10/2026</time></div>
+  <div class="release-body">
+    <h3 data-toc-skip id="v1-44-0-title">Giữ Pi của bạn, chọn giao diện Terminal, thêm repo skill <span class="tag">không phát hành</span></h3>
+    <p>Đã tag nhưng chưa publish: advisory undici mới trong Pi host làm kiểm tra runtime fail. Thay bằng 1.44.1.</p>
+    <ul class="release-items">
+      <li data-kind="new"><span class="kind kind-new">Mới</span><span>/style chọn giao diện Terminal: system, dark, light của Pi hoặc ocean, paper, contrast, focus của Piagent. Terminal công ty nhớ lựa chọn.</span></li>
+      <li data-kind="new"><span class="kind kind-new">Mới</span><span>piagent skills add mattpocock/skills thêm repo skill GitHub ghim một commit; skill dùng được dạng /skill:tên trong Pi, Terminal công ty và dashboard.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Setup, install, update không còn hạ pi mới hơn của dev (vd 1.4.0) về bản pin 1.3.0: Piagent giữ bản riêng trong ~/.piagent/pi-host cho phiên công ty, dashboard và lệnh piagent pi.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>piagent-uninstall --with-host gỡ bản Pi riêng của Piagent và giữ nguyên pi mới hơn của dev.</span></li>
+    </ul>
+  </div>
+</article>
+<article class="release" id="v1-43-9" data-release>
   <div class="release-meta"><a class="release-version" href="#v1-43-9">v1.43.9</a><time class="release-date" datetime="2026-10-27">27/10/2026</time></div>
   <div class="release-body">
     <h3 data-toc-skip id="v1-43-9-title">Đủ skill đã cài, và mở file agent gửi lại</h3>
@@ -402,40 +429,37 @@
     <p class="release-requires"><strong>Cần:</strong> Agent Studio 0.37.0</p>
   </div>
 </article>
-<article class="release" id="v1-35-1" data-release>
-  <div class="release-meta"><a class="release-version" href="#v1-35-1">v1.35.1</a><time class="release-date" datetime="2026-10-21">21/10/2026</time></div>
-  <div class="release-body">
-    <h3 data-toc-skip id="v1-35-1-title">Lỗi tạm thời của nhà cung cấp model không còn làm dừng task dài</h3>
-    <p>Lỗi của nhà cung cấp model giữa câu trả lời được hỏi lại, và vòng bị cắt bởi lỗi như vậy tự chạy tiếp sau một lúc chờ.</p>
-    <ul class="release-items">
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Khi không hỏi lại được, vòng sau tự bắt đầu sau một lúc chờ và báo agent lý do, tối đa 8 lần mỗi tin nhắn của member (khoảng 23 phút).</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Vòng kết thúc tốt sẽ đặt lại bộ đếm, Stop dừng lúc chờ, và sau lần cuối lượt báo lỗi kèm lý do.</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Mỗi lần hỏi lại được ghi vào log trên máy của member, để đọc lại vì sao task dừng hay chạy tiếp.</span></li>
-      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Lỗi của nhà cung cấp sau một bước tool từng dừng task dài cho tới khi member nhắn lại; giờ Piagent hỏi lại sau 2 và 4 giây.</span></li>
-    </ul>
-  </div>
-</article>
-<article class="release" id="v1-35-0" data-release>
-  <div class="release-meta"><a class="release-version" href="#v1-35-0">v1.35.0</a><time class="release-date" datetime="2026-10-21">21/10/2026</time></div>
-  <div class="release-body">
-    <h3 data-toc-skip id="v1-35-0-title">Task dài của công ty chạy qua được lúc Studio cập nhật</h3>
-    <p>Khi Studio dừng, khởi động lại hay cập nhật giữa task, Piagent chờ rồi làm tiếp thay vì báo lỗi, và một lượt trên dashboard chạy được 24 giờ.</p>
-    <ul class="release-items">
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Khi Studio không phản hồi, Piagent đọc heartbeat và hỏi lại khi Studio trở lại, không giới hạn thời gian; Stop vẫn dừng được.</span></li>
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Mỗi lần chờ được ghi vào log trên máy và báo về Studio, nơi hiện nó kèm nguyên nhân trong Logs → &quot;Mất kết nối&quot;.</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Vòng mà dashboard không phát lại được sẽ tự bắt đầu lại và báo agent Studio vừa cập nhật, để agent làm tiếp từ chỗ dở.</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Một tin nhắn của member chạy được tới 24 giờ trên dashboard (trước là 6); giới hạn 15 phút im lặng vẫn giữ.</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Lỗi key, quota hay policy vẫn báo lỗi ngay như trước.</span></li>
-    </ul>
-    <p class="release-requires"><strong>Cần:</strong> Agent Studio 0.36.0</p>
-  </div>
-</article>
 </section>
 <section class="section archive">
   <h2 id="archive">Các bản trước</h2>
   <p class="section-lead">Bản cũ hơn, gom theo tháng. Mở một tháng để xem từng thay đổi.</p>
   <details class="release-archive">
-    <summary><span>Tháng 10/2026</span><span class="archive-count">50</span></summary>
+    <summary><span>Tháng 10/2026</span><span class="archive-count">52</span></summary>
+    <div class="archive-row" id="v1-35-1">
+      <div class="archive-head"><a class="release-version" href="#v1-35-1">v1.35.1</a> <span class="release-date">21/10/2026</span></div>
+      <div class="archive-body">
+        <p><strong>Lỗi tạm thời của nhà cung cấp model không còn làm dừng task dài</strong> — Lỗi của nhà cung cấp model giữa câu trả lời được hỏi lại, và vòng bị cắt bởi lỗi như vậy tự chạy tiếp sau một lúc chờ.</p>
+        <ul class="release-items">
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Khi không hỏi lại được, vòng sau tự bắt đầu sau một lúc chờ và báo agent lý do, tối đa 8 lần mỗi tin nhắn của member (khoảng 23 phút).</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Vòng kết thúc tốt sẽ đặt lại bộ đếm, Stop dừng lúc chờ, và sau lần cuối lượt báo lỗi kèm lý do.</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Mỗi lần hỏi lại được ghi vào log trên máy của member, để đọc lại vì sao task dừng hay chạy tiếp.</span></li>
+        <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Lỗi của nhà cung cấp sau một bước tool từng dừng task dài cho tới khi member nhắn lại; giờ Piagent hỏi lại sau 2 và 4 giây.</span></li>
+        </ul>
+      </div>
+    </div>
+    <div class="archive-row" id="v1-35-0">
+      <div class="archive-head"><a class="release-version" href="#v1-35-0">v1.35.0</a> <span class="release-date">21/10/2026</span></div>
+      <div class="archive-body">
+        <p><strong>Task dài của công ty chạy qua được lúc Studio cập nhật</strong> — Khi Studio dừng, khởi động lại hay cập nhật giữa task, Piagent chờ rồi làm tiếp thay vì báo lỗi, và một lượt trên dashboard chạy được 24 giờ.</p>
+        <ul class="release-items">
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Khi Studio không phản hồi, Piagent đọc heartbeat và hỏi lại khi Studio trở lại, không giới hạn thời gian; Stop vẫn dừng được.</span></li>
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Mỗi lần chờ được ghi vào log trên máy và báo về Studio, nơi hiện nó kèm nguyên nhân trong Logs → &quot;Mất kết nối&quot;.</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Vòng mà dashboard không phát lại được sẽ tự bắt đầu lại và báo agent Studio vừa cập nhật, để agent làm tiếp từ chỗ dở.</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Một tin nhắn của member chạy được tới 24 giờ trên dashboard (trước là 6); giới hạn 15 phút im lặng vẫn giữ.</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Lỗi key, quota hay policy vẫn báo lỗi ngay như trước.</span></li>
+        </ul>
+      </div>
+    </div>
     <div class="archive-row" id="v1-34-3">
       <div class="archive-head"><a class="release-version" href="#v1-34-3">v1.34.3</a> <span class="release-date">20/10/2026</span></div>
       <div class="archive-body">

package/docs-site/windows.html

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

package/docs-site/workflows.html

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

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

@@ -256,8 +256,8 @@
     },
     {
       "path": "tests",
-      "fileCount": 627,
-      "sha256": "b5348255a9be4cc54e203df95af8677a1defd3407017fc45c8a4a0cbcf5d6469"
+      "fileCount": 630,
+      "sha256": "3cb368eea2af5b678eb083ca68195a165db4a05888045939bc846c91b3fa6350"
     }
   ],
   "custodianComparisonRules": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piagent/platform",
-  "version": "1.43.9",
+  "version": "1.44.1",
   "license": "MIT",
   "publishConfig": {
     "access": "public",
@@ -101,6 +101,9 @@
     "skills": [
       "packages/piagent-core/skills"
     ],
+    "themes": [
+      "packages/piagent-core/themes"
+    ],
     "subagents": {
       "agents": [
         "packages/piagent-core/subagents"

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

@@ -171,6 +171,7 @@ import { prefixCompletions, registerPiagentTool as registerToolDefinition, regis
 import { registerTaskEvidenceTools } from "../runtime/registration/task-evidence-tools.ts";
 import { registerAgentResources } from "../runtime/registration/agent-resources.ts";
 import { registerTerminalUpdateOffer } from "../runtime/update/terminal-update-offer.mjs";
+import { registerStyleCommand } from "../runtime/terminal/terminal-style.mjs";
 import { userSkillFolders } from "../runtime/resources/agent-resources.mjs";
 import { FRESH_COMMAND_ACTIONS, FRESH_COMMAND_HELP, ONBOARDING_COMMAND_ACTIONS, WORKFLOW_COMMAND_EXCLUSIONS } from "../runtime/registration/operator-catalogs.ts";
 import { registerPiagentStatusCommand } from "../runtime/registration/runtime-model-status.ts";
@@ -4242,5 +4243,7 @@ export default function piagentGuard(pi: ExtensionAPI) {
   registerAgentResources(pi);
   // A new release is asked about in the Terminal, as the dashboard does.
   registerTerminalUpdateOffer(pi, { installed: installedPlatformVersion(), packageRoot: PLATFORM_ROOT, restart: "pi" });
+  // The Terminal's look (/style): Pi keeps the pick in its own settings.
+  registerStyleCommand(pi);
   registerSessionCommands(pi, { ...registrationDeps, ...contextCommandApi });
 }

package/packages/piagent-core/managed/pi-host.mjs

@@ -1,11 +1,15 @@
+import { spawnSync } from 'node:child_process';
 import fs from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
 
 // The Pi host company sessions are qualified on: the package's peer
 // dependency, which piagent-setup installs and CI tests. One place, so moving
 // to a new host is one change (scripts/verify-release-identity.mjs keeps its
 // own copy on purpose, to catch a pin moved by accident).
-export const PI_HOST_VERSION = JSON.parse(fs.readFileSync(new URL('../../../package.json', import.meta.url), 'utf8')).peerDependencies['@earendil-works/pi-coding-agent'];
+export const PI_HOST_VERSION = JSON.parse(fs.readFileSync(new URL('../../../package.json', import.meta.url), 'utf8')).peerDependencies?.['@earendil-works/pi-coding-agent'];
+
+const HOST_NAME = '@earendil-works/pi-coding-agent';
 
 // A package the host depends on (@earendil-works/pi-ai), found the way Node
 // finds it from the host: in its own node_modules (0.87.1 shipped a
@@ -17,3 +21,58 @@ export function hostPackage(sdk, name) {
     if (path.dirname(dir) === dir) throw new Error(`managed-sdk-dependency-missing: ${name}`);
   }
 }
+
+// A member may run their own Pi, newer than the pinned host (they keep up
+// with Pi themselves). Piagent never replaces it: the pinned host is installed
+// beside it, privately, under ~/.piagent/pi-host/<version>, and company
+// sessions, the dashboard and `piagent pi` run that one.
+export function privateHostPrefix(version = PI_HOST_VERSION, home = os.homedir()) {
+  return path.join(home, '.piagent', 'pi-host', version);
+}
+
+// The private host's package root when it holds exactly `version`, else null.
+export function privateHostRoot(version = PI_HOST_VERSION, home = os.homedir()) {
+  const root = path.join(privateHostPrefix(version, home), 'node_modules', ...HOST_NAME.split('/'));
+  try {
+    const manifest = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
+    return manifest.name === HOST_NAME && manifest.version === version ? fs.realpathSync(root) : null;
+  } catch { return null; }
+}
+
+// The host's command line entry (`pi`), as its manifest names it.
+export function hostCli(root) {
+  const bin = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).bin;
+  return path.join(root, typeof bin === 'string' ? bin : bin.pi);
+}
+
+const parts = (version) => String(version).split(/[+-]/)[0].split('.').map(Number);
+export function compareVersions(a, b) {
+  const x = parts(a), y = parts(b);
+  for (let index = 0; index < 3; index += 1) if ((x[index] ?? 0) !== (y[index] ?? 0)) return (x[index] ?? 0) - (y[index] ?? 0);
+  return 0;
+}
+
+// What setup does with the `pi` on PATH: nothing when it is the pinned host;
+// keep a newer one (the member's own) and install the pinned host privately;
+// replace a missing or older one, as Piagent itself put it there.
+export function hostPlan(current, pinned = PI_HOST_VERSION) {
+  if (current === pinned) return 'current';
+  if (current && compareVersions(current, pinned) > 0) return 'private';
+  return 'global';
+}
+
+// Installs the pinned host into its private prefix (no install scripts, as
+// the global install). Returns the package root.
+export function installPrivateHost({ version = PI_HOST_VERSION, home = os.homedir(), npm = 'npm', dryRun = false, log = () => {} } = {}) {
+  const existing = privateHostRoot(version, home);
+  if (existing) return existing;
+  const prefix = privateHostPrefix(version, home);
+  const args = ['install', '--prefix', prefix, '--ignore-scripts', '--no-audit', '--no-fund', '--no-save', `${HOST_NAME}@${version}`];
+  log(`${dryRun ? 'DRY RUN: ' : ''}${npm} ${args.join(' ')}`);
+  if (dryRun) return path.join(prefix, 'node_modules', ...HOST_NAME.split('/'));
+  fs.mkdirSync(prefix, { recursive: true, mode: 0o700 });
+  const result = spawnSync(npm, args, { stdio: ['ignore', 'inherit', 'inherit'], shell: process.platform === 'win32' });
+  const root = privateHostRoot(version, home);
+  if (result.status !== 0 || !root) throw new Error(`pi-host-private-install-failed: ${HOST_NAME}@${version}`);
+  return root;
+}

package/packages/piagent-core/managed/resource-loader.mjs

@@ -25,13 +25,14 @@ export function projectInstructions(cwd, top = cwd) {
 // Managed sessions never consult the personal trust store or execute resources
 // discovered in a project. Skills and commands are text (agent-skills.mjs):
 // what they ask for runs with the session's own tools.
-export function managedResourceLoader(api, { systemPrompt, extensions = [], runtime = api.createExtensionRuntime(), agentsFiles = [], skills = [], prompts = [] } = {}) {
+// themes: Piagent's own (the company Terminal's /style), loaded by the host.
+export function managedResourceLoader(api, { systemPrompt, extensions = [], runtime = api.createExtensionRuntime(), agentsFiles = [], skills = [], prompts = [], themes = [] } = {}) {
   const empty = Object.freeze([]);
   return Object.freeze({
     getExtensions: () => ({ extensions, errors: empty, runtime }),
     getSkills: () => ({ skills: [...skills], diagnostics: empty }),
     getPrompts: () => ({ prompts: [...prompts], diagnostics: empty }),
-    getThemes: () => ({ themes: empty, diagnostics: empty }),
+    getThemes: () => ({ themes: [...themes], diagnostics: empty }),
     getAgentsFiles: () => ({ agentsFiles: agentsFiles.map((file) => ({ ...file })) }),
     getSystemPrompt: () => typeof systemPrompt === 'function' ? systemPrompt() : systemPrompt,
     getSystemPromptSource: () => undefined,

package/packages/piagent-core/managed/session.mjs

@@ -27,6 +27,7 @@ import { workflowContextTool, workflowContextExtension } from './workflow-contex
 import { beforeDelegate } from './objections.mjs';
 import { HELPER_CALLS, HELPER_ROLES, helperRoles, helperPrompt, webPrompt, delegateDescription } from './helper-roles.mjs'; import { delegateParameters, delegateArgs, SPEC_PROMPT } from './helper-settlement.mjs';
 import { loadAgentResources } from './agent-skills.mjs';
+import { loadPiagentThemes } from '../runtime/terminal/terminal-style.mjs';
 import { restorePermission, recordBypass, permissionSetter } from './permission.mjs';
 import { commandTools, servicesPrompt } from './command-tools.mjs'; import { attachMemory, memoryToolsFor, openRound, closeRound, prepareMemoryContext, trackMemoryLessons } from './memory.mjs';
 
@@ -135,7 +136,7 @@ export class ManagedSession {
     self.checks = repositoryChecks(agentsFiles, self.cwd, self.boundary.repositoryTop);
     // The Harness workflow (possibly changed on a later enrollment) adds its process to the prompt.
     const loader = managedResourceLoader(api, { systemPrompt: () => BASE_PROMPT + referencePrompt(self.boundary.userHome) + TEST_PROMPT + servicesPrompt(self.boundary) + webPrompt(helperRoles(manifest)) + helperPrompt(helperRoles(self.manifest)) + workflowPrompt(workflowPolicy(self.manifest), self.checks), agentsFiles,
-      skills: self.resources.skills, prompts: self.resources.prompts, ...await inlineExtensions(api, sdk, self.cwd,
+      skills: self.resources.skills, prompts: self.resources.prompts, themes: terminalExtensions.length ? await loadPiagentThemes(sdk) : [], ...await inlineExtensions(api, sdk, self.cwd,
         [...terminalExtensions, workflowContextExtension(self.cwd, () => self.session.sessionManager)]) });
     const settings = api.SettingsManager.inMemory({ retry: { enabled: false, provider: { maxRetries: 0 } }, cacheWarming: 'off', enableInstallTelemetry: false, enableAnalytics: false, enableSkillCommands: true });
     const manager = sessionManager ?? api.SessionManager.inMemory(self.cwd); attachMemory(self, manager, agentDir, g => verifyGrant(g, self.manifest, 'main')); self.studioLink = new StudioLink({ origin: self.origin, agentDir, notify: event => self.notify(event), ui: () => self.session?.extensionRunner?.getUIContext?.() });

package/packages/piagent-core/package.json

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

package/packages/piagent-core/runtime/resources/plugin-skills.mjs

@@ -2,7 +2,8 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 
-// Skills and commands a member installed as Claude or Codex plugins
+// Skills and commands a member installed as Claude or Codex plugins, or added
+// to Piagent as a skill source
 // (superpowers, a team's own marketplace…). Each agent keeps them in its plugin
 // cache, not in ~/.claude/skills or ~/.codex/skills, so they are found here:
 // the plugins the agent records as installed, the newest version of each, and
@@ -119,9 +120,37 @@ function codexPlugins(home) {
   return found.filter(Boolean);
 }
 
-// The member's plugins, Claude's first, at most MAX_PLUGINS. A plugin
-// that cannot be read is left out; it never keeps a conversation from opening.
+// Skill repositories the member added with `piagent skills add` (for example
+// mattpocock/skills), each kept at the commit it was added at under
+// ~/.piagent/skill-sources and listed in ~/.piagent/skill-sources.json
+// (scripts/skill-sources.mjs). A repository that ships a Claude or Codex
+// plugin manifest is read through it, so only the skills it publishes load.
+export function skillSourcesRoot(home = os.homedir()) {
+  return path.join(home, '.piagent', 'skill-sources');
+}
+export function skillSourcesIndex(home = os.homedir()) {
+  return path.join(home, '.piagent', 'skill-sources.json');
+}
+function piagentSources(home) {
+  const sources = readJson(skillSourcesIndex(home))?.sources;
+  if (!Array.isArray(sources)) return [];
+  const root = folder(skillSourcesRoot(home));
+  if (!root) return [];
+  return sources.filter((entry) => entry && typeof entry.path === 'string' && entry.enabled !== false).map((entry) => {
+    const dir = folder(path.resolve(root, entry.path));
+    return dir && inside(dir, root) ? skillSourcePlugin(dir, entry.name || entry.repo) : null;
+  }).filter(Boolean);
+}
+// One source's copy read as a plugin: through its Claude or Codex manifest when it has one.
+export function skillSourcePlugin(dir, name) {
+  const manifestDir = fs.existsSync(path.join(dir, '.claude-plugin', 'plugin.json')) ? '.claude-plugin' : '.codex-plugin';
+  return plugin(dir, 'piagent', name, manifestDir);
+}
+
+// The member's plugins, Claude's first, then Codex's and the skill sources
+// added to Piagent, at most MAX_PLUGINS. A plugin that cannot be read is left
+// out; it never keeps a conversation from opening.
 export function memberPlugins({ home = os.homedir(), projects = [] } = {}) {
   const read = (load) => { try { return load(); } catch { return []; } };
-  return [...read(() => claudePlugins(home, projects)), ...read(() => codexPlugins(home))].slice(0, MAX_PLUGINS);
+  return [...read(() => claudePlugins(home, projects)), ...read(() => codexPlugins(home)), ...read(() => piagentSources(home))].slice(0, MAX_PLUGINS);
 }

package/packages/piagent-core/runtime/terminal/terminal-style.d.mts

@@ -0,0 +1,7 @@
+export const THEMES_DIR: string;
+export function piagentThemeFiles(dir?: string): string[];
+export function loadPiagentThemes(sdkRoot: string, dir?: string): Promise<unknown[]>;
+export function readStyle(home?: string): string | null;
+export function writeStyle(name: string, home?: string): void;
+export function styleChoices(ui: unknown): { name: string; label: string }[];
+export function registerStyleCommand(pi: unknown, options?: { remember?: boolean; home?: string }): void;

package/packages/piagent-core/runtime/terminal/terminal-style.mjs

@@ -0,0 +1,99 @@
+// The Terminal's look, chosen by the member: /style lists Pi's own themes
+// (system, dark, light) and Piagent's (packages/piagent-core/themes), shows
+// the one picked at once and keeps it. Personal Pi keeps it in its own
+// settings (`theme`), as /settings → Theme does. The company Terminal runs
+// with settings in memory, so its choice is kept in ~/.pi beside the other
+// Terminal state and put back when a conversation opens.
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+export const THEMES_DIR = fileURLToPath(new URL("../../themes", import.meta.url));
+const STYLE_FILE = "piagent-terminal-style.json";
+// The dashboard's own runtime UI draws its own page: no Terminal theme there.
+const GATEWAY_UI = Symbol.for("piagent.webui.gateway-runtime-ui.v1");
+
+// What each style is for, in the member's words; Pi's own are listed first.
+const DESCRIPTIONS = {
+  system: "theo màu của terminal (mặc định của Pi)",
+  dark: "nền tối của Pi",
+  light: "nền sáng của Pi",
+  "piagent-ocean": "nền tối, xanh biển dịu mắt cho phiên dài",
+  "piagent-paper": "nền sáng, tông giấy ấm",
+  "piagent-contrast": "tương phản cao, cho phòng sáng hoặc máy chiếu",
+  "piagent-focus": "gần như đơn sắc, một màu nhấn hổ phách",
+};
+
+export function piagentThemeFiles(dir = THEMES_DIR) {
+  try { return fs.readdirSync(dir).filter((name) => name.endsWith(".json")).sort().map((name) => path.join(dir, name)); }
+  catch { return []; }
+}
+
+// Piagent's themes loaded with the host's own loader, for a runtime that
+// supplies its own resources (the company Terminal). One that does not load
+// on this host is left out.
+export async function loadPiagentThemes(sdkRoot, dir = THEMES_DIR) {
+  let loader;
+  try { loader = await import(pathToFileURL(path.join(sdkRoot, "dist", "modes", "interactive", "theme", "theme.js")).href); }
+  catch { return []; }
+  const themes = [];
+  for (const file of piagentThemeFiles(dir)) {
+    try { themes.push(loader.loadThemeFromPath(file)); } catch { /* another host's schema */ }
+  }
+  return themes;
+}
+
+const styleFile = (home) => path.join(home ?? os.homedir(), ".pi", STYLE_FILE);
+export function readStyle(home) {
+  try { const name = JSON.parse(fs.readFileSync(styleFile(home), "utf8"))?.theme; return typeof name === "string" && name ? name : null; }
+  catch { return null; }
+}
+export function writeStyle(name, home) {
+  const file = styleFile(home);
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(file, `${JSON.stringify({ theme: name })}\n`, { mode: 0o600 });
+}
+
+// The styles to offer: Pi's built-ins and every loaded theme, each once.
+export function styleChoices(ui) {
+  const names = [...new Set(["system", "dark", "light", ...(ui?.getAllThemes?.() ?? []).map((item) => item?.name).filter(Boolean)])];
+  return names.map((name) => ({ name, label: DESCRIPTIONS[name] ? `${name} — ${DESCRIPTIONS[name]}` : name }));
+}
+
+// remember: true where Pi does not keep the setting itself (company Terminal).
+export function registerStyleCommand(pi, { remember = false, home } = {}) {
+  const apply = (ctx, name) => {
+    const result = ctx.ui.setTheme(name);
+    if (!result?.success) return result?.error ?? "unknown";
+    if (remember) writeStyle(name, home);
+    return null;
+  };
+  if (remember) {
+    pi.on("session_start", async (_event, ctx) => {
+      if (!ctx.hasUI || ctx.ui?.[GATEWAY_UI]) return;
+      const saved = readStyle(home);
+      if (saved && ctx.ui.theme?.name !== saved) ctx.ui.setTheme?.(saved);
+    });
+  }
+  pi.registerCommand("style", {
+    description: "Chọn giao diện (theme) của Terminal: /style để chọn trong danh sách, /style <tên> để đổi ngay",
+    getArgumentCompletions: (prefix) => {
+      const typed = String(prefix ?? "").trim();
+      return Object.keys(DESCRIPTIONS).filter((name) => name !== typed && name.startsWith(typed)).map((value) => ({ value, label: value }));
+    },
+    handler: async (args, ctx) => {
+      if (!ctx.hasUI || ctx.ui?.[GATEWAY_UI] || typeof ctx.ui?.setTheme !== "function") { ctx.ui?.notify?.("/style chỉ dùng trong Terminal.", "info"); return; }
+      const choices = styleChoices(ctx.ui), current = ctx.ui.theme?.name;
+      let name = String(args ?? "").trim();
+      if (!name) {
+        const picked = await ctx.ui.select(`Giao diện Terminal (đang: ${current ?? "system"})`, choices.map((item) => item.label));
+        if (!picked) return;
+        name = choices.find((item) => item.label === picked)?.name ?? picked;
+      }
+      if (!choices.some((item) => item.name === name)) { ctx.ui.notify(`Không có giao diện "${name}". Có: ${choices.map((item) => item.name).join(", ")}.`, "warning"); return; }
+      const error = apply(ctx, name);
+      ctx.ui.notify(error ? `Không đổi được giao diện: ${error}` : `Đã đổi giao diện sang ${name}.`, error ? "error" : "info");
+    },
+  });
+}

package/packages/piagent-core/themes/piagent-contrast.json

@@ -0,0 +1,78 @@
+{
+	"$schema": "https://pi.dev/schemas/theme.schema.json",
+	"name": "piagent-contrast",
+	"appearance": "dark",
+	"vars": {
+		"text": "okhsl(0 0% 98%)",
+		"muted": "okhsl(230 8% 80%)",
+		"violet": "okhsl(295 80% 75%)",
+		"blue": "okhsl(220 85% 75%)",
+		"green": "okhsl(150 85% 72%)",
+		"red": "okhsl(20 95% 70%)",
+		"yellow": "okhsl(85 100% 75%)",
+		"blueBg": "okhsl(230 60% 20%)"
+	},
+	"colors": {
+		"accent": "violet",
+		"border": "okhsl(231 66% 71%)",
+		"borderAccent": "okhsl(295 61% 70%)",
+		"borderMuted": "okhsl(229 9% 59%)",
+		"success": "green",
+		"error": "red",
+		"warning": "yellow",
+		"muted": "muted",
+		"dim": "okhsl(229 9% 62%)",
+		"text": "text",
+		"thinkingText": "okhsl(226 8% 71%)",
+		"selectedBg": "blueBg",
+		"scrollbarTrack": "okhsl(237 8% 39%)",
+		"scrollbarThumb": "okhsl(232 8% 71%)",
+		"searchMatchBg": "okhsl(53 59% 30%)",
+		"searchMatchText": "muted",
+		"userMessageBg": "blueBg",
+		"userMessageText": "text",
+		"customMessageBg": "okhsl(295 48% 30%)",
+		"customMessageText": "muted",
+		"customMessageLabel": "violet",
+		"toolPendingBg": "okhsl(229 6% 30%)",
+		"toolSuccessBg": "okhsl(158 53% 31%)",
+		"toolErrorBg": "okhsl(19 62% 31%)",
+		"toolTitle": "text",
+		"toolOutput": "muted",
+		"mdHeading": "yellow",
+		"mdLink": "blue",
+		"mdLinkUrl": "muted",
+		"mdCode": "violet",
+		"mdCodeBlock": "green",
+		"mdCodeBlockBorder": "muted",
+		"mdQuote": "muted",
+		"mdQuoteBorder": "muted",
+		"mdHr": "muted",
+		"mdListBullet": "violet",
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "muted",
+		"syntaxComment": "muted",
+		"syntaxKeyword": "blue",
+		"syntaxFunction": "yellow",
+		"syntaxVariable": "okhsl(202 67% 73%)",
+		"syntaxString": "okhsl(52 77% 73%)",
+		"syntaxNumber": "green",
+		"syntaxType": "violet",
+		"syntaxOperator": "muted",
+		"syntaxPunctuation": "muted",
+		"thinkingOff": "okhsl(229 9% 55%)",
+		"thinkingMinimal": "okhsl(232 23% 58%)",
+		"thinkingLow": "okhsl(232 52% 60%)",
+		"thinkingMedium": "okhsl(263 68% 62%)",
+		"thinkingHigh": "okhsl(295 84% 65%)",
+		"thinkingXhigh": "okhsl(337 93% 67%)",
+		"thinkingMax": "okhsl(20 100% 69%)",
+		"bashMode": "okhsl(159 74% 71%)"
+	},
+	"export": {
+		"pageBg": "okhsl(262 16% 22%)",
+		"cardBg": "okhsl(264 15% 25%)",
+		"infoBg": "okhsl(53 59% 30%)"
+	}
+}