/** * HTTP surface served by the host web server. * * All routes live under `/dsh-brain`: * - `GET /dsh-brain` configuration page (HTML) * - `GET /dsh-brain/status` settings + reporter counters (JSON) * - `PUT /dsh-brain/config` apply a settings patch (JSON) * - `POST /dsh-brain/login` password sign-in, mints both tokens (JSON) * - `POST /dsh-brain/test` validate both tokens (JSON) * - `POST /dsh-brain/flush` retry the queued reports (JSON) * * Every JSON route is same-origin only: the tokens are read from the local file * and never echoed back, but a cross-site `PUT` could still be used to redirect * reports to an attacker's base URL, so the origin check stays on. */ import type { IncomingMessage, ServerResponse } from 'node:http' import type { CloudClient } from './api.ts' import { describeError, isSecureLoginTarget } from './api.ts' import type { SettingsView, SettingsStore, TokenView } from './store.ts' import type { Reporter } from './reporter.ts' import { renderConfigPage } from './page.ts' import type { CloudMemoryWebRoute } from './context-types.ts' import type { SkillSyncStats } from './skill-sync.ts' import { SkillAdminError } from './skill-admin.ts' import type { SkillAdmin } from './skill-admin.ts' import { renderSkillsPage } from './skill-page.ts' /** Route constants — kept in one place so the client half can reuse them. */ export const ROUTES = { page: '/dsh-brain', status: '/dsh-brain/status', config: '/dsh-brain/config', login: '/dsh-brain/login', test: '/dsh-brain/test', flush: '/dsh-brain/flush', skills: '/dsh-brain/skills', } as const /** Largest request body we accept (a settings patch is tiny). */ const MAX_BODY_BYTES = 64 * 1024 /** Everything the routes need from the plugin core. */ export interface RouteDeps { version: string store: SettingsStore reporter: Reporter client: () => CloudClient /** Latest skill-sync stats, when the engine is wired in. */ skills?: () => SkillSyncStats /** Local skill management (list / toggle / trash / install), when wired in. */ admin?: SkillAdmin } /** Collect a request body as UTF-8 text. */ async function readBody(req: IncomingMessage, maxBytes = MAX_BODY_BYTES): Promise { const chunks: Buffer[] = [] let bytes = 0 for await (const chunk of req) { const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk as Uint8Array) bytes += buffer.byteLength if (bytes > maxBytes) throw new Error('request-too-large') chunks.push(buffer) } return Buffer.concat(chunks).toString('utf8') } /** Reject cross-origin browser writes. */ function sameOrigin(req: IncomingMessage): boolean { const origin = req.headers.origin const host = req.headers.host if (origin === undefined || host === undefined) return true return origin === `http://${host}` || origin === `https://${host}` } /** Emit one JSON response with no caching. */ function json(res: ServerResponse, status: number, body: unknown): void { const text = JSON.stringify(body) res.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store', 'content-length': Buffer.byteLength(text), }) res.end(text) } /** Emit a plain-text error (page route) or JSON error (API routes). */ function fail(res: ServerResponse, status: number, message: string, asHtml = false): void { const text = asHtml ? `云端记忆${message}` : JSON.stringify({ ok: false, error: message }) res.writeHead(status, { 'content-type': asHtml ? 'text/html; charset=utf-8' : 'application/json; charset=utf-8', 'cache-control': 'no-store', }) res.end(text) } /** The payload the page and the client card both consume. */ function statusPayload(deps: RouteDeps): Record { const view = deps.store.describe() const tokens: Record<'activity' | 'memory' | 'summary', TokenView> = { activity: view.activityToken, memory: view.memoryToken, summary: view.summaryToken, } const settings = { enabled: view.enabled, baseUrl: view.baseUrl, clientId: view.clientId, requestTimeoutMs: view.requestTimeoutMs, defaultK: view.defaultK, summaryEnabled: view.summaryEnabled, summaryMaxChars: view.summaryMaxChars, skillsSyncEnabled: view.skillsSyncEnabled, skillsDir: view.skillsDir, } return { ok: true, settings, tokens, settingsPath: view.statePath, reporter: deps.reporter.snapshot(), ...(deps.skills === undefined ? {} : { skills: deps.skills() }), } } /** Serve the configuration page. */ function servePage(deps: RouteDeps, req: IncomingMessage, res: ServerResponse): void { if (req.method !== 'GET' && req.method !== 'HEAD') { fail(res, 405, 'method-not-allowed', true) return } const html = renderConfigPage({ version: deps.version, settingsPath: deps.store.path }) res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-store', 'content-length': Buffer.byteLength(html), }) if (req.method === 'HEAD') res.end() else res.end(html) } /** `GET /dsh-brain/status`. */ function serveStatus(deps: RouteDeps, req: IncomingMessage, res: ServerResponse): void { if (req.method !== 'GET') { fail(res, 405, 'method-not-allowed') return } json(res, 200, statusPayload(deps)) } /** `PUT /dsh-brain/config`. */ async function serveConfig(deps: RouteDeps, req: IncomingMessage, res: ServerResponse): Promise { if (req.method !== 'PUT' && req.method !== 'POST') { fail(res, 405, 'method-not-allowed') return } if (!sameOrigin(req)) { fail(res, 403, 'origin-rejected') return } const type = (req.headers['content-type'] ?? '').toLowerCase() if (!type.startsWith('application/json')) { fail(res, 415, 'json-required') return } let patch: unknown try { patch = JSON.parse(await readBody(req)) } catch (error) { fail(res, 400, error instanceof Error && error.message === 'request-too-large' ? 'request-too-large' : 'invalid-json') return } if (patch === null || typeof patch !== 'object' || Array.isArray(patch)) { fail(res, 400, 'invalid-patch') return } const result = deps.store.patch(patch as Record) if (!result.ok) { fail(res, 400, result.error ?? 'invalid-patch') return } json(res, 200, statusPayload(deps)) } /** `POST /dsh-brain/test` — validate both tokens without recording anything. */ async function serveTest(deps: RouteDeps, req: IncomingMessage, res: ServerResponse): Promise { if (req.method !== 'POST') { fail(res, 405, 'method-not-allowed') return } if (!sameOrigin(req)) { fail(res, 403, 'origin-rejected') return } const client = deps.client() const activityToken = deps.store.activityToken() const memoryToken = deps.store.memoryToken() const activity: { ok: boolean; message: string } = activityToken === '' ? { ok: false, message: '还没填令牌:把 activity:write 密钥粘到下面「活动上报令牌」再点保存' } : await (async () => { const probe = await client.probeActivity(activityToken) return probe.ok ? { ok: true, message: '令牌有效(鉴权通过)' } : { ok: false, message: describeError(probe.error) } })() const memory: { ok: boolean; message: string } = memoryToken === '' ? { ok: false, message: '还没填令牌:把 memory:write 密钥粘到下面「记忆读写令牌」再点保存' } : await (async () => { const probe = await client.projects() return probe.ok ? { ok: true, message: `令牌有效(${(probe.data.projects ?? []).length} 个项目)` } : { ok: false, message: describeError(probe.error) } })() const summaryToken = deps.store.summaryToken() const summary = !deps.store.settings().summaryEnabled ? { ok: false, message: '自动摘要已关闭(可在下方勾选开启)' } : summaryToken === '' ? { ok: false, message: '未配置摘要令牌:留空则不做自动摘要' } : await (async () => { const probe = await client.probeSummary(summaryToken) return probe.ok ? { ok: true, message: '摘要令牌有效(只进待确认队列)' } : { ok: false, message: describeError(probe.error) } })() json(res, 200, { ok: true, activity, memory, summary }) } /** `POST /dsh-brain/flush`. */ async function serveFlush(deps: RouteDeps, req: IncomingMessage, res: ServerResponse): Promise { if (req.method !== 'POST') { fail(res, 405, 'method-not-allowed') return } if (!sameOrigin(req)) { fail(res, 403, 'origin-rejected') return } const result = await deps.reporter.flush() json(res, 200, { ok: true, ...result }) } /** Labels attached to the two tokens this plugin asks the dashboard to mint. */ const TOKEN_LABELS = { activity: 'DSH desktop 活动上报', memory: 'DSH desktop 记忆读写', summary: 'DSH desktop 对话摘要', } as const /** * `POST /dsh-brain/login` — sign in with the cloud account and exchange it * for the two scoped tokens. * * The password is used once, in memory, and never written anywhere: the flow is * password → short-lived session cookie → two `cmt_…` tokens → cookie dropped. * Only the tokens are persisted, so a later password change does not break the * plugin and revoking a token does not reveal the password. */ async function serveLogin(deps: RouteDeps, req: IncomingMessage, res: ServerResponse): Promise { if (req.method !== 'POST') { fail(res, 405, 'method-not-allowed') return } if (!sameOrigin(req)) { fail(res, 403, 'origin-rejected') return } const target = deps.store.settings().baseUrl if (!isSecureLoginTarget(target)) { // Refuse to put a password on a plaintext channel that is not loopback. json(res, 400, { ok: false, error: '服务地址不是 HTTPS,拒绝在上面发送密码,请先把服务地址改成 https://' }) return } let raw: string try { raw = await readBody(req) } catch { fail(res, 413, 'request-too-large') return } let body: Record try { const parsed: unknown = JSON.parse(raw) if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) throw new Error('object required') body = parsed as Record } catch { fail(res, 400, 'invalid-json') return } const username = typeof body.username === 'string' ? body.username.trim() : '' const password = typeof body.password === 'string' ? body.password : '' if (username === '' || password === '') { json(res, 400, { ok: false, error: '请填写用户名和密码' }) return } if (username.length > 64 || password.length > 256) { json(res, 400, { ok: false, error: '用户名或密码过长' }) return } const client = deps.client() const session = await client.login(username, password) if (!session.ok) { const status = session.error.status === 429 ? 429 : 401 json(res, status, { ok: false, error: describeError(session.error) }) return } const activity = await client.mintToken(session.data.sessionCookie, 'activity:write', TOKEN_LABELS.activity) const memory = await client.mintToken(session.data.sessionCookie, 'memory:write', TOKEN_LABELS.memory) const summary = await client.mintToken(session.data.sessionCookie, 'summary:write', TOKEN_LABELS.summary) if (!activity.ok && !memory.ok) { const first = activity.ok ? memory : activity const reason = first.ok ? '无法创建令牌' : describeError(first.error) json(res, 400, { ok: false, error: `登录成功,但创建令牌失败:${reason}` }) return } const patch: Parameters[0] = {} if (activity.ok && typeof activity.data.token === 'string') patch.activityToken = activity.data.token if (memory.ok && typeof memory.data.token === 'string') patch.memoryToken = memory.data.token if (summary.ok && typeof summary.data.token === 'string') patch.summaryToken = summary.data.token const applied = deps.store.patch(patch) if (!applied.ok) { json(res, 500, { ok: false, error: applied.error }) return } const failed = activity.ok ? memory : activity const partial = !activity.ok || !memory.ok json(res, 200, { ...statusPayload(deps), login: { ok: true, partial, user: { username: typeof session.data.user.username === 'string' ? session.data.user.username : username, role: session.data.user.role, }, activity: activity.ok, memory: memory.ok, summary: summary.ok, warning: failed.ok ? undefined : `部分令牌没有创建成功:${describeError(failed.error)}`, }, }) } /** HTTP status for one skill-admin failure code. */ function adminStatus(code: string): number { switch (code) { case 'not_found': return 404 case 'invalid_name': case 'invalid_url': return 400 case 'collision': case 'sync_running': return 409 case 'no_skills_found': return 422 case 'git_failed': return 502 default: return 500 } } /** * The skill management surface, one prefix route: * `GET /dsh-brain/skills` the management page * `GET /dsh-brain/skills/api` inventory JSON (skills + trash) * `POST /dsh-brain/skills/toggle` { folder, enabled } * `POST /dsh-brain/skills/remove` { folder } * `POST /dsh-brain/skills/install` { url } */ async function serveSkills(deps: RouteDeps, req: IncomingMessage, res: ServerResponse): Promise { if (deps.admin === undefined) { fail(res, 404, 'skills-admin-unavailable') return } const admin = deps.admin const suffix = (req.url ?? '').split('?')[0]?.slice(ROUTES.skills.length) ?? '' if (suffix === '' || suffix === '/') { if (req.method !== 'GET' && req.method !== 'HEAD') { fail(res, 405, 'method-not-allowed', true) return } const html = renderSkillsPage({ version: deps.version }) res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-store', 'content-length': Buffer.byteLength(html), }) if (req.method === 'HEAD') res.end() else res.end(html) return } if (suffix === '/api') { if (req.method !== 'GET') { fail(res, 405, 'method-not-allowed') return } json(res, 200, { ok: true, ...(await admin.list()) }) return } const actions: Record) => Promise>> = { '/toggle': async (body) => admin.setEnabled(body.folder, body.enabled === true), '/remove': async (body) => admin.remove(body.folder), '/install': async (body) => admin.installFromGit(body.url), } const action = actions[suffix] if (action === undefined) { fail(res, 404, 'unknown-skill-route') return } if (req.method !== 'POST') { fail(res, 405, 'method-not-allowed') return } if (!sameOrigin(req)) { fail(res, 403, 'origin-rejected') return } const type = (req.headers['content-type'] ?? '').toLowerCase() if (!type.startsWith('application/json')) { fail(res, 415, 'json-required') return } let body: unknown try { body = JSON.parse(await readBody(req)) } catch { fail(res, 400, 'invalid-json') return } if (body === null || typeof body !== 'object' || Array.isArray(body)) { fail(res, 400, 'invalid-body') return } try { json(res, 200, { ok: true, ...(await action(body as Record)) }) } catch (error) { if (error instanceof SkillAdminError) { json(res, adminStatus(error.code), { ok: false, code: error.code, error: error.message }) } else { json(res, 500, { ok: false, code: 'internal', error: error instanceof Error ? error.message : String(error) }) } } } /** Build the exact-route table registered with the host web server. */ /** Pre-rename aliases (v0.5.0): the same handlers under the old `/cloud-memory` prefix. */ export function createLegacyRoutes(deps: RouteDeps): CloudMemoryWebRoute[] { return createRoutes(deps).map((route) => ({ ...route, path: route.path.replace('/dsh-brain', '/cloud-memory') })) } export function createRoutes(deps: RouteDeps): CloudMemoryWebRoute[] { return [ { kind: 'exact', path: ROUTES.page, handler: (req, res) => servePage(deps, req, res), }, { kind: 'exact', path: ROUTES.status, handler: (req, res) => serveStatus(deps, req, res), }, { kind: 'exact', path: ROUTES.config, handler: (req, res) => serveConfig(deps, req, res), }, { kind: 'exact', path: ROUTES.login, handler: (req, res) => serveLogin(deps, req, res), }, { kind: 'exact', path: ROUTES.test, handler: (req, res) => serveTest(deps, req, res), }, { kind: 'exact', path: ROUTES.flush, handler: (req, res) => serveFlush(deps, req, res), }, { kind: 'prefix', path: ROUTES.skills, handler: (req, res) => serveSkills(deps, req, res), }, ] }