@mingmaple/dsh-handover 0.9.14 → 1.0.0

package/src/tools/ho_init.mjs

@@ -1,82 +0,0 @@
-/**
- * ho_init —— 首次安装：在用户给的目录里建「全局文件体系」，可选顺带注册为工作区。
- * 与设置页的「首次安装向导」同一套实现（lib/scaffold.mjs），因此两条路径行为一致。
- */
-import fs from 'node:fs';
-import { nameOf } from '../lib/names.mjs';
-import path from 'node:path';
-import { textOutput } from '../lib/output.mjs';
-import { NL } from '../lib/text.mjs';
-import { createGlobalWorkspace } from '../lib/scaffold.mjs';
-
-export function pmInitTool(env) {
-  return {
-    name: nameOf('init'),
-    description:
-      '首次安装：在指定目录（不存在会创建）下建全局文件体系（根为 <目录>/_Workspace），可顺带注册工作区。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['parent'],
-      properties: {
-        parent: { type: 'string', description: '目标父目录绝对路径（不存在会创建）；全局根建在它里面' },
-        name: { type: 'string', description: '全局根目录名，默认 _Workspace' },
-        register: { type: 'boolean', description: '建好后顺带注册为工作区（默认 false）' },
-        title: { type: 'string', description: 'register 时的工作区标题，默认「全局」' },
-      },
-    },
-    output: textOutput(),
-    async execute(args) {
-      const r = createGlobalWorkspace(args.parent, { name: args.name });
-      const out = [];
-      if (!r.ok) {
-        out.push('未建立：' + r.error);
-        if (r.root) out.push('目标：' + r.root);
-        out.push('');
-        out.push('用法：ho_init(parent="<已存在的目录绝对路径>")。插件只新建、不覆盖。');
-        return { text: out.join(NL) };
-      }
-      out.push('已建立全局文件体系：' + r.root);
-      out.push('  目录 ' + r.created.length + ' 个：' + r.created.slice(0, 5).join('、') + (r.created.length > 5 ? ' 等' : ''));
-      out.push('  文件 ' + r.written.length + ' 个：' + (r.written.length ? r.written.join('、') : '（都已存在，未覆盖）'));
-      if (r.existed) out.push('  目标目录原为空目录，直接使用。');
-      if (r.createdParent) out.push('  父目录原本不存在，已创建。');
-      if (r.skipped.length) out.push('  跳过（已存在、未覆盖）：' + r.skipped.join('、'));
-
-      let registered = null;
-      if (args.register === true) {
-        const reg = env.registry();
-        if (!reg || typeof reg.create !== 'function') {
-          out.push('');
-          out.push('注册未完成：workspaceRegistry 不可用。请把下面这个路径粘进 DSH 的新建工作区窗口：');
-          out.push('  ' + r.root);
-          return { text: out.join(NL) };
-        }
-        const title = String(args.title || '').trim() || '全局';
-        try {
-          const w = await reg.create(r.root, title);
-          registered = w;
-          out.push('');
-          out.push('已注册工作区：' + title + '（' + String(w && w.id ? w.id : '?') + '）');
-        } catch (e) {
-          out.push('');
-          out.push('注册失败：' + String(e && e.message ? e.message : e));
-          out.push('可把下面这个路径粘进 DSH 的新建工作区窗口：');
-          out.push('  ' + r.root);
-          return { text: out.join(NL) };
-        }
-      }
-
-      out.push('');
-      out.push('下一步：');
-      if (!registered) {
-        out.push('  1. 注册为工作区：ho_workspace(action="create", path="' + r.root + '", title="全局")，或把该路径粘进 DSH 的新建工作区窗口；');
-        out.push('  2. 新建一个标题含「全局」的会话，闸门、交接体检、会话水位即接入。');
-      } else {
-        out.push('  新建一个标题含「全局」的会话，闸门、交接体检、会话水位即接入。');
-      }
-      out.push('（也可以在设置页的 dsh-handover 中完成「首次安装」，效果相同。）');
-      return { text: out.join(NL) };
-    },
-  };
-}

package/src/tools/ho_pack.mjs

