@jaychang1989/dsh-webchat 0.3.0 → 0.4.1

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

@@ -1,169 +0,0 @@
-/**
- * dsh-webchat surface copy: zh is the key source, en mirrors every key. The
- * key union (not an object shape) is what the locale machinery wants —
- * LocaleKeysOf<N> intersects the namespace with `string`, so the namespace
- * value must itself be the key union (same pattern as dsh-ssh).
- */
-export declare const zh: {
-    readonly 'entry.label': "网页聊天";
-    readonly 'entry.tooltip': "DeepSeek 网页端聊天（deepseek-chat，Codex ChatGPT 模式）";
-    readonly 'panel.title': "DeepSeek 网页端聊天";
-    readonly 'status.engine.stopped': "浏览器未启动";
-    readonly 'status.engine.launching': "浏览器启动中…";
-    readonly 'status.engine.ready': "浏览器就绪";
-    readonly 'status.engine.error': "浏览器错误";
-    readonly 'status.loggedIn': "已登录";
-    readonly 'status.notLoggedIn': "未登录";
-    readonly 'status.unknown': "状态未知";
-    readonly 'action.openLogin': "打开登录窗口";
-    readonly 'action.closeBrowser': "关闭浏览器";
-    readonly 'action.newChat': "新对话";
-    readonly 'action.recover': "从网页恢复";
-    readonly 'action.refresh': "刷新";
-    readonly 'action.send': "发送";
-    readonly 'action.stop': "停止生成";
-    readonly 'action.transferToHarness': "转移到 Harness";
-    readonly 'action.exportFile': "导出为文件";
-    readonly 'transfer.mode.distill': "蒸馏为任务简报";
-    readonly 'transfer.mode.raw': "原始记录";
-    readonly 'transfer.mode.hint': "蒸馏：用 harness LLM 把对话提炼成可执行任务简报；原始记录：原样放入新会话首条消息";
-    readonly 'transfer.workspace.label': "目标工作区";
-    readonly 'transfer.workspace.ungrouped': "未分组";
-    readonly 'transfer.workspace.new': "新建工作区…";
-    readonly 'transfer.workspace.hint': "转移到所选工作区；未分组则不归入任何工作区";
-    readonly 'transfer.workspace.created': "已创建并选中工作区 {title}";
-    readonly 'transfer.workspace.createFailed': "创建工作区失败：{error}";
-    readonly 'transfer.session.label': "延续到会话";
-    readonly 'transfer.session.hint': "选择已有 harness 会话以延续（把简报作为新消息追加）；默认新建会话";
-    readonly 'transfer.session.new': "新建会话";
-    readonly 'transfer.attached.failed': "会话已创建（{sessionId}），但归入工作区失败，现为未分组";
-    readonly 'handoff.eyebrow': "交付到 Harness";
-    readonly 'toggle.deepThink': "深度思考";
-    readonly 'toggle.search': "智能搜索";
-    readonly 'toggle.deepThink.hint': "开启 R1 深度思考";
-    readonly 'toggle.search.hint': "开启联网检索";
-    readonly 'sidebar.empty': "暂无对话";
-    readonly 'chats.count': "{count} 条";
-    readonly 'role.you': "你";
-    readonly 'chat.rename': "重命名";
-    readonly 'chat.delete': "删除";
-    readonly 'chat.delete.confirm': "确认删除？";
-    readonly 'chat.clearAll': "清空全部";
-    readonly 'chat.clearAll.confirm': "确认清空全部？";
-    readonly 'chat.rename.placeholder': "输入新标题…";
-    readonly 'chat.rename.ok': "确定";
-    readonly 'chat.rename.cancel': "取消";
-    readonly 'chat.manage.hint': "管理本地保存的聊天记录（不影响网页端）";
-    readonly 'toast.rename.done': "已重命名";
-    readonly 'toast.rename.failed': "重命名失败：{error}";
-    readonly 'toast.delete.done': "已删除该对话";
-    readonly 'toast.delete.failed': "删除失败：{error}";
-    readonly 'toast.clear.done': "已清空全部对话";
-    readonly 'toast.clear.failed': "清空失败：{error}";
-    readonly 'model.deepseek-chat': "DeepSeek";
-    readonly 'model.deepseek-reasoner': "DeepSeek";
-    readonly 'composer.placeholder': "给 DeepSeek 发送消息…（将发送到网页端）";
-    readonly 'composer.hint': "Enter 发送 · Shift+Enter 换行";
-    readonly 'composer.busy': "正在生成回复…";
-    readonly 'composer.notLoggedIn': "请先登录 DeepSeek 网页端";
-    readonly 'composer.attach': "图片";
-    readonly 'composer.attach.hint': "添加本地图片（绝对路径，逗号/换行分隔）";
-    readonly 'composer.attach.placeholder': "图片绝对路径，逗号或换行分隔";
-    readonly 'empty.eyebrow': "DeepSeek 网页端 · 桥接开发";
-    readonly 'empty.title': "先聊，再交付";
-    readonly 'empty.body': "登录网页端即可开始对话；任何对话都能蒸馏成任务简报，转入 Harness 会话继续开发。";
-    readonly 'transfer.done': "已创建 Harness 会话 {sessionId}，正在为你打开…";
-    readonly 'transfer.continued': "已延续 Harness 会话 {sessionId}，正在为你打开…";
-    readonly 'transfer.failed': "转移到 Harness 失败：{error}";
-    readonly 'export.done': "已导出到工作区文件：{filePath}";
-    readonly 'export.failed': "导出失败：{error}";
-    readonly 'recover.hint': "列出网页端尚未导入本地的会话";
-    readonly 'recover.empty': "网页端没有未导入的会话";
-    readonly 'recover.done': "已恢复「{title}」";
-    readonly 'msg.empty': "（空）";
-    readonly 'msg.error': "（该回复可能不完整：{error}）";
-    readonly streaming: "生成中";
-};
-/** Bilingual balance enforced: en must cover every zh key. */
-export declare const en: {
-    'entry.label': string;
-    'entry.tooltip': string;
-    'panel.title': string;
-    'status.engine.stopped': string;
-    'status.engine.launching': string;
-    'status.engine.ready': string;
-    'status.engine.error': string;
-    'status.loggedIn': string;
-    'status.notLoggedIn': string;
-    'status.unknown': string;
-    'action.openLogin': string;
-    'action.closeBrowser': string;
-    'action.newChat': string;
-    'action.recover': string;
-    'action.refresh': string;
-    'action.send': string;
-    'action.stop': string;
-    'action.transferToHarness': string;
-    'action.exportFile': string;
-    'transfer.mode.distill': string;
-    'transfer.mode.raw': string;
-    'transfer.mode.hint': string;
-    'transfer.workspace.label': string;
-    'transfer.workspace.ungrouped': string;
-    'transfer.workspace.new': string;
-    'transfer.workspace.hint': string;
-    'transfer.workspace.created': string;
-    'transfer.workspace.createFailed': string;
-    'transfer.session.label': string;
-    'transfer.session.hint': string;
-    'transfer.session.new': string;
-    'transfer.attached.failed': string;
-    'handoff.eyebrow': string;
-    'toggle.deepThink': string;
-    'toggle.search': string;
-    'toggle.deepThink.hint': string;
-    'toggle.search.hint': string;
-    'sidebar.empty': string;
-    'chats.count': string;
-    'role.you': string;
-    'chat.rename': string;
-    'chat.delete': string;
-    'chat.delete.confirm': string;
-    'chat.clearAll': string;
-    'chat.clearAll.confirm': string;
-    'chat.rename.placeholder': string;
-    'chat.rename.ok': string;
-    'chat.rename.cancel': string;
-    'chat.manage.hint': string;
-    'toast.rename.done': string;
-    'toast.rename.failed': string;
-    'toast.delete.done': string;
-    'toast.delete.failed': string;
-    'toast.clear.done': string;
-    'toast.clear.failed': string;
-    'model.deepseek-chat': string;
-    'model.deepseek-reasoner': string;
-    'composer.placeholder': string;
-    'composer.hint': string;
-    'composer.busy': string;
-    'composer.notLoggedIn': string;
-    'composer.attach': string;
-    'composer.attach.hint': string;
-    'composer.attach.placeholder': string;
-    'empty.eyebrow': string;
-    'empty.title': string;
-    'empty.body': string;
-    'transfer.done': string;
-    'transfer.continued': string;
-    'transfer.failed': string;
-    'export.done': string;
-    'export.failed': string;
-    'recover.hint': string;
-    'recover.empty': string;
-    'recover.done': string;
-    'msg.empty': string;
-    'msg.error': string;
-    streaming: string;
-};
-/** Key union of the web-chat surface copy. */
-export type WebChatKey = keyof typeof zh;

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

