dsh-deeppilot 0.9.14 → 0.9.16

package/lib/index.d.ts

@@ -406,6 +406,26 @@ interface WelcomeCapabilities {
    * see binary-frame.ts). Plugin-level, independent of the host. Absent ⇒ the
    * client must keep requesting base64 text frames. */
   binaryFrames?: boolean;
+  /** Bridge honours `watchSessions` on c2s.auth.prove and c2s.session.watch:
+   * a connection that declared an interest set only receives
+   * s2c.session.event / s2c.session.queue (live and replayed) for sessions it
+   * opened or watches. Plugin-level. Absent ⇒ the client gets every
+   * session's events, as before. */
+  sessionInterest?: boolean;
+  /** Bridge compresses downlink frames over 8 KB as binary format 2
+   * (`[2][deflate-raw(envelope JSON)]`) once the client listed "deflate-raw"
+   * in `acceptEncoding` on c2s.auth.prove. Plugin-level. Absent ⇒ the field is
+   * ignored and every JSON frame stays a text frame. */
+  compressedFrames?: boolean;
+  /** Bridge answers c2s.session.open carrying `sinceSeq` with an incremental
+   * tail (`incremental: true`) holding only rows changed after that seq, or
+   * with a full tail when it cannot prove the delta complete. Plugin-level. */
+  incrementalTail?: boolean;
+  /** Bridge includes `routes` (current LAN endpoints with their certificate
+   * fingerprint, and the public Funnel URL) in s2c.welcome so the client can
+   * prefer the LAN on the same network and fall back to Funnel elsewhere.
+   * Plugin-level. */
+  routeHints?: boolean;
 }
 type SessionStatus = "running" | "idle" | "error" | "unknown";
 /**
@@ -1122,6 +1142,14 @@ interface BridgeSink {
    * every push/replay delivery; unknown broadcast types are denied.
    */
   canReceive(scope: DeviceScope): boolean;
+  /**
+   * Interest filter (capability `sessionInterest`): whether this sink wants a
+   * frame it is already permitted to receive. Connections that declared an
+   * interest set drop other sessions' events here. Absent ⇒ wants everything.
+   * The bridge consults it when sizing a replay window; sinks apply it again
+   * on every push.
+   */
+  accepts?(type: string, payload: unknown): boolean;
 }
 /**
  * Offline push fan-out (F-9 离线推送). The bridge forwards every
@@ -1140,6 +1168,42 @@ interface PushOutlet {
    */
   isAvailable(): boolean;
 }
