231 lines
8.9 KiB
JavaScript
231 lines
8.9 KiB
JavaScript
// Host 侧装配:把账本、业务服务、会话层和 HTTP 路由接在一起。
|
||
//
|
||
// 这一层是唯一知道“账本文件在哪、损坏了怎么办”的地方:
|
||
// - 账本损坏(不是 JSON / schemaVersion 不符)时不崩溃:把坏文件改名留存,
|
||
// 从空账本启动,并把 warning 交给调用方(index.js / 诊断页)显示。
|
||
// 悄悄删掉或不说话都会让人以为“历史记录丢了”。
|
||
// - 宿主没有 webServer 时照常返回 service,只是路由不注册,registered=false;
|
||
// 若宿主稍后提供了 webServer,用 ctx.inject 补注册一次(不重复建 store)。
|
||
// - 宿主没有 sessionController 时,工作台仍能读写账本(投影可用),
|
||
// 但派发只落账不投递,UI 显示“尚未接通”,绝不假装成功。
|
||
//
|
||
// 与 workbench-host.mjs 的关系:那边是「账本 + 会话层 + 对账」的纯逻辑外壳,
|
||
// 这边负责文件、损坏隔离、HTTP 与生命周期,并把路由钩子接到外壳上。
|
||
|
||
import { existsSync, renameSync } from 'node:fs'
|
||
import { WorkbenchStore, SCHEMA_VERSION } from '../core/store.mjs'
|
||
import { corruptPathFor, ensureSidecarDir, resolveSidecarDir, resolveStorePath } from './paths.mjs'
|
||
import { registerWorkbenchRoutes } from './routes.mjs'
|
||
import { createWorkbenchHost as createWorkbenchShell } from './workbench-host.mjs'
|
||
|
||
export { createWorkbenchService } from './service.mjs'
|
||
export { createMemoryStore, MemoryError, MEMORY_FILE_MAX_CHARS, MEMORY_EXCERPT_CHARS } from '../core/memory.mjs'
|
||
export {
|
||
createWorkbenchHost as createWorkbenchShell,
|
||
CONTRACT_ACTIONS,
|
||
CONTRACT_ACTION_PREFIX,
|
||
describeContract,
|
||
parseContractLines,
|
||
WORKBENCH_HOST_VERSION,
|
||
} from './workbench-host.mjs'
|
||
export {
|
||
buildRouteTable,
|
||
listWorkbenchRoutes,
|
||
registerWorkbenchRoutes,
|
||
MAX_BODY_BYTES,
|
||
ROUTE_PREFIX,
|
||
} from './routes.mjs'
|
||
export {
|
||
SIDECAR_DIR_NAME,
|
||
corruptPathFor,
|
||
ensureSidecarDir,
|
||
quarantineFile,
|
||
readJsonSafe,
|
||
resolveSidecarDir,
|
||
resolveSidecarFile,
|
||
resolveStorePath,
|
||
writeFileAtomic,
|
||
writeJsonAtomic,
|
||
} from './paths.mjs'
|
||
|
||
/**
|
||
* 创建 Host 侧工作台。
|
||
*
|
||
* @param {object|null} ctx 宿主上下文(可为 null:服务仍可用,只是没有路由/会话)。
|
||
* @param {object} [options]
|
||
* @param {string} [options.file] 账本路径;默认 %DSH_HOME%/sansheng-liubu/workbench.json。
|
||
* @param {object} [options.env] 计算默认路径用的环境变量。
|
||
* @param {() => number} [options.clock] 注入时钟。
|
||
* @param {() => string} [options.random] 注入随机源(测试里固定 ID 用)。
|
||
* @param {boolean} [options.load=true] 是否从磁盘加载既有账本。
|
||
* @param {string} [options.presetId] 部门会话显式使用的 agentPreset;缺省不指定,走宿主默认创建流程。
|
||
* @param {boolean} [options.startReconciler=true] 是否启动周期对账。
|
||
* @param {number} [options.longPollMs] 事件长轮询上限(毫秒)。
|
||
* @param {number} [options.pollIntervalMs] 长轮询内部检查间隔(毫秒)。
|
||
* @returns {object} 见文件末尾 return 语句的字段说明。
|
||
*/
|
||
export function createWorkbenchHost(ctx, options = {}) {
|
||
const env = options.env ?? process.env
|
||
const clock = options.clock ?? Date.now
|
||
const file = options.file === undefined ? resolveStorePath(env) : options.file
|
||
const warnings = []
|
||
const log = typeof options.log === 'function' ? options.log : () => {}
|
||
|
||
// 测试与嵌入场景可以自带账本;自带时不碰磁盘路径,也不做损坏隔离(那是文件的责任)。
|
||
const injectedStore = options.store ?? null
|
||
const store = injectedStore ?? new WorkbenchStore({
|
||
file,
|
||
clock,
|
||
env,
|
||
...(options.random === undefined ? {} : { random: options.random }),
|
||
})
|
||
|
||
if (injectedStore === null && options.load !== false && file !== null && file !== '') {
|
||
ensureSidecarDir(env)
|
||
if (existsSync(file)) {
|
||
try {
|
||
store.load()
|
||
} catch (error) {
|
||
// 损坏与版本不符都是“这个文件不能用”:改名留存后从空账本启动。
|
||
// 绝不覆盖原文件——里面可能是用户唯一一份历史。
|
||
const stamp = new Date(clock()).toISOString().replace(/[:.]/g, '-')
|
||
let quarantined = corruptPathFor(file, stamp)
|
||
try {
|
||
renameSync(file, quarantined)
|
||
} catch (renameError) {
|
||
// 改名失败(被占用/权限不足):不能继续往同一个文件写,退回纯内存账本。
|
||
quarantined = null
|
||
warnings.push(
|
||
`账本损坏且无法改名留存(${renameError?.code ?? 'UNKNOWN'}):${error?.message ?? ''};本次使用内存账本`,
|
||
)
|
||
}
|
||
if (quarantined !== null) {
|
||
warnings.push(
|
||
`账本损坏(${error?.code ?? 'ERROR'}:${error?.message ?? ''}),已改名留存为 ${quarantined},以空账本启动`,
|
||
)
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
// 外壳持有 store 与 service,并在宿主有能力时装配会话层/派发/对账。
|
||
const shell = createWorkbenchShell(ctx, {
|
||
store,
|
||
presetId: options.presetId,
|
||
startReconciler: options.startReconciler,
|
||
clock,
|
||
// 成果文件是否还在,由宿主文件系统回答(A23 失效显示);测试可注入替身。
|
||
fileExists: options.fileExists ?? existsSync,
|
||
})
|
||
const service = shell.service
|
||
|
||
const hooks = routeHooks(shell, service)
|
||
let routes = registerWorkbenchRoutes(ctx, service, { ...options, ...hooks })
|
||
let registered = routes.registered !== false
|
||
if (!registered) warnings.push(`工作台接口未注册:${routes.reason ?? '宿主未提供 webServer'}`)
|
||
|
||
// 宿主稍后才提供 webServer 时补注册一次;cordis 会在依赖出现时回调,
|
||
// 插件卸载时随作用域一起清理,不需要手工跟踪。
|
||
if (!registered && ctx !== null && typeof ctx?.inject === 'function') {
|
||
try {
|
||
ctx.inject(['webServer'], (scoped) => {
|
||
if (registered) return
|
||
const late = registerWorkbenchRoutes({ webServer: scoped?.webServer }, service, { ...options, ...hooks })
|
||
if (late.registered === false) return
|
||
routes = late
|
||
registered = true
|
||
})
|
||
} catch (error) {
|
||
warnings.push(`工作台接口补注册失败:${error?.message ?? error}`)
|
||
}
|
||
}
|
||
|
||
// 会话层也可能晚到:apply 时 sessionController 还没装好,等它出现再挂载一次,
|
||
// 这样用户不必为了「接通部门」而多重启一次 DSH。
|
||
if (shell.hasSessions === false && ctx !== null && typeof ctx?.inject === 'function') {
|
||
try {
|
||
ctx.inject(['sessionController'], (scoped) => {
|
||
if (shell.hasSessions === true) return
|
||
const controller = scoped?.sessionController ?? scoped?.remote?.session ?? null
|
||
if (controller === null) return
|
||
if (!shell.attachSessions(controller)) return
|
||
log('[sansheng-liubo] 会话层已就绪,部门可以接通与派发')
|
||
})
|
||
} catch (error) {
|
||
warnings.push(`会话层补挂失败:${error?.message ?? error}`)
|
||
}
|
||
}
|
||
|
||
shell.start()
|
||
|
||
const dispose = () => {
|
||
try {
|
||
routes()
|
||
} finally {
|
||
shell.dispose()
|
||
}
|
||
}
|
||
|
||
return {
|
||
store,
|
||
service,
|
||
shell,
|
||
routes,
|
||
get sessions() {
|
||
return shell.sessions
|
||
},
|
||
get reconciler() {
|
||
return shell.reconciler
|
||
},
|
||
get dispatchService() {
|
||
return shell.dispatchService
|
||
},
|
||
get hasSessions() {
|
||
return shell.hasSessions
|
||
},
|
||
attachSessions: shell.attachSessions,
|
||
presetId: shell.presetId,
|
||
connectDepartment: shell.connectDepartment,
|
||
dispatchTask: shell.dispatchTask,
|
||
ingestAgentOutput: shell.ingestAgentOutput,
|
||
file: store.file,
|
||
sidecarDir: resolveSidecarDir(env),
|
||
get registered() {
|
||
return registered
|
||
},
|
||
warning: warnings.length === 0 ? null : warnings.join(';'),
|
||
warnings,
|
||
/** 卸载路由与后台服务(幂等);账本不删除,下次启动继续用。 */
|
||
dispose,
|
||
schemaVersion: SCHEMA_VERSION,
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 路由钩子:只有宿主真有能力时才接管,否则让路由退回“只落账”的保守路径。
|
||
* 这样“没接通”永远不会被伪装成“已发送”。
|
||
*/
|
||
function routeHooks(shell, service) {
|
||
return {
|
||
connect: (input) => shell.connectDepartment(input),
|
||
ingest: (input) => shell.ingestAgentOutput(input),
|
||
// 会话层可能晚到,所以钩子恒挂:真挂上了就走派发,没挂上就退回「只落账」,
|
||
// 绝不把「没接通」伪装成「已发送」。
|
||
dispatch: (input) => {
|
||
if (shell.hasSessions === true) return shell.dispatchTask(input)
|
||
return service.dispatchTask({
|
||
projectId: input.projectId,
|
||
taskId: input.taskId,
|
||
idempotencyKey: input.idempotencyKey,
|
||
sourceRoleId: input.sourceRoleId,
|
||
targetRoleId: input.targetRoleId,
|
||
targetSessionId: input.targetSessionId,
|
||
bindingGeneration: input.bindingGeneration,
|
||
packet: input.packet,
|
||
})
|
||
},
|
||
}
|
||
}
|
||
|
||
export default createWorkbenchHost
|