@michengai/dsh-automation 0.1.25 → 0.1.26

package/CHANGELOG.md

@@ -4,6 +4,11 @@
 
 The five most recent published versions are listed below. Git tags and GitHub Releases now mirror these entries; historical sections retain links to their original release commits.
 
+## 0.1.26 — 2026-09-03
+
+- Updated the DSH development baseline to `0.1.2-rc.1`.
+- Read Session events through `snapshotEvents()` on current Hosts while retaining the legacy `events` fallback for older Hosts.
+
 ## 0.1.25 — 2026-09-03
 
 - Fixed scheduled-task select menus so their backgrounds, borders, shadows, and hover states follow the DSH theme. Time options now remain readable in light mode.

package/CHANGELOG.zh-CN.md

@@ -4,6 +4,11 @@
 
 以下记录最近发布的五个版本。Git 标签与 GitHub Release 现已和这些条目同步；历史条目继续保留原始发布提交链接。
 
+## 0.1.26 — 2026-09-03
+
+- 将 DSH 开发基线升级到 `0.1.2-rc.1`。
+- 当前 Host 使用 `snapshotEvents()` 读取 Session 事件，同时保留旧 Host 的 `events` 回退。
+
 ## 0.1.25 — 2026-09-03
 
 - 修复定时任务下拉菜单的背景、边框、阴影和悬停态未跟随 DSH 主题的问题，浅色模式下的时间选项恢复清晰可读。

package/lib/index.js

