dsh-client-auto-continue 0.5.2 → 0.5.3

package/src/client/index.ts

@@ -0,0 +1,91 @@
+/**
+ * Auto-continue plugin, browser half.
+ *
+ * - Runs the auto-continue engine over the live mux + host event streams.
+ * - Registers the `auto-continue` settings card into the plugin-configuration
+ *   section (`settings.plugin.item`), editing the same namespace the engine
+ *   reads — every behavior knob is configurable from the GUI.
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { ConnectionHandle } from '@deepseek-ai/dsh-client-connection/client';
+// Type-only: pulls the locale plugin's Context merge (ctx.locale).
+import type {} from '@deepseek-ai/dsh-client-locale/client';
+// Type-only: pulls the settings-surface SlotMap merge and ctx.settingsScope.
+import type {} from '@deepseek-ai/dsh-client-ui-settings/client';
+// Type-only: pulls the `settings.plugin.item` SlotMap merge.
+import type {} from '@deepseek-ai/dsh-client-ui-settings-plugins/client';
+import { AutoContinueRunner, resolveConfig, type AutoContinueSettings } from './engine.ts';
+import { en, zh, type SettingsCardKey } from './locales.ts';
+import {
+  AutoContinueSettingsCard,
+  AutoContinueSettingsCardController,
+} from './settings-card.tsx';
+
+/** 客户端根上下文的 connection 服务(由 dsh-client-connection 挂载)。 */
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    connection: ConnectionHandle;
+  }
+}
+
+/** Dictionary namespace owned by this plugin. */
+const NS = 'auto-continue';
+
+/** Settings namespace the engine reads and the settings card edits. */
+const SETTINGS_NS = 'auto-continue';
+
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  interface LocaleNamespaceMap {
+    /** auto-continue settings-card copy. */
+    'auto-continue': SettingsCardKey;
+  }
+}
+
+/** Services required by this plugin. */
+export const inject = ['slots', 'locale', 'connection', 'settingsScope'];
+
+// 浏览器侧辅助(设置卡片与模拟测试共用): 暂停控制与统计读取。
+export {
+  fillTemplate,
+  pauseSession,
+  pausedSessions,
+  readTodayStats,
+  resetTodayStats,
+  sessionPauseUntil,
+  unpauseSession,
+} from './engine.ts';
+
+/** 当前 runner(HMR 重载时先销毁旧的再建新的)。 */
+let current: AutoContinueRunner | null = null;
+
+/**
+ * Plugin body: mount the engine and the settings card.
+ * @param ctx - client root context.
+ */
+export function apply(ctx: ClientContext): void {
+  ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'auto-continue: dictionaries');
+
+  // Engine: reads the settings scope live, so GUI changes apply immediately.
+  const scope = ctx.settingsScope.bind<AutoContinueSettings>({ namespace: SETTINGS_NS });
+  current?.dispose();
+  current = new AutoContinueRunner(ctx.connection.api, () => resolveConfig(scope.getSnapshot().value));
+
+  // Plugin configuration card: one staged form over the `auto-continue`
+  // settings namespace, contributed to the plugin-configuration section
+  // (Settings → Plugins). Registered through the public `settings.plugin.item`
+  // slot — no hardcoded section order, label or path anywhere — so the card
+  // shows up in the plugin list like any other plugin's config card.
+  const controller = new AutoContinueSettingsCardController(scope);
+  ctx.slots.inject('settings.plugin.item', () =>
+    ctx.slots.register(
+      {
+        name: 'settings.plugin.item',
+        id: 'auto-continue',
+        order: 90,
+        locale: NS,
+        inject: () => controller.inject(),
+      },
+      AutoContinueSettingsCard,
+    ),
+  );
+}

package/src/client/locales.ts

