@wangchenglai/dsh-acp-session 0.1.0 → 0.1.1

package/lib/replay.js

@@ -1,94 +1,94 @@
-/**
- * 把 dsh 的会话事件翻译成 ACP 的 session/update 通知。
- *
- * 这对应 ACP 里 session/load 的语义："把历史按标准更新回放给客户端"。
- * 形状与 net-agent 的 AcpClientBridge.handleSessionUpdate 对得上：
- * user_message_chunk / agent_message_chunk / agent_thought_chunk /
- * tool_call / tool_call_update。
- */
-
-import { reasoningOf, textOf, isRealUserMessage } from './store.js';
-
-function parseMaybeJson(value) {
-  if (typeof value !== 'string') return value;
-  try {
-    return JSON.parse(value);
-  } catch {
-    return value;
-  }
-}
-
-/**
- * @param events - dsh 的 SessionEvent 数组
- * @returns ACP SessionUpdate 数组（按原顺序）
- */
-export function replayUpdates(events) {
-  const updates = [];
-
-  for (const event of events) {
-    const data = event?.data ?? {};
-
-    switch (event?.type) {
-      case 'user/message': {
-        if (!isRealUserMessage(event)) break;
-        const text = textOf(data.content);
-        if (text) {
-          updates.push({
-            sessionUpdate: 'user_message_chunk',
-            content: { type: 'text', text },
-          });
-        }
-        break;
-      }
-
-      case 'assistant/message': {
-        const content = data?.message?.content;
-        const reasoning = reasoningOf(content);
-        if (reasoning) {
-          updates.push({
-            sessionUpdate: 'agent_thought_chunk',
-            content: { type: 'text', text: reasoning },
-          });
-        }
-        const text = textOf(content);
-        if (text) {
-          updates.push({
-            sessionUpdate: 'agent_message_chunk',
-            content: { type: 'text', text },
-          });
-        }
-        break;
-      }
-
-      case 'tool/call': {
-        if (!data.callId) break;
-        updates.push({
-          sessionUpdate: 'tool_call',
-          toolCallId: String(data.callId),
-          title: typeof data.name === 'string' && data.name ? data.name : 'tool',
-          kind: 'other',
-          status: 'completed',
-          rawInput: parseMaybeJson(data.arguments),
-        });
-        break;
-      }
-
-      case 'tool/result': {
-        const message = data?.message ?? {};
-        const callId = message.toolCallId ?? message?.source?.callId;
-        if (!callId) break;
-        updates.push({
-          sessionUpdate: 'tool_call_update',
-          toolCallId: String(callId),
-          status: message.isError ? 'failed' : 'completed',
-        });
-        break;
-      }
-
-      default:
-        break;
-    }
-  }
-
-  return updates;
-}
+/**
+ * 把 dsh 的会话事件翻译成 ACP 的 session/update 通知。
+ *
+ * 这对应 ACP 里 session/load 的语义："把历史按标准更新回放给客户端"。
+ * 形状与 net-agent 的 AcpClientBridge.handleSessionUpdate 对得上：
+ * user_message_chunk / agent_message_chunk / agent_thought_chunk /
+ * tool_call / tool_call_update。
+ */
+
+import { reasoningOf, textOf, isRealUserMessage } from './store.js';
+
+function parseMaybeJson(value) {
+  if (typeof value !== 'string') return value;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return value;
+  }
+}
+
+/**
+ * @param events - dsh 的 SessionEvent 数组
+ * @returns ACP SessionUpdate 数组（按原顺序）
+ */
+export function replayUpdates(events) {
+  const updates = [];
+
+  for (const event of events) {
+    const data = event?.data ?? {};
+
+    switch (event?.type) {
+      case 'user/message': {
+        if (!isRealUserMessage(event)) break;
+        const text = textOf(data.content);
+        if (text) {
+          updates.push({
+            sessionUpdate: 'user_message_chunk',
+            content: { type: 'text', text },
+          });
+        }
+        break;
+      }
+
+      case 'assistant/message': {
+        const content = data?.message?.content;
+        const reasoning = reasoningOf(content);
+        if (reasoning) {
+          updates.push({
+            sessionUpdate: 'agent_thought_chunk',
+            content: { type: 'text', text: reasoning },
+          });
+        }
+        const text = textOf(content);
+        if (text) {
+          updates.push({
+            sessionUpdate: 'agent_message_chunk',
+            content: { type: 'text', text },
+          });
+        }
+        break;
+      }
+
+      case 'tool/call': {
+        if (!data.callId) break;
+        updates.push({
+          sessionUpdate: 'tool_call',
+          toolCallId: String(data.callId),
+          title: typeof data.name === 'string' && data.name ? data.name : 'tool',
+          kind: 'other',
+          status: 'completed',
+          rawInput: parseMaybeJson(data.arguments),
+        });
+        break;
+      }
+
+      case 'tool/result': {
+        const message = data?.message ?? {};
+        const callId = message.toolCallId ?? message?.source?.callId;
+        if (!callId) break;
+        updates.push({
+          sessionUpdate: 'tool_call_update',
+          toolCallId: String(callId),
+          status: message.isError ? 'failed' : 'completed',
+        });
+        break;
+      }
+
+      default:
+        break;
+    }
+  }
+
+  return updates;
+}

