dsh-session-guard 0.3.0 → 0.4.0

package/CHANGELOG.ja.md

@@ -6,6 +6,45 @@
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
 
+## 3.0.0 — 2026-09-14
+
+### 変更
+
+- **DSH v0.1.5-rc.2 専用ライン（`compat/0.1.5`）。** `engines.dsh` と `dsh-client-*` の peer
+  範囲を `>=0.1.5-rc.2 <0.2.0-0` に狭めました（semver のプレリリース規則上、旧
+  `>=0.1.0-rc.7` は `0.1.5-rc.2` に一致しません）。`dsh.plugin.json` に `engines.dsh` を追加。
+  旧ホスト向けには `main` 上の 2.x / 0.2.x ラインが継続します。
+- **`session.events` → `snapshotEvents()`。** DSH 0.1.5 で `session.events` 配列アクセサが
+  削除されたため（compatibility-guide §20.3）、`pause-gate.js` はデュアルパスのヘルパーで
+  セッションイベントを読みます：まず `snapshotEvents()`、防御的に旧 `events` 配列へフォール
+  バック、どちらも無ければ `null`（fail-open）。対象は `findToolOutcome` と `lastUserPrompt`
+  のみで、イベント型のマッチングは不変です。
+
+### 変更なし
+
+- その他の接続面は一切変更なし：自前の webServer prefix ルート（`/session-guard/rpc`）、
+  `settings.register`、`settings.plugin.item` スロット、クライアント注入、
+  `llm.listConfigurableProviders()` は公開済み 0.1.5-rc.2 バンドルに対して検証済み
+  （`tools/check-api-drift.ps1`、必須アサーション 12/12）。
+
+### 未実施
+
+- 実機 DSH 0.1.5-rc.2 ホストでのライブスモーク（perm-gate の 0.1.5 ラインと同じ状態）。
+
+## 0.2.0-beta.2 — 2026-09-13
+
+### 修正（DSH 0.1.5 互換 — `compat/0.1.5` ブランチ）
+
+- **レジューム入隊のデュアルパス。** DSH 0.1.5 では Inbox が agent-loop の読み取り専用
+  投影に変わるため、`agent.followup` が存在しない可能性があります。レジューム時は
+  `agent.followup` → `agent.send` → warn 降級（例外は投げない）の順で試行します。
+- **レジュームメッセージの `source` に `form: 'instructions'` を追加**（0.1.5 の
+  `ContextFormed` 契約。旧バージョンは未知フィールドを無視します）。
+- **`webServer.register` を try/catch で保護**：ルート登録の失敗はログのみで、
+  `apply` から例外を投げてホストのプラグイン読み込みを壊しません。
+- 0.1.5-rc.2 ソースに対し `WebRoute`（exact/prefix + SSE）契約が不変であることを確認。
+  クライアントの `fetch('/session-guard/...')` に `/api` プレフィックスは不要です。
+
 ## 0.2.0-beta.1 — 2026-09-10
 
 ### 追加

package/CHANGELOG.ko.md

@@ -6,6 +6,45 @@
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
 
