diff --git a/vendor/dsh-sansheng-liubu/workbench/host/workbench-host.mjs b/vendor/dsh-sansheng-liubu/workbench/host/workbench-host.mjs new file mode 100644 index 0000000..dcdb33a --- /dev/null +++ b/vendor/dsh-sansheng-liubu/workbench/host/workbench-host.mjs @@ -0,0 +1,221 @@ +// 工作台 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 }