@shgroup/dsh-serenity-hooks 1.26.15 → 1.26.17

package/lib/tools/handyman.d.ts

@@ -0,0 +1,43 @@
+/**
+ * handyman.ts — handyman（杂工）真实 DSH 工具（v1.24.0：loop 牛马 → handyman 杂工）
+ *
+ * 用户需求（S142 拍板）：
+ *   - **同步**（用户明确：这个事一般不会异步——工具阻塞到完成）
+ *   - **指定模型**（CCC 白名单内——handyman.models，未配置报错）
+ *   - **自主循环到完成**（stop-token 唯一完成判据，对齐 osp loop）
+ *   - **内部递归同样低能 subagent**（worker 工具面含 subagent，DSH 原生模型继承）
+ *   - **workflow 能力**（jobs 编排：主 agent 一次并行多个杂工，maxParallel 默认 10）
+ *   - **worker 不含 handyman 本身**（递归编排归主 agent，防无限嵌套）
+ *   - **不兼容旧 loop 进度文件**（仅 handyman- 前缀）
+ *
+ * 机制：ctx.agents.create()（带 setup 钩子）创建专用 agent（进程内），
+ * 每轮 followup → agent/status idle → 读 session.events 响应 → 写进度 → stop token 检查 →
+ * 未完成继续下一轮；followup/waitIdle 抛错（非正常停止）→ dispose 并重新 create agent
+ * （重启计数，≤100），同一轮重试。工厂模式：apply 时闭包捕获插件 ctx（工具 execute 无 ctx 参数）。
+ *
+ * preset 继承 + 工具收窄：setup 钩子里对子 agent 执行 agentPresets.composeFrom（对齐
+ * subagent 先例）+ tools.restrict deny handyman（worker 内部看不到 handyman 工具）。
+ */
+import type { ToolDefinition } from '@deepseek-ai/dsh-tools';
+import type { Context } from 'cordis';
+/** 非正常停止时重启 agent 的次数上限（防死循环保险阀）：对话轮次有上限，重启有上限 */
+export declare const HANDYMAN_MAX_RESTARTS = 100;
+/** 对话轮次上限（对齐 osp loop-runner 的 round>=100 强制 done 保险阀） */
+export declare const HANDYMAN_MAX_ROUNDS = 100;
+export interface HandymanJob {
+    task: string;
+    label: string;
+    model?: string;
+}
+export interface HandymanJobResult {
+    label: string;
+    done: boolean;
+    rounds: number;
+    finishReason: 'done' | 'max_rounds' | 'restart_exceeded';
+    restarts: number;
+    model: string;
+    lastResponse: string;
+    progressFile: string;
+}
+/** 创建 handyman 工具（闭包捕获插件 ctx → 可访问 ctx.agents） */
+export declare function createHandymanTool(ctx: Context): ToolDefinition;

package/lib/tools/kit.d.ts

@@ -0,0 +1,4 @@
+/**
+ * kit.ts — acc_kit 真实 DSH 工具定义（defineTool）
+ */
+export declare const kitTool: import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/tools/localstore.d.ts

@@ -0,0 +1,8 @@
+/**
+ * localstore.ts — localstore 真实 DSH 工具定义（defineTool）
+ *
+ * ACC 标准本地凭据/配置存储（S133 设计，S134 重设计：CCC 根 localstore.json）。
+ * 进程内注册，零 DSH 依赖逻辑在 localstore-ops.ts（可单测）。
+ * doc 子命令输出存储规范，agent 可直接用 fs 工具（read/write）自己读写。
+ */
+export declare const localstoreTool: import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/tools/msm.d.ts

@@ -0,0 +1,4 @@
+/**
+ * msm.ts — acc_msm 真实 DSH 工具定义（defineTool）
+ */
+export declare const msmTool: import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/tools/neat.d.ts