@@ -1,38 +0,0 @@
-/** ho_pack —— 打包族：action=check（前置闸门）、pack（打包）、verify（校包）、restore（默认预演）。 */
-import { textOutput } from '../lib/output.mjs';
-import { nameOf } from '../lib/names.mjs';
-import { packCheck, packNow, packVerify, packRestore } from '../lib/pack-ops.mjs';
-
-export function pmPackTool(env) {
-  return {
-    name: nameOf('pack'),
-    description: '迁移包四合一：check 前置闸门、pack 打包、verify 校包、restore 恢复（默认预演）。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      properties: {
-        action: { type: 'string', enum: ['check', 'pack', 'verify', 'restore'], description: '缺省 pack' },
-        kind: { type: 'string', enum: ['project', 'task', 'global'], description: 'pack 的目标类型' },
-        name: { type: 'string', description: 'pack 的项目名、任务名' },
-        out: { type: 'string', description: 'pack 的输出目录' },
-        note: { type: 'string', description: 'pack 写进 MIGRATION.md 的说明' },
-        items: { type: 'array', items: { type: 'string' }, description: 'check 检查的项目名（global 表示全局）' },
-        min_age_min: { type: 'number', description: 'check 要求静止分钟（默认 90）' },
-        pack: { type: 'string', description: 'verify/restore 的包路径' },
-        target: { type: 'string', description: 'restore 的目标根（默认当前）' },
-        apply: { type: 'boolean', description: 'restore 时 true 才写入' },
-        dry_run: { type: 'boolean', description: 'pack 只列清单；restore 只预演' },
-        format: { type: 'string', enum: ['auto', '7z', 'tar'], description: 'pack 的归档格式：auto＝有 7-Zip 用 7z，否则内置 tar.gz（默认）' },
-      },
-    },
-    output: textOutput(),
-    async execute(args, exec) {
-      const action = typeof args.action === 'string' && args.action ? args.action : 'pack';
-      if (action === 'check') return { text: packCheck(env, args, exec) };
-      if (action === 'verify') return { text: packVerify(env, args, exec) };
-      if (action === 'restore') return { text: packRestore(env, args, exec) };
-      if (action !== 'pack') throw new Error('未知 action：' + action + '（check、pack、verify、restore）');
-      return { text: packNow(env, args, exec) };
-    },
-  };
-}

package/src/tools/ho_phase.mjs

@@ -1,37 +0,0 @@
-/** ho_phase —— 本会话阶段：水位 / 已压缩次数 / 锁状态 / 建议动作（纯只读，不压缩）。 */
-import { textOutput } from '../lib/output.mjs';
-import { nameOf } from '../lib/names.mjs';
-import { NL } from '../lib/text.mjs';
-import { decide } from '../lib/phase.mjs';
-
-export function pmPhaseTool(env) {
-  return {
-    name: nameOf('phase'),
-    description:
-      '本会话阶段：水位、已压缩次数、锁状态、建议动作。只读。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      properties: {
-        simulateRatio: { type: 'number', description: '演练用：用这个比例替代真实水位（0-1），不写任何状态' },
-      },
-    },
-    output: textOutput(),
-    async execute(args, exec) {
-      const meId = env.selfId(exec);
-      const real = env.selfPct(meId);
-      const ratio = typeof args.simulateRatio === 'number' ? args.simulateRatio : (real === null ? null : real / 100);
-      const count = env.compactionCount(exec);
-      const lock = env.lockState(exec);
-      const adv = decide({ ratio, compactionsUsed: count.used, cfg: env.cfg, lockState: lock });
-      const out = [];
-      out.push('会话      ' + (meId || '未知'));
-      out.push('水位      ' + (ratio === null ? '读不到' : (Math.round(ratio * 1000) / 10).toFixed(1) + '%') + (typeof args.simulateRatio === 'number' ? '  （演练模拟值）' : '') + (typeof env.staleNote === 'function' ? env.staleNote(exec) : ''));
-      const usedText = count.used + '/' + (env.cfg.maxCompactions) + ' 次';
-      out.push('压缩      ' + usedText + (count.note ? '  ' + count.note : ''));
-      out.push('锁        ' + lock);
-      out.push('建议      ' + adv.action + ' —— ' + adv.reason);
-      return { text: out.join(NL) };
-    },
-  };
-}

package/src/tools/ho_snapshot.mjs