+## 3.0.0 — 2026-09-14
+
+### 변경
+
+- **DSH v0.1.5-rc.2 전용 라인(`compat/0.1.5`).** `engines.dsh`와 `dsh-client-*` peer 범위를
+  `>=0.1.5-rc.2 <0.2.0-0`으로 좁혔습니다(semver 프리릴리스 규칙상 기존 `>=0.1.0-rc.7`은
+  `0.1.5-rc.2`와 일치하지 않음). `dsh.plugin.json`에 `engines.dsh`를 추가했습니다. 구버전
+  호스트용으로는 `main`의 2.x / 0.2.x 라인이 계속 유지됩니다.
+- **`session.events` → `snapshotEvents()`.** DSH 0.1.5에서 `session.events` 배열 접근자가
+  제거됨에 따라(compatibility-guide §20.3) `pause-gate.js`는 듀얼 패스 헬퍼로 세션 이벤트를
+  읽습니다: 우선 `snapshotEvents()`, 방어적으로 구 `events` 배열로 폴백, 둘 다 없으면 `null`
+  (fail-open). 대상은 `findToolOutcome`과 `lastUserPrompt` 두 곳뿐이며 이벤트 타입 매칭은
+  불변입니다.
+
+### 변경 없음
+
+- 나머지 연동면은 전부 무변경: 자체 webServer prefix 라우트(`/session-guard/rpc`),
+  `settings.register`, `settings.plugin.item` 슬롯, 클라이언트 주입,
+  `llm.listConfigurableProviders()`는 공개된 0.1.5-rc.2 번들 기준으로 검증 완료
+  (`tools/check-api-drift.ps1`, 필수 어설션 12/12).
+
+### 보류
+
+- 실제 DSH 0.1.5-rc.2 호스트에서의 라이브 스모크(perm-gate 0.1.5 라인과 동일 상태).
+
+## 0.2.0-beta.2 — 2026-09-13
+
+### 수정 (DSH 0.1.5 호환 — `compat/0.1.5` 브랜치)
+
+- **재개 큐잉 듀얼 경로.** DSH 0.1.5에서는 Inbox가 agent-loop의 읽기 전용 프로젝션으로
+  바뀌어 `agent.followup`이 존재하지 않을 수 있습니다. 재개 시 `agent.followup` →
+  `agent.send` → warn 강등(예외 없음) 순으로 시도합니다.
+- **재개 메시지 `source`에 `form: 'instructions'` 추가** (0.1.5 `ContextFormed` 계약;
+  구버전은 알 수 없는 필드를 무시합니다).
+- **`webServer.register` try/catch 보호**: 라우트 등록 실패는 로그만 남기고 `apply`에서
+  예외를 던져 호스트 플러그인 로딩을 깨뜨리지 않습니다.
+- 0.1.5-rc.2 소스 기준 `WebRoute`(exact/prefix + SSE) 계약이 불변임을 확인했습니다.
+  클라이언트 `fetch('/session-guard/...')`에 `/api` 접두사는 불필요합니다.
+
 ## 0.2.0-beta.1 — 2026-09-10
 
 ### 추가

package/CHANGELOG.md

@@ -6,6 +6,47 @@ All notable changes to `dsh-session-guard` are recorded here. Versions follow se
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
 
+## 3.0.0 — 2026-09-14
+
+### Changed
+
+- **DSH v0.1.5-rc.2 dedicated line (`compat/0.1.5`).** `engines.dsh` and the `dsh-client-*`
+  peer ranges narrow to `>=0.1.5-rc.2 <0.2.0-0` (strict-semver prerelease matching means the
+  old `>=0.1.0-rc.7` range never matches `0.1.5-rc.2`); `dsh.plugin.json` gains `engines.dsh`.
+  The 2.x / 0.2.x line on `main` keeps serving DSH 0.1.0-rc.7 … 0.1.2-rc.1.
+- **`session.events` → `snapshotEvents()`.** DSH 0.1.5 removed the `session.events` array
+  accessor (compatibility-guide §20.3). `pause-gate.js` now reads session events through a
+  dual-path helper: `snapshotEvents()` first, the legacy `events` array as a defensive
+  fallback, `null` (fail-open) when neither exists. Affects `findToolOutcome` and
+  `lastUserPrompt` only; event-type matching is unchanged.
+
+### Unchanged
+
+- Zero changes on every other integration seam: the self-held webServer prefix route
+  (`/session-guard/rpc`), `settings.register`, the `settings.plugin.item` card slot,
+  client injections, and `llm.listConfigurableProviders()` are all verified intact against
+  the published 0.1.5-rc.2 bundle (`tools/check-api-drift.ps1`, 12/12 required assertions).
+
+### Pending
+
+- Live smoke on a real DSH 0.1.5-rc.2 host (same status as the perm-gate 0.1.5 line).
+
+## 0.2.0-beta.2 — 2026-09-13
+
+### Fixed (DSH 0.1.5 compat — `compat/0.1.5` branch)
+
+- **Dual-path resume enqueue.** DSH 0.1.5 turns the Inbox into an agent-loop read-only
+  projection, so `agent.followup` may no longer exist. The resume flow now tries
+  `agent.followup` first, falls back to `agent.send`, and degrades to a warn (never throws)
+  when neither is available — a failed enqueue can no longer break resume.
+- **Resume messages carry `source.form: 'instructions'`** per the 0.1.5 `ContextFormed`
+  message-source contract (`kind: 'plugin'` is a built-in kind; older DSH versions ignore
+  the extra field).
+- **`webServer.register` is wrapped in try/catch**: a failed route registration now logs an
+  error instead of throwing out of `apply` and breaking host plugin loading.
+- Verified against the 0.1.5-rc.2 source: the `WebRoute` contract (exact/prefix + SSE) is
+  unchanged, so client `fetch('/session-guard/...')` paths need no `/api` prefix.
+
 ## 0.2.0-beta.1 — 2026-09-10
 
 ### Added

