dsh-subagent-profile 0.3.3 → 0.4.0

package/lib/core/profile-directory.mjs

@@ -0,0 +1,139 @@
+// lib/core/profile-directory.mjs — 派发方案目录的单一数据源。
+// profileSectionText（模型可见段）与 profileSnapshotOf（决策轨迹记录面）都从
+// 本模块的 profileDirectoryRows 派生，构造保证「模型看到 ≡ 记录面」的 id、顺序与
+// 字段集。未来 F 数据层注入 avg_cost / success_rate 只改这里一处。
+//
+// 仅依赖 lib/core/pure.mjs（tierSortKey）；无 @deepseek-ai 依赖，可被 bare-CI
+// 单测直接 import。
+
+import { tierSortKey } from './pure.mjs';
+
+// 决策输入快照阈值：profiles_snapshot 条目数与 description 截断长度。
+const MAX_PROFILE_SNAPSHOT_ENTRIES = 6;
+const PROFILE_DESC_CHARS = 80;
+
+function snapshotEntry(row, maxDesc) {
+  const description = typeof row.description === 'string' ? row.description : '';
+  return {
+    id: row.id,
+    ...(description !== '' ? { description: description.length > maxDesc ? `${description.slice(0, maxDesc)}…` : description } : {}),
+    ...(typeof row.preset === 'string' && row.preset !== '' ? { preset: row.preset } : {}),
+    ...(typeof row.model === 'string' && row.model !== '' ? { model: row.model } : {}),
+    ...(typeof row.provider === 'string' && row.provider !== '' ? { provider: row.provider } : {}),
+    ...(typeof row.tokenTier === 'string' && row.tokenTier !== '' ? { tokenTier: row.tokenTier } : {}),
+    ...(typeof row.avgCost === 'number' && Number.isFinite(row.avgCost) ? { avgCost: row.avgCost } : {}),
+    ...(typeof row.successRate === 'number' && Number.isFinite(row.successRate) ? { successRate: row.successRate } : {}),
+  };
+}
+
+// 模型可见 profile 目录快照：输入为 profileDirectoryRows 的结构化行。description
+// 截断、条目数截到 maxEntries；chosenId 超出 maxEntries 时并入该条并打
+// chosenOutsideSnapshot（37b：截断不得制造审计空洞）。
+export function profileSnapshotOf(profiles, { maxEntries = MAX_PROFILE_SNAPSHOT_ENTRIES, maxDesc = PROFILE_DESC_CHARS, chosenId } = {}) {
+  const list = Array.isArray(profiles) ? profiles : [];
+  const full = [];
+  for (const row of list) {
+    if (row === null || typeof row !== 'object' || typeof row.id !== 'string' || row.id === '') continue;
+    if (row.enabled === false) continue;
+    full.push(snapshotEntry(row, maxDesc));
+  }
+  const entries = full.slice(0, maxEntries);
+  let truncated = full.length > maxEntries;
+  if (typeof chosenId === 'string' && chosenId !== '' && chosenId !== '(inline)' && !entries.some((e) => e.id === chosenId)) {
+    const chosen = full.find((e) => e.id === chosenId);
+    if (chosen !== undefined) {
+      entries.push({ ...chosen, chosenOutsideSnapshot: true });
+      truncated = true;
+    }
+  }
+  return { entries, truncated, total: full.length };
+}
+
+// store 兼容 createProfileStore 返回形态（含 profiles Map）；也接受数组（测试与
+// 非标准调用方）。只保留启用且 id 合法的方案；按 tokenTier cheap-first 稳定排序，
+// tier 相同按 id 升序（确定性，不依赖 Map 插入序的跨运行差异）。
+export function profileDirectoryRows(store) {
+  const source = store !== null && typeof store === 'object' && store.profiles !== undefined
+    ? [...store.profiles.values()]
+    : (Array.isArray(store) ? store : []);
+  return source
+    .filter((p) => p !== null && typeof p === 'object' && typeof p.id === 'string' && p.id !== '' && p.enabled !== false)
+    .sort((a, b) => tierSortKey(a.tokenTier) - tierSortKey(b.tokenTier) || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0))
+    .map((p) => ({
+      id: p.id,
+      description: typeof p.description === 'string' ? p.description : '',
+      ...(typeof p.preset === 'string' && p.preset !== '' ? { preset: p.preset } : {}),
+      ...(typeof p.model === 'string' && p.model !== '' ? { model: p.model } : {}),
+      ...(typeof p.provider === 'string' && p.provider !== '' ? { provider: p.provider } : {}),
+      ...(typeof p.tokenTier === 'string' && p.tokenTier !== '' ? { tokenTier: p.tokenTier } : {}),
+      ...(typeof p.avgCost === 'number' && Number.isFinite(p.avgCost) ? { avgCost: p.avgCost } : {}),
+      ...(typeof p.successRate === 'number' && Number.isFinite(p.successRate) ? { successRate: p.successRate } : {}),
+    }));
+}
+
+
+// 从 summaries.json 的 l1/l2 聚合为每个 profile 提取 { avgCost, successRate, n }。
+// 匹配优先级：profile.model → L2 model 轴；profile.preset → L2 preset 轴。多个 L1
+// 组共享同一轴值时按成本与部署量合并（avg_cost = Σestimated_cost / Σpriced；
+// successRate = Σcompleted / Σdeployments）。无数据返回 null，调用方省略显示。
+export function profileStatsFromSummaries(store, summaries) {
+  const rows = profileDirectoryRows(store);
+  const l2 = summaries !== null && typeof summaries === 'object' && summaries.l2 !== null && typeof summaries.l2 === 'object' ? summaries.l2 : {};
+  const byModel = new Map();
+  const byPreset = new Map();
+  for (const [key, group] of Object.entries(l2)) {
+    if (group === null || typeof group !== 'object') continue;
+    const modelMatch = /:model:([^|]+)$/.exec(key);
+    if (modelMatch) {
+      const arr = byModel.get(modelMatch[1]) ?? [];
+      arr.push(group);
+      byModel.set(modelMatch[1], arr);
+      continue;
+    }
+    const presetMatch = /:preset:([^|]+)$/.exec(key);
+    if (presetMatch) {
+      const arr = byPreset.get(presetMatch[1]) ?? [];
+      arr.push(group);
+      byPreset.set(presetMatch[1], arr);
+    }
+  }
+  const merge = (groups) => {
+    let deployments = 0;
+    let completed = 0;
+    let priced = 0;
+    let cost = 0;
+    for (const g of groups) {
+      deployments += Number.isFinite(g.deployments_total) ? g.deployments_total : 0;
+      completed += Number.isFinite(g.outcome?.completed) ? g.outcome.completed : 0;
+      priced += Number.isFinite(g.cost?.priced) ? g.cost.priced : 0;
+      cost += Number.isFinite(g.cost?.estimated_cost) ? g.cost.estimated_cost : 0;
+    }
+    if (deployments <= 0 && priced <= 0) return null;
+    return {
+      avgCost: priced > 0 ? Number((cost / priced).toFixed(4)) : null,
+      successRate: deployments > 0 ? Number((completed / deployments).toFixed(3)) : null,
+      n: deployments,
+    };
+  };
+  const out = new Map();
+  for (const row of rows) {
+    let stats = null;
+    if (typeof row.model === 'string' && row.model !== '') stats = merge(byModel.get(row.model) ?? []);
+    if (stats === null && typeof row.preset === 'string' && row.preset !== '') stats = merge(byPreset.get(row.preset) ?? []);
+    if (stats !== null) out.set(row.id, stats);
+  }
+  return out;
+}
+
+// 用 stats map 为目录行补 avgCost/successRate（F 数据层 join）。stats 为
+// profileStatsFromSummaries 的返回值；行上已有 avgCost/successRate 时优先保留
+// 显式值（store 侧/测试注入），stats 只补缺失。
+export function applyProfileStats(rows, stats) {
+  const map = stats instanceof Map ? stats : new Map(Object.entries(stats ?? {}));
+  return rows.map((row) => ({
+    ...row,
+    ...(row.avgCost === undefined && map.get(row.id)?.avgCost !== null && map.get(row.id)?.avgCost !== undefined ? { avgCost: map.get(row.id).avgCost } : {}),
+    ...(row.successRate === undefined && map.get(row.id)?.successRate !== null && map.get(row.id)?.successRate !== undefined ? { successRate: map.get(row.id).successRate } : {}),
+    ...(map.get(row.id)?.n !== undefined ? { n: map.get(row.id).n } : {}),
+  }));
+}