+interface QuietCompletionResult {
+  suppressed: boolean;
+  note?: string;
+}
+interface TurnVerdict {
+  /** 本轮最近一条驱动消息是计划任务投递（且其后没有用户消息）。 */
+  scheduled: boolean;
+  /** 本轮 `turn/start` 的轮次号；日志里读不到时为 undefined。 */
+  turn?: number;
+}
+declare class QuietCompletionTracker {
+  /**
+   * 判定过计划任务轮次的会话。粘性集合：加入后不再移除，工具不按轮出现或消失。
+   * 宿主每次工具列表变化都会往会话追加一条工具增减消息并让提示词缓存失效，
+   * 按轮开关会让同一会话反复产生这类消息。
+   */
+  private readonly scheduleSessions;
+  private readonly quiet;
+  /** 启动时用宿主任务列表里的投递目标会话预热，避免重启后工具先消失再出现。 */
+  seed(sessionIds: Iterable<string>): void;
+  isScheduleSession(sessionId: string): boolean;
+  /** 加入粘性集合；返回是否为新加入（调用方据此记一次日志）。 */
+  markScheduleSession(sessionId: string): boolean;
+  /** 工具执行：只在计划任务轮次内生效。 */
+  requestQuiet(sessionId: string | undefined, verdict: TurnVerdict, seq: number): QuietCompletionResult;
+  /**
+   * 桥接层观察到 user/message：用户在请求静默之后插话（日志位置更晚）就撤销静默，
+   * 本轮照常提醒。计划任务与注入上下文不影响。
+   */
+  noteUserMessage(sessionId: string, sourceKind: string | undefined, seq: number | undefined): void;
+  /**
+   * turn.end 时调用。返回 true 表示本轮完成通知应被抑制：成功结束、且本轮请求过静默。
+   * 轮次号能对上时按轮次号判定；迟到的上一轮 turn.end 保留本轮的请求。
+   */
+  consumeTurnEnd(sessionId: string, ok: boolean, turn: number | undefined, seq: number | undefined): boolean;
+}
 interface PromptDocument {
   name: string;
   mediaType: string;
@@ -1183,6 +1247,13 @@ export declare class HostBridge {
   private readonly log?;
   readonly id: number;
   private summaries;
+  /**
+   * 列表推送节流（连接传输第二批 P5）。每个会话最近一次推出去的摘要指纹，
+   * 用来丢掉内容完全相同的重复推送；只改了 `stats` 的变化按 SUMMARY_STATS_THROTTLE_MS
+   * 合并，状态、标题、任务清单、待处理标记、活动描述的变化照旧立即推。
+   */
+  private readonly summaryPushed;
+  private readonly summaryStatsTimers;
   private activeTools;
   private approvals;
   private questions;
@@ -1191,6 +1262,8 @@ export declare class HostBridge {
    * and restore them. Excluded from `summaries` and from the live broadcast. */
   private archivedSummaries;
   private subagentSessionIds;
+  /** 计划任务按需完成通知（quiet-completion.ts）：index.ts 用它注册 Agent 工具。 */
+  readonly quietCompletion: QuietCompletionTracker;
   /**
    * 每个会话最近一次已知的队列（inbox 投影的折叠结果）及其指纹。来源是实时
    * 投影通知或打开会话时读到的基线；指纹用来丢掉内容没变的重复通知。
@@ -1269,11 +1342,24 @@ export declare class HostBridge {
    * reader without interactions.respond never gets the missed approval
    * frames back (R1/P2).
    */
+  /**
+   * 按序补发游标之后的帧。先按权限与关注集合筛出该 sink 真正会收到的帧，
+   * 估算字节数超过 REPLAY_RESYNC_BYTES 时改发 `s2c.resync`：补发是同步一次性
+   * 写出的，经 Funnel 时插件这侧看不到积压，大补发会把之后所有请求响应堵在
+   * 链路上（实测 450 帧堵 37 秒）。重新同步让客户端只拉列表和正在看的会话。
+   */
   resumeFrom(cursor: number, target?: BridgeSink): boolean;
   refreshLiveActivities(): void;
   private record;
   /** Start consuming host + mux streams. Idempotent; aborts on dispose(). */
   start(): void;
+  /**
+   * 用宿主任务列表里的投递目标会话预热计划任务会话集合，避免插件重启后工具
+   * 先消失、等下一次投递再出现（每次变化都会给会话追加工具增减消息）。
+   * `new` 目标没有固定会话，只能从最近一次投递回执里取。失败只记日志：集合仍会
+   * 在下一次投递时补上。由 index.ts 在 schedule 服务就绪、注册工具时调用。
+   */
+  seedQuietCompletionSessions(): Promise<void>;
   dispose(): void;
   private runHostStream;
   private runMuxStream;
@@ -1300,6 +1386,8 @@ export declare class HostBridge {
   private applyProjection;
   private bumpPendingFlags;
   private pushSummary;
+  private noteSummaryPushed;
+  private forgetSummaryPush;
   listSessions(): SessionSummary[];
   /**
    * Archived rows from the last sessions.list, newest first. Served only on
@@ -1316,7 +1404,7 @@ export declare class HostBridge {
   /** Resolve only the exact invocation in this session; never guess from the latest tool. */
   private loadApprovalArguments;
   /** Tail history for an opened session; pushes s2c.session.tail to the sink. */
-  openSession(sink: BridgeSink, sessionId: string, tailCount: number): Promise<boolean>;
+  openSession(sink: BridgeSink, sessionId: string, tailCount: number, sinceSeq?: number): Promise<boolean>;
   /**
    * Pull one session's projection baseline and fold every key
    * through applyProjection — unknown keys are ignored there, `null` means the