@epoch-agent/server 0.7.0 → 0.7.1

package/README.md

@@ -254,8 +254,17 @@ sessionId 就是方案 30 §9.5 那条 bug 的形状 —— 编译得过、跑
 
 **录像那一条不再脱敏一次**：脱敏在落盘那一刻就做完了（core 的 `redactLine`，
 跑在已经序列化过的一整行上）。在这一层补一道会让下一个人以为盘上那一份是干净的
-—— 而盘上那一份才是真正会被 `cat` 的那份。帧数超过 `MAX_RECORDING_FRAMES`
-（4000）时截断 + `truncated: true`，界面必须把它画出来。
+—— 而盘上那一份才是真正会被 `cat` 的那份。
+
+发出去之前**先把流式增量折回消息**（core 的 `coalesceRecording`）：盘上是一个
+`text-delta` 一帧，几千个输出 token 就是几千帧，而这些帧在运行结束之后没有独立
+含义（渲染那侧只是把它们拼成一段正文）。折完之后一帧 ≈ 一段正文 / 一次工具调用，
+`MAX_RECORDING_FRAMES`（4000）这把尺子才量得到真东西 —— **它量的是折叠之后的帧数**。
+
+超了就截断 + `truncated: true`，界面必须把它画出来。⚠️ **截掉的是开头，留的是
+尾巴**（`slice(-N)`）：一次运行里人要看的正是那句结论和 `finish` 那一帧上的账，
+而留头去尾会让正文断在半句话上 —— 屏幕上那半截自己不会说「我是半截的」
+（判据同 protocol 的 `NoticeCode: 'response-truncated'`）。
 
 ⚠️ 这一组借的是 `WebRuntimeView.schedules`（`ScheduleControlView`，
 结构镜像在 [src/schedule/view.ts](./src/schedule/view.ts)）。判定、注册进 OS、

package/dist/index.d.ts

@@ -2666,8 +2666,26 @@ interface ScheduleCreateView {
     endDate?: string;
     enabled?: boolean;
 }
