dsh-client-auto-continue 0.2.0

package/lib/index.js

@@ -0,0 +1,38 @@
+// src/index.ts
+import z from "@deepseek-ai/schemastery";
+import { settingsNamespace } from "@deepseek-ai/dsh-settings";
+var AUTO_CONTINUE_NS = "auto-continue";
+var AutoContinueSchema = z.object({
+  /** Text automatically sent after an interruption. */
+  continueText: 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). */
+  cooldownMs: z.natural().default(2e4),
+  /** Max consecutive auto-continues per session before stopping. */
+  maxConsecutive: z.natural().min(1).default(3),
+  /** Scan recently interrupted sessions on page load / reconnect. */
+  scanOnBoot: z.boolean().default(true),
+  /** Max sessions the scan checks (most recently updated). */
+  scanLimit: z.natural().min(1).default(8),
+  /** Scan only considers interruptions inside this window (ms). */
+  freshMs: z.natural().default(15 * 60 * 1e3),
+  /** Delay before scanning after a reconnect (ms). */
+  reconnectScanDelayMs: z.natural().default(5e3),
+  /** SSE reconnect backoff (ms). */
+  reconnectBackoffMs: z.natural().default(3e3),
+  /** Log `[auto-continue]` lines to the browser console. */
+  verbose: z.boolean().default(true)
+});
+function apply(ctx) {
+  ctx.inject(["settings"], (settingsCtx) => {
+    settingsCtx.settings.register(settingsNamespace(AUTO_CONTINUE_NS), AutoContinueSchema, {
+      applies: "live"
+    });
+  });
+}
+export {
+  AUTO_CONTINUE_NS,
+  AutoContinueSchema,
+  apply
+};

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

@@ -0,0 +1,78 @@
+/**
+ * Auto-continue engine — browser half core.
+ *
+ * Watches the two live event streams of the dsh web GUI (mux + host):
+ *   - turns ended for a non-human reason (`turn/end` reason ∈ error / interrupted / max-tokens)
+ *   - host-reported agent failures with no turn position (`host/agent-error`)
+ * After a grace period it sends a queued prompt (default 「继续」) to that
+ * session — exactly equivalent to the user typing it manually.
+ *
+ * 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';
+/** 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;
+    /** Grace period after an interruption before auto-sending (ms). */
+    graceMs?: number;
+    /** Minimum interval between two auto-continues per session (ms). */
+    cooldownMs?: number;
+    /** Max consecutive auto-continues per session before stopping. */
+    maxConsecutive?: number;
+    /** Scan recently interrupted sessions on page load / reconnect. */
+    scanOnBoot?: boolean;
+    /** Max sessions the scan checks (most recently updated). */
+    scanLimit?: number;
+    /** Scan only considers interruptions inside this window (ms). */
+    freshMs?: number;
+    /** Delay before scanning after a reconnect (ms). */
+    reconnectScanDelayMs?: number;
+    /** SSE reconnect backoff (ms). */
+    reconnectBackoffMs?: number;
+    /** Log `[auto-continue]` lines to the browser console. */
+    verbose?: boolean;
+}
+/** Fully resolved configuration (built-in defaults + user overrides). */
+export type AutoContinueConfig = Required<AutoContinueSettings>;
+/** Built-in defaults — must match the host schema defaults in src/index.ts. */
+export declare const DEFAULT_CONFIG: AutoContinueConfig;
+/** Resolve a (possibly partial / not-yet-loaded) settings section to a full config. */
+export declare function resolveConfig(section: AutoContinueSettings | undefined): AutoContinueConfig;
+/** 插件主体: 一条 mux 流 + 一条 host 流 + 启动/重连扫描。 */
+export declare class AutoContinueRunner {
+    private readonly api;
+    private readonly getConfig;
+    private readonly states;
+    private readonly muxAbort;
+    private readonly hostAbort;
+    private disposed;
+    private reconnectScans;
+    /**
+     * @param api - shared wire client (ctx.connection.api).
+     * @param getConfig - read the current resolved configuration (settings scope).
+     */
+    constructor(api: IApiClient, getConfig: () => AutoContinueConfig);
+    private log;
+    dispose(): void;
+    private state;
+    private runMux;
+    private runHost;
+    private onMuxFrame;
+    private onSessionEvent;
+    private onHostFrame;
+    private schedule;
+    private cancelPending;
+    private fire;
+    private runningViaList;
+    private scheduleReconnectScan;
+    private bootScanLoop;
+    /** 反复尝试扫描, 直到成功(宿主就绪)或达到次数上限。 */
+    private scanLoop;
+    /**
+     * 扫描最近中断过的会话: 最后回合以非人为原因结束, 且其后没有新回合或用户消息。
+     * @returns 是否成功完成一次扫描(宿主就绪)。
+     */
+    private scanInterrupted;
+}

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