@@ -1,104 +0,0 @@
-/** ho_snapshot —— 库快照：逐字节复制 + sha256 清单 + PROVENANCE（Charter §4.4）。 */
-import fs from 'node:fs';
-import { nameOf } from '../lib/names.mjs';
-import path from 'node:path';
-import crypto from 'node:crypto';
-import { textOutput } from '../lib/output.mjs';
-import { NL, isDir } from '../lib/text.mjs';
-import { assertProjectName } from '../lib/role.mjs';
-
-const SKIP_DIRS = ['__pycache__', '.git', 'node_modules', '.obsidian'];
-const SKIP_FILES = ['.DS_Store', 'Thumbs.db'];
-
-function stamp() {
-  const d = new Date();
-  const p = (n) => (n < 10 ? '0' + n : '' + n);
-  return d.getFullYear() + p(d.getMonth() + 1) + p(d.getDate()) + '-' + p(d.getHours()) + p(d.getMinutes());
-}
-
-function walk(root, rel, rows) {
-  for (const name of fs.readdirSync(path.join(root, rel))) {
-    const full = path.join(root, rel, name);
-    const st = fs.statSync(full);
-    const r = rel ? rel + '/' + name : name;
-    if (st.isDirectory()) {
-      if (SKIP_DIRS.indexOf(name) !== -1) continue;
-      walk(root, r, rows);
-    } else if (st.isFile()) {
-      if (SKIP_FILES.indexOf(name) !== -1) continue;
-      if (name.endsWith('.pyc')) continue;
-      rows.push({ rel: r, size: st.size });
-    }
-  }
-  return rows;
-}
-
-export function pmSnapshotTool(env) {
-  return {
-    name: nameOf('snapshot'),
-    description:
-      '库快照：逐字节复制、sha256 清单、来源说明。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['project'],
-      properties: {
-        project: { type: 'string', description: '项目名（Projects/<项目>/ 下）' },
-        tag: { type: 'string', description: '标签，默认 行为检查' },
-        dry_run: { type: 'boolean', description: '只统计不落盘' },
-      },
-    },
-    output: textOutput(),
-    async execute(args, exec) {
-      const ws = env.resolveWs(exec);
-      const project = assertProjectName(typeof args.project === 'string' ? args.project.trim() : '');
-      if (!project) throw new Error('project 不能为空（写项目名，如 Demo）');
-      const projDir = path.join(ws, 'Projects', project);
-      if (!isDir(projDir)) throw new Error('找不到项目：' + projDir);
-      let lib = null;
-      for (const name of fs.readdirSync(projDir)) {
-        const p = path.join(projDir, name);
-        if (isDir(p) && fs.existsSync(path.join(p, 'RULES.md'))) { lib = p; break; }
-      }
-      if (!lib) throw new Error('该项目下没有带 RULES.md 的库根：' + projDir);
-      const rows = walk(lib, '', []);
-      const total = rows.reduce((a, b) => a + b.size, 0);
-      const out = [];
-      out.push('源库 ' + lib);
-      out.push('文件 ' + rows.length + ' 个，共 ' + (total / 1048576).toFixed(2) + ' MB');
-      if (args.dry_run) { out.push('dry_run：不落盘。'); return { text: out.join(NL) }; }
-      const tag = args.tag || '行为检查';
-      const dest = path.join(ws, '_Temp', 'Checks', args.project + '_' + tag + '_' + stamp());
-      if (fs.existsSync(dest)) throw new Error('目标已存在，不覆盖：' + dest);
-      const libDest = path.join(dest, 'lib');
-      fs.mkdirSync(libDest, { recursive: true });
-      const manifest = ['# 源库: ' + lib, '# 文件: ' + rows.length + '  字节: ' + total];
-      let drift = 0;
-      for (const r of rows) {
-        const src = path.join(lib, r.rel);
-        const dst = path.join(libDest, r.rel);
-        fs.mkdirSync(path.dirname(dst), { recursive: true });
-        fs.copyFileSync(src, dst);
-        const h1 = crypto.createHash('sha256').update(fs.readFileSync(src)).digest('hex');
-        const h2 = crypto.createHash('sha256').update(fs.readFileSync(dst)).digest('hex');
-        if (h1 !== h2) drift++;
-        manifest.push(r.rel + String.fromCharCode(9) + r.size + String.fromCharCode(9) + h1);
-      }
-      fs.writeFileSync(path.join(dest, 'MANIFEST.tsv'), manifest.join(NL), 'utf8');
-      const prov = [
-        '# PROVENANCE',
-        '- 源库: ' + lib,
-        '- 生成时间: ' + new Date().toISOString(),
-        '- 发起会话: ' + (env.selfId(exec) || '?'),
-        '- 文件数/字节: ' + rows.length + ' / ' + total,
-        '- 排除: __pycache__ .git node_modules .obsidian *.pyc .DS_Store Thumbs.db',
-        '- 校验: 逐文件 sha256 比对，drift=' + drift,
-        '- 含个人数据，不得外发、不得进 _Archives',
-      ].join(NL);
-      fs.writeFileSync(path.join(dest, 'PROVENANCE.md'), prov, 'utf8');
-      out.push('已落盘 ' + dest);
-      out.push('校验 drift=' + drift + (drift === 0 ? '（逐文件一致）' : '（**不一致，判失败**）'));
-      return { text: out.join(NL) };
-    },
-  };
-}