package/lib/core/profile-provider.mjs

@@ -30,6 +30,7 @@ import { computeEffectiveAllow } from './intersection.mjs';
 import { resolveWhitelist } from './whitelist.mjs';
 import { assertCostGuard } from './cost-guard.mjs';
 import { DELEGATION_CONTEXT, buildDispatchMeta } from './delegation.mjs';
+import { readSessionEvents } from './session-read.mjs';
 
 // --- start 预检段（从 start 拆出）-------------------------------------------------
 
@@ -154,13 +155,14 @@ async function setupChild(childCtx, { parent, profile, swapPreset, delegated, re
       return { ...resolved, reasoningEffort: profile.reasoningEffort };
     });
   }
-  // ⑥ Descriptor append inside the child's first turn（M4：descriptor 非空才 append）。
+  // ⑥ Descriptor append inside the child's first turn（descriptor 存在才 append；
+  // 核心注入的是对象（snapshotJsonValue 快照），早期版本为字符串，故只判存在不判类型）。
   let appended = false;
   childCtx.on('agent/pre-step', async ({ agent }, next) => {
     const decision = await next();
     if (!appended && decision.kind === 'enter') {
       appended = true;
-      if (typeof request.descriptor === 'string' && request.descriptor !== '') agent.session.append('subagent/descriptor', request.descriptor);
+      if (request.descriptor !== undefined && request.descriptor !== null) agent.session.append('subagent/descriptor', request.descriptor);
     }
     return decision;
   });
