@piagent/platform 1.17.0 → 1.19.0

package/packages/piagent-webui/shared/turn-end.ts

@@ -0,0 +1,68 @@
+// How a member's message ended in a company conversation ("agent-watch-turn-end"),
+// read the same way by the transcript, the session list and the company
+// Terminal: every checklist step done, stopped with steps open, failed (which
+// harness role), or stopped by the member.
+import { failureRoleText, type CopyLocale, type FailureRole } from "./company-copy.ts";
+
+export type TurnEndState = "done" | "midway" | "failed" | "cancelled";
+export type TurnEnd = { state: TurnEndState; planSteps: number; planDone: number; planDeferred?: number; rounds: number;
+  reason?: "idle" | "limit" | "policy"; role?: FailureRole; code?: string };
+const ROLES: FailureRole[] = ["main", "scout", "research", "verify", "review"];
+// The harness gives up after this many rounds in a row without progress, and
+// runs at most this many (packages/piagent-core/managed/continuation.mjs).
+export const IDLE_ROUNDS = 2, MAX_ROUNDS = 30;
+
+// The recorded details, checked; null when they do not have the expected shape.
+export function turnEndOf(details: any): TurnEnd | null {
+  const count = (n: unknown): n is number => Number.isInteger(n) && (n as number) >= 0 && (n as number) <= 30;
+  if (!["done", "midway", "failed", "cancelled"].includes(details?.state) || !count(details.planSteps) || !count(details.planDone)
+    || !count(details.rounds) || (details.planDeferred !== undefined && !count(details.planDeferred))
+    || details.planDone + (details.planDeferred ?? 0) > details.planSteps) return null;
+  const out: TurnEnd = { state: details.state, planSteps: details.planSteps, planDone: details.planDone, rounds: details.rounds };
+  if (details.planDeferred) out.planDeferred = details.planDeferred;
+  if (details.state === "midway" && ["idle", "limit", "policy"].includes(details.reason)) out.reason = details.reason;
+  if (details.state === "failed") {
+    out.role = ROLES.includes(details.role) ? details.role : "main";
+    if (typeof details.code === "string" && /^[a-z0-9_]{1,64}$/.test(details.code)) out.code = details.code;
+  }
+  return out;
+}
+
+const pick = (locale: CopyLocale, vi: string, en: string) => locale === "vi" ? vi : en;
+export type TurnEndCopy = { tone: "success" | "warning" | "error" | "info"; title: string; text: string; continuable: boolean };
+
+// What the member reads under the last answer: is the task finished, and if
+// not, why the agent stopped and what to do.
+export function turnEndCopy(end: TurnEnd, locale: CopyLocale): TurnEndCopy {
+  const later = end.planDeferred ?? 0, open = end.planSteps - end.planDone - later;
+  const rounds = end.rounds ? pick(locale, ` Harness đã cho agent làm tiếp ${end.rounds} vòng.`, ` The harness sent the agent back ${end.rounds} time(s).`) : "";
+  if (end.state === "cancelled") return { tone: "info", continuable: true, title: pick(locale, "Bạn đã dừng lượt này", "You stopped this turn"),
+    text: pick(locale, `Task chưa xong${end.planSteps ? ` (${end.planDone}/${end.planSteps} bước)` : ""}. Bấm Tiếp tục để agent làm tiếp từ chỗ dừng.`,
+      `The task is not finished${end.planSteps ? ` (${end.planDone}/${end.planSteps} steps)` : ""}. Choose Continue to pick up where it stopped.`) };
+  if (end.state === "failed") return { tone: "error", continuable: true,
+    title: pick(locale, `Lượt dừng vì lỗi · ${failureRoleText(end.role ?? "main", locale)}`, `Turn stopped by a failure · ${failureRoleText(end.role ?? "main", locale)}`),
+    text: pick(locale, `Task chưa xong${end.planSteps ? `: còn ${open}/${end.planSteps} bước` : ""}. Xem lỗi phía trên; khi đã xử lý, bấm Tiếp tục để chạy lại từ chỗ dừng.`,
+      `The task is not finished${end.planSteps ? `: ${open} of ${end.planSteps} steps open` : ""}. See the failure above; once it is resolved, choose Continue.`) + (end.code ? ` [${end.code}]` : "") };
+  if (end.state === "midway") {
+    const why = end.reason === "idle" ? pick(locale, `Main agent dừng ${IDLE_ROUNDS} vòng liên tiếp mà không xong thêm bước nào: đọc câu trả lời cuối để biết vướng gì.`,
+      `The main agent stopped ${IDLE_ROUNDS} rounds in a row without finishing a step: its last answer says what is in the way.`)
+      : end.reason === "limit" ? pick(locale, `Đã tới giới hạn ${MAX_ROUNDS} vòng tự làm tiếp cho một tin nhắn.`, `The limit of ${MAX_ROUNDS} automatic rounds for one message was reached.`)
+      : pick(locale, "Harness của team không bắt buộc plan nên không tự làm tiếp.", "The team's Harness does not require a plan, so it does not continue on its own.");
+    return { tone: "warning", continuable: true, title: pick(locale, `Dừng giữa chừng · còn ${open}/${end.planSteps} bước`, `Stopped midway · ${open} of ${end.planSteps} steps open`),
+      text: `${why}${rounds} ${pick(locale, "Bấm Tiếp tục để làm tiếp.", "Choose Continue to go on.")}` };
+  }
+  // Steps left for later at the member's word (or no longer needed): done as asked, not all done.
+  if (later) return { tone: "info", continuable: true, title: pick(locale, `Dừng theo yêu cầu · ${end.planDone}/${end.planSteps} bước xong, ${later} bước để sau`, `Stopped as asked · ${end.planDone} of ${end.planSteps} steps done, ${later} left for later`),
+    text: pick(locale, "Các bước còn lại được để sau theo yêu cầu hoặc vì không cần nữa: câu trả lời cuối nói lý do. Bấm Tiếp tục khi muốn làm nốt.", "The other steps were left for later as asked, or are no longer needed: the last answer says why. Choose Continue to do them.") + rounds };
+  return { tone: "success", continuable: false, title: end.planSteps ? pick(locale, `Hoàn thành · ${end.planSteps}/${end.planSteps} bước`, `Done · ${end.planSteps}/${end.planSteps} steps`) : pick(locale, "Xong lượt", "Turn finished"),
+    text: (end.planSteps ? pick(locale, "Mọi bước trong checklist đã xong.", "Every checklist step is completed.") : pick(locale, "Main agent đã trả lời xong; lượt này không có checklist.", "The main agent finished its answer; this turn had no checklist.")) + rounds };
+}
+
+// The short label of the session list.
+export function turnEndShort(end: Pick<TurnEnd, "state" | "planSteps" | "planDone" | "planDeferred">, locale: CopyLocale): string {
+  if (end.state === "done" && end.planDeferred) return pick(locale, `Xong ${end.planDone}/${end.planSteps}, để sau ${end.planDeferred}`, `Done ${end.planDone}/${end.planSteps}, ${end.planDeferred} later`);
+  if (end.state === "midway") return pick(locale, `Dừng giữa chừng ${end.planDone}/${end.planSteps}`, `Stopped ${end.planDone}/${end.planSteps}`);
+  if (end.state === "failed") return pick(locale, "Lỗi, chưa xong", "Failed");
+  if (end.state === "cancelled") return pick(locale, "Đã dừng", "Stopped");
+  return end.planSteps ? pick(locale, `Xong ${end.planSteps}/${end.planSteps}`, `Done ${end.planSteps}/${end.planSteps}`) : pick(locale, "Xong", "Done");
+}