package/src/tools/ho_tokens.mjs

@@ -1,57 +0,0 @@
-/** ho_tokens —— token 体检（替代 token_probe/token_survey 的常用判据）。 */
-import { textOutput } from '../lib/output.mjs';
-import { nameOf } from '../lib/names.mjs';
-import { NL, pick } from '../lib/text.mjs';
-import { findLog, decodeLog, turnStarts } from '../lib/zstd-log.mjs';
-
-function analyzeLog(records) {
-  const turns = turnStarts(records).length;
-  let steps = 0, outTok = 0, maxResult = 0, toolResults = 0;
-  const perTurn = new Map();
-  for (const r of records) {
-    if (!r || !r.type) continue;
-    if (r.type === 'step/start') {
-      steps++;
-      const t = pick(r, 'data', 'turn');
-      if (typeof t === 'number') perTurn.set(t, (perTurn.get(t) || 0) + 1);
-    } else if (r.type === 'assistant/message') {
-      const u = pick(r, 'data', 'usage');
-      if (u && typeof u.outputTokens === 'number') outTok += u.outputTokens;
-    } else if (r.type === 'tool/result') {
-      toolResults++;
-      try { const len = JSON.stringify(pick(r, 'data') || '').length; if (len > maxResult) maxResult = len; } catch { /* ignore */ }
-    }
-  }
-  const heavyTurns = Array.from(perTurn.values()).filter((n) => n > 20).length;
-  return { turns, steps, outTok, maxResult, toolResults, heavyTurns, perStep: steps ? Math.round(outTok / steps) : 0 };
-}
-
-export function pmTokensTool(env) {
-  return {
-    name: nameOf('tokens'),
-    description:
-      '会话 token 体检：轮数、步数、每步 token、最贵单条返回。只读。',
-    parameters: {
-      type: 'object', additionalProperties: false, required: ['sessions'],
-      properties: { sessions: { type: 'array', items: { type: 'string' }, description: '会话 id 列表' } },
-    },
-    output: textOutput(),
-    async execute(args, exec) {
-      const out = [];
-      const list = Array.isArray(args.sessions) ? args.sessions.filter((s) => typeof s === 'string' && s.trim() !== '') : [];
-      if (!list.length) throw new Error('sessions 不能为空（给会话 id 数组）');
-      out.push('会话 轮 步 输出tok 每步tok 最贵返回 超20步轮 判定');
-      for (const sid of list) {
-        const full = sid.indexOf('session-') === 0 ? sid : 'session-' + sid;
-        const log = findLog(full);
-        if (!log) { out.push(sid + '  ERR 日志找不到'); continue; }
-        const recs = decodeLog(log);
-        if (!recs) { out.push(sid + '  ERR 日志解不出'); continue; }
-        const m = analyzeLog(recs);
-        const verdict = m.perStep > 2000 ? '偏贵（每步 >2k）' : m.heavyTurns > 0 ? '有超 20 步的轮' : '正常';
-        out.push([sid.slice(-8), m.turns, m.steps, m.outTok, m.perStep, Math.round(m.maxResult / 1024) + 'KB', m.heavyTurns, verdict].join('  '));
-      }
-      return { text: out.join(NL) };
-    },
-  };
-}

