@mingmaple/dsh-handover 0.0.0-stage → 0.9.12

package/src/tools/peer_list.mjs

@@ -0,0 +1,37 @@
+/** 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

@@ -0,0 +1,75 @@
+/** 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

@@ -0,0 +1,41 @@
+/** 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

@@ -0,0 +1,31 @@
+/** 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

@@ -0,0 +1,52 @@
+/** 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

@@ -0,0 +1,46 @@
+/** 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) };
+    },
+  };
+}