dsh-plugin-prompt-tool 3.1.0 → 3.1.2

package/engine/layers.mjs

@@ -71,7 +71,7 @@ function officialAliasOf(name) {
  * 非法官方名（中文/大写/连字符）改写成确定性别名并改写文本引用；注册失败的名字退回静态解析。
  * @returns 各配置独立的引用白名单与别名；同一作用域内等价绑定只注册一次。
  */
-function registerOfficialVariables(ctx, configs, warnOnce, keep) {
+function registerOfficialVariables(ctx, configs, warnOnce, keep, shared) {
   const registries = new Map(configs.map((config) => [config, { protect: new Set(), alias: new Map(), registered: new Set() }]))
   const systemPrompt = getService(ctx, 'systemPrompt')
   if (systemPrompt === undefined || typeof systemPrompt.variable !== 'function') return registries
@@ -92,8 +92,9 @@ function registerOfficialVariables(ctx, configs, warnOnce, keep) {
     }
   }
   for (const fact of facts) reserved.add(fact)
-  const bindings = new Map()
-  const usedNames = new Set()
+  const bindings = shared?.bindings ?? new Map()
+  const usedNames = shared?.usedNames ?? new Set()
+  const retained = new Set()
   for (const [config, referenced] of references) {
     const registry = registries.get(config)
     for (const name of referenced) {
@@ -115,20 +116,30 @@ function registerOfficialVariables(ctx, configs, warnOnce, keep) {
           usedNames.add(official)
           const source = isFact ? name.toLowerCase() : name
           const variablesDisabled = config[SESSION_VARIABLES_DISABLED] === true
-          keep(systemPrompt.variable(official, (context) => {
+          const release = systemPrompt.variable(official, (context) => {
             const session = context?.agent?.session
             const variables = variablesDisabled ? {} : config.variableStore?.read(config.sourceModuleId).effective ?? config.variables
             const value = Object.hasOwn(variables, source) ? String(variables[source]) : runtimeFactValue(source, session) ?? ''
             // 变量值内的 {{pick}} 同样要有位置身份（配置 id + 声明名），否则同会话下多个变量的首个 pick 撞值。
             const expanded = interpolateVariables(value, variables, session, undefined, `variable:${config.sourceModuleId}:${config.id}:${name}`)
             return officialChannelText(expanded, `variable ${official}`, { alias: new Map(), registered: new Set() }, warnOnce)
-          }), `${name}: official prompt variable ${official}`)
-          binding = official
+          })
+          binding = { name: official, release, refs: 0 }
           bindings.set(signature, binding)
         }
-        registry.registered.add(binding)
+        if (!retained.has(signature)) {
+          retained.add(signature)
+          binding.refs++
+          keep(() => {
+            if (--binding.refs > 0) return
+            bindings.delete(signature)
+            usedNames.delete(binding.name)
+            binding.release?.()
+          }, `${name}: official prompt variable ${binding.name}`)
+        }
+        registry.registered.add(binding.name)
         registry.protect.add(name)
-        if (binding !== name) registry.alias.set(name, binding)
+        if (binding.name !== name) registry.alias.set(name, binding.name)
       } catch (error) {
         warnOnce(`${name}: 官方 prompt 变量 ${official} 注册失败，该引用退回静态解析：${String(error?.message ?? error)}`)
       }
@@ -176,6 +187,7 @@ function textLayerGroups(configs) {
       && config.sourceModuleId === base.sourceModuleId
       && (config.params?.complete === true) === (base.params?.complete === true)
       && (config.params?.suppressRuntimeContext === true) === (base.params?.suppressRuntimeContext === true)
+      && config.runtimePoint?.waterfallPosition === base.runtimePoint?.waterfallPosition
       && config.position === base.position && config.order === base.order) previous.push(config)
     else groups.push([config])
   }
@@ -658,9 +670,9 @@ function orderedNamesOf(entries) {
  * 回填到它们原来的槽位。只换本插件段之间的位置：平台段与其他插件段占住的槽位不动。
  */
 function registerDeliveryOrder(ctx, keep, collection, names) {
-  if (names.length < 2) return
-  const rank = new Map(names.map((entryName, index) => [entryName, index]))
+  if (typeof names !== 'function' && names.length < 2) return
   keep(ctx.on('system-prompt/assemble', async (assembly, context, next) => {
+    const rank = new Map((typeof names === 'function' ? names() : names).map((entryName, index) => [entryName, index]))
     const result = await next()
     const list = result?.[collection]
     if (!Array.isArray(list)) return result
@@ -712,8 +724,8 @@ export function wireLayers(ctx, configs, warnOnce, options = {}) {
   try {
     // 注册即纳入 owned，后续注册失败也能释放已取得的变量和监听器。
     /** 实际注册名与序号：重排器只认这里，不从 configs 反推。 */
-    const ordered = { sections: [], contexts: [] }
-    const registry = registerOfficialVariables(ctx, configs.filter((config) => config.layer === 'system-section' || config.layer === 'runtime-context'), warnOnce, keep)
+    const ordered = options.ordered ?? { sections: [], contexts: [] }
+    const registry = registerOfficialVariables(ctx, configs.filter((config) => config.layer === 'system-section' || config.layer === 'runtime-context'), warnOnce, keep, options.sharedVariables)
     const conditional = configs.filter(config => ['system-section', 'runtime-context'].includes(config.layer)
       && (typeof config.rule?.when === 'function' || typeof config.actionWhen === 'function'
         || (config.rule !== undefined || config.params?.templateEvaluation === true) && config.params?.complete !== true && config.params?.suppressRuntimeContext !== true))
@@ -724,7 +736,7 @@ export function wireLayers(ctx, configs, warnOnce, options = {}) {
     wireTurnStops(ctx, configs.filter((config) => config.layer === 'turn-stop'), warnOnce, on, options.turnStopBudgets)
     wireSubagentEvents(ctx, configs.filter((config) => config.layer === 'subagent-start' || config.layer === 'subagent-end'), warnOnce, on)
     // 官方 order 只提供初始槽位；configOrder 覆盖段/上下文的先后（平台段与其他插件段不动）。
-    for (const collection of ['sections', 'contexts']) {
+    for (const collection of options.deliveryOrder === false ? [] : ['sections', 'contexts']) {
       registerDeliveryOrder(ctx, keep, collection, orderedNamesOf(ordered[collection]))
     }
     return dispose
@@ -733,3 +745,86 @@ export function wireLayers(ctx, configs, warnOnce, options = {}) {
     throw error
   }
 }
+
+/** 按实际文本组保留注册；共享排序投影变化不撤销未变化组的 provider。 */
+export function createLayerRuntime(ctx, warnOnce, options = {}) {
+  let records = []
+  let active = true
+  const listeners = []
+  const sharedVariables = { bindings: new Map(), usedNames: new Set() }
+  const keep = release => { listeners.push(release) }
+  try {
+    for (const collection of ['sections', 'contexts']) {
+      registerDeliveryOrder(ctx, keep, collection, () => orderedNamesOf(records.flatMap(record => record.ordered[collection])))
+    }
+  } catch (error) {
+    for (const release of listeners.reverse()) release()
+    throw error
+  }
+  const groupsOf = configs => {
+    const groups = []
+    for (const layer of ['system-section', 'runtime-context']) {
+      const selected = configs.filter(config => config.layer === layer)
+      const conditional = selected.filter(config => typeof config.rule?.when === 'function' || typeof config.actionWhen === 'function'
+        || (config.rule !== undefined || config.params?.templateEvaluation === true) && config.params?.complete !== true && config.params?.suppressRuntimeContext !== true)
+      const conditionalSet = new Set(conditional)
+      const regular = selected.filter(config => !conditionalSet.has(config))
+      groups.push(...textLayerGroups(conditional))
+      if (layer === 'system-section') groups.push(...textLayerGroups(regular))
+      else {
+        const resolver = regular.filter(config => config.strategy === 'placeholder' || !KNOWN_STRATEGIES.has(config.strategy))
+        const resolverSet = new Set(resolver)
+        groups.push(...textLayerGroups(regular.filter(config => !resolverSet.has(config))), ...resolver.map(config => [config]))
+      }
+    }
+    const other = configs.filter(config => !['system-section', 'runtime-context'].includes(config.layer))
+    return [...groups, ...other.map(config => [config])]
+  }
+  const mount = configs => {
+    const ordered = { sections: [], contexts: [] }
+    const handlers = []
+    const dispose = wireLayers(ctx, configs, warnOnce, {
+      ...options, sharedVariables, ordered, deliveryOrder: false,
+      on(channel, handler) { handlers.push({ channel, handler, config: configs[0] }); return () => {} },
+    })
+    return { configs, ordered, handlers, dispose }
+  }
+  return {
+    replace(configs) {
+      if (!active) throw new Error('rule text runtime disposed')
+      const groups = groupsOf(configs)
+      const byFirst = new Map(records.map(record => [record.configs[0], record]))
+      const retained = groups.map(group => {
+        const record = byFirst.get(group[0])
+        return record?.configs.length === group.length && group.every((config, index) => record.configs[index] === config) ? record : undefined
+      })
+      const retainedSet = new Set(retained)
+      const removed = records.filter(record => !retainedSet.has(record))
+      for (const record of removed) record.dispose()
+      const created = []
+      try {
+        records = groups.map((group, index) => {
+          if (retained[index] !== undefined) return retained[index]
+          const record = mount(group)
+          created.push(record)
+          return record
+        })
+        const owners = new Set(configs.map(config => config.sourceModuleId ?? ''))
+        for (const owner of options.turnStopBudgets?.keys() ?? []) if (!owners.has(owner)) options.turnStopBudgets.delete(owner)
+      } catch (error) {
+        for (const record of created.reverse()) record.dispose()
+        const old = records
+        records = old.filter(record => !removed.includes(record))
+        for (const record of removed) records.push(mount(record.configs))
+        throw error
+      }
+    },
+    entries: () => records.flatMap(record => record.handlers),
+    dispose() {
+      if (!active) return
+      active = false
+      for (const record of records.splice(0).reverse()) record.dispose()
+      for (const release of listeners.splice(0).reverse()) release()
+    },
+  }
+}

package/engine/rule-runtime.d.mts

@@ -51,3 +51,9 @@ export function mountRuleSources(
   sources: ReadonlyArray<RuleSourceLike>,
   options?: MountRuleSourcesOptions,
 ): () => void
+
+/** 同 moduleId 与 rules 引用保持未变来源；候选拒绝时恢复受影响来源的旧贡献。 */
+export function createRuleRuntime(ctx: unknown, options?: MountRuleSourcesOptions): {
+  replace(sources: ReadonlyArray<RuleSourceLike>): void
+  dispose(): void
+}

package/engine/rule-runtime.mjs

@@ -1,7 +1,7 @@
 import { prepareAction } from './actions/index.mjs'
-import { applyPromptConfigSources } from './executor.mjs'
+import { confirmDelivered, runPreStepBatch } from './executor.mjs'
 import { createPreStepSource, moduleSourceId } from './pre-step-source.mjs'
-import { wireLayers } from './layers.mjs'
+import { createLayerRuntime } from './layers.mjs'
 import { rebindConditions, validateDeliverySources } from './rule-spec.mjs'
 import { wireTriggerObservers } from './trigger.mjs'
 import { ruleFrame, actionMatches } from './conditions/evaluation.mjs'
@@ -18,42 +18,67 @@ const compare = (a, b) => a.action.channelOrder - b.action.channelOrder
 
 const sourceError = (error, moduleId) => Object.assign(new Error(String(error?.message ?? error), { cause: error }), { sourceModuleId: moduleId })
 
+const pointKey = point => `${point.channel}:${point.phase}:${point.waterfallPosition}`
+const compareEntries = (a, b) => a.sequence - b.sequence || a.sourceModuleId.localeCompare(b.sourceModuleId)
+  || a.ruleIndex - b.ruleIndex || a.ruleActionIndex - b.ruleActionIndex
+
+function pointHandler(ctx, point, snapshot, warnOnce, report, isActive) {
+  return (...args) => {
+    const handlers = snapshot()
+    const free = noNext.has(point.channel)
+    const payload = free ? args : args.slice(0, -1)
+    const next = free ? () => undefined : args.at(-1)
+    if (!isActive()) return next()
+    let frame
+    try { frame = ruleFrame(point.channel, payload, warnOnce, ctx, report) }
+    catch (error) {
+      warnOnce(`rule engine: frame construction failed on ${point.channel}: ${String(error?.message ?? error)}`)
+      return next()
+    }
+    if (free) {
+      let pending
+      for (const entry of handlers) {
+        const invoke = () => {
+          if (!isActive()) return undefined
+          if (!actionMatches(entry, frame)) { entry.miss?.(frame); return undefined }
+          return entry.handler(...payload, undefined, frame)
+        }
+        pending = pending?.then ? pending.then(invoke) : invoke()
+      }
+      return pending
+    }
+    if (point.phase === 'after-next') return Promise.resolve(next()).then(async initial => {
+      let result = initial
+      for (const entry of handlers) {
+        if (!isActive()) continue
+        if (!actionMatches(entry, frame)) { entry.miss?.(frame); continue }
+        result = await entry.handler(...payload, () => result, frame)
+      }
+      return result
+    })
+    const invoke = index => {
+      if (!isActive() || index === handlers.length) return next()
+      const entry = handlers[index]
+      if (!actionMatches(entry, frame)) { entry.miss?.(frame); return invoke(index + 1) }
+      return entry.handler(...payload, () => invoke(index + 1), frame)
+    }
+    return invoke(0)
+  }
+}
+
 /** 所有来源只进入这个装配入口；受众限定固定效果要求 ctx 属于 options.agent 的 scope。 */
-export function mountRuleSources(ctx, sources, options = {}) {
+function mountSources(ctx, sources, options = {}) {
   validateDeliverySources(sources)
-  // 晋升相位池先建：条件的挂载期绑定要用它（`phase` 的订阅模式从池取实例，见 promotion-pool.mjs）。
-  // 池自己订阅 `session/event` 并统一喂事件；自建的随本挂载释放，注入的由创建者释放。
-  const coordinator = (() => {
-    const service = getService(ctx, PRE_STEP_COORDINATOR_SERVICE)
-    return service !== null && typeof service === 'object' && typeof service.registerPreset === 'function'
-      ? service
-      : undefined
-  })()
-  const pool = options.promotionPool ?? coordinator?.promotionPool ?? createPromotionPool(ctx)
-  const ownsPool = options.promotionPool === undefined && coordinator?.promotionPool === undefined
+  const pool = options.promotionPool
   // 条件绑定**在这里**发生：`compileRules` 编译期没有挂载 scope 的 ctx（preset 条件在那边恒
   // UNAVAILABLE 且静默）。必须早于事件订阅与动作注册——动作级 `actionWhen.observe` 是订阅通道，
   // 绑晚了那一类谓词会漏事件。`standingMountFor` 是可选兜底（官方包缺席＝没有兜底，不是错误）。
   const warnOnce = options.warnOnce ?? createWarnOnce(ctx, options.plugin ?? 'rule-engine')
-  // 非 pre-step 动作仍共享一次 ruleFrame；规则实例没有来源字段（RuleDefinition 不暴露 moduleId），
-  // 因此保留一份局部 rule→module 映射。它不是 pre-step 来源事实的重建，不参与 pre-step 的 source sink。
-  const report = options.onOutcome === undefined ? undefined : (() => {
-    const moduleOfRule = new Map()
-    for (const source of sources) for (const rule of source.rules) if (!moduleOfRule.has(rule)) moduleOfRule.set(rule, source.moduleId)
-    return (rule, channel, outcome) => options.onOutcome({ moduleId: moduleOfRule.get(rule), ruleId: rule.id, channel, outcome })
-  })()
   const releases = []
-  // 自建池随本挂载释放；协调器/调用方注入的池由创建者释放（生命周期随归属，不跨界代管）。
-  if (ownsPool) releases.push(() => pool.dispose())
   const points = new Map()
-  // 续跑预算按来源模块一份：同模块的 turn-stop 动作共享上限，
-  // 不再按动作各建一份。本 mount 可能含多个模块（agent-assembly 一次装载全部启用模块），
-  // 因此按 moduleId 分档；来源 id 缺失时落空串兜底键（与 wireTurnStops 同源）。
-  const turnStopBudgets = new Map()
   const injections = new Map(sources.map(source => [source.moduleId, { moduleId: source.moduleId, sourceId: moduleSourceId(source.moduleId), configs: [], ruleActions: [] }]))
   // 动作级分支条件（actionWhen）也要喂 session/event：否则 else / 嵌套 if 里的 phase / count
   // 谓词永远收不到事件，状态停在冷扫那一刻（规则级 when 已由 rules 覆盖，动作级单独补齐）。
-  let active = true
   const bind = (item, on) => prepareAction(item.action, { plugin: options.plugin, warnOnce, promptConfigOptions: item.rule.promptConfigOptions, on })(ctx)
   try {
     for (const source of sources) {
@@ -84,21 +109,13 @@ export function mountRuleSources(ctx, sources, options = {}) {
       let textConfigs = []
       const flushLayers = () => {
         if (!textConfigs.length) return
-        releases.push(wireLayers(ctx, textConfigs, warnOnce, {
-          agent: options.agent,
-          turnStopBudgets,
-          sourceError,
-          on: (channel, handler) => {
-            if (channel !== point.channel) throw new TypeError(`rule action registered outside ${point.channel}: ${channel}`)
-            handlers.push({ handler }); return () => {}
-          },
-        }))
+        options.collectText(point, textConfigs)
         textConfigs = []
       }
       for (const item of point.items) {
         const { action, rule, moduleId } = item
         if (action.kind === 'inject-text') {
-          const config = { ...action.compiledConfig, rule, sourceModuleId: moduleId, variableStore: options.variableStore, group: undefined, exclusive: false, enabled: true, actionWhen: action.actionWhen, bypassRuleWhen: action.bypassRuleWhen }
+          const config = { ...action.compiledConfig, rule, sourceModuleId: moduleId, variableStore: options.variableStore, group: undefined, exclusive: false, enabled: true, actionWhen: action.actionWhen, bypassRuleWhen: action.bypassRuleWhen, runtimeOrder: action.channelOrder, runtimeRuleIndex: item.ruleIndex }
           if (config.layer === 'pre-step') injections.get(moduleId).configs.push(config)
           else textConfigs.push(config)
           continue
@@ -107,12 +124,11 @@ export function mountRuleSources(ctx, sources, options = {}) {
         const created = []
         const on = (channel, handler) => {
           if (channel !== point.channel) throw new TypeError(`rule action registered outside ${point.channel}: ${channel}`)
-          const entry = { rule, handler, sequence: action.channelOrder, sourceModuleId: moduleId, ruleId: rule.id, ruleActionIndex: action.actionIndex, id: action.id, actionWhen: action.actionWhen, bypassRuleWhen: action.bypassRuleWhen }
+          const entry = { rule, handler, sequence: action.channelOrder, sourceModuleId: moduleId, ruleId: rule.id, ruleIndex: item.ruleIndex, ruleActionIndex: action.actionIndex, id: action.id, actionWhen: action.actionWhen, bypassRuleWhen: action.bypassRuleWhen }
           if (channel === 'agent/pre-step' && point.waterfallPosition === 'default') injections.get(moduleId).ruleActions.push(entry)
           else handlers.push(entry)
           created.push(entry)
-          // 显式放弃：handler 的存活期由下面唯一的 `ctx.on(point.channel, …)` 统一撤销，
-          // 这里再返回一个真 disposer 会与它重复释放同一批 handler。
+          // handler 由稳定执行点统一分派；来源 disposer 只释放动作自身的副作用。
           return () => {}
         }
         let dispose
@@ -127,59 +143,10 @@ export function mountRuleSources(ctx, sources, options = {}) {
       }
       flushLayers()
       if (!handlers.length) continue
-      releases.push(ctx.on(point.channel, (...args) => {
-        const free = noNext.has(point.channel)
-        const payload = free ? args : args.slice(0, -1)
-        const next = free ? () => undefined : args[args.length - 1]
-        if (!active) return next()
-        // 帧构造失败（如宿主 snapshotEvents 抛错）只告警并按「无事实」跳过本点动作，
-        // 不得把异常抛出整条分派。
-        let frame
-        try {
-          frame = ruleFrame(point.channel, payload, warnOnce, ctx, report)
-        } catch (error) {
-          warnOnce(`rule engine: frame construction failed on ${point.channel}: ${String(error?.message ?? error)}`)
-          return next()
-        }
-        if (free) {
-          let pending
-          for (const entry of handlers) {
-            const invoke = () => {
-              if (!active) return undefined
-              if (!actionMatches(entry, frame)) { entry.miss?.(frame); return undefined }
-              return entry.handler(...payload, undefined, frame)
-            }
-            pending = pending?.then ? pending.then(invoke) : invoke()
-          }
-          return pending
-        }
-        if (point.phase === 'after-next') return Promise.resolve(next()).then(async initial => {
-          let result = initial
-          for (const entry of handlers) {
-            if (!active) continue
-            if (!actionMatches(entry, frame)) { entry.miss?.(frame); continue }
-            result = await entry.handler(...payload, () => result, frame)
-          }
-          return result
-        })
-        const invoke = index => {
-          if (!active || index === handlers.length) return next()
-          const entry = handlers[index]
-          if (!actionMatches(entry, frame)) {
-            entry.miss?.(frame)
-            return invoke(index + 1)
-          }
-          return entry.handler(...payload, () => invoke(index + 1), frame)
-        }
-        return invoke(0)
-      }, point.waterfallPosition === 'outermost' ? { prepend: true } : undefined))
-    }
-    // 晋升相位实例对：`options.promotion` 注入（托管路径传协调器那两份），否则从池里按配置取
-    // ——池在挂载开头已建，条件绑定也用它。共用实例后事件由池统一喂，消费者一律不得再 observe。
-    const promotion = options.promotion ?? coordinator?.promotion ?? {
-      main: pool.tracker(PROMOTE_EVENTS.either, { includeSubagents: false }),
-      withSubagents: pool.tracker(PROMOTE_EVENTS.either, { includeSubagents: true }),
+      options.collectPoint(point, handlers)
     }
+    // 各来源共用运行时拥有的晋升相位对，事件只由相位池喂入。
+    const promotion = options.promotion
     const preStep = [...injections.values()]
       .filter(source => source.configs.length || source.ruleActions.length)
       .map(source => createPreStepSource({
@@ -190,14 +157,185 @@ export function mountRuleSources(ctx, sources, options = {}) {
         onOutcome: options.onOutcome === undefined ? undefined : report => options.onOutcome({ moduleId: source.moduleId, ...report }),
         promotion,
       }))
-    if (preStep.length) releases.push(applyPromptConfigSources(preStep, { layers: false }))
+    if (preStep.length) releases.push(options.registerPreStep(preStep))
   } catch (error) {
-    active = false
     for (const dispose of releases.reverse()) { try { dispose?.() } catch {} }
     throw error
   }
   return () => {
-    active = false
     for (const dispose of releases.splice(0).reverse()) { try { dispose?.() } catch {} }
   }
 }
+
+/** 稳定执行点持有有序快照；来源仅在规则实例改变时重新绑定和注册。 */
+export function createRuleRuntime(ctx, options = {}) {
+  const warnOnce = options.warnOnce ?? createWarnOnce(ctx, options.plugin ?? 'rule-engine')
+  const coordinatorOf = () => {
+    const value = getService(ctx, PRE_STEP_COORDINATOR_SERVICE)
+    return typeof value?.registerPreset === 'function' ? value : undefined
+  }
+  const initialCoordinator = coordinatorOf()
+  const pool = options.promotionPool ?? initialCoordinator?.promotionPool ?? createPromotionPool(ctx)
+  const ownsPool = options.promotionPool === undefined && initialCoordinator?.promotionPool === undefined
+  const promotion = options.promotion ?? initialCoordinator?.promotion ?? {
+    main: pool.tracker(PROMOTE_EVENTS.either, { includeSubagents: false }),
+    withSubagents: pool.tracker(PROMOTE_EVENTS.either, { includeSubagents: true }),
+  }
+  const standalone = new Map()
+  const registrations = new Map()
+  let registeredCoordinator = initialCoordinator
+  let active = true
+  let records = new Map()
+  let points = new Map()
+  const listeners = new Map()
+  const ruleOwners = new WeakMap()
+  const memo = new Map()
+  const report = options.onOutcome === undefined ? undefined : (rule, channel, outcome) => options.onOutcome({ moduleId: ruleOwners.get(rule), ruleId: rule.id, channel, outcome })
+  let layers
+  let releaseMemo, releaseFallback
+  const register = (coordinator, source) => {
+    if (coordinator.promotion === undefined) throw new TypeError('prompt-tool: pre-step coordinator v2 must expose a promotion owner')
+    return coordinator.registerPreset(source.sourceId, { ...source, promotion: coordinator.promotion }) ?? (() => {})
+  }
+  const ensureFallback = () => {
+    if (releaseFallback !== undefined) return
+    releaseMemo = ctx.on('session/event', (session, event) => confirmDelivered(memo, session, event))
+    try {
+      releaseFallback = ctx.on('agent/pre-step', async (payload, next) => {
+        // 取得本次完整来源快照后才进入宿主，途中更新不会拼接两个版本的批次。
+        const coordinator = coordinatorOf()
+        if (coordinator !== registeredCoordinator) {
+          for (const release of registrations.values()) release()
+          registrations.clear()
+          registeredCoordinator = coordinator
+          if (coordinator !== undefined) for (const source of standalone.values()) registrations.set(source.sourceId, register(coordinator, source))
+        }
+        const sources = [...standalone.values()]
+        const decision = await next()
+        if (!active || coordinator !== undefined || sources.length === 0) return decision
+        return runPreStepBatch({ sources, ctx, payload, agent: payload?.agent, decision, memo, warnOnce })
+      }, { prepend: true })
+    } catch (error) { releaseMemo(); releaseMemo = undefined; throw error }
+  }
+  const mount = source => {
+    const record = { source, points: [], text: [], dispose: undefined }
+    for (const rule of source.rules) ruleOwners.set(rule, source.moduleId)
+    record.dispose = mountSources(ctx, [source], {
+      ...options, warnOnce, promotionPool: pool, promotion,
+      registerPreStep(sources) {
+        const installed = []
+        const dispose = () => {
+          for (const item of installed) if (standalone.get(item.sourceId) === item) {
+            standalone.delete(item.sourceId)
+            registrations.get(item.sourceId)?.()
+            registrations.delete(item.sourceId)
+          }
+        }
+        try {
+          ensureFallback()
+          for (const item of sources) {
+            if (standalone.has(item.sourceId)) throw new TypeError(`prompt-tool: duplicate pre-step source ${item.sourceId}`)
+            standalone.set(item.sourceId, item)
+            installed.push(item)
+            const coordinator = coordinatorOf()
+            if (coordinator !== undefined) {
+              try { registrations.set(item.sourceId, register(coordinator, item)) }
+              catch (error) { throw sourceError(error, source.moduleId) }
+            }
+          }
+          return dispose
+        } catch (error) { dispose(); throw error }
+      },
+      collectPoint(point, handlers) { record.points.push({ point, handlers }) },
+      collectText(point, configs) {
+        for (const config of configs) { config.runtimePoint = point; record.text.push(config) }
+      },
+    })
+    return record
+  }
+  const publishPoints = () => {
+    const next = new Map()
+    const add = (point, entry) => {
+      const key = pointKey(point)
+      const value = next.get(key) ?? { point, handlers: [] }
+      value.handlers.push(entry)
+      next.set(key, value)
+    }
+    for (const record of records.values()) for (const { point, handlers } of record.points) for (const entry of handlers) add(point, entry)
+    for (const { channel, handler, config } of layers?.entries() ?? []) {
+      const point = { ...config.runtimePoint, channel }
+      add(point, { handler, sequence: config.runtimeOrder, sourceModuleId: config.sourceModuleId, ruleIndex: config.runtimeRuleIndex, ruleActionIndex: config.ruleActionIndex ?? 0 })
+    }
+    for (const [key, value] of next) {
+      value.handlers.sort(compareEntries)
+      if (!listeners.has(key)) listeners.set(key, ctx.on(value.point.channel,
+        pointHandler(ctx, value.point, () => points.get(key)?.handlers ?? [], warnOnce, report, () => active),
+        value.point.waterfallPosition === 'outermost' ? { prepend: true } : undefined))
+    }
+    points = next
+  }
+  return {
+    replace(sources) {
+      if (!active) throw new Error('rule runtime disposed')
+      validateDeliverySources(sources)
+      const desired = new Map()
+      for (const source of sources) {
+        if (desired.has(source.moduleId)) throw sourceError(new TypeError(`duplicate rule source ${source.moduleId}`), source.moduleId)
+        desired.set(source.moduleId, source)
+      }
+      const old = records
+      const changed = [...old.values()].filter(record => desired.get(record.source.moduleId)?.rules !== record.source.rules)
+      if (changed.length === 0 && sources.length === old.size) return
+      for (const record of changed) record.dispose()
+      const created = []
+      try {
+        const next = new Map()
+        for (const source of sources) {
+          let record = old.get(source.moduleId)
+          if (record?.source.rules !== source.rules) {
+            record = mount(source)
+            created.push(record)
+          }
+          next.set(source.moduleId, record)
+        }
+        records = next
+        const text = [...records.values()].flatMap(record => record.text)
+        if (text.length > 0) layers ??= createLayerRuntime(ctx, warnOnce, { agent: options.agent, turnStopBudgets: new Map(), sourceError })
+        layers?.replace(text)
+        publishPoints()
+      } catch (error) {
+        for (const record of created.reverse()) record.dispose()
+        records = new Map(old)
+        try {
+          for (const record of changed) records.set(record.source.moduleId, mount(record.source))
+          layers?.replace([...records.values()].flatMap(record => record.text))
+          publishPoints()
+        } catch (restoreError) {
+          throw Object.assign(new AggregateError([error, restoreError], `rule source replacement and recovery failed: ${String(error.message)}; ${String(restoreError.message)}`), { sourceModuleId: error.sourceModuleId })
+        }
+        throw error
+      }
+    },
+    dispose() {
+      if (!active) return
+      active = false
+      for (const record of records.values()) record.dispose()
+      records.clear()
+      layers?.dispose()
+      for (const release of listeners.values()) release()
+      listeners.clear()
+      points.clear()
+      releaseFallback?.()
+      releaseMemo?.()
+      if (ownsPool) pool.dispose()
+    },
+  }
+}
+
+/** 兼容一次性挂载；增量调用者持有 createRuleRuntime 的来源集合。 */
+export function mountRuleSources(ctx, sources, options = {}) {
+  validateDeliverySources(sources)
+  const runtime = createRuleRuntime(ctx, options)
+  try { runtime.replace(sources) } catch (error) { runtime.dispose(); throw error }
+  return () => runtime.dispose()
+}