@mokuyoaxis/dsh-iris 0.2.6 → 0.2.7

package/lib/dsh-core-adapter.js

@@ -6,7 +6,8 @@ import { runtimeProviders, assignments, irisHome, recordRateLimit, recordAvailab
 import { withDshProviderConfig } from './dsh-provider-config.js';
 import { createCommandService } from './command-service.js';
 import { createCoreArtifact, inspectCoreArtifact, listCoreArtifacts, listCoreArtifactMetadata, readCoreArtifactBytes } from './core-artifacts.js';
-import { createCoreRuntime } from './core-runtime.js';
+import { createApplicationRuntime } from './application-runtime.js';
+import { normalizeCoreOptions } from './core-contract.js';
 import { readSummaryFrames } from './summary-input.js';
 import { readVisionArtifact } from './vision-input.js';
 import { inspectCoreTask, listCoreTasks, recoverCoreTask } from './core-tasks.js';
@@ -19,18 +20,9 @@ import { parseModelRef } from './models.js';
 import { imageCandidatesFromCatalog, musicCandidatesFromCatalog, providerForTaskFromCatalog, providerTaskBinding, transcribeCandidatesFromCatalog, ttsCandidatesFromCatalog, videoCandidatesFromCatalog } from './provider-catalog.js';
 import { generateMusicTask } from './music-generation.js';
 
-let writerTail = Promise.resolve();
-const providerWatchers = new Map();
 const DEFAULT_POLL_INTERVAL_MS = 2500;
 const DEFAULT_MAX_WATCH_MS = 20 * 60 * 1000;
 const POLL_ERROR_TOLERANCE = 5;
-let providerHost = () => undefined;
-
-/** The Host supplies a fresh optional connection port; no credentials are retained here. */
-export function configureProviderHostForDsh(factory) {
-  providerHost = factory;
-  return () => { if (providerHost === factory) providerHost = () => undefined; };
-}
 
 function createConfiguredProviderAdapter(provider, options = {}) {
   return createProviderAdapter(provider, { ...options, onRateLimit: recordRateLimit, onModelAvailability: recordAvailability });
@@ -53,628 +45,730 @@ export function dshCoreDataRoot() {
   return path.join(irisHome(), 'core-v0');
 }
 
-async function withRuntime(mode, callback, signal) {
-  if (signal?.aborted) throw abortError();
-  const runtime = createCoreRuntime({ dataRoot: dshCoreDataRoot(), mode });
-  runtime.start();
-  const onAbort = () => { runtime.dispose().catch(() => {}); };
-  signal?.addEventListener('abort', onAbort, { once: true });
-  try { return await callback(runtime, mode === 'writer' ? createCommandService(runtime) : null); }
-  finally {
-    signal?.removeEventListener('abort', onAbort);
-    await runtime.dispose();
-  }
-}
-
-async function withWriter(callback, signal) {
-  const operation = writerTail.then(() => withRuntime('writer', callback, signal));
-  writerTail = operation.catch(() => {});
-  return operation;
-}
-
-function withReader(callback, signal) {
-  return withRuntime('reader', callback, signal);
-}
-
-/** 本地图片与会话附件都交给同一导入Command，不创建生成任务。 */
-export function importImageForDsh(input = {}) {
-  return withWriter((_runtime, commands) => commands.execute('artifact.import', input.imageBytes !== undefined
-    ? { image_bytes: input.imageBytes } : { image_path: input.imagePath }), input.signal);
-}
-
 /**
- * 将 DSH 图片输入投影到共享 crop Command，再把中性 Artifact 读成宿主可保存的字节。
- * bytes 输入先成为 host-input Artifact，输出通过 derived-from 保留关系。
+ * One plugin-owned DSH assembly. Construction performs no I/O; Core writes share the
+ * Application Runtime FIFO, while polling and foreign Host operations belong here.
  */
-export async function cropForDsh(input = {}) {
-  return withWriter(async (runtime, commands) => {
-    if (input.signal?.aborted) throw Object.assign(new Error('已取消'), { name: 'AbortError' });
-    let commandInput;
-    if (input.bytes !== undefined) {
-      const source = await runtime.run('execute', ({ dataRoot }) => createCoreArtifact(dataRoot, {
-        bytes: input.bytes,
-        mediaType: input.mediaType,
-        kind: 'host-input',
-        metadata: {}
-      }));
-      commandInput = { artifact_id: source.id };
-    } else {
-      commandInput = { image_path: input.imagePath };
-    }
-    Object.assign(commandInput, {
-      left: input.left,
-      top: input.top,
-      width: input.width,
-      height: input.height
-    });
-    const result = await commands.execute('crop', commandInput);
-    if (input.signal?.aborted) throw Object.assign(new Error('已取消'), { name: 'AbortError' });
-    const materialized = await runtime.run('inspect', ({ dataRoot }) =>
-      readCoreArtifactBytes(dataRoot, result.artifact.id));
-    return Object.freeze({
-      artifact: result.artifact,
-      bytes: materialized.bytes,
-      mediaType: result.artifact.mediaType,
-      width: result.artifact.metadata.width,
-      height: result.artifact.metadata.height
+export function createDshRuntime({ dataRoot: requestedRoot, getHost = () => undefined } = {}) {
+  const dataRoot = normalizeCoreOptions({ dataRoot: requestedRoot }).dataRoot;
+  if (typeof getHost !== 'function') throw new TypeError('getHost 必须是宿主端口工厂');
+  const application = createApplicationRuntime({ dataRoot });
+  const providerWatchers = new Map(), polls = new Set(), active = new Set();
+  const lifetime = new AbortController();
+  let state = 'open', disposal;
+
+  function accepting() { return state === 'open' && application.snapshot().state === 'open'; }
+  function closed() {
+    return Object.assign(new DshCoreAdapterError('IRIS_DSH_RUNTIME_CLOSED', 'Iris DSH 实例正在关闭或已关闭'), { statusCode: 503 });
+  }
+  function operationSignal(signal) {
+    return signal === undefined ? lifetime.signal : AbortSignal.any([signal, lifetime.signal]);
+  }
+  function track(value) {
+    const job = Promise.resolve(value);
+    active.add(job);
+    void job.then(() => active.delete(job), () => {
+      active.delete(job);
+      // The failed operation already reports cleanup failure; retain it for the owner too.
+      if (application.snapshot().cleanupFailed) void dispose().catch(() => {});
     });
-  }, input.signal);
-}
+    return job;
+  }
+  // Keep live ports by reference; snapshot only owned business inputs before enqueueing.
+  function ownedInput(input = {}) {
+    const { signal, browser, adapter, candidates, core: _owner, ...value } = input;
+    return { ...structuredClone(value),
+      ...(browser !== undefined ? { browser } : {}),
+      ...(adapter !== undefined ? { adapter } : {}),
+      ...(candidates !== undefined ? { candidates: candidates.map(({ adapter, prepareInput, ...route }) => ({
+        ...structuredClone(route), adapter, ...(prepareInput !== undefined ? { prepareInput } : {})
+      })) } : {}), signal: operationSignal(signal) };
+  }
+  function invoke(fn, optionsIndex, args) {
+    if (!accepting()) return Promise.reject(closed());
+    try {
+      if (fn === maintainWorkbenchForDsh) args[1] = structuredClone(args[1]);
+      args[optionsIndex] = ownedInput(args[optionsIndex]);
+      args[optionsIndex].signal.throwIfAborted();
+      return track(fn(...args));
+    } catch (error) { return Promise.reject(error); }
+  }
+  function runHostOperation(action, { signal } = {}) {
+    if (!accepting()) return Promise.reject(closed());
+    const combined = operationSignal(signal);
+    try {
+      combined.throwIfAborted();
+      return track(action(combined));
+    } catch (error) { return Promise.reject(error); }
+  }
+  function snapshot() {
+    return Object.freeze({ state: accepting() ? 'open' : state === 'closed' ? 'closed' : 'closing',
+      watchers: providerWatchers.size, polls: polls.size, operations: active.size, application: application.snapshot() });
+  }
+  function dispose() {
+    if (disposal) return disposal;
+    state = 'closing'; lifetime.abort();
+    const stopped = stopProviderTaskWatchesForDsh();
+    const released = application.dispose();
+    disposal = (async () => {
+      await Promise.allSettled([...active, ...polls, stopped, released]);
+      await released;
+      state = 'closed';
+      return snapshot();
+    })();
+    return disposal;
+  }
 
-/** Browser 只提供截图字节；DSH/CLI 共用 HTML Command 和 Artifact 提交。 */
-export function htmlForDsh(input = {}) {
-  return withWriter(async runtime => {
-    const commands = createCommandService(runtime, { browser: input.browser });
-    const result = await commands.execute('media.html', { html: input.html, width: input.width,
-      height: input.height, full_page: input.fullPage });
-    return runtime.run('inspect', ({ dataRoot }) => readCoreArtifactBytes(dataRoot, result.artifact.id));
-  }, input.signal);
-}
+  function withRuntime(mode, callback, signal) {
+    return application.run(mode, runtime => callback(runtime,
+      mode === 'writer' ? createCommandService(runtime) : null), { signal });
+  }
+  function withWriter(callback, signal) { return withRuntime('writer', callback, signal); }
+  function withReader(callback, signal) { return withRuntime('reader', callback, signal); }
 
-/** DSH 只把图片来源转换为 Command 输入，差异算法与 Artifact 提交由 Core 执行。 */
-export function diffForDsh(input = {}) {
-  return withWriter(async (runtime, commands) => {
-    const commandInput = { grid: input.grid, top_regions: input.topRegions };
-    for (const [side, source] of [['a', input.imageA], ['b', input.imageB]]) {
-      if (input.signal?.aborted) throw abortError();
-      if (source?.bytes !== undefined) {
-        const artifact = await runtime.run('execute', ({ dataRoot }) => createCoreArtifact(dataRoot, {
-          bytes: source.bytes, mediaType: source.mediaType, kind: 'host-input', metadata: {}
+  /** 本地图片与会话附件都交给同一导入Command，不创建生成任务。 */
+  function importImageForDsh(input = {}) {
+    return withWriter((_runtime, commands) => commands.execute('artifact.import', input.imageBytes !== undefined
+      ? { image_bytes: input.imageBytes } : { image_path: input.imagePath }), input.signal);
+  }
+
+  /**
+   * 将 DSH 图片输入投影到共享 crop Command，再把中性 Artifact 读成宿主可保存的字节。
+   * bytes 输入先成为 host-input Artifact，输出通过 derived-from 保留关系。
+   */
+  async function cropForDsh(input = {}) {
+    return withWriter(async (runtime, commands) => {
+      if (input.signal?.aborted) throw Object.assign(new Error('已取消'), { name: 'AbortError' });
+      let commandInput;
+      if (input.bytes !== undefined) {
+        const source = await runtime.run('execute', ({ dataRoot }) => createCoreArtifact(dataRoot, {
+          bytes: input.bytes,
+          mediaType: input.mediaType,
+          kind: 'host-input',
+          metadata: {}
         }));
-        commandInput['image_' + side + '_artifact_id'] = artifact.id;
+        commandInput = { artifact_id: source.id };
       } else {
-        commandInput['image_' + side + '_path'] = source?.imagePath;
+        commandInput = { image_path: input.imagePath };
       }
-    }
-    const result = await commands.execute('media.diff', commandInput);
-    const materialized = await runtime.run('inspect', ({ dataRoot }) =>
-      readCoreArtifactBytes(dataRoot, result.artifact.id));
-    if (input.signal?.aborted) throw abortError();
-    return Object.freeze({ ...materialized, mediaType: result.artifact.mediaType, metrics: result.metrics });
-  }, input.signal);
-}
+      Object.assign(commandInput, {
+        left: input.left,
+        top: input.top,
+        width: input.width,
+        height: input.height
+      });
+      const result = await commands.execute('crop', commandInput);
+      if (input.signal?.aborted) throw Object.assign(new Error('已取消'), { name: 'AbortError' });
+      const materialized = await runtime.run('inspect', ({ dataRoot }) =>
+        readCoreArtifactBytes(dataRoot, result.artifact.id));
+      return Object.freeze({
+        artifact: result.artifact,
+        bytes: materialized.bytes,
+        mediaType: result.artifact.mediaType,
+        width: result.artifact.metadata.width,
+        height: result.artifact.metadata.height
+      });
+    }, input.signal);
+  }
 
-/** 抽帧结果先落 Core Artifact，再只读转换为 DSH 可保存的附件字节。 */
-export function framesForDsh(input = {}) {
-  return withWriter(async (runtime, commands) => {
-    const result = await commands.execute('media.frames', {
-      video_path: input.videoPath,
-      max_frames: input.maxFrames,
-      target_width: input.targetWidth,
-      format: input.format,
-      quality: input.quality
-    });
-    const frames = await runtime.run('inspect', ({ dataRoot }) => result.artifacts.map((artifact) => ({
-      ...readCoreArtifactBytes(dataRoot, artifact.id),
-      mediaType: artifact.mediaType,
-      ...artifact.metadata
-    })));
-    if (input.signal?.aborted) throw abortError();
-    return Object.freeze({ media: result.media, frames: Object.freeze(frames.map(Object.freeze)) });
-  }, input.signal);
-}
+  /** Browser 只提供截图字节；DSH/CLI 共用 HTML Command 和 Artifact 提交。 */
+  function htmlForDsh(input = {}) {
+    return withWriter(async runtime => {
+      const commands = createCommandService(runtime, { browser: input.browser });
+      const result = await commands.execute('media.html', { html: input.html, width: input.width,
+        height: input.height, full_page: input.fullPage });
+      return runtime.run('inspect', ({ dataRoot }) => readCoreArtifactBytes(dataRoot, result.artifact.id));
+    }, input.signal);
+  }
 
-/** 已有抽帧 Artifact 直接进入共享摘要；reader 不取得写者租约。 */
-export function summaryFramesForDsh(input = {}) {
-  return withReader(runtime => readSummaryFrames(runtime, input.frameArtifactIds, input.signal), input.signal);
-}
+  /** DSH 只把图片来源转换为 Command 输入，差异算法与 Artifact 提交由 Core 执行。 */
+  function diffForDsh(input = {}) {
+    return withWriter(async (runtime, commands) => {
+      const commandInput = { grid: input.grid, top_regions: input.topRegions };
+      for (const [side, source] of [['a', input.imageA], ['b', input.imageB]]) {
+        if (input.signal?.aborted) throw abortError();
+        if (source?.bytes !== undefined) {
+          const artifact = await runtime.run('execute', ({ dataRoot }) => createCoreArtifact(dataRoot, {
+            bytes: source.bytes, mediaType: source.mediaType, kind: 'host-input', metadata: {}
+          }));
+          commandInput['image_' + side + '_artifact_id'] = artifact.id;
+        } else {
+          commandInput['image_' + side + '_path'] = source?.imagePath;
+        }
+      }
+      const result = await commands.execute('media.diff', commandInput);
+      const materialized = await runtime.run('inspect', ({ dataRoot }) =>
+        readCoreArtifactBytes(dataRoot, result.artifact.id));
+      if (input.signal?.aborted) throw abortError();
+      return Object.freeze({ ...materialized, mediaType: result.artifact.mediaType, metrics: result.metrics });
+    }, input.signal);
+  }
 
-/** 共享单图读取器用于 look/locate/OCR，Host 不解释 Core 对象路径。 */
-export function visionImageForDsh(input = {}) {
-  return withReader(runtime => readVisionArtifact(runtime, input.artifactId, input.signal), input.signal);
-}
+  /** 抽帧结果先落 Core Artifact，再只读转换为 DSH 可保存的附件字节。 */
+  function framesForDsh(input = {}) {
+    return withWriter(async (runtime, commands) => {
+      const result = await commands.execute('media.frames', {
+        video_path: input.videoPath,
+        max_frames: input.maxFrames,
+        target_width: input.targetWidth,
+        format: input.format,
+        quality: input.quality
+      });
+      const frames = await runtime.run('inspect', ({ dataRoot }) => result.artifacts.map((artifact) => ({
+        ...readCoreArtifactBytes(dataRoot, artifact.id),
+        mediaType: artifact.mediaType,
+        ...artifact.metadata
+      })));
+      if (input.signal?.aborted) throw abortError();
+      return Object.freeze({ media: result.media, frames: Object.freeze(frames.map(Object.freeze)) });
+    }, input.signal);
+  }
 
-/** 提交一个 Core Provider Task；Provider Adapter 由 DSH 配置边界选择后显式传入。 */
-export function submitProviderTaskForDsh(input = {}) {
-  return withWriter((runtime) => createProviderTaskRunner(runtime).submit({
-    capability: input.capability,
-    candidates: input.candidates,
-    providerInput: input.providerInput,
-    sourceArtifactId: input.sourceArtifactId
-  }), input.signal);
-}
+  /** 已有抽帧 Artifact 直接进入共享摘要；reader 不取得写者租约。 */
+  function summaryFramesForDsh(input = {}) {
+    return withReader(runtime => readSummaryFrames(runtime, input.frameArtifactIds, input.signal), input.signal);
+  }
 
-export function submitMusicForDsh(input) {
-  return withWriter(runtime => generateMusicTask({
-    runner: createProviderTaskRunner(runtime), candidates: input.candidates,
-    providerInput: input.providerInput, options: input.musicOptions, signal: input.signal
-  }), input.signal);
-}
+  /** 共享单图读取器用于 look/locate/OCR，Host 不解释 Core 对象路径。 */
+  function visionImageForDsh(input = {}) {
+    return withReader(runtime => readVisionArtifact(runtime, input.artifactId, input.signal), input.signal);
+  }
 
-/** 单步观察已经受理的 Core Task；不会自动循环，也不会创建第二次 submit。 */
-export function observeProviderTaskForDsh(input = {}) {
-  return withWriter((runtime) => createProviderTaskRunner(runtime).observe(
-    input.taskId, input.adapter, { resumeActive: input.resumeActive === true }
-  ), input.signal);
-}
+  /** 提交一个 Core Provider Task；Provider Adapter 由 DSH 配置边界选择后显式传入。 */
+  function submitProviderTaskForDsh(input = {}) {
+    return withWriter((runtime) => createProviderTaskRunner(runtime).submit({
+      capability: input.capability,
+      candidates: input.candidates,
+      providerInput: input.providerInput,
+      sourceArtifactId: input.sourceArtifactId
+    }), input.signal);
+  }
 
-/**
- * D1/D2 人工动作公共通路：与 Host 观察节拍共用同一个 resolver / binding 校验
- * （configuredAdapterForTask），经 Command Service 显式执行一次人工命令；合法性
- * 门在 Command 内于网络与写入之前完成。返回任务事实对应的五类用户投影行
- * （无 providerId/binding/错误原文/路径）。
- */
-function manualTaskCommandForDsh(command, input = {}) {
-  const taskId = String(input.taskId || '').trim();
-  if (!/^task_[a-f0-9]{24}$/.test(taskId)) {
-    return Promise.reject(new DshCoreAdapterError('IRIS_DSH_TASK_INVALID', 'Core Task ID 无效'));
-  }
-  return withWriter(async (runtime) => {
-    const commands = createCommandService(runtime, { resolveTaskAdapter: configuredAdapterForTask });
-    const result = await commands.execute(command, { task_id: taskId });
-    return runtime.run('inspect', ({ dataRoot }) => {
-      const artifacts = [];
-      for (const artifactId of result.task.artifactIds) {
-        try { artifacts.push(inspectCoreArtifact(dataRoot, artifactId)); }
-        catch (_) { /* 缺失媒体在投影行里降级为不可用 */ }
-      }
-      return Object.freeze({
-        taskId: result.task.id,
-        row: projectCoreTaskUserRow(result.task, artifacts)
+  function submitMusicForDsh(input) {
+    return withWriter(runtime => generateMusicTask({
+      runner: createProviderTaskRunner(runtime), candidates: input.candidates,
+      providerInput: input.providerInput, options: input.musicOptions, signal: input.signal
+    }), input.signal);
+  }
+
+  /** 单步观察已经受理的 Core Task；不会自动循环，也不会创建第二次 submit。 */
+  function observeProviderTaskForDsh(input = {}) {
+    return withWriter((runtime) => createProviderTaskRunner(runtime).observe(
+      input.taskId, input.adapter, { resumeActive: input.resumeActive === true }
+    ), input.signal);
+  }
+
+  /**
+   * D1/D2 人工动作公共通路：与 Host 观察节拍共用同一个 resolver / binding 校验
+   * （configuredAdapterForTask），经 Command Service 显式执行一次人工命令；合法性
+   * 门在 Command 内于网络与写入之前完成。返回任务事实对应的五类用户投影行
+   * （无 providerId/binding/错误原文/路径）。
+   */
+  function manualTaskCommandForDsh(command, input = {}) {
+    const taskId = String(input.taskId || '').trim();
+    if (!/^task_[a-f0-9]{24}$/.test(taskId)) {
+      return Promise.reject(new DshCoreAdapterError('IRIS_DSH_TASK_INVALID', 'Core Task ID 无效'));
+    }
+    return withWriter(async (runtime) => {
+      const commands = createCommandService(runtime, { resolveTaskAdapter: task => configuredAdapterForTask(task, runtime.signal) });
+      const result = await commands.execute(command, { task_id: taskId });
+      return runtime.run('inspect', ({ dataRoot }) => {
+        const artifacts = [];
+        for (const artifactId of result.task.artifactIds) {
+          try { artifacts.push(inspectCoreArtifact(dataRoot, artifactId)); }
+          catch (_) { /* 缺失媒体在投影行里降级为不可用 */ }
+        }
+        return Object.freeze({
+          taskId: result.task.id,
+          row: projectCoreTaskUserRow(result.task, artifacts)
+        });
       });
-    });
-  }, input.signal);
-}
+    }, input.signal);
+  }
 
-/** D1 人工 reobserve：显式单步 poll 一次，绝不 submit。 */
-export function reobserveProviderTaskForDsh(input = {}) {
-  return manualTaskCommandForDsh('task.reobserve', input);
-}
+  /** D1 人工 reobserve：显式单步 poll 一次，绝不 submit。 */
+  function reobserveProviderTaskForDsh(input = {}) {
+    return manualTaskCommandForDsh('task.reobserve', input);
+  }
 
-/**
- * D2 人工 redeliver：只对 outcome=succeeded / deliveryState=failed 的 Task
- * 重新交付原结果（同步读缓存，异步 re-poll → download），绝不 submit、
- * 绝不重新生成。
- */
-export function redeliverProviderTaskForDsh(input = {}) {
-  return manualTaskCommandForDsh('task.redeliver', input);
-}
+  /**
+   * D2 人工 redeliver：只对 outcome=succeeded / deliveryState=failed 的 Task
+   * 重新交付原结果（同步读缓存，异步 re-poll → download），绝不 submit、
+   * 绝不重新生成。
+   */
+  function redeliverProviderTaskForDsh(input = {}) {
+    return manualTaskCommandForDsh('task.redeliver', input);
+  }
 
-/**
- * D3 人工 cancel：只有 Provider 明确确认才写 outcome=canceled；不支持或无法确认
- * 时保持真实状态（详见 core-tasks 的 recordCoreCancelResult 三分支）。
- */
-export function cancelProviderTaskForDsh(input = {}) {
-  return manualTaskCommandForDsh('task.cancel', input);
-}
+  /**
+   * D3 人工 cancel：只有 Provider 明确确认才写 outcome=canceled；不支持或无法确认
+   * 时保持真实状态（详见 core-tasks 的 recordCoreCancelResult 三分支）。
+   */
+  function cancelProviderTaskForDsh(input = {}) {
+    return manualTaskCommandForDsh('task.cancel', input);
+  }
 
-/**
- * 注意力处置（Host 偏好，零 Core 写入）：acknowledge/restore/hide/unhide。
- * 只校验任务存在；动作幂等（偏好不变时不写盘）；返回装饰后的投影行。
- */
-export async function disposeCoreTaskAttention(input = {}) {
-  const taskId = String(input.taskId || '').trim();
-  const action = String(input.action || '').trim();
-  if (!/^task_[a-f0-9]{24}$/.test(taskId)) {
-    throw new DshCoreAdapterError('IRIS_DSH_TASK_INVALID', 'Core Task ID 无效');
-  }
-  // 任务必须存在（reader 只读）；不存在统一 404。
-  const task = await inspectProviderTaskForDsh(taskId, { signal: input.signal });
-  const applied = applyCoreAttentionAction(task.id, action);
-  const row = await withReader((runtime) => runtime.run('inspect', ({ dataRoot }) => {
-    const artifacts = [];
-    for (const artifactId of task.artifactIds) {
-      try { artifacts.push(inspectCoreArtifact(dataRoot, artifactId)); }
-      catch (_) { /* 缺失媒体在投影行里降级为不可用 */ }
+  /**
+   * 注意力处置（Host 偏好，零 Core 写入）：acknowledge/restore/hide/unhide。
+   * 只校验任务存在；动作幂等（偏好不变时不写盘）；返回装饰后的投影行。
+   */
+  async function disposeCoreTaskAttention(input = {}) {
+    const taskId = String(input.taskId || '').trim();
+    const action = String(input.action || '').trim();
+    if (!/^task_[a-f0-9]{24}$/.test(taskId)) {
+      throw new DshCoreAdapterError('IRIS_DSH_TASK_INVALID', 'Core Task ID 无效');
     }
-    return decorateCoreUserRows(
-      [projectCoreTaskUserRow(task, artifacts)],
-      listAllCoreTaskRecords(dataRoot),
-      readCoreAttentionPrefs()
-    )[0];
-  }), input.signal);
-  return Object.freeze({ taskId: task.id, changed: applied.changed, row });
-}
-
-/**
- * D4 人工 retry as new task：产生新的真实计费。候选链按当前 assignments/池实况
- * 重新解析（不绑定旧 Provider/binding——旧配置可能正是失败原因），modelRef 可
- * 显式指定。prompt 必须由调用方重新提供（Core 记录不持久化 Prompt）。
- */
-export function retryProviderTaskForDsh(input = {}) {
-  const taskId = String(input.taskId || '').trim();
-  if (!/^task_[a-f0-9]{24}$/.test(taskId)) {
-    return Promise.reject(new DshCoreAdapterError('IRIS_DSH_TASK_INVALID', 'Core Task ID 无效'));
-  }
-  return withWriter(async (runtime) => {
-    const commands = createCommandService(runtime, {
-      resolveTaskCandidates: ({ capability, modelRef }) => withDshProviderConfig(providerHost(), async () => {
-        if (!modelRef) await refreshAutomaticDirectories({ capability: { image: 'image-gen', video: 'video-gen', music: 'music-gen' }[capability] || capability, signal: input.signal });
-        const catalog = { providers: runtimeProviders(), assignments: assignments() };
-        const ref = modelRef || undefined;
-        const candidates = capability === 'video'
-          ? videoCandidatesFromCatalog(catalog, ref)
-          : capability === 'tts'
-            ? ttsCandidatesFromCatalog(catalog, ref)
-            : capability === 'music'
-              ? musicCandidatesFromCatalog(catalog, ref)
-            : capability === 'transcribe'
-              ? transcribeCandidatesFromCatalog(catalog, ref)
-              : imageCandidatesFromCatalog(catalog, ref);
-        return candidates.map((route) => ({
-          adapter: createConfiguredProviderAdapter(route.provider),
-          model: route.modelRef,
-          selectionReason: route.selectionReason,
-          providerBinding: providerTaskBinding(route.provider)
-        }));
-      }, { signal: input.signal, fresh: true })
-    });
-    const result = await commands.execute('task.retry', {
-      task_id: taskId,
-      provider_input: input.text !== undefined
-        ? { text: input.text, ...(input.voice !== undefined ? { voice: input.voice } : {}) }
-        : input.audio_url !== undefined
-          ? { audio_url: input.audio_url }
-          : { prompt: input.prompt, ...(input.sourceArtifactId !== undefined ? { source_artifact_id: input.sourceArtifactId } : {}) },
-      model_ref: input.modelRef,
-      confirm_billing: input.confirmBilling
-    });
-    return runtime.run('inspect', ({ dataRoot }) => {
+    // 任务必须存在（reader 只读）；不存在统一 404。
+    const task = await inspectProviderTaskForDsh(taskId, { signal: input.signal });
+    const applied = applyCoreAttentionAction(task.id, action);
+    const row = await withReader((runtime) => runtime.run('inspect', ({ dataRoot }) => {
       const artifacts = [];
-      for (const artifactId of result.task.artifactIds) {
+      for (const artifactId of task.artifactIds) {
         try { artifacts.push(inspectCoreArtifact(dataRoot, artifactId)); }
         catch (_) { /* 缺失媒体在投影行里降级为不可用 */ }
       }
-      return Object.freeze({
-        taskId: result.task.id,
-        retriedFrom: result.retriedFrom,
-        row: projectCoreTaskUserRow(result.task, artifacts)
+      return decorateCoreUserRows(
+        [projectCoreTaskUserRow(task, artifacts)],
+        listAllCoreTaskRecords(dataRoot),
+        readCoreAttentionPrefs()
+      )[0];
+    }), input.signal);
+    return Object.freeze({ taskId: task.id, changed: applied.changed, row });
+  }
+
+  /**
+   * D4 人工 retry as new task：产生新的真实计费。候选链按当前 assignments/池实况
+   * 重新解析（不绑定旧 Provider/binding——旧配置可能正是失败原因），modelRef 可
+   * 显式指定。prompt 必须由调用方重新提供（Core 记录不持久化 Prompt）。
+   */
+  function retryProviderTaskForDsh(input = {}) {
+    const taskId = String(input.taskId || '').trim();
+    if (!/^task_[a-f0-9]{24}$/.test(taskId)) {
+      return Promise.reject(new DshCoreAdapterError('IRIS_DSH_TASK_INVALID', 'Core Task ID 无效'));
+    }
+    return withWriter(async (runtime) => {
+      const commands = createCommandService(runtime, {
+        resolveTaskCandidates: ({ capability, modelRef }) => withDshProviderConfig(getHost(), async () => {
+          if (!modelRef) await refreshAutomaticDirectories({ capability: { image: 'image-gen', video: 'video-gen', music: 'music-gen' }[capability] || capability, signal: input.signal });
+          const catalog = { providers: runtimeProviders(), assignments: assignments() };
+          const ref = modelRef || undefined;
+          const candidates = capability === 'video'
+            ? videoCandidatesFromCatalog(catalog, ref)
+            : capability === 'tts'
+              ? ttsCandidatesFromCatalog(catalog, ref)
+              : capability === 'music'
+                ? musicCandidatesFromCatalog(catalog, ref)
+              : capability === 'transcribe'
+                ? transcribeCandidatesFromCatalog(catalog, ref)
+                : imageCandidatesFromCatalog(catalog, ref);
+          return candidates.map((route) => ({
+            adapter: createConfiguredProviderAdapter(route.provider),
+            model: route.modelRef,
+            selectionReason: route.selectionReason,
+            providerBinding: providerTaskBinding(route.provider)
+          }));
+        }, { signal: input.signal, fresh: true })
       });
-    });
-  }, input.signal);
-}
+      const result = await commands.execute('task.retry', {
+        task_id: taskId,
+        provider_input: input.text !== undefined
+          ? { text: input.text, ...(input.voice !== undefined ? { voice: input.voice } : {}) }
+          : input.audio_url !== undefined
+            ? { audio_url: input.audio_url }
+            : { prompt: input.prompt, ...(input.sourceArtifactId !== undefined ? { source_artifact_id: input.sourceArtifactId } : {}) },
+        model_ref: input.modelRef,
+        confirm_billing: input.confirmBilling
+      });
+      return runtime.run('inspect', ({ dataRoot }) => {
+        const artifacts = [];
+        for (const artifactId of result.task.artifactIds) {
+          try { artifacts.push(inspectCoreArtifact(dataRoot, artifactId)); }
+          catch (_) { /* 缺失媒体在投影行里降级为不可用 */ }
+        }
+        return Object.freeze({
+          taskId: result.task.id,
+          retriedFrom: result.retriedFrom,
+          row: projectCoreTaskUserRow(result.task, artifacts)
+        });
+      });
+    }, input.signal);
+  }
 
-/** DSH Host 观察接管的媒体能力白名单：图片、视频与转写共用 Task/Attempt 事实轴。 */
-const WATCHABLE_CAPABILITIES = new Set(['image', 'video', 'transcribe']);
-const WATCH_INTERVAL_BY_CAPABILITY = Object.freeze({ image: DEFAULT_POLL_INTERVAL_MS, video: 6000, transcribe: 2500 });
+  /** DSH Host 观察接管的媒体能力白名单：图片、视频与转写共用 Task/Attempt 事实轴。 */
+  const WATCHABLE_CAPABILITIES = new Set(['image', 'video', 'transcribe']);
+  const WATCH_INTERVAL_BY_CAPABILITY = Object.freeze({ image: DEFAULT_POLL_INTERVAL_MS, video: 6000, transcribe: 2500 });
 
-function observableProviderTask(task) {
-  return Boolean(task && WATCHABLE_CAPABILITIES.has(task.capability)
-    && task.acceptance === 'accepted' && task.remoteTaskId
-    && ['none', 'unknown'].includes(task.outcome)
-    && task.phase !== 'terminal');
-}
+  function observableProviderTask(task) {
+    return Boolean(task && WATCHABLE_CAPABILITIES.has(task.capability)
+      && task.acceptance === 'accepted' && task.remoteTaskId
+      && ['none', 'unknown'].includes(task.outcome)
+      && task.phase !== 'terminal');
+  }
 
-async function configuredAdapterForTask(task) {
-  return withDshProviderConfig(providerHost(), () => {
-    const provider = providerForTaskFromCatalog({ providers: runtimeProviders() }, task);
-    return createConfiguredProviderAdapter(provider, { modelId: parseModelRef(task.modelRef)?.modelId });
-  }, { fresh: true });
-}
+  async function configuredAdapterForTask(task, signal = lifetime.signal) {
+    signal.throwIfAborted();
+    return withDshProviderConfig(getHost(), () => {
+      const provider = providerForTaskFromCatalog({ providers: runtimeProviders() }, task);
+      return createConfiguredProviderAdapter(provider, { modelId: parseModelRef(task.modelRef)?.modelId });
+    }, { signal, fresh: true });
+  }
 
-function stopProviderWatch(taskId, expectedState) {
-  const current = providerWatchers.get(taskId);
-  if (expectedState && current !== expectedState) return;
-  if (current?.timer) clearTimeout(current.timer);
-  providerWatchers.delete(taskId);
-  current?.controller.abort();
-}
+  function stopProviderWatch(taskId, expectedState) {
+    const current = providerWatchers.get(taskId);
+    if (expectedState && current !== expectedState) return;
+    if (current?.timer) clearTimeout(current.timer);
+    providerWatchers.delete(taskId);
+    current?.controller.abort();
+  }
 
-/**
- * DSH Host 拥有的有界 Core 观察器。每个 tick 重新读取 Task 与配置，最多执行
- * 一次 poll；任何路径都不会调用 submit。Runtime/Writer 只在单次观察期间存活。
- */
-export async function watchProviderTaskForDsh(input = {}) {
-  const taskId = String(input.taskId || '').trim();
-  if (!/^task_[a-f0-9]{24}$/.test(taskId)) {
-    throw new DshCoreAdapterError('IRIS_DSH_TASK_INVALID', 'Core Task ID 无效');
-  }
-  if (providerWatchers.has(taskId)) return false;
-  const initial = await inspectProviderTaskForDsh(taskId, { signal: input.signal });
-  if (!observableProviderTask(initial) || providerWatchers.has(taskId)) return false;
-  await configuredAdapterForTask(initial); // binding/模型漂移在定时器和网络前失败
-
-  const state = {
-    timer: null,
-    controller: new AbortController(),
-    startedAt: Date.now(),
-    errors: 0,
-    intervalMs: Math.max(5, Number(input.intervalMs)
-      || WATCH_INTERVAL_BY_CAPABILITY[initial.capability] || DEFAULT_POLL_INTERVAL_MS),
-    maxWatchMs: Math.max(50, Number(input.maxWatchMs) || DEFAULT_MAX_WATCH_MS)
-  };
-  providerWatchers.set(taskId, state);
-
-  const schedule = (delay = state.intervalMs) => {
-    if (providerWatchers.get(taskId) !== state) return;
-    state.timer = setTimeout(() => { tick().catch(() => stopProviderWatch(taskId, state)); }, delay);
-    if (state.timer.unref) state.timer.unref();
-  };
-  const tick = async () => {
-    if (providerWatchers.get(taskId) !== state) return;
-    const before = await inspectProviderTaskForDsh(taskId, { signal: state.controller.signal });
-    if (providerWatchers.get(taskId) !== state) return;
-    if (!observableProviderTask(before)) return stopProviderWatch(taskId, state);
-    if (Date.now() - state.startedAt > state.maxWatchMs) {
-      console.warn('[iris] Core Task 自动观察已达到本轮时限，保留远端受理事实：' + taskId);
-      return stopProviderWatch(taskId, state);
-    }
-    let adapter;
-    try {
-      adapter = await configuredAdapterForTask(before);
-    } catch (error) {
-      console.warn('[iris] Core Task 无法按原 Provider binding 恢复观察：' + taskId
-        + ' · ' + String(error?.code || error?.message || error));
-      return stopProviderWatch(taskId, state);
+  /**
+   * DSH Host 拥有的有界 Core 观察器。每个 tick 重新读取 Task 与配置，最多执行
+   * 一次 poll；任何路径都不会调用 submit。Runtime/Writer 只在单次观察期间存活。
+   */
+  async function watchProviderTaskForDsh(input = {}) {
+    const taskId = String(input.taskId || '').trim();
+    if (!/^task_[a-f0-9]{24}$/.test(taskId)) {
+      throw new DshCoreAdapterError('IRIS_DSH_TASK_INVALID', 'Core Task ID 无效');
     }
-    let after;
-    try {
-      after = await observeProviderTaskForDsh({
-        taskId, adapter, resumeActive: true, signal: state.controller.signal
-      });
-    } catch (error) {
-      if (error?.code === 'IRIS_CORE_DATA_ROOT_BUSY') return schedule();
-      state.errors += 1;
+    if (providerWatchers.has(taskId)) return false;
+    const initial = await inspectProviderTaskForDsh(taskId, { signal: input.signal });
+    if (!observableProviderTask(initial) || providerWatchers.has(taskId)) return false;
+    await configuredAdapterForTask(initial, input.signal); // binding/模型漂移在定时器和网络前失败
+
+    input.signal.throwIfAborted();
+    if (!accepting()) throw closed();
+    if (providerWatchers.has(taskId)) return false;
+    const state = {
+      timer: null,
+      controller: new AbortController(),
+      startedAt: Date.now(),
+      errors: 0,
+      intervalMs: Math.max(5, Number(input.intervalMs)
+        || WATCH_INTERVAL_BY_CAPABILITY[initial.capability] || DEFAULT_POLL_INTERVAL_MS),
+      maxWatchMs: Math.max(50, Number(input.maxWatchMs) || DEFAULT_MAX_WATCH_MS)
+    };
+    providerWatchers.set(taskId, state);
+
+    const schedule = (delay = state.intervalMs) => {
+      if (providerWatchers.get(taskId) !== state) return;
+      if (!accepting()) return stopProviderWatch(taskId, state);
+      state.timer = setTimeout(() => {
+        const job = tick().catch(() => stopProviderWatch(taskId, state));
+        polls.add(job); void job.then(() => polls.delete(job));
+      }, delay);
+      if (state.timer.unref) state.timer.unref();
+    };
+    const tick = async () => {
+      if (providerWatchers.get(taskId) !== state) return;
+      const before = await inspectProviderTaskForDsh(taskId, { signal: state.controller.signal });
+      if (providerWatchers.get(taskId) !== state) return;
+      if (!observableProviderTask(before)) return stopProviderWatch(taskId, state);
+      if (Date.now() - state.startedAt > state.maxWatchMs) {
+        console.warn('[iris] Core Task 自动观察已达到本轮时限，保留远端受理事实：' + taskId);
+        return stopProviderWatch(taskId, state);
+      }
+      let adapter;
+      try {
+        adapter = await configuredAdapterForTask(before, state.controller.signal);
+      } catch (error) {
+        console.warn('[iris] Core Task 无法按原 Provider binding 恢复观察：' + taskId
+          + ' · ' + String(error?.code || error?.message || error));
+        return stopProviderWatch(taskId, state);
+      }
+      let after;
+      try {
+        after = await observeProviderTaskForDsh({
+          taskId, adapter, resumeActive: true, signal: state.controller.signal
+        });
+      } catch (error) {
+        if (error?.code === 'IRIS_CORE_DATA_ROOT_BUSY') return schedule();
+        state.errors += 1;
+        if (state.errors >= POLL_ERROR_TOLERANCE) {
+          console.warn('[iris] Core Task 自动观察连续失败，保留事实供人工继续：' + taskId);
+          return stopProviderWatch(taskId, state);
+        }
+        return schedule();
+      }
+      if (providerWatchers.get(taskId) !== state) return;
+      if (!observableProviderTask(after)) return stopProviderWatch(taskId, state);
+      if (after.outcome === 'unknown') state.errors += 1;
+      else state.errors = 0;
       if (state.errors >= POLL_ERROR_TOLERANCE) {
-        console.warn('[iris] Core Task 自动观察连续失败，保留事实供人工继续：' + taskId);
+        console.warn('[iris] Core Task Provider 观察连续失败，保留事实供人工继续：' + taskId);
         return stopProviderWatch(taskId, state);
       }
-      return schedule();
-    }
-    if (providerWatchers.get(taskId) !== state) return;
-    if (!observableProviderTask(after)) return stopProviderWatch(taskId, state);
-    if (after.outcome === 'unknown') state.errors += 1;
-    else state.errors = 0;
-    if (state.errors >= POLL_ERROR_TOLERANCE) {
-      console.warn('[iris] Core Task Provider 观察连续失败，保留事实供人工继续：' + taskId);
-      return stopProviderWatch(taskId, state);
-    }
-    schedule();
-  };
-  schedule(Math.min(500, state.intervalMs));
-  return true;
-}
+      schedule();
+    };
+    schedule(Math.min(500, state.intervalMs));
+    return true;
+  }
 
-/** DSH 启动时只接管仍有明确远端受理证据的 Core 图片 Task。 */
-export async function resumeProviderTaskWatchesForDsh(options = {}) {
-  if (!fs.existsSync(dshCoreDataRoot())) return Object.freeze([]);
-  const records = await withReader((runtime) => runtime.run('inspect', ({ dataRoot }) => {
-    const all = [];
-    let page;
-    do {
-      page = listCoreTasks(dataRoot, { offset: all.length, limit: 200 });
-      all.push(...page.tasks);
-    } while (all.length < page.total);
-    return all;
-  }));
-  const resumed = [];
-  for (const original of records) {
-    if (!WATCHABLE_CAPABILITIES.has(original.capability)) continue;
-    try {
-      if (observableProviderTask(original)) await configuredAdapterForTask(original);
-      const needsRecovery = (original.phase === 'submitting' && original.acceptance === 'none')
-        || original.cancelState === 'requested'
-        || (original.outcome === 'succeeded' && ['pending', 'downloading'].includes(original.deliveryState))
-        || (original.acceptance === 'accepted' && original.watchState === 'active');
-      const task = needsRecovery
-        ? await withWriter((runtime) => runtime.run('recover', ({ dataRoot }) => recoverCoreTask(dataRoot, original.id)))
-        : original;
-      if (!observableProviderTask(task)) continue;
-      const createdAt = Date.parse(task.createdAt);
-      if (!Number.isFinite(createdAt) || Date.now() - createdAt > (options.maxWatchMs || DEFAULT_MAX_WATCH_MS)) {
-        console.warn('[iris] Core Task 超过自动接管窗口，保留事实供显式观察：' + task.id);
-        continue;
+  /** DSH 启动时只接管仍有明确远端受理证据的 Core 图片 Task。 */
+  async function resumeProviderTaskWatchesForDsh(options = {}) {
+    options.signal.throwIfAborted();
+    if (!fs.existsSync(dataRoot)) return Object.freeze([]);
+    const records = await withReader((runtime) => runtime.run('inspect', ({ dataRoot }) => {
+      const all = [];
+      let page;
+      do {
+        page = listCoreTasks(dataRoot, { offset: all.length, limit: 200 });
+        all.push(...page.tasks);
+      } while (all.length < page.total);
+      return all;
+    }));
+    const resumed = [];
+    for (const original of records) {
+      if (!WATCHABLE_CAPABILITIES.has(original.capability)) continue;
+      try {
+        options.signal.throwIfAborted();
+        if (observableProviderTask(original)) await configuredAdapterForTask(original, options.signal);
+        const needsRecovery = (original.phase === 'submitting' && original.acceptance === 'none')
+          || original.cancelState === 'requested'
+          || (original.outcome === 'succeeded' && ['pending', 'downloading'].includes(original.deliveryState))
+          || (original.acceptance === 'accepted' && original.watchState === 'active');
+        const task = needsRecovery
+          ? await withWriter((runtime) => runtime.run('recover', ({ dataRoot }) => recoverCoreTask(dataRoot, original.id)), options.signal)
+          : original;
+        options.signal.throwIfAborted();
+        if (!observableProviderTask(task)) continue;
+        const createdAt = Date.parse(task.createdAt);
+        if (!Number.isFinite(createdAt) || Date.now() - createdAt > (options.maxWatchMs || DEFAULT_MAX_WATCH_MS)) {
+          console.warn('[iris] Core Task 超过自动接管窗口，保留事实供显式观察：' + task.id);
+          continue;
+        }
+        if (await watchProviderTaskForDsh({
+          taskId: task.id, signal: options.signal,
+          intervalMs: options.intervalMs,
+          maxWatchMs: options.maxWatchMs
+        })) resumed.push(task.id);
+      } catch (error) {
+        if (options.signal.aborted || !accepting()) throw error;
+        console.warn('[iris] Core Task 启动接管失败：' + original.id
+          + ' · ' + String(error?.code || error?.message || error));
       }
-      if (await watchProviderTaskForDsh({
-        taskId: task.id,
-        intervalMs: options.intervalMs,
-        maxWatchMs: options.maxWatchMs
-      })) resumed.push(task.id);
-    } catch (error) {
-      console.warn('[iris] Core Task 启动接管失败：' + original.id
-        + ' · ' + String(error?.code || error?.message || error));
     }
+    return Object.freeze(resumed);
   }
-  return Object.freeze(resumed);
-}
 
-/** 插件 Fiber 释放时停止 Host 定时器并中止在途观察；不请求远端取消或撤销既有受理/成功事实。 */
-export function stopProviderTaskWatchesForDsh() {
-  for (const taskId of [...providerWatchers.keys()]) stopProviderWatch(taskId);
-}
-
-/** 读取 Core Task 事实；reader 不初始化、修复或更新记录。 */
-export function inspectProviderTaskForDsh(taskId, options = {}) {
-  return withReader((runtime) => runtime.run('inspect', ({ dataRoot }) =>
-    inspectCoreTask(dataRoot, taskId)), options.signal);
-}
+  /** 插件 Fiber 释放时停止 Host 定时器并中止在途观察；不请求远端取消或撤销既有受理/成功事实。 */
+  function stopProviderTaskWatchesForDsh() {
+    for (const taskId of [...providerWatchers.keys()]) stopProviderWatch(taskId);
+    return Promise.allSettled([...polls]);
+  }
 
-/** 作品目录与任务 snapshot 分开查询，目录不加载媒体字节、不取得 writer 租约。 */
-export function galleryArtifactsForDsh(options = {}) {
-  if (!fs.existsSync(dshCoreDataRoot())) return Promise.resolve({ artifacts: [], revision: 0, dropped: 0 });
-  return withReader((runtime) => runtime.run('inspect', ({ dataRoot }) =>
-    listCoreArtifactMetadata(dataRoot)), options.signal);
-}
+  /** 读取 Core Task 事实；reader 不初始化、修复或更新记录。 */
+  function inspectProviderTaskForDsh(taskId, options = {}) {
+    return withReader((runtime) => runtime.run('inspect', ({ dataRoot }) =>
+      inspectCoreTask(dataRoot, taskId)), options.signal);
+  }
 
-export function inspectWorkbenchArtifactForDsh(artifactId, options = {}) {
-  return withReader(runtime => runtime.run('inspect', ({ dataRoot }) =>
-    inspectCoreArtifact(dataRoot, artifactId)), options.signal);
-}
+  /** 作品目录与任务 snapshot 分开查询，目录不加载媒体字节、不取得 writer 租约。 */
+  function galleryArtifactsForDsh(options = {}) {
+    if (!fs.existsSync(dataRoot)) return Promise.resolve({ artifacts: [], revision: 0, dropped: 0 });
+    return withReader((runtime) => runtime.run('inspect', ({ dataRoot }) =>
+      listCoreArtifactMetadata(dataRoot)), options.signal);
+  }
 
-/** 工作台管理沿用 CLI 的维护命令；预览/事务列表只读，执行使用既有串行 writer。 */
-export function maintainWorkbenchForDsh(command, input, options = {}) {
-  if (!['core.delete', 'core.transactions', 'core.restore'].includes(command)) {
-    throw new DshCoreAdapterError('IRIS_COMMAND_INPUT_INVALID', '不支持的作品管理命令');
+  function inspectWorkbenchArtifactForDsh(artifactId, options = {}) {
+    return withReader(runtime => runtime.run('inspect', ({ dataRoot }) =>
+      inspectCoreArtifact(dataRoot, artifactId)), options.signal);
   }
-  if (command === 'core.transactions' && !fs.existsSync(dshCoreDataRoot())) return Promise.resolve({ transactions: [] });
-  if (command === 'core.restore' || input.confirm_delete === true) {
-    return withWriter((_runtime, commands) => commands.execute(command, input), options.signal);
+
+  /** 工作台管理沿用 CLI 的维护命令；预览/事务列表只读，执行使用既有串行 writer。 */
+  function maintainWorkbenchForDsh(command, input, options = {}) {
+    if (!['core.delete', 'core.transactions', 'core.restore'].includes(command)) {
+      throw new DshCoreAdapterError('IRIS_COMMAND_INPUT_INVALID', '不支持的作品管理命令');
+    }
+    if (command === 'core.transactions' && !fs.existsSync(dataRoot)) return Promise.resolve({ transactions: [] });
+    if (command === 'core.restore' || input.confirm_delete === true) {
+      return withWriter((_runtime, commands) => commands.execute(command, input), options.signal);
+    }
+    return withReader(runtime => createCommandService(runtime).execute(command, input), options.signal);
   }
-  return withReader(runtime => createCommandService(runtime).execute(command, input), options.signal);
-}
 
-/**
- * 工作台只读候选快照；数据根不存在时不创建任何目录。
- * userTasks 是用户任务区消费的五类状态安全投影（lib/core-user-projection.js），
- * 单条损坏记录或媒体缺失只触发局部降级（degraded/droppedTasks），快照整体仍可加载。
- */
-export function coreSnapshotForDsh(options = {}) {
-  if (!fs.existsSync(dshCoreDataRoot())) {
-    return Promise.resolve(Object.freeze({
-      schemaVersion: 0, available: false, readOnly: true, degraded: false, droppedTasks: 0,
-      tasks: Object.freeze({ total: 0, recent: Object.freeze([]) }),
-      artifacts: Object.freeze({ total: 0, recent: Object.freeze([]) }),
-      userTasks: Object.freeze([])
-    }));
+  /**
+   * 工作台只读候选快照；数据根不存在时不创建任何目录。
+   * userTasks 是用户任务区消费的五类状态安全投影（lib/core-user-projection.js），
+   * 单条损坏记录或媒体缺失只触发局部降级（degraded/droppedTasks），快照整体仍可加载。
+   */
+  function coreSnapshotForDsh(options = {}) {
+    if (!fs.existsSync(dataRoot)) {
+      return Promise.resolve(Object.freeze({
+        schemaVersion: 0, available: false, readOnly: true, degraded: false, droppedTasks: 0,
+        tasks: Object.freeze({ total: 0, recent: Object.freeze([]) }),
+        artifacts: Object.freeze({ total: 0, recent: Object.freeze([]) }),
+        userTasks: Object.freeze([])
+      }));
+    }
+    return withReader((runtime) => runtime.run('inspect', ({ dataRoot }) => {
+      const tasks = listCoreTasks(dataRoot, { limit: options.limit || 12, skipInvalid: true });
+      let artifacts = { total: 0, artifacts: Object.freeze([]) };
+      let artifactDegraded = false;
+      try { artifacts = listCoreArtifacts(dataRoot, { limit: options.limit || 12 }); }
+      catch (_) { artifactDegraded = true; }
+      const userTasks = decorateCoreUserRows(
+        tasks.tasks.map((task) => projectCoreTaskUserRow(task, artifacts.artifacts)),
+        listAllCoreTaskRecords(dataRoot),
+        readCoreAttentionPrefs()
+      );
+      return Object.freeze({
+        schemaVersion: 0, available: true, readOnly: true,
+        degraded: artifactDegraded || tasks.dropped > 0,
+        droppedTasks: tasks.dropped,
+        tasks: Object.freeze({ total: tasks.total, recent: tasks.tasks }),
+        artifacts: Object.freeze({ total: artifacts.total, recent: artifacts.artifacts }),
+        userTasks: Object.freeze(userTasks)
+      });
+    }), options.signal);
   }
-  return withReader((runtime) => runtime.run('inspect', ({ dataRoot }) => {
-    const tasks = listCoreTasks(dataRoot, { limit: options.limit || 12, skipInvalid: true });
-    let artifacts = { total: 0, artifacts: Object.freeze([]) };
-    let artifactDegraded = false;
-    try { artifacts = listCoreArtifacts(dataRoot, { limit: options.limit || 12 }); }
-    catch (_) { artifactDegraded = true; }
-    const userTasks = decorateCoreUserRows(
-      tasks.tasks.map((task) => projectCoreTaskUserRow(task, artifacts.artifacts)),
-      listAllCoreTaskRecords(dataRoot),
-      readCoreAttentionPrefs()
-    );
-    return Object.freeze({
-      schemaVersion: 0, available: true, readOnly: true,
-      degraded: artifactDegraded || tasks.dropped > 0,
-      droppedTasks: tasks.dropped,
-      tasks: Object.freeze({ total: tasks.total, recent: tasks.tasks }),
-      artifacts: Object.freeze({ total: artifacts.total, recent: artifacts.artifacts }),
-      userTasks: Object.freeze(userTasks)
-    });
-  }), options.signal);
-}
 
-/** bounded：全量扫描仅供自动静默派生；超界仍有界退出。 */
-const SUCCESSOR_SCAN_LIMIT = 2000;
-function listAllCoreTaskRecords(dataRoot) {
-  const all = [];
-  let page;
-  do {
-    page = listCoreTasks(dataRoot, { offset: all.length, limit: 200, skipInvalid: true });
-    all.push(...page.tasks);
-  } while (all.length < page.total && all.length < SUCCESSOR_SCAN_LIMIT);
-  return all;
-}
+  /** bounded：全量扫描仅供自动静默派生；超界仍有界退出。 */
+  const SUCCESSOR_SCAN_LIMIT = 2000;
+  function listAllCoreTaskRecords(dataRoot) {
+    const all = [];
+    let page;
+    do {
+      page = listCoreTasks(dataRoot, { offset: all.length, limit: 200, skipInvalid: true });
+      all.push(...page.tasks);
+    } while (all.length < page.total && all.length < SUCCESSOR_SCAN_LIMIT);
+    return all;
+  }
 
-/** retriedFrom → 后继任务列表（自动静默只从事实派生，不缓存、不落偏好）。 */
-function successorsByRetriedFrom(records) {
-  const map = new Map();
-  for (const record of records) {
-    if (!record.retriedFrom) continue;
-    if (!map.has(record.retriedFrom)) map.set(record.retriedFrom, []);
-    map.get(record.retriedFrom).push(record);
+  /** retriedFrom → 后继任务列表（自动静默只从事实派生，不缓存、不落偏好）。 */
+  function successorsByRetriedFrom(records) {
+    const map = new Map();
+    for (const record of records) {
+      if (!record.retriedFrom) continue;
+      if (!map.has(record.retriedFrom)) map.set(record.retriedFrom, []);
+      map.get(record.retriedFrom).push(record);
+    }
+    return map;
   }
-  return map;
-}
 
-function suppressedByRetrySuccess(taskId, successors) {
-  return (successors.get(taskId) || [])
-    .some((record) => record.outcome === 'succeeded' && record.deliveryState === 'ready');
-}
+  function suppressedByRetrySuccess(taskId, successors) {
+    return (successors.get(taskId) || [])
+      .some((record) => record.outcome === 'succeeded' && record.deliveryState === 'ready');
+  }
 
-/**
- * 投影行装饰：合并 Host 处置偏好与"重试成功自动静默"派生（每次都是事实重算）。
- * historical 只控制 DSH 分区；canceled 的 Core 五类事实投影仍保持 attention 不变。
- */
-function decorateCoreUserRows(rows, records, prefs) {
-  const successors = successorsByRetriedFrom(records);
-  const recordsById = new Map(records.map((record) => [record.id, record]));
-  return rows.map((row) => Object.freeze({
-    ...row,
-    disposition: attentionDispositionOf(prefs.entries[row.id]),
-    suppressed: suppressedByRetrySuccess(row.id, successors),
-    historical: recordsById.get(row.id)?.outcome === 'canceled'
-  }));
-}
+  /**
+   * 投影行装饰：合并 Host 处置偏好与"重试成功自动静默"派生（每次都是事实重算）。
+   * historical 只控制 DSH 分区；canceled 的 Core 五类事实投影仍保持 attention 不变。
+   */
+  function decorateCoreUserRows(rows, records, prefs) {
+    const successors = successorsByRetriedFrom(records);
+    const recordsById = new Map(records.map((record) => [record.id, record]));
+    return rows.map((row) => Object.freeze({
+      ...row,
+      disposition: attentionDispositionOf(prefs.entries[row.id]),
+      suppressed: suppressedByRetrySuccess(row.id, successors),
+      historical: recordsById.get(row.id)?.outcome === 'canceled'
+    }));
+  }
 
-/** 为 DSH 同源媒体路由读取已验证 hash 的 Core 图片；不创建宿主 URL 或 token。 */
-export async function readCoreArtifactMediaForDsh(artifactId, options = {}) {
-  const id = String(artifactId || '').trim();
-  if (!/^artifact_[a-f0-9]{24}$/.test(id) || !fs.existsSync(dshCoreDataRoot())) {
-    throw new DshCoreAdapterError('IRIS_DSH_ARTIFACT_NOT_FOUND', 'Core Artifact 不存在');
-  }
-  try {
-    const result = await withReader((runtime) => runtime.run('inspect', ({ dataRoot }) =>
-      readCoreArtifactBytes(dataRoot, id)), options.signal);
-    if (!result.artifact.mediaType.startsWith('image/') && result.artifact.mediaType !== 'video/mp4'
-        && result.artifact.mediaType !== 'video/webm' && !result.artifact.mediaType.startsWith('audio/')
-        && result.artifact.mediaType !== 'text/plain' && result.artifact.mediaType !== 'application/json') {
-      throw new DshCoreAdapterError('IRIS_DSH_ARTIFACT_UNSUPPORTED', '当前 DSH 媒体预览不支持此 Artifact 类型');
+  /** 为 DSH 同源媒体路由读取已验证 hash 的 Core 图片；不创建宿主 URL 或 token。 */
+  async function readCoreArtifactMediaForDsh(artifactId, options = {}) {
+    const id = String(artifactId || '').trim();
+    if (!/^artifact_[a-f0-9]{24}$/.test(id) || !fs.existsSync(dataRoot)) {
+      throw new DshCoreAdapterError('IRIS_DSH_ARTIFACT_NOT_FOUND', 'Core Artifact 不存在');
+    }
+    try {
+      const result = await withReader((runtime) => runtime.run('inspect', ({ dataRoot }) =>
+        readCoreArtifactBytes(dataRoot, id)), options.signal);
+      if (!result.artifact.mediaType.startsWith('image/') && result.artifact.mediaType !== 'video/mp4'
+          && result.artifact.mediaType !== 'video/webm' && !result.artifact.mediaType.startsWith('audio/')
+          && result.artifact.mediaType !== 'text/plain' && result.artifact.mediaType !== 'application/json') {
+        throw new DshCoreAdapterError('IRIS_DSH_ARTIFACT_UNSUPPORTED', '当前 DSH 媒体预览不支持此 Artifact 类型');
+      }
+      return result;
+    } catch (error) {
+      if (options.signal?.aborted || error?.code === 'IRIS_APP_CLOSED' || error?.code === 'IRIS_CORE_LEASE_INVALID') throw error;
+      if (error instanceof DshCoreAdapterError) throw error;
+      throw new DshCoreAdapterError('IRIS_DSH_ARTIFACT_NOT_FOUND', 'Core Artifact 不存在');
     }
-    return result;
-  } catch (error) {
-    if (error instanceof DshCoreAdapterError) throw error;
-    throw new DshCoreAdapterError('IRIS_DSH_ARTIFACT_NOT_FOUND', 'Core Artifact 不存在');
   }
-}
 
-/**
- * 将已经 ready 的 Core 图片投影为 DSH attachment blocks。重复调用只重复宿主展示，
- * 不修改 Task/Artifact，也不触发 submit、poll 或 download。
- */
-export async function projectCoreTaskForDsh(host, taskId, options = {}) {
-  const attachments = requireHostPort(host, 'attachments', 'Core 任务产物展示');
-  const materialized = await withReader((runtime) => runtime.run('inspect', ({ dataRoot }) => {
-    const task = inspectCoreTask(dataRoot, taskId);
-    if (task.outcome !== 'succeeded' || task.deliveryState !== 'ready' || !task.artifactIds.length) {
-      throw new DshCoreAdapterError('IRIS_DSH_TASK_NOT_READY', 'Core Task 尚无可展示的本地产物');
+  /**
+   * 将已经 ready 的 Core 图片投影为 DSH attachment blocks。重复调用只重复宿主展示，
+   * 不修改 Task/Artifact，也不触发 submit、poll 或 download。
+   */
+  async function projectCoreTaskForDsh(host, taskId, options = {}) {
+    const attachments = requireHostPort(host, 'attachments', 'Core 任务产物展示');
+    const materialized = await withReader((runtime) => runtime.run('inspect', ({ dataRoot }) => {
+      const task = inspectCoreTask(dataRoot, taskId);
+      if (task.outcome !== 'succeeded' || task.deliveryState !== 'ready' || !task.artifactIds.length) {
+        throw new DshCoreAdapterError('IRIS_DSH_TASK_NOT_READY', 'Core Task 尚无可展示的本地产物');
+      }
+      return {
+        task,
+        artifacts: task.artifactIds.map((artifactId) => readCoreArtifactBytes(dataRoot, artifactId))
+      };
+    }), options.signal);
+
+    const projected = [];
+    for (const item of materialized.artifacts) {
+      if (options.signal?.aborted) throw abortError();
+      if (!item.artifact.mediaType.startsWith('image/')) {
+        throw new DshCoreAdapterError('IRIS_DSH_ARTIFACT_UNSUPPORTED', '当前 DSH 投影只支持图片 Artifact');
+      }
+      let attachment;
+      try {
+        const extension = item.artifact.mediaType === 'image/jpeg' ? 'jpg' : item.artifact.mediaType.slice(6);
+        attachment = await attachments.saveImage({
+          data: new Uint8Array(item.bytes),
+          mediaType: item.artifact.mediaType,
+          name: 'iris-core-' + item.artifact.id + '.' + extension
+        });
+      } catch (_) {
+        throw new DshCoreAdapterError('IRIS_DSH_PROJECTION_FAILED', 'Core 产物无法保存为 DSH attachment');
+      }
+      options.signal.throwIfAborted();
+      if (!attachment || !String(attachment.attachmentId || '').trim()) {
+        throw new DshCoreAdapterError('IRIS_DSH_PROJECTION_FAILED', 'DSH attachment 返回无效');
+      }
+      projected.push(Object.freeze({ artifact: item.artifact, attachment }));
     }
-    return {
-      task,
-      artifacts: task.artifactIds.map((artifactId) => readCoreArtifactBytes(dataRoot, artifactId))
-    };
-  }), options.signal);
 
-  const projected = [];
-  for (const item of materialized.artifacts) {
-    if (options.signal?.aborted) throw abortError();
-    if (!item.artifact.mediaType.startsWith('image/')) {
-      throw new DshCoreAdapterError('IRIS_DSH_ARTIFACT_UNSUPPORTED', '当前 DSH 投影只支持图片 Artifact');
-    }
-    let attachment;
-    try {
-      const extension = item.artifact.mediaType === 'image/jpeg' ? 'jpg' : item.artifact.mediaType.slice(6);
-      attachment = await attachments.saveImage({
-        data: new Uint8Array(item.bytes),
-        mediaType: item.artifact.mediaType,
-        name: 'iris-core-' + item.artifact.id + '.' + extension
-      });
-    } catch (_) {
-      throw new DshCoreAdapterError('IRIS_DSH_PROJECTION_FAILED', 'Core 产物无法保存为 DSH attachment');
-    }
-    if (!attachment || !String(attachment.attachmentId || '').trim()) {
-      throw new DshCoreAdapterError('IRIS_DSH_PROJECTION_FAILED', 'DSH attachment 返回无效');
+    const blocks = [];
+    for (const item of projected) {
+      blocks.push(Object.freeze({
+        type: 'text',
+        text: '[iris] Core 任务完成：' + materialized.task.id
+          + '\nartifact: ' + item.artifact.id + '\nattachment: ' + item.attachment.attachmentId
+      }));
+      blocks.push(Object.freeze({ type: 'image', attachment: item.attachment }));
     }
-    projected.push(Object.freeze({ artifact: item.artifact, attachment }));
+    return Object.freeze({
+      task: materialized.task,
+      artifacts: Object.freeze(projected),
+      blocks: Object.freeze(blocks)
+    });
   }
 
-  const blocks = [];
-  for (const item of projected) {
-    blocks.push(Object.freeze({
-      type: 'text',
-      text: '[iris] Core 任务完成：' + materialized.task.id
-        + '\nartifact: ' + item.artifact.id + '\nattachment: ' + item.attachment.attachmentId
-    }));
-    blocks.push(Object.freeze({ type: 'image', attachment: item.attachment }));
-  }
-  return Object.freeze({
-    task: materialized.task,
-    artifacts: Object.freeze(projected),
-    blocks: Object.freeze(blocks)
+  return Object.freeze({ dataRoot, snapshot, dispose, runHostOperation,
+    importImageForDsh: (...args) => invoke(importImageForDsh, 0, args),
+    cropForDsh: (...args) => invoke(cropForDsh, 0, args),
+    htmlForDsh: (...args) => invoke(htmlForDsh, 0, args),
+    diffForDsh: (...args) => invoke(diffForDsh, 0, args),
+    framesForDsh: (...args) => invoke(framesForDsh, 0, args),
+    summaryFramesForDsh: (...args) => invoke(summaryFramesForDsh, 0, args),
+    visionImageForDsh: (...args) => invoke(visionImageForDsh, 0, args),
+    submitProviderTaskForDsh: (...args) => invoke(submitProviderTaskForDsh, 0, args),
+    submitMusicForDsh: (...args) => invoke(submitMusicForDsh, 0, args),
+    observeProviderTaskForDsh: (...args) => invoke(observeProviderTaskForDsh, 0, args),
+    reobserveProviderTaskForDsh: (...args) => invoke(reobserveProviderTaskForDsh, 0, args),
+    redeliverProviderTaskForDsh: (...args) => invoke(redeliverProviderTaskForDsh, 0, args),
+    cancelProviderTaskForDsh: (...args) => invoke(cancelProviderTaskForDsh, 0, args),
+    disposeCoreTaskAttention: (...args) => invoke(disposeCoreTaskAttention, 0, args),
+    retryProviderTaskForDsh: (...args) => invoke(retryProviderTaskForDsh, 0, args),
+    watchProviderTaskForDsh: (...args) => invoke(watchProviderTaskForDsh, 0, args),
+    resumeProviderTaskWatchesForDsh: (...args) => invoke(resumeProviderTaskWatchesForDsh, 0, args),
+    stopProviderTaskWatchesForDsh,
+    inspectProviderTaskForDsh: (...args) => invoke(inspectProviderTaskForDsh, 1, args),
+    galleryArtifactsForDsh: (...args) => invoke(galleryArtifactsForDsh, 0, args),
+    inspectWorkbenchArtifactForDsh: (...args) => invoke(inspectWorkbenchArtifactForDsh, 1, args),
+    maintainWorkbenchForDsh: (...args) => invoke(maintainWorkbenchForDsh, 2, args),
+    coreSnapshotForDsh: (...args) => invoke(coreSnapshotForDsh, 0, args),
+    readCoreArtifactMediaForDsh: (...args) => invoke(readCoreArtifactMediaForDsh, 1, args),
+    projectCoreTaskForDsh: (...args) => invoke(projectCoreTaskForDsh, 2, args),
   });
 }