@piagent/platform 1.25.0 → 1.26.1

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-CiLLJu4R.js"></script>
+    <script type="module" crossorigin src="/assets/index-DWkb1mpZ.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-B5XOKQy-.css">
   </head>
   <body>

package/packages/piagent-webui/gateway/managed-gateway.mjs

@@ -2,6 +2,7 @@ import { managedThinkingLevels, nearestLevel } from '../../piagent-core/managed/
 import { ManagedBrokerClient } from '../../piagent-core/managed/broker-client.mjs';
 import { ManagedSession } from '../../piagent-core/managed/session.mjs';
 import { fastAllowed } from '../../piagent-core/managed/fast-mode.mjs';
+import { PI_HOST_VERSION } from '../../piagent-core/managed/pi-host.mjs';
 import fs from 'node:fs';
 
 // A company model as the new chat page sees it: the thinking levels its
@@ -43,7 +44,7 @@ export async function startManagedGateway({ config, configPath, cwd, agentDir, p
         return {session:runtime.session,dispose:()=>runtime.dispose()};
       } catch(error) { if(runtime) await runtime.dispose(); else await broker.dispose(); throw error; }
     };
-    const gateway=await startPiagentGateway({packageRoot,agentDir,expectedPiVersion:'0.87.1',managed:{host,models,runtimeFactory:factory,project:registerProject?cwd:null}});
+    const gateway=await startPiagentGateway({packageRoot,agentDir,expectedPiVersion:PI_HOST_VERSION,managed:{host,models,runtimeFactory:factory,project:registerProject?cwd:null}});
     return gateway;
   } finally { if(probe) await probe.dispose(); else await probeBroker.dispose(); }
 }

package/packages/piagent-webui/gateway/session-runtime-supervisor.ts

