@goodandready/dsh-lanmode 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-voice contributors
+
+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.md

@@ -0,0 +1,78 @@
+# dsh-lanmode
+
+**Settings over the LAN** for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh).
+
+Open the Web UI at `http://192.168.1.50:3080` instead of `http://localhost:3080` and every settings card in the deployment goes blank — your plugins' cards, and **Settings → Plugins → Plugin configuration** with them. No error appears, the plugins load fine, and reloading does not help. Saving silently does nothing.
+
+This plugin fixes that. Install it, reload the page, and the settings work from any address.
+
+## Why it happens
+
+The decision is made in the browser, from the page's hostname:
+
+```js
+isLoopback: pageLocation === undefined || isLoopbackHostname(pageLocation.hostname)
+```
+
+`isLoopbackHostname` accepts `localhost`, `[::1]` and `127.0.0.0/8` — nothing else. A page served at a LAN address is therefore "remote", and the settings service switches to a process-local mode where the shared mirror of the settings document is never read at all:
+
+```js
+ensure() { if (this.persistence === "memory") return Promise.resolve() }
+status: persistence === "host" ? "loading" : "unavailable"
+enqueue() { if (this.persistence === "memory") return Promise.resolve() }
+```
+
+Every bound namespace reports `status: "unavailable"` for the life of the page, and writes are dropped before they reach the wire.
+
+**The server does not share this restriction.** Both `settings.describe` and `settings.mutate` answer normally over the network as long as the request's `Origin` matches the page it came from — which is exactly the case for requests the UI itself makes. Verified against a live harness behind a reverse proxy.
+
+## What the plugin does
+
+On a loopback page: nothing at all — the core works there, and a second implementation would only be a second source of truth.
+
+On any other page it stands up its own copy of the same machinery over the same two calls, and publishes it:
+
+- as a service named `lanSettings`, for plugins that want to ask for it explicitly;
+- and, if the runtime allows a plugin to claim the name, in place of `settingsScope` — which repairs every settings surface at once, including the core's plugin configuration tab and plugins that know nothing about this one.
+
+The snapshot it hands out has the same shape the core's has — `status`, `value`, `base`, `user`, `revision`, `writable` — so cards cannot tell the difference.
+
+## Install
+
+```bash
+dsh plugin --profile web add @goodandready/dsh-lanmode
+```
+
+Restart the Web UI afterwards, then reload the browser.
+
+## Checking it on a machine where it is not needed
+
+The plugin stands aside on a loopback page, which makes it awkward to try out
+on the machine that runs the harness. A debug switch turns it on there anyway:
+
+```js
+localStorage.setItem('dsh-lanmode:force', '1'); location.reload()
+```
+
+Remove the key to go back to normal. This is only for looking at the plugin
+itself; nothing in day-to-day use needs it.
+
+## What it is not
+
+Not authentication. The plugin does not add a password and does not widen what the server accepts — the harness answers those same calls with or without it. If your harness is reachable by other people, put a real gate in front of it (HTTP auth in your reverse proxy, or a VPN); a plugin cannot do that job, because the web server service hands plugins their own routes and no way to intercept anyone else's.
+
+## Structure
+
+```
+dsh-lanmode/
+├── package.json            # dsh bundle/plugin metadata
+├── cordis.patch.yml        # bundle layer: inserts the plugin row
+├── lib/index.js            # host: nothing but a log line — the work is in the browser
+├── lib/client.js           # browser: the settings mirror and namespace scopes
+├── README.md
+└── LICENSE                 # MIT
+```
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,11 @@
+# dsh-lanmode bundle layer: applied automatically when the package is installed
+# as a profile bundle (package.json declares dsh.bundle.patch).
+#
+# `name` must stay the full npm package name: the client-modules registry
+# resolves the browser bundle by the loader entry name, so a shortened name
+# leaves the UI half silently out of window.__DSH_BOOT__ — and the UI half is
+# the whole plugin here.
+- insert:
+    - id: dsh-lanmode
+      name: '@goodandready/dsh-lanmode'
+      config: {}

package/lib/client.js

