@epoch-agent/protocol 0.7.0 → 0.7.1

package/dist/index.d.ts

@@ -3807,8 +3807,10 @@ declare const SCHEDULE_RUN_STATUSES: readonly ScheduleRunStatus[];
  * 任务注册在哪儿。
  *
  * - `schtasks` / `launchd` —— 真的注册进了操作系统的调度器，**epoch 不用开着**
- * - `host` —— 一行都没注册进 OS，宿主自己掐点调 `fire()`（方案 45 §2.6 的路 B）。
- *   **关掉宿主应用就不跑**，这句话必须原样说给用户听，不许写成「已启用」
+ * - `host` —— **一行都没注册进 OS**（方案 45 §2.6 的路 B）。到点了唤起它的只能是
+ *   宿主自己（`setInterval` 调 `fire()`）—— 而宿主有没有真的这么做，**这一格答不出来**，
+ *   它唯一承诺的事实就是「没进 OS」。所以界面上不许把它写成「已启用」，
+ *   也**不许许诺「开着就会跑」**（判据全文在 locales 的 `notice_host` 上）
  */
 type ScheduleBackendKind = 'schtasks' | 'launchd' | 'host';
 /**
@@ -12058,9 +12060,17 @@ declare const WIRE_SCHEDULE_CREATE_FIELDS: WireFields<WireScheduleCreateRequest>
 /**
  * `PATCH /api/schedules/:id` 的请求体 —— **没给的字段一个都不动**。
  *
- * ⚠️ 三个「清空」用 `null` 而不是空串：`workDir: null` 是「不绑工作区了」，
- * `workDir: ''` 说不清是「清空」还是「客户端把一个 undefined 序列化坏了」。
+ * ⚠️ **四个**「清空」用 `null` 而不是空串（`workDir` / `model` / `startDate` /
+ * `endDate`）：`workDir: null` 是「不绑工作区了」，而 `workDir: ''` 说不清是
+ * 「清空」还是「客户端把一个 undefined 序列化坏了」。
  * 同一条规矩在 `WireModelSetRequest.model` 上用过一次。
+ *
+ * ⚠️ **这个 `null` 一路走到 SQLite 的 `NULL`，中间没有第二个词。**
+ * 2026-09-07 之前 server 那一层把它翻成空串再往下递（`schedule/body.ts`），
+ * 而 core 压根不认空串是清空 —— 于是「两格生效区间都没填」被判成
+ * 「给了两个不合法的日期」，表单上冒出两行 `生效区间不对: ` 后面空着；
+ * 而那个空串真要是落进库，`isWithinWindow` 对它是 `false`，这条任务会
+ * **每次到点都被判在生效区间外**。判据全文在 `UpdateScheduleInput` 上。
  */
 interface WireScheduleUpdateRequest {
     name?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epoch-agent/protocol",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "private": false,
   "description": "epoch-agent 契约层：工具 / 事件 / 权限 / 插件的类型定义，零运行时依赖",
   "repository": {