@@ -218,8 +218,8 @@ export class SessionRuntimeSupervisor {
     expectedOperationRef: string | null; messageRequestId?: string; images?: unknown[] }, sessionRevision: string, options: { deferDispatch?: boolean } = {}):
   Promise<SessionSendResult> {
     await this.acquire(sessionRef);
-    const active = this.#active.get(sessionRef), session = active?.runtime.session;
-    if (!active || !session) throw new Error("session-runtime-unavailable");
+    const active = this.#active.get(sessionRef), session = active?.runtime.session; if (!active || !session) throw new Error("session-runtime-unavailable");
+    if (payload.delivery === "new-operation" && payload.expectedOperationRef === null && active.operationRef && !active.settling && session.isStreaming && !active.runtime.beginWireOperation) payload = { ...payload, delivery: "follow-up", expectedOperationRef: active.operationRef }; // a message from another tab waits for the running turn, as in the Terminal
     if (payload.delivery !== "new-operation") {
       if (active.runtime.beginWireOperation) throw new Error("provider-wire-queued-input-unsupported");
       if (!active.operationRef || active.operationRef !== payload.expectedOperationRef || active.settling || !session.isStreaming) throw new Error("session-operation-conflict");
@@ -405,11 +405,11 @@ export class SessionRuntimeSupervisor {
     await this.acquire(sessionRef);
     const active = this.#active.get(sessionRef), session = active?.runtime.session;
     if (!active || !session?.sessionManager) throw new Error("session-runtime-unavailable");
-    if (active.operationRef || !session.isIdle) throw new Error("session-runtime-busy");
+    // One appended entry the turn neither reads nor waits on, so no busy check: renamed mid-turn, as Pi's own /name is.
     const current = String(session.sessionManager.getSessionName?.() ?? "").trim();
     if (current === title.trim()) return "no-change";
     session.sessionManager.appendSessionInfo(title);
-    this.#touchCreated(sessionRef);
+    const created = this.#created.get(sessionRef); if (created) created.name = title; this.#touchCreated(sessionRef); // listed from memory until its first message
     return "renamed";
   }
   async fork(sessionRef: string, entryRef: string | null, title: string | null): Promise<string> {

package/packages/piagent-webui/server/transcript-projection.ts

@@ -37,9 +37,10 @@ type TranscriptItem = { messageRef: string; parentMessageRef: string | null; rol
     summary?: ToolSummary; change?: ToolChange; result?: ToolResult }>; usage?: TurnUsage; model?: string; process?: HarnessProcess; turnEnd?: TurnEnd };
 type HarnessFinding = { severity: "blocking" | "major" | "minor"; file: string; line: number | null; issue: string };
 type HarnessIssue = { kind: "wrong_premise" | "conflicts_with_request" | "ambiguous" | "out_of_scope"; detail: string };
-type HarnessProcess = { phase: "plan" | "verify" | "review" | "final" | "objection" | "answer" | "claims" | "rejudge" | "dispute" | "continue"; outcome?: string; loop?: number; maxLoops?: number;
+type HarnessProcess = { phase: "plan" | "verify" | "review" | "final" | "objection" | "answer" | "claims" | "rejudge" | "dispute" | "continue" | "undo"; outcome?: string; loop?: number; maxLoops?: number;
   verified?: boolean; reviewed?: boolean; blockingOpen?: number; planOpen?: number; planDone?: number; planSteps?: number; round?: number; maxRounds?: number; idle?: number; planSkipped?: true; verifyPolicy?: string; reviewPolicy?: string; reviewUnavailable?: string;
-  findings?: HarnessFinding[]; role?: "scout" | "research" | "verify" | "review"; by?: "main" | "harness"; disputes?: number; unchanged?: true; issues?: HarnessIssue[]; claims?: { claim: string }[] };
+  findings?: HarnessFinding[]; role?: "scout" | "research" | "verify" | "review"; by?: "main" | "harness"; disputes?: number; unchanged?: true; issues?: HarnessIssue[]; claims?: { claim: string }[];
+  undo?: { result: "done" | "refused" | "busy" | "none" | "failed"; restored: number; removed: number; files: string[]; more?: boolean } };
 export type TranscriptDocument = { schemaVersion: 1; version: "piagent-webui-transcript-v1"; generatedAt: string; identity: TranscriptIdentity;
   revision: TranscriptRevision; eventCursor: string; state: "ready" | "unavailable"; items: TranscriptItem[];
   page: { beforeCursor: string | null; nextBeforeCursor: string | null; hasOlder: boolean; limit: number; truncated: boolean }; reasonCode: string | null };
@@ -197,7 +198,8 @@ function toolCalls(message: any, sessionRef: string, role: TranscriptItem["role"
 const PROCESS_OUTCOMES = ["no_change", "interrupted", "disputed", "blocking_open", "unverified", "review_unavailable", "unreviewed", "clean"];
 // A helper's objection to its brief, a failed claim, a disagreement handed to the member.
 // "continue": the harness sent the agent back to a checklist with open steps.
-const PROCESS_PHASES = ["plan", "verify", "review", "final", "objection", "answer", "claims", "rejudge", "dispute", "continue"];
+// "undo": the member's /undo put the last turn's files back (checkpoints.mjs).
+const PROCESS_PHASES = ["plan", "verify", "review", "final", "objection", "answer", "claims", "rejudge", "dispute", "continue", "undo"];
 const ISSUE_KINDS = ["wrong_premise", "conflicts_with_request", "ambiguous", "out_of_scope"], HELPER_ROLES = ["scout", "research", "verify", "review"];
 const POLICY_MODES = ["off", "suggest", "require"];
 function harnessProcess(details: any): HarnessProcess | null {
@@ -233,6 +235,10 @@ function harnessProcess(details: any): HarnessProcess | null {
     .map((i: any) => ({ kind: i.kind, detail: safeText(i.detail).full.slice(0, 400) }));
   if (Array.isArray(details.claims)) out.claims = details.claims.filter((c: any) => typeof c?.claim === "string" && c.claim.trim()).slice(0, 10)
     .map((c: any) => ({ claim: safeText(c.claim).full.slice(0, 500) }));
+  const count = (n: unknown) => Number.isInteger(n) && (n as number) >= 0 ? Math.min(n as number, 100000) : 0;
+  if (details.phase === "undo" && ["done", "refused", "busy", "none", "failed"].includes(details.undo?.result)) out.undo = { result: details.undo.result,
+    restored: count(details.undo.restored), removed: count(details.undo.removed), ...(details.undo.more === true ? { more: true } : {}),
+    files: (Array.isArray(details.undo.files) ? details.undo.files : []).filter((f: unknown) => typeof f === "string" && f).slice(0, 5).map((f: string) => safeText(f).full.slice(0, 300)) };
   return out;
 }
 function role(message: any): TranscriptItem["role"] | null {

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

@@ -8,6 +8,7 @@ export type ProcessCopyInput = {
   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 }>;
+  undo?: { result: string; restored: number; removed: number; files: string[]; more?: boolean };
 };
 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"] };
@@ -51,6 +52,15 @@ export function headlineText(process: ProcessCopyInput, locale: CopyLocale): str
     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 "undo": {
+      const u = process.undo, files = u?.files?.length ? ` (${u.files.join(", ")})` : "";
+      if (u?.result === "done") return pick(locale, `Đã hoàn tác lượt trước: ${u.restored} file trả về như trước, ${u.removed} file lượt đó tạo đã xoá${files}.${u.more ? " Gửi /undo lần nữa để hoàn tác lượt trước nữa." : ""} Commit trong lượt đó vẫn giữ.`,
+        `Undid the last turn: ${u.restored} file(s) restored, ${u.removed} file(s) it created removed${files}.${u.more ? " Send /undo again to undo the turn before." : ""} Commits made in that turn stay.`);
+      if (u?.result === "refused") return pick(locale, `Không hoàn tác: file lượt trước đã sửa lại bị đổi tiếp sau đó${files}; hoàn tác sẽ ghi đè thay đổi đó.`, `Not undone: a file the last turn changed was changed again since${files}; undoing would overwrite that change.`);
+      if (u?.result === "busy") return pick(locale, "Đang có một lượt chạy: chờ nó xong (hoặc dừng nó) rồi /undo.", "A turn is running: wait for it (or stop it), then /undo.");
+      if (u?.result === "none") return pick(locale, "Không có lượt nào để hoàn tác (chỉ áp dụng cho project là git repository, từ khi mở cuộc trò chuyện).", "There is no turn to undo (git repositories only, since the conversation opened).");
+      return pick(locale, "Không đọc được trạng thái project; không hoàn tác.", "The project's state could not be read; nothing was undone.");
+    }
     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 "";
   }

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

@@ -157,7 +157,19 @@
       "additionalProperties": false,
       "required": ["phase"],
       "properties": {
-        "phase": { "enum": ["plan", "verify", "review", "final", "objection", "answer", "claims", "rejudge", "dispute", "continue"] },
+        "phase": { "enum": ["plan", "verify", "review", "final", "objection", "answer", "claims", "rejudge", "dispute", "continue", "undo"] },
+        "undo": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["result", "restored", "removed", "files"],
+          "properties": {
+            "result": { "enum": ["done", "refused", "busy", "none", "failed"] },
+            "restored": { "type": "integer", "minimum": 0, "maximum": 100000 },
+            "removed": { "type": "integer", "minimum": 0, "maximum": 100000 },
+            "files": { "type": "array", "maxItems": 5, "items": { "type": "string", "maxLength": 300 } },
+            "more": { "type": "boolean" }
+          }
+        },
         "outcome": { "enum": ["no_change", "interrupted", "disputed", "blocking_open", "unverified", "review_unavailable", "unreviewed", "clean"] },
         "role": { "enum": ["scout", "research", "verify", "review"] },
         "by": { "enum": ["main", "harness"] },

package/scripts/company-terminal.mjs

@@ -9,6 +9,7 @@ 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 { checkpointsOf } from '../packages/piagent-core/managed/checkpoints.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';
@@ -83,6 +84,17 @@ export function companyTerminalExtension({ managed, packageRoot, sdkRoot, bindin
         ctx.ui.notify(PERMISSION_TEXT[session.permission] ?? PERMISSION_TEXT['workspace-write'], 'info');
       } });
 
+    // /undo: the files the last turn changed go back to how they were before
+    // it, unless one changed again since (checkpoints.mjs).
+    pi.registerCommand('undo', {
+      description: 'Hoàn tác file mà lượt trước của agent đã sửa (project là git repository)',
+      handler: async (_args, ctx) => {
+        const session = managed();
+        if (!session?.boundary) { ctx.ui.notify('Cuộc trò chuyện này chưa sẵn sàng.', 'error'); return; }
+        try { ctx.ui.notify((await checkpointsOf(session).undo()).text, 'info'); }
+        catch (error) { ctx.ui.notify(`Không hoàn tác được: ${String(error?.message ?? error).slice(0, 300)}`, 'error'); }
+      } });
+
     // Fast mode, where the team's Harness allows it; off until the member turns it on.
     const showFast = (ctx) => ctx.ui?.setStatus?.('agent-watch-fast', managed()?.session?.managedFastState?.() === 'on' ? 'Fast' : undefined);
     pi.on('session_start', async (_event, ctx) => showFast(ctx));

package/scripts/piagent-studio.mjs

@@ -14,12 +14,13 @@ const digest = file => createHash('sha256').update(fs.readFileSync(file)).digest
 process.removeAllListeners('warning');
 process.on('warning', warning => { if (warning.name !== 'ExperimentalWarning') process.stderr.write(`${warning.name}: ${warning.message}\n`); });
 const args = process.argv.slice(2), flags = new Map();
-if (args.includes('--help')) { console.log('piagent studio [--web [--no-open] | --serve | --check | --doctor | --prompt <text>] [--config <Agent Watch configuration>] [--project <folder>]\nDefaults: the configuration imported into ~/.pi/agent and the current project. Personal sessions remain under pi / piagent dashboard.'); process.exit(0); }
+if (args.includes('--help')) { console.log('piagent studio [--web [--no-open] | --serve | --check | --doctor | --prompt <text> [--json]] [--config <Agent Watch configuration>] [--project <folder>]\nDefaults: the configuration imported into ~/.pi/agent and the current project. Personal sessions remain under pi / piagent dashboard.\n--json with --prompt writes the event stream of `pi --mode json` (JSONL on stdout; failures on stderr, exit 1).'); process.exit(0); }
 for (let i = 0; i < args.length; i++) {
-  if (['--check', '--doctor', '--web', '--serve', '--no-open'].includes(args[i])) { flags.set(args[i], true); continue; }
+  if (['--check', '--doctor', '--web', '--serve', '--no-open', '--json'].includes(args[i])) { flags.set(args[i], true); continue; }
   if (!['--config', '--project', '--prompt'].includes(args[i]) || flags.has(args[i]) || !args[i + 1]) throw Error('managed-launch-arguments');
   flags.set(args[i], args[++i]);
 }
+if (flags.has('--json') && !flags.has('--prompt')) throw Error('managed-launch-arguments');
 const home = os.homedir();
 // Do this before importing the SDK: it must not discover personal keys, Node
 // preload hooks, proxy overrides or provider endpoints from an ambient shell.
@@ -133,11 +134,23 @@ try {
   const host = await api.createAgentSessionRuntime(factory, { cwd, agentDir, sessionManager: api.SessionManager.create(cwd, path.join(agentDir, 'sessions')) });
   if (flags.get('--check')) console.log('agent-watch-auto: connected; native context; isolated tools; no inference sent.');
   else if (flags.has('--prompt')) {
-    current.session.subscribe(event => {
-      if (event.type === 'message_update' && event.assistantMessageEvent.type === 'text_delta') process.stdout.write(event.assistantMessageEvent.delta);
-      if (event.type === 'message_end' && ['agent-watch-helper-receipt','agent-watch-review-status'].includes(event.message?.customType)) process.stderr.write(String(event.message.content) + '\n');
-    });
-    await current.session.prompt(flags.get('--prompt')); process.stdout.write('\n');
+    if (flags.has('--json')) {
+      // The event stream of `pi --mode json`, from Pi's own serializer: the
+      // session header, then every session event as one JSON line. Company
+      // events (managed_helpers, the Harness's agent-watch-process notes)
+      // come in the same stream.
+      const { toJsonEvent } = await import(pathToFileURL(path.join(config.sdk_root, 'dist/modes/json-event.js')).href);
+      const header = current.session.sessionManager.getHeader?.();
+      if (header) process.stdout.write(JSON.stringify(header) + '\n');
+      current.session.subscribe(event => process.stdout.write(JSON.stringify(toJsonEvent(event)) + '\n'));
+      await current.session.prompt(flags.get('--prompt'));
+    } else {
+      current.session.subscribe(event => {
+        if (event.type === 'message_update' && event.assistantMessageEvent.type === 'text_delta') process.stdout.write(event.assistantMessageEvent.delta);
+        if (event.type === 'message_end' && ['agent-watch-helper-receipt','agent-watch-review-status'].includes(event.message?.customType)) process.stderr.write(String(event.message.content) + '\n');
+      });
+      await current.session.prompt(flags.get('--prompt')); process.stdout.write('\n');
+    }
     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].