package/INSTALL.ja.md

@@ -22,9 +22,12 @@ dsh --version
 ## 1. インストール
 
 ```bash
-dsh plugin --profile web add github:drscrewdriver/dsh-session-guard
+dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5#compat/0.1.5
 ```
 
+`compat/0.1.5` は DSH `0.1.5-rc.x` 専用ライン（3.x、`engines.dsh: >=0.1.5-rc.2 <0.2.0-0`）。`main` は
+引き続き DSH `0.1.0-rc.7` – `0.1.2-rc.1`（2.x / 0.2.x）を担当します。
+
 dsh web を再起動し、ページをリフレッシュ。
 
 ## 2. 検証
@@ -52,7 +55,7 @@ npm test
 
 ```bash
 dsh plugin --profile web remove dsh-session-guard
-dsh plugin --profile web add github:drscrewdriver/dsh-session-guard
+dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
 ```
 
 dsh web を再起動しページをリフレッシュ。設定は `$DSH_HOME/settings.yaml` の `session-guard`

package/INSTALL.ko.md

@@ -22,9 +22,12 @@ dsh --version
 ## 1. 설치
 
 ```bash
-dsh plugin --profile web add github:drscrewdriver/dsh-session-guard
+dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5#compat/0.1.5
 ```
 
+`compat/0.1.5`는 DSH `0.1.5-rc.x` 전용 라인(3.x, `engines.dsh: >=0.1.5-rc.2 <0.2.0-0`)입니다. `main`은
+계속 DSH `0.1.0-rc.7` – `0.1.2-rc.1`(2.x / 0.2.x)을 담당합니다.
+
 dsh web을 재시작하고 페이지를 새로고침.
 
 ## 2. 검증
@@ -52,7 +55,7 @@ npm test
 
 ```bash
 dsh plugin --profile web remove dsh-session-guard
-dsh plugin --profile web add github:drscrewdriver/dsh-session-guard
+dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
 ```
 
 dsh web을 재시작하고 페이지를 새로고침. 설정은 `$DSH_HOME/settings.yaml`의 `session-guard`

package/INSTALL.md

@@ -24,9 +24,12 @@ dsh --version
 ## 1. Install
 
 ```bash
-dsh plugin --profile web add github:drscrewdriver/dsh-session-guard
+dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
 ```
 
+`compat/0.1.5` is the DSH `0.1.5-rc.x` line (3.x, `engines.dsh: >=0.1.5-rc.2 <0.2.0-0`); `main` keeps
+serving DSH `0.1.0-rc.7` – `0.1.2-rc.1` (2.x / 0.2.x).
+
 Restart dsh web and refresh the page.
 
 ## 2. Verify
@@ -55,7 +58,7 @@ npm test
 
 ```bash
 dsh plugin --profile web remove dsh-session-guard
-dsh plugin --profile web add github:drscrewdriver/dsh-session-guard
+dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
 ```
 
 Restart dsh web and refresh the page. Settings live in `$DSH_HOME/settings.yaml` under the

package/INSTALL.zh.md

