@piagent/platform 1.16.1 → 1.16.3

package/packages/piagent-webui/dist/client/index.html

@@ -7,7 +7,7 @@
     <meta name="csp-nonce" content="__PIAGENT_CSP_NONCE__" />
     <meta name="piagent-webui-mode" content="__PIAGENT_WEBUI_MODE__" />
     <title>Piagent WebUI</title>
-    <script type="module" crossorigin src="/assets/index-Bs8l37SR.js"></script>
+    <script type="module" crossorigin src="/assets/index-DJGByyfL.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-Z91z6SlN.css">
   </head>
   <body>

package/packages/piagent-webui/shared/company-copy.ts

@@ -0,0 +1,99 @@
+// What a company failure means for the member and what to do next, in
+// Vietnamese and English: the dashboard and the company Terminal say the same.
+// The kind comes from Studio's (or Agent Watch's) own code; the copy never
+// names the model behind a harness role.
+export type CopyLocale = "vi" | "en";
+const pick = (locale: CopyLocale, [vi, en]: [string, string]) => locale === "vi" ? vi : en;
+
+// Why the company runtime did not start (Agent Watch launch codes).
+export const LAUNCH_REASONS: Record<string, [string, string]> = {
+  "managed-config-missing": ["Chưa nhập cấu hình công ty. Mở Agent Watch → Studio → Nhập cấu hình cho Piagent (trên Windows: Kết nối Piagent trong WSL).", "Company configuration is not imported. Open Agent Watch → Studio and import it for Piagent (on Windows: Connect Piagent in WSL)."],
+  "managed-keychain-approval-required": ["macOS chưa cho Agent Watch đọc key. Chọn “Luôn cho phép” khi được hỏi rồi kết nối lại.", "macOS did not let Agent Watch read the key. Choose “Always Allow” when asked, then connect again."],
+  "managed-key-unavailable": ["Agent Watch không đọc được key công ty trên máy này. Mở Agent Watch, dán lại mã kết nối, bấm Kết nối Piagent trong WSL rồi kết nối lại.", "Agent Watch cannot read the company key on this computer. Open Agent Watch, paste the connection code again, choose Connect Piagent in WSL, then connect again."],
+  "managed-profile-disconnected": ["Cấu hình Piagent đang thuộc key công ty đã ngắt kết nối. Nhập lại cấu hình cho Piagent trong Agent Watch (trên Windows: Kết nối Piagent trong WSL).", "The Piagent configuration belongs to a disconnected company key. Import it again in Agent Watch (on Windows: Connect Piagent in WSL)."],
+  "managed-launch-binding-changed": ["Agent Watch hoặc Piagent vừa cập nhật. Nhập lại cấu hình cho Piagent trong Agent Watch (trên Windows: Kết nối Piagent trong WSL).", "Agent Watch or Piagent changed. Import the Piagent configuration again in Agent Watch (on Windows: Connect Piagent in WSL)."],
+  "managed-launch-version-mismatch": ["Agent Watch đang dùng một bản Piagent khác với dashboard này. Mở Agent Watch → Studio, bấm Áp dụng cho Piagent rồi kết nối lại.", "Agent Watch points at another Piagent install than this dashboard. Open Agent Watch → Studio, apply for Piagent, then connect again."],
+  "managed-launch-stale-runtime": ["Phiên công ty của bản Piagent cũ chưa dừng được. Thử kết nối lại sau ít giây.", "The company runtime from the previous Piagent did not stop yet. Connect again in a few seconds."],
+  "managed-launch-timeout": ["Phiên công ty khởi động quá lâu. Kết nối lại.", "The company runtime took too long to start. Connect again."]
+};
+
+export type Copy = { title: [string, string]; text: [string, string] };
+export const COPY: Record<string, Copy> = {
+  "company-quota": { title: ["Hết hạn mức token", "Token quota used up"],
+    text: ["Hạn mức token của key này đã hết. Chờ kỳ hạn mức mới hoặc liên hệ quản trị viên để tăng hạn mức.",
+      "This key's token quota is used up. Wait for the next quota period or ask an administrator to raise it."] },
+  "company-provider-limit": { title: ["Tài khoản model của công ty hết lượt", "Company model account limited"],
+    text: ["Nhà cung cấp đang giới hạn tài khoản model của công ty (hết lượt dùng hoặc quá tải). Thử lại sau; quản trị viên có thể đổi model trong Harness.",
+      "The provider is limiting the company's model account (out of usage or overloaded). Try again later; an administrator can switch the harness model."] },
+  "company-account": { title: ["Tài khoản model cần đăng nhập lại", "Model account must sign in again"],
+    text: ["Tài khoản model của công ty đã hết phiên đăng nhập. Quản trị viên cần đăng nhập lại trong Studio (Tài khoản AI).",
+      "The company's model account is signed out. An administrator has to sign it in again in Studio (AI accounts)."] },
+  "company-busy": { title: ["Đang quá tải", "Busy"],
+    text: ["Studio đang xử lý quá nhiều request của key này, hoặc tài khoản model đang bận. Chờ vài giây rồi gửi lại.",
+      "Studio is handling too many requests for this key, or the model account is busy. Wait a few seconds and send again."] },
+  "company-trial-limit": { title: ["Studio hết lượt thử nghiệm", "Studio live-test limit reached"],
+    text: ["Studio đã dùng hết số request thử nghiệm được cấp. Quản trị viên cần nâng trần trước khi chạy tiếp.",
+      "Studio has used up its live-test request ceiling. An administrator has to raise it before anything runs."] },
+  "company-key": { title: ["Key công ty không dùng được", "Company key unusable"],
+    text: ["Key công ty đã hết hạn, bị thu hồi, hoặc Agent Watch không đọc được. Nhập lại key trong Agent Watch.",
+      "The company key expired, was revoked, or Agent Watch cannot read it. Import the key again in Agent Watch."] },
+  "company-policy": { title: ["Không được phép", "Not allowed"],
+    text: ["Key này không được dùng model, mức suy luận hoặc độ dài trả lời đang chọn. Nếu Harness vừa đổi, gửi lại để dùng cấu hình mới; nếu vẫn lỗi, kiểm tra Harness trong Studio.",
+      "This key may not use this model, thinking level or answer length. If the harness just changed, send again to use the new one; otherwise check the harness in Studio."] },
+  "company-new-session": { title: ["Cần cuộc trò chuyện mới", "New conversation needed"],
+    text: ["Cuộc trò chuyện này không tiếp tục được với tài khoản model hiện tại. Nội dung cũ vẫn đọc được; tạo cuộc trò chuyện mới để làm tiếp.",
+      "This conversation cannot continue with the current model account. It stays readable; start a new conversation to go on."] },
+  "company-rejected": { title: ["Yêu cầu bị từ chối", "Request rejected"],
+    text: ["Model từ chối yêu cầu này, thường vì cuộc trò chuyện đã dài hơn model hiện tại nhận được. Bấm Tiếp tục: phần cũ được tóm tắt rồi mới gửi. Nếu vẫn bị từ chối, rút gọn tin nhắn hoặc tạo cuộc trò chuyện mới.",
+      "The model rejected this request, usually because the conversation grew longer than the current model accepts. Press Continue: the older part is summarised before sending. If it is still rejected, shorten the message or start a new conversation."] },
+  "company-refused": { title: ["Model từ chối yêu cầu này", "The model declined this request"],
+    text: ["Nhà cung cấp model từ chối yêu cầu này theo chính sách sử dụng của họ (ví dụ: in, mã hoá hoặc gửi ra ngoài thông tin bí mật). Gửi lại nguyên văn sẽ bị từ chối tiếp; hãy viết lại yêu cầu theo cách khác.",
+      "The model's provider declined this request under its usage policy (for example, printing, encoding or sending out secrets). The same request is declined again; ask in a different way."] },
+  "company-unreachable": { title: ["Lỗi kết nối", "Connection error"],
+    text: ["Không kết nối được tới Studio. Kiểm tra mạng hoặc VPN rồi gửi lại.", "Studio could not be reached. Check the network or VPN and send again."] },
+  "company-service": { title: ["Dịch vụ model lỗi", "Model service error"],
+    text: ["Studio đã nhận yêu cầu nhưng dịch vụ model phía sau không trả lời. Gửi lại; nếu lặp lại, báo quản trị viên kèm mã bên dưới.",
+      "Studio took the request but its model service did not answer. Send again; if it repeats, give an administrator the code below."] },
+  "company-config-changed": { title: ["Cấu hình vừa thay đổi", "Configuration changed"],
+    text: ["Key hoặc Harness vừa thay đổi trong Studio. Gửi lại để chạy với cấu hình mới.", "The key or harness just changed in Studio. Send again to run with the new one."] },
+  "company-update": { title: ["Cần cập nhật Piagent", "Piagent update needed"],
+    text: ["Harness dùng model mà bản Piagent này chưa biết. Cập nhật Piagent rồi gửi lại.", "The harness uses a model this Piagent does not know. Update Piagent and send again."] },
+  "company-tool": { title: ["Công cụ lỗi", "Tool error"],
+    text: ["Công cụ này không chạy được ở bước này (ví dụ subagent đã chạy đủ 8 lần cho tin nhắn này).", "This tool could not run at this step (for example, the subagent already ran 8 times for this message)."] },
+  "company-failed": { title: ["Lỗi chưa phân loại", "Unclassified error"],
+    text: ["Yêu cầu không hoàn tất. Gửi lại; nếu lặp lại, báo quản trị viên kèm mã bên dưới.",
+      "The request did not complete. Send again; if it repeats, give an administrator the code below."] },
+};
+export const OTHER_KEY: [string, string] = ["Cuộc trò chuyện này thuộc thành viên hoặc Studio khác với key đang nhập trong Agent Watch. Nội dung cũ vẫn đọc được; tạo cuộc trò chuyện mới để làm tiếp.",
+  "This conversation belongs to another member or Studio than the key Agent Watch holds. It stays readable; start a new conversation to go on."];
+
+// Codes that say more than their kind: no account serves a role's model, or
+// the run started without one (the subagent then cannot run at all).
+export const CODE_COPY: Record<string, Copy> = {
+  "harness_route_unavailable": { title: ["Không có tài khoản AI cho vai trò này", "No AI account for this role"],
+    text: ["Không tài khoản AI nào của công ty đang phục vụ model của vai trò này cho team (tài khoản bị ngắt, tắt cho team hoặc hết lượt). Quản trị viên cần gắn hoặc bật tài khoản trong Studio (Tài khoản AI), hoặc đổi model của vai trò trong Harness.",
+      "No company AI account serves this role's model for the team right now (disconnected, off for the team or out of usage). An administrator has to link or enable one in Studio (AI accounts), or change the role's model in the harness."] },
+  "harness_profile_unavailable": { title: ["Harness không có model cho vai trò này", "Harness has no model for this role"],
+    text: ["Lượt này bắt đầu khi Harness của team không có model dùng được cho vai trò này. Quản trị viên kiểm tra Harness và tài khoản AI của team trong Studio, rồi gửi lại.",
+      "This run started while the team's harness had no usable model for this role. An administrator checks the team's harness and AI accounts in Studio; then send again."] },
+};
+
+export function launchReasonText(code: string, locale: CopyLocale): string | null {
+  const reason = LAUNCH_REASONS[code];
+  return reason ? pick(locale, reason) : null;
+}
+
+export function companyFailureText(reason: string, code: string | null, locale: CopyLocale): { title: string; text: string } | null {
+  const copy = (code ? CODE_COPY[code] : undefined) ?? COPY[reason] ?? (reason.startsWith("company-") ? COPY["company-failed"] : undefined);
+  if (!copy) return null;
+  return { title: pick(locale, copy.title), text: pick(locale, code === "managed-session-scope-changed" ? OTHER_KEY : copy.text) };
+}
+
+// Who failed: a harness role, never a model name.
+export type FailureRole = "main" | "scout" | "research" | "verify" | "review";
+export function failureRoleText(role: FailureRole, locale: CopyLocale): string {
+  return role === "main" ? "Main agent" : role === "scout" ? pick(locale, ["Subagent scout", "Scout subagent"])
+    : role === "research" ? pick(locale, ["Subagent research", "Research subagent"])
+    : role === "verify" ? pick(locale, ["Subagent verify", "Verify subagent"])
+    : pick(locale, ["Subagent review", "Review subagent"]);
+}

