dsh-client-auto-continue 0.11.2 → 0.11.4

package/lib/types/host/engine.d.ts

@@ -21,7 +21,7 @@ export interface HostNotice {
     title: string;
     body: string;
     /** 会话 id(通知按钮「立即续跑 / 暂停该会话」作用于它)。 */
-    sessionId?: SessionId;
+    sessionId: SessionId;
     actions: NotifyAction[];
     /** 产生时间。 */
     at: number;
@@ -74,8 +74,8 @@ export declare class AutoContinueRunner {
     private checkLoop;
     /**
      * 打断运行中的回合: cancel(带来源标记)+ 进冷却。
-     * 随后的 turn/end aborted 会因 loopCancelled 走「可恢复中断」路径,
-     * 用 loopText 重启回合——不会与用户手动停止混淆。
+     * 只有随后持久化的 turn/end 精确携带专属 hook cause 时,
+     * 才会用 loopText 重启回合——DSH 的 first-cause 语义保证用户 Stop 优先。
      */
     private interruptLoop;
     private onSessionEvent;

package/lib/types/shared/core.d.ts

@@ -152,21 +152,92 @@ export interface ToolResultFacts {
     ok: boolean;
     /** 工具输出的文本摘要(截断)。 */
     excerpt: string;
+    /** 完整模型可见内容 + 错误状态的定长稳定指纹(loop guard 比较用)。 */
+    identity: string;
 }
-/** 从 tool/result 事件载荷提取成功与否与文本摘要。 */
-export declare function toolResultFacts(data: {
+interface ToolResultData {
+    turn?: unknown;
+    step?: unknown;
     error?: {
         name?: string;
         code?: string;
     };
     message?: {
+        source?: {
+            kind?: string;
+            callId?: unknown;
+        };
         content?: Array<{
             type?: string;
+            toolCallId?: unknown;
             content?: unknown;
             isError?: boolean;
         }>;
     };
-}): ToolResultFacts;
+}
+/**
+ * 取工具结果的关联 id。新版 DSH 的权威位置是 message.source.callId，
+ * 同时接受模型可见 block 上的 toolCallId；两者冲突时宁可忽略，不猜测配对。
+ */
+export declare function toolResultCallId(data: ToolResultData): string | undefined;
+/** 从 tool/result 事件载荷提取成功与否与文本摘要。 */
+export declare function toolResultFacts(data: ToolResultData): ToolResultFacts;
+/** loop guard 在后续 step 边界确认的连续重复信号。 */
+export interface ToolRepeatSignal {
+    tool: string;
+    count: number;
+}
+export type ToolGuardState = {
+    kind: 'none';
+} | {
+    kind: 'pending';
+    tool: string;
+} | {
+    kind: 'done';
+    tool: string;
+    result: string;
+} | {
+    kind: 'failed';
+    tool: string;
+};
+/**
+ * 每个会话的工具调用关联器。
+ *
+ * 集中封装事件关联、step 边界确认、护栏读取与重置。内部按 callId 配对，
+ * 乱序结果先缓存、再按调用顺序推进 loop 计数。队列和去重 id 都有硬上限；
+ * 超限或载荷无法关联时会打断重复计数，宁可漏报也不误杀健康回合。
+ */
+export declare class ToolInvocationTracker {
+    private readonly pendingById;
+    private readonly pendingInOrder;
+    private readonly seenCalls;
+    private readonly seenInOrder;
+    private latest;
+    private run;
+    private repeatSignal;
+    private lastEventSeq;
+    reset(): void;
+    /** 新回合边界：清空工具态，同时把重放水位推进到 turn/start。 */
+    startTurn(seq: number): void;
+    /** 回合已结束：保留最后一次调用的护栏，丢弃不再可用的 loop 关联态。 */
+    resetRepeat(): void;
+    recordCall(event: SessionEvent<'tool/call'>): boolean;
+    recordResult(event: SessionEvent<'tool/result'>): ToolRepeatSignal | undefined;
+    guard(): ToolGuardState;
+    lastTool(): string | undefined;
+    /** 下一模型 step 是稳定边界；此前 replacement/新调用会先清除候选。 */
+    confirmRepeatAtStep(seq: number): ToolRepeatSignal | undefined;
+    /** 非工具 surface range replacement（如 compaction summary）同样终止旧工具证据。 */
+    recordSurfaceReplacement(seq: number): void;
+    restore(events: readonly SessionEvent[], untilSeq: number): void;
+    private acceptEventSeq;
+    private breakCorrelation;
+    private invalidateRunHistory;
+    private trim;
+    private drainCompleted;
+    private advanceRun;
+    private refreshRepeatSignal;
+}
 /** 自适应退避: 同一会话连续失败时的有效冷却间隔。 */
 export declare function effectiveCooldown(consecutive: number, base: number, factor: number, max: number): number;
 export declare function sleep(ms: number): Promise<void>;
@@ -196,12 +267,10 @@ export declare function emptyDayStats(): DayStats;
 export interface SessionState {
     /** 连续自动「继续」次数; 成功回合或用户手动介入后归零。 */
     consecutive: number;
-    /** 上次自动「继续」时间戳。 */
-    lastAutoAt: number;
     /** 上次自动「继续」尝试(成功或失败)时间戳; 防止失败场景下的快速重试循环。 */
     lastAttemptAt: number;
-    /** 我们上次自动发送的文本(用于识别自己的回显)。 */
-    lastSentText: string;
+    /** 尚未回显到会话事件流的自动发送消息 ID。 */
+    pendingEchoMessageIds: Map<string, number>;
     /** 宽限期定时器(进行中的待发送)。 */
     pendingTimer: ReturnType<typeof setTimeout> | undefined;
     /** 宿主权威 running 位(来自 host/session-status 与回合事件)。 */
@@ -214,10 +283,8 @@ export interface SessionState {
     lastFailure: FailureFacts | undefined;
     /** 最近一次失败的发生时间(模板 {elapsed} 与恢复统计用)。 */
     lastFailureAt: number;
-    /** 失败前最后一次工具调用的名称(模板 {tool} 与幂等护栏用)。 */
-    lastTool: string | undefined;
-    /** 上一步工具调用的结果状态: 'pending' = 已发起未见结果(可能已部分执行)。 */
-    lastToolResult: 'pending' | ToolResultFacts | undefined;
+    /** callId 精确配对的工具调用、幂等护栏与 loop 重复态。 */
+    tools: ToolInvocationTracker;
     /** 失败回合的编号(模板 {turn})。 */
     lastTurn: number | undefined;
     /** 我们最近一次自动发送的时间戳; 0 = 没有待确认的恢复。 */
@@ -230,29 +297,18 @@ export interface SessionState {
     lastAssistantText: string;
     /** 连续相同文本消息数(最强空转信号, 不限长度)。 */
     sameTextRun: number;
-    /**
-     * 工具重复信号(loop guard 信号 2: 死循环)。
-     * 只有「同工具 + 同参数 + 同结果」的连续调用才累计; 参数或结果有变化视为有进展, 计数重置。
-     */
-    toolRun: {
-        /** 工具名 + 参数(用于判定是否同一调用)。 */
-        key: string;
-        /** 连续相同调用数(结果确认后更新)。 */
-        count: number;
-        /** 上次该调用的结果摘要(比较用)。 */
-        lastResult: string | undefined;
-        /** 本次调用等待结果确认。 */
-        waiting: boolean;
-    } | undefined;
     /** 本回合已触发过 loop guard(防重复打断)。 */
     loopFired: boolean;
     /** loop 重启的延迟定时器(冷却结束后再 schedule)。 */
     loopRetryTimer: ReturnType<typeof setTimeout> | undefined;
-    /** 我们主动 cancel 过本回合(区分用户停止)。 */
-    loopCancelled: boolean;
 }
 export declare const freshState: () => SessionState;
 export declare const RECOVERY_WINDOW_MS: number;
 export declare const ECHO_WINDOW_MS: number;
+/** Track an identified plugin message before handing it to the host queue. */
+export declare function trackPendingEcho(state: SessionState, messageId: string): void;
+/** Roll back tracking when the host rejects a queued message. */
+export declare function forgetPendingEcho(state: SessionState, messageId: string): void;
+/** Match and consume one plugin-owned `user/message` event by stable message ID. */
 export declare function isOurEcho(state: SessionState, event: SessionEvent): boolean;
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-client-auto-continue",
   "description": "DSH Web UI plugin: automatically sends a localized continue prompt when a request is interrupted by network errors or other non-human causes",
-  "version": "0.11.2",
+  "version": "0.11.4",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",