-/** 改一条任务 —— core 的 `UpdateScheduleInput`。没给的字段一个都不动 */
-type ScheduleUpdateView = Partial<ScheduleCreateView>;
+/**
+ * 改一条任务 —— core 的 `UpdateScheduleInput`。没给的字段一个都不动。
+ *
+ * ⚠️ **四格收 `null` = 清空这一格**，和网线上那份（`WireScheduleUpdateRequest`）
+ * 逐字段对得上。别写成 `Partial<ScheduleCreateView>`（2026-09-07 之前就是那样）：
+ * 那一版比真身**窄**，而窄的方向 TS 不报 —— 入参是逆变的，一个「什么都收得下」
+ * 的真身赋给一个「只收 string」的镜像永远合法。于是这一层压根表达不出「清空」，
+ * `schedule/body.ts` 只好把 `null` 翻成空串往下递，而 core 从来不认空串是清空。
+ * 那次的表现是：表单上两格生效区间都没填，保存却报两行「生效区间不对: 」。
+ *
+ * 也就是说**这一格的正确性没有编译器守着**，只有这段注释和用例。判据全文在
+ * core 的 `UpdateScheduleInput` 上。
+ */
+type ScheduleUpdateView = Partial<Omit<ScheduleCreateView, 'workDir' | 'model' | 'startDate' | 'endDate'>> & {
+    /** `null` = 不绑工作区了 → 落回 `~/.epoch/automation/<id>/`（runtime 那一层解析） */
+    workDir?: string | null;
+    model?: string | null;
+    startDate?: string | null;
+    endDate?: string | null;
+};
 /** 存下来了没有 —— core / runtime 的 `ScheduleSaveResult` */
 interface ScheduleSaveView {
     /** 校验不过时 `undefined`，且库里一个字都没写 */
@@ -4884,12 +4902,17 @@ declare function collectTasks(sessionId: string, registry: TaskRegistryView): Wi
  */
 
 /**
- * 一份录像最多回多少帧。
+ * 一份录像最多回多少帧 —— **折叠之后的帧**。
+ *
+ * 一次跑飞的运行能写出几万帧，整份推给浏览器会让那个标签页卡死。超了就截断 +
+ * `truncated: true` —— **必须说出来**，判据同 `WireSkillBodyResponse.truncated`：
+ * 一份看起来完整、其实少了后半截的回放，比一句「太长了没给全」坏得多。
  *
- * 一次跑飞的运行能写出几万帧（每个 `text-delta` 一帧），整份推给浏览器会让
- * 那个标签页卡死。超了就截断 + `truncated: true` —— **必须说出来**，
- * 判据同 `WireSkillBodyResponse.truncated`：一份看起来完整、其实少了后半截的
- * 回放，比一句「太长了没给全」坏得多。
+ * ⚠️ **这把尺子量的是折叠之后的帧数**（2026-09-07 改准）。原来量的是盘上的原始
+ * 帧数，而盘上「每个 `text-delta` 一帧」—— 于是几千个输出 token 就是几千帧，
+ * **一次正常的多轮任务**（实测：27 轮、0.016 美元）就撞上了这道闸门。
+ * 折叠在 core 的 `coalesceRecording` 里，折完一帧 ≈ 一段正文 / 一次工具调用，
+ * 4000 才重新是「一次真正巨大的运行」的意思。
  */
 declare const MAX_RECORDING_FRAMES = 4000;
 /**

package/dist/index.js

@@ -1,5 +1,5 @@
 import { createServer } from 'http';
-import { t, ApprovalRelay, QuestionRelay, serializeStream, withRoleScope, withModelScope, withToolScope, nextRunAt, skillIndexDescription, SANDBOX_EXCLUDES, SANDBOX_COVERS, isSystemOpenable, backgroundTaskOutput, listBackgroundTasks, providerLabel, MAX_REASON_CHARS, MAX_OBJECTIVE_CHARS, MAX_GOAL_MAX_ROUNDS, DEFAULT_GOAL_MAX_ROUNDS, SCHEDULE_DEFAULT_ALLOWLIST, SCHEDULE_DEFAULTS, readRecording } from '@epoch-agent/runtime';
+import { t, ApprovalRelay, QuestionRelay, serializeStream, withRoleScope, withModelScope, withToolScope, nextRunAt, skillIndexDescription, SANDBOX_EXCLUDES, SANDBOX_COVERS, isSystemOpenable, backgroundTaskOutput, listBackgroundTasks, providerLabel, MAX_REASON_CHARS, MAX_OBJECTIVE_CHARS, MAX_GOAL_MAX_ROUNDS, DEFAULT_GOAL_MAX_ROUNDS, SCHEDULE_DEFAULT_ALLOWLIST, SCHEDULE_DEFAULTS, coalesceRecording, readRecording } from '@epoch-agent/runtime';
 import { timingSafeEqual, randomBytes } from 'crypto';
 import { PLAN_OUTCOMES, WIRE_AUTH_COOKIE, WIRE_AUTH_COOKIE_ATTRS, WIRE_AUTH_TOKEN_PARAM, extractAllMentions, MAX_ATTACH_FILES, utf8ByteLength, MAX_SESSION_REFS, attachSessionSurface, isWireRewindScope, WIRE_REWIND_SCOPES, MAX_ATTACH_TOTAL_BYTES, MAX_ATTACH_BYTES, WIRE_LANG_PARAM, isLang, isQuestionAnswerMap, isProviderType, apiKeyEnvVar, WIRE_FILE_STAT_MAX, WIRE_SETTING_WRITE_LAYERS, isWirePlanAction, WIRE_PLAN_ACTIONS, isPermissionLevel, PERMISSION_LEVELS, collectPendingApprovals, unfixedRules, isWireSettingWriteLayer, parseModelRef, WIRE_GOAL_ACTIONS, OPERATION_TYPES, isOperationType } from '@epoch-agent/protocol';
 import { resolve, join, relative, isAbsolute, sep, dirname, basename, extname } from 'path';
@@ -2855,21 +2855,28 @@ function numberList(value) {
   }
   return out;
 }
-function optionals(raw, lang) {
+var CLEARABLE = ["model", "workDir", "startDate", "endDate"];
+function optionals(raw, allowClear, lang) {
   const out = {};
-  for (const key of ["name", "prompt", "model", "workDir", "startDate", "endDate"]) {
+  const bad = (field) => ({
+    ok: false,
+    message: t("web.schedule_bad_field", { field }, lang)
+  });
+  for (const key of ["name", "prompt"]) {
+    const value = raw[key];
+    if (value === void 0) continue;
+    if (typeof value !== "string") return bad(key);
+    out[key] = value;
+  }
+  for (const key of CLEARABLE) {
     const value = raw[key];
     if (value === void 0) continue;
     if (value === null) {
-      if (key === "name" || key === "prompt") {
-        return { ok: false, message: t("web.schedule_bad_field", { field: key }, lang) };
-      }
-      out[key] = "";
+      if (!allowClear) return bad(key);
+      out[key] = null;
       continue;
     }
-    if (typeof value !== "string") {
-      return { ok: false, message: t("web.schedule_bad_field", { field: key }, lang) };
-    }
+    if (typeof value !== "string") return bad(key);
     out[key] = value;
   }
   for (const key of ["maxTurns", "maxBudgetUsd", "timeoutMs"]) {
@@ -2939,7 +2946,7 @@ function parseCreate2(body, lang) {
     return { ok: false, message: t("web.schedule_bad_trigger", void 0, lang) };
   if (budget === null)
     return { ok: false, message: t("web.schedule_budget_required", void 0, lang) };
-  const rest = optionals(raw, lang);
+  const rest = optionals(raw, false, lang);
   if (!rest.ok) return rest;
   return {
     ok: true,
@@ -2947,7 +2954,7 @@ function parseCreate2(body, lang) {
   };
 }
 function parseUpdate2(body, lang) {
-  return optionals(asRecord(body), lang);
+  return optionals(asRecord(body), true, lang);
 }
 function parseFix(body, lang) {
   const runId = asRecord(body)["runId"];
@@ -3105,14 +3112,14 @@ function toRecording(run) {
   if (run.logPath === void 0) {
     return { runId: run.id, frames: [], missing: true, truncated: false };
   }
-  const frames = readRecording(run.logPath);
+  const frames = coalesceRecording(readRecording(run.logPath));
   if (frames.length === 0) {
     return { runId: run.id, frames: [], missing: true, truncated: false };
   }
   const truncated = frames.length > MAX_RECORDING_FRAMES;
   return {
     runId: run.id,
-    frames: truncated ? frames.slice(0, MAX_RECORDING_FRAMES) : frames,
+    frames: truncated ? frames.slice(-MAX_RECORDING_FRAMES) : frames,
     missing: false,
     truncated
   };