@dsh-plus/agent-preset-rea 0.0.0-stage → 0.1.0

package/src/registration.ts

@@ -0,0 +1,86 @@
+/**
+ * 预设声明的换代器：初始注册、`personaPrefix` 热更后的「注销旧 → 注册新」、卸载收尾。
+ *
+ * 注册表按 id 唯一（重复注册抛 `Duplicate agent preset`），且注销与激活都是异步的，
+ * 因此换代必须串行：同一时刻至多一个在途注册，且永远先注销上一代。串行链上的失败
+ * （重名、激活失败）只经 `onError` 上报，不让 boot 失败——与注册表的「诊断留在名册」
+ * 语义一致。
+ *
+ * 卸载后到达的 disposer 由换代器自己收掉（`disposed` 分支），调用方无需等待在途注册。
+ * @module @dsh-plus/agent-preset-rea/registration
+ */
+import type { PresetDefinition } from '@deepseek-ai/dsh-agent-preset-registry'
+
+/** 注册表返回的注销句柄。 */
+export type Unregister = () => Promise<void>
+
+export interface PresetRegistrarOptions {
+  /** 注册一份声明，返回其注销句柄（即 `ctx.agentPresets.register`）。 */
+  register(definition: PresetDefinition): Promise<Unregister>
+  /** 按当前配置构造声明（每次换代重新调用，读到的必须是活值）。 */
+  build(): PresetDefinition
+  /** 注册/注销失败的上报口（不抛）。 */
+  onError(error: unknown): void
+}
+
+/** 换代器：`refresh()` 触发一次换代，`dispose()` 停用并注销。 */
+export interface PresetRegistrar {
+  refresh(): void
+  dispose(): void
+}
+
+/**
+ * 建一个换代器并立即调度初始注册。
+ * 后台串行链不返回句柄：需要等待完成的是测试与调用方的关停流程，而不是业务路径。
+ */
+export function createPresetRegistrar(options: PresetRegistrarOptions): PresetRegistrar {
+  let disposed = false
+  let queued = false
+  let unregister: Unregister | undefined
+  let chain: Promise<void> = Promise.resolve()
+
+  const report = (error: unknown): void => {
+    options.onError(error)
+  }
+  const settle = (task: Promise<void>): void => {
+    void task.catch(report)
+  }
+
+  /** 换一代：先注销上一代，再注册按当前配置重建的声明。 */
+  const swap = async (): Promise<void> => {
+    if (disposed) return
+    const previous = unregister
+    unregister = undefined
+    if (previous !== undefined) await previous()
+    if (disposed) return
+    const next = await options.register(options.build())
+    if (disposed) {
+      await next()
+      return
+    }
+    unregister = next
+  }
+
+  const schedule = (): void => {
+    if (queued) return
+    queued = true
+    chain = chain
+      .then(async () => {
+        queued = false
+        await swap()
+      })
+      .catch(report)
+  }
+
+  schedule()
+
+  return {
+    refresh: schedule,
+    dispose: () => {
+      disposed = true
+      const pending = unregister
+      unregister = undefined
+      if (pending !== undefined) settle(pending())
+    },
+  }
+}

package/src/skill.ts

@@ -0,0 +1,24 @@
+/**
+ * 预设作用域内的 skill 根解析：随包 REA 官方 skill + 配置追加目录。
+ *
+ * 两者都只加在本预设 `skill-filesystem` 行的 `customSkillDirs`（rank 300 的
+ * **追加**根）上，因此不会进入项目根 / 用户根 / `$DSH_BUNDLED_SKILL_DIR`，
+ * 其他预设的 skill 目录不受影响。
+ * @module @dsh-plus/agent-preset-rea/skill
+ */
+import { fileURLToPath } from 'node:url'
+
+import type { AgentPresetReaConfig } from './config.ts'
+
+/**
+ * 随包 REA 官方 skill 根（包内 `skills/`）。
+ *
+ * `src/` 与构建产物 `lib/` 同为包根下一级，`../skills` 在源码直跑测试与安装后
+ * 运行产物两种位置下解析到同一目录。
+ */
+export const BUNDLED_SKILL_ROOT = fileURLToPath(new URL('../skills', import.meta.url))
+
+/** skill-filesystem 的追加根清单：随包 REA skill 在前，配置追加目录随后。 */
+export function reaSkillDirs(config: AgentPresetReaConfig): string[] {
+  return [BUNDLED_SKILL_ROOT, ...config.extraSkillDirs]
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.