@@ -1,23 +0,0 @@
-import type { ISessions, IWorkspaces } from '@deepseek-ai/dsh-client-runtime/client';
-import type { WebChatApi } from './api.ts';
-import type { PanelController } from './controller.ts';
-import type { WebChatKey } from './locales.ts';
-/** The injected panel container (kept in the DOM, hidden when inactive). */
-export declare const PANEL_VIEW_SELECTOR = "[data-dsh-webchat-view]";
-export interface MountPanelDeps {
-    sessions: ISessions;
-    workspaces: IWorkspaces;
-    api: WebChatApi;
-    controller: PanelController;
-    /** Locale accessor bound to the plugin's registered dictionaries. */
-    tt: (key: WebChatKey) => string;
-    /** Resolve the current session's cwd (for transfers / exports). */
-    currentCwd: () => string | undefined;
-}
-/**
- * Mount the panel React tree into the center column and bind its visibility
- * to the controller's panelOpen state.
- * @param deps - sessions, api, controller, locale accessor.
- * @returns disposer unmounting the tree and restoring the column.
- */
-export declare function mountPanel(deps: MountPanelDeps): () => void;

package/lib/types/client/panel/Markdown.d.ts

@@ -1,15 +0,0 @@
-/**
- * Minimal markdown renderer for the web-chat panel. Deliberately small and
- * dependency-free: headings, paragraphs, bold/italic, inline + fenced code,
- * links, DeepSeek `[citation:N]` markers (rendered as superscript badges),
- * unordered/ordered lists, blockquotes, GFM tables, horizontal rules, and
- * <details> passthrough (used for DeepSeek R1 thinking blocks). Anything
- * unrecognized renders as plain text — never raw HTML.
- */
-import { type ReactNode } from 'react';
-/** Render one block of markdown text into React nodes. */
-export declare function renderMarkdown(source: string): ReactNode[];
-/** The markdown renderer component. */
-export declare function Markdown({ source }: {
-    source: string;
-}): ReactNode;