@@ -0,0 +1,30 @@
+/**
+ * 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';
+import { type SettingsCardKey } from './locales.ts';
+/** 客户端根上下文的 connection 服务(由 dsh-client-connection 挂载)。 */
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        connection: ConnectionHandle;
+    }
+}
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** auto-continue settings-card copy. */
+        'auto-continue': SettingsCardKey;
+    }
+}
+/** Services required by this plugin. */
+export declare const inject: string[];
+/**
+ * Plugin body: mount the engine and the settings card.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;

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

@@ -0,0 +1,48 @@
+/**
+ * `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 declare const zh: {
+    'card.title': string;
+    'card.description': string;
+    'field.continueText': string;
+    'field.continueTextHint': string;
+    'field.graceMs': string;
+    'field.graceMsHint': string;
+    'field.cooldownMs': string;
+    'field.cooldownMsHint': string;
+    'field.maxConsecutive': string;
+    'field.maxConsecutiveHint': string;
+    'field.scanOnBoot': string;
+    'field.scanOnBootHint': string;
+    'field.scanLimit': string;
+    'field.scanLimitHint': string;
+    'field.freshMs': string;
+    'field.freshMsHint': string;
+    'field.reconnectScanDelayMs': string;
+    'field.reconnectScanDelayMsHint': string;
+    'field.reconnectBackoffMs': string;
+    'field.reconnectBackoffMsHint': string;
+    'field.verbose': string;
+    'field.verboseHint': string;
+    'chrome.collapse': string;
+    'chrome.expand': string;
+    'chrome.unsaved': string;
+    'chrome.readOnly': string;
+    'chrome.saveFailed': string;
+    'chrome.discard': string;
+    'chrome.saving': string;
+    'chrome.save': string;
+    'chrome.overridden': string;
+    'chrome.reset': string;
+    'chrome.invalidNumber': string;
+    'chrome.inherit': string;
+    'chrome.on': string;
+    'chrome.off': string;
+};
+/** 本插件的键联合。 */
+export type SettingsCardKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: Record<SettingsCardKey, string>;

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

@@ -0,0 +1,47 @@
+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 CardActions, type CardFieldState, type CardShell } from './settings-form.ts';
+/** What the auto-continue card renders. */
+export interface AutoContinueSettingsCardState extends CardShell {
+    continueText: CardFieldState;
+    graceMs: CardFieldState;
+    cooldownMs: CardFieldState;
+    maxConsecutive: CardFieldState;
+    scanOnBoot: CardFieldState;
+    scanLimit: CardFieldState;
+    freshMs: CardFieldState;
+    reconnectScanDelayMs: CardFieldState;
+    reconnectBackoffMs: CardFieldState;
+    verbose: CardFieldState;
+}
+/** The registration-side face the card's slot entry injects. */
+export interface AutoContinueSettingsCardFace extends CardActions {
+    hooks: {
+        /** Card snapshot bound by the renderer as useAutoContinueSettingsCard. */
+        autoContinueSettingsCard: SnapshotStore<AutoContinueSettingsCardState>;
+    };
+}
+/** Bridges the `auto-continue` scope onto the card's staged form. */
+export declare class AutoContinueSettingsCardController {
+    private readonly form;
+    private readonly store;
+    /**
+     * @param scope - the bound settings scope for the `auto-continue` namespace.
+     */
+    constructor(scope: SettingsScope<AutoContinueSettings>);
+    private projection;
+    /**
+     * Build the face the card's slot registration injects.
+     * @returns the card's snapshot and its form actions.
+     */
+    inject(): AutoContinueSettingsCardFace;
+}
+/** Props the renderer binds for the auto-continue card. */
+export type AutoContinueSettingsCardProps = PropsRuntime<'settings.plugin.item'> & PropsLocale<'auto-continue'> & InjectFace<AutoContinueSettingsCardFace>;
+/**
+ * Render the auto-continue card.
+ * @param props - locale copy, the card snapshot, and its form actions.
+ * @returns the card.
+ */
+export declare function AutoContinueSettingsCard(props: AutoContinueSettingsCardProps): import("react").JSX.Element;

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