@@ -22,9 +22,12 @@ dsh --version
 ## 1. 安装
 
 ```bash
-dsh plugin --profile web add github:drscrewdriver/dsh-session-guard
+dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5#compat/0.1.5
 ```
 
+`compat/0.1.5` 是 DSH `0.1.5-rc.x` 专线（3.x，`engines.dsh: >=0.1.5-rc.2 <0.2.0-0`）；`main` 继续服务
+DSH `0.1.0-rc.7` – `0.1.2-rc.1`（2.x / 0.2.x）。
+
 重启 dsh web 并刷新页面。
 
 ## 2. 验证
@@ -52,7 +55,7 @@ npm test
 
 ```bash
 dsh plugin --profile web remove dsh-session-guard
-dsh plugin --profile web add github:drscrewdriver/dsh-session-guard
+dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
 ```
 
 重启 dsh web 并刷新页面。设置在 `$DSH_HOME/settings.yaml` 的 `session-guard` 命名空间下，升级不会丢；

package/README.en.md

@@ -30,22 +30,38 @@
 >
 > | DSH version | Load | Settings registration | Session events / gate | Client half |
 > | --- | --- | --- | --- | --- |
-> | 0.1.0-rc.7 ~ 0.1.1-rc.x | ✅ | `ctx.settings.register(ns, schema, { base })` | ✅ same shape | ✅ no platform value imports |
-> | 0.1.2-alpha.2+ / 0.1.2-rc.1 | ✅ | `register` still present (`installSection` added) | ✅ same shape | ✅ no platform value imports |
-> | 0.1.3+ / 0.1.5-alpha.1 | APIs still present (unverified) | `register` unchanged | ✅ | ✅ |
+> | 0.1.0-rc.7 ~ 0.1.1-rc.x | ✅ (2.x / 0.2.x line) | `ctx.settings.register(ns, schema, { base })` | ✅ same shape | ✅ no platform value imports |
+> | 0.1.2-alpha.2+ / 0.1.2-rc.1 | ✅ (2.x / 0.2.x line) | `register` still present (`installSection` added) | ✅ same shape | ✅ no platform value imports |
+> | **0.1.5-rc.2** | ✅ (**3.x dedicated line `compat/0.1.5`**) | `register` unchanged (string namespaces) | ✅ events read via `snapshotEvents()` dual path | ✅ |
 >
-> One artifact covers both. `session/event`, `agent.cancel`, `goals.pause`,
+> **3.x is the 0.1.5 dedicated line**: engines/peers narrow to `>=0.1.5-rc.2 <0.2.0-0`;
+> 0.1.0-rc.7~0.1.2 hosts should stay on the 2.x / 0.2.x line (`main`).
+> **0.1.5 adaptation (compat/0.1.5 branch, v3.0.0)**:
+> ① dual-path resume enqueue — 0.1.5 turns Inbox into an agent-loop read-only projection;
+> if `agent.followup` is gone the plugin falls back to `agent.send`, and degrades to a warn
+> (never throws) when neither exists; ② resume messages now carry
+> `source.form: 'instructions'` (0.1.5 ContextFormed contract; older versions ignore it);
+> ③ `webServer.register` is wrapped in try/catch so a failed registration only logs instead
+> of breaking host loading; ④ 0.1.5 removes the `session.events` array accessor — events are
+> now read via `snapshotEvents()` (legacy array kept as fallback), affecting only the
+> `findToolOutcome` / `lastUserPrompt` helper paths.
+> Verified that 0.1.5 `WebRoute` (exact/prefix + SSE) contract is
+> unchanged — client `fetch('/session-guard/...')` needs no `/api` prefix.
+> The 2.x-line table (one artifact, both versions) is kept below. `session/event`, `agent.cancel`, `goals.pause`,
 > `agent.followup`, `commands.register`, `timer.interval`, `webServer.register`,
 > `agent/request`, `llm.listConfigurableProviders` and `settings.register/get`
 > are signature-identical between `dsh-v0.1.1-rc.2` and `dsh-v0.1.2-rc.1`