package/lib/store.js

@@ -1,156 +1,156 @@
-/**
- * 通过 dsh 自己的 sessionPersistence 服务读取会话。
- *
- * 不直接解压 session.v4.jsonl.zstd：持久化后端已经做了分帧解压和格式校验，
- * 用它既少一份解析代码，也不会跟着 dsh 的内部格式变动而失效。
- */
-
-import { rm } from 'node:fs/promises';
-import { dirname } from 'node:path';
-
-/** 取 content 数组里的文本片段。 */
-export function textOf(content) {
-  if (!Array.isArray(content)) return '';
-  let text = '';
-  for (const item of content) {
-    if (item && item.type === 'text' && typeof item.text === 'string') text += item.text;
-  }
-  return text;
-}
-
-/** 取 content 数组里的推理片段。 */
-export function reasoningOf(content) {
-  if (!Array.isArray(content)) return '';
-  let text = '';
-  for (const item of content) {
-    if (item && item.type === 'reasoning' && typeof item.text === 'string') text += item.text;
-  }
-  return text;
-}
-
-/**
- * 是否是真人输入的消息。
- *
- * dsh 会把运行时注入的上下文也写成 user/message，只有 source.kind === 'user'
- * 才是用户在聊天框里真的说的话。
- */
-export function isRealUserMessage(event) {
-  return event?.data?.source?.kind === 'user';
-}
-
-function firstUserText(events, limit) {
-  for (const event of events) {
-    if (event?.type !== 'user/message' || !isRealUserMessage(event)) continue;
-    const text = textOf(event?.data?.content).trim();
-    if (text) return text.slice(0, limit);
-  }
-  return '';
-}
-
-/**
- * 从会话头的元数据和事件流里提炼列表页需要的字段。
- *
- * @param header - sessionPersistence.list()/stat() 给出的 header（可缺省）
- * @param events - sessionPersistence.readStoredLog() 解出的事件
- * @returns {{id: string|undefined, cwd: string, title: string, updatedAt: string|null, messageCount: number}}
- */
-export function summarize(header, events) {
-  let cwd = header?.cwd ?? '';
-  let title = '';
-  let updatedAt = typeof header?.createdAt === 'number' ? header.createdAt : null;
-  let messageCount = 0;
-
-  for (const event of events) {
-    const time = event?.time;
-    if (typeof time === 'number' && (updatedAt === null || time > updatedAt)) updatedAt = time;
-
-    switch (event?.type) {
-      case 'session':
-        if (!cwd && typeof event?.data?.cwd === 'string') cwd = event.data.cwd;
-        if (updatedAt === null && typeof event?.createdAt === 'number') updatedAt = event.createdAt;
-        break;
-      case 'session/title':
-        if (typeof event?.data?.title === 'string') title = event.data.title;
-        break;
-      case 'user/message':
-        if (isRealUserMessage(event)) messageCount += 1;
-        break;
-      case 'assistant/message':
-        messageCount += 1;
-        break;
-      default:
-        break;
-    }
-  }
-
-  if (!title) title = firstUserText(events, 20);
-
-  return {
-    id: header?.id,
-    cwd,
-    title,
-    updatedAt: updatedAt === null ? null : new Date(updatedAt).toISOString(),
-    messageCount,
-  };
-}
-
-/**
- * 读出某个会话的全部事件。
- *
- * @returns 事件数组；**读不到日志时返回 null**（不是空数组）。
- *
- * 读不到有两种情况，必须和"确实是空会话"区分开：
- *   - 会话不存在
- *   - 会话正被当前 dsh 进程持有（正在聊天），此时 resolveCurrentLog 拿不到路径
- * 后者如果当成空会话，正在用的那条就会从列表里消失。
- */
-export async function readSessionEvents(persistence, sessionId) {
-  const path = await persistence.resolveCurrentLog(sessionId);
-  if (!path) return null;
-  const stored = await persistence.readStoredLog(path, sessionId);
-  return Array.isArray(stored?.events) ? stored.events : null;
-}
-
-/**
- * 提炼单个会话的摘要（标题、更新时间、消息数）。
- *
- * @returns messageCount 为 null 表示"读不到日志、内容未知"——调用方不应据此过滤。
- */
-export async function describeSession(persistence, sessionId) {
-  const events = await readSessionEvents(persistence, sessionId);
-  if (events !== null) return summarize({ id: sessionId }, events);
-
-  // 读不到日志时用元数据兜底：至少把 cwd 和创建时间填上
-  let header = { id: sessionId };
-  try {
-    const snapshot = await persistence.stat(sessionId);
-    if (snapshot?.header) header = snapshot.header;
-  } catch {
-    // 元数据也拿不到就保持最小信息
-  }
-
-  return {
-    id: sessionId,
-    cwd: header.cwd ?? '',
-    title: '',
-    updatedAt: typeof header.createdAt === 'number'
-      ? new Date(header.createdAt).toISOString()
-      : null,
-    messageCount: null,
-  };
-}
-
-/**
- * 删除一个会话。
- *
- * dsh 的 SessionPersistence 没有 delete，但提供了 resolveCurrentLog 找到
- * 当前产物路径；一个会话目录里只有它的日志，整目录删掉即可。
- *
- * @returns 是否真的删掉了（会话不存在时返回 false）
- */
-export async function removeSession(persistence, sessionId) {
-  const path = await persistence.resolveCurrentLog(sessionId);
-  if (!path) return false;
-  await rm(dirname(path), { recursive: true, force: true });
-  return true;
-}
+/**
+ * 通过 dsh 自己的 sessionPersistence 服务读取会话。
+ *
+ * 不直接解压 session.v4.jsonl.zstd：持久化后端已经做了分帧解压和格式校验，
+ * 用它既少一份解析代码，也不会跟着 dsh 的内部格式变动而失效。
+ */
+
+import { rm } from 'node:fs/promises';
+import { dirname } from 'node:path';
+
+/** 取 content 数组里的文本片段。 */
+export function textOf(content) {
+  if (!Array.isArray(content)) return '';
+  let text = '';
+  for (const item of content) {
+    if (item && item.type === 'text' && typeof item.text === 'string') text += item.text;
+  }
+  return text;
+}
+
+/** 取 content 数组里的推理片段。 */
+export function reasoningOf(content) {
+  if (!Array.isArray(content)) return '';
+  let text = '';
+  for (const item of content) {
+    if (item && item.type === 'reasoning' && typeof item.text === 'string') text += item.text;
+  }
+  return text;
+}
+
+/**
+ * 是否是真人输入的消息。
+ *
+ * dsh 会把运行时注入的上下文也写成 user/message，只有 source.kind === 'user'
+ * 才是用户在聊天框里真的说的话。
+ */
+export function isRealUserMessage(event) {
+  return event?.data?.source?.kind === 'user';
+}
+
+function firstUserText(events, limit) {
+  for (const event of events) {
+    if (event?.type !== 'user/message' || !isRealUserMessage(event)) continue;
+    const text = textOf(event?.data?.content).trim();
+    if (text) return text.slice(0, limit);
+  }
+  return '';
+}
+
+/**
+ * 从会话头的元数据和事件流里提炼列表页需要的字段。
+ *
+ * @param header - sessionPersistence.list()/stat() 给出的 header（可缺省）
+ * @param events - sessionPersistence.readStoredLog() 解出的事件
+ * @returns {{id: string|undefined, cwd: string, title: string, updatedAt: string|null, messageCount: number}}
+ */
+export function summarize(header, events) {
+  let cwd = header?.cwd ?? '';
+  let title = '';
+  let updatedAt = typeof header?.createdAt === 'number' ? header.createdAt : null;
+  let messageCount = 0;
+
+  for (const event of events) {
+    const time = event?.time;
+    if (typeof time === 'number' && (updatedAt === null || time > updatedAt)) updatedAt = time;
+
+    switch (event?.type) {
+      case 'session':
+        if (!cwd && typeof event?.data?.cwd === 'string') cwd = event.data.cwd;
+        if (updatedAt === null && typeof event?.createdAt === 'number') updatedAt = event.createdAt;
+        break;
+      case 'session/title':
+        if (typeof event?.data?.title === 'string') title = event.data.title;
+        break;
+      case 'user/message':
+        if (isRealUserMessage(event)) messageCount += 1;
+        break;
+      case 'assistant/message':
+        messageCount += 1;
+        break;
+      default:
+        break;
+    }
+  }
+
+  if (!title) title = firstUserText(events, 20);
+
+  return {
+    id: header?.id,
+    cwd,
+    title,
+    updatedAt: updatedAt === null ? null : new Date(updatedAt).toISOString(),
+    messageCount,
+  };
+}
+
+/**
+ * 读出某个会话的全部事件。
+ *
+ * @returns 事件数组；**读不到日志时返回 null**（不是空数组）。
+ *
+ * 读不到有两种情况，必须和"确实是空会话"区分开：
+ *   - 会话不存在
+ *   - 会话正被当前 dsh 进程持有（正在聊天），此时 resolveCurrentLog 拿不到路径
+ * 后者如果当成空会话，正在用的那条就会从列表里消失。
+ */
+export async function readSessionEvents(persistence, sessionId) {
+  const path = await persistence.resolveCurrentLog(sessionId);
+  if (!path) return null;
+  const stored = await persistence.readStoredLog(path, sessionId);
+  return Array.isArray(stored?.events) ? stored.events : null;
+}
+
+/**
+ * 提炼单个会话的摘要（标题、更新时间、消息数）。
+ *
+ * @returns messageCount 为 null 表示"读不到日志、内容未知"——调用方不应据此过滤。
+ */
+export async function describeSession(persistence, sessionId) {
+  const events = await readSessionEvents(persistence, sessionId);
+  if (events !== null) return summarize({ id: sessionId }, events);
+
+  // 读不到日志时用元数据兜底：至少把 cwd 和创建时间填上
+  let header = { id: sessionId };
+  try {
+    const snapshot = await persistence.stat(sessionId);
+    if (snapshot?.header) header = snapshot.header;
+  } catch {
+    // 元数据也拿不到就保持最小信息
+  }
+
+  return {
+    id: sessionId,
+    cwd: header.cwd ?? '',
+    title: '',
+    updatedAt: typeof header.createdAt === 'number'
+      ? new Date(header.createdAt).toISOString()
+      : null,
+    messageCount: null,
+  };
+}
+
+/**
+ * 删除一个会话。
+ *
+ * dsh 的 SessionPersistence 没有 delete，但提供了 resolveCurrentLog 找到
+ * 当前产物路径；一个会话目录里只有它的日志，整目录删掉即可。
+ *
+ * @returns 是否真的删掉了（会话不存在时返回 false）
+ */
+export async function removeSession(persistence, sessionId) {
+  const path = await persistence.resolveCurrentLog(sessionId);
+  if (!path) return false;
+  await rm(dirname(path), { recursive: true, force: true });
+  return true;
+}