@@ -0,0 +1,140 @@
+/**
+ * `auto-continue` namespace dictionaries: copy for the plugin settings card
+ * registered into the `settings.plugin.item` seat of the plugin-configuration
+ * section. Includes the card-chrome keys the card component reads.
+ */
+
+/** 简体中文词典(键集的事实来源)。 */
+export const zh = {
+  'card.title': '自动继续',
+  'card.description': '请求因网络等原因(非人为)中断后, 自动发送「继续」续跑。',
+  'field.paused': '暂停自动继续',
+  'field.pausedHint': '全局暂停: 实时与扫描都不会再自动发送, 已排队的待发送也会取消。',
+  'field.continueText': '继续文本',
+  'field.continueTextHint': '中断后自动发送的消息内容。',
+  'field.continueTextMaxTokens': '超限时的继续文本',
+  'field.continueTextMaxTokensHint': '达到输出 token 上限时自动发送的文本, 支持与继续文本相同的占位符。',
+  'field.graceMs': '宽限期 (ms)',
+  'field.graceMsHint': '检测到中断后等待的时长; 期间宿主自行恢复则取消。',
+  'field.cooldownMs': '冷却时间 (ms)',
+  'field.cooldownMsHint': '同一会话两次自动「继续」的最小间隔, 失败尝试也计入。',
+  'field.maxConsecutive': '最大连续次数',
+  'field.maxConsecutiveHint': '同一会话连续自动「继续」的上限; 超过后停止, 直到用户手动介入或出现成功回合。',
+  'field.scanOnBoot': '启动/重连扫描',
+  'field.scanOnBootHint': '页面启动或重连时扫描最近中断的会话并自动续跑(如浏览器关闭期间宿主崩溃)。',
+  'field.scanLimit': '扫描会话数',
+  'field.scanLimitHint': '最多检查多少个最近更新的会话(不含运行中与子代理会话)。',
+  'field.freshMs': '扫描时间窗 (ms)',
+  'field.freshMsHint': '扫描只处理该时间窗内的中断。',
+  'field.reconnectScanDelayMs': '重连扫描延迟 (ms)',
+  'field.reconnectScanDelayMsHint': '重连后等待宿主完成恢复再扫描。',
+  'field.reconnectBackoffMs': '重连退避 (ms)',
+  'field.reconnectBackoffMsHint': '事件流断开后的重连间隔。',
+  'field.verbose': '详细日志',
+  'field.verboseHint': '在浏览器控制台输出 [auto-continue] 日志。',
+  'field.classify': '错误分类',
+  'field.classifyHint': '仅自动恢复临时性错误(网络/超时/5xx 等); 认证/余额/模型不存在等永久性错误跳过并通知。',
+  'field.backoffFactor': '退避系数',
+  'field.backoffFactorHint': '连续失败时冷却间隔的倍率(如 2 表示 20s→40s→80s 递增)。',
+  'field.backoffMaxMs': '最大退避间隔 (ms)',
+  'field.backoffMaxMsHint': '自适应退避的上限, 防止等待过久。',
+  'field.notify': '浏览器通知',
+  'field.notifyHint': '自动继续成功/放弃/遇到永久性错误时弹出浏览器通知, 通知带「立即续跑」与「暂停该会话 1 小时」按钮。',
+  'stats.title': '今日统计',
+  'stats.sent': '自动继续',
+  'stats.skipped': '跳过(永久错误)',
+  'stats.recovered': '恢复成功',
+  'stats.failed': '继续后仍失败',
+  'stats.gaveUp': '停止(达上限)',
+  'stats.byCode': '错误码分布',
+  'stats.empty': '今天还没有自动继续记录。',
+  'stats.reset': '清零',
+  'pause.title': '已暂停会话',
+  'pause.none': '没有暂停中的会话。',
+  'pause.clearAll': '全部解除',
+  'pause.unpause': '解除',
+  'pause.minutes': '分钟',
+  'chrome.collapse': '收起设置',
+  'chrome.expand': '展开设置',
+  'chrome.unsaved': '未保存',
+  'chrome.readOnly': '当前部署的设置只读。',
+  'chrome.saveFailed': '部署未接受这些值, 已保留供你修改。',
+  'chrome.discard': '放弃',
+  'chrome.saving': '保存中…',
+  'chrome.save': '保存',
+  'chrome.overridden': '已覆盖',
+  'chrome.reset': '恢复默认',
+  'chrome.invalidNumber': '请输入数字, 留空则使用默认值。',
+  'chrome.inherit': '继承',
+  'chrome.on': '开',
+  'chrome.off': '关',
+} satisfies Record<string, string>;
+
+/** 本插件的键联合。 */
+export type SettingsCardKey = keyof typeof zh;
+
+/** English dictionary, checked complete against the zh key set. */
+export const en: Record<SettingsCardKey, string> = {
+  'card.title': 'Auto continue',
+  'card.description': 'When a request is interrupted by a non-human cause, automatically send 「继续」 to resume.',
+  'field.paused': 'Pause auto-continue',
+  'field.pausedHint': 'Globally pause: no live or scan auto-send fires, and queued pending sends are cancelled.',
+  'field.continueText': 'Continue text',
+  'field.continueTextHint': 'Message automatically sent after an interruption.',
+  'field.continueTextMaxTokens': 'Continue text (max tokens)',
+  'field.continueTextMaxTokensHint': 'Text sent when the output token ceiling is reached; same placeholders as the continue text.',
+  'field.graceMs': 'Grace period (ms)',
+  'field.graceMsHint': 'Wait after an interruption; cancelled if the host recovers on its own.',
+  'field.cooldownMs': 'Cooldown (ms)',
+  'field.cooldownMsHint': 'Minimum interval between auto-continues per session; failed attempts count too.',
+  'field.maxConsecutive': 'Max consecutive',
+  'field.maxConsecutiveHint': 'Max consecutive auto-continues per session; stops until a user intervenes or a turn completes.',
+  'field.scanOnBoot': 'Scan on load / reconnect',
+  'field.scanOnBootHint': 'Scan recently interrupted sessions on page load or reconnect (e.g. the host crashed while the browser was closed).',
+  'field.scanLimit': 'Scan limit',
+  'field.scanLimitHint': 'How many most-recently-updated sessions to check (running / subagent sessions excluded).',
+  'field.freshMs': 'Scan window (ms)',
+  'field.freshMsHint': 'Only interruptions inside this window are considered.',
+  'field.reconnectScanDelayMs': 'Reconnect scan delay (ms)',
+  'field.reconnectScanDelayMsHint': 'Wait for the host to finish recovering before scanning after a reconnect.',
+  'field.reconnectBackoffMs': 'Reconnect backoff (ms)',
+  'field.reconnectBackoffMsHint': 'Interval between event-stream reconnect attempts.',
+  'field.verbose': 'Verbose logs',
+  'field.verboseHint': 'Log [auto-continue] lines to the browser console.',
+  'field.classify': 'Classify errors',
+  'field.classifyHint': 'Auto-resume transient failures only (network/timeout/5xx…); auth, balance and model errors are skipped and notified.',
+  'field.backoffFactor': 'Backoff factor',
+  'field.backoffFactorHint': 'Cooldown multiplier per consecutive failure (2 = 20s→40s→80s…).',
+  'field.backoffMaxMs': 'Max backoff (ms)',
+  'field.backoffMaxMsHint': 'Cap on the adaptive backoff interval.',
+  'field.notify': 'Browser notifications',
+  'field.notifyHint': 'Notify when auto-continue fires, gives up, or hits a permanent error; notifications carry "Resume now" and "Pause this session 1h" buttons.',
+  'stats.title': "Today's stats",
+  'stats.sent': 'Auto-continued',
+  'stats.skipped': 'Skipped (permanent)',
+  'stats.recovered': 'Recovered',
+  'stats.failed': 'Failed after',
+  'stats.gaveUp': 'Gave up (cap)',
+  'stats.byCode': 'By error code',
+  'stats.empty': 'No auto-continue activity today.',
+  'stats.reset': 'Reset',
+  'pause.title': 'Paused sessions',
+  'pause.none': 'No sessions paused.',
+  'pause.clearAll': 'Clear all',
+  'pause.unpause': 'Resume',
+  'pause.minutes': 'min',
+  'chrome.collapse': 'Hide settings',
+  'chrome.expand': 'Show settings',
+  'chrome.unsaved': 'Unsaved',
+  'chrome.readOnly': 'This deployment stores settings read-only.',
+  'chrome.saveFailed': 'The deployment did not accept these values; they were left for you to correct.',
+  'chrome.discard': 'Discard',
+  'chrome.saving': 'Saving…',
+  'chrome.save': 'Save',
+  'chrome.overridden': 'Overridden',
+  'chrome.reset': 'Reset to default',
+  'chrome.invalidNumber': 'Enter a number, or leave blank to use the default.',
+  'chrome.inherit': 'Inherit',
+  'chrome.on': 'On',
+  'chrome.off': 'Off',
+};