329 lines
13 KiB
JavaScript
329 lines
13 KiB
JavaScript
// 工作台 Host 外壳:把 store + service + 适配层 + 两个后台服务组装成一个可挂载组件。
|
||
//
|
||
// 挂载方式(index.js 里):
|
||
// const host = createWorkbenchHost(ctx, { store, presetId })
|
||
// ctx.effect(() => () => host.dispose(), 'sansheng-liubo: workbench')
|
||
//
|
||
// 能力探测优先:宿主没有 sessionController 时,工作台仍然能读写账本(投影可用),
|
||
// 但任何“派发/接通”都返回 NO_SESSION_CONTROLLER,UI 显示“尚未接通”,绝不假装成功。
|
||
|
||
import { join } from 'node:path'
|
||
import { WorkbenchStore, defaultStorePath } from '../core/store.mjs'
|
||
import { createMemoryStore } from '../core/memory.mjs'
|
||
import { resolveSidecarDir } from './paths.mjs'
|
||
import { createWorkbenchService } from './service.mjs'
|
||
import { createSessionAdapter } from './session-adapter.mjs'
|
||
import { createDispatchService } from './dispatch-service.mjs'
|
||
import { createReconciler } from './reconciler.mjs'
|
||
import { CONTRACT_ACTIONS, CONTRACT_ACTION_PREFIX, parseContractLines, describeContract } from './contract.mjs'
|
||
|
||
export const WORKBENCH_HOST_VERSION = 1
|
||
|
||
/**
|
||
* @param {object} ctx Host 插件上下文(cordis Context)
|
||
* @param {object} [options]
|
||
* @param {object} [options.store] 已有 store(测试注入);缺省按环境建一个。
|
||
* @param {object} [options.service] 已有 service;缺省按 store 新建。给了 service 就必须同时给 store,
|
||
* 否则两边的账不是同一本。
|
||
* @param {string} [options.presetId] 部门会话显式使用的 agentPreset;缺省不指定,走宿主默认创建流程。
|
||
* @param {boolean} [options.startReconciler] 是否启动周期对账,默认 true。
|
||
*/
|
||
export function createWorkbenchHost(ctx, options = {}) {
|
||
const log = (message) => {
|
||
try {
|
||
ctx?.logger?.info?.(message)
|
||
} catch {
|
||
/* 日志失败不能影响业务 */
|
||
}
|
||
}
|
||
|
||
const store = options.store ?? createStore(options)
|
||
// 记忆层:默认落在侧车目录的 memory/ 下(惰性读写,装配本身不碰磁盘);
|
||
// 测试可注入 options.memory,用 null 明确关掉。
|
||
const memory = options.memory === null
|
||
? null
|
||
: (options.memory ?? createMemoryStore({ dir: join(resolveSidecarDir(options.env ?? process.env), 'memory'), clock: options.clock }))
|
||
const service = options.service ?? createWorkbenchService({ store, clock: options.clock, fileExists: options.fileExists, memory })
|
||
|
||
// 会话层是可选能力:宿主没有 sessionController(或版本不提供)时整体降级。
|
||
// 注意 apply 时宿主可能还没把 sessionController 装好,所以这里只是「尝试挂载」,
|
||
// 真正的挂载动作集中在 mountSessions,宿主晚到时由 attachSessions 再补一次。
|
||
let sessions = null
|
||
let dispatchService = null
|
||
let reconciler = null
|
||
let hasSessions = false
|
||
let started = false
|
||
|
||
function mountSessions(controller) {
|
||
const usable = controller !== null && typeof controller?.prompt === 'function'
|
||
if (!usable) return false
|
||
if (sessions !== null) return true
|
||
try {
|
||
sessions = createSessionAdapter({ sessionController: controller, log })
|
||
} catch (error) {
|
||
log(`[sansheng-liubo] 会话层不可用:${error?.message ?? error}`)
|
||
sessions = null
|
||
return false
|
||
}
|
||
dispatchService = createDispatchService({ store, service, sessions, log, applyModelToSessions: options.applyModelToSessions === true })
|
||
reconciler = createReconciler({ store, service, sessions, log })
|
||
hasSessions = true
|
||
if (started && options.startReconciler !== false) reconciler.start()
|
||
followBoundSessions()
|
||
return true
|
||
}
|
||
|
||
/**
|
||
* 订阅一个部门会话。subscribe 失败与正常结束分开处理:
|
||
* - 正常结束/主动取消只记日志;
|
||
* - 订阅失败把该绑定标成 unavailable,界面会显示“绑定失效,需重新接通”,
|
||
* 而不是让用户对着一个永远不更新的会话猜。
|
||
*/
|
||
function followSession(sessionId) {
|
||
if (sessions === null || typeof sessionId !== 'string' || sessionId === '') return
|
||
try {
|
||
sessions.follow(sessionId, {
|
||
onFrame: (frame) => {
|
||
if (reconciler !== null) {
|
||
void Promise.resolve(reconciler.onSessionFrame({ sessionId })).catch((error) => {
|
||
log(`[sansheng-liubo] 帧事件对账失败:${error?.message ?? error}`)
|
||
})
|
||
}
|
||
void frame
|
||
},
|
||
onError: (failure) => {
|
||
log(`[sansheng-liubo] 会话 ${failure.sessionId} 订阅失败(${failure.code}):${failure.message}`)
|
||
markSessionUnavailable(failure.sessionId, failure.message)
|
||
},
|
||
})
|
||
} catch (error) {
|
||
const code = error?.code ?? 'UNKNOWN'
|
||
log(`[sansheng-liubo] 无法订阅会话 ${sessionId}(${code}):${error?.message ?? error}`)
|
||
// 宿主没有 follow 能力是“功能缺席”,不是绑定失效:不要因此标坏部门。
|
||
if (code !== 'NO_FOLLOW') markSessionUnavailable(sessionId, error?.message ?? String(error))
|
||
}
|
||
}
|
||
|
||
/** 找到持有该会话的项目/席位,并把绑定状态标成 unavailable。 */
|
||
function markSessionUnavailable(sessionId, reason) {
|
||
if (typeof sessionId !== 'string' || sessionId === '') return
|
||
for (const project of store.listProjects()) {
|
||
let seats = []
|
||
try {
|
||
seats = service.listSeats(project.id)
|
||
} catch {
|
||
continue
|
||
}
|
||
for (const seat of seats) {
|
||
const binding = store.getBinding(project.id, seat.roleId)
|
||
if (binding?.currentSessionId !== sessionId) continue
|
||
try {
|
||
service.setDepartmentStatus({ projectId: project.id, roleId: seat.roleId, status: 'unavailable' })
|
||
} catch (error) {
|
||
log(`[sansheng-liubo] 标记 ${seat.roleId} 订阅失败状态被拒:${error?.message ?? error}`)
|
||
}
|
||
log(`[sansheng-liubo] 部门 ${seat.roleId} 的会话订阅失败:${reason ?? 'unknown'}`)
|
||
return
|
||
}
|
||
}
|
||
}
|
||
|
||
/** 会话层晚挂或重挂后,把账本里已有的部门绑定重新接上事件流。 */
|
||
function followBoundSessions() {
|
||
if (sessions === null) return 0
|
||
let count = 0
|
||
for (const project of store.listProjects()) {
|
||
for (const seat of service.listSeats(project.id)) {
|
||
const binding = store.getBinding(project.id, seat.roleId)
|
||
if (binding?.currentSessionId) {
|
||
followSession(binding.currentSessionId)
|
||
count += 1
|
||
}
|
||
}
|
||
}
|
||
if (count > 0) log(`[sansheng-liubo] 已恢复 ${count} 个部门会话订阅`)
|
||
return count
|
||
}
|
||
|
||
/** 宿主稍后才提供 sessionController 时补挂(不重启也能用)。返回是否挂上。 */
|
||
function attachSessions(controller) {
|
||
const mounted = mountSessions(controller ?? null)
|
||
if (!mounted) log('[sansheng-liubo] 会话控制器仍不可用,派发继续保持“只落账”')
|
||
return mounted
|
||
}
|
||
|
||
mountSessions(ctx?.sessionController ?? ctx?.remote?.session ?? null)
|
||
|
||
const presetId = typeof options.presetId === 'string' && options.presetId !== '' ? options.presetId : null
|
||
|
||
/**
|
||
* 显式预设先用宿主公开的 preset 名册校验;名册服务缺席时不假装能验,
|
||
* 交给 `sessionController.create` 返回它自己的 agent-preset/not-found。
|
||
*/
|
||
async function assertAgentPreset(agentPreset) {
|
||
if (typeof agentPreset !== 'string' || agentPreset.trim() === '') return
|
||
let presets = null
|
||
try {
|
||
presets = typeof ctx?.get === 'function' ? ctx.get('agentPresets') : ctx?.agentPresets
|
||
} catch {
|
||
presets = null
|
||
}
|
||
if (presets === null || presets === undefined || typeof presets.list !== 'function') return
|
||
let roster = null
|
||
try {
|
||
roster = await presets.list()
|
||
} catch (error) {
|
||
log(`[sansheng-liubo] 无法读取宿主预设名册:${error?.message ?? error}`)
|
||
return
|
||
}
|
||
if (!Array.isArray(roster)) return
|
||
if (!roster.some((row) => row?.id === agentPreset)) {
|
||
const error = new Error(`指定的预设“${agentPreset}”不存在或未启用`)
|
||
error.code = 'INVALID_INPUT'
|
||
throw error
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 接通某个部门的会话:已有绑定就直接用,没有就按 workspace 建一个并登记。
|
||
* 绑定替换由 store 的 bindSession 判定(allowReplace),账上和宿主保持一致。
|
||
*/
|
||
async function connectDepartment(input = {}) {
|
||
const projectId = requireText(input.projectId, 'projectId')
|
||
const roleId = requireText(input.roleId, 'roleId')
|
||
const project = store.getProject(projectId)
|
||
if (project === undefined) throw new Error('项目不存在')
|
||
if (sessions === null) {
|
||
throw new Error('宿主未提供会话能力,暂时无法接通部门(账本仍可读写)')
|
||
}
|
||
const binding = store.getBinding(projectId, roleId)
|
||
const existing = binding?.currentSessionId ?? null
|
||
if (existing !== null) {
|
||
const known = await sessions.inspectSession(existing)
|
||
if (known !== null) {
|
||
followSession(existing)
|
||
return { sessionId: existing, created: false, seat: seatOf(projectId, roleId) }
|
||
}
|
||
}
|
||
const requestedPreset = input.agentPreset ?? presetId
|
||
await assertAgentPreset(requestedPreset)
|
||
const target = await sessions.ensureSession({
|
||
workspaceId: project?.hostWorkspaceId,
|
||
sessionId: input.sessionId ?? null,
|
||
agentPreset: requestedPreset,
|
||
})
|
||
// 账上登记:同一会话被别的部门占用时 store 会拒绝,正是我们要的“会话独占”。
|
||
const saved = service.bindDepartmentSession({
|
||
projectId,
|
||
roleId,
|
||
sessionId: target.sessionId,
|
||
allowReplace: existing !== null,
|
||
})
|
||
followSession(target.sessionId)
|
||
return { sessionId: target.sessionId, created: target.created === true, seat: saved.seat }
|
||
}
|
||
|
||
function seatOf(projectId, roleId) {
|
||
return service.listSeats(projectId).find((seat) => seat.roleId === roleId) ?? null
|
||
}
|
||
|
||
/** 派发(对 UI 的唯一入口)。没有会话层时返回明确错误,不假装已发送。 */
|
||
async function dispatchTask(input = {}) {
|
||
if (dispatchService === null) {
|
||
return { ok: false, code: 'NO_SESSION_CONTROLLER', message: '宿主未提供会话能力,派发已停在工作台账内' }
|
||
}
|
||
return dispatchService.dispatch(input)
|
||
}
|
||
|
||
/** 处理部门输出里的契约行:只认结构化字段,解析失败的行原样返回给 UI 提示。 */
|
||
function ingestAgentOutput({ projectId, roleId, text } = {}) {
|
||
const parsed = parseContractLines(text)
|
||
const applied = []
|
||
const failed = []
|
||
for (const call of parsed.calls) {
|
||
try {
|
||
applied.push(applyContractCall({ projectId, roleId, call }))
|
||
} catch (error) {
|
||
failed.push({ action: call.action, code: error?.code ?? 'unknown', message: error?.message ?? String(error) })
|
||
}
|
||
}
|
||
return { applied, failed, invalid: parsed.invalid }
|
||
}
|
||
|
||
function applyContractCall({ projectId, roleId, call }) {
|
||
const payload = { ...call.payload, projectId }
|
||
switch (call.action) {
|
||
case 'dispatchTask':
|
||
if (payload.sourceRoleId === undefined) payload.sourceRoleId = roleId
|
||
return { action: call.action, result: service.dispatchTask(payload) }
|
||
case 'reportTaskResult':
|
||
return { action: call.action, result: service.reportTaskResult(payload) }
|
||
case 'requestTaskInput':
|
||
return { action: call.action, result: service.requestTaskInput(payload) }
|
||
case 'syncDecision':
|
||
return { action: call.action, result: service.syncDecision(payload) }
|
||
default:
|
||
throw new Error(`未知动作:${String(call.action)}`)
|
||
}
|
||
}
|
||
|
||
function start() {
|
||
if (started) return
|
||
started = true
|
||
if (options.startReconciler !== false && reconciler !== null) reconciler.start()
|
||
}
|
||
|
||
function dispose() {
|
||
if (reconciler !== null) reconciler.stop()
|
||
if (sessions !== null) sessions.dispose()
|
||
started = false
|
||
}
|
||
|
||
return Object.freeze({
|
||
version: WORKBENCH_HOST_VERSION,
|
||
store,
|
||
service,
|
||
memory,
|
||
// 会话层可能晚到:用 getter,调用方总能读到最新挂载结果。
|
||
get sessions() {
|
||
return sessions
|
||
},
|
||
get reconciler() {
|
||
return reconciler
|
||
},
|
||
get dispatchService() {
|
||
return dispatchService
|
||
},
|
||
get hasSessions() {
|
||
return hasSessions
|
||
},
|
||
attachSessions,
|
||
presetId,
|
||
connectDepartment,
|
||
dispatchTask,
|
||
ingestAgentOutput,
|
||
bootstrap: (projectId) => service.bootstrap(projectId),
|
||
listEvents: (projectId, since, opts) => service.listEvents(projectId, since, opts),
|
||
start,
|
||
dispose,
|
||
})
|
||
}
|
||
|
||
function createStore(options) {
|
||
const file = options.storeFile ?? defaultStorePath(process.env)
|
||
const store = new WorkbenchStore({ file })
|
||
try {
|
||
store.load()
|
||
} catch {
|
||
// 读到坏账本时不静默清空:由 paths.quarantineFile 在 HTTP 层隔离,这里保持空账可写。
|
||
}
|
||
return store
|
||
}
|
||
|
||
function requireText(value, field) {
|
||
if (typeof value !== 'string' || value.trim() === '') throw new Error(`${field} 必须是非空字符串`)
|
||
return value
|
||
}
|
||
|
||
export { CONTRACT_ACTIONS, CONTRACT_ACTION_PREFIX, parseContractLines, describeContract }
|