dsh-sansheng-liubu/workbench/host/workbench-host.mjs

222 lines
8.9 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

// 工作台 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()
return true
}
/** 宿主稍后才提供 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 : 'sansheng-liubu'
/**
* 接通某个部门的会话:已有绑定就直接用,没有就按 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) return { sessionId: existing, created: false, seat: seatOf(projectId, roleId) }
}
const target = await sessions.ensureSession({
workspaceId: project?.hostWorkspaceId,
sessionId: input.sessionId ?? null,
agentPreset: input.agentPreset ?? presetId,
})
// 账上登记:同一会话被别的部门占用时 store 会拒绝,正是我们要的“会话独占”。
const saved = service.bindDepartmentSession({
projectId,
roleId,
sessionId: target.sessionId,
allowReplace: existing !== null,
})
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 }