package/lib/types/client/panel/WebChatPanel.d.ts

@@ -1,28 +0,0 @@
-/**
- * The web-chat panel: engine/login status, a conversation sidebar (the local
- * transcript list + management), the chat transcript with markdown rendering,
- * streaming updates (polled), the composer with deep-think / internet-search
- * toggles, and the transfer-to-Harness handoff. All data flows through the
- * /api/dsh-webchat routes; the panel is a plain React root in the center column.
- *
- * Layout mirrors chat.deepseek.com: a left conversation sidebar (new chat +
- * history + per-item rename/delete + clear-all) beside the main chat column
- * (messages → composer with 深度思考 / 智能搜索 toggles → handoff dock). The
- * mono register stays reserved for machine things — timestamps, counts,
- * status, and the handoff eyebrow.
- */
-import type { ISessions, IWorkspaces } from '@deepseek-ai/dsh-client-runtime/client';
-import type { WebChatApi } from '../api.ts';
-import type { WebChatKey } from '../locales.ts';
-export interface WebChatPanelProps {
-    api: WebChatApi;
-    /** Locale accessor (the plugin registers its dictionaries on ctx.locale). */
-    tt: (key: WebChatKey) => string;
-    /** Client sessions service (ctx.sessions) for opening transferred sessions. */
-    sessions: ISessions;
-    /** Client workspaces service (ctx.workspaces) for the transfer target picker. */
-    workspaces: IWorkspaces;
-    /** Resolve the current workspace directory (cwd for new sessions / exports). */
-    currentCwd: () => string | undefined;
-}
-export declare function WebChatPanel({ api, tt, sessions, workspaces, currentCwd }: WebChatPanelProps): import("react").JSX.Element;

package/lib/types/client/sidebar-entry-core.d.ts