package/schemas/piagent-webui/session-catalog-v1.schema.json

@@ -95,13 +95,23 @@
         "managedThinkingLevels": {"type": "array", "uniqueItems": true, "maxItems": 7, "items": {"enum": ["off","minimal","low","medium","high","xhigh","max"]}}, "managedPermission": {"enum": ["workspace-write","trusted-full-access"]},
         "managedPlan": { "type": "object", "additionalProperties": false, "required": ["steps"], "properties": {
           "steps": { "type": "array", "minItems": 1, "maxItems": 30, "items": { "type": "object", "additionalProperties": false, "required": ["step", "status"], "properties": {
-            "step": { "type": "string", "minLength": 1, "maxLength": 200 }, "status": { "enum": ["pending", "in_progress", "completed"] } } } } } },
+            "step": { "type": "string", "minLength": 1, "maxLength": 200 }, "status": { "enum": ["pending", "in_progress", "completed", "deferred"] } } } } } },
         "managedProcess": { "type": "object", "additionalProperties": false, "required": ["outcome", "verified", "reviewed", "blockingOpen"], "properties": {
           "outcome": { "enum": ["no_change", "interrupted", "disputed", "blocking_open", "unverified", "review_unavailable", "unreviewed", "clean"] },
           "verified": { "type": "boolean" }, "reviewed": { "type": "boolean" }, "blockingOpen": { "type": "integer", "minimum": 0, "maximum": 1000 }, "planSkipped": { "const": true } } },
