@tea-agent/loop-agent 0.41.0 → 0.42.0-next.1

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

@@ -14,6 +14,162 @@ const MUTATION_GATE_COPY = [
         copy: "请求主机校验失败：非回环绑定时要求 Host 头，请刷新页面或检查访问地址。",
     },
 ];
+/**
+ * Context-transfer / artifact-revision 稳定 reason code（kernel CLI 会原样
+ * 透传到操作错误信息里）→ 面向操作者的中文语义。与 observe 侧
+ * dag-context-reason-labels.js 同源，保留原码便于诊断。
+ */
+const CONTEXT_TRANSFER_CODE_COPY = [
+    {
+        pattern: /\bCONTEXT_RECEIPT_MISSING\b/,
+        copy: "该节点没有执行时上下文回执（CONTEXT_RECEIPT_MISSING）：只有真实执行过的模型节点才有可导出的上下文；历史 run 不做事后回填。",
+    },
+    {
+        pattern: /\bCONTEXT_COMPONENT_UNAVAILABLE\b/,
+        copy: "部分上下文组件当前不可用（CONTEXT_COMPONENT_UNAVAILABLE），无法生成完整交接包。",
+    },
+    {
+        pattern: /\bCONTEXT_BUNDLE_TOO_LARGE\b/,
+        copy: "导出内容超出体积上限（CONTEXT_BUNDLE_TOO_LARGE），请缩小节点范围或联系维护者调整上限。",
+    },
+    {
+        pattern: /\bRAW_EXPORT_ACKNOWLEDGEMENT_REQUIRED\b/,
+        copy: "原文导出包含敏感数据风险（RAW_EXPORT_ACKNOWLEDGEMENT_REQUIRED），需要先勾选风险确认。",
+    },
+    {
+        pattern: /\bSECRET_SCAN_CONFIRMATION_REQUIRED\b/,
+        copy: "候选文件疑似包含凭据（SECRET_SCAN_CONFIRMATION_REQUIRED），确认风险后才能继续。",
+    },
+    {
+        pattern: /\bARTIFACT_BINDING_UNAVAILABLE\b/,
+        copy: "缺少结构化产物关系（ARTIFACT_BINDING_UNAVAILABLE）：只有带产物绑定的新 run 支持修订与派生，历史 run 仅可查看/下载。",
+    },
+    {
+        pattern: /\bARTIFACT_NOT_REVISION_ELIGIBLE\b/,
+        copy: "该产物不允许修订替换（ARTIFACT_NOT_REVISION_ELIGIBLE）。",
+    },
+    {
+        pattern: /\bARTIFACT_IDENTITY_AMBIGUOUS\b/,
+        copy: "产物身份不唯一（ARTIFACT_IDENTITY_AMBIGUOUS），无法安全定位修订目标。",
+    },
+    {
+        pattern: /\bARTIFACT_REVISION_SCHEMA_INVALID\b/,
+        copy: "候选文件不符合该产物声明的数据结构（ARTIFACT_REVISION_SCHEMA_INVALID），已拒绝入库。",
+    },
+    {
+        pattern: /\bARTIFACT_REVISION_PATH_INVALID\b/,
+        copy: "候选目标路径无效（ARTIFACT_REVISION_PATH_INVALID），已拒绝。",
+    },
+    {
+        pattern: /\bARTIFACT_REVISION_EXPIRED\b/,
+        copy: "修订候选已过期（ARTIFACT_REVISION_EXPIRED），请重新上传后再继续。",
+    },
+    {
+        pattern: /\bARTIFACT_REVISION_DRIFT\b/,
+        copy: "候选文件与登记内容不一致（ARTIFACT_REVISION_DRIFT），请重新上传。",
+    },
+    {
+        pattern: /\bARTIFACT_REVISION_QUOTA_EXCEEDED\b/,
+        copy: "修订暂存区配额已满（ARTIFACT_REVISION_QUOTA_EXCEEDED），请先丢弃不需要的修订或等待过期回收。",
+    },
+    {
+        pattern: /\bARTIFACT_CONSUMER_UNKNOWN\b/,
+        copy: "无法确定受影响的下游节点（ARTIFACT_CONSUMER_UNKNOWN），派生继续已被阻止。",
+    },
+    {
+        pattern: /\bARTIFACT_IMPACT_UNSAFE\b/,
+        copy: "影响范围包含不能自动重跑的节点（ARTIFACT_IMPACT_UNSAFE），派生继续已被阻止。",
+    },
+    {
+        pattern: /\bRERUN_PLAN_DRIFT\b|\bPLAN_DRIFT\b/,
+        copy: "继续运行计划与当前事实发生漂移（RERUN_PLAN_DRIFT），请重新生成计划后再执行。",
+    },
+    {
+        pattern: /\bWORKER_MANAGED_CONTINUATION_UNSUPPORTED\b/,
+        copy: "由 Worker 托管的运行暂不支持派生继续（WORKER_MANAGED_CONTINUATION_UNSUPPORTED），这是当前版本的明确边界，不是失败。",
+    },
+    {
+        pattern: /\bWORKER_CONTINUATION_AUTHORITY_MISMATCH\b/,
+        copy: "Worker 派生运行的归属事实不一致（WORKER_CONTINUATION_AUTHORITY_MISMATCH），请刷新计划并核对 Task Pool 状态。",
+    },
+    {
+        pattern: /\bWORKER_CONTINUATION_LEASE_CONFLICT\b/,
+        copy: "该 Worker Task 已有运行占用（WORKER_CONTINUATION_LEASE_CONFLICT），请等待当前运行结束或先完成恢复核对。",
+    },
+    {
+        pattern: /\bWORKER_CONTINUATION_NEEDS_RECONCILE\b/,
+        copy: "Worker 派生运行已存在但终态尚未完成核对（WORKER_CONTINUATION_NEEDS_RECONCILE），不会再次启动；请先执行恢复核对。",
+    },
+    {
+        pattern: /\bPARENT_IMMUTABILITY_VIOLATION\b/,
+        copy: "父运行事实发生变化（PARENT_IMMUTABILITY_VIOLATION），已阻止派生以保护历史证据。",
+    },
+    {
+        pattern: /\bPARENT_LIFECYCLE\b/,
+        copy: "父运行当前状态不允许派生继续（PARENT_LIFECYCLE）。",
+    },
+    {
+        pattern: /\bREQUEST_ID_REUSE_CONFLICT\b/,
+        copy: "相同请求 ID 已被其他操作占用（REQUEST_ID_REUSE_CONFLICT），请更换请求 ID 重试。",
+    },
+    {
+        pattern: /\bOPERATION_NEEDS_RECONCILE\b/,
+        copy: "操作记录需要先恢复核对（OPERATION_NEEDS_RECONCILE）：上次执行未确认结束，请刷新操作状态后重试。",
+    },
+    {
+        pattern: /\bCONTEXT_EXPORT_FAILED\b/,
+        copy: "上下文导出失败（CONTEXT_EXPORT_FAILED），请稍后重试；若持续失败请检查该节点是否存在可导出的执行事实。",
+    },
+    {
+        pattern: /\bCONTEXT_EXPORT_UNAVAILABLE\b/,
+        copy: "导出内容不存在或已过期（CONTEXT_EXPORT_UNAVAILABLE），请重新生成。",
+    },
+    {
+        pattern: /\bLEASE_HELD\b/,
+        copy: "资源正被其他操作占用（LEASE_HELD），请等待当前操作结束或稍后重试。",
+    },
+    // 更新并初始化链路的稳定错误码。
+    {
+        pattern: /\bREGISTRY_VERSION_REGRESSION\b/,
+        copy: "所选渠道的最新版本比当前安装的版本更旧（REGISTRY_VERSION_REGRESSION），已阻止降级更新。请改用包含更新版本的渠道（如 next/beta）。",
+    },
+    {
+        pattern: /\bUPDATE_LOCKED\b/,
+        copy: "另一个 loop-agent 更新正在进行（UPDATE_LOCKED），请等待其结束后重试。",
+    },
+    {
+        pattern: /\bINSTALL_FAILED\b/,
+        copy: "新版本安装失败（INSTALL_FAILED），请检查网络与 npm registry 后重试。",
+    },
+    {
+        pattern: /\bINSTALL_VERIFICATION_FAILED\b/,
+        copy: "安装后校验未通过（INSTALL_VERIFICATION_FAILED），未接棒新版本；请重试或手动安装。",
+    },
+    {
+        pattern: /\bACTIVE_RUNTIME\b/,
+        copy: "当前存在活跃的 DAG/Worker 运行（ACTIVE_RUNTIME），更新已推迟；请等待运行结束后再更新。",
+    },
+    {
+        pattern: /\bCHAT_TURN_ACTIVE\b/,
+        copy: "对话正在执行中（CHAT_TURN_ACTIVE），更新已推迟；请等待当前回合结束后再更新。",
+    },
+    {
+        pattern: /\bOPERATION_ACTIVE\b/,
+        copy: "另一个 Console 操作正在进行（OPERATION_ACTIVE），请等待其结束后再更新。",
+    },
+    {
+        pattern: /\bHANDOFF_FAILED\b/,
+        copy: "新版本已安装，但接棒启动新 Console 失败（HANDOFF_FAILED）；旧进程未被关闭，可直接重试或手动重启 Console。",
+    },
+    {
+        pattern: /\bINIT_NEEDS_RECONCILE\b/,
+        copy: "安全初始化未完全通过（INIT_NEEDS_RECONCILE）：版本已就绪，请查看初始化待处理项后重试。",
+    },
+    {
+        pattern: /\bINVALID_VERSION\b/,
+        copy: "安装版本或渠道版本号无法解析（INVALID_VERSION），请重试；若持续出现请反馈。",
+    },
+];
 /** Map internal spawn/controller errors to actionable Chinese copy. */
 export function formatOperatorUserError(message) {
     const raw = (message ?? "").trim();
@@ -37,6 +193,19 @@ export function formatOperatorUserError(message) {
     if (/force-required|requires --force/i.test(raw)) {
         return "该终态需要强制 Discard。请确认后勾选强制再试。";
     }
+    if (/not-global|GLOBAL_INSTALL_UNPROVEN/i.test(raw)) {
+        return "当前 Console 由仓库内构建启动，不是全局 npm 安装，一键更新不可用。请全局安装（npm i -g @tea-agent/loop-agent）后从全局命令启动 Console 再更新，或手动更新本仓库后重启。";
+    }
+    if (/could not verify npm (?:latest|next) \(timeout\)/i.test(raw)) {
+        return "检查 npm 更新渠道超时：请确认本机网络或 npm registry 镜像可访问后重试。";
+    }
+    if (/could not verify npm (?:latest|next) \(/i.test(raw)) {
+        return "检查 npm 更新渠道失败：请确认本机 npm 可用、网络可访问 registry 后重试。";
+    }
+    for (const entry of CONTEXT_TRANSFER_CODE_COPY) {
+        if (entry.pattern.test(raw))
+            return entry.copy;
+    }
     for (const entry of MUTATION_GATE_COPY) {
         if (entry.pattern.test(raw))
             return entry.copy;

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

@@ -2,6 +2,7 @@ import { existsSync, mkdirSync, readFileSync } from "node:fs";
 import { spawn } from "node:child_process";
 import os from "node:os";
 import path from "node:path";
+import semver from "semver";
 import catalogData from "./pi-plugins.catalog.json" with { type: "json" };
 export function getPiAgentDir() {
     const envDir = process.env.PI_CODING_AGENT_DIR;
@@ -125,6 +126,62 @@ export async function listPiPluginVersions(name) {
         };
     }
 }
+/** 单个已装插件的升级判定：latest 严格大于已装版本才算有更新。 */
+export function isPluginUpgradable(installed, latest) {
+    if (!installed || !latest)
+        return false;
+    const current = semver.valid(installed);
+    const next = semver.valid(latest);
+    if (!current || !next)
+        return false;
+    return semver.gt(next, current);
+}
+/** 已装插件更新检查结果的最短缓存时长：避免前端频繁刷新打爆 registry。 */
+const UPDATES_CACHE_TTL_MS = 60_000;
+let cachedUpdates;
+/**
+ * 检查所有已安装插件的可用更新：并发拉取每个包的 dist-tags.latest，
+ * 与 node_modules 里的实际版本做 semver 比较。单包失败不阻塞其它包。
+ * TTL 内重复调用直接复用上次结果（`force: true` 可绕过）。
+ */
+export async function checkPiPluginUpdates(options) {
+    const now = options?.now ?? Date.now;
+    if (!options?.force &&
+        cachedUpdates &&
+        now() - cachedUpdates.at < UPDATES_CACHE_TTL_MS) {
+        return cachedUpdates.view;
+    }
+    const fetchPackument = options?.fetchPackument ?? listPiPluginVersions;
+    const installed = options?.listInstalled?.() ??
+        listPiPlugins()
+            .plugins.filter((p) => p.installed)
+            .map((p) => ({ name: p.name, installedVersion: p.installedVersion }));
+    const statuses = await Promise.all(installed.map(async (p) => {
+        const result = await fetchPackument(p.name);
+        if (!result.ok) {
+            return {
+                name: p.name,
+                installedVersion: p.installedVersion,
+                upgradable: false,
+                error: result.error,
+            };
+        }
+        return {
+            name: p.name,
+            installedVersion: p.installedVersion,
+            latest: result.latest,
+            upgradable: isPluginUpgradable(p.installedVersion, result.latest),
+        };
+    }));
+    const view = {
+        checked: statuses.length,
+        upgradableCount: statuses.filter((s) => s.upgradable).length,
+        checkedAt: new Date().toISOString(),
+        plugins: statuses,
+    };
+    cachedUpdates = { at: now(), view };
+    return view;
+}
 function runPi(args) {
     return new Promise((resolve) => {
         mkdirSync(getPiAgentDir(), { recursive: true });