@@ -1,60 +0,0 @@
-/**
- * Shared sidebar entry injection core.
- *
- * dsh's sidebar shell exposes no slot an external plugin can register into,
- * so the entry row is injected between the shell's New Session button and the
- * workspace browser. The injection self-heals: a MutationObserver watches the
- * sidebar root and re-inserts the row whenever a React re-render displaces it
- * (re-insertion happens in the same frame, before paint, so no flicker).
- *
- * The row is plain DOM (no React tree) so it can never disturb the shell's
- * reconciliation; the view it toggles is a separate root owned by the caller.
- *
- * Packages receive this file as a generated copy via scripts/sync-shared.mjs;
- * edit the shared source and re-run the sync instead of editing a copy.
- */
-/** Per-package configuration for one sidebar entry row. */
-export interface SidebarEntryOptions {
-    /** Full attribute name identifying the injected row (idempotency key), e.g. 'data-dsh-ssh-entry'. */
-    rowAttribute: string;
-    /** CSS selector matching the injected row, e.g. '[data-dsh-ssh-entry]'. */
-    rowSelector: string;
-    /**
-     * L2 semantic-attribute plugin id (issue #506, enum table:
-     * skins/skin-center/contracts/semantic-attrs-v1.md). When set, the row also
-     * outputs data-dsh-plugin="<id>" and data-dsh-part="sidebar-entry"; unset
-     * leaves the row without semantic attributes.
-     */
-    plugin?: string;
-    /** Inline icon markup (matches the shell's 16px nav-icon look). */
-    icon: string;
-    /** CSS module class names for the row and its two spans (entry / entryIcon / entryLabel). */
-    css: Record<string, string>;
-    /** Localized row label (aria-label + visible text). */
-    label(): string;
-    /** Optional localized tooltip (title attribute). */
-    tooltip?(): string;
-    /** Click action (open/toggle the owning panel). */
-    onToggle(): void;
-    /** Family-block position: 'before' inserts ahead of sibling plugin rows, 'after' behind them. */
-    position: 'before' | 'after';
-    /**
-     * Selectors of the sibling plugin entry rows this package orders against
-     * (its own row included — the placement guard excludes a row that is
-     * already inside the root). Each package passes the same list it used
-     * before the consolidation so the rendered order stays stable.
-     */
-    familySelectors: readonly string[];
-    /** Optional active-state bridge; highlights the row while the panel is open. */
-    active?: {
-        subscribe(listener: () => void): () => void;
-        isOpen(): boolean;
-    };
-}
-/**
- * Mount the sidebar entry, waiting for the shell to render and self-healing
- * on later React re-renders.
- * @param options - the row's attribute/icon/copy/action/ordering configuration.
- * @returns disposer removing the entry and its observers.
- */
-export declare function mountSidebarEntry(options: SidebarEntryOptions): () => void;

package/lib/types/client/sidebar-entry.d.ts

@@ -1,22 +0,0 @@
-/**
- * Sidebar entry injection — package-specific wiring over the shared core
- * (sidebar-entry-core.ts). The row is plain DOM so it can never disturb the
- * shell's reconciliation; the panel view it toggles is a separate React root
- * mounted in the center column (see mount.tsx).
- */
-import type { PanelController } from './controller.ts';
-import type { WebChatKey } from './locales.ts';
-/** Stable data attribute identifying the injected entry row. */
-export declare const ENTRY_SELECTOR = "[data-dsh-webchat-entry]";
-export interface SidebarEntryDeps {
-    controller: PanelController;
-    /** Locale accessor (spelled here to keep the core dependency-free). */
-    tt: (key: WebChatKey) => string;
-}
-/**
- * Mount the sidebar entry, waiting for the shell to render and self-healing
- * on later React re-renders.
- * @param deps - controller and copy accessor.
- * @returns disposer removing the entry and its observers.
- */
-export declare function mountSidebarEntry(deps: SidebarEntryDeps): () => void;

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

