dsh-messager 0.1.4

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

@@ -0,0 +1,92 @@
+/**
+ * dsh-messager 客户端字典（zh / en），注册进 DSH locale 服务
+ * （ctx.locale.register('dsh-messager', { zh, en })）。
+ * 键集合必须 zh/en 一致（tests/locales.spec.ts 校验）。
+ */
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** 本插件字典键（typed bind / slot locale 声明）。 */
+        'dsh-messager': keyof typeof zh;
+    }
+}
+export declare const zh: {
+    nav: string;
+    'section.description': string;
+    'group.triggers': string;
+    'group.system': string;
+    'group.browser': string;
+    'group.feishu': string;
+    'group.message': string;
+    'field.triggers.interaction': string;
+    'field.triggers.completed': string;
+    'field.triggers.error': string;
+    'field.system.enabled': string;
+    'field.system.icon': string;
+    'field.system.verbosity': string;
+    'field.browser.enabled': string;
+    'field.browser.icon': string;
+    'field.browser.onlyWhenHidden': string;
+    'field.browser.verbosity': string;
+    'field.feishu.enabled': string;
+    'field.feishu.webhookUrl': string;
+    'field.feishu.secret': string;
+    'field.feishu.timeoutMs': string;
+    'field.feishu.verbosity': string;
+    'field.message.titlePrefix': string;
+    'field.message.includeSessionTitle': string;
+    'field.message.guiUrl': string;
+    'hint.system.icon': string;
+    'hint.feishu.secret': string;
+    'hint.message.titlePrefix': string;
+    'action.save': string;
+    'action.saving': string;
+    'action.discard': string;
+    'action.reset': string;
+    'badge.overridden': string;
+    'status.readOnly': string;
+    'status.saveFailed': string;
+    'status.invalidInput': string;
+    'status.invalidField': string;
+    'status.unavailable': string;
+};
+export declare const en: {
+    nav: string;
+    'section.description': string;
+    'group.triggers': string;
+    'group.system': string;
+    'group.browser': string;
+    'group.feishu': string;
+    'group.message': string;
+    'field.triggers.interaction': string;
+    'field.triggers.completed': string;
+    'field.triggers.error': string;
+    'field.system.enabled': string;
+    'field.system.icon': string;
+    'field.system.verbosity': string;
+    'field.browser.enabled': string;
+    'field.browser.icon': string;
+    'field.browser.onlyWhenHidden': string;
+    'field.browser.verbosity': string;
+    'field.feishu.enabled': string;
+    'field.feishu.webhookUrl': string;
+    'field.feishu.secret': string;
+    'field.feishu.timeoutMs': string;
+    'field.feishu.verbosity': string;
+    'field.message.titlePrefix': string;
+    'field.message.includeSessionTitle': string;
+    'field.message.guiUrl': string;
+    'hint.system.icon': string;
+    'hint.feishu.secret': string;
+    'hint.message.titlePrefix': string;
+    'action.save': string;
+    'action.saving': string;
+    'action.discard': string;
+    'action.reset': string;
+    'badge.overridden': string;
+    'status.readOnly': string;
+    'status.saveFailed': string;
+    'status.invalidInput': string;
+    'status.invalidField': string;
+    'status.unavailable': string;
+};
+//# sourceMappingURL=locales.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,2CAA2C;QAC3C,cAAc,EAAE,MAAM,OAAO,EAAE,CAAA;KAChC;CACF;AAED,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2Cd,CAAA;AAED,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2Cd,CAAA"}

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

@@ -0,0 +1,16 @@
+/**
+ * 设置页分区组件：渲染在 设置 → 「通知&信使」分区（Agent预设下方，动态 order）。
+ *
+ * 数据走 webServer 配置路由（见 src/config-route.ts / fetch-scope.ts），
+ * 不受 Web 设置白名单门控 —— 发行版（未打补丁）同样可读写。
+ * 表单体复用 MessagerSettingsForm；文案经 face 平铺的 t() 取当前语言。
+ */
+import type { PropsRuntime, InjectFace } from '@deepseek-ai/dsh-client-ui-slots';
+import type { MessagerCardFace } from './card-controller.js';
+export type MessagerSectionProps = PropsRuntime<'settings.section'> & InjectFace<MessagerCardFace>;
+/**
+ * dsh-messager 设置分区（设置页「通知&信使」）。
+ * @param props - 槽位 owner props + 注入面（useMessagerCard + 动作 + t）。
+ */
+export declare function MessagerSection(props: MessagerSectionProps): import("react").JSX.Element;
+//# sourceMappingURL=section.d.ts.map