package/src/tools/peer_list.mjs

@@ -1,37 +0,0 @@
-/** peer_list —— 平级会话一览：id / 项目 / 水位 / 运行状态。只读本地投影缓存，不激活任何会话。 */
-import { textOutput } from '../lib/output.mjs';
-import { peerNameOf } from '../lib/names.mjs';
-import { NL } from '../lib/text.mjs';
-import { readProjCache, rowLine, sessionRows, stamp } from '../lib/peer.mjs';
-
-export function pmPeerListTool(env) {
-  return {
-    name: peerNameOf('list'),
-    description:
-      '会话清点（只读缓存，不激活任何会话）。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      properties: {
-        include_subagents: { type: 'boolean', description: '同时列出 origin=subagent 的子会话' },
-        limit: { type: 'number', description: '最多列出多少行（默认 40）' },
-      },
-    },
-    output: textOutput(),
-    async execute(args) {
-      const controller = env.controller();
-      if (!controller || typeof controller.list !== 'function') {
-        throw new Error('peer_list：sessionController 不可用（插件未注入该服务）');
-      }
-      const limit = Number.isFinite(args.limit) ? Math.max(1, Math.min(200, Math.trunc(args.limit))) : 40;
-      const rows = await sessionRows(controller, args.include_subagents === true);
-      if (rows.length === 0) return { text: 'no sessions' };
-      const lines = rows.slice(0, limit).map((row) => {
-        const cache = readProjCache(row.sessionId);
-        const state = row.running ? 'running' : row.agentAvailable ? 'idle' : 'cold';
-        return rowLine(row.sessionId, cache, state) + ' | ' + stamp(row.updatedAt);
-      });
-      return { text: lines.join(NL) };
-    },
-  };
-}

package/src/tools/peer_new.mjs

@@ -1,75 +0,0 @@
-/** peer_new —— 新建平级会话（无父血缘，永远不会自动通知任何人）。 */
-import { randomUUID } from 'node:crypto';
-import { peerNameOf } from '../lib/names.mjs';
-import { textOutput } from '../lib/output.mjs';
-import { resolveWorkspaceId } from '../lib/peer.mjs';
-
-export function pmPeerNewTool(env) {
-  return {
-    name: peerNameOf('new'),
-    description:
-      '新建平级会话，可指定工作区与标题。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      properties: {
-        cwd: { type: 'string', description: '新会话的工作目录' },
-        workspace: {
-          type: 'string',
-          description:
-            '工作区 id、标题、路径。传入后**直接建立在该工作区内**（cwd 取该工作区的 path），不再归入「未分类」。与 cwd 互斥。',
-        },
-        title: { type: 'string', description: '新会话的显示标题' },
-        message: { type: 'string', description: '可选：投递一条起始消息' },
-      },
-    },
-    output: textOutput(),
-    async execute(args) {
-      const controller = env.controller();
-      if (!controller || typeof controller.create !== 'function') {
-        throw new Error('peer_new：sessionController.create 不可用（插件未注入该服务）');
-      }
-      const wantsWorkspace = typeof args.workspace === 'string' && args.workspace.trim() !== '';
-      if (wantsWorkspace && args.cwd !== undefined) {
-        throw new Error(
-          'peer_new: 传 workspace 时不要再传 cwd —— session.create 只接受其中之一（cwd 会自动取该工作区的 path）',
-        );
-      }
-      let request = {};
-      if (wantsWorkspace) {
-        const workspaceId = resolveWorkspaceId(args.workspace);
-        if (workspaceId === null || workspaceId === undefined) {
-          throw new Error(
-            'peer_new: 找不到工作区「' + args.workspace + '」（可用 id / 标题 / 路径；数据源 storages/workspace.json）',
-          );
-        }
-        request = { workspaceId };
-      } else if (args.cwd !== undefined) {
-        request = { cwd: args.cwd };
-      }
-      const created = await controller.create(request);
-      const id = created.sessionId;
-      if (typeof args.title === 'string' && args.title.trim() !== '') {
-        try {
-          await controller.rename({ sessionId: id, title: args.title.trim() });
-        } catch (error) {
-          if (typeof env.log === 'function') env.log('peer_new: 改标题失败：' + String(error));
-        }
-      }
-      let tail = '';
-      if (typeof args.message === 'string' && args.message.trim() !== '') {
-        await controller.prompt(
-          {
-            requestId: randomUUID(),
-            sessionId: id,
-            mode: 'queue',
-            content: [{ type: 'text', text: args.message }],
-          },
-          new AbortController().signal,
-        );
-        tail = ' (opening message delivered)';
-      }
-      return { text: 'created ' + id + tail };
-    },
-  };
-}

