@tea-agent/loop-agent 0.44.0-next.5 → 0.44.0-next.7

package/dist/worker/console/chat/session-store.js

@@ -11,7 +11,8 @@
  * operator action call. Every invocation is re-authorized here.
  */
 import path from "node:path";
-import { readdir, rm } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { copyFile, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import { readJsonIfExists, writeSecureJson, } from "../../../infrastructure/console/app-data.js";
 import { dispatchOperatorAction } from "../operator-actions.js";
 import { authorizeOperatorChatTool } from "./tools.js";
@@ -19,6 +20,18 @@ import { authorizeChatSessionTool, DEFAULT_CONSOLE_CHAT_SESSION_MODE, readStored
 import { projectOperationForChat } from "./chat-event-store.js";
 import { scrubSecrets } from "./explore-tools.js";
 import { hashDeferredTurnPayload, parseDeferredTurns, } from "./deferred-turn.js";
+const CHAT_IMAGE_MIME_TYPES = new Set([
+    "image/png",
+    "image/jpeg",
+    "image/gif",
+    "image/webp",
+]);
+function isChatImageMimeType(value) {
+    return typeof value === "string" && CHAT_IMAGE_MIME_TYPES.has(value);
+}
+function isChatAttachmentId(value) {
+    return typeof value === "string" && /^[0-9a-f-]{36}$/i.test(value);
+}
 /** True only for a durable session that has never received user work. */
 export function isBlankChatSession(record) {
     return (record.state === "active" &&
@@ -48,6 +61,11 @@ export function cleanChatTitle(value) {
 function recordPath(appData, sessionId) {
     return path.join(appData.chats, `${sessionId}.json`);
 }
+function attachmentDir(appData, sessionId) {
+    if (!/^[a-zA-Z0-9_-]+$/.test(sessionId))
+        throw new Error("invalid chat session id");
+    return path.join(appData.chats, "attachments", sessionId);
+}
 /** True when `sessionFile` lives inside this store's dedicated Pi JSONL dir. */
 export function isConsoleOwnedSessionFile(appData, sessionFile) {
     const value = sessionFile?.trim();
@@ -196,6 +214,12 @@ export class ChatSessionStore {
         const source = await this.get(input.sourceSessionId);
         if (!source)
             throw new Error(`chat session not found: ${input.sourceSessionId}`);
+        const throughIndex = input.throughMessageId
+            ? source.messages.findIndex((message) => message.id === input.throughMessageId && message.role === "user")
+            : -1;
+        if (input.throughMessageId && throughIndex < 0) {
+            throw new Error("FORK_MESSAGE_NOT_FOUND");
+        }
         return this.serialize(input.targetSessionId, async () => {
             const now = new Date().toISOString();
             const record = {
@@ -208,11 +232,30 @@ export class ChatSessionStore {
                 updatedAt: now,
                 deferredTurns: [],
                 deferredQueueRevision: 0,
-                messages: structuredClone(source.messages),
-                toolInvocations: structuredClone(source.toolInvocations),
+                messages: structuredClone(throughIndex >= 0
+                    ? source.messages.slice(0, throughIndex + 1)
+                    : source.messages),
+                toolInvocations: throughIndex >= 0 ? [] : structuredClone(source.toolInvocations),
             };
-            await this.persist(record);
-            return record;
+            const attachmentIds = record.messages.flatMap((message) => Array.isArray(message.attachments)
+                ? message.attachments.map((attachment) => attachment.id)
+                : []);
+            if (!attachmentIds.every(isChatAttachmentId)) {
+                throw new Error("INVALID_CHAT_ATTACHMENT_REFERENCE");
+            }
+            try {
+                if (attachmentIds.length > 0) {
+                    const targetDir = attachmentDir(this.appData, input.targetSessionId);
+                    await mkdir(targetDir, { recursive: true });
+                    await Promise.all(attachmentIds.map((attachmentId) => copyFile(path.join(attachmentDir(this.appData, input.sourceSessionId), attachmentId), path.join(targetDir, attachmentId))));
+                }
+                await this.persist(record);
+                return record;
+            }
+            catch (error) {
+                await this.removeAttachmentFiles(input.targetSessionId).catch(() => undefined);
+                throw error;
+            }
         });
     }
     /** Atomically backfill the per-conversation simulated identity on first use. */
@@ -286,17 +329,84 @@ export class ChatSessionStore {
             const record = await this.get(sessionId);
             if (!record)
                 return false;
-            const sessionFile = record.sessionFile;
-            await rm(recordPath(this.appData, sessionId), { force: true });
-            this.options.onRecordChange?.(sessionId, undefined);
-            // Record first, then best-effort JSONL unlink. Final consistency is
-            // "both gone" — a leftover JSONL is harmless, a leftover record is not.
-            if (isConsoleOwnedSessionFile(this.appData, sessionFile) && sessionFile) {
-                await rm(sessionFile, { force: true }).catch(() => undefined);
-            }
+            await this.removeSessionArtifacts(sessionId, record.sessionFile);
             return true;
         });
     }
+    /** Roll back a runtime-created session that never acquired a durable owner. */
+    async discardUnownedSession(sessionId, sessionFile) {
+        await this.serialize(sessionId, () => this.removeSessionArtifacts(sessionId, sessionFile));
+    }
+    async removeSessionArtifacts(sessionId, sessionFile) {
+        await rm(recordPath(this.appData, sessionId), { force: true });
+        await this.removeAttachmentFiles(sessionId).catch(() => undefined);
+        this.options.onRecordChange?.(sessionId, undefined);
+        // Record first, then best-effort JSONL unlink. Final consistency is
+        // "both gone" — a leftover JSONL is harmless, a leftover record is not.
+        if (isConsoleOwnedSessionFile(this.appData, sessionFile) && sessionFile) {
+            await rm(sessionFile, { force: true }).catch(() => undefined);
+        }
+    }
+    async removeAttachmentFiles(sessionId, attachmentIds) {
+        const dir = attachmentDir(this.appData, sessionId);
+        if (!attachmentIds) {
+            await rm(dir, { recursive: true, force: true });
+            return;
+        }
+        await Promise.all(attachmentIds.map((attachmentId) => rm(path.join(dir, attachmentId), { force: true })));
+    }
+    async saveAttachments(sessionId, images) {
+        if (images.length === 0)
+            return [];
+        if (!(await this.get(sessionId)))
+            throw new Error(`chat session not found: ${sessionId}`);
+        const dir = attachmentDir(this.appData, sessionId);
+        await mkdir(dir, { recursive: true });
+        const stored = [];
+        try {
+            for (const [index, image] of images.entries()) {
+                if (!isChatImageMimeType(image.mimeType)) {
+                    throw new Error("unsupported chat attachment mime type");
+                }
+                const id = randomUUID();
+                const bytes = Buffer.from(image.data, "base64");
+                await writeFile(path.join(dir, id), bytes, { flag: "wx", mode: 0o600 });
+                stored.push({
+                    id,
+                    name: `图片 ${index + 1}`,
+                    mimeType: image.mimeType,
+                    byteLength: bytes.length,
+                });
+            }
+        }
+        catch (error) {
+            await this.removeAttachmentFiles(sessionId, stored.map((attachment) => attachment.id)).catch(() => undefined);
+            throw error;
+        }
+        return stored;
+    }
+    async readAttachment(sessionId, attachmentId) {
+        if (!isChatAttachmentId(attachmentId))
+            return undefined;
+        const record = await this.get(sessionId);
+        const metadata = record?.messages
+            .flatMap((message) => Array.isArray(message.attachments) ? message.attachments : [])
+            .find((attachment) => attachment.id === attachmentId);
+        if (!metadata || !isChatImageMimeType(metadata.mimeType))
+            return undefined;
+        try {
+            return {
+                metadata,
+                bytes: await readFile(path.join(attachmentDir(this.appData, sessionId), attachmentId)),
+            };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async removeAttachments(sessionId, attachments) {
+        await this.removeAttachmentFiles(sessionId, attachments.map((attachment) => attachment.id));
+    }
     async putDeferredTurn(sessionId, input) {
         return this.serialize(sessionId, async () => {
             const record = await this.get(sessionId);
@@ -454,11 +564,13 @@ export class ChatSessionStore {
             const deferredTurn = index >= 0 ? queue[index] : undefined;
             if (!deferredTurn || deferredTurn.state !== "dispatching")
                 return undefined;
+            const attachments = await this.saveAttachments(sessionId, deferredTurn.images);
             const message = {
                 id: `m_${record.messages.length + 1}_${Math.random().toString(36).slice(2, 8)}`,
                 role: "user",
                 text,
                 at: new Date().toISOString(),
+                ...(attachments.length > 0 ? { attachments } : {}),
             };
             queue.splice(index, 1);
             record.messages.push(message);
@@ -468,7 +580,13 @@ export class ChatSessionStore {
             if (!record.displayTitle)
                 record.displayTitle = cleanChatTitle(message.text);
             record.updatedAt = message.at;
-            await this.persist(record);
+            try {
+                await this.persist(record);
+            }
+            catch (error) {
+                await this.removeAttachments(sessionId, attachments).catch(() => undefined);
+                throw error;
+            }
             return {
                 record,
                 message,
@@ -623,11 +741,20 @@ export async function runChatTurn(options) {
         };
     }
     if (options.persistUserMessage !== false) {
-        const userMessage = await store.appendMessage(sessionId, {
-            role: "user",
-            text,
-            ...(options.clientRequestId ? { clientRequestId: options.clientRequestId } : {}),
-        });
+        const attachments = await store.saveAttachments(sessionId, options.images ?? []);
+        let userMessage;
+        try {
+            userMessage = await store.appendMessage(sessionId, {
+                role: "user",
+                text,
+                ...(options.clientRequestId ? { clientRequestId: options.clientRequestId } : {}),
+                ...(attachments.length > 0 ? { attachments } : {}),
+            });
+        }
+        catch (error) {
+            await store.removeAttachments(sessionId, attachments).catch(() => undefined);
+            throw error;
+        }
         const afterUserMessage = await store.get(sessionId);
         if (afterUserMessage)
             await options.onUserMessagePersisted?.(afterUserMessage, userMessage);
@@ -687,6 +814,7 @@ export async function runChatTurn(options) {
                 // persisted + framed above. Nothing further to persist here.
                 break;
             case "tool_call":
+            case "tool_update":
                 // Forwarded to the caller (SSE) for UI feedback. The actual tool
                 // execution happens in the SDK's customTools[].execute(), which
                 // routes to dispatchChatToolCall (Gate 3). Do NOT dispatch here —

package/dist/worker/console/chat/turn-process.js

@@ -51,7 +51,7 @@ export function projectTurnFlow(group) {
         (item.kind === "step" && item.node.status === "running"))
         .sort((a, b) => compareChatOrder(conversationNodeOrder(a.node), conversationNodeOrder(b.node)));
     const postAnswer = conversationItems
-        .filter((item) => item.kind === "max-tokens")
+        .filter((item) => item.kind === "max-tokens" || item.kind === "turn-error")
         .sort((a, b) => compareChatOrder(conversationNodeOrder(a.node), conversationNodeOrder(b.node)));
     const preludeKeys = new Set(prelude.map((item) => item.node.key));
     const postAnswerKeys = new Set(postAnswer.map((item) => item.node.key));
@@ -86,6 +86,19 @@ export function projectTurnFlow(group) {
     }
     return { prelude, process, postAnswer };
 }
+/**
+ * Main-chat projection: request provenance and model-step bookkeeping remain
+ * available to Trajectory, but do not occupy the user-facing message stream.
+ */
+export function projectTimelineTurnFlow(group) {
+    const flow = projectTurnFlow(group);
+    return {
+        prelude: [],
+        process: flow.process.filter((entry) => entry.source === "process" ||
+            (entry.item.kind !== "request" && entry.item.kind !== "step")),
+        postAnswer: flow.postAnswer,
+    };
+}
 function emptyGroup(key, turnId) {
     return {
         key,
@@ -94,6 +107,7 @@ function emptyGroup(key, turnId) {
         tools: [],
         processItems: [],
         conversationItems: [],
+        turnClosed: false,
         live: false,
     };
 }
@@ -129,6 +143,7 @@ export function hydrateSessionThread(raw) {
                 ...(item.clientRequestId ? { clientRequestId: item.clientRequestId } : {}),
                 ...(item.eventSeq === undefined ? {} : { eventSeq: item.eventSeq }),
                 ...(item.turnId ? { turnId: item.turnId } : {}),
+                ...(item.attachments?.length ? { attachments: item.attachments } : {}),
             });
             continue;
         }
@@ -225,12 +240,17 @@ function flushToolBuffer(processItems, buffer) {
         };
         const dagProgress = dagProgressActivityForTool(tool);
         if (dagProgress) {
-            processItems.push({ kind: "dag-progress", progress: dagProgress, ...order });
+            processItems.push({
+                kind: "dag-progress",
+                progress: dagProgress,
+                toolCallCount: 1,
+                ...order,
+            });
             continue;
         }
         const activity = semanticActivityForTool(tool);
         if (activity) {
-            processItems.push({ kind: "activity", activity, ...order });
+            processItems.push({ kind: "activity", activity, toolCallCount: 1, ...order });
         }
         else {
             processItems.push({ kind: "tool", tool, ...order });
@@ -238,15 +258,28 @@ function flushToolBuffer(processItems, buffer) {
     }
 }
 function collapseDagProgressItems(items) {
-    const seen = new Set();
-    return items.filter((item) => {
-        if (item.kind !== "dag-progress")
-            return true;
-        if (seen.has(item.progress.activityRef))
-            return false;
-        seen.add(item.progress.activityRef);
-        return true;
-    });
+    const collapsed = [];
+    const progressIndexByRef = new Map();
+    for (const item of items) {
+        if (item.kind !== "dag-progress") {
+            collapsed.push(item);
+            continue;
+        }
+        const existingIndex = progressIndexByRef.get(item.progress.activityRef);
+        if (existingIndex === undefined) {
+            progressIndexByRef.set(item.progress.activityRef, collapsed.length);
+            collapsed.push(item);
+            continue;
+        }
+        const existing = collapsed[existingIndex];
+        if (existing?.kind === "dag-progress") {
+            collapsed[existingIndex] = {
+                ...existing,
+                toolCallCount: (existing.toolCallCount ?? 1) + (item.toolCallCount ?? 1),
+            };
+        }
+    }
+    return collapsed;
 }
 function fillProcessDetails(group) {
     const usedToolIds = new Set();
@@ -289,6 +322,7 @@ function fillProcessDetails(group) {
                     items.push({
                         kind: "text",
                         text: block.text,
+                        assistantMessageId: assistant.id,
                         ...(anchorSeq === undefined ? {} : { eventSeq: anchorSeq }),
                         createdAt: anchorAt,
                     });
@@ -353,8 +387,16 @@ function fillProcessDetails(group) {
         }
         addAssistantNode(assistant, getDisplayableAssistantBlocks(assistant.content ?? []));
     }
-    const blocks = finalAssistant?.content ?? [];
-    const split = splitFinalAssistantBlocks(blocks, { isStreaming: group.live });
+    const blocks = finalAssistant?.content ??
+        (finalAssistant?.text.trim()
+            ? [{ type: "text", text: finalAssistant.text }]
+            : []);
+    // Without durable step-completion metadata, only a normally settled Turn can
+    // prove that its latest assistant generation is a final answer. Keep partial
+    // text in process for running/aborted/failed and legacy unknown states.
+    const split = splitFinalAssistantBlocks(blocks, {
+        isStreaming: group.live || group.turnState !== "settled",
+    });
     if (finalAssistant) {
         addAssistantNode(finalAssistant, split.processBlocks);
     }
@@ -391,10 +433,6 @@ function fillProcessDetails(group) {
     group.processItems = collapseDagProgressItems(processItems);
     if (!finalAssistant)
         return;
-    if (blocks.length === 0) {
-        group.answer = finalAssistant;
-        return;
-    }
     if (split.answerBlocks.length === 0)
         return;
     const answerText = joinAssistantText(split.answerBlocks);
@@ -404,9 +442,6 @@ function fillProcessDetails(group) {
         content: split.answerBlocks,
     };
 }
-/**
- * Build user → process → answer groups for the message timeline.
- */
 export function buildTurnProcessGroups(input) {
     const visible = ensureLinkedSubmissionOrder(input.messages
         .filter((m) => m.role === "user" || m.role === "assistant")
@@ -523,10 +558,21 @@ export function buildTurnProcessGroups(input) {
             }
             return a.createdAt - b.createdAt;
         });
+        const turnState = group.turnId
+            ? input.turnStatesById?.[group.turnId]
+            : undefined;
+        if (turnState !== undefined)
+            group.turnState = turnState;
+        group.turnClosed =
+            turnState === "settled" ||
+                turnState === "aborted" ||
+                turnState === "failed";
+        const targetsActiveAssistant = input.activeAssistantId !== null &&
+            group.assistants.some((assistant) => assistant.id === input.activeAssistantId);
         group.live =
             input.streaming &&
-                input.activeAssistantId !== null &&
-                group.assistants.some((a) => a.id === input.activeAssistantId);
+                !group.turnClosed &&
+                (targetsActiveAssistant || turnState === "running");
         fillProcessDetails(group);
         group.conversationItems = (input.conversationNodes ?? [])
             .filter((node) => node.location.kind !== "session" && node.location.turnId === group.turnId)

package/dist/worker/console/chat/user-turn-outline.js

@@ -0,0 +1,19 @@
+const PREVIEW_LIMIT = 160;
+/** Project the complete durable user-message index without shipping full history. */
+export function projectUserTurnOutline(messages) {
+    let index = 0;
+    return messages.flatMap((message) => {
+        if (message.role !== "user")
+            return [];
+        index += 1;
+        const flat = message.text.trim().replace(/\s+/g, " ");
+        return [{
+                messageId: message.id,
+                index,
+                textPreview: flat.length > PREVIEW_LIMIT
+                    ? `${flat.slice(0, PREVIEW_LIMIT).trimEnd()}…`
+                    : flat,
+                createdAt: Date.parse(message.at) || 0,
+            }];
+    });
+}

package/dist/worker/console/console-update-runtime.js

@@ -4,7 +4,7 @@ import { createNpmUpdateClient } from "../../shared/update/npm-client.js";
 import { acquireUpdateLock, updateLockPath } from "../../shared/update/state.js";
 import { readInitRuntimeActivity } from "../observability/init-runtime-activity.js";
 import { performConsoleUpdateAndInit, } from "./console-update-and-init.js";
-import { TERMINAL_OPERATION_STATES } from "../../infrastructure/console/operation-store.js";
+import { isOperationOccupied, } from "../../infrastructure/console/operation-store.js";
 export function createConsoleUpdateExecutor(input) {
     return async (channel) => {
         const currentVersion = readPackageVersion(input.packageRoot);
@@ -49,7 +49,7 @@ export function createConsoleUpdateExecutor(input) {
                     };
                 }
                 const liveOtherOperation = operations.some((operation) => operation.action !== "consoleUpdateAndInit" &&
-                    !TERMINAL_OPERATION_STATES.has(operation.state));
+                    isOperationOccupied(operation.state));
                 return liveOtherOperation
                     ? {
                         ok: false,

package/dist/worker/console/operator-user-error.js

@@ -114,7 +114,7 @@ const CONTEXT_TRANSFER_CODE_COPY = [
     },
     {
         pattern: /\bOPERATION_NEEDS_RECONCILE\b/,
-        copy: "操作记录需要先恢复核对（OPERATION_NEEDS_RECONCILE）：上次执行未确认结束，请刷新操作状态后重试。",
+        copy: "当前操作的执行结果尚未确认，需要先核对（OPERATION_NEEDS_RECONCILE）。请查看操作记录和相关任务状态，核对实际执行结果后再决定后续操作；确认前请勿重复提交。",
     },
     {
         pattern: /\bCONTEXT_EXPORT_FAILED\b/,
@@ -169,6 +169,33 @@ const CONTEXT_TRANSFER_CODE_COPY = [
         pattern: /\bINVALID_VERSION\b/,
         copy: "安装版本或渠道版本号无法解析（INVALID_VERSION），请重试；若持续出现请反馈。",
     },
+    // 源绑定漂移（dag-confirmation.ts / dag-execution-receipt.ts 的英文原文）
+    // 与 frontend split CAS 冲突（operator-actions.ts）原本会原样透传到操作者
+    // 横幅，这里给出可执行的中文说明。
+    {
+        pattern: /\bBINDING_DRIFT\b|\bbinding drift\b|\bbinding drifted\b/i,
+        copy: "这次确认所依据的内容已经变了（任务契约、源文件、程序版本或校验结果在确认之后被修改），因此旧确认不能再使用。这是保护措施，不是故障：请回到任务页重新生成确认，然后重新开始运行。",
+    },
+    {
+        pattern: /frontend split CAS conflict/i,
+        copy: "前端拆分任务的状态在你操作期间被其他操作改过了（通常是另一个标签页或并发操作），为避免覆盖对方的结果，本次修改没有生效。请刷新页面，确认当前状态后重试。",
+    },
+    {
+        pattern: /\bCONFIRMATION_EXPIRED\b/,
+        copy: "这次确认已经超时失效。请回到任务页重新生成确认后再继续。",
+    },
+    {
+        pattern: /\bCONFIRMATION_STALE\b/,
+        copy: "这次确认对应的是改动之前的内容，已经过期作废。请回到任务页重新生成确认后再继续。",
+    },
+    {
+        pattern: /\bCONFIRMATION_CONSUMED\b/,
+        copy: "这次确认已经被使用过了，不能重复提交。如需再次执行，请重新生成确认。",
+    },
+    {
+        pattern: /\bHUMAN_CONFIRMATION_REQUIRED\b/,
+        copy: "这一步需要你先在页面上确认一次才能继续。请按提示完成确认后再重试。",
+    },
 ];
 /** Map internal spawn/controller errors to actionable Chinese copy. */
 export function formatOperatorUserError(message) {

package/dist/worker/console/pi-readiness.js

@@ -85,7 +85,7 @@ function hasProviderConfig(snapshot) {
 /**
  * Discover live Pi SDK / auth / model readiness via ModelRuntime.
  * Kept inside worker/console (dynamic import) so Worker does not depend on
- * executors; contract matches pi-sdk-executor 0.83.0.
+ * executors; contract matches pi-sdk-executor 0.84.4.
  */
 export async function discoverPiReadinessProbe(options) {
     const repoRoot = options?.repoRoot ?? process.cwd();
@@ -118,7 +118,7 @@ export async function discoverPiReadinessProbe(options) {
             modelsAvailable: false,
             interviewSessionOk: false,
             details: {
-                sdkMessage: "Pi SDK incompatible: requires createAgentSession, getAgentDir, and ModelRuntime.create (0.83.0)",
+                sdkMessage: "Pi SDK incompatible: requires createAgentSession, getAgentDir, and ModelRuntime.create (0.84.4)",
                 authMessage: "skipped (sdk incompatible)",
                 modelsMessage: "skipped (sdk incompatible)",
                 sessionMessage: "skipped (sdk incompatible)",
@@ -159,7 +159,7 @@ export async function discoverPiReadinessProbe(options) {
             modelsAvailable: false,
             interviewSessionOk: false,
             details: {
-                sdkMessage: "Pi SDK 0.83.0 contract available",
+                sdkMessage: "Pi SDK 0.84.4 contract available",
                 authMessage: `ModelRuntime.create failed: ${message}`,
                 modelsMessage: "skipped (runtime init failed)",
                 sessionMessage: "skipped (runtime init failed)",
@@ -225,7 +225,7 @@ export async function discoverPiReadinessProbe(options) {
         interviewSessionOk,
         piAvailableModels: availableModels,
         details: {
-            sdkMessage: `Pi SDK 0.83.0 contract available (agentDir=${agentDir})`,
+            sdkMessage: `Pi SDK 0.84.4 contract available (agentDir=${agentDir})`,
             authMessage: authReady
                 ? `credentials/providers ready (available=${availableCount}, providerConfig=${providerConfigured})`
                 : "no available models and no stored/configured provider credentials (set Pi auth or provider API keys)",

package/dist/worker/console/recovery-cta.js

@@ -13,40 +13,40 @@ const CTA = {
     },
     doctor: {
         id: "doctor",
-        label: "Doctor 诊断",
+        label: "体检诊断",
         action: "doctor",
         lane: "dag",
-        guide: "只读诊断：检查 Console / Pi / 仓库就绪，不是重跑前置",
+        guide: "只做检查、不改动任何东西：看看 Console、模型服务和仓库是否正常。重跑之前先跑它，能省很多试错。",
         commandHint: "agent-worker console doctor --repo .",
     },
     decision: {
         id: "decision",
         label: "人工决策",
         lane: "dag",
-        guide: "暂停等人时：先看 doctor 输出再做决策（经 CLI）",
+        guide: "运行停下来等你拍板时用：先点「体检诊断」看清现状，再决定继续还是调整（需要走命令行）。",
         commandHint: "loop-agent dag doctor --run-id <run-id> --markdown",
     },
     resume: {
         id: "resume",
-        label: "恢复运行",
+        label: "继续运行",
         lane: "dag",
-        guide: "仅当运行可安全 resume 时使用（经 CLI）",
+        guide: "只在确认这次运行还能安全接着跑时使用；不确定就先点「体检诊断」（需要走命令行）。",
         commandHint: "loop-agent task advance <task-id> --json",
     },
     reconcile: {
         id: "reconcile",
-        label: "对账 / reconcile",
+        label: "核对并归档中断的运行",
         requiresReason: true,
         action: "dagReconcileRun",
         lane: "dag",
-        guide: "Orphan/中断时先对账归档（默认 supersede）；runner 仍存活时勿盲 supersede",
+        guide: "运行被中断或找不到归属时，用它把这次运行标记为「已归档」，之后才能重新发起。如果运行其实还在跑，请不要用这个动作，否则会打断它。",
         commandHint: "loop-agent dag reconcile-run --run-id <run-id> --action supersede --reason <structured-reason>",
     },
     regenerate: {
         id: "regenerate",
         label: "重新生成契约/计划",
         lane: "dag",
-        guide: "契约/计划过期时：回任务页或经 CLI 重新 task advance（本页仅提示）",
+        guide: "任务契约或计划已经过期时用：回任务页重新生成，或走命令行重跑一次 task advance。本页只是提示，按钮在任务页。",
         commandHint: "loop-agent task advance <task-id> --json",
     },
     observeLink: {
@@ -54,16 +54,16 @@ const CTA = {
         label: "全屏观测",
         action: "observeLink",
         lane: "dag",
-        guide: "打开完整 Inspect 画布；顶栏可返回操作台",
+        guide: "打开完整的过程视图；顶栏可以回到操作台。",
         commandHint: "agent-worker console --repo . --port 8790",
     },
     dagRerun: {
         id: "dagRerun",
-        label: "从失败节点恢复",
+        label: "从失败节点继续",
         requiresReason: true,
         action: "dagRerun",
         lane: "dag",
-        guide: "Provider、网络、限流或超时等非代码问题的首选：先评估安全子图，合格后创建 continuation run 从有效节点恢复（无需 Human Gate）。Worker 持有的 run、workspace/controller 漂移或含 unsafe shell 时不要强跑子图",
+        guide: "失败原因跟代码无关时（模型服务报错、网络、限流、超时）首选这个：系统会先判断哪些步骤可以安全跳过，再从出错前的那一步接着跑，不用从头再来，也不需要人工审批。以下几种情况不能这样跑：这次运行是 Worker 队列发起的、仓库或程序版本在这次运行后被改过、或者后续步骤里有会执行命令的验证环节——遇到这些请改用「带反馈重新执行任务」。",
         commandHint: "loop-agent dag rerun --run-id <run-id> --from-node <node-id> --plan",
     },
     standaloneTaskRerun: {
@@ -72,7 +72,7 @@ const CTA = {
         requiresReason: true,
         action: "standaloneTaskRerun",
         lane: "dag",
-        guide: "独立 DAG run 无法安全从节点恢复时，重新生成完整 DAG，并带入上一轮仍未解决的 verify/review 反馈；没有可继承反馈时会明确说明（无需 Human Gate）。Worker 持有的 run 请用下方「重新排队 Worker Task」",
+        guide: "不能从中间某一步接着跑时用这个：会把整个任务从头重新执行一遍，并自动带上上一轮还没解决的验证/评审意见，不用人工审批。如果没有可以继承的意见，会明确告诉你。注意：Worker 队列发起的任务请用下方「重新排队 Worker Task」。",
         commandHint: "loop-agent dag rerun-task --run-id <run-id> --reason <text> --json",
     },
     workerTaskRetry: {
@@ -81,7 +81,7 @@ const CTA = {
         requiresReason: true,
         action: "workerTaskRetry",
         lane: "worker",
-        guide: "仅 Worker 队列任务失败时直调执行，服务端校验 Failed 状态，无需 Human Gate；不要与 DAG 完整重跑混用",
+        guide: "只用于 Worker 队列里失败的任务：服务端会先确认它确实处于失败状态再重新入队，不需要人工审批。不要和上面的「带反馈重新执行任务」混用。",
         commandHint: "agent-worker task retry <task-id> --feature-id <feature-id> --repo . --reason <reason>",
     },
     interrupt: {
@@ -90,7 +90,7 @@ const CTA = {
         requiresReason: true,
         action: "dagRequestInterrupt",
         lane: "dag",
-        guide: "仅本机 Console 持有的正在运行 DAG：经 Human Gate 登记协作中止，等待当前节点安全收敛。不会立即强杀进程",
+        guide: "只对这台 Console 正在跑的运行有效：提交后需要你在浏览器里确认一次，然后等当前步骤安全跑完，不会立刻杀掉进程。",
         commandHint: "loop-agent dag request-interrupt --run-id <run-id> --reason-code operator-request --reason <structured-reason>",
     },
 };

package/dist/worker/console/static/assets/{abnfDiagram-N423BO3Z-BHuhGM1e.js → abnfDiagram-N423BO3Z-DTuku_-7.js}

@@ -1 +1 @@
-import{g as p,r as u,d as a}from"./chunk-6Q2QTUOP-ClMg8xmV.js";import{p as f}from"./chunk-JWPE2WC7-CDdO-jPJ.js";import{_ as n,l as o}from"./mermaid.core-BdAMrTf7.js";import{M as c,b as d}from"./cynefin-VYW2F7L2-B8u1_FtM.js";import"./index-wKEJUaP5.js";var v=d().RailroadAbnf.parser.LangiumParser,i=n(e=>{const r=e.alternatives.map(g);return r.length===1?r[0]:{type:"choice",alternatives:r}},"transformAlternation"),g=n(e=>{const r=e.elements.map(y);return r.length===1?r[0]:{type:"sequence",elements:r}},"transformConcatenation"),b=n(e=>{if(e.includes("*")){const[t,s]=e.split("*"),l=t?parseInt(t,10):0,m=s?parseInt(s,10):1/0;return{min:l,max:m}}const r=parseInt(e,10);return{min:r,max:r}},"parseRepeat"),y=n(e=>{const r=A(e.primary);if(!e.repeat)return r;const{min:t,max:s}=b(e.repeat);return t===0&&s===1?{type:"optional",element:r}:{type:"repetition",element:r,min:t,max:s}},"transformElement"),A=n(e=>{switch(e.$type){case"AbnfStringLiteral":return{type:"terminal",value:e.value};case"AbnfNumVal":return{type:"terminal",value:e.value};case"AbnfRuleName":return{type:"nonterminal",name:e.name};case"AbnfGroup":return i(e.element);case"AbnfOptionalGroup":return{type:"optional",element:i(e.element)};default:throw new Error(`Unsupported ABNF primary node: ${e.$type}`)}},"transformPrimary"),P=n(e=>({name:e.name,definition:i(e.definition)}),"transformRule"),h=n(e=>{f(e,a),e.title&&a.setTitle(e.title),e.rules.map(r=>a.addRule(P(r)))},"populateDb"),R={parse:n(e=>{a.clear(),o.debug("[ABNF Parser] Starting Langium parse");const r=v.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new c(r);const t=r.value;o.debug("[ABNF Parser] Parsed rules:",t.rules.length),h(t),o.debug("[ABNF Parser] Parse complete")},"parse"),parser:{yy:a}},B={parser:R,db:a,renderer:u,styles:p};export{B as diagram};
+import{g as p,r as u,d as a}from"./chunk-6Q2QTUOP-Caso6uN7.js";import{p as f}from"./chunk-JWPE2WC7-DiMqZQ_8.js";import{_ as n,l as o}from"./mermaid.core-DF6mMPJ9.js";import{M as c,b as d}from"./cynefin-VYW2F7L2-C-NKFflx.js";import"./index-DWKejNVJ.js";var v=d().RailroadAbnf.parser.LangiumParser,i=n(e=>{const r=e.alternatives.map(g);return r.length===1?r[0]:{type:"choice",alternatives:r}},"transformAlternation"),g=n(e=>{const r=e.elements.map(y);return r.length===1?r[0]:{type:"sequence",elements:r}},"transformConcatenation"),b=n(e=>{if(e.includes("*")){const[t,s]=e.split("*"),l=t?parseInt(t,10):0,m=s?parseInt(s,10):1/0;return{min:l,max:m}}const r=parseInt(e,10);return{min:r,max:r}},"parseRepeat"),y=n(e=>{const r=A(e.primary);if(!e.repeat)return r;const{min:t,max:s}=b(e.repeat);return t===0&&s===1?{type:"optional",element:r}:{type:"repetition",element:r,min:t,max:s}},"transformElement"),A=n(e=>{switch(e.$type){case"AbnfStringLiteral":return{type:"terminal",value:e.value};case"AbnfNumVal":return{type:"terminal",value:e.value};case"AbnfRuleName":return{type:"nonterminal",name:e.name};case"AbnfGroup":return i(e.element);case"AbnfOptionalGroup":return{type:"optional",element:i(e.element)};default:throw new Error(`Unsupported ABNF primary node: ${e.$type}`)}},"transformPrimary"),P=n(e=>({name:e.name,definition:i(e.definition)}),"transformRule"),h=n(e=>{f(e,a),e.title&&a.setTitle(e.title),e.rules.map(r=>a.addRule(P(r)))},"populateDb"),R={parse:n(e=>{a.clear(),o.debug("[ABNF Parser] Starting Langium parse");const r=v.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new c(r);const t=r.value;o.debug("[ABNF Parser] Parsed rules:",t.rules.length),h(t),o.debug("[ABNF Parser] Parse complete")},"parse"),parser:{yy:a}},B={parser:R,db:a,renderer:u,styles:p};export{B as diagram};