@a9i5k4/dsh-auto-memory 0.1.28 → 0.1.30

package/cordis.patch.yml

@@ -1,9 +1,9 @@
-# dsh-auto-memory bundle patch: inserts the dual-face plugin row into the web
-# profile roster. Applied as a profile bundle layer (the `dsh.bundle.patch`
-# manifest field). The node half (exports ".") runs in the host process
-# (memory engine, /api/dsh-auto-memory routes, agent tools, prompt injection);
-# the `dsh.client` declaration in package.json makes the browser half
-# (exports "./client", served at /plugins/<id>/client.js) load in the web GUI.
-- insert:
-    - id: auto-memory
-      name: '@a9i5k4/dsh-auto-memory'
+# dsh-auto-memory bundle patch: inserts the dual-face plugin row into the web
+# profile roster. Applied as a profile bundle layer (the `dsh.bundle.patch`
+# manifest field). The node half (exports ".") runs in the host process
+# (memory engine, /api/dsh-auto-memory routes, agent tools, prompt injection);
+# the `dsh.client` declaration in package.json makes the browser half
+# (exports "./client", served at /plugins/<id>/client.js) load in the web GUI.
+- insert:
+    - id: auto-memory
+      name: '@a9i5k4/dsh-auto-memory'

package/lib/activation-host.js