-> (verified through `0.1.5-alpha.1`). The one
+> (3.x verified against `dsh-v0.1.5-rc.2`). The one
 > seam that needs a dual read is the `tool/result` call id (`content[].toolCallId`
 > first, `source.callId` as fallback) — both forms appear in replay logs of both
 > versions. It now lives in `src/tool-call-id.js` with unit tests.
+> Since 0.1.5 the `session.events` array accessor is removed; 3.x reads events
+> through `snapshotEvents()` (with the legacy array as fallback), affecting only
+> the `findToolOutcome` / `lastUserPrompt` helper paths.
 > The `model/selection` event exists **only on 0.1.2+** and is feature-probed; the
 > settings surface uses only the `register` + `get` intersection (never
 > `installSection`, never the removed `installSettingsSection`). Drift guard:
-> `tools/check-api-drift.ps1`.
+> `tools/check-api-drift.ps1` (3.x defaults to asserting against `dsh-v0.1.5-rc.2`).
 
 > Automatically pause running sessions during peak pricing hours and resume during off-peak/weekend; pair with input-traffic's freeze button for **per-session** locking; backend **auto-retry** yields during freeze/gate. Core based on a custom session gate (`agent.cancel keepInbox + goals.pause + session/event safe boundary + followup resume`), no longer depending on dsh-task-control.
 
@@ -66,9 +82,12 @@ A cordis plugin assembled via the `dsh plugin` command and a bundle patch — no
 ## Installation
 
 ```bash
-dsh plugin --profile web add github:<owner>/dsh-session-guard
+dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
 ```
 
+`compat/0.1.5` is the DSH `0.1.5-rc.x` line (3.x); `main` keeps serving DSH `0.1.0-rc.7` – `0.1.2-rc.1`
+(2.x / 0.2.x).
+
 Restart dsh web and refresh the page after installation.
 
 ## Settings (Settings → Plugins → session-guard, simple toggles)

package/README.ja.md

@@ -45,9 +45,11 @@
 ## インストール
 
 ```bash
-dsh plugin --profile web add github:<owner>/dsh-session-guard
+dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
 ```
 
+`compat/0.1.5` は DSH `0.1.5-rc.x` 専用ライン（3.x）。`main` は引き続き DSH `0.1.0-rc.7` – `0.1.2-rc.1`（2.x / 0.2.x）を担当します。
+
 インストール後 dsh web を再起動し、ページをリフレッシュ。
 
 ## 設定（設定 → プラグイン → session-guard）

package/README.ko.md

@@ -45,9 +45,11 @@
 ## 설치
 
 ```bash
-dsh plugin --profile web add github:<owner>/dsh-session-guard
+dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
 ```
 
+`compat/0.1.5`는 DSH `0.1.5-rc.x` 전용 라인(3.x)입니다. `main`은 계속 DSH `0.1.0-rc.7` – `0.1.2-rc.1`(2.x / 0.2.x)을 담당합니다.
+
 설치 후 dsh web을 재시작하고 페이지를 새로고침.
 
 ## 설정 (설정 → 플러그인 → session-guard)

package/README.md

@@ -32,19 +32,31 @@
 >
 > | DSH 版本 | 加载 | 设置注册 | 会话事件 / 会话门 | 客户端半 |
 > | --- | --- | --- | --- | --- |
-> | 0.1.0-rc.7 ~ 0.1.1-rc.x | ✅ | `ctx.settings.register(ns, schema, { base })` | ✅ 形状一致 | ✅ 无平台值导入 |
-> | 0.1.2-alpha.2+ / 0.1.2-rc.1 | ✅ | `register` 仍保留（另加 `installSection`） | ✅ 形状一致 | ✅ 无平台值导入 |
-> | 0.1.3+ / 0.1.5-alpha.1 | 接口仍在（未验证） | `register` 仍在（行号未变） | ✅ | ✅ |
+> | 0.1.0-rc.7 ~ 0.1.1-rc.x | ✅（2.x / 0.2.x 线） | `ctx.settings.register(ns, schema, { base })` | ✅ 形状一致 | ✅ 无平台值导入 |
+> | 0.1.2-alpha.2+ / 0.1.2-rc.1 | ✅（2.x / 0.2.x 线） | `register` 仍保留（另加 `installSection`） | ✅ 形状一致 | ✅ 无平台值导入 |
+> | **0.1.5-rc.2** | ✅（**3.x 专线 `compat/0.1.5`**） | `register` 仍在（字符串命名空间） | ✅ 事件经 `snapshotEvents()` 双路径读取 | ✅ |
 >