@@ -1,247 +0,0 @@
-/**
- * DeepSeek web engine — the "Codex ChatGPT mode" analog for DeepSeek Harness.
- *
- * Drives a real browser (system Chrome/Edge via playwright-core) against
- * chat.deepseek.com with a dedicated persistent profile, so the user logs in
- * once with their own DeepSeek account (phone / password / Apple / WeChat QR)
- * and the session persists. Chatting happens THROUGH the real web page —
- * messages are typed into the real composer — so the plugin needs no API key,
- * no billing, and stays immune to DeepSeek's private-API PoW challenge.
- *
- * Replies are read by teeing the page's own SSE stream: an injected init
- * script wraps XMLHttpRequest and captures the `/api/v0/chat/completion`
- * response as it streams (the page has already solved PoW + auth, so we get
- * the model's raw markdown for free). DOM scraping of `.ds-markdown` is kept
- * only as a fallback for when the capture cannot install. The web chat runs
- * the `deepseek-chat` model by default (switchable to deepseek-reasoner).
- *
- * All page interactions are best-effort and selector-defensive: failures
- * produce readable errors (never crashes) and the caller decides how to
- * degrade.
- */
-import { type Page } from 'playwright-core';
-import type { TranscriptStore } from '../store.ts';
-import type { EngineState, SendResult, WebChatErrorCode } from '../protocol.ts';
-/** Engine configuration (resolved from the plugin settings surface). */
-export interface WebChatEngineConfig {
-    /** Data dir root (browser profile lives under it). */
-    dataDir: string;
-    /** Browser channel hint: 'chrome' | 'msedge' | 'chromium' | undefined (auto-detect). */
-    channel?: string;
-    /** Explicit browser executable path (overrides channel detection). */
-    executablePath?: string;
-    /** Proxy mode: 'direct' (--no-proxy-server), 'system' (browser default), or a proxy URL. */
-    proxy?: string;
-    /** Visible browser window (required for the one-time login; defaults true). */
-    headless?: boolean;
-    /** Max seconds to wait for a reply before returning the partial. */
-    replyTimeoutMs?: number;
-    /** DeepSeek web origin. */
-    baseUrl?: string;
-}
-/** Parsed reply from the accumulated SSE text. */
-export interface ParsedStreamReply {
-    /** Markdown body (thinking wrapped in a <details> block). */
-    markdown: string;
-    /** Raw thinking text (empty when the model has none). */
-    thinking: string;
-    /** True once the stream reported FINISHED. */
-    finished: boolean;
-}
-/**
- * Parse the accumulated `/api/v0/chat/completion` SSE body into reply text.
- * The stream is `event:` / `data:` lines; each `data:` payload is JSON. The
- * protocol distinguishes the R1 reasoning fragment (type `THINK`) from the
- * answer fragment (type `RESPONSE`), and carries search steps as `TOOL_SEARCH`
- * / `TOOL_OPEN` fragments:
- *   - {"v":{"response":{"fragments":[{"type":"THINK","content":"…"}]}}}
- *     a snapshot carrying the fragment list and their types.
- *   - {"p":"response/fragments","o":"APPEND","v":[{"type":"RESPONSE",…}]}
- *     appends a NEW fragment (reasoning / search / answer); `-1/content`
- *     deltas after this belong to that new fragment.
- *   - {"p":"response/fragments/-1/content","o":"APPEND","v":"是一座"} — appends
- *     a text delta to the CURRENT fragment's content.
- *   - {"p":"response/fragments/-1/results","o":"SET","v":[…]} — search results
- *     for a TOOL_SEARCH step (rendered as "搜索到 N 个网页").
- *   - {"v":"将"} — a bare delta continuing the current fragment; a bare
- *     `{"v":[{p:"content",o:"APPEND",v:"[reference:N]"},…]}` carries citation
- *     markers.
- *   - {"p":"response/status","o":"SET","v":"FINISHED"} — generation complete.
- */
-export declare function parseStreamReply(raw: string): ParsedStreamReply;
-export declare class DeepSeekWebEngine {
-    private readonly store;
-    private readonly config;
-    private readonly profileDir;
-    private context;
-    private page;
-    private readonly queue;
-    private state;
-    private engineError;
-    private busy;
-    private lastError;
-    private lastErrorCode;
-    private launchedOnce;
-    /** True while a headed one-time login window is open (auto-closes on login). */
-    private loginMode;
-    /** Remembered login state — survives the auto-close so the panel stays "已登录". */
-    private loggedInOnce;
-    /** Commanded toggle state (best-effort read-back overrides on status). */
-    private deepThink;
-    private search;
-    constructor(store: TranscriptStore, config: WebChatEngineConfig);
-    /** Coarse state for status snapshots. */
-    getState(): EngineState;
-    getEngineError(): string | undefined;
-    getBusy(): boolean;
-    getLastError(): string | undefined;
-    getLastErrorCode(): WebChatErrorCode | undefined;
-    /** Set the last error + its structured code together (keeps them in sync). */
-    private setLastError;
-    private setState;
-    /** Resolve a browser launch descriptor (executable + args). */
-    private launchOptions;
-    /**
-     * Ensure the browser + chat.deepseek.com page exist. Launches the persistent
-     * context on first call; subsequent calls reuse the page.
-     */
-    /** True when the cached page/context are still connected (not closed by the user). */
-    private isPageAlive;
-    ensureBrowser(): Promise<Page>;
-    /** The candidate list used during auto-detection. */
-    private launchOptionsCandidates;
-    /** Navigate to the DeepSeek chat root. */
-    private openDeepSeekPage;
-    /** True when the page shows the chat UI (not the login page). */
-    isLoggedIn(): Promise<boolean | null>;
-    /**
-     * Open a visible browser window for the one-time login. The window is forced
-     * headed (login needs a user) and auto-closes as soon as the page reaches the
-     * chat UI; normal chatting then runs headless on the persisted profile.
-     */
-    openLoginWindow(): Promise<{
-        ok: boolean;
-        error?: string;
-    }>;
-    /** Poll the login window and close it once the user has logged in. */
-    private watchLoginAndClose;
-    /** Current page URL (for status/debug). */
-    pageUrl(): string | undefined;
-    /**
-     * Best-effort read of the deep-think (R1) and search toggle state from the
-     * page. The toggles are `div.ds-toggle-button` elements (NOT `<button>`)
-     * carrying `aria-pressed` plus a `ds-toggle-button--selected` class when on;
-     * the search toggle is labeled 智能搜索. Falls back to the last commanded
-     * state when the page gives no clear signal.
-     */
-    private readToggles;
-    /** Serialized page evaluation guarded against a dead page. */
-    private evalPage;
-    /**
-     * In-page scraper: returns the ordered rendered messages currently in the
-     * DOM. Uses the virtual-list item keys as message boundaries and the
-     * assistant-main-content class to split roles. Fallback only — the primary
-     * reply source is the teed SSE stream.
-     */
-    private scrapeConversation;
-    /** Convert scraped DOM messages into transcript messages (markdown content). */
-    private scrapedToMessages;
-    /**
-     * Scrape the DeepSeek sidebar conversation titles (best effort). The web
-     * conversation list has no stable contract, so several candidate selectors
-     * are probed and short non-menu texts are returned.
-     */
-    listWebConversations(): Promise<Array<{
-        title: string;
-    }>>;
-    /** Click a sidebar conversation whose text contains the given title. */
-    private clickConversationByTitle;
-    /**
-     * Recover a web conversation into the local transcript store: open it in the
-     * sidebar, scrape its history, and import it (idempotent by title).
-     */
-    recoverWebConversation(title: string): Promise<{
-        ok: boolean;
-        chatId?: string;
-        title?: string;
-        created?: boolean;
-        error?: string;
-    }>;
-    /** Detect whether the page is currently generating (stop affordance visible). */
-    private isGenerating;
-    /** Click the stop-generation affordance, best effort. */
-    stop(): Promise<void>;
-    /** Find the composer textarea (defensive selector list). */
-    private composerLocator;
-    /**
-     * Upload local image files into the composer through the page's (usually
-     * hidden) file input. `setInputFiles` fires the input's change event, which
-     * is how DeepSeek picks up attachments without clicking its native dialog.
-     */
-    private attachImages;
-    /**
-     * Send a message through the real web page.
-     * @param text - message text.
-     * @param wait - when true (agent tools), resolve with the final reply after
-     *   streaming completes; when false (GUI), resolve right after the message
-     *   is submitted — the reply streams in the background into the transcript
-     *   and the panel polls it live.
-     */
-    send(text: string, wait?: boolean, images?: string[]): Promise<SendResult>;
-    private sendImpl;
-    /**
-     * Background reply loop. Primary source is the teed SSE stream (raw model
-     * markdown, no selectors); if the capture never installs, falls back to
-     * scraping the rendered DOM. Writes the growing reply into the transcript
-     * until the stream reports done/FINISHED or the timeout hits.
-     */
-    private streamReply;
-    /** Start a new chat on the web page (best effort) + a fresh local transcript. */
-    newChat(): Promise<{
-        ok: boolean;
-        chatId?: string;
-        error?: string;
-    }>;
-    /**
-     * Click a toggle on the page by label candidates (best effort — the DeepSeek
-     * web UI has no stable contract, so a miss is not an error). The toggles are
-     * `div.ds-toggle-button` elements (not `<button>`), so those selectors come
-     * first; `<button>` variants remain as fallbacks for older page versions.
-     * @returns true when a candidate was clicked.
-     */
-    private clickToggle;
-    /** Toggle deep-think (R1) mode on the web page. */
-    setDeepThink(enabled: boolean): Promise<{
-        ok: boolean;
-        error?: string;
-    }>;
-    /** Toggle internet search on the web page (web label: 智能搜索). */
-    setSearch(enabled: boolean): Promise<{
-        ok: boolean;
-        error?: string;
-    }>;
-    /** Close the browser (releases the profile lock). */
-    disposeBrowser(): Promise<void>;
-    /** Engine snapshot for status routes and agent tools. */
-    status(): Promise<{
-        engine: EngineState;
-        engineError?: string;
-        loggedIn: boolean | null;
-        pageUrl?: string;
-        deepThink: boolean;
-        search: boolean;
-        busy: boolean;
-        lastError?: string;
-        lastErrorCode?: WebChatErrorCode;
-    }>;
-}
-export interface MarkupNode {
-    readonly tagName?: string;
-    readonly nodeType: number;
-    readonly textContent?: string;
-    readonly children: MarkupNode[];
-    readonly attributes: Record<string, string | undefined>;
-    readonly parent?: MarkupNode;
-}
-/** Convert a scraped markdown-HTML string to markdown (used by send). */
-export declare function scrapedHtmlToMarkdown(html: string): string;