@@ -0,0 +1,5 @@
+/**
+ * neat.ts — Neat 设计协作协议工具（渐进式披露，ACC 标准工具化）
+ */
+export declare const NEAT_CONTENT = "# Neat Design Collaboration Protocol\n\n> Complex design is not thought up at once \u2014 it is walked out in small aligned steps.\n\n## Four Iron Rules\n| Rule | Meaning | Anti-example |\n|------|---------|--------------|\n| Small-step alignment | Advance one decision at a time; confirm before the next step | Presenting 10 options at once |\n| Explicit decisions | Every choice records rationale and alternatives | \"I feel this is good\" (no rationale) |\n| Document-driven | Conclusions land in named files (<subject>-<scope>-<type>.md) | Conclusions exist only in conversation |\n| No level-skipping | Advance strictly through the layers | Writing implementation before requirements are aligned |\n\n## Five-Layer Progression (no skipping)\nRequirements \u2192 Scope \u2192 Solution \u2192 Interface \u2192 Implementation\n| Layer | Artifact | Question |\n|-------|----------|----------|\n| Requirements | Requirements description | \"What problem are we solving?\" |\n| Scope | Scope list (in/out) | \"What is in, explicitly what is out?\" |\n| Solution | Solution comparison + selection | \"How? Which one? Why?\" |\n| Interface | Interface/protocol definition | \"How do the boundaries interact?\" |\n| Implementation | Code/docs | \"Land it layer by layer\" |\n\n## Collaboration Rhythm\n1. Raise one decision point of the current layer (with context + suggestion + rationale)\n2. Wait for confirmation or correction (small step)\n3. After confirmation, record the decision (into session SESSION.md or a design doc)\n4. Move to the next decision point";
+export declare const neatTool: import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/tools/rebuild.d.ts

@@ -0,0 +1,19 @@
+/**
+ * rebuild.ts — session_rebuild 工具定义（轨迹跟踪器，v1.22.4 定稿：复用旧会话 + 完全清空重来）
+ *
+ * LLM 主动触发清空重建（用户决策：keeper 超阈值提示 [TRAJECTORY]，不自动执行——防误清空）。
+ * v1.22.4 定稿语义（用户明确）：**复用当前 dsh 会话（同一 id），turn 结束时 surface
+ * 完全清空重建**——锚点消息「继续 {宁静号 SESSION 名} 的工作」；SESSION.md 是持久轨迹
+ * 永远原位，身份从 SESSION.md 自动延续。同一会话 id → 同工作区天然满足、无新/旧会话
+ * 之分、无需销毁/切换/归档。
+ * v1.22.5 增强（S142 用户需求）：① turn-stopping 执行 replace 后 **steer 自动继续**
+ * （无需用户手工输入，模型自动读 SESSION.md 接续）；② 锚点消息**保留 first-anchor
+ * 协议正文**（ACC 身份/EAP/协作协议，去 acknowledge 尾句——重建后直接干活）。
+ * 执行时机：工具只排队（queueRebuild），`agent/turn-stopping` 钩子执行真正 replace
+ * （turn 结束前所有 tool/result 已 append → 无孤儿；S141 INVALID_REQUEST 根治）。
+ * 服务端逻辑在 ../rebuild.ts（queueRebuild/performRebuild/registerRebuildTurnHook）。
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import type { Context } from 'cordis';
+/** 创建 session_rebuild 工具（闭包捕获 ctx → 排队清空重建，turn 结束时同一会话原地重来并自动继续） */
+export declare function createRebuildTool(ctx: Context): ReturnType<typeof defineTool>;

package/lib/tools/session.d.ts