-> 一份产物同时支持两版本。`session/event`、`agent.cancel`、`goals.pause`、
+> **3.x 为 0.1.5 专线**：engines/peer 收窄为 `>=0.1.5-rc.2 <0.2.0-0`，0.1.0-rc.7~0.1.2 宿主请继续使用 2.x / 0.2.x 线（`main`）。
+> **0.1.5 适配（compat/0.1.5 分支，v3.0.0）**：
+> ① `agent.followup` 双路径——0.1.5 将 Inbox 改为 agent-loop 只读投影，若 `followup`
+> 不再存在则回退 `agent.send`，两者皆无时 warn 降级不抛错（恢复续跑的兜底）；
+> ② 恢复消息 `source` 补 `form: 'instructions'`（0.1.5 ContextFormed 契约，旧版本忽略）；
+> ③ `webServer.register` 包 try/catch，注册失败仅记日志不炸宿主加载；
+> ④ 0.1.5 移除 `session.events` 数组访问器，事件读取改为 `snapshotEvents()` 主路径 +
+> 旧数组回退（仅影响 `findToolOutcome` / `lastUserPrompt` 两条辅助路径，事件类型匹配不变）。
+> 已核实 0.1.5 的 `WebRoute`（exact/prefix + SSE）契约不变，客户端
+> `fetch('/session-guard/...')` 无需改 `/api` 前缀。
+> 2.x 线的旧表（一份产物双版本）保留如下。`session/event`、`agent.cancel`、`goals.pause`、
 > `agent.followup`、`commands.register`、`timer.interval`、`webServer.register`、
 > `agent/request`、`llm.listConfigurableProviders`、`settings.register/get` 在
-> `dsh-v0.1.1-rc.2` 与 `dsh-v0.1.2-rc.1` 之间签名一致（并已核到 `0.1.5-alpha.1`）；
+> `dsh-v0.1.1-rc.2` 与 `dsh-v0.1.2-rc.1` 之间签名一致（3.x 已核到 `dsh-v0.1.5-rc.2`）；
 > 唯一需要双读的是 `tool/result` 记录的调用 id 形态（`content[].toolCallId` 优先、
 > `source.callId` 回退），已抽到 `src/tool-call-id.js` 并配单测——两版本的回放日志都可能出现这两种形态。
+> 0.1.5 起 `session.events` 数组访问器被移除，3.x 经 `snapshotEvents()`（保留旧数组回退）读取，
+> 只影响 `findToolOutcome` / `lastUserPrompt` 两条辅助路径。
 > `model/selection` 事件**仅 0.1.2+**，只做切模型加速且必须特性探测；设置面只用
 > `register` + `get` 交集（不碰 `installSection` / 已移除的 `installSettingsSection`）。
-> 漂移守卫脚本：`tools/check-api-drift.ps1`（对四个 tag 断言必需接口存在）。
+> 漂移守卫脚本：`tools/check-api-drift.ps1`（3.x 默认对 `dsh-v0.1.5-rc.2` 断言必需接口存在）。
 
 > 高峰时段自动暂停运行中的会话、低峰/周末自动续跑；配合 input-traffic 的冻结按钮做到**会话级**锁定；后端**自动重试**在冻结/门控期间让路。核心基于**自研会话门**（`agent.cancel keepInbox + goals.pause + session/event 安全边界 + followup 续跑`），不再依赖 dsh-task-control。
 