@@ -0,0 +1,253 @@
+// dsh-lanmode — клиентская половина.
+//
+// Зачем это существует.
+//
+// Веб-интерфейс харнесса отключает настройки на любой странице, открытой не с
+// localhost. Решение принимается в браузере по имени хоста:
+//
+//   isLoopback: pageLocation === undefined || isLoopbackHostname(pageLocation.hostname)
+//
+// и дальше сервис настроек уходит в режим «памяти»: общее зеркало документа
+// никогда не читается, каждый связанный раздел сразу получает статус
+// "unavailable", а запись молча выбрасывается. Внешне это выглядит как пустые
+// карточки настроек у всех плагинов сразу и пустая вкладка «Настройки
+// плагинов» — при полностью исправном сервере.
+//
+// Сервер этого ограничения не разделяет: и чтение (settings.describe), и
+// запись (settings.mutate) по сети работают штатно, если Origin совпадает с
+// адресом страницы — то есть ровно в том случае, когда запрос шлёт сам
+// интерфейс. Проверено на живом харнессе через обратный прокси.
+//
+// Поэтому плагин делает одно: на не-loopback странице поднимает собственный
+// экземпляр той же механики поверх тех же вызовов и отдаёт его как службу.
+// На loopback-странице он не делает ничего — там ядро справляется само.
+
+window.__ModuleLoader__.load({
+  id: '@goodandready/dsh-lanmode',
+  factory: (require) => {
+    var module = { exports: {} }
+    var exports = module.exports
+
+    // ------------------------------------------------- зеркало документа
+    //
+    // Один читатель settings.describe на всю страницу: разделы выводятся из
+    // него, поэтому они не могут разойтись во мнении о документе.
+    function createMirror(api) {
+      let snapshot = { status: 'idle', view: undefined, error: null }
+      const listeners = new Set()
+      let inFlight
+      let rerun = false
+
+      const notify = () => {
+        for (const listener of [...listeners]) {
+          try { listener() } catch (listenerFailure) { /* чужой слушатель нам не судья */ }
+        }
+      }
+      const put = (next) => { snapshot = next; notify() }
+
+      async function run() {
+        do {
+          rerun = false
+          let outcome
+          try {
+            const response = await api.settings.describe({})
+            outcome = response.result.ok
+              ? { view: response.result.value }
+              : { failure: response.result.error.message }
+          } catch (wireFailure) {
+            outcome = { failure: String(wireFailure && wireFailure.message || wireFailure) }
+          }
+          if (outcome.view !== undefined) {
+            put({ status: 'ready', view: outcome.view, error: null })
+          } else {
+            // Держим то, что уже прочитали: неудачное обновление не должно
+            // опустошать готовые разделы.
+            put({ status: snapshot.view === undefined ? 'idle' : 'ready', view: snapshot.view, error: outcome.failure })
+          }
+        } while (rerun)
+      }
+
+      return {
+        getSnapshot: () => snapshot,
+        subscribe: (listener) => {
+          listeners.add(listener)
+          return () => { listeners.delete(listener) }
+        },
+        load() {
+          if (inFlight !== undefined) { rerun = true; return inFlight }
+          inFlight = run().finally(() => { inFlight = undefined })
+          return inFlight
+        },
+        ensure() {
+          if (inFlight !== undefined) return inFlight
+          if (snapshot.status === 'idle') return this.load()
+          return Promise.resolve()
+        },
+        // Ответ на запись возвращает свежий вид одного раздела — вкладываем его
+        // на место, чтобы не перечитывать весь документ ради одного поля.
+        acceptView(view) {
+          const before = snapshot
+          if (before.view === undefined) { this.load(); return }
+          const known = before.view.namespaces.some((row) => row.ns === view.ns)
+          const namespaces = known
+            ? before.view.namespaces.map((row) => (row.ns === view.ns ? view : row))
+            : before.view.namespaces.concat([view])
+          put({ ...before, view: { ...before.view, namespaces } })
+        },
+      }
+    }
+
+    // ------------------------------------------------------- раздел настроек
+    //
+    // Снимок повторяет форму ядрового: status, value, base, user, revision,
+    // writable. Карточки читают именно эти поля, поэтому подмена для них
+    // незаметна.
+    function createScope(api, mirror, namespace) {
+      let snapshot = {
+        status: 'loading',
+        value: undefined,
+        base: undefined,
+        user: undefined,
+        revision: undefined,
+        writable: false,
+        mode: 'host',
+      }
+      const listeners = new Set()
+      const notify = () => {
+        for (const listener of [...listeners]) {
+          try { listener() } catch (listenerFailure) { /* см. выше */ }
+        }
+      }
+
+      function derive() {
+        const held = mirror.getSnapshot()
+        if (held.view === undefined) return
+        const row = held.view.namespaces.find((candidate) => candidate.ns === namespace)
+        if (row === undefined) {
+          // Хост про такой раздел не знает. Это законное состояние: плагин
+          // может быть ещё не применён.
+          snapshot = { ...snapshot, status: 'unavailable', writable: held.view.writable }
+          notify()
+          return
+        }
+        snapshot = {
+          status: 'ready',
+          value: row.value,
+          base: row.base,
+          user: row.user,
+          revision: row.revision,
+          writable: held.view.writable,
+          mode: 'host',
+        }
+        notify()
+      }
+
+      const off = mirror.subscribe(derive)
+      derive()
+
+      // Записи выстраиваем в очередь: правка ревизии, пришедшая из ответа,
+      // должна попасть в следующий запрос, иначе хост отвергнет его как
+      // устаревший.
+      let tail = Promise.resolve()
+      function write(op) {
+        const task = tail.then(async () => {
+          const revision = snapshot.revision
+          let response
+          try {
+            response = await api.settings.mutate({
+              ns: namespace,
+              ops: [op],
+              ...(revision === undefined ? {} : { expectedRevision: revision }),
+            })
+          } catch (wireFailure) {
+            await mirror.load()
+            throw wireFailure
+          }
+          if (!response.result.ok) {
+            // Чаще всего это разошедшаяся ревизия: перечитываем и отдаём
+            // ошибку наверх, чтобы карточка показала неудачу сохранения.
+            await mirror.load()
+            throw new Error(response.result.error.message)
+          }
+          mirror.acceptView(response.result.value)
+        })
+        tail = task.catch(() => {})
+        return task
+      }
+
+      return {
+        getSnapshot: () => snapshot,
+        subscribe: (listener) => {
+          listeners.add(listener)
+          return () => { listeners.delete(listener) }
+        },
+        set: (field, value) => write({ op: 'set', path: [field], value }),
+        unset: (field) => write({ op: 'unset', path: [field] }),
+        dispose: () => { off() },
+      }
+    }
+
+    exports.inject = ['connection']
+
+    // Отладочный переключатель: включает режим и на loopback-странице, где
+    // ядро и без нас справляется. Нужен, чтобы проверить сам плагин там, где
+    // это удобно сделать:
+    //
+    //   localStorage.setItem('dsh-lanmode:force', '1'); location.reload()
+    //
+    // В обычной работе не нужен и по умолчанию выключен.
+    function forcedOn() {
+      try { return window.localStorage.getItem('dsh-lanmode:force') === '1' }
+      catch (noStorage) { return false }
+    }
+
+    exports.apply = function apply(ctx) {
+      const connection = ctx.get('connection')
+
+      // На loopback-странице ядро работает штатно, и вмешиваться незачем.
+      if (connection.isLoopback && !forcedOn()) return
+
+      const mirror = createMirror(connection.api)
+      const binder = {
+        bind: (spec) => createScope(connection.api, mirror, spec && spec.namespace),
+        describe: () => mirror,
+      }
+
+      // Документ меняют не только из этой вкладки; ядро слушает тот же сигнал.
+      try {
+        const remote = ctx.get('remote')
+        if (remote && typeof remote.$on === 'function') {
+          ctx.effect(() => remote.$on('settings/document-updated', () => { mirror.load() }),
+            'dsh-lanmode: перечитывать документ настроек по сигналу хоста')
+        }
+      } catch (noRemoteService) { /* без сигнала обойдёмся, останется ручное перечитывание */ }
+
+      mirror.ensure()
+
+      // Своя служба: ею может пользоваться любой плагин, которому нужны
+      // настройки по сети.
+      ctx.provide('lanSettings', binder)
+
+      // Попытка встать на место ядровой службы. Если разрешено — оживает весь
+      // интерфейс настроек разом, включая чужие плагины и вкладку ядра.
+      // Если ядро не отдаёт имя, остаёмся со своей службой: наши плагины
+      // умеют её спрашивать.
+      let tookOver = false
+      try {
+        ctx.provide('settingsScope', binder)
+        tookOver = true
+      } catch (nameTaken) {
+        tookOver = false
+      }
+
+      // Одна строка в консоли: без неё непонятно, работает режим или нет.
+      try {
+        console.info('[dsh-lanmode] режим включён (' + location.hostname + (connection.isLoopback ? ', принудительно' : '') + '); '
+          + 'настройки подняты через сеть, ядровая служба '
+          + (tookOver ? 'подменена' : 'оставлена как есть'))
+      } catch (noConsole) { /* незачем */ }
+    }
+
+    return module.exports
+  },
+})