@@ -0,0 +1,78 @@
+/**
+ * session.ts — session 真实 DSH 工具定义（defineTool）
+ *
+ * AGENT_SESSIONS/ 全周期管理：list/show/create/use/close/health/qa/archive/summary。
+ * 行为对齐 osp（opencode-serenity-plugin/src/session/session-tool.ts）——osp 是 ACC 工具 spec：
+ *   - create：--desc <desc> [--goal <goal>] 或 --issue <id>（二选一）
+ *   - close：需 --confirm 防误关
+ *   - archive：name 可缺省（批量归档）
+ *   - hook-develop-guide 子命令 + CCC session-tool MSM 扩展提示（extHint）
+ * CCC 扩展采用 osp 的"钩子后处理"模型（create-transform），而非整命令委派。
+ * 活跃会话跟踪：写内存 Map（.dsh/active-sessions/<scope> 语义）+ events 恢复（S134）。
+ *
+ * v1.21 F3（用户逻辑修正）：SESSION 是对话过程中创建的——**use 激活宁静号会话时，
+ * 同步把当前 dsh 会话重命名为该 SESSION 目录名**（sessionTitle.rename，user source
+ * pin 住标题）。非创建时预命名。
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import type { Context } from 'cordis';
+import { type ActiveSessionInfo, type CreateSessionResult } from '../session-ops.js';
+export interface RenameOnUseDeps {
+    /** naming.enabled 简单配置（DSH settings） */
+    namingEnabled: boolean;
+    /** sessionTitle 服务可用性 */
+    sessionTitleAvailable: boolean;
+}
+/**
+ * 从激活会话派生命名标题（v1.22.9 格式修正）：
+ * F3 原始需求是 **`S###-日期`**（如 `S143-2026-08-26`）——从 `sessionId` 派生，
+ * 而非完整目录名（`2026-08-24--S142--...` 超长 + 中文，不符合用户拍板格式）。
+ * 无 S### 编号（issue 会话等）→ 回退目录名。
+ * @returns `S143-2026-08-26` 或原目录名
+ */
+export declare function namingTitleFor(active: ActiveSessionInfo): string;
+/**
+ * use 激活宁静号会话后，把当前 dsh 会话重命名为命名标题（`S###-日期`）。
+ * 门控：naming.enabled + sessionTitle 服务存在；失败不静默——返回结果对象
+ * 而非 null（v1.22.9），调用方决定可见性。
+ *
+ * v1.23.2 修复（this 绑定）：第三参从**解构的裸 rename 函数**改为**整个
+ * sessionTitle 服务对象**——内部以 `titles.rename(session, title)` **方法调用**
+ * （this = titles 服务实例）。旧实现调用点 `const rename = titles.rename` 解构
+ * 后传入，方法内部读 `this.assertServiceActive` → this=undefined 抛错
+ * （日志实证：`Cannot read properties of undefined (reading 'assertServiceActive')`；
+ * 与 v1.20.2/1.20.3 图片落盘同款解构丢 this bug）。
+ * @returns { title, ok } 或 { ok:false, reason }（未执行/失败均返回对象）
+ */
+export declare function renameDshSessionOnUse(deps: RenameOnUseDeps, session: unknown, titles: {
+    rename: (session: unknown, title: string) => unknown;
+} | undefined, active: ActiveSessionInfo): {
+    ok: true;
+    title: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * 从 create 结果构造命名用 ActiveSessionInfo（v1.25.11，S142 用户：create 也要命名）：
+ * createSession 返回的 result 已含 sessionId（S###/issue）与 dirName——无需等待 use 激活，
+ * 直接构造（mdPath = sessionPath/SESSION.md，与 use 时一致）即可驱动 renameDshSessionOnUse。
+ */
+export declare function activeInfoFromCreate(result: CreateSessionResult): ActiveSessionInfo;
+/**
+ * 把当前 dsh 会话重命名为指定 SESSION 的命名标题（use/create 共用；v1.25.11）。
+ * 门控/失败可见性与 renameDshSessionOnUse 一致（不静默：成功 log / 失败 warn）。
+ * 调用点（use 分支原内联逻辑提取，create 分支复用）：
+ *   - use：激活后从 activeStore 取 info
+ *   - create：createSession 结果经 activeInfoFromCreate 构造 info
+ */
+export declare function renameDshSessionForActive(ctx: Context, exec: {
+    agent?: {
+        session?: unknown;
+    };
+}, info: ActiveSessionInfo): void;
+/**
+ * 创建 session 工具（闭包捕获插件 ctx → use 后可调 ctx.sessionTitle.rename）。
+ * v1.21 F3：use 激活宁静号会话 → 当前 dsh 会话重命名为该 SESSION 目录名。
+ */
+export declare function createSessionTool(ctx: Context): ReturnType<typeof defineTool>;

package/lib/tools/skiff-admin.d.ts

@@ -0,0 +1,25 @@
+/**
+ * skiff-admin.ts — skiff_admin ACC 工具（F4a'，v1.25.0 实验性，第 12 个工具）
+ *
+ * 教 CCC 如何定义 Skiff 角色（仿 session 工具 hook-develop-guide 的 SEP 教学模式，
+ * 用户拍板 2026-08-28：guide 定义教程 / validate 配置校验 / list 角色摘要）。
+ *
+ * 归属：ACC 机制工具（教会 + 校验），角色内容仍归 CCC 配置（.opencode/serenity.json skiff.roles）。
+ */
+import type { JsonValue } from '../json.js';
+/** Skiff 定义教程（核心）：概念 / schema / 认知 MSM 写法 / 双白名单 / 轨迹纪律 / 示例角色 */
+export declare const SKIFF_GUIDE = "\u2550\u2550\u2550 Skiff Definition Guide (F4, experimental) \u2550\u2550\u2550\n\nSkiff = \u5B81\u9759\u53F7\u653E\u51FA\u7684\u72EC\u7ACB\u5C0F\u8247\u2014\u2014\u5B8C\u6574 trajectory\uFF08\u5728\u5B81\u9759\u53F7\u5185\u5168\u77E5\u5168\u80FD\uFF09\u7684**\u4EFB\u610F\u5B50\u96C6\u89D2\u8272**\u3002\n\u7531\u672C CCC\uFF08.opencode/serenity.json skiff.roles\uFF09\u5B9A\u4E49\uFF1A\u80FD\u529B\u9762\uFF08\u53CC\u767D\u540D\u5355\uFF09+ \u8F68\u8FF9\u7EAA\u5F8B\u5B50\u96C6 + \u7CFB\u7EDF\u63D0\u793A\u8BCD\u3002\ndsp \u53EA\u63D0\u4F9B\u673A\u5236\uFF08\u53CC\u767D\u540D\u5355\u5F3A\u5236 + \u57FA\u7840\u63D0\u793A\u8BCD + \u8C03\u8BD5\u95EE\u7B54\u9875\uFF09\uFF1B\u89D2\u8272\u5185\u5BB9\u5B8C\u5168\u7531 CCC \u53D1\u6325\u3002\n\n\u2500\u2500 \u89D2\u8272\u914D\u7F6E schema \u2500\u2500\n  { \"skiff\": { \"roles\": {\n      \"<role-name>\": {\n        \"model\": \"provider/model\",             // \u89D2\u8272\u6A21\u578B\uFF08CCC \u76F4\u63A5\u6307\u5B9A\uFF0C\u65E0\u767D\u540D\u5355\u6821\u9A8C\uFF1B\u7F3A\u7701\u56DE\u9000 handyman.defaultModel\uFF09\n        \"msms\": [\"msm-a\", \"msm-b\"],            // MSM \u767D\u540D\u5355\uFF08\u72EC\u7ACB\uFF09\uFF1Aacc_msm exec \u53EA\u80FD\u8DD1\u8FD9\u4E9B\uFF1Bregister/deregister \u5FC5\u62D2\uFF1Blist \u53EA\u663E\u793A\u8FD9\u4E9B\n        \"tools\": [\"read\",\"grep\",\"glob\",...],   // \u975E MSM \u5DE5\u5177\u767D\u540D\u5355\uFF08\u72EC\u7ACB\uFF09\uFF1A\u767D\u540D\u5355\u5916\u5DE5\u5177\u4E00\u5F8B\u4E0D\u53EF\u7528\uFF08guard \u5F3A\u5236\uFF09\n        \"trajectory\": { \"session\": false, \"keeper\": false, \"rebuild\": false },  // \u8F68\u8FF9\u7EAA\u5F8B\u5B50\u96C6\uFF08\u7F3A\u7701\u5168\u5173 = \u5B8C\u5168\u72EC\u7ACB\uFF09\n        // \u89D2\u8272\u4EBA\u683C/\u8BA4\u77E5\u8FB9\u754C/\u98CE\u683C\uFF08CCC \u5B8C\u6574\u5B9A\u4E49\uFF1Bdsp \u53EA\u7ED9\u57FA\u7840\u63D0\u793A\u8BCD\uFF09\n        \"systemPromptFile\": \".opencode/skiff/<role>.md\"   // \u2605 \u63A8\u8350\uFF1A\u5F15\u7528 md \u6587\u4EF6\uFF08\u76F8\u5BF9 CCC \u6839\uFF1B\u8D85\u957F\u63D0\u793A\u8BCD\u5728 JSON \u5185\u5D4C\u4E0D\u53EF\u8BFB\uFF09\n        // \"systemPrompt\": \"...\"                          // \u517C\u5BB9\uFF1A\u5185\u5D4C\u5B57\u7B26\u4E32\u4ECD\u53EF\u7528\uFF1B\u4E24\u8005\u90FD\u8BBE\u65F6 systemPromptFile \u4F18\u5148\n      }\n  } } }\n\n\u2500\u2500 \u53CC\u767D\u540D\u5355\u8BED\u4E49\uFF08\u5168\u6309\u767D\u540D\u5355\u66B4\u9732\uFF0C\u767D\u540D\u5355\u5916\u5168\u9690\u85CF\uFF09\u2500\u2500\n  - tools \u7A7A + msms \u975E\u7A7A = \u7EAF MSM \u89D2\u8272\uFF08\u8BA4\u77E5\u95EE\u7B54\u5178\u578B\u5F62\u6001\uFF09\n  - msms \u975E\u7A7A \u2192 acc_msm \u5DE5\u5177\u81EA\u52A8\u53EF\u7528\uFF08MSM \u901A\u9053\uFF09\n  - \u767D\u540D\u5355\u5916\u5DE5\u5177\u5373\u4F7F DSH \u672A\u6765\u65B0\u589E\u4E5F\u81EA\u52A8\u88AB\u6321\uFF08guard \u6309\u89D2\u8272\u5224\u5B9A\uFF0C\u4E0D\u679A\u4E3E\u5DE5\u5177\u540D\u2014\u2014\u5B8C\u5907\u6027\uFF09\n\n\u2500\u2500 \u8BA4\u77E5 MSM \u5199\u6CD5\uFF08\u8BFB\u77E5\u8BC6 / \u64CD\u4F5C\u80FD\u529B\uFF09\u2500\u2500\n  - \u8BFB\u77E5\u8BC6\uFF1A\u811A\u672C\u8BFB CCC \u5185\u6587\u4EF6\uFF08SERENITY_ROOT env \u6CE8\u5165\uFF09\u2192 \u8F93\u51FA\u7B54\u6848/\u6458\u8981\uFF08\u5982 cognitive-qa\uFF09\n  - \u64CD\u4F5C\u80FD\u529B\uFF1A\u811A\u672C\u8C03\u7528\u65E2\u6709\u5BB6\u5EAD\u5DE5\u5177/\u670D\u52A1\uFF08SSH/API/\u6587\u4EF6\u64CD\u4F5C\uFF09\u2014\u2014\u89D2\u8272\u80FD\u529B\u4E0A\u9650 = \u767D\u540D\u5355 MSM \u7684\u5B9E\u9645\u884C\u4E3A\n  - \u4F8B\uFF1Acognitive-qa\uFF08\u8BFB docs/references \u56DE\u7B54\uFF09\u3001review-scan\uFF08\u8BFB\u4EE3\u7801\u51FA\u5BA1\u67E5\u610F\u89C1\uFF09\u3001review-fix\uFF08\u5199\u4FEE\u590D\uFF09\n  - \u6CE8\u610F\uFF1AMSM \u5728\u811A\u672C\u5C42\u6267\u884C\uFF08bun\uFF09\uFF0C\u6587\u4EF6\u8BBF\u95EE\u4E0D\u53D7 agent \u5DE5\u5177\u9762\u7EA6\u675F\u2014\u2014\"\u53EA\u8BFB\"\u8BED\u4E49\u9760 CCC \u81EA\u5199 MSM \u81EA\u89C9\n\n\u2500\u2500 \u8F68\u8FF9\u7EAA\u5F8B\u5B50\u96C6\uFF08trajectory\uFF09\u2500\u2500\n  - session/keeper/rebuild \u9ED8\u8BA4 false\uFF1ASkiff \u5B8C\u5168\u72EC\u7ACB\uFF08\u4E0D\u5EFA SESSION.md\u3001\u65E0 keeper \u63D0\u9192\u3001\u65E0 rebuild \u538B\u529B\u68C0\u6D4B\uFF09\n  - \u5F00\u542F\u67D0\u9879 = \u8BE5\u89D2\u8272\u53C2\u4E0E\u5BF9\u5E94\u8F68\u8FF9\u673A\u5236\uFF08\u5982 keeper=true \u8BA1\u5206\u63D0\u9192\u6309\u89D2\u8272\u751F\u6548\uFF09\n\n\u2500\u2500 \u793A\u4F8B\u89D2\u8272 \u2500\u2500\n  qa-readonly: { \"msms\": [\"cognitive-qa\"], \"tools\": [], \"trajectory\": {} }\n      \u2192 \u8BA4\u77E5\u95EE\u7B54\uFF08\u4EC5 MSM \u901A\u9053\uFF0C\u65E0\u76F4\u63A5\u5DE5\u5177\uFF0C\u5B8C\u5168\u72EC\u7ACB\uFF09\n  code-review: { \"msms\": [\"review-scan\",\"review-fix\"], \"tools\": [\"read\",\"grep\",\"glob\",\"write\",\"edit\"], \"trajectory\": { \"keeper\": true } }\n      \u2192 \u6709\u64CD\u4F5C\u80FD\u529B\uFF08\u53EF\u5199\u4FEE\u590D\uFF09\uFF0C\u53C2\u4E0E keeper \u8F68\u8FF9\u673A\u5236\n\n\u2500\u2500 \u8FD0\u884C \u2500\u2500\n  \u8C03\u8BD5\uFF1A\u8BBE\u7F6E\u9762\u677F\u300CSerenity\u300D\u9875 Skiff \u533A\u5757\u5F00\u542F \u2192 http://127.0.0.1:<debugPort> \u95EE\u7B54\u9875\u5B9E\u6D4B\n  ACP \u7A0B\u5E8F\u5316\u9762\uFF08v1.26.0\uFF09\uFF1A\u8BBE\u7F6E\u9762\u677F\u300CACP\u300D\u533A\u5757\u5F00\u542F \u2192 HTTP JSON-RPC \u7AEF\u70B9\uFF08\u9ED8\u8BA4 3100\uFF09\u2014\u2014\n    POST /  {jsonrpc, id, method, params}\n    session/new {ccc, role, sessionId?}  \u2192 \u521B\u5EFA/\u5EF6\u7EED\u4F1A\u8BDD\uFF08sessionId \u53EF\u9009=\u8FDB\u7A0B\u5185\u8FFD\u95EE\uFF09\n    session/prompt {sessionId, question} \u2192 {answer, trajectory}\n    session/cancel / session/close / session/list / request_permission\uFF08\u6052 allow\uFF09\n  \u542F\u505C = \u4EBA\u5DE5\uFF08\u8BBE\u7F6E\u9762\u677F\u5F00\u5173\uFF0C\u4E0D\u968F\u63D2\u4EF6\u52A0\u8F7D\u81EA\u52A8\u542F\u52A8\uFF09\uFF1B\u672A\u5F00\u542F\u96F6\u8D44\u6E90\u5360\u7528\n  \u751F\u6548\u673A\u5236\uFF1A\u89D2\u8272\u914D\u7F6E**\u5B9E\u65F6\u8BFB\u53D6**\uFF08\u6539 .opencode/serenity.json \u2192 \u5237\u65B0\u8C03\u8BD5\u9875\u5373\u751F\u6548\uFF09\uFF1B\n  \u6539\u914D\u7F6E\u540E\u7528 skiff_admin apply \u505A\u663E\u5F0F\u6821\u9A8C + \u5E94\u7528\u786E\u8BA4\uFF08\u7ED1\u5B9A CCC + \u89D2\u8272\u6E05\u5355\uFF09\n  \u4F1A\u8BDD\u8FFD\u95EE\uFF08v1.25.10\uFF09\uFF1A\u8C03\u8BD5\u9875\u6301\u6709\u5F53\u524D\u4F1A\u8BDD\uFF0C\u8FFD\u95EE\u81EA\u52A8\u7EED\u63A5\uFF08\u540C\u4F1A\u8BDD\u4E0A\u4E0B\u6587\u5EF6\u7EED\uFF09\uFF1B\n  \u300C\u65B0\u5BF9\u8BDD\u300D\u6309\u94AE\u5F00\u65B0\u4F1A\u8BDD\uFF1B\u8FDB\u7A0B\u91CD\u542F\u540E\u65E7\u4F1A\u8BDD\u4E0D\u53EF\u7EED\uFF08WebUI \u4ECD\u53EF\u89C1\u5386\u53F2\uFF09\n  \u6CE8\u610F\uFF1Askill \u52A0\u8F7D\u5BF9 skiff **\u6052\u53EF\u7528**\uFF08\u4E0D\u8BBE\u767D\u540D\u5355\u2014\u2014\u8BFB\u77E5\u8BC6\u9762\uFF0C\u65E0\u5199\u80FD\u529B\uFF09";
+/** 校验当前 CCC 的 skiff 配置：roles schema 合法 / msms 均已注册 / model ∈ handyman.models / systemPrompt 非空 */
+export declare function validateSkiffConfig(root: string): JsonValue;
+/** 列出当前 CCC 已定义角色（名 / 模型 / msms / tools / 轨迹纪律摘要） */
+export declare function listSkiffRoles(root: string): JsonValue;
+/**
+ * 应用当前 skiff 配置（v1.25.3，S142 用户：改了 json 应该有个生效机制）。
+ *
+ * 语义：配置是**每次请求实时读取**的（v1.25.2）——apply 不是"推送"，而是**显式校验 + 应用确认**：
+ * ① 校验配置合法（复用 validate：msms 注册 / model 白名单 / systemPrompt 非空）
+ * ② 非法 → 报告问题清单，不应用（提示修复后重跑 apply）
+ * ③ 合法 → 应用确认：绑定 CCC + 角色清单 + 说明（调试页刷新即生效）
+ */
+export declare function applySkiffConfig(root: string): JsonValue;
+export declare const skiffAdminTool: import("@deepseek-ai/dsh-tools").ToolDefinition;

package/lib/totp.d.ts

@@ -0,0 +1,40 @@
+/**
+ * totp.ts — TOTP 第二因素（RFC 6238，零依赖，v1.22.4）
+ *
+ * 背景（S142 安全审计 S1）：公网暴露密码登录不足 → 可选 Authenticator 第二因素。
+ * 实现：HMAC-SHA1 TOTP（与 Google Authenticator / 1Password / Aegis 等兼容），
+ * base32 secret（RFC 4648 无填充），30s 时步，6 位码，允许 ±1 时步漂移。
+ * 零依赖（node:crypto HMAC），可单测。
+ *
+ * 边界：本模块只做纯算法（生成/校验/URI），secret 的存储/绑定由 config-ops +
+ * gateway 登录流负责（wire 层永不返回 secret，只返回 hasTotp 布尔）。
+ */
+/** 时步（秒）——RFC 6238 默认 30 */
+export declare const TOTP_STEP_SECONDS = 30;
+/** 验证窗口：当前时步 ± 1（容忍时钟漂移/生成延迟） */
+export declare const TOTP_WINDOW = 1;
+/** 输出位数（标准 6 位） */
+export declare const TOTP_DIGITS = 6;
+/** 字节 → base32（无填充）。secret 显示/otpauth URI 用。 */
+export declare function base32Encode(bytes: Uint8Array): string;
+/** base32（无填充，大小写不敏感）→ 字节；非法字符抛错。 */
+export declare function base32Decode(input: string): Uint8Array;
+/** 生成新 TOTP secret（20 字节 = 160-bit，RFC 4226 推荐 ≥128-bit；返回 base32） */
+export declare function generateTotpSecret(): string;
+/** 一个时步的 TOTP code（6 位，前导零保留）。counter = floor(epochSeconds / step) */
+export declare function totpCode(secretBase32: string, counter: number): string;
+/** 当前 epoch 秒 */
+export declare function nowEpochSeconds(): number;
+/**
+ * 校验用户输入的 code（允许 ±TOTP_WINDOW 时步漂移，防重放窗口内同 code 复用由
+ * 调用方按账号记录最近成功 counter 实现——本函数只做纯算法校验）。
+ * @returns 命中的 counter（用于防重放）；不匹配返回 null。
+ */
+export declare function verifyTotpCode(secretBase32: string, code: string, nowSeconds?: number): number | null;
+/**
+ * 生成 otpauth://totp URI（标准格式，主流 Authenticator 兼容）。
+ * @param secretBase32 - base32 secret
+ * @param label - 账号标识（如 "yh@serenity-home"）
+ * @param issuer - 发行方（如 "Serenity Home"）
+ */
+export declare function otpauthUri(secretBase32: string, label: string, issuer: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.26.15",
+  "version": "1.26.17",
   "description": "宁静号 ACC harness — Native Cordis 插件（DeepSeek Harness 运行时）。真实 DSH 工具注册（cc_fs/session/acc_msm 等 9 工具）+ 拦截缝机械约束（safe-mode/路径守卫/会话落盘）+ 系统提示词注入（ACC/CCE/Constraints/SKILL/Session 五块）。适配 DSH 公开版（deepseek-ai/deepseek-harness 0.1.0-rc）。",
   "license": "MIT",
   "repository": {
@@ -25,7 +25,9 @@
     "lib/index.js",
     "lib/client.js",
     "lib/invariant.js",
-    "lib/types/**/*.d.ts",
+    "lib/*.js",
+    "lib/*.d.ts",
+    "lib/**/*.d.ts",
     "cordis.patch.yml",
     "dsh.plugin.json",
     "README.md",
@@ -35,8 +37,8 @@
   "scripts": {
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
-    "build": "tsc -p tsconfig.json && tsdown -c tsdown.config.ts",
-    "prepare": "tsdown --config tsdown.prepare.config.ts"
+    "build": "tsdown -c tsdown.config.ts && tsc -p tsconfig.json --emitDeclarationOnly",
+    "prepare": "tsdown --config tsdown.prepare.config.ts && tsc -p tsconfig.json --emitDeclarationOnly"
   },
   "dsh": {
     "bundle": {