@@ -0,0 +1,123 @@
+/**
+ * Staged form model behind the plugin settings card — a self-contained
+ * implementation of the plugin-card store pattern used by the DSH plugin
+ * configuration section.
+ *
+ * A card stages what the user types and writes it only when they save. Each
+ * settings write is a durable, revision-fenced document mutation, so staging
+ * keeps what is on screen exactly what a save would store. A field shows its
+ * effective value — the user layer over the composition layer over the schema
+ * default — and whether the user layer carries it (presence, not value
+ * equality, marks an override).
+ */
+import type { SettingsScope, SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+/** The write one field's staged text performs when the card is saved. */
+export type FieldWrite = {
+    kind: 'set';
+    value: unknown;
+} | {
+    kind: 'clear';
+};
+/** How one field converts between its stored value and its draft text. */
+export interface CardFieldSpec {
+    /** Field name inside the namespace section. */
+    field: string;
+    /** Render a stored value as draft text; the empty string when the section carries none. */
+    format: (value: unknown) => string;
+    /**
+     * The write this draft text stages, or undefined when the text is not a
+     * value this field accepts — which blocks the save rather than discarding it.
+     */
+    parse: (text: string) => FieldWrite | undefined;
+}
+/** One field as the card's control renders it. */
+export interface CardFieldState {
+    /** Draft text the control renders. */
+    text: string;
+    /** Whether saving would leave a user-layer entry for this field. */
+    overridden: boolean;
+    /** Whether the draft is not a value this field accepts, which blocks saving. */
+    invalid: boolean;
+}
+/** Form state every plugin card shares. */
+export interface CardShell {
+    /** False while the namespace is not served to this client; the card renders nothing. */
+    available: boolean;
+    /** Whether the Host document accepts writes. */
+    writable: boolean;
+    /** Whether the form holds edits that a save would write. */
+    dirty: boolean;
+    /** Whether any staged draft is invalid, which blocks the save. */
+    invalid: boolean;
+    /** Whether a save is crossing the wire. */
+    saving: boolean;
+    /** Whether the last save did not land as staged; cleared by the next edit or save. */
+    failed: boolean;
+}
+/** The write actions the card's slot entry injects. */
+export interface CardActions {
+    /** Stage draft text for one field. */
+    edit: (field: string, text: string) => void;
+    /** Stage a clear, so saving lets the field re-inherit the composition layer. */
+    resetField: (field: string) => void;
+    /** Write every staged edit, then re-seed from what the Host accepted. */
+    save: () => void;
+    /** Drop every staged edit. */
+    discard: () => void;
+}
+/** A whole-number field. An empty draft clears the field; a non-number or out-of-range draft blocks the save. */
+export declare function numberField(field: string, min?: number): CardFieldSpec;
+/** A free-text field. An empty draft clears the field, so emptying the control and saving is the same gesture as resetting it. */
+export declare function textField(field: string): CardFieldSpec;
+/** A boolean field, edited through true/false draft text; an empty draft inherits. */
+export declare function booleanField(field: string): CardFieldSpec;
+/**
+ * Stages one card's edits over one settings namespace and writes them on save.
+ *
+ * The Host is the only authority on whether a value was accepted, so the
+ * outcome is read back from the section rather than predicted here. A save
+ * that did not land keeps its drafts, so the user can correct them instead of
+ * retyping.
+ */
+export declare class CardForm<T> {
+    private readonly scope;
+    private readonly specs;
+    private readonly staged;
+    private readonly listeners;
+    private saving;
+    private failed;
+    /**
+     * @param scope - the bound settings scope for this card's namespace.
+     * @param specs - the section fields this card edits.
+     */
+    constructor(scope: SettingsScope<T>, specs: CardFieldSpec[]);
+    /** Publish a projection of this form, rebuilt whenever the scope or a draft changes. */
+    bind<S>(project: () => S, createStore: (init: S) => SnapshotStore<S>): SnapshotStore<S>;
+    /** Read the card-level state: what the Host serves, and what a save would do. */
+    shell(): CardShell;
+    /** Read one field's state from the effective section and its staged draft. */
+    field(field: string): CardFieldState;
+    /** The actions the card's slot registration injects. */
+    actions(): CardActions;
+    /**
+     * Write every staged edit, then re-seed from what the Host accepted.
+     * @returns settlement after every write and the read-back.
+     */
+    save(): Promise<void>;
+    /**
+     * Every staged edit a save would write. An entry whose draft is not a value
+     * its field accepts carries no write: the form is still dirty, and the save
+     * refuses rather than dropping the edit. A staged edit that matches the
+     * effective section is not a write at all.
+     */
+    private plan;
+    private clear;
+    private store;
+    private stage;
+    private specOf;
+    private sectionValue;
+    private baseValue;
+    private userLayer;
+    private stored;
+    private publish;
+}

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

@@ -0,0 +1,8 @@
+/**
+ * Styles for the auto-continue settings card, injected at factory
+ * materialization so the client module system's style bookkeeping (HMR) owns
+ * them. Uses the DSH design tokens (`--dsw-alias-*`) so the card follows the
+ * active theme.
+ */
+/** Inject the stylesheet once; a no-op outside a browser environment. */
+export declare function injectStyles(): void;

package/lib/types/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Host half of the auto-continue plugin: registers the `auto-continue`
+ * settings namespace so the browser half's settings card can edit it and the
+ * engine can read it. No other host-side behavior.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+/** Settings namespace of the auto-continue plugin (lowercase kebab-case). */
+export declare const AUTO_CONTINUE_NS = "auto-continue";
+/** Wire schema of the auto-continue section; defaults are the plugin's built-in values. */
+export declare const AutoContinueSchema: z<Schemastery.ObjectS<{
+    /** Text automatically sent after an interruption. */
+    continueText: 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). */
+    cooldownMs: z<number, number>;
+    /** Max consecutive auto-continues per session before stopping. */
+    maxConsecutive: z<number, number>;
+    /** Scan recently interrupted sessions on page load / reconnect. */
+    scanOnBoot: z<boolean, boolean>;
+    /** Max sessions the scan checks (most recently updated). */
+    scanLimit: z<number, number>;
+    /** Scan only considers interruptions inside this window (ms). */
+    freshMs: z<number, number>;
+    /** Delay before scanning after a reconnect (ms). */
+    reconnectScanDelayMs: z<number, number>;
+    /** SSE reconnect backoff (ms). */
+    reconnectBackoffMs: z<number, number>;
+    /** Log `[auto-continue]` lines to the browser console. */
+    verbose: z<boolean, boolean>;
+}>, Schemastery.ObjectT<{
+    /** Text automatically sent after an interruption. */
+    continueText: 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). */
+    cooldownMs: z<number, number>;
+    /** Max consecutive auto-continues per session before stopping. */
+    maxConsecutive: z<number, number>;
+    /** Scan recently interrupted sessions on page load / reconnect. */
+    scanOnBoot: z<boolean, boolean>;
+    /** Max sessions the scan checks (most recently updated). */
+    scanLimit: z<number, number>;
+    /** Scan only considers interruptions inside this window (ms). */
+    freshMs: z<number, number>;
+    /** Delay before scanning after a reconnect (ms). */
+    reconnectScanDelayMs: z<number, number>;
+    /** SSE reconnect backoff (ms). */
+    reconnectBackoffMs: z<number, number>;
+    /** Log `[auto-continue]` lines to the browser console. */
+    verbose: z<boolean, boolean>;
+}>>;
+/**
+ * Plugin body: register the settings namespace when a settings provider is
+ * composed. Changes apply live — the browser half observes the scope.
+ * @param ctx - host plugin context.
+ */
+export declare function apply(ctx: Context): void;

package/package.json

@@ -0,0 +1,82 @@
+{
+  "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.2.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-plugins"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "node build.mjs && tsc -p tsconfig.build.json",
+    "watch": "node build.mjs --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "node tests/simulate.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "plugin",
+    "web-ui",
+    "auto-continue"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HsiangNianian/dsh-auto-continue.git"
+  },
+  "homepage": "https://github.com/HsiangNianian/dsh-auto-continue",
+  "devDependencies": {
+    "esbuild": "^0.25.0",
+    "typescript": "~5.8.0",
+    "@types/react": "~18.3.1",
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "^3.18.1"
+  }
+}