package/lib/index.js

@@ -0,0 +1,20 @@
+// dsh-lanmode — хост-половина.
+//
+// Работа плагина целиком в браузере: ограничение, которое он снимает, живёт
+// в клиентском коде харнесса, а сервер и без него отдаёт настройки по сети.
+// Хост-половина существует потому, что запись в дереве плагинов — это модуль
+// на хосте; она ничего не регистрирует и ничего не слушает.
+//
+// Единственное, что здесь есть, — строчка в журнале при запуске, чтобы по
+// логу было видно, что плагин установлен.
+
+export const name = 'dsh-lanmode'
+export const inject = []
+
+export function apply(ctx) {
+  ctx.effect(() => {
+    // eslint-disable-next-line no-console
+    console.info('[dsh-lanmode] установлен: настройки будут работать и на страницах, открытых не с localhost')
+    return () => {}
+  }, 'dsh-lanmode: отметка о запуске')
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@goodandready/dsh-lanmode",
+  "version": "0.1.0",
+  "description": "Settings over the LAN for DeepSeek Harness: the Web UI turns the settings service off on any page that is not localhost, even though the server serves settings over the network just fine. This plugin brings them back.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json",
+    "./cordis.patch.yml": "./cordis.patch.yml"
+  },
+  "files": [
+    "lib/",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "settings",
+    "lan",
+    "remote"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GooDAnDReaDY/dsh-lanmode.git"
+  },
+  "homepage": "https://github.com/GooDAnDReaDY/dsh-lanmode",
+  "bugs": {
+    "url": "https://github.com/GooDAnDReaDY/dsh-lanmode/issues"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1"
+  }
+}