@goodandready/dsh-session-control 0.1.0

package/lib/index.js

@@ -0,0 +1,127 @@
+/**
+ * Серверная половина dsh-session-control.
+ *
+ * Здесь живут пространство настроек (закрепления и скрытия) и один маршрут —
+ * расшифровка заархивированной сессии.
+ *
+ * Почему маршрут вообще понадобился. Заархивированную сессию нельзя открыть в
+ * браузере: окно истории у клиента поднимается только для сессии «на сцене»,
+ * то есть текущей, а текущей архивная быть не может — политика ядра снимает
+ * такой выбор. Потоковый `session/follow` по обычному запросу не открывается,
+ * ему нужен потоковый переносчик, а `session/page` отвечает «failed to observe
+ * session», пока за сессией не следят.
+ *
+ * Зато на хосте есть штатная дверь: `sessionPersistence.readRaw(id)` отдаёт
+ * сохранённый лог, не поднимая живую сессию. Через неё мы и читаем.
+ */
+import z from '@deepseek-ai/schemastery'
+import { transcriptFromEvents } from './transcript.js'
+
+export const name = 'dsh-session-control'
+
+/** Пространство настроек. Совпадает с ключом карточки settings.plugin.item. */
+export const NS = 'dsh-session-control'
+
+/** Сколько сообщений отдаём за один запрос: расшифровка читается, а не листается бесконечно. */
+const TRANSCRIPT_LIMIT = 400
+
+export const Config = z.object({
+  /**
+   * Идентификаторы закреплённых сессий. Порядок массива — порядок в панели.
+   * Закрепление общее на всю панель, а не внутри папки.
+   */
+  pinned: z.array(z.string()).default([]),
+  /**
+   * Идентификаторы скрытых сессий. Наше скрытие обратимо, в отличие от
+   * ядрового архива: WorkspaceRegistry.archiveSession только добавляет, метода
+   * возврата в API нет.
+   */
+  hidden: z.array(z.string()).default([]),
+  /**
+   * Прятать сессии без единого сообщения. Их непрерывно плодят расписания,
+   * мессенджер и доска, и в списке они мешают настоящим разговорам.
+   * Текущая сессия не прячется никогда, даже пустая: иначе пропадёт строка,
+   * в которую человек как раз собирается писать.
+   */
+  hideBlank: z.boolean().default(true),
+})
+
+
+
+export function apply(ctx, config) {
+  ctx.inject(['settings'], (sctx) => {
+    sctx.settings.register(NS, Config, { base: config })
+  })
+
+  ctx.inject(['webServer', 'sessionPersistence'], (rctx) => {
+    rctx.effect(() => rctx.webServer.register({
+      kind: 'exact',
+      path: '/dsh-session-control/transcript',
+      handler: async (req, res) => {
+        const reply = (code, body) => {
+          res.writeHead(code, { 'content-type': 'application/json; charset=utf-8' })
+          res.end(JSON.stringify(body))
+        }
+        try {
+          const url = new URL(req.url, 'http://localhost')
+          const sessionId = url.searchParams.get('session')
+          if (sessionId === null || sessionId === '') {
+            reply(400, { ok: false, error: 'session parameter is required' })
+            return
+          }
+          // Сервис берём через get, а не как свойство контекста: так делает и
+          // ядровый экспорт логов.
+          const store = rctx.get('sessionPersistence')
+          // Поверхность бэкенда различается между выпусками ядра: где-то есть
+          // readRaw, где-то пара resolveLog + readStoredLog. Спрашиваем, что
+          // умеет этот, вместо того чтобы полагаться на версию.
+          if (store === undefined
+              || typeof store.resolveLog !== 'function'
+              || typeof store.readStoredLog !== 'function') {
+            reply(501, { ok: false, error: 'this session backend cannot read stored logs' })
+            return
+          }
+          // Старые логи формата v0 ядро отказывается мигрировать при чтении
+          // и возвращает пустой лог, не сообщая об отказе. Отличаем это от
+          // действительно пустой сессии: врать «сообщений нет» нельзя.
+          let messages = []
+          let unreadable = false
+          let missing = false
+          try {
+            // resolveLog сам запускает миграцию формата и бросает на старых
+            // логах, поэтому под перехватом должен быть и он, а не только
+            // чтение.
+            const path = await store.resolveLog(sessionId)
+            if (path === undefined) {
+              missing = true
+            } else {
+              const log = await store.readStoredLog(path, sessionId)
+              const events = (log && log.events) || []
+              messages = transcriptFromEvents(events)
+              unreadable = events.length === 0
+            }
+          } catch (refused) {
+            unreadable = true
+          }
+          if (missing) {
+            reply(404, { ok: false, error: 'session not found' })
+            return
+          }
+          if (unreadable) {
+            reply(200, { ok: true, sessionId, unreadable: true, total: 0, truncated: false, messages: [] })
+            return
+          }
+          reply(200, {
+            ok: true,
+            sessionId,
+            total: messages.length,
+            truncated: messages.length > TRANSCRIPT_LIMIT,
+            messages: messages.slice(-TRANSCRIPT_LIMIT),
+          })
+        } catch (failure) {
+          reply(500, { ok: false, error: (failure && failure.message) || String(failure) })
+        }
+      },
+    }), 'dsh-session-control: маршрут расшифровки')
+  })
+}

