import { describeError, isSecureLoginTarget } from "./api.js"; import { renderConfigPage } from "./page.js"; import { SkillAdminError } from "./skill-admin.js"; import { MarketError } from "./market.js"; import { brainStatus, migrateLegacyFiles } from "./brain-migration.js"; import { SkillGroupError } from "./skill-groups.js"; import { renderSkillsPage } from "./skill-page.js"; import { randomUUID } from 'node:crypto'; /** Route constants — kept in one place so the client half can reuse them. */ export const ROUTES = { page: '/dsh-brain', status: '/dsh-brain/status', capabilities: '/dsh-brain/capabilities', config: '/dsh-brain/config', login: '/dsh-brain/login', test: '/dsh-brain/test', flush: '/dsh-brain/flush', skills: '/dsh-brain/skills', market: '/dsh-brain/market', sync: '/dsh-brain/sync', clients: '/dsh-brain/clients', migrate: '/dsh-brain/migrate', }; /** Largest request body we accept (a settings patch is tiny). */ const MAX_BODY_BYTES = 64 * 1024; /** What this build actually implements, stated per feature. */ function capabilities(deps) { const marketProviders = deps.market?.list().length ?? 0; return { version: deps.version, features: { connection: true, identitySwitch: true, skills: deps.admin !== undefined, skillInstallPlans: deps.admin !== undefined, skillUninstallPlan: deps.admin !== undefined, skillsSync: deps.skills !== undefined, skillsMarketplace: deps.market !== undefined, marketProviders, skillUpdate: deps.updates !== undefined, syncResolve: deps.sync !== undefined, multiClient: deps.clients !== undefined, brainMigration: 'ready', // The MCP bridge is provided by the host `dsh-mcp-connector` plugin over // the same origin; the browser half probes it at runtime. mcpBridge: 'host-plugin', }, notes: [ ...(deps.market === undefined ? ['技能市场未启用:没有配置市场来源。'] : [`技能市场已接入 ${marketProviders} 个来源;安装走暂存计划并固定提交。`]), ...(deps.updates === undefined ? ['技能更新/回退未启用。'] : ['更新/回退仅对带来源记录(.skill-source.json)的技能生效,更新前自动备份。']), ...(deps.sync === undefined ? [] : ['同步冲突可在技能页签逐项“保留本地 / 采用云端 / 手动合并”。']), ...(deps.clients === undefined ? [] : ['跨软件与工作区技能清单为只读(DSH 之外不写目录);dsh-brain 数据迁移已就绪,实际改名需部署重启。']), 'MCP 管理由宿主 dsh-mcp-connector 插件提供,本卡通过其公开接口读写,不另建凭据库。', 'MCP 工具可见性与会话级激活分属两层:本卡展示连接与工具缓存,会话级“选择精确工具后激活”由宿主 session-tools 负责,本卡不伪造激活。', ], }; } /** Collect a request body as UTF-8 text. */ async function readBody(req, maxBytes = MAX_BODY_BYTES) { const chunks = []; let bytes = 0; for await (const chunk of req) { const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk); 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) { 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, status, body) { 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, status, message, asHtml = false) { 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); } /** * Read one JSON object body, or answer the request and return undefined. * * The method, origin and content-type gates live here so every write route * cannot forget one of them. */ async function jsonBody(req, res) { if (req.method !== 'POST' && req.method !== 'PUT') { fail(res, 405, 'method-not-allowed'); return undefined; } if (!sameOrigin(req)) { fail(res, 403, 'origin-rejected'); return undefined; } const type = (req.headers['content-type'] ?? '').toLowerCase(); if (!type.startsWith('application/json')) { fail(res, 415, 'json-required'); return undefined; } let parsed; try { parsed = JSON.parse(await readBody(req)); } catch (error) { fail(res, 400, error instanceof Error && error.message === 'request-too-large' ? 'request-too-large' : 'invalid-json'); return undefined; } if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) { fail(res, 400, 'invalid-body'); return undefined; } return parsed; } /** Last test run, kept in memory so the card can show "最后检查". */ let lastCheck = null; /** * Uninstall confirmations. * * A preview issues a single-use token bound to one folder; the delete route * refuses without it, so a stray click cannot remove a skill. */ const uninstallTokens = new Map(); const UNINSTALL_TOKEN_TTL_MS = 10 * 60_000; /** The payload the page and the client card both consume. */ function statusPayload(deps) { const view = deps.store.describe(); const tokens = { activity: view.activityToken, memory: view.memoryToken, summary: view.summaryToken, }; const settings = { enabled: view.enabled, baseUrl: view.baseUrl, baseUrlConfigured: view.baseUrlConfigured, baseUrlOrigin: view.baseUrlOrigin, 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(), lastCheck, capabilities: capabilities(deps), ...(deps.skills === undefined ? {} : { skills: deps.skills() }), }; } /** Serve the configuration page. */ function servePage(deps, req, res) { 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, req, res) { if (req.method !== 'GET') { fail(res, 405, 'method-not-allowed'); return; } json(res, 200, statusPayload(deps)); } /** `GET /dsh-brain/capabilities`. */ function serveCapabilities(deps, req, res) { if (req.method !== 'GET') { fail(res, 405, 'method-not-allowed'); return; } json(res, 200, { ok: true, ...capabilities(deps) }); } /** `PUT /dsh-brain/config`. */ async function serveConfig(deps, req, res) { 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; 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); if (!result.ok) { fail(res, 400, result.error ?? 'invalid-patch'); return; } json(res, 200, { ...statusPayload(deps), ...(result.clearedTokens === undefined ? {} : { credentialsCleared: result.clearedTokens }), }); } /** Map one failed credential probe onto a check state. */ function checkState(error) { if (error.status === 0) return 'unreachable'; if (error.status === 401) return 'invalid'; if (error.status === 403) return 'forbidden'; return 'error'; } /** `POST /dsh-brain/test` — read-only checks, one per credential. */ async function serveTest(deps, req, res) { 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 checks = []; const settings = deps.store.settings(); const reach = await client.reach(); checks.push({ id: 'network', label: '服务地址', state: reach.ok ? 'ok' : 'unreachable', message: deps.store.describe().baseUrlConfigured === false ? '服务地址还是打包默认值,请先填写真实地址。' : reach.message, }); const activityToken = deps.store.activityToken(); if (activityToken === '') { checks.push({ id: 'activity', label: '活动上报权限(activity:write)', state: 'unconfigured', message: '未配置令牌' }); } else { const probe = await client.probeActivity(activityToken); checks.push({ id: 'activity', label: '活动上报权限(activity:write)', state: probe.ok ? 'ok' : checkState(probe.error), message: probe.ok ? '鉴权通过(只验证权限,不代表已写入一条上报)' : describeError(probe.error), }); } const memoryToken = deps.store.memoryToken(); if (memoryToken === '') { checks.push({ id: 'memory', label: '记忆读写权限(memory:write)', state: 'unconfigured', message: '未配置令牌' }); } else { const probe = await client.projects(); checks.push({ id: 'memory', label: '记忆读写权限(memory:write)', state: probe.ok ? 'ok' : checkState(probe.error), message: probe.ok ? `鉴权通过(${(probe.data.projects ?? []).length} 个项目)` : describeError(probe.error), }); } const summaryToken = deps.store.summaryToken(); if (!settings.summaryEnabled) { checks.push({ id: 'summary', label: '摘要权限(summary:write)', state: 'unconfigured', message: '自动摘要已关闭' }); } else if (summaryToken === '') { checks.push({ id: 'summary', label: '摘要权限(summary:write)', state: 'unconfigured', message: '未配置摘要令牌(可选)' }); } else { const probe = await client.probeSummary(summaryToken); checks.push({ id: 'summary', label: '摘要权限(summary:write)', state: probe.ok ? 'ok' : checkState(probe.error), message: probe.ok ? '鉴权通过(只进待确认队列)' : describeError(probe.error), }); } lastCheck = { at: Date.now(), checks }; json(res, 200, { ok: true, checkedAt: lastCheck.at, checks, // Kept for the older card/page shape; both views read the same probes. activity: { ok: checks[1]?.state === 'ok', message: checks[1]?.message ?? '' }, memory: { ok: checks[2]?.state === 'ok', message: checks[2]?.message ?? '' }, summary: { ok: checks[3]?.state === 'ok', message: checks[3]?.message ?? '' }, }); } /** `POST /dsh-brain/flush`. */ async function serveFlush(deps, req, res) { 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 tokens this plugin asks the dashboard to mint. */ const TOKEN_LABELS = { activity: 'DSH desktop 活动上报', memory: 'DSH desktop 记忆读写', summary: 'DSH desktop 对话摘要', }; /** * `POST /dsh-brain/login` — sign in with the cloud account and exchange it * for the scoped tokens. * * The password is used once, in memory, and never written anywhere: the flow is * password → short-lived session cookie → 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, req, res) { 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; try { raw = await readBody(req); } catch { fail(res, 413, 'request-too-large'); return; } let body; try { const parsed = JSON.parse(raw); if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) throw new Error('object required'); body = parsed; } 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 = {}; 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) { switch (code) { case 'not_found': return 404; case 'invalid_name': case 'invalid_url': case 'invalid_plan': return 400; case 'collision': case 'sync_running': case 'plan_expired': case 'confirmation_required': case 'no_source': case 'up_to_date': case 'stale_plan': case 'unsupported': return 409; case 'no_backup': return 404; case 'no_skills_found': return 422; case 'git_failed': return 502; default: return 500; } } /** Issue the single-use token a delete needs. */ function issueUninstallToken(folder) { const token = `uninstall_${randomUUID()}`; uninstallTokens.set(folder, { token, expiresAt: Date.now() + UNINSTALL_TOKEN_TTL_MS }); return token; } /** Consume one uninstall token; false when it is missing, stale or foreign. */ function useUninstallToken(folder, token) { const record = uninstallTokens.get(folder); if (record === undefined) return false; if (typeof token !== 'string' || token !== record.token) return false; if (record.expiresAt < Date.now()) { uninstallTokens.delete(folder); return false; } uninstallTokens.delete(folder); return true; } /** * The skill management surface, one prefix route: * `GET /dsh-brain/skills` the management page * `GET /dsh-brain/skills/api` inventory JSON (skills + plans) * `POST /dsh-brain/skills/detail` { folder } — one skill with SKILL.md * `POST /dsh-brain/skills/toggle` { folder, enabled } * `POST /dsh-brain/skills/install/plan` { url } — stage the repository * `POST /dsh-brain/skills/install/commit` { planId, folders } * `POST /dsh-brain/skills/install/cancel` { planId } * `POST /dsh-brain/skills/uninstall/plan` { folder } — impact preview * `POST /dsh-brain/skills/remove` { folder, token, confirmed: true } */ async function serveSkills(deps, req, res) { const admin = deps.admin; if (admin === undefined) { fail(res, 404, 'skills-admin-unavailable'); return; } 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; } const inventory = await admin.list(); json(res, 200, { ok: true, ...inventory, ...(await admin.listPlans()) }); return; } if (suffix === '/sources') { if (req.method !== 'GET') { fail(res, 405, 'method-not-allowed'); return; } const groups = deps.groups; if (groups === undefined) { fail(res, 404, 'skill-groups-unavailable'); return; } json(res, 200, { ok: true, ...(await groups.overview()) }); return; } const actions = { '/detail': async (body) => ({ ...(await admin.detail(body.folder)) }), '/toggle': async (body) => ({ ...(await admin.setEnabled(body.folder, body.enabled === true)) }), // One-shot install kept for the standalone page; the card uses plan/commit. '/install': async (body) => ({ ...(await admin.installFromGit(body.url)) }), '/install/plan': async (body) => ({ ...(await admin.prepareInstall(body.url)) }), '/install/commit': async (body) => ({ ...(await admin.commitInstall({ planId: body.planId, folders: body.folders })) }), '/install/cancel': async (body) => ({ ...(await admin.cancelInstall({ planId: body.planId })) }), '/uninstall/plan': async (body) => { const plan = await admin.uninstallPlan(body.folder); return { ...plan, token: issueUninstallToken(plan.folder) }; }, '/remove': async (body) => { if (body.confirmed !== true) { throw new SkillAdminError('confirmation_required', '删除必须显式确认:先预览影响,再传 confirmed=true。'); } const folder = typeof body.folder === 'string' ? body.folder : ''; if (!useUninstallToken(folder, body.token)) { throw new SkillAdminError('confirmation_required', '卸载确认已过期或与该技能不匹配,请重新预览。'); } return { ...(await admin.remove(folder)) }; }, }; // Update/rollback operate on skills with a `.skill-source.json` record. They // are optional: without the updater wired in the routes answer 404. const updateActions = { '/update/check': async (body) => ({ ...(await requireUpdates(deps).checkUpdate(body.folder)) }), '/update/apply': async (body) => ({ ...(await requireUpdates(deps).applyUpdate(body.folder, body.expectedCommit)) }), '/rollback': async (body) => ({ ...(await requireUpdates(deps).rollback(body.folder)) }), }; // Category and source switches live in the same prefix so the card has one // base URL; they are grouped here because they never touch a skill folder // directly (except the DSH park/unpark the group manager delegates). const groupActions = { '/import': async (body) => ({ ...(await requireGroups(deps).importSkill(body.sourceId, body.folder)) }), '/groups/create': async (body) => ({ ...(await requireGroups(deps).createGroup(body.sourceId, body.name)) }), '/groups/rename': async (body) => ({ ...(await requireGroups(deps).renameGroup(body.sourceId, body.groupId, body.name)) }), '/groups/delete': async (body) => ({ ...(await requireGroups(deps).deleteGroup(body.sourceId, body.groupId)) }), '/groups/assign': async (body) => ({ ...(await requireGroups(deps).assign(body.sourceId, body.groupId, body.folders)) }), '/groups/toggle': async (body) => ({ ...(await requireGroups(deps).toggleGroup(body.sourceId, body.groupId, body.enabled === true)) }), '/source/toggle': async (body) => ({ ...(await requireGroups(deps).toggleSource(body.sourceId, body.enabled === true)) }), '/source/reveal': async (body) => ({ ...(await requireGroups(deps).reveal(body.sourceId)) }), }; const action = actions[suffix] ?? groupActions[suffix] ?? updateActions[suffix]; if (action === undefined) { fail(res, 404, 'unknown-skill-route'); return; } const body = await jsonBody(req, res); if (body === undefined) return; try { json(res, 200, { ok: true, ...(await action(body)) }); } catch (error) { if (error instanceof SkillAdminError) { json(res, adminStatus(error.code), { ok: false, code: error.code, error: error.message }); return; } if (error instanceof SkillGroupError) { json(res, groupStatus(error.code), { ok: false, code: error.code, error: error.message }); return; } json(res, 500, { ok: false, code: 'internal', error: error instanceof Error ? error.message : String(error) }); } } /** The group manager is optional; the routes answer 404 when it is absent. */ function requireGroups(deps) { if (deps.groups === undefined) throw new SkillGroupError('unavailable', '技能分组功能未启用。'); return deps.groups; } /** HTTP status for one group failure code. */ function groupStatus(code) { switch (code) { case 'not_found': case 'unknown_source': return 404; case 'invalid_name': case 'duplicate': case 'import_from_self': case 'invalid_skill': case 'too_many': return 400; case 'unavailable': return 503; default: return 500; } } /** The updater is optional; its routes answer 404 when it is absent. */ function requireUpdates(deps) { if (deps.updates === undefined) throw new SkillAdminError('unsupported', '技能更新/回退未启用。'); return deps.updates; } /** HTTP status for one market failure code. */ function marketStatus(code) { switch (code) { case 'unknown_provider': case 'invalid_manifest': return 400; case 'not_found': return 404; case 'unreachable': case 'unavailable': return 502; default: return code.startsWith('http_') ? 502 : 500; } } /** * Market surface, one prefix route: * `GET /dsh-brain/market/providers` configured sources * `GET /dsh-brain/market/search` ?provider=&q=&cursor= * `POST /dsh-brain/market/detail` { provider, id } * `POST /dsh-brain/market/plan` { provider, id } — pin commit + stage a plan * `POST /dsh-brain/market/commit` { planId, folders } * `POST /dsh-brain/market/cancel` { planId } */ async function serveMarket(deps, req, res) { const market = deps.market; if (market === undefined) { fail(res, 404, 'market-unavailable'); return; } const url = new URL(req.url ?? '/', 'http://localhost'); const suffix = url.pathname.slice(ROUTES.market.length); try { if (suffix === '' || suffix === '/' || suffix === '/providers') { if (req.method !== 'GET') { fail(res, 405, 'method-not-allowed'); return; } json(res, 200, { ok: true, providers: market.list() }); return; } if (suffix === '/search') { if (req.method !== 'GET') { fail(res, 405, 'method-not-allowed'); return; } const providerId = url.searchParams.get('provider') ?? market.list()[0]?.id ?? ''; const query = url.searchParams.get('q') ?? ''; const cursorRaw = Number(url.searchParams.get('cursor') ?? '0'); const cursor = Number.isFinite(cursorRaw) && cursorRaw > 0 ? cursorRaw : 0; const result = await market.search(providerId, query, cursor); json(res, 200, { ok: true, provider: market.get(providerId).info(), ...result }); return; } const admin = deps.admin; const requireAdmin = () => { if (admin === undefined) throw new MarketError('unavailable', '技能管理未启用,无法安装。'); return admin; }; const actions = { '/detail': async (body) => ({ ...(await market.detail(String(body.provider ?? ''), String(body.id ?? ''))) }), '/plan': async (body) => { const providerId = String(body.provider ?? ''); const id = String(body.id ?? ''); const artifact = await market.resolve(providerId, id, typeof body.version === 'string' ? body.version : undefined); const plan = await requireAdmin().prepareInstall(artifact.repoUrl, { ref: artifact.ref, source: { provider: providerId, entryId: id, ...(artifact.version === undefined ? {} : { version: artifact.version }), }, }); const wanted = new Set(artifact.folders); return { planId: plan.planId, ...(plan.commit === undefined ? {} : { commit: plan.commit }), artifact, candidates: plan.candidates.filter((candidate) => wanted.has(candidate.folder)), totalInRepo: plan.candidates.length, }; }, '/commit': async (body) => ({ ...(await requireAdmin().commitInstall({ planId: body.planId, folders: body.folders })) }), '/cancel': async (body) => ({ ...(await requireAdmin().cancelInstall({ planId: body.planId })) }), }; const action = actions[suffix]; if (action === undefined) { fail(res, 404, 'unknown-market-route'); return; } const body = await jsonBody(req, res); if (body === undefined) return; json(res, 200, { ok: true, ...(await action(body)) }); } catch (error) { if (error instanceof MarketError) { json(res, marketStatus(error.code), { ok: false, code: error.code, error: error.message }); return; } if (error instanceof SkillAdminError) { json(res, adminStatus(error.code), { ok: false, code: error.code, error: error.message }); return; } json(res, 500, { ok: false, code: 'internal', error: error instanceof Error ? error.message : String(error) }); } } /** * Sync surface: * `GET /dsh-brain/sync/status` latest stats + both sides of each conflict * `POST /dsh-brain/sync/run` trigger one pass now * `POST /dsh-brain/sync/resolve` { name, action: keep_local | take_cloud | manual } */ async function serveSync(deps, req, res) { const sync = deps.sync; if (sync === undefined) { fail(res, 404, 'sync-unavailable'); return; } const url = new URL(req.url ?? '/', 'http://localhost'); const suffix = url.pathname.slice(ROUTES.sync.length); try { if (suffix === '' || suffix === '/' || suffix === '/status') { if (req.method !== 'GET') { fail(res, 405, 'method-not-allowed'); return; } json(res, 200, { ok: true, stats: sync.stats(), conflicts: await sync.conflictDetails() }); return; } if (suffix === '/run') { if (req.method !== 'POST') { fail(res, 405, 'method-not-allowed'); return; } const stats = await sync.syncOnce(); json(res, 200, { ok: true, stats, conflicts: await sync.conflictDetails() }); return; } if (suffix === '/resolve') { if (req.method !== 'POST') { fail(res, 405, 'method-not-allowed'); return; } const body = await jsonBody(req, res); if (body === undefined) return; const result = await sync.resolveConflict(body.name, body.action); json(res, 200, { ok: true, ...result, conflicts: await sync.conflictDetails() }); return; } fail(res, 404, 'unknown-sync-route'); } catch (error) { const message = error instanceof Error ? error.message : String(error); const known = ['invalid_name', 'invalid_action', 'no_local_copy', 'no_cloud_copy', 'stale_revision', 'sync_running', 'manifest_mismatch']; const code = known.includes(message) ? message : 'internal'; const status = code === 'internal' ? 500 : code === 'invalid_name' || code === 'invalid_action' ? 400 : 409; json(res, status, { ok: false, code, error: message }); } } /** Cross-software / workspace inventory routes. */ async function serveClients(deps, req, res) { const registry = deps.clients; if (registry === undefined) { fail(res, 404, 'clients-unavailable'); return; } const url = new URL(req.url ?? '/', 'http://localhost'); const suffix = url.pathname.slice(ROUTES.clients.length); try { if (suffix === '' || suffix === '/' || suffix === '/overview') { if (req.method !== 'GET') { fail(res, 405, 'method-not-allowed'); return; } json(res, 200, { ok: true, ...(await registry.overview()) }); return; } if (suffix === '/inventory') { if (req.method !== 'GET') { fail(res, 405, 'method-not-allowed'); return; } const result = await registry.inventory(url.searchParams.get('software'), url.searchParams.get('scope'), url.searchParams.get('workspaceId') ?? undefined); json(res, 200, { ok: true, ...result }); return; } if (suffix === '/workspaces/add') { if (req.method !== 'POST') { fail(res, 405, 'method-not-allowed'); return; } const body = await jsonBody(req, res); if (body === undefined) return; const workspace = await registry.addWorkspace(body.software, body.path, body.name); json(res, 200, { ok: true, workspace }); return; } if (suffix === '/workspaces/remove') { if (req.method !== 'POST') { fail(res, 405, 'method-not-allowed'); return; } const body = await jsonBody(req, res); if (body === undefined) return; json(res, 200, { ok: true, ...(await registry.removeWorkspace(body.software, body.id)) }); return; } if (suffix === '/workspace/inventory') { if (req.method !== 'GET') { fail(res, 405, 'method-not-allowed'); return; } const { admin, workspace } = await registry.workspaceSkillAdmin(url.searchParams.get('software'), url.searchParams.get('workspaceId')); json(res, 200, { ok: true, workspace, ...(await admin.list()) }); return; } if (suffix === '/workspace/detail') { if (req.method !== 'POST') { fail(res, 405, 'method-not-allowed'); return; } const body = await jsonBody(req, res); if (body === undefined) return; const { admin } = await registry.workspaceSkillAdmin(body.software, body.workspaceId); json(res, 200, { ok: true, ...(await admin.detail(body.folder)) }); return; } if (suffix === '/workspace/toggle') { if (req.method !== 'POST') { fail(res, 405, 'method-not-allowed'); return; } const body = await jsonBody(req, res); if (body === undefined) return; const { admin } = await registry.workspaceSkillAdmin(body.software, body.workspaceId); json(res, 200, { ok: true, ...(await admin.setEnabled(body.folder, body.enabled === true)) }); return; } if (suffix === '/workspace/remove') { if (req.method !== 'POST') { fail(res, 405, 'method-not-allowed'); return; } const body = await jsonBody(req, res); if (body === undefined) return; if (body.confirmed !== true) throw new SkillAdminError('confirmation_required', '工作区技能删除必须显式 confirmed:true。'); const { admin } = await registry.workspaceSkillAdmin(body.software, body.workspaceId); json(res, 200, { ok: true, ...(await admin.remove(body.folder)) }); return; } if (suffix === '/workspace/install/plan') { if (req.method !== 'POST') { fail(res, 405, 'method-not-allowed'); return; } const body = await jsonBody(req, res); if (body === undefined) return; const { admin } = await registry.workspaceSkillAdmin(body.software, body.workspaceId); json(res, 200, { ok: true, ...(await admin.prepareInstall(body.url)) }); return; } if (suffix === '/workspace/install/commit') { if (req.method !== 'POST') { fail(res, 405, 'method-not-allowed'); return; } const body = await jsonBody(req, res); if (body === undefined) return; const { admin } = await registry.workspaceSkillAdmin(body.software, body.workspaceId); json(res, 200, { ok: true, ...(await admin.commitInstall({ planId: body.planId, folders: body.folders })) }); return; } fail(res, 404, 'unknown-clients-route'); } catch (error) { if (error instanceof SkillAdminError) { json(res, adminStatus(error.code), { ok: false, code: error.code, error: error.message }); return; } const message = error instanceof Error ? error.message : String(error); const known = ['invalid_software', 'invalid_path', 'duplicate', 'not_found', 'unknown_workspace', 'unsupported_workspace_write']; const code = known.includes(message) ? message : 'internal'; const status = code === 'internal' ? 500 : code === 'not_found' || code === 'unknown_workspace' ? 404 : code === 'duplicate' ? 409 : code === 'unsupported_workspace_write' ? 501 : 400; json(res, status, { ok: false, code, error: message }); } } /** dsh-brain data migration: GET status, POST run. */ async function serveMigrate(_deps, req, res) { const url = new URL(req.url ?? '/', 'http://localhost'); const suffix = url.pathname.slice(ROUTES.migrate.length); if (suffix === '' || suffix === '/' || suffix === '/brain') { if (req.method === 'GET') { const status = await brainStatus(); json(res, 200, { ok: true, ...status }); return; } if (req.method === 'POST') { const result = await migrateLegacyFiles(); json(res, 200, { ok: true, ...result }); return; } fail(res, 405, 'method-not-allowed'); return; } fail(res, 404, 'unknown-migrate-route'); } /** Build the exact-route table registered with the host web server. */ /** Pre-rename aliases (0.8.0): the same handlers under the old `/cloud-memory` prefix. */ export function createLegacyRoutes(deps) { return createRoutes(deps).map((route) => ({ ...route, path: route.path.replace('/dsh-brain', '/cloud-memory') })); } export function createRoutes(deps) { 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.capabilities, handler: (req, res) => serveCapabilities(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), }, { kind: 'prefix', path: ROUTES.market, handler: (req, res) => serveMarket(deps, req, res), }, { kind: 'prefix', path: ROUTES.sync, handler: (req, res) => serveSync(deps, req, res), }, { kind: 'prefix', path: ROUTES.clients, handler: (req, res) => serveClients(deps, req, res), }, { kind: 'prefix', path: ROUTES.migrate, handler: (req, res) => serveMigrate(deps, req, res), }, ]; }