dsh-tg-bridge 1.3.5 → 1.4.0

package/README.md

@@ -23,9 +23,28 @@ blocks.
 ## Requirements
 
 - Node.js ≥ 20
+- DeepSeek Harness `0.2.1-rc.2` or newer in the `0.2.x` line (`>=0.2.1-rc.2 <0.3.0`)
 - DeepSeek Harness installed (`~/.dsh/profiles/headless`)
 - A Telegram bot token from [@BotFather](https://t.me/BotFather)
 
+The supported harness range is declared twice: `engines.dsh` in `package.json`
+(what npm and the market read) and `dsh.compatibility.dsh` (what DSH itself
+reads before mounting the bundle). A future `0.3.0` needs an explicit bump:
+the bridge relies on the `0.2.x` CLI flags and profile layout.
+
+## Ecosystem
+
+The Chinese DSH community maintains the largest plugin catalogs and the
+in-app markets that read them; this bridge follows their packaging rules so it
+can be listed next to them:
+
+- [awesome-dsh-plugin](https://awesome-dsh-plugin.com) — bilingual (English /
+  中文) plugin list and the `dsh-plugin-catalog` npm package
+- [dsh-market](https://github.com/dsh-market/dsh-market) — the Chinese-built
+  in-app market with one-click install and themes
+- [dsh-find-plugin](https://github.com/awesome-dsh-plugin/dsh-find-plugin) —
+  finds a plugin from chat instead of browsing a catalog
+
 ## Languages
 
 - Menus (`/` in chat): three sets, `ru` by default, plus `en` and `zh`.
@@ -39,26 +58,26 @@ blocks.
 
 One command: your bot token and your numeric id. Nothing to edit by hand.
 
-**Windows (PowerShell)**
+**Any platform with Node.js ≥ 20**
 
-```powershell
+```bash
 npx dsh-tg-bridge@latest init --token 123456789:AA... --user 123456789
 npx dsh-tg-bridge@latest setup
 ```
 
-**macOS / Linux**
+`init` writes the token, your id and the working directory; `setup` registers
+autostart and starts the bridge.
+
+**As a DSH plugin** (the package carries a `dsh.bundle`; the catalog entry is
+pending review):
 
 ```bash
-DSH_TG_TOKEN=123456789:AA... DSH_TG_USER=123456789 \
-  bash -c "$(curl -fsSL https://raw.githubusercontent.com/aleksvega/dsh-tg-bridge/main/install.sh)"
+dsh plugin --profile desktop add dsh-tg-bridge
 ```
 
-**Windows, one line** (same thing, installs and starts):
-
-```powershell
-$env:DSH_TG_TOKEN='123456789:AA...'; $env:DSH_TG_USER='123456789'
-irm https://raw.githubusercontent.com/aleksvega/dsh-tg-bridge/main/install.ps1 | iex
-```
+The plugin starts one bridge when DSH boots and stops it on shutdown; if a
+bridge is already running (for example from the scheduled task), it leaves it
+alone. Run `npx dsh-tg-bridge@latest init ...` first so a config exists.
 
 What `init` does:
 
@@ -90,17 +109,17 @@ in Russian, English and Chinese at once. The full settings table, permissions, c
 common errors are in [docs/TELEGRAM-SETUP.md](docs/TELEGRAM-SETUP.md).
 
 **Autostart** is installed by the setup: `launchd` on macOS, `systemd --user` on
-Linux. On Windows `setup` registers the `DSH-TG-Bridge` task and a one-minute watchdog
-`DSH-Bridge-Kick` that brings the bridge back after a crash.
+Linux. On Windows `setup` registers the `DSH-TG-Bridge` task, which runs the
+guarded supervisor (the same launcher on logon and every five minutes) so a
+crashed bridge comes back without a second poller.
 
 **Manual install** (if you want full control):
 
 ```bash
-git clone https://github.com/aleksvega/dsh-tg-bridge.git ~/.dsh/tg-bridge
-cd ~/.dsh/tg-bridge
-node cli.mjs init --token 123456789:AA... --user 123456789
-node cli.mjs check     # report only, changes nothing
-node cli.mjs setup     # stop the old bridge and start the new one
+npm install -g dsh-tg-bridge
+dsh-tg init --token 123456789:AA... --user 123456789
+dsh-tg check     # report only, changes nothing
+dsh-tg setup     # stop the old bridge and start the new one
 ```
 
 If the bridge is already installed, `setup` restarts it on the new code and reinstalls

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# DSH bundle: load the Telegram bridge with the harness. The plugin starts one
+# bridge process (skipped when a bridge is already running) and stops it on
+# shutdown. Install with: dsh plugin --profile desktop add dsh-tg-bridge
+- insert:
+    - id: tg-bridge
+      name: dsh-tg-bridge

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "dsh-tg-bridge",
-  "version": "1.3.5",
+  "version": "1.4.0",
   "description": "Telegram bridge for DeepSeek Harness: text, voice, photos and project-per-topic sessions without opening the desktop app",
   "type": "module",
-  "main": "bridge.mjs",
+  "main": "plugin-bridge.mjs",
   "bin": {
     "dsh-tg": "./cli.mjs"
   },
@@ -16,7 +16,25 @@
     "test": "node --test"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=20",
+    "dsh": ">=0.2.1-rc.2 <0.3.0"
+  },
+  "dsh": {
+    "manifestVersion": 1,
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "compatibility": {
+      "dsh": ">=0.2.1-rc.2 <0.3.0",
+      "profiles": [
+        "desktop",
+        "web"
+      ]
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aleksvega/dsh-tg-bridge.git"
   },
   "keywords": [
     "deepseek-harness",
@@ -31,6 +49,8 @@
   "dependencies": {},
   "files": [
     "bridge.mjs",
+    "plugin-bridge.mjs",
+    "cordis.patch.yml",
     "control.mjs",
     "i18n.mjs",
     "prices.mjs",

package/plugin-bridge.mjs

@@ -0,0 +1,83 @@
+// DSH plugin entry: run the Telegram bridge alongside the harness.
+//
+// The bridge is a separate long-polling process, not a tool inside the agent,
+// so the plugin starts it once when the host boots and stops it on shutdown.
+// It never starts a second copy: a live `bridge.pid` wins. That keeps the
+// scheduled-task install and this plugin from polling the same bot twice.
+import { spawn } from 'node:child_process';
+import { closeSync, existsSync, openSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+export const name = 'tg-bridge';
+export const inject = [];
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const DSH_HOME = process.env.DSH_HOME || join(homedir(), '.dsh');
+const DIR = join(DSH_HOME, 'tg-bridge');
+
+function alive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    return error.code === 'EPERM';
+  }
+}
+
+function runningPid() {
+  try {
+    const pid = Number(readFileSync(join(DIR, 'bridge.pid'), 'utf8').trim());
+    return pid > 0 && alive(pid) ? pid : 0;
+  } catch {
+    return 0;
+  }
+}
+
+export function apply(ctx, config = {}) {
+  if (config.autoStart === false) return;
+  // Nothing to start until `dsh-tg init` wrote a token and a working directory.
+  if (!existsSync(join(DIR, 'config.json'))) return;
+  if (runningPid()) return;
+
+  // Two profiles loading at once must not both start a poller.
+  const lock = join(DIR, 'plugin-start.lock');
+  try {
+    const fd = openSync(lock, 'wx');
+    writeFileSync(fd, String(process.pid));
+    closeSync(fd);
+  } catch {
+    return;
+  }
+
+  let child = null;
+  try {
+    child = spawn(process.execPath, [join(HERE, 'bridge.mjs')], {
+      cwd: DIR,
+      detached: true,
+      stdio: 'ignore',
+      windowsHide: true,
+      env: {
+        ...process.env,
+        // Inside DSH desktop, process.execPath is Electron; this makes it run
+        // as Node without opening a window.
+        ...(process.versions.electron ? { ELECTRON_RUN_AS_NODE: '1' } : {}),
+      },
+    });
+    child.unref();
+  } catch {
+    child = null;
+  } finally {
+    try {
+      unlinkSync(lock);
+    } catch {}
+  }
+
+  if (!child?.pid || typeof ctx.on !== 'function') return;
+  ctx.on('dispose', () => {
+    try {
+      if (alive(child.pid)) process.kill(child.pid);
+    } catch {}
+  });
+}