package/src/tools/peer_peek.mjs

@@ -1,41 +0,0 @@
-/** peer_peek —— 可选监测：读另一个会话日志里最近若干条对话。只读，但内容进本会话上下文。 */
-import { textOutput } from '../lib/output.mjs';
-import { peerNameOf } from '../lib/names.mjs';
-import { NL } from '../lib/text.mjs';
-import { findSessionLog, decodeSessionLog, conversation, stamp } from '../lib/peer.mjs';
-
-export function pmPeerPeekTool(env) {
-  return {
-    name: peerNameOf('peek'),
-    description:
-      '查看指定会话近期的对话（消耗本会话 token）。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['session_id'],
-      properties: {
-        session_id: { type: 'string', description: '目标会话 id' },
-        limit: { type: 'number', description: '取最近多少条（默认 8，上限 40）' },
-      },
-    },
-    output: textOutput(),
-    async execute(args) {
-      const limit = Number.isFinite(args.limit) ? Math.max(1, Math.min(40, Math.trunc(args.limit))) : 8;
-      const file = findSessionLog(args.session_id);
-      if (file === null) return { text: 'no session log found for ' + args.session_id };
-      const events = decodeSessionLog(file);
-      if (events === null) return { text: 'this Node build has no zstd support; cannot read the session log' };
-      const items = conversation(events, limit);
-      const head = 'session ' + args.session_id + '  |  最近 ' + String(items.length) + ' 条  |  ' + file;
-      if (items.length === 0) return { text: head + NL + '(没有可读的对话内容)' };
-      const body = items
-        .map((it) => {
-          const one = it.text.replace(/\s+/g, ' ').trim();
-          const cut = one.length > 400 ? one.slice(0, 400) + ' …' : one;
-          return '[' + stamp(it.t) + ' ' + it.who + '] ' + cut;
-        })
-        .join(NL);
-      return { text: head + NL + body };
-    },
-  };
-}

package/src/tools/peer_rename.mjs

@@ -1,31 +0,0 @@
-/** peer_rename —— 改会话显示标题：命名约定 项目会话 <项目名><N>、全局 全局<N>。 */
-import { textOutput } from '../lib/output.mjs';
-import { peerNameOf } from '../lib/names.mjs';
-
-export function pmPeerRenameTool(env) {
-  return {
-    name: peerNameOf('rename'),
-    description:
-      '只改显示标题，不唤醒目标会话。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['session_id', 'title'],
-      properties: {
-        session_id: { type: 'string', description: '目标会话 id' },
-        title: { type: 'string', description: '新的显示标题（如 Demo4 / DemoB4 / 全局11）' },
-      },
-    },
-    output: textOutput(),
-    async execute(args) {
-      const controller = env.controller();
-      if (!controller || typeof controller.rename !== 'function') {
-        throw new Error('peer_rename：sessionController.rename 不可用（插件未注入该服务）');
-      }
-      const title = String(args.title ?? '').trim();
-      if (title === '') throw new Error('peer_rename: title 不能为空');
-      await controller.rename({ sessionId: args.session_id, title });
-      return { text: 'renamed ' + args.session_id + ' -> ' + title };
-    },
-  };
-}

package/src/tools/peer_send.mjs