@@ -0,0 +1,455 @@
+/**
+ * M6-3 Surface Adapter(docs/M6-CONTRACT.md §7-§11,§13 M6-3)。
+ * 桥接 lib/index.js(pre-step 生命周期/systemPrompt surface/调试路由)与 M6-1/2 纯核心:
+ *   - capability 快照(不按模型名硬编码):本 DSH 构建可证明进入下一请求 messages 的
+ *     surface=systemPrompt.context(user-role 快照追加历史尾部);pre-step/user-message patch
+ *     不存在 → capability='dynamic-context';连 context 都没有 → 'none'(降级 Shadow,不标 delivered)。
+ *   - pre-step 时序(§8):bumpStep→setCursor→claim(四重门);claimed packet 缓存于 runtime 态。
+ *   - 渲染即投递:专用 context 组件 'dsh:m6-reference-tail-pre' 的 text() 重渲染并校验 exactDigest,
+ *     一致则返回尾注文本(=已实际进入 messages)并 markDelivered + 异步创建 seen evidence;
+ *     systemPrompt.section 永不承载动态 tail。
+ * 默认关闭(associativeMemoryEnabled ∧ activationInboxEnabled 双门);activationSource='fake' 为
+ * 路由注入唯一入口;'python' 仅在 assoc∧inbox∧pythonBackend 三重门下经 offerExternalActivation
+ * 接收 worker 帧并走现有 validator/inbox/pre-step claim(M7-1)。无 spawn/net/http;UTF-8 无 BOM。
+ */
+import {
+  buildReferenceTailPacketPre, renderReferenceTail, computeExactDigest, TAIL_MARKER_LINE_V1,
+  REFERENCE_TAIL_BUDGET_V1, ACTIVATION_POLICY_VERSION,
+} from './activation-inbox.js'
+import { createActivationInboxPre, ActivationInboxRegistry, REFERENCE_TAIL_COOLDOWN_STEPS_V1 } from './activation-inbox-state.js'
+import { createAccessEvidencePre } from './context-bridge.js'
+import path from 'node:path'
+import { buildSourceCatalog, loadCorpusSnapshot, CorpusRegistry, canonicalize } from './m4-corpus.js'
+
+/** §11 capability 快照版本。 */
+export const CAPABILITY_SNAPSHOT_V1 = 'capability_v1'
+
+/** §11 capability 检测:按宿主提供的 surface 形状决定 packetPatch,禁止按模型名硬编码。 */
+export function detectPacketCapabilityPre(ctxLike) {
+  const sp = ctxLike && ctxLike.systemPrompt
+  const hasContext = !!(sp && typeof sp.context === 'function')
+  return {
+    capabilityVersion: CAPABILITY_SNAPSHOT_V1,
+    packetPatch: hasContext ? 'dynamic-context' : 'none',
+    includeRuntimeContext: false,
+    maxPacketBytes: REFERENCE_TAIL_BUDGET_V1.maxPacketBytes,
+    supportsDeliveryAck: true, // context text 返回非空即证明进入 messages,可同步 ack
+  }
+}
+
+export function createActivationHost(opts = {}) {
+  const engine = opts.engine
+  if (!engine) throw new Error('activation-host: engine required')
+  const registry = new ActivationInboxRegistry()
+  const corpusRegistry = new CorpusRegistry({ sidecarDir: path.join(dshHome(), 'memory', 'index', 'files') })
+  const runtimeState = new Map() // runtime.key → {step, claimed:{packet, inbox}|null, identity:{sessionId,workspaceKey}|null}
+  let mivCache = { wsRef: null, miv: null }
+  const pathsByKey = new Map()
+  const volatileEvents = [] // ≤16 最小投影
+  const stats = { injected: 0, injectedAccepted: 0, injectedRejected: 0, claims: 0, claimFails: 0, rendered: 0, delivered: 0, seenCreated: 0, seenSkippedNoProv: 0, errors: 0 }
+
+  function effectiveEnabled() {
+    return engine.config.associativeMemoryEnabled === true && engine.config.activationInboxEnabled === true
+  }
+  /** M7-1 三重门(PYTHON-SIDECAR-CONTRACT §13.1):默认 fake 时恒不走 python 分支。 */
+  function pythonGate() {
+    return engine.config.associativeMemoryEnabled === true &&
+      engine.config.activationInboxEnabled === true &&
+      engine.config.pythonBackendEnabled === true
+  }
+  function sourceMode() {
+    const s = String(engine.config.activationSource || 'fake')
+    if (s === 'fake') return 'fake'
+    if (s === 'js') return 'js' // 2026-08-27 JS 判定来源(C2 检索 + JS 判定核,独立于 Python)
+    if (s === 'python' && pythonGate()) return 'python'
+    return 'invalid'
+  }
+  function dshHome() {
+    const env = process.env.DSH_HOME
+    if (env && env.trim()) return env.trim()
+    const base = engine.__homedirFn ? engine.__homedirFn() : (process.env.USERPROFILE || process.env.HOME || '')
+    return base ? path.join(base, '.dsh') : '.'
+  }
+  function pushEvent(entry) {
+    volatileEvents.push({ at: Date.now(), ...entry })
+    if (volatileEvents.length > 16) volatileEvents.shift()
+  }
+  function capturePaths(runtimeKey, p) {
+    pathsByKey.set(String(runtimeKey || ''), {
+      workspaceKey: canonicalize(p.ws),
+      userMemoryPath: p.userDir ? path.join(p.userDir, 'MEMORY.md') : undefined,
+      workspaceMemoryPath: p.notesPath,
+      todayLogPath: p.logPath,
+    })
+  }
+
+
+  /** 当前 workspace 的 memoryIndexVersion(自有 CorpusRegistry 懒加载;失败 null 并清缓存)。 */
+  function currentMiv(workspaceKey) {
+    const ws = canonicalize(workspaceKey)
+    const p = null
+    for (const [, v] of pathsByKey) {
+      if (v.workspaceKey !== ws) continue
+      try {
+        const catalog = buildSourceCatalog({
+          workspaceKey: v.workspaceKey,
+          userMemoryPath: v.userMemoryPath,
+          workspaceMemoryPath: v.workspaceMemoryPath,
+          todayLogPath: v.todayLogPath,
+        })
+        const res = corpusRegistry.get(catalog)
+        if (res && res.ok) {
+          mivCache = { wsRef: ws, miv: res.snapshot.memoryIndexVersion }
+          return mivCache.miv
+        }
+      } catch (_) {}
+      break
+    }
+    if (mivCache.wsRef === ws) return mivCache.miv
+    return null
+  }
+  function setMiv(workspaceKey, miv) { mivCache = { wsRef: canonicalize(workspaceKey), miv } }
+
+  function identityFor(runtime) {
+    const sessionId = runtime.sessionId || ''
+    const p = pathsByKey.get(String(runtime.key || '')) || null
+    const workspaceKey = p ? p.workspaceKey : (engine.state && engine.state.ws ? canonicalize(engine.state.ws) : '')
+    if (!sessionId || !workspaceKey) return null
+    return { sessionId, agentId: runtime.agentId || '', workspaceKey }
+  }
+
+  /** fake/python 注入入口(路由/未来 sink 共用)。返回 offer 结果。 */
+  function injectActivation(request) {
+    try {
+      if (!effectiveEnabled()) return { ok: false, reason: 'disabled' }
+      if (sourceMode() !== 'fake') return { ok: false, reason: 'source-not-fake' }
+      stats.injected++
+      const rv = validateRequestShape(request)
+      if (!rv.ok) { stats.injectedRejected++; return rv }
+      const req = rv.request
+      const box = registry.get(req.sessionId, req.workspaceKey)
+      if (!box) {
+        const created = registry.forRuntime(req.sessionId, req.workspaceKey, { contextVersion: req.contextVersion, memoryIndexVersion: req.memoryIndexVersion, agentId: req.agentId })
+        if (!created) { stats.injectedRejected++; return { ok: false, reason: 'identity-mismatch' } }
+        return finishInject(created, req)
+      }
+      if (!box.identity.agentId && req.agentId) box.identity.agentId = String(req.agentId)
+      return finishInject(box, req)
+    } catch (e) { stats.errors++; return { ok: false, reason: 'internal-error' } }
+  }
+  function finishInject(box, req) {
+    box.setCursor({ contextVersion: req.contextVersion, memoryIndexVersion: req.memoryIndexVersion })
+    const r = box.offerActivation(req, { nowStep: stepFor(req.sessionId, req.workspaceKey), currentMemoryIndexVersion: req.memoryIndexVersion })
+    if (r.ok) {
+      stats.injectedAccepted++
+      // fake 来源「注入即泵」：立刻以请求自声明版本过四重门 claim，并把 claimed 挂到
+      // 目标 runtime 态——下一次该 session 的自然 compose 会渲染尾注并 markDelivered(+seen)。
+      pumpClaimed(box, req)
+    } else stats.injectedRejected++
+    pushEvent({ kind: 'inject', ok: !!r.ok, outcome: r.outcome || r.reason })
+    return r
+  }
+  /**
+   * 注入即泵(2026-08-28 自 fake 提取共享):offer 成功后立刻以请求自声明版本过四重门 claim,
+   * claimed 挂到目标 runtime 态 → 下一次自然 compose 渲染尾注并 markDelivered(+seen)。
+   * 动机(live 实证):DSH 会话 cv 每段自增 + TTL=3 步 < 多步回合长度,回合中途 offer 的
+   * packet 活不到下一次 pre-step 自然 claim(claimFails 全 none-pending)。fake 与 JS 判定
+   * 来源共用;Python 保持 pre-step 自然 claim(冻结契约,待 Python live 按证据另议)。
+   */
+  function pumpClaimed(box, req) {
+    const c2 = box.claim({
+      nowStep: stepFor(req.sessionId, req.workspaceKey),
+      currentContextVersion: req.contextVersion,
+      currentMemoryIndexVersion: req.memoryIndexVersion,
+    })
+    if (c2.ok) {
+      stats.claims++
+      let target = null
+      for (const rt of engine.runtimes.values()) { if (rt.sessionId === req.sessionId && !rt.disposed) { target = rt; break } }
+      if (target) {
+        let st = runtimeState.get(target.key)
+        if (!st) { st = { step: 0, claimed: null }; runtimeState.set(target.key, st) }
+        st.claimed = { packet: c2.packet, inbox: box }
+        pushEvent({ kind: 'pump', packetId: c2.packet.packetId, runtimeKey: String(target.key).slice(0, 24) })
+      } else {
+        box.rollbackClaim()
+        pushEvent({ kind: 'pump', reason: 'no-runtime' })
+      }
+    } else {
+      pushEvent({ kind: 'pump', reason: c2.reason })
+    }
+  }
+  /**
+   * M7-1 python 来源入口(worker activation_request 帧):JS 硬校验+身份/重复/抑制/cursor/index 门后入箱。
+   * 与 fake 的注入即泵不同——真实 Python 推送不做 pump,走 pre-step 自然 claim(§8 时序保留;M6-4 偏差仅限 fake)。
+   */
+  function offerExternalActivation(request) {
+    try {
+      if (!effectiveEnabled()) return { ok: false, reason: 'disabled' }
+      const sm = sourceMode()
+      if (sm !== 'python' && sm !== 'js') return { ok: false, reason: 'source-not-python' }
+      stats.injected++
+      const rv = validateRequestShape(request)
+      if (!rv.ok) { stats.injectedRejected++; return rv }
+      const req = rv.request
+      // P0:skill 段附着。JS 档已用 query 匹配到技能时保留其结果;否则(典型=Python 档
+      // 无 query)退回候选∩sourceMemoryIds 匹配。技能段非法会在 M6 校验器被拒(fail-closed)。
+      try {
+        if (!req.skill) {
+          const sk = matchSkillByCandidates(req)
+          if (sk) req.skill = sk
+        }
+      } catch (_) {}
+      let box = registry.get(req.sessionId, req.workspaceKey)
+      if (!box) {
+        box = registry.forRuntime(req.sessionId, req.workspaceKey, { contextVersion: req.contextVersion, memoryIndexVersion: req.memoryIndexVersion, agentId: req.agentId })
+        if (!box) { stats.injectedRejected++; return { ok: false, reason: 'identity-mismatch' } }
+      }
+      if (!box.identity.agentId && req.agentId) box.identity.agentId = String(req.agentId)
+      const miv = currentMiv(req.workspaceKey)
+      const r = box.offerActivation(req, { nowStep: stepFor(req.sessionId, req.workspaceKey), currentMemoryIndexVersion: miv === null ? undefined : miv })
+      pushEvent({ kind: 'python-offer', ok: !!r.ok, outcome: r.outcome || r.reason })
+      if (r.ok) {
+        stats.injectedAccepted++
+        // 2026-08-30:注入即泵扩展到 Python 来源——canary 实证(JS 档 08-28)自然 claim
+        // 在回合中段必死(cv 每段自增+TTL3 步),Python emit 的时序机制完全相同,同一证据
+        // 同一修法。泵是 M6 投递侧机制,不耦合任何语义档(JS/Python 各自独立可用)。
+        pumpClaimed(box, req)
+      } else stats.injectedRejected++
+      return r
+    } catch (e) { stats.errors++; return { ok: false, reason: 'internal-error' } }
+  }
+  /**
+   * M9 act.skill 附着(2026-08-30 P0):Python 档 emit 帧到站时,JS 侧拿不到 query 文本
+   * (query 在 worker 内部,帧只带 candidates/score/identity),因此 JS 档那套「C2 稠密/词法
+   * 匹配技能标题」在 Python 档无解 → 改用**候选 ∩ 技能 sourceMemoryIds 求交集**匹配:
+   * 被唤起的记忆本身若正是某 active 技能的来源记忆,则该技能的 checklist 与本轮上下文相关。
+   *
+   * 语义分工(不可互相覆盖):
+   *   - JS 档(context-host.js)仍走 query 匹配,命中后请求自带 skill → 此处不覆盖;
+   *   - Python 档无 query → 走本函数的候选交集匹配。
+   * 纯增强:任何异常静默返回 null(无技能段),绝不阻断投递主链路。
+   */
+  function matchSkillByCandidates(req) {
+    try {
+      const hub = engine._memoryHub
+      if (!hub || !hub.stores || !hub.stores.procedures) return null
+      if (engine.config.memoryHubEnabled !== true) return null
+      if (engine.config.procedurePromotionEnabled === false) return null
+      const actives = hub.stores.procedures.activeProcedures()
+      if (!actives.length) return null
+      const candIds = new Set()
+      for (const c of Array.isArray(req.candidates) ? req.candidates : []) {
+        if (c && typeof c.memoryId === 'string' && c.memoryId) candIds.add(c.memoryId)
+      }
+      if (!candIds.size) return null
+      // 命中数最多者胜;平局取 store 顺序首个(过程确定,同输入同输出)
+      let best = null
+      let bestHits = 0
+      for (const p of actives) {
+        if (!p || !Array.isArray(p.sourceMemoryIds)) continue
+        let hits = 0
+        for (const id of p.sourceMemoryIds) if (candIds.has(id)) hits++
+        if (hits > bestHits) { bestHits = hits; best = p }
+      }
+      if (!best) return null
+      const cl = hub.stores.procedures.renderChecklist(best.procedureId)
+      if (!cl || !cl.text) return null
+      try { hub.stores.procedures.touch(best.procedureId) } catch (_) {} // Hermes:last_used 时钟
+      return {
+        procedureId: String(best.procedureId),
+        title: String((cl && cl.title) || best.title || ''),
+        level: String((cl && cl.level) || 'checklist'),
+        text: String(cl.text).slice(0, 1200),
+      }
+    } catch (_) { return null }
+  }
+
+  function validateRequestShape(request) {
+    if (!request || typeof request !== 'object') return { ok: false, reason: 'not-object' }
+    if (typeof request.activationId !== 'string' || !request.activationId) return { ok: false, reason: 'no-activation-id' }
+    return { ok: true, request }
+  }
+  const stepsByRuntime = new Map()
+  function stepFor(sessionId, workspaceKey) {
+    const key = sessionId + '|ws:' + workspaceKey
+    const n = (stepsByRuntime.get(key) || 0) + 1
+    stepsByRuntime.set(key, n)
+    return n
+  }
+
+  /**
+   * agent/pre-step(§8):先校验当前 cursor/index/TTL 再 claim;claimed packet 存 runtime 态,
+   * 等待渲染面(text())消费。cursor/miv 取自 runtime 与 corpus 快照。
+   */
+  function onPreStep(agent) {
+    try {
+      if (!effectiveEnabled()) return
+      const runtime = engine.runtimeFor(agent)
+      if (!runtime || runtime.disposed) return
+      const identity = identityFor(runtime)
+      if (!identity) { pushEvent({ kind: 'prestep', reason: 'no-identity' }); return }
+      const box = registry.forRuntime(identity.sessionId, identity.workspaceKey, { contextVersion: runtime.contextVersion })
+      if (!box) return
+      const miv = currentMiv(identity.workspaceKey)
+      box.setCursor({ contextVersion: runtime.contextVersion, memoryIndexVersion: miv || undefined })
+      const nowStep = stepFor(identity.sessionId, identity.workspaceKey)
+      const c = box.claim({
+        nowStep,
+        currentContextVersion: runtime.contextVersion,
+        currentMemoryIndexVersion: miv === null ? undefined : miv,
+      })
+      let st = runtimeState.get(runtime.key)
+      if (!st) { st = { step: 0, claimed: null }; runtimeState.set(runtime.key, st) }
+      st.step = nowStep
+      if (c.ok) { st.claimed = { packet: c.packet, inbox: box }; stats.claims++ }
+      else {
+        // 2026-08-28 浏览器实测修复:claim 失败(none-pending 等)不得清掉已存在的 claimed——
+        // 注入即泵挂上的包在 pending 里已不存在,下一次 pre-step 的 none-pending 失败会把
+        // 它擦掉,导致 rendered 永远为 0。仅在无 claimed 时保持空位。
+        stats.claimFails++; pushEvent({ kind: 'claim', reason: c.reason })
+        if (process.env.DSH_ACT_DEBUG) console.error('[act-diag] claim fail ' + c.reason + ' runtimeCv=' + runtime.contextVersion + ' miv=' + miv)
+      }
+    } catch (e) { stats.errors++ }
+  }
+
+  /**
+   * 专用渲染面(dsh:m6-reference-tail-pre 的 text()):重渲染 claimed packet 并校验 exactDigest,
+   * 一致 → 返回尾注文本 + markDelivered + 异步 seen;不一致/未声明 → 返回空串(零注入)。
+   */
+  function renderTailFor(agent) {
+    try {
+      if (!effectiveEnabled()) return ''
+      const runtime = engine.runtimeFor(agent)
+      if (!runtime) return ''
+      const st = runtimeState.get(runtime.key)
+      if (!st || !st.claimed) return ''
+      const { packet, inbox } = st.claimed
+      // skill 必须与 packet 构建时同源传入:渲染器据此复现逐字节一致的文本,exactDigest 才对得上
+      const re = renderReferenceTail(packet.references, { reason: packet.triggerReason, budgetBytes: REFERENCE_TAIL_BUDGET_V1.maxPacketBytes, skill: packet.skill })
+      if (!re.ok || computeExactDigest(re.text) !== packet.exactDigest) {
+        stats.errors++
+        pushEvent({ kind: 'render', reason: 'digest-mismatch' })
+        st.claimed = null
+        return ''
+      }
+      const ack = inbox.markDelivered(packet.packetId, { nowStep: st.step })
+      st.claimed = null
+      if (!ack.ok) return ''
+      stats.rendered++
+      stats.delivered++
+      // G-02:渲染结果可观测——skill 字段让 /activation status 端点直接证明技能段进了 tail
+      pushEvent({ kind: 'render', skill: !!(packet && packet.skill), refs: Array.isArray(packet.references) ? packet.references.length : 0, packetId: packet.packetId })
+      void createSeenEvidences(runtime, packet)
+      return re.text
+    } catch (e) { stats.errors++; return '' }
+  }
+
+  /** delivery ack → M5 seen evidence(provenance 从 corpus 补全;查不到则跳过,fail closed)。 */
+  async function createSeenEvidences(runtime, packet) {
+    try {
+      const ch = engine._contextHost
+      const identity = identityFor(runtime)
+      if (!ch || !identity) { stats.seenSkippedNoProv += packet.references.length; return }
+      const evidences = []
+      for (const ref of packet.references) {
+        const prov = ch.findProvenance(identity.workspaceKey, ref.memoryId, ref.recordDigest)
+        if (!prov) { stats.seenSkippedNoProv++; continue }
+        const ev = createAccessEvidencePre({
+          kind: 'seen', memoryId: prov.memoryId, anchorId: prov.anchorId, scope: prov.scope,
+          workspaceKey: identity.workspaceKey, sessionId: identity.sessionId,
+          eventSeq: runtime.eventCursor | 0, nativeSeq: undefined, contextVersion: packet.contextVersion,
+          ts: Date.now(),
+          sourceRef: prov.sourceRef, sourceEpoch: prov.sourceEpoch, sourceVersion: prov.sourceVersion,
+          fileDigest: prov.fileDigest, recordDigest: prov.recordDigest,
+        })
+        if (ev.ok) evidences.push(ev.evidence)
+      }
+      if (evidences.length) {
+        await ch.appendEvidence(evidences)
+        stats.seenCreated += evidences.length
+      }
+    } catch (e) { stats.errors++ }
+  }
+
+  /** §11 capability(按当前宿主形状);Host 无 ctx 引用,由 index.js 注入一次。 */
+  let capability = null
+  function initCapability(ctxLike) { capability = detectPacketCapabilityPre(ctxLike); return capability }
+  function getCapability() { return capability || { capabilityVersion: CAPABILITY_SNAPSHOT_V1, packetPatch: 'none', supportsDeliveryAck: false } }
+
+  function debugView() {
+    if (!effectiveEnabled()) return { enabled: false }
+    const cap = getCapability()
+    return {
+      enabled: true,
+      activationPolicyVersion: ACTIVATION_POLICY_VERSION,
+      cooldownSteps: REFERENCE_TAIL_COOLDOWN_STEPS_V1,
+      capability: cap,
+      sourceMode: sourceMode(),
+      memoryIndexVersion: mivCache.miv || null,
+      inboxCount: registry.size,
+      stats: { ...stats },
+      recentEvents: volatileEvents.slice(-4),
+    }
+  }
+
+  /**
+   * M10 存储管理级联清理(2026-08-30 P3):一条记忆被删除后,清掉三处在途/在册痕迹,
+   * 避免「已删除的记忆又被投递一次」:
+   *   ①每个 inbox:进抑制名单 + 丢弃含它的 pending 包(见 inbox.purgeMemoryId)
+   *   ②已挂到 runtime 态的 claimed 包(注入即泵挂上的):含它则丢弃 → 下一轮渲染为空
+   *   ③already-delivered 的 seen 证据不动(seen 语义冻结:已发生的事实不改写)
+   * 纯内存操作,零 IO;不影响 validator/Reference Tail 固定边界/seen 语义。
+   */
+  function purgeMemory(memoryId) {
+    const id = String(memoryId || '')
+    if (!id) return { ok: false, reason: 'no-memory-id' }
+    let inboxCount = 0
+    let droppedPending = 0
+    let droppedClaimed = 0
+    try {
+      for (const box of registry.boxes()) {
+        inboxCount++
+        const r = box.purgeMemoryId(id)
+        if (r && r.droppedPending) droppedPending++
+      }
+      for (const [key, st] of runtimeState) {
+        if (!st || !st.claimed) continue
+        const refs = st.claimed.packet && Array.isArray(st.claimed.packet.references) ? st.claimed.packet.references : []
+        if (refs.some((r) => r && r.memoryId === id)) { st.claimed = null; droppedClaimed++ }
+        void key
+      }
+      pushEvent({ kind: 'purge', memoryId: id, inboxCount, droppedPending, droppedClaimed })
+      return { ok: true, inboxCount, droppedPending, droppedClaimed }
+    } catch (e) { stats.errors++; return { ok: false, reason: 'internal-error' } }
+  }
+
+  function disposeRuntime(runtimeKey) {
+    runtimeState.delete(runtimeKey)
+    stepsByRuntime.delete(String(runtimeKey))
+  }
+  function disposeAll(reason) {
+    runtimeState.clear()
+    stepsByRuntime.clear()
+    registry.disposeAll(reason)
+    volatileEvents.length = 0
+  }
+  function disposeSession(sessionId, workspaceKey) { registry.disposeSession(sessionId, workspaceKey) }
+
+  return {
+    initCapability,
+    getCapability,
+    capturePaths,
+    effectiveEnabled,
+    injectActivation,
+    offerExternalActivation,
+    purgeMemory,
+    onPreStep,
+    renderTailFor,
+    debugView,
+    disposeRuntime,
+    disposeAll,
+    disposeSession,
+    _statsForTest: stats,
+  }
+}