dsh-telegram-connector 0.14.1 → 0.15.1

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.15.1
+
+- Release-check fix: the `0.15.0` tag was cut without its COMPATIBILITY row and
+  was never published; this is the published release of the configuration page
+  described below.
+
+## 0.15.0
+
+- **The connector has a configuration page.** On DSH `0.2.1-rc.5` or newer, the
+  Plugins page shows **Configure** on the `dsh-telegram-connector` row: bot
+  token, allowed user ids and admin user id, saved through the page's own form.
+  No `.env` edit or restart is needed; the connector recomposes and starts.
+- **Standalone is a first-class mode.** The setup is optional: the connector
+  does not assume the setup supervisor or updater. The setup-specific commands
+  report the missing sidecar instead of failing; workspaces, sessions, topics,
+  plugins and model calls work on any DSH runtime.
+- The browser half is plain JavaScript in the client-module format, copied to
+  `lib/client.js` by the build; the host half is unchanged.
+
 ## 0.14.1
 
 - **Component actions no longer restart the runtime.** The setup's

package/COMPATIBILITY.md

@@ -6,6 +6,7 @@ every release.
 
 | Connector | DSH | Status | Notes |
 |---|---|---|---|
+| 0.15.1 | `0.2.1-rc.5` | needs UAT | config page (Plugins → Configure) for bot token, allowed ids and admin id; standalone without the setup updater |
 | 0.14.1 | `0.2.1-rc.5` | needs UAT | component actions no longer restart the runtime; the tools load on the next start |
 | 0.14.0 | `0.2.1-rc.5` | needs UAT | one command surface: `/menu` card, `/plugins` subcommands, `/components`; aliases and `/man` removed |
 | 0.13.1 | `0.2.1-rc.5` | needs UAT | `/system status` probes the advertised web address, so a LAN-only bind no longer reports loopback as unreachable |

package/README.md

@@ -141,11 +141,11 @@ Telegram:
 ```sh
 git clone https://github.com/vladtsvirko/dsh-tg-docker-setup
 cd dsh-tg-docker-setup
-./install.sh            # asks for mode, port, bind address, provider, key,
+./setup.sh              # asks for port, bind address, provider, key,
                         # bot token, allowed ids, admin id, git author
 ```
 
-`./install.sh --check` prints the whole plan and changes nothing. The setup
+`./setup.sh --check` prints the whole plan and changes nothing. The setup
 pins a recommended connector tag in its `plugins.json`; the connector is
 versioned on its own and can move to a newer compatible version from the bot without
 a setup release. See [`docs/STANDALONE.md`](docs/STANDALONE.md) for the same
@@ -154,8 +154,7 @@ install without the setup.
 The connector is published to npm as an exact version:
 
 ```sh
-dsh plugin --profile web add dsh-telegram-connector@0.13.1
-export DSH_TELEGRAM_BOT_TOKEN='123456:ABC…'
+dsh plugin --profile web add dsh-telegram-connector@0.15.1
 ```
 
 The registry tarball already contains the built `lib/`, so there is no
@@ -163,6 +162,21 @@ The registry tarball already contains the built `lib/`, so there is no
 the plugin. The setup's `plugins.json` uses the same spec and keeps the GitHub
 tag as a fallback when the registry is unreachable.
 
+### Configure in the UI
+
+On DSH `0.2.1-rc.5` or newer, open **Plugins** → **dsh-telegram-connector** and
+press **Configure** on the `dsh-telegram-connector` row. The page has three
+fields — **bot token**, **allowed user ids** and **admin user id** — and
+**Save** writes the row's config into the profile's user layer. No `.env` edit
+or restart is needed; the connector recomposes and starts polling.
+
+That is the standalone path: the setup is not required, and the connector does
+not assume the setup's supervisor or updater. Commands that need them
+(`/system update setup`, `/components`, `/firewall allow`, restart/rollback)
+report that the sidecar is unavailable instead of failing. Everything else —
+workspaces, sessions, topics, plugins and model calls — works on any DSH
+runtime.
+
 Installing from the source repository is still possible:
 
 ```sh
@@ -170,7 +184,7 @@ cat >> "$DSH_HOME/profiles/web/pnpm-workspace.yaml" <<'YAML'
 allowBuilds:
   dsh-telegram-connector@https://github.com/vladtsvirko/dsh-telegram-connector.git: true
 YAML
-dsh plugin --profile web add github:vladtsvirko/dsh-telegram-connector#v0.13.1
+dsh plugin --profile web add github:vladtsvirko/dsh-telegram-connector#v0.15.1
 ```
 
 That path runs the package's `prepare` build; pnpm ≥ 10 refuses it until the