@@ -7,6 +7,255 @@ var __export = (target, all) => {
 // src/index.ts
 import z2 from "@deepseek-ai/schemastery";
 
+// src/executor.ts
+import { installModelSelection } from "@deepseek-ai/dsh-agent";
+import { createUserMessage } from "@deepseek-ai/dsh-llm";
+import { SessionId } from "@deepseek-ai/dsh-session";
+import { setApprovalPolicy } from "@deepseek-ai/dsh-user-approval";
+import { WorkspaceId } from "@deepseek-ai/dsh-workspace";
+
+// src/run-title.ts
+function formatRunStamp(iso) {
+  const value = new Date(iso);
+  if (Number.isNaN(value.getTime())) return iso;
+  const date5 = `${value.getFullYear()}-${String(value.getMonth() + 1).padStart(2, "0")}-${String(value.getDate()).padStart(2, "0")}`;
+  const time3 = `${String(value.getHours()).padStart(2, "0")}:${String(value.getMinutes()).padStart(2, "0")}`;
+  return `${date5} ${time3}`;
+}
+function automationSessionTitle(taskName, iso) {
+  return `${formatRunStamp(iso)} - ${taskName}`;
+}
+
+// src/executor.ts
+var UNATTENDED_TOOL_ALLOWLIST = /* @__PURE__ */ new Set([
+  "run_code",
+  "bash",
+  "pwsh",
+  "read",
+  "read_image",
+  "write",
+  "edit",
+  "str_replace_editor",
+  "glob",
+  "grep",
+  "lsp",
+  "web_search",
+  "web_fetch",
+  "skill",
+  "session_search",
+  "session_trace",
+  "session_event_read",
+  "session_event_search",
+  "session_event_trace"
+]);
+var CANCEL_CONVERGENCE_TIMEOUT_MS = 1e4;
+async function settlesWithin(promise2, timeoutMs) {
+  let timer;
+  try {
+    return await Promise.race([
+      promise2.then(() => true, () => false),
+      new Promise((resolve) => {
+        timer = setTimeout(() => resolve(false), timeoutMs);
+      })
+    ]);
+  } finally {
+    if (timer !== void 0) clearTimeout(timer);
+  }
+}
+function unattendedToolGuardReason(name2, args) {
+  if ((name2 === "bash" || name2 === "pwsh") && typeof args === "object" && args !== null && args.run_in_background === true) {
+    return "\u65E0\u4EBA\u503C\u5B88\u8FD0\u884C\u4E0D\u5141\u8BB8\u542F\u52A8\u540E\u53F0\u8FDB\u7A0B\u3002";
+  }
+  return UNATTENDED_TOOL_ALLOWLIST.has(name2) ? void 0 : `\u5DE5\u5177 '${name2}' \u4E0D\u5728\u65E0\u4EBA\u503C\u5B88\u81EA\u52A8\u5316\u5141\u8BB8\u5217\u8868\u4E2D\u3002`;
+}
+function applyUnattendedPermission(presets, session, permission) {
+  presets.set(session, permission);
+  setApprovalPolicy(session, "never");
+}
+function readSessionEvents(session) {
+  if (typeof session.snapshotEvents === "function") return session.snapshotEvents();
+  return session.events ?? [];
+}
+function summarizeRun(events, firstSeq) {
+  let started = false;
+  let text = "";
+  let reason;
+  for (const event of events) {
+    if (event.seq < firstSeq) continue;
+    if (event.type === "turn/start") {
+      started = true;
+      continue;
+    }
+    if (!started) continue;
+    if (event.type === "assistant/message") {
+      const blocks = event.data.message?.content ?? [];
+      const joined = blocks.filter((block) => block.type === "text").map((block) => block.text ?? "").join("");
+      if (joined !== "") text = joined;
+    }
+    if (event.type === "turn/end") reason = event.data.reason;
+  }
+  return { text, ...reason === void 0 ? {} : { reason } };
+}
+function boundSummary(value) {
+  const normalized = value.trim();
+  if (normalized === "") return void 0;
+  return normalized.length <= 2e3 ? normalized : `${normalized.slice(0, 1999)}\u2026`;
+}
+function reasonError(reason) {
+  if (reason === void 0) return { code: "no_turn_result", message: "\u672C\u6B21\u81EA\u52A8\u5316\u6CA1\u6709\u4EA7\u751F\u5B8C\u6574 turn\u3002" };
+  if (reason.kind === "error") {
+    return {
+      code: typeof reason.error?.code === "string" ? reason.error.code : "agent_error",
+      message: typeof reason.error?.message === "string" ? reason.error.message : "\u81EA\u52A8\u5316 Agent \u6267\u884C\u5931\u8D25\u3002"
+    };
+  }
+  return { code: `turn_${String(reason.kind)}`, message: `\u81EA\u52A8\u5316\u4EE5 ${String(reason.kind)} \u7ED3\u675F\u3002` };
+}
+async function executeAutomationRun(ctx, definition, run, config2) {
+  if (config2.signal?.aborted === true) {
+    return { status: "cancelled", error: { code: "cancelled", message: "\u81EA\u52A8\u5316\u5728\u542F\u52A8\u524D\u5DF2\u88AB\u53D6\u6D88\u3002" } };
+  }
+  const target = run.targetSnapshot;
+  const workspace = ctx.workspaceRegistry.get(WorkspaceId(target.workspaceId));
+  if (workspace === void 0) {
+    return { status: "failed", error: { code: "workspace_not_found", message: "\u76EE\u6807\u5DE5\u4F5C\u533A\u5DF2\u4E0D\u5B58\u5728\u3002" } };
+  }
+  if (await workspace.status() !== "ok" || workspace.path !== target.cwd) {
+    return { status: "failed", error: { code: "workspace_unavailable", message: "\u76EE\u6807\u5DE5\u4F5C\u533A\u76EE\u5F55\u4E0D\u53EF\u7528\u6216\u5DF2\u53D8\u66F4\u3002" } };
+  }
+  const fallbackSelection = ctx.agentDefaultModel.currentSelection();
+  const selection = target.provider !== null && target.model !== null ? {
+    provider: target.provider,
+    model: target.model,
+    ...target.reasoningEffort ? { reasoningEffort: target.reasoningEffort } : {}
+  } : fallbackSelection;
+  const sessionId = SessionId(config2.sessionId);
+  let handle;
+  let timeout;
+  let removeCancellationListener = () => {
+  };
+  try {
+    handle = await ctx.agents.withoutInitiator(() => ctx.agents.create({
+      sessionId,
+      ...config2.signal === void 0 ? {} : { signal: config2.signal },
+      meta: { cwd: target.cwd, agentPreset: target.agentPreset },
+      agentOptions: { provider: selection.provider, model: selection.model },
+      setup: async (agentCtx) => {
+        await ctx.agentPresets.mount(agentCtx, target.agentPreset);
+        installModelSelection(agentCtx, { current: selection, assembled: void 0 });
+        const agent = agentCtx.agent;
+        if (agent === void 0) throw new Error("automation setup has no scoped Agent");
+        applyUnattendedPermission(ctx.permissionPresets, agent.session, target.permissionPreset);
+        agentCtx.tools.guard((exec) => unattendedToolGuardReason(exec.name, exec.arguments));
+      }
+    }));
+    await handle.agent.whenIdle();
+    await workspace.attachSession(sessionId);
+    pinAutomationSessionTitle(ctx, handle.agent.session, automationSessionTitle(definition.name, run.startedAt ?? run.scheduledFor));
+    const firstSeq = handle.agent.session.seq;
+    handle.agent.followup(createUserMessage({
+      content: [{ type: "text", text: run.promptSnapshot }],
+      source: {
+        kind: "automation",
+        automationId: definition.id,
+        runId: run.id,
+        scheduledFor: run.scheduledFor
+      }
+    }));
+    let timedOut = false;
+    let aborted2 = false;
+    const idle = handle.agent.whenIdle();
+    const deadline = new Promise((resolve) => {
+      timeout = setTimeout(() => {
+        timedOut = true;
+        handle?.agent.cancel({ kind: "hook", reason: "automation run timeout" });
+        resolve();
+      }, config2.runTimeoutMs);
+    });
+    const cancellation = new Promise((resolve) => {
+      if (config2.signal === void 0) return;
+      const cancel = () => {
+        aborted2 = true;
+        handle?.agent.cancel({ kind: "hook", reason: "automation service disposed" });
+        resolve();
+      };
+      if (config2.signal.aborted) cancel();
+      else {
+        config2.signal.addEventListener("abort", cancel, { once: true });
+        removeCancellationListener = () => {
+          config2.signal?.removeEventListener("abort", cancel);
+        };
+      }
+    });
+    await Promise.race([idle, deadline, cancellation]);
+    removeCancellationListener();
+    if ((timedOut || aborted2) && !await settlesWithin(idle, CANCEL_CONVERGENCE_TIMEOUT_MS)) {
+      return {
+        sessionId: String(sessionId),
+        status: aborted2 ? "cancelled" : "failed",
+        error: {
+          code: "cancel_convergence_timeout",
+          message: "\u81EA\u52A8\u5316\u53D6\u6D88\u540E\u672A\u80FD\u5728\u5B89\u5168\u65F6\u9650\u5185\u505C\u6B62\u3002"
+        }
+      };
+    }
+    if (timeout !== void 0) clearTimeout(timeout);
+    await ctx.sessions.flush(handle.agent.session);
+    const outcome = summarizeRun(readSessionEvents(handle.agent.session), firstSeq);
+    const summary = boundSummary(outcome.text);
+    if (aborted2) {
+      return {
+        sessionId: String(sessionId),
+        status: "cancelled",
+        ...summary === void 0 ? {} : { summary },
+        error: { code: "cancelled", message: "\u81EA\u52A8\u5316\u56E0\u5176\u6240\u5C5E\u670D\u52A1\u505C\u6B62\u800C\u88AB\u53D6\u6D88\u3002" }
+      };
+    }
+    if (timedOut) {
+      return {
+        sessionId: String(sessionId),
+        status: "failed",
+        ...summary === void 0 ? {} : { summary },
+        error: { code: "timeout", message: "\u81EA\u52A8\u5316\u8D85\u8FC7\u6700\u5927\u8FD0\u884C\u65F6\u9650\u3002" }
+      };
+    }
+    if (outcome.reason?.kind === "completed") {
+      return { sessionId: String(sessionId), status: "succeeded", ...summary === void 0 ? {} : { summary } };
+    }
+    return {
+      sessionId: String(sessionId),
+      status: "failed",
+      ...summary === void 0 ? {} : { summary },
+      error: reasonError(outcome.reason)
+    };
+  } catch (error51) {
+    return {
+      ...handle === void 0 ? {} : { sessionId: String(sessionId) },
+      status: "failed",
+      error: {
+        code: "executor_error",
+        message: error51 instanceof Error ? error51.message : "\u81EA\u52A8\u5316\u6267\u884C\u5668\u5931\u8D25\u3002"
+      }
+    };
+  } finally {
+    removeCancellationListener();
+    if (timeout !== void 0) clearTimeout(timeout);
+    if (handle !== void 0) {
+      await settlesWithin(handle.dispose().catch(() => {
+      }), CANCEL_CONVERGENCE_TIMEOUT_MS);
+    }
+  }
+}
+function pinAutomationSessionTitle(ctx, session, title) {
+  const service = ctx.get("sessionTitle");
+  if (service === void 0 || typeof service.rename !== "function") return;
+  try {
+    service.rename(session, title);
+  } catch (error51) {
+    ctx.logger.warn(`dsh-automation: failed to pin session title: ${error51 instanceof Error ? error51.message : String(error51)}`);
+  }
+}
+
 // src/prompt.ts
 var AUTOMATION_PROMPT_NAME = "tool:automation";
 var AUTOMATION_PROMPT_ORDER = 118;
@@ -21540,251 +21789,6 @@ function positiveInteger(value, field) {
   return value;
 }
 
-// src/executor.ts
-import { installModelSelection } from "@deepseek-ai/dsh-agent";
-import { createUserMessage } from "@deepseek-ai/dsh-llm";
-import { SessionId } from "@deepseek-ai/dsh-session";
-import { setApprovalPolicy } from "@deepseek-ai/dsh-user-approval";
-import { WorkspaceId } from "@deepseek-ai/dsh-workspace";
-
-// src/run-title.ts
-function formatRunStamp(iso) {
-  const value = new Date(iso);
-  if (Number.isNaN(value.getTime())) return iso;
-  const date5 = `${value.getFullYear()}-${String(value.getMonth() + 1).padStart(2, "0")}-${String(value.getDate()).padStart(2, "0")}`;
-  const time3 = `${String(value.getHours()).padStart(2, "0")}:${String(value.getMinutes()).padStart(2, "0")}`;
-  return `${date5} ${time3}`;
-}
-function automationSessionTitle(taskName, iso) {
-  return `${formatRunStamp(iso)} - ${taskName}`;
-}
-
-// src/executor.ts
-var UNATTENDED_TOOL_ALLOWLIST = /* @__PURE__ */ new Set([
-  "run_code",
-  "bash",
-  "pwsh",
-  "read",
-  "read_image",
-  "write",
-  "edit",
-  "str_replace_editor",
-  "glob",
-  "grep",
-  "lsp",
-  "web_search",
-  "web_fetch",
-  "skill",
-  "session_search",
-  "session_trace",
-  "session_event_read",
-  "session_event_search",
-  "session_event_trace"
-]);
-var CANCEL_CONVERGENCE_TIMEOUT_MS = 1e4;
-async function settlesWithin(promise2, timeoutMs) {
-  let timer;
-  try {
-    return await Promise.race([
-      promise2.then(() => true, () => false),
-      new Promise((resolve) => {
-        timer = setTimeout(() => resolve(false), timeoutMs);
-      })
-    ]);
-  } finally {
-    if (timer !== void 0) clearTimeout(timer);
-  }
-}
-function unattendedToolGuardReason(name2, args) {
-  if ((name2 === "bash" || name2 === "pwsh") && typeof args === "object" && args !== null && args.run_in_background === true) {
-    return "\u65E0\u4EBA\u503C\u5B88\u8FD0\u884C\u4E0D\u5141\u8BB8\u542F\u52A8\u540E\u53F0\u8FDB\u7A0B\u3002";
-  }
-  return UNATTENDED_TOOL_ALLOWLIST.has(name2) ? void 0 : `\u5DE5\u5177 '${name2}' \u4E0D\u5728\u65E0\u4EBA\u503C\u5B88\u81EA\u52A8\u5316\u5141\u8BB8\u5217\u8868\u4E2D\u3002`;
-}
-function applyUnattendedPermission(presets, session, permission) {
-  presets.set(session, permission);
-  setApprovalPolicy(session, "never");
-}
-function summarizeRun(events, firstSeq) {
-  let started = false;
-  let text = "";
-  let reason;
-  for (const event of events) {
-    if (event.seq < firstSeq) continue;
-    if (event.type === "turn/start") {
-      started = true;
-      continue;
-    }
-    if (!started) continue;
-    if (event.type === "assistant/message") {
-      const blocks = event.data.message?.content ?? [];
-      const joined = blocks.filter((block) => block.type === "text").map((block) => block.text ?? "").join("");
-      if (joined !== "") text = joined;
-    }
-    if (event.type === "turn/end") reason = event.data.reason;
-  }
-  return { text, ...reason === void 0 ? {} : { reason } };
-}
-function boundSummary(value) {
-  const normalized = value.trim();
-  if (normalized === "") return void 0;
-  return normalized.length <= 2e3 ? normalized : `${normalized.slice(0, 1999)}\u2026`;
-}
-function reasonError(reason) {
-  if (reason === void 0) return { code: "no_turn_result", message: "\u672C\u6B21\u81EA\u52A8\u5316\u6CA1\u6709\u4EA7\u751F\u5B8C\u6574 turn\u3002" };
-  if (reason.kind === "error") {
-    return {
-      code: typeof reason.error?.code === "string" ? reason.error.code : "agent_error",
-      message: typeof reason.error?.message === "string" ? reason.error.message : "\u81EA\u52A8\u5316 Agent \u6267\u884C\u5931\u8D25\u3002"
-    };
-  }
-  return { code: `turn_${String(reason.kind)}`, message: `\u81EA\u52A8\u5316\u4EE5 ${String(reason.kind)} \u7ED3\u675F\u3002` };
-}
-async function executeAutomationRun(ctx, definition, run, config2) {
-  if (config2.signal?.aborted === true) {
-    return { status: "cancelled", error: { code: "cancelled", message: "\u81EA\u52A8\u5316\u5728\u542F\u52A8\u524D\u5DF2\u88AB\u53D6\u6D88\u3002" } };
-  }
-  const target = run.targetSnapshot;
-  const workspace = ctx.workspaceRegistry.get(WorkspaceId(target.workspaceId));
-  if (workspace === void 0) {
-    return { status: "failed", error: { code: "workspace_not_found", message: "\u76EE\u6807\u5DE5\u4F5C\u533A\u5DF2\u4E0D\u5B58\u5728\u3002" } };
-  }
-  if (await workspace.status() !== "ok" || workspace.path !== target.cwd) {
-    return { status: "failed", error: { code: "workspace_unavailable", message: "\u76EE\u6807\u5DE5\u4F5C\u533A\u76EE\u5F55\u4E0D\u53EF\u7528\u6216\u5DF2\u53D8\u66F4\u3002" } };
-  }
-  const fallbackSelection = ctx.agentDefaultModel.currentSelection();
-  const selection = target.provider !== null && target.model !== null ? {
-    provider: target.provider,
-    model: target.model,
-    ...target.reasoningEffort ? { reasoningEffort: target.reasoningEffort } : {}
-  } : fallbackSelection;
-  const sessionId = SessionId(config2.sessionId);
-  let handle;
-  let timeout;
-  let removeCancellationListener = () => {
-  };
-  try {
-    handle = await ctx.agents.withoutInitiator(() => ctx.agents.create({
-      sessionId,
-      ...config2.signal === void 0 ? {} : { signal: config2.signal },
-      meta: { cwd: target.cwd, agentPreset: target.agentPreset },
-      agentOptions: { provider: selection.provider, model: selection.model },
-      setup: async (agentCtx) => {
-        await ctx.agentPresets.mount(agentCtx, target.agentPreset);
-        installModelSelection(agentCtx, { current: selection, assembled: void 0 });
-        const agent = agentCtx.agent;
-        if (agent === void 0) throw new Error("automation setup has no scoped Agent");
-        applyUnattendedPermission(ctx.permissionPresets, agent.session, target.permissionPreset);
-        agentCtx.tools.guard((exec) => unattendedToolGuardReason(exec.name, exec.arguments));
-      }
-    }));
-    await handle.agent.whenIdle();
-    await workspace.attachSession(sessionId);
-    pinAutomationSessionTitle(ctx, handle.agent.session, automationSessionTitle(definition.name, run.startedAt ?? run.scheduledFor));
-    const firstSeq = handle.agent.session.seq;
-    handle.agent.followup(createUserMessage({
-      content: [{ type: "text", text: run.promptSnapshot }],
-      source: {
-        kind: "automation",
-        automationId: definition.id,
-        runId: run.id,
-        scheduledFor: run.scheduledFor
-      }
-    }));
-    let timedOut = false;
-    let aborted2 = false;
-    const idle = handle.agent.whenIdle();
-    const deadline = new Promise((resolve) => {
-      timeout = setTimeout(() => {
-        timedOut = true;
-        handle?.agent.cancel({ kind: "hook", reason: "automation run timeout" });
-        resolve();
-      }, config2.runTimeoutMs);
-    });
-    const cancellation = new Promise((resolve) => {
-      if (config2.signal === void 0) return;
-      const cancel = () => {
-        aborted2 = true;
-        handle?.agent.cancel({ kind: "hook", reason: "automation service disposed" });
-        resolve();
-      };
-      if (config2.signal.aborted) cancel();
-      else {
-        config2.signal.addEventListener("abort", cancel, { once: true });
-        removeCancellationListener = () => {
-          config2.signal?.removeEventListener("abort", cancel);
-        };
-      }
-    });
-    await Promise.race([idle, deadline, cancellation]);
-    removeCancellationListener();
-    if ((timedOut || aborted2) && !await settlesWithin(idle, CANCEL_CONVERGENCE_TIMEOUT_MS)) {
-      return {
-        sessionId: String(sessionId),
-        status: aborted2 ? "cancelled" : "failed",
-        error: {
-          code: "cancel_convergence_timeout",
-          message: "\u81EA\u52A8\u5316\u53D6\u6D88\u540E\u672A\u80FD\u5728\u5B89\u5168\u65F6\u9650\u5185\u505C\u6B62\u3002"
-        }
-      };
-    }
-    if (timeout !== void 0) clearTimeout(timeout);
-    await ctx.sessions.flush(handle.agent.session);
-    const outcome = summarizeRun(handle.agent.session.events, firstSeq);
-    const summary = boundSummary(outcome.text);
-    if (aborted2) {
-      return {
-        sessionId: String(sessionId),
-        status: "cancelled",
-        ...summary === void 0 ? {} : { summary },
-        error: { code: "cancelled", message: "\u81EA\u52A8\u5316\u56E0\u5176\u6240\u5C5E\u670D\u52A1\u505C\u6B62\u800C\u88AB\u53D6\u6D88\u3002" }
-      };
-    }
-    if (timedOut) {
-      return {
-        sessionId: String(sessionId),
-        status: "failed",
-        ...summary === void 0 ? {} : { summary },
-        error: { code: "timeout", message: "\u81EA\u52A8\u5316\u8D85\u8FC7\u6700\u5927\u8FD0\u884C\u65F6\u9650\u3002" }
-      };
-    }
-    if (outcome.reason?.kind === "completed") {
-      return { sessionId: String(sessionId), status: "succeeded", ...summary === void 0 ? {} : { summary } };
-    }
-    return {
-      sessionId: String(sessionId),
-      status: "failed",
-      ...summary === void 0 ? {} : { summary },
-      error: reasonError(outcome.reason)
-    };
-  } catch (error51) {
-    return {
-      ...handle === void 0 ? {} : { sessionId: String(sessionId) },
-      status: "failed",
-      error: {
-        code: "executor_error",
-        message: error51 instanceof Error ? error51.message : "\u81EA\u52A8\u5316\u6267\u884C\u5668\u5931\u8D25\u3002"
-      }
-    };
-  } finally {
-    removeCancellationListener();
-    if (timeout !== void 0) clearTimeout(timeout);
-    if (handle !== void 0) {
-      await settlesWithin(handle.dispose().catch(() => {
-      }), CANCEL_CONVERGENCE_TIMEOUT_MS);
-    }
-  }
-}
-function pinAutomationSessionTitle(ctx, session, title) {
-  const service = ctx.get("sessionTitle");
-  if (service === void 0 || typeof service.rename !== "function") return;
-  try {
-    service.rename(session, title);
-  } catch (error51) {
-    ctx.logger.warn(`dsh-automation: failed to pin session title: ${error51 instanceof Error ? error51.message : String(error51)}`);
-  }
-}
-
 // src/permission-presets.ts
 function normalizePermissionPreset(input, names) {
   if (typeof input !== "string") return void 0;
@@ -23079,7 +23083,7 @@ async function apply(ctx, rawConfig) {
     };
     try {
       const mountTools = (agent) => {
-        if (!alive || agentTools.has(agent) || service.ownsSession(String(agent.id), agent.session.events)) return;
+        if (!alive || agentTools.has(agent) || service.ownsSession(String(agent.id), readSessionEvents(agent.session))) return;
         if (!ctx.agents.roots().includes(agent)) return;
         const dispose = agent.ctx.effect(
           () => registerAutomationTools(service, agent),

package/lib/types/executor.d.ts

@@ -2,11 +2,15 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { PermissionPresetService } from './permission-presets.ts';
 import type { AutomationDefinition, AutomationRun } from './types.ts';
-interface SessionEventLike {
+export interface SessionEventLike {
     readonly seq: number;
     readonly type: string;
     readonly data: Record<string, any>;
 }
+interface SessionEventReader {
+    readonly events?: readonly SessionEventLike[];
+    snapshotEvents?(): readonly SessionEventLike[];
+}
 /** 对不保证及时响应 AbortSignal 的宿主任务设置第二道退出上限。 */
 export declare function settlesWithin(promise: Promise<unknown>, timeoutMs: number): Promise<boolean>;
 export declare function unattendedToolGuardReason(name: string, args: unknown): string | undefined;
@@ -26,6 +30,8 @@ export interface ExecutorConfig {
 }
 /** 先应用官方预设的完整语义，再让无人值守审批 fail-closed。 */
 export declare function applyUnattendedPermission(presets: PermissionPresetService, session: unknown, permission: AutomationDefinition['permissionPreset']): void;
+/** 优先读取新版按需快照，避免保留旧版 Session.events 的内部日志引用。 */
+export declare function readSessionEvents(session: SessionEventReader): readonly SessionEventLike[];
 export declare function summarizeRun(events: readonly SessionEventLike[], firstSeq: number): {
     readonly text: string;
     readonly reason?: Record<string, any>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-automation",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "description": "在独立 DSH Session 中按计划执行编码任务，支持 Web 设置页与 Agent 双入口管理。",
   "type": "module",
   "main": "./lib/index.js",
@@ -91,21 +91,21 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-agent": "0.1.2-alpha.5",
-    "@deepseek-ai/dsh-agent-default-model": "0.1.2-alpha.5",
-    "@deepseek-ai/dsh-agent-presets": "0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-connection": "0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-locale": "0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.2-alpha.5",
-    "@deepseek-ai/dsh-llm": "0.1.2-alpha.5",
-    "@deepseek-ai/dsh-permission-presets": "0.1.2-alpha.5",
-    "@deepseek-ai/dsh-session": "0.1.2-alpha.5",
-    "@deepseek-ai/dsh-storage-domain": "0.1.2-alpha.5",
-    "@deepseek-ai/dsh-tools": "0.1.2-alpha.5",
-    "@deepseek-ai/dsh-user-approval": "0.1.2-alpha.5",
-    "@deepseek-ai/dsh-workspace": "0.1.2-alpha.5",
+    "@deepseek-ai/dsh-agent": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-agent-default-model": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-agent-presets": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-connection": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-permission-presets": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-storage-domain": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-tools": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-user-approval": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-workspace": "0.1.2-rc.1",
     "@deepseek-ai/schemastery": "3.18.2",
     "@types/luxon": "^3.7.1",
     "@types/node": "^22.0.0",

package/docs/00-/344/272/244/346/216/245/345/205/245/345/217/243/00-/351/230/205/350/257/273/345/257/274/350/210/252.md

@@ -1,11 +0,0 @@
-# 阅读导航
-
-更新时间：2026-08-16 18:30（Asia/Shanghai）
-
-1. [项目概览](01-项目概览.md) — 先看插件定位和稳定边界。
-2. [当前状态](02-当前状态.md) — 再看当前阶段和有效风险。
-3. [待办与阻塞](03-待办与阻塞.md) — 只看尚未关闭的事项。
-4. [迭代路线图](04-迭代路线图.md) — 只看迭代顺序。
-5. [技术架构基线](05-技术架构基线.md) — 看当前生效的硬约束。
-6. [调度与执行模型](..\03-技术架构\01-调度与执行模型.md) — 看领域设计。
-7. [I001 迭代总览](..\01-当前工作\I001-任务自动化插件\00-迭代总览.md) — 看本次交付范围。

package/docs/00-/344/272/244/346/216/245/345/205/245/345/217/243/01-/351/241/271/347/233/256/346/246/202/350/247/210.md

@@ -1,22 +0,0 @@
-# 项目概览
-
-更新时间：2026-08-16 18:30（Asia/Shanghai）
-
-`@michengai/dsh-automation` 是 DeepSeek Harness Web Profile 的社区插件，用于创建独立、可审计的定时编码任务。
-
-## 当前阶段
-
-首个可安装版本：支持设置页、Agent 工具，以及单次/间隔/每天/每周计划。
-
-## 核心能力
-
-- 每次到期都创建全新 root Agent 和 Session，不继承来源对话。
-- 规则、修订号和运行历史持久化。
-- 同一条规则同时最多一个 active run；超时、重叠和 Host 中断都有明确终态。
-- 权限预设与 Chat 保持一致，完整使用 Host 提供的列表与默认值；切换到 `danger-full-access` 时显示同款风险确认。
-
-## 稳定边界
-
-- 不替代 DSH Core Schedule 的同会话提醒。
-- 不是操作系统守护进程，Host 必须正在运行。
-- 不提供 raw cron、DAG、外部通知或 worktree 生命周期。

package/docs/00-/344/272/244/346/216/245/345/205/245/345/217/243/02-/345/275/223/345/211/215/347/212/266/346/200/201.md

@@ -1,9 +0,0 @@
-# 当前状态
-
-更新时间：2026-09-03 00:00（Asia/Shanghai）
-
-- 阶段：I001 进行中，DSH peer 兼容范围为 `>=0.1.0-rc.5 <0.2.0`，开发与最高验证基线为 `0.1.2-alpha.5`。
-- 活动迭代：[I001-任务自动化插件](..\01-当前工作\I001-任务自动化插件\00-迭代总览.md)
-- 有效风险：
-  - DSH `0.1.2-alpha.5` 为当日预发布版本，已对其 41 个精确包版本配置最小发布时间例外；发布前需在真实 Web Profile 完成组合验收。
-  - Host 未运行时不会补跑历史 backlog。

package/docs/00-/344/272/244/346/216/245/345/205/245/345/217/243/03-/345/276/205/345/212/236/344/270/216/351/230/273/345/241/236.md

@@ -1,7 +0,0 @@
-# 待办与阻塞
-
-更新时间：2026-09-02 23:50（Asia/Shanghai）
-
-| 事项 | 负责人 | 优先级 | 下一步 | 解除条件 |
-| --- | --- | --- | --- | --- |
-| 真实 DSH Web alpha.5 组合验收 | 维护者 | 高 | 以本地源码安装插件，重启 DSH Web 后创建任务并立即运行 | 能加载设置页、显示 GitHub 与 Issues 入口、到期触发并打开结果 Session |

package/docs/00-/344/272/244/346/216/245/345/205/245/345/217/243/04-/350/277/255/344/273/243/350/267/257/347/272/277/345/233/276.md

@@ -1,5 +0,0 @@
-# 迭代路线图
-
-更新时间：2026-09-03 00:00（Asia/Shanghai）
-
-- I001 任务自动化插件：进行中。已交付独立 Session 调度、设置页与 Web/Agent 双入口，并完成 DSH `>=0.1.0-rc.5 <0.2.0` 兼容及 alpha.5 验证基线迁移。

package/docs/00-/344/272/244/346/216/245/345/205/245/345/217/243/05-/346/212/200/346/234/257/346/236/266/346/236/204/345/237/272/347/272/277.md

@@ -1,10 +0,0 @@
-# 技术架构基线
-
-更新时间：2026-08-16 18:30（Asia/Shanghai）
-
-- 包名：`@michengai/dsh-automation`
-- 运行时：Node.js 22.19+ / 24+，Cordis Host + DSH Web client
-- 持久化：`ctx.storageDomain`，domain 名 `dsh_automation`
-- 调度语义：at-most-once dispatch；无自动重试
-- 权限：`read-only` / `workspace-write`；审批策略 `never`
-- 构建：`scripts\build.mjs` 产出 Host ESM 与 `__ModuleLoader__` Web bundle

package/docs/00-/344/272/244/346/216/245/345/205/245/345/217/243/06-/346/226/207/346/241/243/347/274/226/345/206/231/350/247/204/350/214/203.md

@@ -1,8 +0,0 @@
-# 文档编写规范
-
-更新时间：2026-08-16 18:30（Asia/Shanghai）
-
-1. 文档使用简体中文和 UTF-8。
-2. 同一信息只保留一个权威位置。
-3. 当前工作只放未完成迭代；完成后移入 `docs\07-迭代归档`。
-4. 不创建空模板文档。

package/docs/01-/345/275/223/345/211/215/345/267/245/344/275/234/I001-/344/273/273/345/212/241/350/207/252/345/212/250/345/214/226/346/217/222/344/273/266/00-/350/277/255/344/273/243/346/200/273/350/247/210.md

@@ -1,56 +0,0 @@
-# I001 任务自动化插件
-
-- 状态：进行中
-- 负责人：维护者
-- 优先级：高
-- 更新时间：2026-09-03 00:00（Asia/Shanghai）
-
-## 目标与业务边界
-
-实现 DeepSeek Harness 的独立任务自动化：用户或 Agent 保存一条自包含任务，Host 到期后在全新 Session 中执行，并留下可审计历史。设置页提供任务列表、执行记录和新建模态。
-
-## 任务清单
-
-- [x] 领域模型、周期计算
-- [x] Service / Executor / Tools / RPC
-- [x] Web Automations 页
-- [x] 原生侧栏定时页签：包裹官方任务树，不依赖 dsh-codex-ui
-- [x] 单测与包契约
-- [x] 定时侧栏会话菜单互斥，避免点第二条时与第一条重叠
-- [x] 新建弹窗只允许选择 Host 已注册工作区，新增目录统一从 Host 工作区入口完成
-- [x] 修复任务树过滤导致的 Loading plugins / 点任务卡死
-- [x] 会话创建定时任务按官方审批策略分流，并补系统提示避免走 crontab
-- [x] 工作区标题栏对齐官方位置与搜索点击
-- [x] DSH `>=0.1.0-rc.5 <0.2.0` 兼容及 alpha.5 验证基线迁移，设置标题增加 GitHub 与 Issues 入口
-- [ ] 真实 Web Profile 组合验收
-
-## 阻塞事项
-
-无；alpha.5 预发布版本组合验收待在真实 DSH Web Profile 执行。
-
-## 验收标准
-
-1. Web 和 Agent 都能创建、列出、暂停、恢复、立即运行和删除。
-2. 到期后创建新 Session，消息 source 为 `automation`。
-4. 重启不会偷偷重跑遗留 running。
-5. 删除定义不删除运行历史。
-
-## 已完成内容
-
-仓库内已落地 Host 插件、Web 客户端、原生侧栏定时页签、文档和单测。定时会话更多菜单改为列表级互斥，并用固定定位弹出，避免两条菜单叠在一起。新建弹窗只消费 Host 已注册工作区，避免插件 RPC 自行扩大目录边界；点遮罩不再关闭。DSH peer 兼容范围为 `>=0.1.0-rc.5 <0.2.0`，开发与最高验证基线为 `0.1.2-alpha.5`；客户端仅声明旧新版本共有的注入，并在设置标题旁加入 GitHub 与 Issues 入口。
-
-## 待处理事项
-
-真实 DSH `0.1.2-alpha.5` Host 上重启 Web，验证设置页、侧栏、创建和立即运行。
-
-## 关联提交
-
-待发布 `@michengai/dsh-automation@0.1.24`。
-
-## 阅读顺序
-
-1. [项目概览](..\..\00-交接入口\01-项目概览.md)
-2. [调度与执行模型](..\..\03-技术架构\01-调度与执行模型.md)
-
-
-

package/docs/03-/346/212/200/346/234/257/346/236/266/346/236/204/00-/351/242/206/345/237/237/347/264/242/345/274/225.md

@@ -1,5 +0,0 @@
-# 技术架构索引
-
-更新时间：2026-08-16 18:30（Asia/Shanghai）
-
-1. [调度与执行模型](01-调度与执行模型.md)

package/docs/03-/346/212/200/346/234/257/346/236/266/346/236/204/01-/350/260/203/345/272/246/344/270/216/346/211/247/350/241/214/346/250/241/345/236/213.md

@@ -1,30 +0,0 @@
-# 调度与执行模型
-
-更新时间：2026-08-26（Asia/Shanghai）
-
-## 分层
-
-- Store：只保存 definition 与 run。
-- Clock：只回答下次到期时间。
-- Executor：只执行已经认领的 run。
-- Tools / RPC：只调用 service。
-- Web client：只展示快照并提交明确 mutation。
-
-## 调度
-
-- `once` / `interval` / `hourly` / `daily` / `weekly` / `monthly` / `custom` 会编译为校验过的 RRULE。
-- `interval` 最短 5 分钟，创建后不会立刻跑第一次。
-- 每天/每周/每月/自定义间隔天数使用 IANA 本地 `HH:mm`；夏令时中不存在的本地时间会被跳过。
-- 立即运行不受计划时间限制。
-
-## 恢复
-
-- 先持久化 `queued`，再创建 Agent。
-- Host 重启后，遗留 `queued`/`running` 变为 `failed(host_interrupted)`。
-- 补跑窗口默认 15 分钟，只物化最新一条 overdue occurrence。
-
-## 侧栏
-
-- 有 `dsh-codex-ui` 时只填充 `sidebar.schedule`。
-- 没有 Codex UI 时不换掉官方任务树，只在外面套「任务 / 定时」页签；官方搜索、工作区和会话菜单都保留。若存在 `sidebar.channels` 再显示「频道」。
-- 定时树按任务名称分组，子会话标题为 `YYYY-MM-DD HH:mm - 任务名`。