package/lib/transcript.js

@@ -0,0 +1,67 @@
+/**
+ * Превращение лога сессии в расшифровку.
+ *
+ * Модуль намеренно без единой внешней зависимости: это чистая логика, и она
+ * должна проверяться тестами без харнесса и без установки профиля.
+ */
+
+/**
+ * Отобрать из событий то, что человек считает разговором.
+ *
+ * Берём его собственные сообщения, ответы агента и факт вызова инструмента.
+ * Рассуждения модели пропускаем — это её черновик, а не содержание беседы.
+ *
+ * @param events - события лога в порядке записи.
+ * @returns сообщения в том же порядке.
+ */
+export function transcriptFromEvents(events) {
+  const out = []
+  for (const event of events || []) {
+    const kind = event && event.type
+    if (kind === 'user/message' || kind === 'assistant/message') {
+      // Две формы в одном логе: у сообщений пользователя содержимое лежит
+      // прямо в data.content, у ответов агента — в data.message.content.
+      // Читаем обе, иначе половина разговора пропадает молча.
+      const data = event.data || {}
+      const message = data.message || {}
+      const parts = Array.isArray(data.content)
+        ? data.content
+        : (Array.isArray(message.content) ? message.content : [])
+      const text = parts
+        .filter((part) => part && part.type === 'text' && typeof part.text === 'string')
+        .map((part) => part.text)
+        .join('\n')
+      if (text.trim() === '') continue
+      out.push({ role: kind === 'user/message' ? 'user' : 'assistant', text, time: event.time })
+    } else if (kind === 'tool/call') {
+      const data = event.data || {}
+      const toolName = data.name || (data.call && data.call.name)
+      if (typeof toolName === 'string' && toolName !== '') {
+        out.push({ role: 'tool', text: toolName, time: event.time })
+      }
+    }
+  }
+  return out
+}
+
+/**
+ * То же самое, но из сырого текста лога — одна JSON-запись на строку.
+ *
+ * Битые строки пропускаем: одна повреждённая запись не должна лишать человека
+ * всей остальной расшифровки.
+ *
+ * @param raw - содержимое файла лога.
+ * @returns сообщения в порядке лога.
+ */
+export function parseTranscript(raw) {
+  const events = []
+  for (const line of String(raw).split('\n')) {
+    if (line.trim() === '') continue
+    try {
+      events.push(JSON.parse(line))
+    } catch (notJson) {
+      continue
+    }
+  }
+  return transcriptFromEvents(events)
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@goodandready/dsh-session-control",
+  "version": "0.1.0",
+  "description": "Session management for the DeepSeek Harness sidebar: pin conversations, search their contents, read archived transcripts and hide the noise",
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/",
+    "cordis.patch.yml",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-api-session-controller",
+        "@deepseek-ai/dsh-api-workspace-controller",
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-session",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-sidebar"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GooDAnDReaDY/dsh-session-control.git"
+  },
+  "homepage": "https://github.com/GooDAnDReaDY/dsh-session-control#readme",
+  "bugs": {
+    "url": "https://github.com/GooDAnDReaDY/dsh-session-control/issues"
+  }
+}