package/lib/types/engine/html-md.d.ts

@@ -1,23 +0,0 @@
-/**
- * Minimal HTML → Markdown converter used to scrape DeepSeek's rendered
- * `.ds-markdown` replies. Covers the shapes DeepSeek renders (headings,
- * paragraphs, code blocks with syntax classes, inline code, bold/italic,
- * links, images, lists, tables, blockquotes, math placeholders). Anything
- * unrecognized falls back to its text content — fidelity loss degrades
- * gracefully instead of dropping text.
- */
-interface NodeLike {
-    readonly tagName?: string;
-    readonly nodeType?: number;
-    readonly textContent?: string | null;
-    readonly children?: readonly NodeLike[];
-    readonly attributes?: Record<string, string | undefined>;
-    readonly innerHTML?: string;
-    readonly className?: string;
-    readonly parent?: NodeLike;
-}
-/** Convert one DOM subtree (element or text) to markdown. */
-export declare function htmlToMarkdown(root: NodeLike): string;
-/** Convert serialized DOM (from the in-page scraper) to markdown. */
-export declare function serializeToMarkdown(root: NodeLike): string;
-export {};

package/lib/types/index.d.ts

@@ -1,63 +0,0 @@
-/**
- * dsh-webchat — host half. Mounts the DeepSeek web engine (a real browser at
- * chat.deepseek.com driven through its own page, persistent login profile),
- * the /api/dsh-webchat route family, the agent tools (webchat_status,
- * webchat_send, webchat_import, webchat_transfer), the harness transfer
- * (seed a new session with a web transcript) and a system-prompt
- * announcement. The browser half (./client) renders the chat panel. All
- * transport rides the official NPM SDK packages — no dsh source changes.
- */
-import type { Context } from '@deepseek-ai/cordis';
-import z from 'schemastery';
-/** Stable cordis plugin name. */
-export declare const name = "webchat";
-/** Services required before the web-chat surfaces can mount. */
-export declare const inject: string[];
-/**
- * Settings namespace of the web-chat capability — the section the web
- * settings surface edits. Spelled here rather than imported: the browser half
- * spells the same value and must not depend on a Host package.
- */
-export declare const WEBCHAT_SETTINGS_NAMESPACE: import("@deepseek-ai/dsh-settings").SettingsNamespace;
-/** Plugin config, validated by the same-named schemastery schema. */
-export interface Config {
-    /** When true (default), a system-prompt section announces the plugin to every agent. */
-    announceToAgent?: boolean;
-    /** Master switch for the plugin (routes, tools, prompt section). */
-    enabled?: boolean;
-    /** Browser channel hint ('chrome' | 'msedge' | 'chromium' | 'auto'). */
-    browserChannel?: string;
-    /** Explicit browser executable path. */
-    browserExecutablePath?: string;
-    /** Proxy mode: 'direct' | 'system' | 'http://host:port'. */
-    browserProxy?: string;
-    /**
-     * Run the chat browser headless (invisible). Default true: only the one-time
-     * login window is visible, and it auto-closes once logged in. Set false to
-     * keep a visible browser window during chatting too.
-     */
-    browserHeadless?: boolean;
-    /** Max ms to wait for a web reply. */
-    replyTimeoutMs?: number;
-    /** Data directory override (tests). */
-    dataDir?: string;
-    /** When true (default), distill the transcript into an executable task brief before transfer. */
-    transferDistill?: boolean;
-    /** Provider route for the transfer distillation call (empty = auto-detect). */
-    transferProvider?: string;
-    /** Model id for the transfer distillation call (empty = auto-detect). */
-    transferModel?: string;
-    /** Output-token cap for the final distillation brief (default 4096). */
-    transferMaxTokens?: number;
-    /** Output-token cap per chunk summary in long-conversation map-reduce (default 1024). */
-    transferChunkTokens?: number;
-}
-export declare const Config: z<Config>;
-/** Model-facing announcement: plugin presence, capabilities, and limits. */
-export declare const WEBCHAT_GUIDANCE = "\u672C\u673A\u5DF2\u5B89\u88C5 dsh-webchat \u63D2\u4EF6\uFF08Codex ChatGPT \u6A21\u5F0F \u00B7 DeepSeek \u7F51\u9875\u7AEF\u804A\u5929\uFF09\uFF1A\u4FA7\u8FB9\u680F\u300C\u7F51\u9875\u804A\u5929\u300D\u5165\u53E3\uFF1B\u901A\u8FC7\u771F\u5B9E\u6D4F\u89C8\u5668\u9A71\u52A8 chat.deepseek.com\uFF08DeepSeek \u7F51\u9875\u6A21\u578B\uFF0C\u6DF1\u5EA6\u601D\u8003/\u667A\u80FD\u641C\u7D22\u5F00\u5173\uFF0C\u7F51\u9875\u767B\u5F55\u4F1A\u8BDD\uFF0C\u65E0\u9700 API \u989D\u5EA6\uFF09\u3002\u80FD\u529B\uFF1Awebchat_status \u67E5\u770B\u767B\u5F55/\u4F1A\u8BDD\u72B6\u6001\u3001webchat_send \u901A\u8FC7\u7F51\u9875\u7AEF\u53D1\u9001\u6D88\u606F\u5E76\u6D41\u5F0F\u83B7\u53D6\u56DE\u590D\uFF08\u53EF\u9644\u5E26\u672C\u5730\u56FE\u7247\u8DEF\u5F84\u505A\u591A\u6A21\u6001\u63D0\u95EE\uFF09\u3001webchat_recover \u628A\u7F51\u9875\u7AEF\u5DF2\u6709\u4F1A\u8BDD\u540C\u6B65/\u6062\u590D\u5230\u672C\u5730\u3001webchat_import \u628A\u5B58\u50A8\u7684\u7F51\u9875\u5BF9\u8BDD\u5BFC\u5165\u4E3A markdown \u4E0A\u4E0B\u6587\u3001webchat_transfer \u628A\u7F51\u9875\u5BF9\u8BDD\u84B8\u998F\u6210\u53EF\u6267\u884C\u4EFB\u52A1\u7B80\u62A5\u5E76\u521B\u5EFA\u65B0 harness \u4F1A\u8BDD\uFF08\u9996\u6761\u6D88\u606F\u5373\u4EFB\u52A1\u7B80\u62A5\uFF0C\u800C\u975E\u539F\u59CB\u804A\u5929\u8BB0\u5F55\uFF09\uFF0C\u6216\u7ECF targetSessionId \u628A\u7B80\u62A5\u4F5C\u4E3A\u65B0\u6D88\u606F\u8FFD\u52A0\u5230\u5DF2\u6709\u4F1A\u8BDD\u5EF6\u7EED\u540C\u4E00\u4EFB\u52A1\uFF1BGUI \u9762\u677F\u53EF\u5C06\u5BF9\u8BDD\u968F\u65F6\u5BFC\u51FA\u4E3A\u5DE5\u4F5C\u533A\u6587\u4EF6\u6216\u8F6C\u5165 harness \u4F1A\u8BDD\u3002\u9650\u5236\uFF1A\u9996\u6B21\u4F7F\u7528\u9700\u7528\u6237\u5728\u5F39\u51FA\u7684\u6D4F\u89C8\u5668\u7A97\u53E3\u5B8C\u6210 DeepSeek \u7F51\u9875\u767B\u5F55\uFF1B\u7F51\u9875\u7AEF\u53D7 DeepSeek \u5B98\u65B9\u98CE\u63A7\uFF0C\u64CD\u4F5C\u5931\u8D25\u6216\u9875\u9762\u6539\u7248\u65F6\u8FD4\u56DE\u9519\u8BEF\u800C\u975E\u5D29\u6E83\uFF1B\u9762\u677F\u63D0\u4F9B\u300C\u6DF1\u5EA6\u601D\u8003\uFF08R1\uFF09\u300D\u4E0E\u300C\u667A\u80FD\u641C\u7D22\u300D\u5F00\u5173\uFF08\u7F51\u9875\u7AEF\u65E0\u6A21\u578B\u9009\u62E9\u5668\uFF09\u3002\u7528\u6237\u63D0\u5230\u300C\u7F51\u9875\u804A\u5929 / \u7F51\u9875\u7AEF / ChatGPT \u6A21\u5F0F / deepseek web / \u8F6C\u79FB\u5230 harness\u300D\u65F6\u5373\u6307\u672C\u63D2\u4EF6\uFF0C\u8BF7\u636E\u6B64\u534F\u4F5C\u3002";
-/**
- * Mount the engine, routes, tools, and announcement.
- * @param ctx - host plugin context carrying webServer/tools/systemPrompt.
- * @param config - resolved plugin config (schema defaults applied by the loader).
- */
-export declare function apply(ctx: Context, config?: Config): void;