@@ -194,7 +196,7 @@ function restrictChildTools(childCtx, parent, profile) {
 // 已取消时 result 闭包跳过 followup。
 function wireChildLifecycle(handle, request, childId, swapPreset, profile, logger) {
   const child = handle.agent;
-  const boundary = child.session.events.length;
+  const boundary = readSessionEvents(child.session).length;
   const flags = { cancelled: false };
   const onAbort = () => {
     flags.cancelled = true;

package/lib/core/profiles-store.mjs

@@ -166,12 +166,20 @@ function persistProfiles(state, logger) {
 }
 
 // 插件开关态（state.json）：enabled（默认开，禁用即关派发工具）+ evolutionAdvice
-// （只读建议注入，默认关，需显式开）+ escapeEnabled（逃生舱放行，默认关——信任
-// 底板，仅设置页显式 opt-in 可放开）。三开关共用同一 state.json，读写整份对象
-// 以互不覆盖；缺失文件回退默认值（全新部署），损坏文件 fail-closed（三开关全关，
-// 绝不静默回退 enabled:true —— 安全禁用会被撤销），内存态仍驱动本进程。
-const STATE_DEFAULTS = { enabled: true, evolutionAdvice: false, escapeEnabled: false };
-const STATE_FAIL_CLOSED = { enabled: false, evolutionAdvice: false, escapeEnabled: false };
+// （派发优化建议注入，默认关，需显式开）+ escapeEnabled（逃生舱放行，默认关——信任
+// 底板，仅设置页显式 opt-in 可放开）+ applyEnabled（进化候选生成与应用写路径，默认
+// 关——应用能力只由人显式开启）+ candidateMode/candidateTtlH（候选方案更新策略与
+// 有效期，用户可配置）。开关共用同一 state.json，读写整份对象以互不覆盖；
+// 缺失文件回退默认值（全新部署），损坏文件 fail-closed（全关，绝不静默回退
+// enabled:true —— 安全禁用会被撤销），内存态仍驱动本进程。
+const STATE_DEFAULTS = { enabled: true, evolutionAdvice: false, escapeEnabled: false, applyEnabled: false, candidateMode: 'auto', candidateTtlH: 24 };
+const STATE_FAIL_CLOSED = { enabled: false, evolutionAdvice: false, escapeEnabled: false, applyEnabled: false, candidateMode: 'auto', candidateTtlH: 24 };
+
+// 候选有效期小时数归一：0（不自动过期）或 1~8760（一年内）的整数原样保留，
+// 其余值回退默认 24 小时（读取与写入共用同一口径，防坏值落盘）。
+function validCandidateTtlH(value) {
+  return typeof value === 'number' && Number.isInteger(value) && (value === 0 || (value >= 1 && value <= 8760)) ? value : 24;
+}
 
 function loadState(state) {
   if (!existsSync(state.stateFile)) return { ...STATE_DEFAULTS };
@@ -182,6 +190,9 @@ function loadState(state) {
       enabled: parsed.enabled !== false,
       evolutionAdvice: parsed.evolutionAdvice === true,
       escapeEnabled: parsed.escapeEnabled === true,
+      applyEnabled: parsed.applyEnabled === true,
+      candidateMode: parsed.candidateMode === 'manual' ? 'manual' : 'auto',
+      candidateTtlH: validCandidateTtlH(parsed.candidateTtlH),
     };
   } catch (error) {
     // fail-closed（S2）：损坏的 state.json 若回退 enabled:true，会把「安全禁用」静默撤销。
@@ -246,6 +257,13 @@ export function createProfileStore({ dshHome, logger, onGovernanceFailure = () =
     persistEvolutionAdvice: (value) => persistState(state, { evolutionAdvice: value === true }, onGovernanceFailure),
     loadEscapeEnabled: () => loadState(state).escapeEnabled,
     persistEscapeEnabled: (value) => persistState(state, { escapeEnabled: value === true }, onGovernanceFailure),
+    loadApplyEnabled: () => loadState(state).applyEnabled,
+    persistApplyEnabled: (value) => persistState(state, { applyEnabled: value === true }, onGovernanceFailure),
+    // 候选更新策略与有效期（state.json 同源读写，坏值归一默认）。
+    loadCandidateMode: () => loadState(state).candidateMode,
+    persistCandidateMode: (value) => persistState(state, { candidateMode: value === 'manual' ? 'manual' : 'auto' }, onGovernanceFailure),
+    loadCandidateTtlH: () => loadState(state).candidateTtlH,
+    persistCandidateTtlH: (value) => persistState(state, { candidateTtlH: validCandidateTtlH(value) }, onGovernanceFailure),
     // getAllowFailOpen：cost guard 必须在派发时读取迁移标志；
     // loadProfiles/persistProfiles 持有该写入。
     getAllowFailOpen: () => state.allowFailOpen,

package/lib/core/reminder-store.mjs

@@ -0,0 +1,172 @@
+// lib/core/reminder-store.mjs — 提醒系统 host 侧 store + 审计同源。
+// 一条提醒 = 一条治理审计记录（经 audit 钩子写入 governance-audit.jsonl，与 [6] 审计
+// 同源）；每个用户动作（采纳/忽略/拒绝/关闭）与「标记已读」都追加审计留痕。P0 三要件：
+// severity 上色（P0 由 client 用错误色渲染）、常驻至已读（unread 标记，绝不自动消失）、
+// 带 session 标识（sessionId 字段；全局异常显式 null，client 标注「全局」）。
+// 隐私红线：只落结构字段（severity/kind/title/detail/sessionId/时间戳）与「未采纳」
+// 条目的展示字段（子会话 id/模式、prompt 摘要 ≤200 字符、结算摘要结构、估算成本）。
+// prompt 摘要不存原文，结算摘要无子输出正文；其余提醒类不携带这些字段（null）。
+// 落盘 subagent-evolution/reminders.json（原子写 tmp+rename；损坏/形状不符
+// fail-soft 从空起步）。import-free（仅 node 内置），可被裸 CI 单测。
+
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+
+const SEVERITIES = new Set(['P0', 'P1', 'P2']);
+const MAX_REMINDERS = 200;
+
+function isRecordShape(rec) {
+  return rec !== null && typeof rec === 'object' && typeof rec.id === 'string'
+    && typeof rec.severity === 'string' && typeof rec.kind === 'string'
+    && typeof rec.title === 'string' && typeof rec.detail === 'string';
+}
+
+// 结算摘要形状守卫（宽松）：只接受非数组对象，具体字段逐个归一。
+function isSettleShape(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+function normalizeSettled(value) {
+  if (!isSettleShape(value)) return null;
+  return {
+    stopReason: typeof value.stopReason === 'string' ? value.stopReason : '',
+    elapsedMs: Number.isFinite(value.elapsedMs) ? value.elapsedMs : null,
+    ...(Number.isFinite(value.childTotalTokens) ? { childTotalTokens: value.childTotalTokens } : {}),
+    ...(isSettleShape(value.childUsage) ? { childUsage: value.childUsage } : {}),
+    ...(typeof value.childSessionId === 'string' && value.childSessionId !== '' ? { childSessionId: value.childSessionId } : {}),
+  };
+}
+
+function loadState(stateFile, state, warn) {
+  if (stateFile === undefined) return;
+  try {
+    if (!existsSync(stateFile)) return;
+    const parsed = JSON.parse(readFileSync(stateFile, 'utf8'));
+    if (parsed === null || typeof parsed !== 'object' || parsed.v !== 1 || !Array.isArray(parsed.reminders)) {
+      warn('reminder store: 提醒文件版本或形状不符，从空状态起步');
+      return;
+    }
+    for (const raw of parsed.reminders) {
+      if (!isRecordShape(raw)) continue;
+      state.reminders.push({
+        id: raw.id,
+        severity: SEVERITIES.has(raw.severity) ? raw.severity : 'P2',
+        kind: raw.kind,
+        title: raw.title,
+        detail: raw.detail,
+        sessionId: typeof raw.sessionId === 'string' && raw.sessionId !== '' ? raw.sessionId : null,
+        childId: typeof raw.childId === 'string' && raw.childId !== '' ? raw.childId : null,
+        childSessionId: typeof raw.childSessionId === 'string' && raw.childSessionId !== '' ? raw.childSessionId : null,
+        childMode: typeof raw.childMode === 'string' && raw.childMode !== '' ? raw.childMode : null,
+        promptExcerpt: typeof raw.promptExcerpt === 'string' ? raw.promptExcerpt : '',
+        settled: normalizeSettled(raw.settled),
+        costEstimated: Number.isFinite(raw.costEstimated) ? raw.costEstimated : null,
+        unread: raw.unread !== false,
+        createdAt: Number.isFinite(raw.createdAt) ? raw.createdAt : 0,
+        action: typeof raw.action === 'string' ? raw.action : null,
+        actedAt: Number.isFinite(raw.actedAt) ? raw.actedAt : null,
+      });
+    }
+  } catch (error) {
+    warn('reminder store: 提醒文件读取失败，从空状态起步（' + (error instanceof Error ? error.message : String(error)) + '）');
+  }
+}
+
+function persistState(stateFile, state, warn) {
+  if (stateFile === undefined) return;
+  const tmp = stateFile + '.tmp';
+  try {
+    mkdirSync(dirname(stateFile), { recursive: true });
+    writeFileSync(tmp, JSON.stringify({ v: 1, reminders: state.reminders }, null, 2), 'utf8');
+    renameSync(tmp, stateFile);
+  } catch (error) {
+    try { rmSync(tmp, { force: true }); } catch { /* best effort */ }
+    warn('reminder store: 提醒文件写入失败（' + (error instanceof Error ? error.message : String(error)) + '）');
+  }
+}
+
+function auditReminder(audit, kind, reminder, action) {
+  audit({
+    kind,
+    reminderId: reminder.id,
+    severity: reminder.severity,
+    reminderKind: reminder.kind,
+    ...(reminder.sessionId !== null ? { sessionId: reminder.sessionId } : {}),
+    ...(action !== undefined ? { action } : {}),
+  });
+}
+
+// 产生一条提醒：severity 非法回退 P2；空 sessionId 归一 null（全局）。「未采纳」
+// 条目额外携带子会话 id/模式、prompt 摘要（≤200 字符再截一次防超）、结算摘要与估算
+// 成本；其余提醒类这些字段为空/null。创建即审计。
+function recordReminder(state, persist, audit, { severity, kind, title, detail, sessionId, childId, childSessionId, childMode, promptExcerpt, settled, costEstimated }) {
+  const reminder = {
+    id: 'r-' + Date.now() + '-' + Math.random().toString(36).slice(2, 8),
+    severity: SEVERITIES.has(severity) ? severity : 'P2',
+    kind: typeof kind === 'string' && kind !== '' ? kind : 'event',
+    title: typeof title === 'string' ? title : '',
+    detail: typeof detail === 'string' ? detail : '',
+    sessionId: typeof sessionId === 'string' && sessionId !== '' ? sessionId : null,
+    childId: typeof childId === 'string' && childId !== '' ? childId : null,
+    childSessionId: typeof childSessionId === 'string' && childSessionId !== '' ? childSessionId : null,
+    childMode: typeof childMode === 'string' && childMode !== '' ? childMode : null,
+    promptExcerpt: typeof promptExcerpt === 'string' ? promptExcerpt.slice(0, 200) : '',
+    settled: normalizeSettled(settled),
+    costEstimated: Number.isFinite(costEstimated) ? costEstimated : null,
+    unread: true,
+    createdAt: Date.now(),
+    action: null,
+    actedAt: null,
+  };
+  state.reminders.push(reminder);
+  if (state.reminders.length > state.maxReminders) state.reminders.shift();
+  persist();
+  auditReminder(audit, 'reminder-created', reminder);
+  return reminder;
+}
+
+// 标记已读（unread=false）：P0 角标常驻至已读的「已读」动作，逐条留痕。
+function ackReminders(state, persist, audit, ids) {
+  const list = Array.isArray(ids) ? ids : [];
+  const acked = [];
+  for (const reminder of state.reminders) {
+    if (reminder.unread !== true || !list.includes(reminder.id)) continue;
+    reminder.unread = false;
+    acked.push(reminder.id);
+    auditReminder(audit, 'reminder-acked', reminder);
+  }
+  if (acked.length > 0) persist();
+  return acked;
+}
+
+// 用户动作（采纳/忽略/拒绝/关闭）：互斥终态 + 审计留痕（关闭留痕要求）。
+function actOnReminder(state, persist, audit, id, action) {
+  const reminder = state.reminders.find((r) => r.id === id);
+  if (reminder === undefined) return false;
+  if (action !== 'adopt' && action !== 'ignore' && action !== 'reject' && action !== 'dismiss') return false;
+  reminder.action = action;
+  reminder.actedAt = Date.now();
+  reminder.unread = false;
+  persist();
+  auditReminder(audit, 'reminder-action', reminder, action);
+  return true;
+}
+
+function listReminders(state, unreadOnly) {
+  const all = [...state.reminders].reverse();
+  return unreadOnly ? all.filter((r) => r.unread === true) : all;
+}
+
+export function createReminderStore({ dshHome, audit = () => {}, warn = () => {}, maxReminders = MAX_REMINDERS } = {}) {
+  const state = { reminders: [], maxReminders: Number.isFinite(maxReminders) && maxReminders > 0 ? maxReminders : MAX_REMINDERS };
+  const stateFile = dshHome !== undefined && dshHome !== '' ? join(dshHome, 'subagent-evolution', 'reminders.json') : undefined;
+  loadState(stateFile, state, warn);
+  const persist = () => persistState(stateFile, state, warn);
+  return {
+    record: (entry) => recordReminder(state, persist, audit, entry),
+    ack: (ids) => ackReminders(state, persist, audit, ids),
+    actOn: (id, action) => actOnReminder(state, persist, audit, id, action),
+    list: ({ unreadOnly = false } = {}) => listReminders(state, unreadOnly),
+    unreadCount: () => state.reminders.filter((r) => r.unread === true).length,
+  };
+}

package/lib/core/session-read.mjs

@@ -0,0 +1,17 @@
+// lib/core/session-read.mjs — 会话事件统一读取口（双轨兼容）。
+//
+// 读取会话事件的两个不兼容环境：
+//   * 稳定线：session.events 是数组（本插件当前发布环境的形状）；
+//   * 新线：session.events 属性被移除，改为按需读取 session.snapshotEvents()。
+// 直接改成新 API 会让稳定线崩溃；直接保留旧读法会在新线崩溃。因此本 helper
+// 逐次 feature-detect：events 数组优先，snapshotEvents() 其次，两轨都不可用
+// 时返回空数组（fall-soft，绝不抛出）。
+//
+// 返回语义：稳定线分支返回 session.events 原数组引用（不拷贝），保持既有
+// identity 语义与零开销；新线分支返回 snapshotEvents() 的返回值（默认全量快照）。
+export function readSessionEvents(session) {
+  if (session === null || session === undefined) return [];
+  if (Array.isArray(session.events)) return session.events;
+  if (typeof session.snapshotEvents === 'function') return session.snapshotEvents();
+  return [];
+}

package/lib/core/shims.mjs

@@ -23,6 +23,7 @@ import { createRequire } from 'node:module';
 // 导出缺失会在 apply 能运行之前就以明确错误中止模块加载——这正是本类存在的隔离。
 import { assertSubagentMaxDepth, resolveChildDepth } from '@deepseek-ai/dsh-subagent';
 import { toStopReason } from './pure.mjs';
+import { readSessionEvents } from './session-read.mjs';
 
 // warn：模块顶层没有 ctx / logger，降级用 console.warn。
 // 前缀让来源在共享宿主日志中可辨认。
@@ -162,7 +163,7 @@ const [foldConsumedWork, finalAssistantOutput, createUserMessage, appendDelegate
 // finalAssistantOutput（最后一个非空 assistant/message，否则拼接的 text-delta
 // 分片，再否则 undefined -> []）。
 function readResult(child, boundary, cancelled) {
-  const own = child.session.events.slice(boundary);
+  const own = readSessionEvents(child.session).slice(boundary);
   const end = foldConsumedWork(own).end;
   const recorded = toStopReason(end?.data.reason);
   const stopReason = cancelled && recorded !== 'completed' ? 'aborted' : recorded;
@@ -191,6 +192,16 @@ function readPackageVersion(pkg) {
   }
 }
 
+// 读本插件自身 package.json version（fail-soft 'unknown'），供维护区显示当前版本。
+function readOwnPluginVersion() {
+  try {
+    const manifest = requirePkg('../../package.json');
+    return typeof manifest.version === 'string' && manifest.version !== '' ? manifest.version : 'unknown';
+  } catch {
+    return 'unknown';
+  }
+}
+
 // 极简 semver 比较：major.minor.patch + 可选 `-预发布` 段（覆盖 peerDependencies
 // 范围判断所需）。预发布 < 正式版；预发布段逐段比较，纯数字段按数值、否则按字典序
 // （`0.1.0-rc.10` > `0.1.0-rc.6`）。
@@ -249,7 +260,7 @@ export function detectVersions(reader = readPackageVersion) {
       warnings.push(`@deepseek-ai/${pkg} 版本 ${version} 超出 peerDependencies 范围（>=${PEER_MIN} <${PEER_MAX}），派发行为可能与预期不符`);
     }
   }
-  return { versions, warnings };
+  return { versions, warnings, pluginVersion: readOwnPluginVersion() };
 }
 
 // 仅供测试访问本地降级实现（包导入在这里可解析，真函数胜出；`__fallbacks`

package/package.json

@@ -1,82 +1,82 @@
-{
-  "name": "dsh-subagent-profile",
-  "version": "0.3.3",
-  "description": "Dispatch one-shot subtasks to derived subagents with per-task overrides (preset/model/provider/reasoningEffort/persona/tool whitelist), a runtime-derived cost guard, a subagent-profiles service, observability metadata, and a web-GUI settings page plus a dispatch tool-call card.",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/muzyLink/dsh-subagent-profile.git"
-  },
-  "type": "module",
-  "main": "index.mjs",
-  "exports": {
-    ".": "./index.mjs",
-    "./client": "./lib/client.js",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "index.mjs",
-    "lib",
-    "cordis.patch.yml",
-    "presets",
-    "docs/screenshots",
-    "README.md",
-    "README.zh.md"
-  ],
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [],
-      "platform": "web"
-    }
-  },
-  "peerDependencies": {
-    "@deepseek-ai/dsh-agent": ">=0.1.0-rc.6 <0.2.0",
-    "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6 <0.2.0",
-    "@deepseek-ai/dsh-subagent": ">=0.1.0-rc.6 <0.2.0",
-    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.6 <0.2.0"
-  },
-  "peerDependenciesMeta": {
-    "@deepseek-ai/dsh-agent": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-subagent": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-llm": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-tools": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@deepseek-ai/dsh-agent": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-llm": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-subagent": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-tools": "0.1.0-rc.8",
-    "@eslint/js": "^10.0.1",
-    "eslint": "^10.9.0"
-  },
-  "engines": {
-    "node": "^22.19.0 || >=24"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "keywords": [
-    "deepseek-harness",
-    "dsh",
-    "subagent",
-    "dispatch",
-    "profiles"
-  ],
-  "license": "MIT",
-  "scripts": {
-    "test": "node --test \"test/**/*.test.mjs\"",
-    "test:bare": "node --test test/pure.test.mjs test/input-schema.test.mjs test/catalog-integrity.test.mjs",
-    "preflight": "node scripts/preflight.mjs",
-    "leak-scan": "node scripts/leak-scan.mjs"
-  }
-}
+{
+  "name": "dsh-subagent-profile",
+  "version": "0.4.0",
+  "description": "DeepSeek Harness 子 Agent 派发插件：按任务为子代理选模型、推理强度与工具范围，常用组合存成命名方案随时复用；内置安全检查、成本估算与节省分析、完整决策台账。",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/muzyLink/dsh-subagent-profile.git"
+  },
+  "type": "module",
+  "main": "index.mjs",
+  "scripts": {
+    "test": "node --test \"test/**/*.test.mjs\"",
+    "test:bare": "node --test test/pure.test.mjs test/input-schema.test.mjs test/catalog-integrity.test.mjs",
+    "preflight": "node scripts/preflight.mjs",
+    "leak-scan": "node scripts/leak-scan.mjs"
+  },
+  "exports": {
+    ".": "./index.mjs",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.mjs",
+    "lib",
+    "cordis.patch.yml",
+    "presets",
+    "docs/screenshots",
+    "README.md",
+    "README.zh.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-agent": ">=0.1.0-rc.6 <0.2.0",
+    "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6 <0.2.0",
+    "@deepseek-ai/dsh-subagent": ">=0.1.0-rc.6 <0.2.0",
+    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.6 <0.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-agent": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-subagent": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-agent": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-llm": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-subagent": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-tools": "0.1.0-rc.8",
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.9.0"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "subagent",
+    "dispatch",
+    "profiles"
+  ],
+  "license": "MIT"
+}