package/packages/piagent-webui/shared/process-copy.ts

@@ -0,0 +1,64 @@
+// What a Harness step says, in Vietnamese and English: the dashboard's turn
+// notes and the company Terminal read the same words.
+import { failureRoleText, type CopyLocale, type FailureRole } from "./company-copy.ts";
+
+export type ProcessCopyInput = {
+  phase?: string; outcome?: string; loop?: number; maxLoops?: number; verified?: boolean; reviewed?: boolean; blockingOpen?: number;
+  planOpen?: number; planSkipped?: boolean; verifyPolicy?: string; reviewPolicy?: string; reviewUnavailable?: string; role?: FailureRole;
+  disputes?: number; unchanged?: boolean;
+  findings?: Array<{ severity: string; file?: string; line?: number | null; issue: string }>;
+  claims?: Array<{ claim: string }>; issues?: Array<{ kind: string; detail: string }>;
+};
+const pick = (locale: CopyLocale, vi: string, en: string) => locale === "vi" ? vi : en;
+const SEVERITY: Record<string, [string, string]> = { blocking: ["blocking", "blocking"], major: ["major", "major"], minor: ["minor", "minor"] };
+const KIND: Record<string, [string, string]> = { wrong_premise: ["sai giả định", "wrong premise"], conflicts_with_request: ["conflict với yêu cầu", "conflicts with the request"],
+  ambiguous: ["chưa rõ ràng", "ambiguous"], out_of_scope: ["out of scope", "out of scope"] };
+const UNAVAILABLE: Record<string, [string, string]> = { too_large: ["patch quá lớn", "the patch is too large"], not_git: ["thư mục không phải git", "not a git repository"],
+  limit: ["subagent đã hết lượt gọi", "the subagent ran out of calls"], failed: ["subagent lỗi", "the subagent failed"] };
+
+// How a code-changing turn ended against the Harness workflow, in a few words.
+export function outcomeText(process: ProcessCopyInput, locale: CopyLocale): string {
+  const parts: string[] = [];
+  if (process.outcome === "interrupted") return pick(locale, "Lượt bị dừng trước khi check xong", "The turn stopped before its checks finished");
+  // A disagreement between the main agent and a subagent is the member's to settle.
+  if (process.outcome === "disputed") parts.push((process.disputes ?? 1) > 1 ? pick(locale, `${process.disputes} conflict giữa main agent và subagent, bạn quyết định`, `${process.disputes} disagreements between the main agent and a subagent; your call`)
+    : pick(locale, "Main agent và subagent conflict, bạn quyết định", "The main agent and a subagent disagree; your call"));
+  if (process.unchanged) return parts.join(" · ") || pick(locale, "Không đổi code", "No code changed");
+  if (process.verified) parts.push(pick(locale, "Check đã pass trên code cuối", "A check passed on the final code"));
+  else if (process.verifyPolicy !== "off") parts.push(pick(locale, "Chưa có check pass trên code cuối", "No check passed on the final code"));
+  if (process.reviewed) parts.push(process.blockingOpen ? pick(locale, `Còn ${process.blockingOpen} lỗi blocking chưa fix`, `${process.blockingOpen} blocking issue(s) still open`)
+    : pick(locale, "Review không có lỗi blocking", "Review found no blocking issue"));
+  else if (process.reviewPolicy !== "off") parts.push(process.outcome === "review_unavailable" ? pick(locale, "Không chạy được review", "The review could not run")
+    + (process.reviewUnavailable && UNAVAILABLE[process.reviewUnavailable] ? ` (${pick(locale, ...UNAVAILABLE[process.reviewUnavailable])})` : "")
+    : pick(locale, "Chưa review", "Not reviewed"));
+  if (process.planSkipped) parts.push(pick(locale, "Đã sửa code khi chưa có plan", "Code was changed before a plan existed"));
+  if (process.planOpen) parts.push(pick(locale, `Plan còn ${process.planOpen} bước chưa xong`, `${process.planOpen} plan step(s) not completed`));
+  return parts.join(" · ") || pick(locale, "Đã đổi code", "Code changed");
+}
+
+// What a harness step (other than the final one) says, in one line.
+export function headlineText(process: ProcessCopyInput, locale: CopyLocale): string {
+  const round = process.loop && process.maxLoops ? pick(locale, ` (vòng ${process.loop}/${process.maxLoops})`, ` (round ${process.loop}/${process.maxLoops})`) : "";
+  const who = failureRoleText(process.role ?? "review", locale), count = (process.findings ?? process.claims ?? process.issues ?? []).length;
+  switch (process.phase) {
+    case "plan": return pick(locale, `Harness: plan còn ${process.planOpen ?? 0} bước chưa đánh dấu xong, yêu cầu agent cập nhật`, `Harness: ${process.planOpen ?? 0} plan step(s) not marked completed; asked the agent to update the plan`);
+    case "verify": return pick(locale, `Harness: chưa có check nào pass trên code hiện tại, yêu cầu agent chạy check${round}`, `Harness: no check has passed on the current code; asked the agent to run checks${round}`);
+    case "review": return pick(locale, `Harness: review tìm thấy ${count} lỗi blocking, gửi lại agent để fix hoặc giải thích${round}`, `Harness: the review found ${count} blocking issue(s); sent back to the agent to fix or answer${round}`);
+    case "objection": return pick(locale, `${who} phản biện brief của main agent`, `${who} objected to the main agent's brief`);
+    case "answer": return pick(locale, "Harness: yêu cầu main agent nói rõ đã quyết định gì với phản biện của subagent", "Harness: asked the main agent to say what it decided about the subagent's objection");
+    case "claims": return pick(locale, `Harness: ${who} đánh fail ${count} claim, gửi lại main agent`, `Harness: ${who} marked ${count} claim(s) as failed; sent back to the main agent`);
+    case "rejudge": return process.role === "verify" ? pick(locale, `Harness: ${who} check lại các claim cùng câu trả lời của main agent`, `Harness: ${who} checks the claims again with the main agent's answer`)
+      : pick(locale, `Harness: main agent giải thích thay vì fix, ${who} xem xét lại lời giải thích`, `Harness: the main agent answered instead of fixing; ${who} judges the answer`);
+    case "dispute": return pick(locale, `Main agent và ${who} vẫn conflict sau 2 lượt, bạn quyết định`, `The main agent and the ${who} still disagree after two rounds; your call`);
+    default: return "";
+  }
+}
+
+// The items a step carries: review findings, failed claims, objections to a brief.
+export type ProcessItem = { tag: string; tone: "error" | "warning"; location: string | null; text: string };
+export function processItems(process: ProcessCopyInput, locale: CopyLocale): ProcessItem[] {
+  return (process.findings ?? []).map((f): ProcessItem => ({ tag: pick(locale, ...(SEVERITY[f.severity] ?? [f.severity, f.severity])),
+    tone: f.severity === "blocking" ? "error" : "warning", location: f.file ? `${f.file}${f.line ? `:${f.line}` : ""}` : null, text: f.issue }))
+    .concat((process.claims ?? []).map((c): ProcessItem => ({ tag: "fail", tone: "error", location: null, text: c.claim })))
+    .concat((process.issues ?? []).map((i): ProcessItem => ({ tag: pick(locale, ...(KIND[i.kind] ?? [i.kind, i.kind])), tone: "warning", location: null, text: i.detail })));
+}

