@goodandready/dsh-lanmode 0.1.0 → 0.2.0

package/README.md

@@ -28,34 +28,18 @@ Every bound namespace reports `status: "unavailable"` for the life of the page,
 
 ## 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.
+It injects one script into the served `index.html`, through the web server's official index tap, ahead of the boot manifest. The script intercepts module registration and hands the two settings packages a connection whose `isLoopback` reads `true`. Everything downstream — the shared mirror of the settings document, every namespace scope, the core's own settings pages — then behaves exactly as it does on localhost.
 
-On any other page it stands up its own copy of the same machinery over the same two calls, and publishes it:
+The substitution is narrow on purpose. Three packages read that flag, and the third is deliverables, where it decides whether a produced file may be opened locally: forcing it there would ask the Host to open paths on the server's desktop. Only the settings packages see the substitute; the rest of the UI keeps the truth.
 
-- 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.
+Taking the core settings service over instead is not possible — cordis refuses a second provider for a registered name, and refuses assignment across fibers.
 
-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.
+## Checking it
 
-## Install
+- `?lanmode=invert` — report the flag as `false` even on a loopback page. The harness then fails exactly the way it does over the LAN, which is how this plugin is verified.
+- `?lanmode=off` — stand the plugin down entirely.
 
-```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.
+On a loopback page the plugin substitutes `true` where the real value is already `true`, so it cannot change behaviour there.
 
 ## What it is not
 

package/lib/index.js

@@ -1,20 +1,52 @@
 // dsh-lanmode — хост-половина.
 //
-// Работа плагина целиком в браузере: ограничение, которое он снимает, живёт
-// в клиентском коде харнесса, а сервер и без него отдаёт настройки по сети.
-// Хост-половина существует потому, что запись в дереве плагинов — это модуль
-// на хосте; она ничего не регистрирует и ничего не слушает.
+// Задача плагина: вернуть настройки на страницах, открытых не с localhost.
 //
-// Единственное, что здесь есть, — строчка в журнале при запуске, чтобы по
-// логу было видно, что плагин установлен.
+// Веб-интерфейс решает это в браузере, по имени хоста страницы:
+//
+//   isLoopback: pageLocation === undefined || isLoopbackHostname(hostname)
+//
+// где своими считаются только localhost, [::1] и 127.0.0.0/8. Дальше сервис
+// настроек уходит в режим «памяти»: общий вид документа не читается никогда,
+// каждый раздел получает статус "unavailable", запись выбрасывается до
+// отправки. Внешне — пустые карточки всех плагинов, пустая вкладка «Настройки
+// плагинов» и страница «Модели» с надписью
+// "settings are unavailable in this browser".
+//
+// Сервер это ограничение не разделяет: settings.describe и settings.mutate по
+// сети отвечают штатно, когда Origin совпадает с адресом страницы, — то есть
+// ровно в том случае, когда запрос шлёт сам интерфейс.
+//
+// Поэтому плагин вставляет в index.html короткий скрипт (через официальную
+// точку webServer.tapIndex) и подменяет флаг ТОЧЕЧНО — только для двух
+// настроечных пакетов ядра. Флаг читают трое, и третьему подменять нельзя:
+// в результатах работы isLoopback решает, можно ли открыть файл локально, и
+// с подменой браузер просил бы открыть путь на машине сервера.
+
+import { readFileSync } from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
 
 export const name = 'dsh-lanmode'
-export const inject = []
+export const inject = ['webServer']
+
+const here = path.dirname(fileURLToPath(import.meta.url))
+
+/** Скрипт-заплатка читается с диска: так его видно и правится он как код. */
+function shimSource() {
+  return readFileSync(path.join(here, 'shim.js'), 'utf8')
+}
 
 export function apply(ctx) {
-  ctx.effect(() => {
-    // eslint-disable-next-line no-console
-    console.info('[dsh-lanmode] установлен: настройки будут работать и на страницах, открытых не с localhost')
-    return () => {}
-  }, 'dsh-lanmode: отметка о запуске')
+  const script = '<script data-dsh-lanmode="1">' + shimSource() + '</script>'
+
+  ctx.effect(() => ctx.webServer.tapIndex((html) => {
+    if (html.includes('data-dsh-lanmode')) return html
+    // Сразу за <head>: к моменту, когда страница начнёт грузить бандлы,
+    // перехватчик уже стоит. Загрузчик к этому моменту может ещё не
+    // существовать — заплатка это учитывает.
+    const at = html.indexOf('<head>')
+    if (at === -1) return script + html
+    return html.slice(0, at + '<head>'.length) + script + html.slice(at + '<head>'.length)
+  }), 'dsh-lanmode: вставка заплатки в index.html')
 }

package/lib/shim.js

@@ -0,0 +1,123 @@
+(function () {
+  // Заплатка выполняется в самом начале страницы, до загрузки бандлов ядра.
+  //
+  // Она перехватывает регистрацию двух настроечных пакетов и подсовывает им
+  // связь, у которой isLoopback всегда true. Остальные пакеты видят правду:
+  // в результатах работы этот же флаг решает, открывать ли файл локально, и
+  // подменять его там нельзя.
+  var TARGETS = [
+    '@deepseek-ai/dsh-client-ui-settings',
+    '@deepseek-ai/dsh-client-ui-settings-general',
+  ]
+
+  // Отладочные переключатели через адресную строку:
+  //   ?lanmode=off — не вмешиваться (проверить, как было без плагина);
+  //   ?lanmode=invert — притвориться чужим на своей же странице
+  //                     (так проверяется, что заплатка вообще управляет флагом).
+  var mode = ''
+  try { mode = new URLSearchParams(location.search).get('lanmode') || '' } catch (noSearch) { mode = '' }
+  if (mode === 'off') return
+  var forced = mode === 'invert' ? false : true
+
+  function connectionWithForcedFlag(connection) {
+    if (!connection || typeof connection !== 'object') return connection
+    return new Proxy(connection, {
+      get: function (target, prop, receiver) {
+        if (prop === 'isLoopback') return forced
+        var value = Reflect.get(target, prop, target)
+        return typeof value === 'function' ? value.bind(target) : value
+      },
+    })
+  }
+
+  function ctxWithForcedConnection(ctx) {
+    return new Proxy(ctx, {
+      get: function (target, prop, receiver) {
+        if (prop === 'get') {
+          return function (nameRequested) {
+            var value = target.get(nameRequested)
+            return nameRequested === 'connection' ? connectionWithForcedFlag(value) : value
+          }
+        }
+        if (prop === 'connection') return connectionWithForcedFlag(Reflect.get(target, prop, target))
+        var value = Reflect.get(target, prop, target)
+        return typeof value === 'function' ? value.bind(target) : value
+      },
+    })
+  }
+
+  function wrap(registration) {
+    if (!registration || TARGETS.indexOf(registration.id) === -1) return registration
+    if (typeof registration.factory !== 'function') return registration
+    var factory = registration.factory
+    var patched = {}
+    for (var key in registration) patched[key] = registration[key]
+    patched.factory = function (requireFn) {
+      var moduleExports = factory(requireFn)
+      if (!moduleExports || typeof moduleExports.apply !== 'function') return moduleExports
+      var originalApply = moduleExports.apply
+      moduleExports.apply = function (ctx) {
+        return originalApply.call(this, ctxWithForcedConnection(ctx))
+      }
+      return moduleExports
+    }
+    return patched
+  }
+
+  // Загрузчик подменяет собственный load, когда переходит из режима очереди
+  // в рабочий, — обёртка при этом слетала бы. Поэтому ставим её через
+  // свойство-аксессор: любая новая функция оборачивается снова.
+  function install(loader) {
+    if (!loader || typeof loader !== 'object') return loader
+    var wrapped
+
+    function rewrap(fn) {
+      if (typeof fn !== 'function' || fn.__dshLanmode) { wrapped = fn; return }
+      var inner = fn
+      wrapped = function (registration) { return inner.call(this, wrap(registration)) }
+      wrapped.__dshLanmode = true
+    }
+
+    if (loader.load && loader.load.__dshLanmode) return loader
+    rewrap(loader.load)
+    try {
+      Object.defineProperty(loader, 'load', {
+        configurable: true,
+        get: function () { return wrapped },
+        set: function (fn) { rewrap(fn) },
+      })
+    } catch (cannotDefine) {
+      loader.load = wrapped
+    }
+
+    // Уже поставленные в очередь до нас — тоже наши.
+    if (Array.isArray(loader.pendingQueue)) {
+      for (var i = 0; i < loader.pendingQueue.length; i++) {
+        loader.pendingQueue[i] = wrap(loader.pendingQueue[i])
+      }
+    }
+    try {
+      console.info('[dsh-lanmode] настройки будут работать на этой странице'
+        + (forced ? '' : ' (перевёрнутый режим: притворяемся чужим)'))
+    } catch (noConsole) { /* незачем */ }
+    return loader
+  }
+
+  // Загрузчик объявляется встроенным скриптом страницы. Если он уже есть —
+  // оборачиваем сразу; если нет — дожидаемся присваивания.
+  if (window.__ModuleLoader__) {
+    install(window.__ModuleLoader__)
+    return
+  }
+  var held
+  try {
+    Object.defineProperty(window, '__ModuleLoader__', {
+      configurable: true,
+      get: function () { return held },
+      set: function (value) { held = install(value) },
+    })
+  } catch (cannotDefine) {
+    // Свойство неподатливо — молчим: без заплатки страница остаётся такой же,
+    // какой была без плагина.
+  }
+})()

package/package.json

@@ -1,13 +1,12 @@
 {
   "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.",
+  "version": "0.2.0",
+  "description": "Settings over the LAN for DeepSeek Harness: the Web UI turns its settings service off on any page that is not localhost, even though the server serves settings over the network fine. This plugin taps the served index.html and hands the two settings packages a connection that reports loopback, so every settings surface works from any address.",
   "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"
   },
@@ -39,15 +38,10 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "platform": "web",
-      "inject": [
-        "@deepseek-ai/dsh-client-runtime"
-      ]
     }
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1"
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6"
   }
 }

package/lib/client.js

@@ -1,253 +0,0 @@
-// 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
-  },
-})