dsh-client-auto-continue 0.4.4 → 0.5.0

package/lib/index.js

@@ -5,6 +5,8 @@ var AUTO_CONTINUE_NS = "auto-continue";
 var AutoContinueSchema = z.object({
   /** Text automatically sent after an interruption. */
   continueText: z.string().default("继续"),
+  /** Text sent when the output token ceiling is reached (same placeholders as `continueText`). */
+  continueTextMaxTokens: z.string().default("继续"),
   /** Grace period after an interruption before auto-sending (ms). */
   graceMs: z.natural().default(3e3),
   /** Minimum interval between two auto-continues per session (ms). */
@@ -30,7 +32,9 @@ var AutoContinueSchema = z.object({
   /** Cap on the effective backoff interval (ms). */
   backoffMaxMs: z.natural().default(3e5),
   /** Show browser notifications for auto-continue events. */
-  notify: z.boolean().default(false)
+  notify: z.boolean().default(false),
+  /** Globally pause auto-continue: no live or scan send. */
+  paused: z.boolean().default(false)
 });
 function apply(ctx) {
   ctx.inject(["settings"], (settingsCtx) => {

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

@@ -10,11 +10,13 @@
  * All behavior is driven by the `auto-continue` settings namespace (see the
  * plugin's settings card); every knob below is user-configurable there.
  */
-import type { IApiClient } from '@deepseek-ai/dsh-client-connection/client';
+import type { IApiClient, SessionId } from '@deepseek-ai/dsh-client-connection/client';
 /** The `auto-continue` settings section (all fields optional on the wire; the host schema carries defaults). */
 export interface AutoContinueSettings {
     /** Text automatically sent after an interruption. */
     continueText?: string;
+    /** Text sent when the output token ceiling is reached (same placeholders as `continueText`). */
+    continueTextMaxTokens?: string;
     /** Grace period after an interruption before auto-sending (ms). */
     graceMs?: number;
     /** Minimum interval between two auto-continues per session (ms). */
@@ -41,6 +43,8 @@ export interface AutoContinueSettings {
     backoffMaxMs?: number;
     /** Show browser notifications for auto-continue events. */
     notify?: boolean;
+    /** Globally pause auto-continue: no live or scan send, queued pending sends cancelled. */
+    paused?: boolean;
 }
 /** Fully resolved configuration (built-in defaults + user overrides). */
 export type AutoContinueConfig = Required<AutoContinueSettings>;
@@ -69,10 +73,69 @@ export declare function isTransientFailure(failure: FailureFacts): boolean;
  * 序列化失败(如 Windows 下 abort 的 DOMException reason)绝不能自动续跑。
  */
 export declare function isTransientAgentError(message: string): boolean;
-/** 用失败事实与回合信息填充 continueText 模板占位符({code}/{message}/{status}/{tool}/{turn})。 */
-export declare function fillTemplate(template: string, facts: FailureFacts | undefined, tool: string | undefined, turn: number | undefined): string;
+/** 通知上的一个操作按钮(action 标识 + 显示文案)。 */
+export interface NotifyAction {
+    /** 稳定动作标识, 点击时经 onAction 回调传出。 */
+    action: string;
+    /** 按钮显示文案。 */
+    title: string;
+}
+/** 通知的可选行为: 操作按钮列表与点击回调。 */
+export interface NotifyOptions {
+    actions?: NotifyAction[];
+    onAction?: (action: string) => void;
+}
+/** 模板填充所需的上下文(全部可选, 缺失的占位符填为空串)。 */
+export interface TemplateContext {
+    /** 失败事实(错误码/消息/HTTP 状态), 对应 {code}/{message}/{status}。 */
+    facts?: FailureFacts;
+    /** 失败前最后一次工具调用的名称, 对应 {tool}。 */
+    tool?: string;
+    /** 失败回合的编号, 对应 {turn}。 */
+    turn?: number;
+    /** 连续失败次数(含本次), 对应 {errorCount}。 */
+    errorCount?: number;
+    /** 会话标题(来自 session.list 投影, 可用时), 对应 {sessionTitle}。 */
+    sessionTitle?: string;
+    /** 自失败发生以来的毫秒数, 对应 {elapsed}。 */
+    elapsedMs?: number;
+}
+/** 用失败事实与回合信息填充 continueText 模板占位符({code}/{message}/{status}/{tool}/{turn}/{errorCount}/{sessionTitle}/{elapsed})。 */
+export declare function fillTemplate(template: string, ctx: TemplateContext): string;
 /** 自适应退避: 同一会话连续失败时的有效冷却间隔。 */
 export declare function effectiveCooldown(consecutive: number, base: number, factor: number, max: number): number;
+/** 暂停某会话: 到 `until` 之前, 引擎不会为该会话自动继续(通知按钮等调用)。 */
+export declare function pauseSession(sessionId: SessionId, ms: number): void;
+/** 解除某会话的暂停。 */
+export declare function unpauseSession(sessionId: SessionId): void;
+/** 会话暂停的截止时间戳; 0 表示未暂停。 */
+export declare function sessionPauseUntil(sessionId: SessionId): number;
+/** 当前生效(未过期)的暂停会话列表; 顺带清理过期条目。 */
+export declare function pausedSessions(): {
+    sessionId: SessionId;
+    until: number;
+}[];
+/** 一天的自动继续统计。 */
+export interface DayStats {
+    /** 本地日期 YYYY-MM-DD。 */
+    date: string;
+    /** 自动发送次数。 */
+    sent: number;
+    /** 因永久性错误跳过的次数。 */
+    skipped: number;
+    /** 发送后回合成功完成(恢复成功)的次数。 */
+    recovered: number;
+    /** 发送后再次失败的次数。 */
+    failed: number;
+    /** 达到连续上限而停止的次数(按停止事件计)。 */
+    gaveUp: number;
+    /** 按错误码计数的失败分布。 */
+    byCode: Record<string, number>;
+}
+/** 今日统计(设置卡片展示用)。 */
+export declare function readTodayStats(): DayStats;
+/** 清零今日统计。 */
+export declare function resetTodayStats(): void;
 /** 插件主体: 一条 mux 流 + 一条 host 流 + 启动/重连扫描。 */
 export declare class AutoContinueRunner {
     private readonly api;
@@ -97,11 +160,22 @@ export declare class AutoContinueRunner {
     private onHostFrame;
     /** 回合失败入口: 先做错误分类, 永久性失败跳过并通知, 临时性失败走正常调度。 */
     private onTurnFailure;
+    /** 通知操作按钮与回调(「立即续跑」/「暂停该会话 1 小时」)。 */
+    private notifyOptions;
+    private onNotifyAction;
+    /** 恢复结果记账: 自动发送后窗口内的回合结束, 判定恢复成功或失败。 */
+    private noteRecovery;
+    /** 立即为该会话发送一次自动继续(无视冷却与连续上限; 由通知按钮触发)。 */
+    resumeNow(sessionId: SessionId): Promise<void>;
     /** 本会话当前生效的冷却间隔(自适应退避)。 */
     private cooldownFor;
     private schedule;
     private cancelPending;
     private fire;
+    /** 会话标题缓存(来自 session.list 投影, {sessionTitle} 占位符用)。 */
+    private readonly titles;
+    /** 查一次 session.list, 顺带缓存该会话的标题。 */
+    private fetchSessionInfo;
     private runningViaList;
     private scheduleReconnectScan;
     private bootScanLoop;

package/lib/types/client/index.d.ts

@@ -23,6 +23,7 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
 }
 /** Services required by this plugin. */
 export declare const inject: string[];
+export { fillTemplate, pauseSession, pausedSessions, readTodayStats, resetTodayStats, sessionPauseUntil, unpauseSession, } from './engine.ts';
 /**
  * Plugin body: mount the engine and the settings card.
  * @param ctx - client root context.

package/lib/types/client/locales.d.ts

@@ -7,8 +7,12 @@
 export declare const zh: {
     'card.title': string;
     'card.description': string;
+    'field.paused': string;
+    'field.pausedHint': string;
     'field.continueText': string;
     'field.continueTextHint': string;
+    'field.continueTextMaxTokens': string;
+    'field.continueTextMaxTokensHint': string;
     'field.graceMs': string;
     'field.graceMsHint': string;
     'field.cooldownMs': string;
@@ -35,6 +39,20 @@ export declare const zh: {
     'field.backoffMaxMsHint': string;
     'field.notify': string;
     'field.notifyHint': string;
+    'stats.title': string;
+    'stats.sent': string;
+    'stats.skipped': string;
+    'stats.recovered': string;
+    'stats.failed': string;
+    'stats.gaveUp': string;
+    'stats.byCode': string;
+    'stats.empty': string;
+    'stats.reset': string;
+    'pause.title': string;
+    'pause.none': string;
+    'pause.clearAll': string;
+    'pause.unpause': string;
+    'pause.minutes': string;
     'chrome.collapse': string;
     'chrome.expand': string;
     'chrome.unsaved': string;

package/lib/types/client/settings-card.d.ts

@@ -1,10 +1,12 @@
 import { type SettingsScope, type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
-import type { AutoContinueSettings } from './engine.ts';
+import { type AutoContinueSettings } from './engine.ts';
 import { type CardActions, type CardFieldState, type CardShell } from './settings-form.ts';
 /** What the auto-continue card renders. */
 export interface AutoContinueSettingsCardState extends CardShell {
+    paused: CardFieldState;
     continueText: CardFieldState;
+    continueTextMaxTokens: CardFieldState;
     graceMs: CardFieldState;
     cooldownMs: CardFieldState;
     maxConsecutive: CardFieldState;

package/lib/types/index.d.ts

@@ -11,6 +11,8 @@ export declare const AUTO_CONTINUE_NS = "auto-continue";
 export declare const AutoContinueSchema: z<Schemastery.ObjectS<{
     /** Text automatically sent after an interruption. */
     continueText: z<string, string>;
+    /** Text sent when the output token ceiling is reached (same placeholders as `continueText`). */
+    continueTextMaxTokens: z<string, string>;
     /** Grace period after an interruption before auto-sending (ms). */
     graceMs: z<number, number>;
     /** Minimum interval between two auto-continues per session (ms). */
@@ -37,9 +39,13 @@ export declare const AutoContinueSchema: z<Schemastery.ObjectS<{
     backoffMaxMs: z<number, number>;
     /** Show browser notifications for auto-continue events. */
     notify: z<boolean, boolean>;
+    /** Globally pause auto-continue: no live or scan send. */
+    paused: z<boolean, boolean>;
 }>, Schemastery.ObjectT<{
     /** Text automatically sent after an interruption. */
     continueText: z<string, string>;
+    /** Text sent when the output token ceiling is reached (same placeholders as `continueText`). */
+    continueTextMaxTokens: z<string, string>;
     /** Grace period after an interruption before auto-sending (ms). */
     graceMs: z<number, number>;
     /** Minimum interval between two auto-continues per session (ms). */
@@ -66,6 +72,8 @@ export declare const AutoContinueSchema: z<Schemastery.ObjectS<{
     backoffMaxMs: z<number, number>;
     /** Show browser notifications for auto-continue events. */
     notify: z<boolean, boolean>;
+    /** Globally pause auto-continue: no live or scan send. */
+    paused: z<boolean, boolean>;
 }>>;
 /**
  * Plugin body: register the settings namespace when a settings provider is

package/package.json

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