@@ -1,52 +0,0 @@
-/** peer_send —— 给指定会话投一条消息：唯一会花对方 token 的动作。 */
-import { randomUUID } from 'node:crypto';
-import { peerNameOf } from '../lib/names.mjs';
-import { textOutput } from '../lib/output.mjs';
-import { NL } from '../lib/text.mjs';
-import { peerMarker } from '../lib/peer.mjs';
-
-export function pmPeerSendTool(env) {
-  return {
-    name: peerNameOf('send'),
-    description:
-      '向指定会话投递一条消息；唯一会消耗对方 token 的动作，尽量少用。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['session_id', 'message'],
-      properties: {
-        session_id: { type: 'string', description: '目标会话 id' },
-        message: { type: 'string', description: '要投递的正文' },
-        mode: { type: 'string', enum: ['queue', 'steer'], description: 'queue（默认）或 steer' },
-      },
-    },
-    output: textOutput(),
-    async execute(args, exec) {
-      const controller = env.controller();
-      if (!controller || typeof controller.prompt !== 'function') {
-        throw new Error('peer_send：sessionController.prompt 不可用（插件未注入该服务）');
-      }
-      const message = typeof args.message === 'string' ? args.message : '';
-      if (message.trim() === '') throw new Error('message 不能为空');
-      const mode = args.mode === 'steer' ? 'steer' : 'queue';
-      // 来源标记：dsh 把宿主投递的消息记成 source.kind === "user"，不加标记的话，
-      // 平级会话的消息在日志和界面上与用户消息完全无法区分。
-      const sender = exec?.agent?.session?.header?.id ?? 'unknown';
-      const marker = peerMarker(sender);
-      const body = message.startsWith(marker) ? message : marker + NL + message;
-      const receipt = await controller.prompt(
-        {
-          requestId: randomUUID(),
-          sessionId: args.session_id,
-          mode,
-          content: [{ type: 'text', text: body }],
-        },
-        new AbortController().signal,
-      );
-      return {
-        text:
-          'accepted=' + String(receipt.accepted) + ' mode=' + mode + ' target=' + args.session_id + ' from=' + sender,
-      };
-    },
-  };
-}

package/src/tools/peer_status.mjs

@@ -1,46 +0,0 @@
-/** peer_status —— 单个会话的详细状态（水位 / 运行状态 / 轮步 / cwd / preset / 平级或子会话）。只读本地。 */
-import { textOutput } from '../lib/output.mjs';
-import { peerNameOf } from '../lib/names.mjs';
-import { NL } from '../lib/text.mjs';
-import { readProjCache, pressurePct, isSubagent, isBusy, projectName, pick, sessionRows, stamp } from '../lib/peer.mjs';
-
-export function pmPeerStatusTool(env) {
-  return {
-    name: peerNameOf('status'),
-    description:
-      '单会话详情：水位、运行状态、轮数、步数、工作目录。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['session_id'],
-      properties: {
-        session_id: { type: 'string', description: '目标会话 id' },
-      },
-    },
-    output: textOutput(),
-    async execute(args) {
-      const controller = env.controller();
-      if (!controller || typeof controller.list !== 'function') {
-        throw new Error('peer_status：sessionController 不可用（插件未注入该服务）');
-      }
-      const cache = readProjCache(args.session_id);
-      const rows = await sessionRows(controller, true);
-      const row = rows.find((r) => r.sessionId === args.session_id) ?? null;
-      if (cache === null && row === null) return { text: 'unknown session: ' + args.session_id };
-      const stats = pick(cache, 'record', 'rows', 'sessionStats', 'val') ?? {};
-      const pct = cache === null ? null : pressurePct(cache);
-      const lines = [
-        'session  ' + args.session_id,
-        'kind     ' + (cache === null ? '?' : isSubagent(cache) ? '子会话（subagent）' : '平级会话（peer）'),
-        'project  ' + (cache === null ? '-' : projectName(cache)),
-        'pressure ' + (pct === null ? '?' : pct.toFixed(1) + '%') + (pct !== null && pct >= 32 ? '  已进入预警区' : ''),
-        'state    ' + (isBusy(cache) === true ? 'running' : row === null ? 'cold' : row.agentAvailable ? 'idle' : 'cold'),
-        'turns    ' + String(stats.turns ?? '?') + '   steps ' + String(stats.steps ?? '?'),
-        'cwd      ' + String(row?.cwd ?? pick(cache, 'record', 'identity', 'cwd') ?? '-'),
-        'preset   ' + String(pick(cache, 'record', 'rows', 'agentPreset', 'val') ?? '-'),
-        'updated  ' + stamp(row?.updatedAt ?? pick(cache, 'record', 'identity', 'createdAt')),
-      ];
-      return { text: lines.join(NL) };
-    },
-  };
-}