@piagent/platform 1.52.0 → 1.52.2

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.52.0" title="v1.52.0 docs · VI"><span class="dot"></span>v1.52.0</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.52.2" title="v1.52.2 docs · VI"><span class="dot"></span>v1.52.2</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,28 @@
 <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-52-0" data-release>
+<article class="release latest" id="v1-52-2" data-release>
+  <div class="release-meta"><a class="release-version" href="#v1-52-2">v1.52.2</a><time class="release-date" datetime="2026-11-09">09/11/2026</time></div>
+  <div class="release-body">
+    <h3 data-toc-skip id="v1-52-2-title">Xin nhiều helper general thì chạy một, không còn bị từ chối</h3>
+    <p>Khi thành viên xin nhiều helper, agent chính gọi nhiều general cùng lúc, bị từ chối rồi gọi lại mãi nên general không chạy. Giờ một general chạy và agent chính merge ref của nó trước phần việc tiếp theo.</p>
+    <ul class="release-items">
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Lệnh gọi xin nhiều helper general chạy một, nói rõ lý do và bảo agent chính merge ref rồi gọi general tiếp.</span></li>
+    </ul>
+    <p class="release-requires"><strong>Cần:</strong> Agent Studio 0.51.0 và Agent Watch 0.15.20 (Windows 0.1.19) để dùng helper advisor và general</p>
+  </div>
+</article>
+<article class="release" id="v1-52-1" data-release>
+  <div class="release-meta"><a class="release-version" href="#v1-52-1">v1.52.1</a><time class="release-date" datetime="2026-11-09">09/11/2026</time></div>
+  <div class="release-body">
+    <h3 data-toc-skip id="v1-52-1-title">Xin nhiều helper general thì chạy một, không còn bị từ chối <span class="tag">không phát hành</span></h3>
+    <p>Đã tag nhưng chưa publish: capability lock ghi sai nguồn package nên kiểm tra release fail. Thay bằng 1.52.2.</p>
+    <ul class="release-items">
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Lệnh gọi xin nhiều helper general chạy một, nói rõ lý do và bảo agent chính merge ref rồi gọi general tiếp.</span></li>
+    </ul>
+  </div>
+</article>
+<article class="release" id="v1-52-0" data-release>
   <div class="release-meta"><a class="release-version" href="#v1-52-0">v1.52.0</a><time class="release-date" datetime="2026-11-08">08/11/2026</time></div>
   <div class="release-body">
     <h3 data-toc-skip id="v1-52-0-title">Helper công ty có thêm advisor và general làm việc trong bản clone riêng</h3>
@@ -396,38 +417,36 @@
     </ul>
   </div>
 </article>
-<article class="release" id="v1-44-2" data-release>
-  <div class="release-meta"><a class="release-version" href="#v1-44-2">v1.44.2</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-2-title">Harness công ty theo cỡ thay đổi</h3>
-    <p>Thay đổi nhỏ xong sau khi check, không cần review; thay đổi rủi ro bắt buộc check và review. Main agent được tra web nhanh vài lần bên cạnh research helper.</p>
-    <ul class="release-items">
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>workflow.main_web_lookups (0 đến 5) cho main agent tra web_search hoặc web_fetch nhanh chừng ấy lần mỗi tin nhắn, bên cạnh research helper.</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Risk lanes, bật mặc định: thay đổi tối đa 2 file, 40 dòng, không chạm file nhạy cảm xong sau khi check, không gọi reviewer. workflow.lanes: false để tắt.</span></li>
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Thay đổi rủi ro (migration, auth, CI, dependency, AGENTS.md, yêu cầu phức tạp, hơn 12 file hoặc 400 dòng) bắt buộc qua check và review kể cả khi Harness chỉ đặt suggest.</span></li>
-    </ul>
-  </div>
-</article>
-<article class="release" 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>
 </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">75</span></summary>
+    <summary><span>Tháng 10/2026</span><span class="archive-count">77</span></summary>
+    <div class="archive-row" id="v1-44-2">
+      <div class="archive-head"><a class="release-version" href="#v1-44-2">v1.44.2</a> <span class="release-date">28/10/2026</span></div>
+      <div class="archive-body">
+        <p><strong>Harness công ty theo cỡ thay đổi</strong> — Thay đổi nhỏ xong sau khi check, không cần review; thay đổi rủi ro bắt buộc check và review. Main agent được tra web nhanh vài lần bên cạnh research helper.</p>
+        <ul class="release-items">
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>workflow.main_web_lookups (0 đến 5) cho main agent tra web_search hoặc web_fetch nhanh chừng ấy lần mỗi tin nhắn, bên cạnh research helper.</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Risk lanes, bật mặc định: thay đổi tối đa 2 file, 40 dòng, không chạm file nhạy cảm xong sau khi check, không gọi reviewer. workflow.lanes: false để tắt.</span></li>
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Thay đổi rủi ro (migration, auth, CI, dependency, AGENTS.md, yêu cầu phức tạp, hơn 12 file hoặc 400 dòng) bắt buộc qua check và review kể cả khi Harness chỉ đặt suggest.</span></li>
+        </ul>
+      </div>
+    </div>
+    <div class="archive-row" id="v1-44-1">
+      <div class="archive-head"><a class="release-version" href="#v1-44-1">v1.44.1</a> <span class="release-date">28/10/2026</span></div>
+      <div class="archive-body">
+        <p><strong>Giữ Pi của bạn, chọn giao diện Terminal, thêm repo skill</strong> — 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>
+    </div>
     <div class="archive-row" id="v1-44-0">
       <div class="archive-head"><a class="release-version" href="#v1-44-0">v1.44.0</a> <span class="release-date">28/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.52.0" title="v1.52.0 docs · VI"><span class="dot"></span>v1.52.0</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.52.2" title="v1.52.2 docs · VI"><span class="dot"></span>v1.52.2</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.52.0" title="v1.52.0 docs · VI"><span class="dot"></span>v1.52.0</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.52.2" title="v1.52.2 docs · VI"><span class="dot"></span>v1.52.2</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