package/package.json

@@ -1,39 +1,38 @@
-{
-  "name": "@wangchenglai/dsh-acp-session",
-  "version": "0.1.0",
-  "description": "为 DeepSeek Harness 的 ACP 补上 session/load、session/delete，并让 session/list 带标题与更新时间",
-  "keywords": [
-    "acp",
-    "deepseek",
-    "dsh",
-    "agent"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://gitservice.cstcloud.cn/jfli/agent-backend.git",
-    "directory": "jupyter/dsh-plugins/acp-session"
-  },
-  "type": "module",
-  "main": "index.js",
-  "exports": {
-    ".": "./index.js"
-  },
-  "files": [
-    "index.js",
-    "lib",
-    "profile-patch.yml",
-    "start-acp.sh",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "license": "MIT",
-  "dependencies": {
-    "@agentclientprotocol/sdk": "1.4.0",
-    "@deepseek-ai/dsh-acp": "0.2.0-rc.2"
-  }
-}
+{
+  "name": "@wangchenglai/dsh-acp-session",
+  "version": "0.1.1",
+  "description": "为 DeepSeek Harness 的 ACP 补上 session/load、session/delete，并让 session/list 带标题与更新时间",
+  "keywords": [
+    "acp",
+    "deepseek",
+    "dsh",
+    "agent"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://gitservice.cstcloud.cn/WangChengLai/dsh-acp-session.git"
+  },
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "lib",
+    "profile-patch.yml",
+    "start-acp.sh",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@agentclientprotocol/sdk": "1.4.0",
+    "@deepseek-ai/dsh-acp": "0.2.0-rc.2"
+  }
+}

package/profile-patch.yml

@@ -1,15 +1,15 @@
-# 叠加到 acp profile 上的一层 patch（用 dsh --profile acp --patch <本文件> 加载）。
-#
-# 1) 关掉 dsh 自带的 ACP 插件——stdio 只能由一个插件接管；
-# 2) 挂载本插件，config 里的 provider/model 与原来的 acp 行保持一致。
-
-- id: acp
-  disabled: true
-
-- insert:
-    - id: acp-session
-      name: '@wangchenglai/dsh-acp-session'
-      inject: [acpAppStartup]
-      config:
-        provider: deepseek-official
-        model: deepseek-v4-flash
+# 叠加到 acp profile 上的一层 patch（用 dsh --profile acp --patch <本文件> 加载）。
+#
+# 1) 关掉 dsh 自带的 ACP 插件——stdio 只能由一个插件接管；
+# 2) 挂载本插件，config 里的 provider/model 与原来的 acp 行保持一致。
+
+- id: acp
+  disabled: true
+
+- insert:
+    - id: acp-session
+      name: '@wangchenglai/dsh-acp-session'
+      inject: [acpAppStartup]
+      config:
+        provider: deepseek-official
+        model: deepseek-v4-flash