package/lib/types/client/section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.d.ts","sourceRoot":"","sources":["../../../src/client/section.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAEhF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAG5D,MAAM,MAAM,oBAAoB,GAAG,YAAY,CAAC,kBAAkB,CAAC,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAA;AA+BlG;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,+BAe1D"}

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

@@ -0,0 +1,22 @@
+/**
+ * dsh-messager 设置表单体（设置页分区共用）。
+ *
+ * 渲染全部字段分组（FieldRow）+ 底部操作栏（放弃修改 / 保存），
+ * 样式沿用 DSH 主题变量（--dsw-alias-*），与 ValueField 布局同源。
+ * 文案经 t() 取当前语言（字典见 locales.ts）；字段 label/hint 为翻译键。
+ */
+import type { MessagerCardActions, MessagerCardState } from './card-controller.js';
+/** 分组标题的翻译键（键见 locales.ts；导出供字典一致性测试）。 */
+export declare const GROUP_TITLE_KEYS: Record<string, string>;
+/**
+ * 设置表单体：全部字段分组 + 底部操作栏。
+ * @param state - 控制器快照（useMessagerCard 的返回）。
+ * @param actions - 控制器动作（edit/reset/save/discard）。
+ * @param t - 翻译函数（键 → 当前语言文案）。
+ */
+export declare function MessagerSettingsForm({ state, actions, t }: {
+    state: MessagerCardState;
+    actions: MessagerCardActions;
+    t: (key: string) => string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=settings-form.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings-form.d.ts","sourceRoot":"","sources":["../../../src/client/settings-form.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAiB,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAEjG,0CAA0C;AAC1C,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMnD,CAAA;AA2ND;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE;IAC1D,KAAK,EAAE,iBAAiB,CAAA;IACxB,OAAO,EAAE,mBAAmB,CAAA;IAC5B,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;CAC3B,+BAqDA"}

package/lib/types/config-shared.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 配置路由的跨端共享类型（host 与浏览器 client 共用，不得 import 任何
+ * Node/浏览器专属模块）。
+ */
+/** 配置路由路径（挂在 DSH webServer 上，同源访问）。 */
+export declare const CONFIG_PATH = "/dsh-messager/config";
+/** client ScopeLike 快照同构的配置视图。 */
+export interface ConfigView {
+    status: 'ready' | 'unavailable';
+    value: unknown;
+    user: unknown;
+    base: unknown;
+    writable: boolean;
+    mode: 'host';
+    revision?: number;
+}
+/** client ScopeWriteOp 同构的写操作。 */
+export interface ConfigWriteOp {
+    op: 'set' | 'unset';
+    path: string[];
+    value?: unknown;
+}
+/** POST /dsh-messager/config 的请求体。 */
+export interface ConfigWriteBody {
+    ops: ConfigWriteOp[];
+    expectedRevision?: number;
+}
+//# sourceMappingURL=config-shared.d.ts.map

package/lib/types/config-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-shared.d.ts","sourceRoot":"","sources":["../../src/config-shared.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uCAAuC;AACvC,eAAO,MAAM,WAAW,yBAAyB,CAAA;AAEjD,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,GAAG,aAAa,CAAA;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,OAAO,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,KAAK,GAAG,OAAO,CAAA;IACnB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,aAAa,EAAE,CAAA;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B"}

package/lib/types/config.d.ts

@@ -0,0 +1,82 @@
+/**
+ * dsh-messager 配置模型。
+ *
+ * 本 schema 同时承担两个角色：
+ * - host 端的 Loader config（cordis.yml 中该插件行的 `config:`，成为 settings 命名空间的 base 层）；
+ * - `ctx.settings.register('messager', Config, { base })` 的命名空间 schema，
+ *   因此 Web 设置页会自动渲染配置表单，用户层可覆盖 base。
+ *
+ * 有效值优先级：schema 默认值 → base（cordis.yml）→ 用户层（设置页）。
+ */
+import Schema from '@deepseek-ai/schemastery';
+/** 通知内容繁复度。 */
+export type Verbosity = 'minimal' | 'normal' | 'detailed';
+/** 触发时机开关（需求 1：什么时候通知）。 */
+export interface TriggerConfig {
+    /** 会话需要交互（审批 / 提问 / 计划待审）时通知。 */
+    interaction: boolean;
+    /** 任务执行完毕时通知。 */
+    completed: boolean;
+    /** 任务出错时通知。 */
+    error: boolean;
+}
+/** 系统通知通道（OS 级 toast，host 端由 node-notifier 投递）。 */
+export interface SystemChannelConfig {
+    enabled: boolean;
+    /** 图标：绝对路径（或包内 assets/icon.png 的绝对路径）。 */
+    icon?: string;
+    verbosity: Verbosity;
+}
+/** 浏览器通知通道（Web Notification API，client 端投递）。 */
+export interface BrowserChannelConfig {
+    enabled: boolean;
+    /** 图标：URL 或 data URL。 */
+    icon?: string;
+    /** 仅当页面隐藏/未聚焦时才弹通知，避免看着界面还被打扰。 */
+    onlyWhenHidden: boolean;
+    verbosity: Verbosity;
+}
+/** 飞书机器人通道（webhook 版，即自定义机器人 webhook，host 端投递）。 */
+export interface FeishuChannelConfig {
+    enabled: boolean;
+    /** 飞书自定义机器人 webhook 地址。 */
+    webhookUrl?: string;
+    /** 签名密钥（飞书机器人 webhook“安全设置-签名校验”），配置后按 HMAC-SHA256 签名。 */
+    secret?: string;
+    /** 单次请求超时（ms）。 */
+    timeoutMs: number;
+    verbosity: Verbosity;
+}
+/** 去重 / 节流配置。 */
+export interface DedupConfig {
+    /** 同一会话同一类触发的冷却时间（ms）。 */
+    interactionCooldownMs: number;
+    /** 完成通知防抖窗口（ms）：等待 turn/end 事件以丰富内容并合并边界抖动。 */
+    completedDebounceMs: number;
+    /** 每通道每分钟通知上限（防止第三方通道限流/刷屏）。 */
+    perChannelPerMinute: number;
+}
+/** 消息内容配置。 */
+export interface MessageConfig {
+    /** 标题前缀，例如 "[DSH]"。 */
+    titlePrefix?: string;
+    /** 正文是否附带会话标题。 */
+    includeSessionTitle: boolean;
+    /** GUI 地址，用于通知中的“打开”链接/按钮。 */
+    guiUrl: string;
+}
+export interface Config {
+    triggers: TriggerConfig;
+    system: SystemChannelConfig;
+    browser: BrowserChannelConfig;
+    feishu: FeishuChannelConfig;
+    dedup: DedupConfig;
+    message: MessageConfig;
+}
+export declare const Config: Schema<Config>;
+/**
+ * 用 schema 默认值解析一份配置（输入可省略任意字段）。
+ * 与 cordis Loader 的校验同源，保证“默认值 → base → 用户层”的解析一致。
+ */
+export declare function resolveConfig(input?: Partial<Config>): Config;
+//# sourceMappingURL=config.d.ts.map

package/lib/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAE7C,eAAe;AACf,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAA;AAEzD,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,WAAW,EAAE,OAAO,CAAA;IACpB,iBAAiB;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,eAAe;IACf,KAAK,EAAE,OAAO,CAAA;CACf;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,SAAS,CAAA;CACrB;AAED,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kCAAkC;IAClC,cAAc,EAAE,OAAO,CAAA;IACvB,SAAS,EAAE,SAAS,CAAA;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,SAAS,CAAA;CACrB;AAED,iBAAiB;AACjB,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,+CAA+C;IAC/C,mBAAmB,EAAE,MAAM,CAAA;IAC3B,gCAAgC;IAChC,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAED,cAAc;AACd,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kBAAkB;IAClB,mBAAmB,EAAE,OAAO,CAAA;IAC5B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,aAAa,CAAA;IACvB,MAAM,EAAE,mBAAmB,CAAA;IAC3B,OAAO,EAAE,oBAAoB,CAAA;IAC7B,MAAM,EAAE,mBAAmB,CAAA;IAC3B,KAAK,EAAE,WAAW,CAAA;IAClB,OAAO,EAAE,aAAa,CAAA;CACvB;AAID,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,CAsChC,CAAA;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAE,OAAO,CAAC,MAAM,CAAM,GAAG,MAAM,CAEjE"}

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "dsh-messager",
+  "version": "0.1.4",
+  "description": "DeepSeek Harness 通知插件：会话交互/任务完成/出错时通过系统通知、浏览器通知、飞书机器人（webhook）推送提醒",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "assets",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.client.json && pnpm run build:client",
+    "build:client": "tsdown",
+    "prepare": "pnpm run build",
+    "prepublishOnly": "pnpm run test",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-agent": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-api-remotes": "0.1.0-rc.6",
+    "@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-primitives": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-host-webserver": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-title": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-settings": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-user-approval": "0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "node-notifier": "^10.0.1",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "@types/node-notifier": "^8.0.5",
+    "@types/react": "~18.3.31",
+    "tsdown": "^0.22.14",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-primitives"
+      ],
+      "platform": "web"
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "deepseek-harness-plugin",
+    "notification",
+    "feishu",
+    "webhook"
+  ],
+  "packageManager": "pnpm@11.7.0",
+  "license": "MIT"
+}