@@ -74,9 +86,11 @@
 ## 安装
 
 ```bash
-dsh plugin --profile web add github:<owner>/dsh-session-guard
+dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
 ```
 
+`compat/0.1.5` 是 DSH `0.1.5-rc.x` 专线（3.x）；`main` 继续服务 DSH `0.1.0-rc.7` – `0.1.2-rc.1`（2.x / 0.2.x）。
+
 装后重启 dsh web 并刷新页面。
 
 ## 设置（设置 → 插件 → session-guard，简单开关）

package/dsh.plugin.json

@@ -1,8 +1,11 @@
 {
   "id": "dsh-external/dsh-session-guard",
-  "version": "0.2.0-beta.1",
+  "version": "3.0.0",
   "main": "./src/index.js",
   "description": "高峰自动会话门：step 级门控 + 周末模式 + 高峰自动暂停 + 官方源二维判定 + 会话级冻结 + 后端自动重试。",
+  "engines": {
+    "dsh": ">=0.1.5-rc.2 <0.2.0-0"
+  },
   "contributes": {
     "tools": [],
     "skills": []

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "dsh-session-guard",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public",
-    "tag": "dsh-0.1.2"
+    "tag": "dsh-0.1.5"
   },
   "type": "module",
   "description": "高峰自动会话门：周末模式 + 高峰自动暂停 + 官方源二维判定 + 会话级冻结 + 后端自动重试。",
@@ -23,9 +23,9 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/drscrewdriver/session-guard.git"
+    "url": "git+https://github.com/drscrewdriver/dsh-session-guard.git"
   },
