niceeval 0.10.0 → 0.10.2

package/src/sandbox/e2b.ts

@@ -14,7 +14,11 @@ import type {
   SourceFiles,
   ReadSourceFilesOptions,
 } from "../types.ts";
-import { classifyProvisionErrorFallback, type SandboxProvisionErrorKind } from "./errors.ts";
+import {
+  classifyProvisionErrorFallback,
+  isRetryableProvisionError,
+  type SandboxProvisionErrorKind,
+} from "./errors.ts";
 import { classifySandboxIoError } from "./errors.ts";
 import { readSourceFilesByList } from "./source-files.ts";
 import { collectLocalFiles } from "./local-files.ts";
@@ -30,6 +34,13 @@ const DEFAULT_COMMAND_TIMEOUT_MS = 600_000;
 const SESSION_TIMEOUT_MS = 1_800_000;
 
 /** e2b 的限流错误是 SDK 原生的 RateLimitError(HTTP 429 映射而来);见 resolve.ts 的 withProvisionRetry。 */
+// 对账本身只有一次机会:retry.ts 的 withProvisionRetry 对账失败就直接放弃重试、抛回原始
+// create() 错误(见那边的注释)。对账走的这次 list 请求跟刚失败的 create() 往往挨得很近,
+// 大概率处在同一段网络抖动里——不给它自己的重试,一次瞬时失败就会把本可能自愈的 attempt
+// 判死。这里给 nextItems() 单独包一层短重试,只吃与 create() 侧同一套分类下的瞬时错误。
+const RECONCILE_LIST_MAX_ATTEMPTS = 3;
+const RECONCILE_LIST_RETRY_DELAY_MS = 500;
+
 /**
  * Provisioning 重试前的对账:按 metadata 里的 provision token 检索远端实例,查到即 kill。
  * 检索或销毁失败必须抛出——对账是重试的硬前置,静默放行等于盲重试,会复制计费实例
@@ -43,7 +54,7 @@ export async function reconcileProvision(token: string): Promise<void> {
   // 命中的实例数极少,通常一页打完。
   const paginator = E2BSdkSandbox.list({ apiKey, query: { metadata: { "niceeval-provision-token": token } } });
   while (paginator.hasNext) {
-    const sandboxes = await paginator.nextItems();
+    const sandboxes = await fetchNextItemsWithRetry(paginator);
     for (const info of sandboxes) {
       try {
         await E2BSdkSandbox.kill(info.sandboxId, { apiKey });
@@ -54,6 +65,31 @@ export async function reconcileProvision(token: string): Promise<void> {
   }
 }
 
+/**
+ * `nextItems()` 按类型契约总是 resolve 成数组(SDK 内部对空响应也兜了 `?? []`),但对账这条
+ * 路径线上真实撞见过它 resolve 成非数组的一次——没能复现出确切成因,不排它,原样让下面的
+ * `for...of` 抛出,但换一句能定位的诊断,而不是留一条裸的 "X is not iterable"。
+ */
+async function fetchNextItemsWithRetry(
+  paginator: ReturnType<typeof E2BSdkSandbox.list>,
+): Promise<Awaited<ReturnType<typeof paginator.nextItems>>> {
+  for (let attempt = 0; ; attempt += 1) {
+    try {
+      const items = await paginator.nextItems();
+      if (!Array.isArray(items)) {
+        throw new Error(
+          `e2b Sandbox.list() 分页器 nextItems() 返回了非数组(${typeof items}),不是 SDK 类型契约里的 SandboxInfo[]`,
+        );
+      }
+      return items;
+    } catch (e) {
+      const kind = classifyProvisionErrorFallback(e);
+      if (attempt >= RECONCILE_LIST_MAX_ATTEMPTS - 1 || !isRetryableProvisionError(kind)) throw e;
+      await new Promise((resolve) => setTimeout(resolve, RECONCILE_LIST_RETRY_DELAY_MS * 2 ** attempt));
+    }
+  }
+}
+
 export function classifyProvisionError(e: unknown): SandboxProvisionErrorKind {
   // SDK 原生限流先归拒绝类;没认出的过与文件 IO 共用的保守瞬时兜底分类器
   // (真实跑分里出现过 create 阶段 `fetch failed · other side closed`,属歧义类)。

package/src/view/view-report.test.ts

@@ -577,7 +577,7 @@ describe("buildView · attempt/<locator>.html", () => {
     expect(existsSync(join(out, "attempt", `${droppedLocator}.html`))).toBe(false);
   });
 
-  it("直接读取该文档(无 JavaScript 场景)即可见完整内容:身份/verdict/断言/时间树/diagnostics/usage/对话/trace/diff 都在可见的 en 区块里,不藏在 hidden 或 <template> 里(cases.md 第 206 行)", async () => {
+  it("直接读取该文档即可见完整内容(cases.md Attempt 参数化 page);样式与视觉归 e2e 报告域,不在本层断言", async () => {
     const root = await makeRoot();
     const writer = createResultsWriter(root, { producer: { name: "niceeval", version: "1.0.0" } });
     const snap = await writer.snapshot({ experimentId: "compare/bub", agent: "bub", startedAt: "2026-07-01T08:00:00.000Z" });
@@ -642,5 +642,7 @@ describe("buildView · attempt/<locator>.html", () => {
     ]) {
       expect(enBlock, needle).toContain(needle);
     }
+    // 有 source 时对话住在源码行内,不再渲染独立 AttemptConversation。
+    expect(enBlock).not.toContain("nre-attempt-conversation");
   });
 });