@@ -257,7 +257,7 @@
     {
       "path": "tests",
       "fileCount": 653,
-      "sha256": "577758e269e6cb8d79d32cec4c354be0ea343404c897c24280dc50f86002ea21"
+      "sha256": "fe018c94cf247031a7aa476925be84127455c3fe6dc93486d6c7e809a81df247"
     }
   ],
   "custodianComparisonRules": {

package/package.json

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

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

@@ -28,6 +28,9 @@ export function fanOut(manager, role, args, harness) {
   const split = Array.isArray(args?.split) ? args.split.map(s => typeof s === 'string' ? s.trim().slice(0, 500) : '').filter(Boolean) : [];
   const n = split.length || (Number.isInteger(args?.copies) ? args.copies : 1);
   if (n <= 1) return null;
+  // general works in one clone at a time: run one and say so, never refuse (a
+  // refusal sent agents round 15 retries in a few minutes, 2026-11-09).
+  if (role === 'general') return { dropped: n, single: true };
   if (harness) throw Error('managed-copies-invalid: the harness runs one helper per call.');
   const words = normal(args?.member_words);
   if (words.length < 3 || !memberRequest(memberMessages(manager)).some(text => normal(text).includes(words)) || namedCount(words) < n || !HELPER_WORDS.test(words)) return { dropped: n };
@@ -39,7 +42,9 @@ export function fanOut(manager, role, args, harness) {
 export function withDroppedNote(result, role, asked) {
   const n = asked?.dropped, first = result?.content?.[0];
   if (!n || first?.type !== 'text') return result;
-  const note = `One ${callName(role)} helper ran, not ${n}: the member's own words did not ask for ${n} ${callName(role)} helpers. Go on with this answer; run several only when the member asks for that many.\n\n`;
+  const note = asked.single
+    ? `One general helper ran, not ${n}: general works one at a time, each in its own clone. Merge the ref it returned, then call general again (without copies or split) for the next share of the work.\n\n`
+    : `One ${callName(role)} helper ran, not ${n}: the member's own words did not ask for ${n} ${callName(role)} helpers. Go on with this answer; run several only when the member asks for that many.\n\n`;
   return { ...result, content: [{ ...first, text: note + first.text }, ...result.content.slice(1)] };
 }
 // What one copy reads under its brief.

package/packages/piagent-core/managed/helper-settlement.mjs

@@ -26,7 +26,7 @@ export function delegateParameters() {
     ...Object.fromEntries(Object.entries(SPEC_FIELDS).map(([name, description]) => [name, field(description)])),
     since: { type: 'string', maxLength: 200, description: 'Review only: the commit, branch or HEAD~N the work to review started from (work committed in earlier turns).' },
     // Several helpers of the role, only at the member's request (copies.mjs).
-    copies: { type: 'integer', minimum: 2, maximum: 3, description: 'Only when the member asked for several helpers of this role: how many (2 or 3) run side by side on this brief. Never on your own.' },
+    copies: { type: 'integer', minimum: 2, maximum: 3, description: 'Only when the member asked for several helpers of this role: how many (2 or 3) run side by side on this brief. Never on your own, and never for general (one at a time).' },
     split: { type: 'array', minItems: 2, maxItems: 3, items: { type: 'string', minLength: 1, maxLength: 500 }, description: 'Instead of copies: one line per helper naming its share of the work, when the member asked for several and the work divides.' },
     member_words: { type: 'string', maxLength: 300, description: 'With copies or split: the member\'s own words, verbatim, that ask for that many helpers.' } },
   required: ['role', 'task'], additionalProperties: false };

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

@@ -465,7 +465,6 @@ export class ManagedSession {
     if (!this.grant || !HELPER_ROLES.includes(role) || typeof task !== 'string' || !task.trim() || task.length > 12000 || this.helpers.has(role)) throw Error('managed-helper-unavailable');
     const enabled = helperRoles(this.manifest);
     if (!enabled.includes(role)) throw Error(`managed-helper-not-configured: the company Harness has no ${name} subagent${enabled.length ? `; use ${enabled.map(callName).join(', ')}` : ''}.`);
-    if (role === 'general' && (more.copies || more.split)) throw Error('managed-general-single: the general helper runs one at a time, each in its own clone; call it again for the next piece of work after merging the first.');
     if (role === 'general') this.orphans = sweepGeneral(this);
     // Studio lets each helper role run HELPER_CALLS times per run (one user
     // message), each helper the member asked for counted (copies.mjs). Say so at once.

package/packages/piagent-core/package.json

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