+        "managedTurnEnd": { "type": "object", "additionalProperties": false, "required": ["state", "planSteps", "planDone"], "properties": {
+          "state": { "enum": ["done", "midway", "failed", "cancelled"] },
+          "planSteps": { "type": "integer", "minimum": 0, "maximum": 30 }, "planDone": { "type": "integer", "minimum": 0, "maximum": 30 },
+          "planDeferred": { "type": "integer", "minimum": 1, "maximum": 30 },
+          "reason": { "enum": ["idle", "limit", "policy"] } } },
         "gitBranch": { "type": "object", "additionalProperties": false, "required": ["name", "detached"], "properties": {
           "name": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[^\\u0000-\\u001F\\u007F]*$" },
           "detached": { "type": "boolean" } } },
+        "gitRepositories": { "type": "array", "maxItems": 30, "items": { "type": "object", "additionalProperties": false, "required": ["name", "branch"], "properties": {
+          "name": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[^\\u0000-\\u001F\\u007F/\\\\]*$" },
+          "branch": { "anyOf": [{ "type": "null" }, { "type": "object", "additionalProperties": false, "required": ["name", "detached"], "properties": {
+            "name": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[^\\u0000-\\u001F\\u007F]*$" },
+            "detached": { "type": "boolean" } } }] } } } },
         "modelLabel": { "$ref": "common-v1.schema.json#/$defs/nullableDisplayText" },
         "thinkingLevel": { "enum": ["off", "minimal", "low", "medium", "high", "xhigh", "max", "unknown"] },
         "contextUsage": { "$ref": "#/$defs/contextUsage" },

package/schemas/piagent-webui/transcript-v1.schema.json

@@ -157,7 +157,7 @@
       "additionalProperties": false,
       "required": ["phase"],
       "properties": {
-        "phase": { "enum": ["plan", "verify", "review", "final", "objection", "answer", "claims", "rejudge", "dispute"] },
+        "phase": { "enum": ["plan", "verify", "review", "final", "objection", "answer", "claims", "rejudge", "dispute", "continue"] },
         "outcome": { "enum": ["no_change", "interrupted", "disputed", "blocking_open", "unverified", "review_unavailable", "unreviewed", "clean"] },
         "role": { "enum": ["scout", "research", "verify", "review"] },
         "by": { "enum": ["main", "harness"] },
@@ -192,6 +192,11 @@
         "reviewed": { "type": "boolean" },
         "blockingOpen": { "type": "integer", "minimum": 0, "maximum": 1000 },
         "planOpen": { "type": "integer", "minimum": 1, "maximum": 30 },
+        "planDone": { "type": "integer", "minimum": 0, "maximum": 30 },
+        "planSteps": { "type": "integer", "minimum": 1, "maximum": 30 },
+        "round": { "type": "integer", "minimum": 1, "maximum": 30 },
+        "maxRounds": { "type": "integer", "minimum": 1, "maximum": 30 },
+        "idle": { "type": "integer", "minimum": 1, "maximum": 2 },
         "planSkipped": { "const": true },
         "verifyPolicy": { "enum": ["off", "suggest", "require"] },
         "reviewPolicy": { "enum": ["off", "suggest", "require"] },
@@ -213,6 +218,21 @@
         }
       }
     },
