@capyclaw/ppt-workbench 2.4.0 → 2.4.1

package/package.json

@@ -1,53 +1,53 @@
-{
-  "name": "@capyclaw/ppt-workbench",
-  "version": "2.4.0",
-  "description": "PPT 工作台运行时：27 个 ppt_* MCP 工具（导入/导出 PPTX + 图表/表格/公式/形状/线条/备注 + 契约探测）+ 本机实时 PPTist 编辑器。",
-  "type": "module",
-  "main": "./lib/host.mjs",
-  "exports": {
-    ".": "./lib/host.mjs",
-    "./package.json": "./package.json"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "capabilities": {
-      "source": "server/tools/capabilities",
-      "manifest": "capabilities.json"
-    }
-  },
-  "meta": {
-    "title": "PPT 工作台运行时",
-    "description": "AI 生成/编辑 PPT：27 个 ppt_* 工具 + 浏览器实时编辑器（http://127.0.0.1:39311/）"
-  },
-  "files": [
-    "lib/",
-    "server/",
-    "core/",
-    "!server/.relay-instance.lock",
-    "editor/",
-    "contract/",
-    "cordis.patch.yml",
-    "README.md",
-    "THIRD_PARTY_NOTICES.md"
-  ],
-  "license": "AGPL-3.0-or-later",
-  "dependencies": {
-    "dsh-document-workbench": "^0.1.0",
-    "pptxgenjs": "^3.12.0"
-  },
-  "author": {
-    "name": "CapyClaw",
-    "url": "https://github.com/capyclaw",
-    "email": "support@capyclaw.dev"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/capyclaw/dsh-plugins"
-  },
-  "bugs": {
-    "url": "https://github.com/capyclaw/dsh-plugins/issues"
-  },
-  "homepage": "https://github.com/capyclaw/dsh-plugins"
-}
+{
+  "name": "@capyclaw/ppt-workbench",
+  "version": "2.4.1",
+  "description": "PPT 工作台运行时：27 个 ppt_* MCP 工具（导入/导出 PPTX + 图表/表格/公式/形状/线条/备注 + 契约探测）+ 本机实时 PPTist 编辑器。",
+  "type": "module",
+  "main": "./lib/host.mjs",
+  "exports": {
+    ".": "./lib/host.mjs",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "capabilities": {
+      "source": "server/tools/capabilities",
+      "manifest": "capabilities.json"
+    }
+  },
+  "meta": {
+    "title": "PPT 工作台运行时",
+    "description": "AI 生成/编辑 PPT：27 个 ppt_* 工具 + 浏览器实时编辑器（http://127.0.0.1:39311/）"
+  },
+  "files": [
+    "lib/",
+    "server/",
+    "core/",
+    "!server/.relay-instance.lock",
+    "editor/",
+    "contract/",
+    "cordis.patch.yml",
+    "README.md",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "license": "AGPL-3.0-or-later",
+  "dependencies": {
+    "pptxgenjs": "^3.12.0",
+    "@capyclaw/document-workbench": "^0.1.0"
+  },
+  "author": {
+    "name": "CapyClaw",
+    "url": "https://github.com/capyclaw",
+    "email": "support@capyclaw.dev"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/capyclaw/dsh-plugins"
+  },
+  "bugs": {
+    "url": "https://github.com/capyclaw/dsh-plugins/issues"
+  },
+  "homepage": "https://github.com/capyclaw/dsh-plugins"
+}

package/server/http-utils.mjs

@@ -1,2 +1,2 @@
-/** 兼容入口：HTTP 传输实现统一来自 dsh-plugin-kit 的构建快照。 */
-export * from './infra/http.mjs'
+/** 兼容入口：HTTP 传输实现统一来自 @capyclaw/plugin-kit 的构建快照。 */
+export * from './infra/http.mjs'

package/server/infra/tuning.mjs

@@ -1,82 +1,82 @@
-/**
- * dsh-plugin-kit 运行时调优层。
- *
- * 默认值与进化搜索（evolution/ NSGA-II）的 founder 基线保持一致；
- * 生产环境可用 DSH_TUNING_JSON 覆盖（按包名分组），测试/评估用 setTuning 注入。
- *
- * DSH_TUNING_JSON 形如：
- *   {"dsh-plugin-kit": {"fileLockPollMs": 25, "journalMaxBytes": 2097152}}
- */
-
-const DEFAULTS = {
-  /* fs-lock：元数据文件锁
-   * pollMs=10 由 NSGA-II 进化搜索固化（evolution/，2026-11-01）：
-   * 24 路竞争延迟 2202→1400ms；10ms 为延迟与轮询 IO 的膝点。 */
-  fileLockSyncTimeoutMs: 10000,
-  fileLockSyncStaleMs: 30000,
-  fileLockAsyncTimeoutMs: 30000,
-  fileLockPollMs: 10,
-  fileLockFreshGraceMs: 2000,
-
-  /* 编辑器租约：wait() 轮询节奏 */
-  leaseWaitPollMs: 200,
-  leaseWaitTimeoutMs: 4000,
-
-  /* JournalStore：journal 轮转阈值与尾读默认行数
-   * 512KB 由进化搜索固化：尾读 p95 4.3→1.9ms、磁盘 -70%、追加吞吐 +8%。 */
-  journalMaxBytes: 512 * 1024,
-  journalTailLimit: 8,
-
-  /* WorkspaceManager catalog 写节流（降低全局 catalog 锁竞争） */
-  catalogThrottleMs: 5000,
-
-  /* WorkspaceClient token 校验缓存 */
-  tokenVerifyCacheMs: 30000,
-
-  /* HTTP 服务三级超时（keepAliveTimeoutMs 必须小于 headersTimeoutMs） */
-  requestTimeoutMs: 30000,
-  headersTimeoutMs: 10000,
-  keepAliveTimeoutMs: 5000,
-}
-
-let overrides = {}
-let envLoaded = false
-
-function loadEnv() {
-  if (envLoaded) return
-  envLoaded = true
-  try {
-    const raw = process.env.DSH_TUNING_JSON
-    if (!raw) return
-    const parsed = JSON.parse(raw)
-    if (!parsed || typeof parsed !== 'object') return
-    const own = parsed['dsh-plugin-kit'] && typeof parsed['dsh-plugin-kit'] === 'object'
-      ? parsed['dsh-plugin-kit']
-      : parsed
-    for (const key of Object.keys(DEFAULTS)) {
-      if (own[key] !== undefined) overrides[key] = own[key]
-    }
-  } catch { /* 非法 JSON 静默忽略：调优失败不能阻塞启动 */ }
-}
-
-/** 当前生效参数（默认值 + env + setTuning 覆盖）。 */
-export function tuning() {
-  loadEnv()
-  return { ...DEFAULTS, ...overrides }
-}
-
-/** 测试/评估注入。只接受已知键，避免拼写错误静默生效。 */
-export function setTuning(patch = {}) {
-  loadEnv()
-  for (const [key, value] of Object.entries(patch)) {
-    if (key in DEFAULTS) overrides[key] = value
-  }
-}
-
-/** 恢复到默认值 + env 覆盖。 */
-export function resetTuning() {
-  overrides = {}
-  envLoaded = false
-}
-
-export const TUNING_DEFAULTS = { ...DEFAULTS }
+/**
+ * @capyclaw/plugin-kit 运行时调优层。
+ *
+ * 默认值与进化搜索（evolution/ NSGA-II）的 founder 基线保持一致；
+ * 生产环境可用 DSH_TUNING_JSON 覆盖（按包名分组），测试/评估用 setTuning 注入。
+ *
+ * DSH_TUNING_JSON 形如：
+ *   {"@capyclaw/plugin-kit": {"fileLockPollMs": 25, "journalMaxBytes": 2097152}}
+ */
+
+const DEFAULTS = {
+  /* fs-lock：元数据文件锁
+   * pollMs=10 由 NSGA-II 进化搜索固化（evolution/，2026-11-01）：
+   * 24 路竞争延迟 2202→1400ms；10ms 为延迟与轮询 IO 的膝点。 */
+  fileLockSyncTimeoutMs: 10000,
+  fileLockSyncStaleMs: 30000,
+  fileLockAsyncTimeoutMs: 30000,
+  fileLockPollMs: 10,
+  fileLockFreshGraceMs: 2000,
+
+  /* 编辑器租约：wait() 轮询节奏 */
+  leaseWaitPollMs: 200,
+  leaseWaitTimeoutMs: 4000,
+
+  /* JournalStore：journal 轮转阈值与尾读默认行数
+   * 512KB 由进化搜索固化：尾读 p95 4.3→1.9ms、磁盘 -70%、追加吞吐 +8%。 */
+  journalMaxBytes: 512 * 1024,
+  journalTailLimit: 8,
+
+  /* WorkspaceManager catalog 写节流（降低全局 catalog 锁竞争） */
+  catalogThrottleMs: 5000,
+
+  /* WorkspaceClient token 校验缓存 */
+  tokenVerifyCacheMs: 30000,
+
+  /* HTTP 服务三级超时（keepAliveTimeoutMs 必须小于 headersTimeoutMs） */
+  requestTimeoutMs: 30000,
+  headersTimeoutMs: 10000,
+  keepAliveTimeoutMs: 5000,
+}
+
+let overrides = {}
+let envLoaded = false
+
+function loadEnv() {
+  if (envLoaded) return
+  envLoaded = true
+  try {
+    const raw = process.env.DSH_TUNING_JSON
+    if (!raw) return
+    const parsed = JSON.parse(raw)
+    if (!parsed || typeof parsed !== 'object') return
+    const own = parsed['@capyclaw/plugin-kit'] && typeof parsed['@capyclaw/plugin-kit'] === 'object'
+      ? parsed['@capyclaw/plugin-kit']
+      : parsed
+    for (const key of Object.keys(DEFAULTS)) {
+      if (own[key] !== undefined) overrides[key] = own[key]
+    }
+  } catch { /* 非法 JSON 静默忽略：调优失败不能阻塞启动 */ }
+}
+
+/** 当前生效参数（默认值 + env + setTuning 覆盖）。 */
+export function tuning() {
+  loadEnv()
+  return { ...DEFAULTS, ...overrides }
+}
+
+/** 测试/评估注入。只接受已知键，避免拼写错误静默生效。 */
+export function setTuning(patch = {}) {
+  loadEnv()
+  for (const [key, value] of Object.entries(patch)) {
+    if (key in DEFAULTS) overrides[key] = value
+  }
+}
+
+/** 恢复到默认值 + env 覆盖。 */
+export function resetTuning() {
+  overrides = {}
+  envLoaded = false
+}
+
+export const TUNING_DEFAULTS = { ...DEFAULTS }

package/server/routes/bridge.mjs

@@ -1,47 +1,47 @@
-/**
- * PPT 桥端点：协议与路由由 dsh-document-workbench 提供，本文件只注入
- * PPT 的 deck 投影、VIEW_OPS 与 applyOp。
- */
-import { createDocumentBridge } from 'dsh-document-workbench/bridge'
-import { BASE_PATH, VIEW_OPS } from '../constants.mjs'
-import { getTuning } from '../tuning.mjs'
-import {
-  sanitizeAck, sanitizeClaim, sanitizePush, sanitizeShotResult, sanitizeState,
-} from '../store.mjs'
-
-export function createBridgeRoutes({ store, jsonP, applyOp }) {
-  const tuning = getTuning()
-  return createDocumentBridge({
-    session: store,
-    basePath: BASE_PATH,
-    bridgeName: 'ppt-bridge',
-    documentKey: 'deck',
-    documentPath: '/deck',
-    authority: 'server',
-    apply: (cmd) => applyOp(jsonP, cmd),
-    isViewOp: (cmd) => VIEW_OPS.has(cmd.op),
-    sanitizers: {
-      sanitizeAck,
-      sanitizeClaim,
-      sanitizePush,
-      sanitizeShotResult,
-      sanitizeState,
-    },
-    bodyLimitBytes: Number(tuning.bodyLimitBytes) || 10 * 1024 * 1024,
-    watch: {
-      pollMs: tuning.watchPollMs,
-      timeoutSec: tuning.watchTimeoutSec,
-      maxTimeoutSec: tuning.watchTimeoutMaxSec,
-    },
-    projectStatus: (doc) => ({
-      bridge: 'ppt-workbench',
-      has_deck: !!(doc.deck && Array.isArray(doc.deck.slides) && doc.deck.slides.length),
-      slides: doc.deck && Array.isArray(doc.deck.slides) ? doc.deck.slides.length : 0,
-    }),
-    projectDocument: (doc) => ({
-      deck: doc.deck || {},
-      state_seq: doc.state_seq | 0,
-      applied_seq: doc.applied_seq | 0,
-    }),
-  }).routes
-}
+/**
+ * PPT 桥端点：协议与路由由 @capyclaw/document-workbench 提供，本文件只注入
+ * PPT 的 deck 投影、VIEW_OPS 与 applyOp。
+ */
+import { createDocumentBridge } from '@capyclaw/document-workbench/bridge'
+import { BASE_PATH, VIEW_OPS } from '../constants.mjs'
+import { getTuning } from '../tuning.mjs'
+import {
+  sanitizeAck, sanitizeClaim, sanitizePush, sanitizeShotResult, sanitizeState,
+} from '../store.mjs'
+
+export function createBridgeRoutes({ store, jsonP, applyOp }) {
+  const tuning = getTuning()
+  return createDocumentBridge({
+    session: store,
+    basePath: BASE_PATH,
+    bridgeName: 'ppt-bridge',
+    documentKey: 'deck',
+    documentPath: '/deck',
+    authority: 'server',
+    apply: (cmd) => applyOp(jsonP, cmd),
+    isViewOp: (cmd) => VIEW_OPS.has(cmd.op),
+    sanitizers: {
+      sanitizeAck,
+      sanitizeClaim,
+      sanitizePush,
+      sanitizeShotResult,
+      sanitizeState,
+    },
+    bodyLimitBytes: Number(tuning.bodyLimitBytes) || 10 * 1024 * 1024,
+    watch: {
+      pollMs: tuning.watchPollMs,
+      timeoutSec: tuning.watchTimeoutSec,
+      maxTimeoutSec: tuning.watchTimeoutMaxSec,
+    },
+    projectStatus: (doc) => ({
+      bridge: 'ppt-workbench',
+      has_deck: !!(doc.deck && Array.isArray(doc.deck.slides) && doc.deck.slides.length),
+      slides: doc.deck && Array.isArray(doc.deck.slides) ? doc.deck.slides.length : 0,
+    }),
+    projectDocument: (doc) => ({
+      deck: doc.deck || {},
+      state_seq: doc.state_seq | 0,
+      applied_seq: doc.applied_seq | 0,
+    }),
+  }).routes
+}

package/server/runtime/watch.mjs

@@ -1,17 +1,17 @@
-/** 兼容层：长轮询的通用实现位于 dsh-document-workbench/session。 */
-import { watchSession } from 'dsh-document-workbench/session'
-import { getTuning } from '../tuning.mjs'
-
-export function watchDoc(store, seq0, shot0, ui0, timeoutS, aborted) {
-  const tuning = getTuning()
-  return watchSession(store, {
-    seq: seq0,
-    shot: shot0,
-    ui: ui0,
-    timeoutS,
-    isAborted: aborted,
-    pollMs: tuning.watchPollMs,
-    timeoutSec: tuning.watchTimeoutSec,
-    maxTimeoutSec: tuning.watchTimeoutMaxSec,
-  })
-}
+/** 兼容层：长轮询的通用实现位于 @capyclaw/document-workbench/session。 */
+import { watchSession } from '@capyclaw/document-workbench/session'
+import { getTuning } from '../tuning.mjs'
+
+export function watchDoc(store, seq0, shot0, ui0, timeoutS, aborted) {
+  const tuning = getTuning()
+  return watchSession(store, {
+    seq: seq0,
+    shot: shot0,
+    ui: ui0,
+    timeoutS,
+    isAborted: aborted,
+    pollMs: tuning.watchPollMs,
+    timeoutSec: tuning.watchTimeoutSec,
+    maxTimeoutSec: tuning.watchTimeoutMaxSec,
+  })
+}

package/server/shared/editor-host.mjs

@@ -1,125 +1,125 @@
-/**
- * dsh-editor-host —— 通用浏览器编辑器宿主。
- *
- * 功能插件只提供 editor/ 静态目录，不再自己写：
- *   - 静态文件路由 / content-type / 404
- *   - “显示即连接”的租约仲裁（后打开者抢占，旧窗口静默待命）
- *   - claim / release / status / heartbeat 端点
- *   - 连接状态供 /healthz 使用
- *
- * 浏览器端可直接使用 dsh-plugin-kit 的 editor/lease.mjs（无 Node 依赖）。
- */
-import fs from 'node:fs'
-import path from 'node:path'
-import { createEditorLease } from './kit/editor/lease.mjs'
-import { send, readBody } from './kit/service/http.mjs'
-import { createServiceApi } from './kit/service/api.mjs'
-
-const MIME = {
-  '.html': 'text/html; charset=utf-8',
-  '.js': 'text/javascript; charset=utf-8',
-  '.mjs': 'text/javascript; charset=utf-8',
-  '.css': 'text/css; charset=utf-8',
-  '.json': 'application/json; charset=utf-8',
-  '.svg': 'image/svg+xml',
-  '.png': 'image/png',
-  '.jpg': 'image/jpeg',
-  '.jpeg': 'image/jpeg',
-  '.webp': 'image/webp',
-  '.woff2': 'font/woff2',
-}
-
-function safeJoin(root, rel) {
-  const target = path.resolve(root, `.${path.sep}${rel}`)
-  const base = path.resolve(root)
-  return target === base || target.startsWith(base + path.sep) ? target : null
-}
-
-function contentType(file) {
-  return MIME[path.extname(file).toLowerCase()] || 'application/octet-stream'
-}
-
-/**
- * @param {{ id: string, dir: string, basePath?: string, index?: string, files?: Record<string,string|string[]> }} options
- */
-export function createEditorHost({ id, dir, basePath = '', index = 'index.html', files = null } = {}) {
-  if (!id) throw new Error('createEditorHost: id 必填')
-  const prefix = basePath === '/' ? '' : String(basePath || '').replace(/\/+$/, '')
-  const lease = createEditorLease()
-
-  const staticRoutes = async function editorStatic(req, res, u) {
-    if (req.method !== 'GET' && req.method !== 'HEAD') return false
-    if (prefix && u.pathname !== prefix && !u.pathname.startsWith(prefix + '/')) return false
-    const relRaw = prefix ? u.pathname.slice(prefix.length) : u.pathname
-    const rel = relRaw === '' || relRaw === '/' ? index : decodeURIComponent(relRaw.replace(/^\/+/, ''))
-    let file = null
-    if (files) {
-      const hit = files[relRaw === '' ? '/' : relRaw] || files[relRaw]
-      if (!hit) return false
-      const name = Array.isArray(hit) ? hit[0] : hit
-      file = safeJoin(dir, name)
-    } else {
-      file = safeJoin(dir, rel)
-    }
-    if (!file) return false
-    try {
-      const data = fs.readFileSync(file)
-      res.writeHead(200, {
-        'content-type': contentType(file),
-        'content-length': data.length,
-        'x-content-type-options': 'nosniff',
-        'referrer-policy': 'no-referrer',
-        'cache-control': 'no-cache',
-      })
-      res.end(req.method === 'HEAD' ? undefined : data)
-      return true
-    } catch {
-      return false
-    }
-  }
-
-  const leaseRoutes = async function editorLeaseRoutes(req, res, u) {
-    const claimPath = `${prefix}/claim`
-    const releasePath = `${prefix}/release`
-    const statusPath = `${prefix}/status`
-    if (u.pathname === claimPath && req.method === 'POST') {
-      const body = await readBody(req)
-      const result = lease.claim(String(body.id || ''), !!body.force)
-      send(req, res, result.ok ? 200 : 409, result)
-      return true
-    }
-    if (u.pathname === releasePath && req.method === 'POST') {
-      const body = await readBody(req)
-      send(req, res, 200, lease.release(String(body.id || '')))
-      return true
-    }
-    if (u.pathname === statusPath && req.method === 'GET') {
-      send(req, res, 200, { ok: true, connected: lease.isLive(), lease: lease.status() })
-      return true
-    }
-    return false
-  }
-
-  return {
-    id,
-    lease,
-    routes() {
-      return [staticRoutes, leaseRoutes]
-    },
-    staticRoutes,
-    leaseRoutes,
-    status() {
-      return { connected: lease.isLive(), lease: lease.status() }
-    },
-  }
-}
-
-export function createEditorHostService(config = {}) {
-  return {
-    api: createServiceApi('editorHost', '1.0.0', ['static', 'lease', 'heartbeat', 'status']),
-    version: '0.1.0',
-    createEditorHost,
-    createLease: createEditorLease,
-    defaultHost: config.dir ? createEditorHost({ id: config.id || 'editor', ...config }) : null,
-  }
-}
+/**
+ * dsh-editor-host —— 通用浏览器编辑器宿主。
+ *
+ * 功能插件只提供 editor/ 静态目录，不再自己写：
+ *   - 静态文件路由 / content-type / 404
+ *   - “显示即连接”的租约仲裁（后打开者抢占，旧窗口静默待命）
+ *   - claim / release / status / heartbeat 端点
+ *   - 连接状态供 /healthz 使用
+ *
+ * 浏览器端可直接使用 @capyclaw/plugin-kit 的 editor/lease.mjs（无 Node 依赖）。
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { createEditorLease } from './kit/editor/lease.mjs'
+import { send, readBody } from './kit/service/http.mjs'
+import { createServiceApi } from './kit/service/api.mjs'
+
+const MIME = {
+  '.html': 'text/html; charset=utf-8',
+  '.js': 'text/javascript; charset=utf-8',
+  '.mjs': 'text/javascript; charset=utf-8',
+  '.css': 'text/css; charset=utf-8',
+  '.json': 'application/json; charset=utf-8',
+  '.svg': 'image/svg+xml',
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.webp': 'image/webp',
+  '.woff2': 'font/woff2',
+}
+
+function safeJoin(root, rel) {
+  const target = path.resolve(root, `.${path.sep}${rel}`)
+  const base = path.resolve(root)
+  return target === base || target.startsWith(base + path.sep) ? target : null
+}
+
+function contentType(file) {
+  return MIME[path.extname(file).toLowerCase()] || 'application/octet-stream'
+}
+
+/**
+ * @param {{ id: string, dir: string, basePath?: string, index?: string, files?: Record<string,string|string[]> }} options
+ */
+export function createEditorHost({ id, dir, basePath = '', index = 'index.html', files = null } = {}) {
+  if (!id) throw new Error('createEditorHost: id 必填')
+  const prefix = basePath === '/' ? '' : String(basePath || '').replace(/\/+$/, '')
+  const lease = createEditorLease()
+
+  const staticRoutes = async function editorStatic(req, res, u) {
+    if (req.method !== 'GET' && req.method !== 'HEAD') return false
+    if (prefix && u.pathname !== prefix && !u.pathname.startsWith(prefix + '/')) return false
+    const relRaw = prefix ? u.pathname.slice(prefix.length) : u.pathname
+    const rel = relRaw === '' || relRaw === '/' ? index : decodeURIComponent(relRaw.replace(/^\/+/, ''))
+    let file = null
+    if (files) {
+      const hit = files[relRaw === '' ? '/' : relRaw] || files[relRaw]
+      if (!hit) return false
+      const name = Array.isArray(hit) ? hit[0] : hit
+      file = safeJoin(dir, name)
+    } else {
+      file = safeJoin(dir, rel)
+    }
+    if (!file) return false
+    try {
+      const data = fs.readFileSync(file)
+      res.writeHead(200, {
+        'content-type': contentType(file),
+        'content-length': data.length,
+        'x-content-type-options': 'nosniff',
+        'referrer-policy': 'no-referrer',
+        'cache-control': 'no-cache',
+      })
+      res.end(req.method === 'HEAD' ? undefined : data)
+      return true
+    } catch {
+      return false
+    }
+  }
+
+  const leaseRoutes = async function editorLeaseRoutes(req, res, u) {
+    const claimPath = `${prefix}/claim`
+    const releasePath = `${prefix}/release`
+    const statusPath = `${prefix}/status`
+    if (u.pathname === claimPath && req.method === 'POST') {
+      const body = await readBody(req)
+      const result = lease.claim(String(body.id || ''), !!body.force)
+      send(req, res, result.ok ? 200 : 409, result)
+      return true
+    }
+    if (u.pathname === releasePath && req.method === 'POST') {
+      const body = await readBody(req)
+      send(req, res, 200, lease.release(String(body.id || '')))
+      return true
+    }
+    if (u.pathname === statusPath && req.method === 'GET') {
+      send(req, res, 200, { ok: true, connected: lease.isLive(), lease: lease.status() })
+      return true
+    }
+    return false
+  }
+
+  return {
+    id,
+    lease,
+    routes() {
+      return [staticRoutes, leaseRoutes]
+    },
+    staticRoutes,
+    leaseRoutes,
+    status() {
+      return { connected: lease.isLive(), lease: lease.status() }
+    },
+  }
+}
+
+export function createEditorHostService(config = {}) {
+  return {
+    api: createServiceApi('editorHost', '1.0.0', ['static', 'lease', 'heartbeat', 'status']),
+    version: '0.1.0',
+    createEditorHost,
+    createLease: createEditorLease,
+    defaultHost: config.dir ? createEditorHost({ id: config.id || 'editor', ...config }) : null,
+  }
+}