@shgroup/dsh-serenity-hooks 1.31.12 → 1.32.0

package/lib/wake-scheduler.d.ts

@@ -0,0 +1,76 @@
+/**
+ * wake-scheduler.ts — trajectory 唤醒调度器（D58/D59/D60；S142 2026-09-13）
+ *
+ * 一个**中心调度器**（5min tick，复用 autopilot 的节律常量），处理 CCC 唤醒注册表里
+ * 到期的条目：把「未来时刻 + 一条 message」投递给目标 trajectory，**fire-and-forget**
+ * （无阻塞、无等待、无回执——发起方不 await，调度器不替模型结果负责）。
+ *
+ * 与 autopilot 的关系（D59）：**两个 tick 各自独立**。autopilot 是每 CCC 单例的
+ * 周期自唤醒，逻辑一行不碰；本模块只处理注册表的一次性唤醒条目。
+ *
+ * 投递路径（P-1 证据链见 SESSION.md §30.6）：
+ *  1. target（S### / 目录名）→ 目录名 + SESSION.md
+ *  2. 目标 dsh 会话 id：`.bindings.json` 里绑定该目录名的会话（按绑定时间倒序，权威）
+ *     → 回退：live 会话标题匹配
+ *  3. agent：**live 优先**（`ctx.agents.get`）→ 冷会话走 `ctx.sessionController.resolveAgent`
+ *     （宿主实现：live 优先 + resume 去重 + 由会话元数据恢复 preset）
+ *     → `sessionController` 缺席（headless profile）⇒ 仅投递 live 目标，**不静默**
+ *  4. 投递：`agent.followup(...)`（"Queue an ordinary follow-up turn and wake the driver"）
+ *
+ * 守卫（I-4 默认）：全局 `trajectoryEnabled`（旧键 `autopilotEnabled` 回退）｜
+ * 补跑窗口 2h（超窗置 missed 留痕）｜同 tick 串行｜唤起后维持 live（人类可介入）。
+ */
+import type { Context } from 'cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import { type WakeEntry } from './wake-registry.js';
+/** 投递结果（写回条目的 lastResult；人读） */
+export interface WakeDeliveryResult {
+    ok: boolean;
+    detail: string;
+}
+/** 目标定位：目录名 + SESSION.md 绝对路径 */
+interface WakeTarget {
+    dirName: string;
+    mdPath: string;
+}
+/**
+ * 解析条目的 target（`S###` 或完整目录名）→ 目录名 + SESSION.md 路径。
+ * @param root CCC 根
+ * @param target 条目里的目标标识
+ * @returns 命中返回目录信息，未命中 null
+ */
+export declare function resolveWakeTarget(root: string, target: string): WakeTarget | null;
+/** 全局闸：`trajectoryEnabled` 优先，旧键 `autopilotEnabled` 回退（设置服务不可用 → 关） */
+export declare function wakeSchedulerEnabled(): boolean;
+/**
+ * 取目标 agent：live 优先 → 冷会话走 sessionController.resolveAgent → 标题回退。
+ * @param ctx 插件上下文
+ * @param root CCC 根
+ * @param dirName 目标 trajectory 目录名
+ * @returns 命中返回 agent 与取得方式（how 进 lastResult，便于诊断）；未命中返回原因
+ */
+export declare function acquireWakeAgent(ctx: Context, root: string, dirName: string): Promise<{
+    agent: Agent;
+    how: string;
+} | {
+    error: string;
+}>;
+/** 唤醒消息（唤起即投递正文：身份锚定 + 唤醒信息 + 任务） */
+export declare function buildWakeText(entry: WakeEntry, target: WakeTarget): string;
+/**
+ * 投递一条唤醒（fire-and-forget：`followup` 入队即返回，不等模型结果）。
+ * @param ctx 插件上下文
+ * @param root CCC 根
+ * @param entry 唤醒条目
+ * @returns 投递结果（写回 lastResult）
+ */
+export declare function deliverWake(ctx: Context, root: string, entry: WakeEntry): Promise<WakeDeliveryResult>;
+/** 一次调度 tick：遍历 live CCC → 到期项串行投递 / 超窗项置 missed；返回人读摘要 */
+export declare function runWakeTick(ctx: Context): Promise<string[]>;
+/**
+ * 装配调度器（index.ts apply 调用）：5min tick + 生命周期 disposer +
+ * 会话出现/settings 变化时热启动（与 autopilot 同款触发面，互不干扰）。
+ * @param ctx 插件上下文
+ */
+export declare function registerWakeScheduler(ctx: Context): void;
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shgroup/dsh-serenity-hooks",
-  "version": "1.31.12",
-  "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：11 个工具（container_fs/logbook/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/autopilot-trajectory/im-bridge）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/自主巡航。适配 DSH 0.1.5-rc.2。",
+  "version": "1.32.0",
+  "description": "宁静号 ACC harness（Native Cordis 插件）——给 DeepSeek Harness 装一个「AI 工作区」：11 个工具（container_fs/logbook/dashboard/container_git/msm/praxis/handyman/localstore/container_admin/trajectory/im-bridge）+ 机械约束（安全模式/工作区围墙/密钥守卫/对外输出守卫）+ 工作日志与原地重建 + 网页登录入口/微信桥/子角色/对外问答页/trajectory 唤醒注册表。适配 DSH 0.1.5-rc.2。",
   "license": "MIT",
   "repository": {
     "type": "git",