+    "turnEnd": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "planSteps", "planDone", "rounds"],
+      "properties": {
+        "state": { "enum": ["done", "midway", "failed", "cancelled"] },
+        "planSteps": { "type": "integer", "minimum": 0, "maximum": 30 },
+        "planDone": { "type": "integer", "minimum": 0, "maximum": 30 },
+        "planDeferred": { "type": "integer", "minimum": 1, "maximum": 30 },
+        "rounds": { "type": "integer", "minimum": 0, "maximum": 30 },
+        "reason": { "enum": ["idle", "limit", "policy"] },
+        "role": { "enum": ["main", "scout", "research", "verify", "review"] },
+        "code": { "type": "string", "pattern": "^[a-z0-9_]{1,64}$" }
+      }
+    },
     "companyFailure": {
       "type": "object",
       "additionalProperties": false,
@@ -243,7 +263,7 @@
           "additionalProperties": false,
           "required": ["kind", "target", "detail"],
           "properties": {
-            "kind": { "enum": ["read", "write", "edit", "command", "search", "list", "web-search", "web-fetch", "subagent", "network", "git", "plan", "other"] },
+            "kind": { "enum": ["read", "write", "edit", "command", "search", "list", "web-search", "web-fetch", "subagent", "network", "docker", "git", "plan", "other"] },
             "target": { "anyOf": [{ "type": "string", "maxLength": 400 }, { "type": "null" }] },
             "detail": { "anyOf": [{ "type": "string", "maxLength": 400 }, { "type": "null" }] }
           }
@@ -315,6 +335,7 @@
         "model": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[A-Za-z0-9._:@/-]{1,120}$" },
         "failure": { "$ref": "#/$defs/companyFailure" },
         "process": { "$ref": "#/$defs/harnessProcess" },
+        "turnEnd": { "$ref": "#/$defs/turnEnd" },
         "toolCalls": {
           "type": "array",
           "maxItems": 64,

package/scripts/company-terminal.mjs

@@ -11,6 +11,7 @@ import { registerTerminalUpdateOffer } from '../packages/piagent-core/runtime/up
 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';
+import { turnEndCopy, turnEndOf } from '../packages/piagent-webui/shared/turn-end.ts';
 
 const LOCALE = 'vi';
 const PERMISSION_STATUS = 'agent-watch-permission';
@@ -88,6 +89,20 @@ export function companyTerminalExtension({ managed, packageRoot, sdkRoot, bindin
       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;
     });
+    // How the member's message ended (finished, stopped with steps open,
+    // failed, stopped), as the dashboard says it under the last answer.
+    let heard = null;
+    pi.on('session_start', async (_event, ctx) => {
+      const session = managed()?.session;
+      if (!session?.subscribe || heard === session) return;
+      heard = session;
+      session.subscribe((event) => {
+        const end = event?.type === 'managed_turn_end' ? turnEndOf(event.end) : null;
+        if (!end) return;
+        const copy = turnEndCopy(end, LOCALE);
+        ctx.ui?.notify?.(`${copy.title}. ${copy.text.replace('Bấm Tiếp tục', 'Gửi "tiếp tục"').replace('bấm Tiếp tục', 'gửi "tiếp tục"')}`, copy.tone === 'success' ? 'info' : copy.tone === 'error' ? 'error' : copy.tone === 'warning' ? 'warning' : 'info');
+      });
+    });
     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) =>

package/scripts/configure-model-scope.sh

@@ -135,6 +135,7 @@ const codexModels = [
 
 const claudeModels = [
   "anthropic/claude-haiku-4-5:low",
+  "anthropic/claude-haiku-5-5:medium",
   "anthropic/claude-sonnet-4-5:high",
   "anthropic/claude-sonnet-4-6:max",
   "anthropic/claude-sonnet-5:xhigh",

package/templates/global/settings.json

@@ -27,7 +27,8 @@
     "anthropic/claude-opus-4-8:xhigh",
     "anthropic/claude-fable-5:xhigh",
     "anthropic/claude-sonnet-5-5:high",
-    "anthropic/claude-opus-5-5:high"
+    "anthropic/claude-opus-5-5:high",
+    "anthropic/claude-haiku-5-5:medium"
   ],
   "compaction": {
     "enabled": true,