dsh-workbuddy-connect 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Corrine Hu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,58 @@
+# DSH WorkBuddy Connect
+
+English | [中文](./README.md)
+
+Brings every model in the WorkBuddy desktop app (GLM-5.3, GLM-5.2, DeepSeek-V4-Pro, DeepSeek-V4-Flash, Kimi-K3, MiniMax-M3, Hy3, and more) straight into [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) — zero configuration in the DSH chat.
+
+## Features
+
+- **Works out of the box**: install and enable the plugin, then use it directly in DSH — no extra configuration.
+
+![WorkBuddy models in the DSH model picker](assets/1.png)
+
+- **Info at a glance**: Settings → Plugins → DSH WorkBuddy Connect card
+
+![Settings card showing the plugin](assets/2.png)
+
+Expand the card to see the account, token validity, and remaining credit.
+
+![Settings card showing account and remaining credit](assets/3.png)
+
+## Install
+
+Prerequisite: the WorkBuddy desktop app is installed and signed in (the plugin reuses the app's sign-in state and follows account switches automatically).
+
+```sh
+# npm (recommended; ships prebuilt artifacts)
+dsh plugin --profile web add dsh-workbuddy-connect
+
+# or install from the GitHub source
+dsh plugin --profile web add github:corrinehu/dsh-workbuddy-connect
+
+dsh web
+```
+
+## CLI
+
+`dsh plugin --profile web exec dsh-workbuddy-connect status`: sign-in state and remaining credit (`--json` for machine-readable output; `doctor` for diagnostics and `logout` for credential cleanup are also available).
+
+## Known limitations
+
+- Verified on macOS with the DSH Web profile (`0.1.1-rc.2`+, Node 22+). The default credential paths on Windows / Linux are unverified — point the `WORKBUDDY_AUTH_FILE` environment variable at the actual location if needed.
+- Relies on WorkBuddy client interfaces (not a public API); the plugin may need updates as WorkBuddy changes.
+
+## Disclaimer
+
+- This project is for **personal learning and research only**, driving your own WorkBuddy account on your own machine. Do not use it commercially or beyond reasonable personal use.
+- Users must comply with the WorkBuddy terms of service. Any consequence of using this project (including but not limited to account restrictions, depleted credit, or service interruption) is borne by the user.
+- The author is not liable for any direct or indirect loss arising from the use or misuse of this project.
+- This project is not affiliated with, endorsed by, or sponsored by Tencent, WorkBuddy, or DeepSeek. Product names are used for compatibility description only; trademarks belong to their respective owners.
+
+## Acknowledgements
+
+- [Sliverkiss/workbuddy2api](https://github.com/Sliverkiss/workbuddy2api) (MIT) — reference implementation of the WorkBuddy upstream protocol.
+- [franksong2702/dsh-codex-connect](https://github.com/franksong2702/dsh-codex-connect) (Apache-2.0) — reference for the DSH plugin structure and provider registration.
+
+## License
+
+[MIT](./LICENSE)

package/README.md

@@ -0,0 +1,64 @@
+# DSH WorkBuddy Connect
+
+
+[English](./README.en.md) | 中文
+
+
+将 WorkBuddy 桌面 App 中包含的各种模型（GLM-5.3、GLM-5.2、DeepSeek-V4-Pro、DeepSeek-V4-Flash、Kimi-K3、MiniMax-M3 、Hy3等）自动接入 DeepSeek Harness，实现在 DSH 对话窗口里零配置使用。
+
+
+## 功能
+
+- **开箱即用**：安装和启用插件后，在 DSH 中直接使用，无需额外配置。
+
+
+![WorkBuddy 模型出现在 DSH 模型选择器中](assets/1.png)
+
+
+- **信息查看**：设置 → 插件 → DSH WorkBuddy Connect 卡片
+
+
+![设置卡片显示插件](assets/2.png)
+
+卡片展开后，可查看账号信息、令牌有效期与剩余积分。
+
+![设置卡片显示账号与剩余积分](assets/3.png)
+
+## 安装
+
+前置：已安装并登录 WorkBuddy 桌面 App（插件复用 App 的登录状态，账号切换自动跟随）。
+
+```sh
+# npm（推荐，自带预构建产物）
+dsh plugin --profile web add dsh-workbuddy-connect
+
+# 或从 GitHub 源码安装
+dsh plugin --profile web add github:corrinehu/dsh-workbuddy-connect
+
+dsh web
+```
+
+## 命令行
+
+`dsh plugin --profile web exec dsh-workbuddy-connect status`：登录状态与剩余积分（`--json` 输出机器可读格式；另有 `doctor` 诊断、`logout` 清理凭据）。
+
+## 已知限制
+
+- 在 macOS 与 DSH Web profile（`0.1.1-rc.2`+、Node 22+）下验证通过；Windows / Linux 的凭据默认路径未经验证，必要时可通过环境变量 `WORKBUDDY_AUTH_FILE` 指定实际位置。
+- 依赖 WorkBuddy 客户端接口（非官方开放 API），WorkBuddy 更新后插件可能需要随之调整。
+
+## 免责声明
+
+- 本项目**仅供个人学习和研究使用**，仅驱动使用者自己的 WorkBuddy 账号在本机调用，请勿用于商业用途或超出个人合理使用的场景。
+- 使用者需遵守 WorkBuddy 的服务条款；因使用本项目产生的任何后果（包括但不限于账号被限制、额度被清空、服务中断），由使用者自行承担。
+- 本项目作者不对任何因使用或滥用本项目产生的直接或间接损失负责。
+- 本项目与腾讯、WorkBuddy、DeepSeek 均无关联，未获其授权或认可；文中出现的名称仅用于描述兼容关系，其商标权利归各自所有。
+
+## 致谢
+
+- [Sliverkiss/workbuddy2api](https://github.com/Sliverkiss/workbuddy2api)（MIT）— WorkBuddy 上游协议的参照实现。
+- [franksong2702/dsh-codex-connect](https://github.com/franksong2702/dsh-codex-connect)（Apache-2.0）— DSH 插件结构与 provider 注册的参照。
+
+## 许可证
+
+[MIT](./LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# Register the WorkBuddy provider without changing the profile's current
+# default model. The plugin reuses the WorkBuddy desktop app's sign-in; no
+# separate OAuth flow is started.
+- insert:
+    - id: llm-workbuddy
+      name: dsh-workbuddy-connect

package/lib/bin.d.ts

@@ -0,0 +1,6 @@
+//#region src/bin.d.ts
+/** Standalone status/diagnostics CLI for the dsh-workbuddy-connect bundle. */
+/** Execute one boot-free command. */
+declare function run(argv: readonly string[]): Promise<number>;
+//#endregion
+export { run };

package/lib/bin.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+import { _ as WorkBuddyCredentialStore, a as readHostHeartbeat, b as workbuddyOwnAuthPath, c as WORKBUDDY_CONNECT_VERSION, l as WorkBuddyUpstreamClient, o as workbuddyHostHeartbeatPath, p as FALLBACK_WORKBUDDY_MODELS, r as isHeartbeatProcessAlive } from "./host-heartbeat-DehQgrb9.js";
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+//#region src/bin.ts
+/** Standalone status/diagnostics CLI for the dsh-workbuddy-connect bundle. */
+const JSON_SCHEMA_VERSION = 1;
+/** Remove token-like strings from an unexpected diagnostic message. */
+function safeMessage(error) {
+	return (error instanceof Error ? error.message : String(error)).replace(/\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\b/gu, "[redacted token]").replace(/(\b(?:code|token|refresh_token|access_token)=)[^&\s]+/giu, "$1[redacted]");
+}
+function printHelp() {
+	process.stdout.write([
+		"Usage: dsh-workbuddy-connect <doctor|status|logout> [--json]",
+		"",
+		"  doctor   secret-free sign-in and environment diagnostics",
+		"  status   sign-in state, remaining WorkBuddy credit, and host-bundle health",
+		"  logout   remove the plugin-owned credential copy (the desktop app keeps its sign-in)",
+		"  --json   emit one secret-free JSON document (doctor/status only)",
+		""
+	].join("\n"));
+}
+function printJson(value) {
+	process.stdout.write(`${JSON.stringify(value)}\n`);
+}
+function makeStore() {
+	const client = new WorkBuddyUpstreamClient();
+	return new WorkBuddyCredentialStore({ refresh: (credential) => client.refreshToken(credential) });
+}
+async function doctor(jsonOutput) {
+	const store = makeStore();
+	const status = await store.status();
+	const desktopPresent = await store.desktopFilePresent();
+	const heartbeat = await readHostHeartbeat();
+	const hostAlive = heartbeat !== void 0 && isHeartbeatProcessAlive(heartbeat);
+	const report = {
+		schemaVersion: JSON_SCHEMA_VERSION,
+		package: "dsh-workbuddy-connect",
+		version: WORKBUDDY_CONNECT_VERSION,
+		node: process.version,
+		desktopAuthFile: {
+			path: store.desktopAuthPath() ?? "(no platform default; set WORKBUDDY_AUTH_FILE)",
+			present: desktopPresent
+		},
+		ownAuthFile: workbuddyOwnAuthPath(),
+		hostHeartbeat: {
+			path: workbuddyHostHeartbeatPath(),
+			present: heartbeat !== void 0,
+			...heartbeat === void 0 ? {} : {
+				registeredAt: heartbeat.registeredAt,
+				pid: heartbeat.pid
+			},
+			processAlive: hostAlive
+		},
+		signIn: status.state,
+		fallbackModels: FALLBACK_WORKBUDDY_MODELS.length,
+		hints: [
+			...status.state === "signed-in" ? [] : ["Sign in once in the WorkBuddy desktop app, then run status again."],
+			...desktopPresent ? [] : [`No WorkBuddy desktop auth file at the expected path; set WORKBUDDY_AUTH_FILE if it lives elsewhere.`],
+			...hostAlive ? [] : ["Host bundle not running in this DSH profile (or the process exited). The browser card and provider are unavailable until DSH starts the plugin."]
+		]
+	};
+	if (jsonOutput) printJson(report);
+	else process.stdout.write([
+		`WorkBuddy Connect ${WORKBUDDY_CONNECT_VERSION} on ${process.version}`,
+		`Desktop auth file: ${report.desktopAuthFile.present ? "present" : "missing"} (${report.desktopAuthFile.path})`,
+		`Host bundle: ${hostAlive ? `running (pid ${heartbeat.pid})` : heartbeat !== void 0 ? "stale heartbeat (process exited)" : "not started"}`,
+		`Sign-in state: ${report.signIn}`,
+		`Static fallback models: ${report.fallbackModels}`,
+		...report.hints.map((hint) => `Hint: ${hint}`),
+		""
+	].join("\n"));
+	return status.state === "signed-in" && desktopPresent ? 0 : 1;
+}
+async function status(jsonOutput) {
+	const store = makeStore();
+	const client = new WorkBuddyUpstreamClient();
+	const authStatus = await store.status();
+	const heartbeat = await readHostHeartbeat();
+	const hostAlive = heartbeat !== void 0 && isHeartbeatProcessAlive(heartbeat);
+	const hostState = hostAlive ? "running" : heartbeat !== void 0 ? "stale" : "not-started";
+	if (authStatus.state !== "signed-in") {
+		if (jsonOutput) printJson({
+			schemaVersion: JSON_SCHEMA_VERSION,
+			package: "dsh-workbuddy-connect",
+			version: WORKBUDDY_CONNECT_VERSION,
+			status: "signed-out",
+			hostBundle: hostState
+		});
+		else process.stdout.write(`WorkBuddy Connect: signed out\nHost bundle: ${hostState}\n`);
+		return 1;
+	}
+	let credits;
+	try {
+		const credential = await store.current();
+		if (credential !== void 0) credits = { total: (await client.fetchCredits(credential)).total };
+	} catch (error) {
+		credits = {
+			total: 0,
+			error: safeMessage(error)
+		};
+	}
+	const expiresAt = authStatus.expiresAtMs !== void 0 ? new Date(authStatus.expiresAtMs).toISOString() : void 0;
+	if (jsonOutput) {
+		printJson({
+			schemaVersion: JSON_SCHEMA_VERSION,
+			package: "dsh-workbuddy-connect",
+			version: WORKBUDDY_CONNECT_VERSION,
+			status: "signed-in",
+			...expiresAt === void 0 ? {} : { accessTokenExpires: expiresAt },
+			...authStatus.nickname === void 0 ? {} : { nickname: authStatus.nickname },
+			...authStatus.domain === void 0 || authStatus.domain === "" ? {} : { domain: authStatus.domain },
+			source: authStatus.source,
+			credits: credits?.total,
+			...credits?.error === void 0 ? {} : { creditsError: credits.error },
+			hostBundle: hostState
+		});
+		return 0;
+	}
+	process.stdout.write([
+		`WorkBuddy Connect: signed in${authStatus.nickname === void 0 ? "" : ` as ${authStatus.nickname}`}`,
+		...expiresAt === void 0 ? [] : [`Access token expires ${expiresAt} (refresh is automatic)`],
+		credits?.error === void 0 ? `Remaining credit: ${credits?.total ?? "unknown"}` : `Remaining credit: unavailable (${credits.error})`,
+		`Host bundle: ${hostAlive ? `running (pid ${heartbeat.pid})` : hostState === "stale" ? "stale heartbeat (DSH process exited)" : "not started in this profile"}`,
+		"Client card: load failures are logged to the browser console only; the host provider is unaffected.",
+		""
+	].join("\n"));
+	return 0;
+}
+/** Execute one boot-free command. */
+async function run(argv) {
+	if (argv.length === 0 || argv[0] === "--help" || argv[0] === "-h") {
+		printHelp();
+		return 0;
+	}
+	const [rawAction, ...flags] = argv;
+	if (![
+		"doctor",
+		"logout",
+		"status"
+	].includes(rawAction)) {
+		process.stderr.write(`dsh-workbuddy-connect: expected doctor, logout, or status; got ${JSON.stringify(rawAction)}\n`);
+		return 1;
+	}
+	const action = rawAction;
+	const jsonOutput = flags.includes("--json");
+	if (flags.filter((flag) => flag !== "--json").length > 0 || jsonOutput && action === "logout") {
+		process.stderr.write(`dsh-workbuddy-connect: invalid options for ${action}: ${flags.join(" ")}\n`);
+		return 1;
+	}
+	try {
+		switch (action) {
+			case "doctor": return await doctor(jsonOutput);
+			case "status": return await status(jsonOutput);
+			case "logout":
+				await makeStore().logout();
+				process.stdout.write(`WorkBuddy Connect: removed ${workbuddyOwnAuthPath()}; the desktop app's sign-in is untouched\n`);
+				return 0;
+		}
+	} catch (error) {
+		process.stderr.write(`dsh-workbuddy-connect: ${action} failed: ${safeMessage(error)}\n`);
+		return 1;
+	}
+}
+if (process.argv[1] !== void 0 && fileURLToPath(import.meta.url) === realpathSync(process.argv[1])) process.exitCode = await run(process.argv.slice(2));
+//#endregion
+export { run };