@@ -180,6 +194,9 @@ The package is a plugin bundle: `cordis.patch.yml` mounts one row.
 
 ## Configuration
 
+The row config from the UI is the first source. The environment is the
+fallback (the setup writes it; a standalone profile can export it instead):
+
 Environment:
 
 | Variable | Meaning |

package/lib/client.js

@@ -0,0 +1,176 @@
+/**
+ * Browser half: the configuration page for the `dsh-telegram-connector` row.
+ *
+ * DSH's Plugins page declares the `plugins.row.config` slot; this module
+ * registers the row's page with the three answers a fresh standalone install
+ * needs. The host half already reads the same keys from its Config schema; the
+ * patch keeps the environment as the fallback, and a value saved here is the
+ * profile's user layer, which wins over it.
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-telegram-connector',
+  factory: (require) => {
+    var module = { exports: {} }
+    var exports = module.exports
+    Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
+
+    const React = require('react')
+    const h = React.createElement
+
+    const KEY = 'dsh-telegram-connector#dsh-telegram-connector'
+    const inputStyle = {
+      boxSizing: 'border-box',
+      width: '100%',
+      padding: '6px 8px',
+      borderRadius: 6,
+      border: '1px solid var(--dsh-border, #d0d5dd)',
+      background: 'var(--dsh-surface, #fff)',
+      color: 'inherit',
+      font: 'inherit',
+    }
+
+    function field(label, hint, input) {
+      return h(
+        'label',
+        { style: { display: 'flex', flexDirection: 'column', gap: 4, marginBottom: 14 } },
+        h('span', { style: { fontWeight: 600 } }, label),
+        hint === undefined ? null : h('span', { style: { opacity: 0.7, fontSize: 12 } }, hint),
+        input,
+      )
+    }
+
+    function parseIds(text) {
+      return text
+        .split(/[\s,]+/)
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0)
+        .map((part) => Number(part))
+        .filter((id) => Number.isFinite(id) && id > 0)
+    }
+
+    function TelegramConfigForm({ form }) {
+      if (form === undefined) {
+        return h('p', null, 'This plugin does not expose its configuration in this build.')
+      }
+      const state = form.state
+      if (state.status === 'unavailable') {
+        return h('p', null, 'This plugin is not loaded, so it cannot be configured right now.')
+      }
+      if (state.status === 'loading') {
+        return h('p', null, 'Loading the current values…')
+      }
+      const value = state.value ?? {}
+      const [botToken, setBotToken] = React.useState(String(value.botToken ?? ''))
+      const [allowed, setAllowed] = React.useState(Array.isArray(value.allowedUserIds) ? value.allowedUserIds.join(', ') : '')
+      const [admin, setAdmin] = React.useState(value.adminUserId === undefined ? '' : String(value.adminUserId))
+      const [saving, setSaving] = React.useState(false)
+      const [message, setMessage] = React.useState('')
+
+      React.useEffect(() => {
+        const next = state.value ?? {}
+        setBotToken(String(next.botToken ?? ''))
+        setAllowed(Array.isArray(next.allowedUserIds) ? next.allowedUserIds.join(', ') : '')
+        setAdmin(next.adminUserId === undefined ? '' : String(next.adminUserId))
+      }, [state.revision])
+
+      const disabled = !state.writable || saving
+      const save = async () => {
+        const ids = parseIds(allowed)
+        const adminId = admin.trim().length === 0 ? undefined : Number(admin.trim())
+        if (adminId !== undefined && (!Number.isFinite(adminId) || adminId <= 0)) {
+          setMessage('The admin user id must be a number, or empty to use the first allowed id.')
+          return
+        }
+        setSaving(true)
+        setMessage('')
+        try {
+          const ops = [
+            { op: 'set', path: ['botToken'], value: botToken.trim() },
+            { op: 'set', path: ['allowedUserIds'], value: ids },
+            adminId === undefined
+              ? { op: 'unset', path: ['adminUserId'] }
+              : { op: 'set', path: ['adminUserId'], value: adminId },
+          ]
+          const ok = await form.mutate(ops, state.revision)
+          setMessage(ok ? 'Saved. The connector reconnects with these values.' : 'The deployment did not accept these values; they were left for you to correct.')
+        } catch (error) {
+          setMessage(`Save failed: ${String(error)}`)
+        } finally {
+          setSaving(false)
+        }
+      }
+
+      return h(
+        'div',
+        null,
+        h('p', null, 'Connect the bot to Telegram. The token comes from @BotFather; user ids are numeric and come from @userinfobot.'),
+        field(
+          'Bot token',
+          'For example 123456789:AA… . Keep it out of screenshots and commits.',
+          h('input', {
+            type: 'password',
+            value: botToken,
+            disabled,
+            placeholder: 'the token from @BotFather',
+            style: inputStyle,
+            onChange: (event) => setBotToken(event.target.value),
+          }),
+        ),
+        field(
+          'Allowed user ids',
+          'Comma- or space-separated numeric ids. Everyone in this list can talk to the agent and use the sessions.',
+          h('input', {
+            type: 'text',
+            value: allowed,
+            disabled,
+            placeholder: '142283532, 777000111',
+            style: inputStyle,
+            onChange: (event) => setAllowed(event.target.value),
+          }),
+        ),
+        field(
+          'Admin user id',
+          'Optional. One allowed id that may update, restart, roll back and manage plugins; empty uses the first allowed id.',
+          h('input', {
+            type: 'text',
+            value: admin,
+            disabled,
+            placeholder: 'optional',
+            style: inputStyle,
+            onChange: (event) => setAdmin(event.target.value),
+          }),
+        ),
+        h(
+          'div',
+          { style: { display: 'flex', alignItems: 'center', gap: 10 } },
+          h(
+            'button',
+            {
+              type: 'button',
+              disabled,
+              onClick: save,
+              style: { padding: '6px 14px', borderRadius: 6, cursor: disabled ? 'default' : 'pointer' },
+            },
+            saving ? 'Saving…' : 'Save',
+          ),
+          message.length === 0 ? null : h('span', { style: { fontSize: 13 } }, message),
+        ),
+      )
+    }
+
+    const inject = ['slots']
+    function apply(ctx) {
+      ctx.slots.inject('plugins.row.config', () =>
+        ctx.slots.register(
+          { name: 'plugins.row.config', key: KEY },
+          ({ view, form }) => (view === 'summary' ? null : h(TelegramConfigForm, { form })),
+        ),
+      )
+    }
+
+    exports.NS = 'dsh-telegram-connector'
+    exports.apply = apply
+    exports.inject = inject
+    return module.exports
+  },
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-telegram-connector",
-  "version": "0.14.1",
+  "version": "0.15.1",
   "description": "Telegram control plane for DeepSeek Harness \u2014 one group per workspace, one forum topic per session.",
   "type": "module",
   "main": "lib/index.js",
@@ -26,7 +26,7 @@
     "node": ">=22"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "tsc -p tsconfig.json && node scripts/copy-client.mjs",
     "prepare": "npm run build",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "test": "vitest run",
@@ -37,6 +37,12 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-slots"
+      ],
+      "platform": "web"
     }
   },
   "peerDependencies": {
@@ -67,5 +73,13 @@
   ],
   "publishConfig": {
     "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
   }
 }