package/scripts/company-terminal.mjs

@@ -0,0 +1,104 @@
+// The company Terminal (`piagent studio`) says what the dashboard says: a new
+// release is asked about, Bypass can be chosen, the Harness's notes and a
+// failed request read in the member's words. Loaded only in the Terminal; the
+// company Gateway draws its own pages.
+import fs from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+import { registerTerminalUpdateOffer } from '../packages/piagent-core/runtime/update/terminal-update-offer.mjs';
+import { parseFailure } from '../packages/piagent-core/runtime/managed-failure.mjs';
+import { companyFailureText } from '../packages/piagent-webui/shared/company-copy.ts';
+import { headlineText, outcomeText, processItems } from '../packages/piagent-webui/shared/process-copy.ts';
+
+const LOCALE = 'vi';
+const PERMISSION_STATUS = 'agent-watch-permission';
+const ASK = 'Hỏi trước (mặc định)', BYPASS = 'Bypass: chỉ hỏi việc bắt buộc';
+const PERMISSION_TEXT = {
+  'workspace-write': 'Hỏi trước: mọi lệnh cần internet đều hỏi bạn.',
+  'trusted-full-access': 'Bypass: lệnh cần internet chạy luôn; vẫn hỏi trước khi đẩy hoặc gửi dữ liệu ra ngoài, chạy migration, xoá không rõ đích hoặc dùng sudo.',
+};
+
+// A harness note's details, in the shape the shared copy reads.
+export function processInput(details) {
+  if (!details || typeof details !== 'object' || typeof details.phase !== 'string') return null;
+  const { policy, ...rest } = details;
+  return { ...rest, verifyPolicy: policy?.verify, reviewPolicy: policy?.review };
+}
+
+// The lines a harness note shows: what happened, then its findings or objections.
+export function processLines(details) {
+  const input = processInput(details);
+  if (!input) return null;
+  const head = input.phase === 'final' ? outcomeText(input, LOCALE) : headlineText(input, LOCALE);
+  if (!head) return null;
+  const items = processItems(input, LOCALE).map((item, i) => `  ${i + 1}. [${item.tag}]${item.location ? ` ${item.location} —` : ''} ${item.text}`);
+  return [input.phase === 'final' ? `Tiến trình: ${head}` : head, ...items];
+}
+
+// A failed company request, as the dashboard explains it (null when it is not one).
+export function failureLines(errorMessage) {
+  const failure = parseFailure(errorMessage);
+  if (!failure) return null;
+  const copy = companyFailureText(`company-${failure.kind}`, failure.code, LOCALE);
+  return copy ? `${copy.title}: ${copy.text} [${failure.code}]` : null;
+}
+
+export function companyTerminalExtension({ managed, packageRoot, sdkRoot, bindingChanged = () => false }) {
+  const require = createRequire(path.join(sdkRoot, 'package.json'));
+  let tui;
+  const components = async () => (tui ??= await import(pathToFileURL(require.resolve('@earendil-works/pi-tui')).href));
+  const installed = (() => { try { return JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8')).version; } catch { return undefined; } })();
+
+  return async (pi) => {
+    const { Box, Text } = await components();
+    const box = (text, theme, color) => {
+      const view = new Box(1, 0, (t) => theme.bg('customMessageBg', t));
+      view.addChild(new Text(color ? theme.fg(color, text) : text, 0, 0));
+      return view;
+    };
+
+    registerTerminalUpdateOffer(pi, { installed, packageRoot, restart: 'piagent studio',
+      afterUpdate: () => bindingChanged() ? 'Bản mới đổi trình khởi chạy công ty: mở Agent Watch → Studio và nhập lại cấu hình cho Piagent trước khi mở lại.' : null });
+
+    // Ask first or Bypass, kept with the conversation like the dashboard's switch.
+    const showPermission = (ctx) => ctx.ui?.setStatus?.(PERMISSION_STATUS, managed()?.permission === 'trusted-full-access' ? 'Bypass' : undefined);
+    pi.on('session_start', async (_event, ctx) => showPermission(ctx));
+    pi.registerCommand('bypass', {
+      description: 'Bật/tắt Bypass cho cuộc trò chuyện công ty này (on, off, hoặc để trống để chọn)',
+      getArgumentCompletions: (prefix) => ['on', 'off', 'status'].filter((v) => v.startsWith(prefix)).map((value) => ({ value, label: value })),
+      handler: async (args, ctx) => {
+        const session = managed();
+        if (typeof session?.session?.managedSetPermission !== 'function') { ctx.ui.notify('Cuộc trò chuyện này chưa sẵn sàng.', 'error'); return; }
+        const arg = args.trim().toLowerCase();
+        let mode = arg === 'on' ? 'trusted-full-access' : arg === 'off' ? 'workspace-write' : null;
+        if (!mode && arg !== 'status') {
+          const choice = await ctx.ui.select(`Quyền của cuộc trò chuyện này (đang: ${session.permission === 'trusted-full-access' ? 'Bypass' : 'Hỏi trước'})`, [ASK, BYPASS]);
+          mode = choice === BYPASS ? 'trusted-full-access' : choice === ASK ? 'workspace-write' : null;
+        }
+        if (mode && mode !== session.permission) session.session.managedSetPermission(mode);
+        showPermission(ctx);
+        ctx.ui.notify(PERMISSION_TEXT[session.permission] ?? PERMISSION_TEXT['workspace-write'], 'info');
+      } });
+
+    // The Harness's notes carry English for the agent; the member reads them in Vietnamese.
+    pi.registerMessageRenderer('agent-watch-process', (message, _options, theme) => {
+      const lines = processLines(message.details);
+      const loud = ['dispute', 'objection'].includes(message.details?.phase) || message.details?.outcome === 'disputed';
+      return lines ? box(lines.join('\n'), theme, loud ? 'warning' : message.details?.outcome === 'clean' ? 'success' : 'muted') : undefined;
+    });
+    pi.registerMessageRenderer('agent-watch-review-status', (_message, _options, theme) =>
+      box('Review đã cũ: code đổi sau khi review. Cần review lại cho thay đổi hiện tại.', theme, 'warning'));
+    pi.registerMessageRenderer('agent-watch-helper-receipt', (message, _options, theme) =>
+      box(String(message.content ?? '').replace(/(\d[\d,]*) tokens/, '$1 token').replace('review is stale', 'review đã cũ'), theme, 'dim'));
+
+    // A failed request says what it means and what to do, as on the dashboard.
+    pi.on('message_end', async (event, ctx) => {
+      const message = event?.message;
+      if (message?.role !== 'assistant' || message.stopReason !== 'error') return;
+      const text = failureLines(message.errorMessage);
+      if (text) ctx.ui?.notify?.(text, 'error');
+    });
+  };
+}

package/scripts/dashboard-update-job.mjs

@@ -72,6 +72,9 @@ fs.writeSync(log, "\nRestarting the dashboard on the new release\n");
 // install sits under node_modules, where Node does not strip types itself.
 // --import takes a URL: a Windows path (C:\...) reads as a URL scheme.
 const loader = pathToFileURL(path.join(packageRoot, "scripts", "register-typescript-loader.mjs")).href;
+// The new dashboard checks for the next release itself: only the update step
+// runs without the check.
+const restartEnv = { ...process.env }; delete restartEnv.PIAGENT_NO_UPDATE_CHECK;
 const restart = spawnSync(process.execPath, ["--disable-warning=ExperimentalWarning", "--import", loader, dashboard, "restart", "--json"],
-  { stdio: ["ignore", "ignore", log], env, timeout: 3 * 60 * 1000 });
+  { stdio: ["ignore", "ignore", log], env: restartEnv, timeout: 3 * 60 * 1000 });
 finish("succeeded", { installed, ...(bindingChanged ? { bindingChanged } : {}), ...(restart.status === 0 ? {} : { reason: "dashboard-restart-failed" }) });

package/scripts/piagent-dashboard.mjs

@@ -154,6 +154,18 @@ async function waitForGatewayStopped(previous, timeoutMs = 8_000) {
   throw new Error("gateway-restart-stop-timeout\nThe previous Gateway did not stop; restart refused to reuse the old process.");
 }
 
+// An update job of an earlier release restarted the dashboard with update
+// checks switched off (it meant them for its own install step only): a
+// dashboard it starts checks for releases again.
+function serveEnvironment(home = os.homedir()) {
+  const env = { ...process.env };
+  try {
+    const job = JSON.parse(fs.readFileSync(path.join(home, ".pi", "piagent-update-job.json"), "utf8"));
+    if (job?.state === "running" && job.pid === process.ppid) delete env.PIAGENT_NO_UPDATE_CHECK;
+  } catch { /* no update running */ }
+  return env;
+}
+
 async function ensureStarted() {
   // After an update the Gateway still running is the earlier release, with
   // its pages loaded: it is replaced rather than reused.
@@ -174,7 +186,7 @@ async function ensureStarted() {
     fileURLToPath(import.meta.url),
     "serve",
     ...(agentDir ? ["--agent-dir", agentDir] : [])
-  ], { cwd: process.cwd(), env: { ...process.env,
+  ], { cwd: process.cwd(), env: { ...serveEnvironment(),
     PIAGENT_PINNED_TS_TRANSFORM_ROOT: path.join(effectiveAgentDir, "npm", "node_modules", "pi-mcp-adapter") },
     detached: true, stdio: "ignore" });
   let exit = null;

package/scripts/piagent-studio.mjs

@@ -114,6 +114,11 @@ try {
   // company Gateway uses: the WebUI shows it running here and never runs it
   // at the same time. One the WebUI is running is refused.
   const { holdManagedSession } = await import('../packages/piagent-webui/ownership/managed-terminal-lease.ts');
+  // The Terminal's own commands and words (updates, Bypass, Harness notes): company-terminal.mjs.
+  const { companyTerminalExtension } = await import('./company-terminal.mjs');
+  const packageRoot = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
+  const terminal = companyTerminalExtension({ managed: () => current, packageRoot, sdkRoot: config.sdk_root,
+    bindingChanged: () => { try { return digest(config.entrypoint) !== config.entrypoint_sha256; } catch { return true; } } });
   const factory = async ({ cwd, sessionManager }) => {
     let next;
     try { next = holdManagedSession(agentDir, sessionManager.getSessionFile()); }
@@ -122,7 +127,7 @@ try {
     // A conversation that enrolled again (key or harness changed) holds the live broker.
     if (current) { broker = current.broker; await current.session.abort(); await Promise.allSettled([...current.helpers.values()]); await broker.request('close'); current.session.dispose(); await current.boundary.dispose(); }
     current = await ManagedSession.create({ sdkRoot: config.sdk_root, cwd, origin: config.origin, broker, agentDir, sessionManager,
-      protectedRoots: [configPath, agentDir], renewBroker: newBroker, bindingRevision });
+      protectedRoots: [configPath, agentDir], renewBroker: newBroker, bindingRevision, terminalExtensions: [terminal] });
     return { session: current.session, extensionsResult: current.extensionsResult, services: current.services, diagnostics: [] };
   };
   const host = await api.createAgentSessionRuntime(factory, { cwd, agentDir, sessionManager: api.SessionManager.create(cwd, path.join(agentDir, 'sessions')) });
@@ -136,7 +141,8 @@ try {
     const last=current.session.messages.filter(message=>message.role==='assistant').at(-1);
     if (last?.stopReason === 'error') {
       // Already says who failed and why, ending in its stable [code].
-      process.stderr.write(`${String(last.errorMessage??'Agent Watch: the request failed [managed-request-failed]')}\n`);process.exitCode = 1;
+      const { failureLines } = await import('./company-terminal.mjs');
+      process.stderr.write(`${failureLines(last.errorMessage) ?? String(last.errorMessage??'Agent Watch: the request failed [managed-request-failed]')}\n`);process.exitCode = 1;
     }
   } else {
     // The company terminal runs the pinned Pi release: no "Run pi update" notice
@@ -149,7 +155,10 @@ try {
 } catch (error) {
   // Never print JSON payloads or startup objects that can contain role tokens.
   const code = error instanceof Error && /^managed-[a-z:_-]+$/.test(error.message) ? error.message : 'managed-launch-failed';
-  const hint = code === 'managed-session-open-elsewhere' ? 'This conversation is running in the Piagent WebUI; continue it there, or start a new one here.'
-    : process.platform === 'linux' ? 'In Agent Watch for Windows, choose Connect Piagent in WSL again.' : 'Refresh the Studio import or check Keychain access.';
+  // The same words as the dashboard (shared/company-copy.ts), with the code for support.
+  let explained = null;
+  try { await import('./register-typescript-loader.mjs'); explained = (await import('../packages/piagent-webui/shared/company-copy.ts')).launchReasonText(code, 'vi'); } catch { /* the code alone */ }
+  const hint = explained ?? (code === 'managed-session-open-elsewhere' ? 'Cuộc trò chuyện này đang chạy trong Piagent WebUI; tiếp tục ở đó, hoặc mở cuộc trò chuyện mới ở đây.'
+    : process.platform === 'linux' ? 'Trong Agent Watch cho Windows, chọn lại Kết nối Piagent trong WSL.' : 'Mở Agent Watch → Studio, nhập lại cấu hình cho Piagent, hoặc kiểm tra quyền Keychain.');
   process.stderr.write(`Agent Watch: ${code}. ${hint}\n`); process.exitCode = 1;
 } finally { await gateway?.close(); if (current) await current.dispose(); else await broker?.dispose(); hold?.release(); }