@jaychang1989/dsh-webchat 0.3.0

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

@@ -0,0 +1,74 @@
+/**
+ * Browser-side API client for the /api/dsh-webchat route family. The only
+ * data access path the panel components use — plain fetch, same origin.
+ */
+import { type TransferMode, type WebChatState } from '../protocol.ts';
+/** Shape every /api/dsh-webchat response carries: ok plus optional error. */
+interface ApiResult {
+    ok: boolean;
+    error?: string;
+}
+/** Endpoint payloads always extend ApiResult. */
+type EndpointResult<T> = T & ApiResult;
+export declare class WebChatApi {
+    state(): Promise<EndpointResult<WebChatState>>;
+    openLogin(): Promise<EndpointResult<{
+        ok: boolean;
+    }>>;
+    closeBrowser(): Promise<EndpointResult<{
+        ok: boolean;
+    }>>;
+    newChat(): Promise<EndpointResult<{
+        ok: boolean;
+        chatId?: string;
+    }>>;
+    send(text: string, images?: string[]): Promise<EndpointResult<{
+        ok: boolean;
+        chatId?: string;
+    }>>;
+    stop(): Promise<EndpointResult<{
+        ok: boolean;
+    }>>;
+    setDeepThink(enabled: boolean): Promise<EndpointResult<{
+        ok: boolean;
+    }>>;
+    setSearch(enabled: boolean): Promise<EndpointResult<{
+        ok: boolean;
+    }>>;
+    transfer(chatId: string, cwd?: string, mode?: TransferMode, workspaceId?: string, targetSessionId?: string): Promise<EndpointResult<{
+        ok: boolean;
+        sessionId?: string;
+        distilled?: boolean;
+        attached?: boolean;
+        continued?: boolean;
+        workspaceId?: string;
+    }>>;
+    exportFile(chatId: string, cwd?: string): Promise<EndpointResult<{
+        ok: boolean;
+        filePath?: string;
+    }>>;
+    renameChat(chatId: string, title: string): Promise<EndpointResult<{
+        ok: boolean;
+    }>>;
+    deleteChat(chatId: string): Promise<EndpointResult<{
+        ok: boolean;
+    }>>;
+    clearChats(): Promise<EndpointResult<{
+        ok: boolean;
+        count?: number;
+    }>>;
+    webChats(): Promise<EndpointResult<{
+        ok: boolean;
+        web: Array<{
+            title: string;
+        }>;
+        missing: string[];
+    }>>;
+    recover(title: string): Promise<EndpointResult<{
+        ok: boolean;
+        chatId?: string;
+        title?: string;
+        created?: boolean;
+    }>>;
+}
+export {};

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

@@ -0,0 +1,19 @@
+/**
+ * Panel controller: minimal external state the sidebar entry and the panel
+ * share (open/closed), plus a tiny pub/sub. The chat data itself lives in the
+ * panel component's polling loop.
+ */
+export interface PanelSnapshot {
+    readonly panelOpen: boolean;
+}
+/** Plain pub/sub store (no React dependency — used by the DOM sidebar entry). */
+export declare class PanelController {
+    private snapshot;
+    private readonly listeners;
+    getSnapshot(): PanelSnapshot;
+    subscribe(listener: () => void): () => void;
+    private set;
+    open(): void;
+    close(): void;
+    toggle(): void;
+}

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

@@ -0,0 +1,30 @@
+/**
+ * Browser-half entry for the dsh-webchat plugin — runs inside the dsh web GUI.
+ *
+ * Registers the locale dictionaries and mounts the two DOM surfaces: the
+ * sidebar entry row (toggles the panel) and the web-chat panel in the center
+ * column. Failure policy: DOM mounting problems are logged, never thrown —
+ * the web shell fails the whole boot when a plugin apply throws, and an
+ * external plugin must not take the GUI down.
+ *
+ * Export discipline (packages/client rule): the /client surface carries what
+ * cordis loading needs plus types only — all value exports stay internal.
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type WebChatKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** dsh-webchat surface copy. */
+        'dsh-webchat': WebChatKey;
+    }
+}
+/** Required services (fiber inject waiting — the runtime must be up first). */
+export declare const inject: string[];
+/** Type-only surface (export discipline: no value exports beyond the plugin contract). */
+export type { WebChatPanelProps } from './panel/WebChatPanel.tsx';
+export type { WebChatKey } from './locales.ts';
+/**
+ * Mount the web-chat panel.
+ * @param ctx - client root context (locale + sessions services).
+ */
+export declare function apply(ctx: ClientContext): void;

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

@@ -0,0 +1,169 @@
+/**
+ * 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

@@ -0,0 +1,23 @@
+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

@@ -0,0 +1,15 @@
+/**
+ * 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

@@ -0,0 +1,28 @@
+/**
+ * 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

@@ -0,0 +1,60 @@
+/**
+ * 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

@@ -0,0 +1,22 @@
+/**
+ * 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;