-  "homepage": "https://github.com/drscrewdriver/session-guard",
+  "homepage": "https://github.com/drscrewdriver/dsh-session-guard",
   "main": "src/index.js",
   "exports": {
     ".": "./src/index.js",
@@ -70,16 +70,16 @@
   },
   "engines": {
     "node": ">=20",
-    "dsh": ">=0.1.0-rc.7 <0.2.0-0"
+    "dsh": ">=0.1.5-rc.2 <0.2.0-0"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-locale": ">=0.1.0-rc.7 <0.2.0-0",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.7 <0.2.0-0",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.7 <0.2.0-0"
+    "@deepseek-ai/dsh-client-locale": ">=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.5-rc.2 <0.2.0-0"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {

package/src/index.js

@@ -220,8 +220,12 @@ export function apply(ctx) {
   tick()
 
   // ── HTTP 路由 ──
+  // 0.1.5 compat：注册失败只记日志，不让 apply 抛错炸掉宿主插件加载（#5926 教训）。
+  // webServer.register 前缀路由 + SSE 在 0.1.5 契约不变（packages/host/webserver WebRoute）。
   if (ctx.webServer && typeof ctx.webServer.register === 'function') {
-    ctx.effect(() => ctx.webServer.register({
+    ctx.effect(() => {
+      try {
+        return ctx.webServer.register({
       kind: 'prefix',
       path: '/session-guard',
       handler: async (req, res) => {
@@ -400,6 +404,10 @@ export function apply(ctx) {
           res.end(JSON.stringify({ ok: false, error: String(e && e.message || e) }))
         }
       },
-    }), 'session-guard: routes')
+      })
+      } catch (e) {
+        ctx.logger?.error?.(`[session-guard] webServer.register failed (routes disabled): ${String(e && e.message || e)}`)
+      }
+    }, 'session-guard: routes')
   }
 }

package/src/pause-gate.js

@@ -46,6 +46,36 @@ export function createPluginUserMessage({ content, source }) {
   return { id, role: 'user', content, source }
 }
 
+/**
+ * 恢复消息入队（0.1.5 compat 双路径）。
+ *
+ * 0.1.5 把 Inbox 从独立服务改为 agent-loop 只读投影（消息入队走 session 事件），
+ * `agent.followup` 是否保留无法静态确认，因此运行时检测：
+ * 1. `agent.followup(msg)` —— ≤0.1.4 与（若保留的）0.1.5 首选路径；
+ * 2. `agent.send(msg)` —— followup 被移除时的回退；
+ * 3. 两者皆无 —— 记 warn 并返回 false，绝不让 resume 因入队失败而抛错。
+ * @param {object} agent 目标 agent（live agent）
+ * @param {{id: string, role: 'user', content: unknown, source: object}} message 本地构造的 user 消息
+ * @param {object} [ctx] host context（仅用于 logger）
+ * @returns {boolean} 是否成功入队
+ */
+export function enqueueFollowup(agent, message, ctx) {
+  if (typeof agent.followup === 'function') {
+    agent.followup(message)
+    return true
+  }
+  if (typeof agent.send === 'function') {
+    agent.send(message)
+    return true
+  }
+  try {
+    ctx?.logger?.warn?.('[session-guard] agent has no followup/send; resume message dropped')
+  } catch {
+    /* logger 不可用时静默 */
+  }
+  return false
+}
+
 /**
  * @param {object} deps
  * @param {object} deps.ctx host context（含 agents.get / get / logger，可选 goals）
@@ -132,11 +162,31 @@ export function createPauseGate({ ctx, pauseStore, pluginId = 'session-guard', m
    * 两种形态在 DSH 0.1.1-rc.2 与 0.1.2-rc.1 的回放日志里都保留，勿改成单读。
    */
 
+  /**
+   * 读取会话事件数组。DSH 0.1.5 移除了 `session.events` 数组访问器，改为
+   * `snapshotEvents()`（compatibility-guide §20.3 实测表）；本专线以
+   * snapshotEvents() 为主，events 数组仅作回退防御，两者皆缺时返回 null
+   * （fail-open，与既有防御语义一致）。
+   */
+  function readSessionEvents(session) {
+    if (!session) return null
+    if (typeof session.snapshotEvents === 'function') {
+      try {
+        const events = session.snapshotEvents()
+        return Array.isArray(events) ? events : null
+      } catch {
+        return null
+      }
+    }
+    return Array.isArray(session.events) ? session.events : null
+  }
+
   /** 在 session log 查一个中断工具的实际结果（kernel 会 drain 已启动工具到 tool/result）。 */
   function findToolOutcome(agent, callId) {
-    if (!agent?.session?.events) return null
+    const events = readSessionEvents(agent?.session)
+    if (!events) return null
     let outcome = null
-    for (const event of agent.session.events) {
+    for (const event of events) {
       if (event.type === 'tool/result') {
         const message = event.data?.message ?? {}
         const block = (Array.isArray(message.content) ? message.content : []).find((b) => b?.type === 'tool-result')
@@ -162,9 +212,10 @@ export function createPauseGate({ ctx, pauseStore, pluginId = 'session-guard', m
   }
 
   function lastUserPrompt(agent) {
-    if (!agent?.session?.events) return null
-    for (let index = agent.session.events.length - 1; index >= 0; index -= 1) {
-      const event = agent.session.events[index]
+    const events = readSessionEvents(agent?.session)
+    if (!events) return null
+    for (let index = events.length - 1; index >= 0; index -= 1) {
+      const event = events[index]
       if (event.type !== 'user/message') continue
       if (event.data?.source?.kind !== 'user') continue
       return event.data.content ?? null
@@ -286,7 +337,8 @@ export function createPauseGate({ ctx, pauseStore, pluginId = 'session-guard', m
     state.pendingPause.delete(sessionId)
     const current = currentPause(sessionId)
     if (!current.paused) return { kind: 'success', text: 'no paused task to resume' }
-    const followup = (blocks) => agent.followup(makeFollowupMessage({ content: blocks, source: { kind: 'plugin', plugin: pluginId } }))
+    // 0.1.5 compat：source 补 form: 'instructions'（0.1.5 ContextFormed 契约；旧版本忽略未知字段）
+    const followup = (blocks) => enqueueFollowup(agent, makeFollowupMessage({ content: blocks, source: { kind: 'plugin', plugin: pluginId, form: 'instructions' } }), ctx)
 
     if (current.forced) {
       const tool = current.interruptedTool