@yeaft/webchat-agent 0.1.60 → 0.1.61

package/claude.js

@@ -1,7 +1,7 @@
 import { query, Stream } from './sdk/index.js';
 import ctx from './context.js';
 import { sendConversationList, sendOutput, sendError, handleAskUserQuestion } from './conversation.js';
-import { buildVCrewSystemPrompt } from './vcrew.js';
+import { buildRolePlaySystemPrompt } from './roleplay.js';
 
 /**
  * Start a Claude SDK query for a conversation
@@ -10,13 +10,13 @@ import { buildVCrewSystemPrompt } from './vcrew.js';
 export async function startClaudeQuery(conversationId, workDir, resumeSessionId) {
   // 如果已存在，先保存 per-session 设置，再关闭
   let savedDisallowedTools = null;
-  let savedVcrewConfig = null;
+  let savedRolePlayConfig = null;
   let savedUserId = undefined;
   let savedUsername = undefined;
   if (ctx.conversations.has(conversationId)) {
     const existing = ctx.conversations.get(conversationId);
     savedDisallowedTools = existing.disallowedTools ?? null;
-    savedVcrewConfig = existing.vcrewConfig ?? null;
+    savedRolePlayConfig = existing.rolePlayConfig ?? null;
     savedUserId = existing.userId;
     savedUsername = existing.username;
     if (existing.abortController) {
@@ -54,8 +54,8 @@ export async function startClaudeQuery(conversationId, workDir, resumeSessionId)
     backgroundTasks: new Map(),
     // Per-session 工具禁用设置
     disallowedTools: savedDisallowedTools,
-    // Virtual Crew config (for appendSystemPrompt injection)
-    vcrewConfig: savedVcrewConfig,
+    // Role Play config (for appendSystemPrompt injection)
+    rolePlayConfig: savedRolePlayConfig,
     // 保留用户信息（从旧 state 恢复）
     userId: savedUserId,
     username: savedUsername,
@@ -85,10 +85,10 @@ export async function startClaudeQuery(conversationId, workDir, resumeSessionId)
     console.log(`[SDK] Disallowed tools: ${effectiveDisallowedTools.join(', ')}`);
   }
 
-  // Virtual Crew: inject appendSystemPrompt with role descriptions and workflow
-  if (savedVcrewConfig) {
-    options.appendSystemPrompt = buildVCrewSystemPrompt(savedVcrewConfig);
-    console.log(`[SDK] VCrew appendSystemPrompt injected (teamType: ${savedVcrewConfig.teamType})`);
+  // Role Play: inject appendSystemPrompt with role descriptions and workflow
+  if (savedRolePlayConfig) {
+    options.appendSystemPrompt = buildRolePlaySystemPrompt(savedRolePlayConfig);
+    console.log(`[SDK] RolePlay appendSystemPrompt injected (teamType: ${savedRolePlayConfig.teamType})`);
   }
 
   // Validate session ID is a valid UUID before using it

package/conversation.js

@@ -2,10 +2,10 @@ import ctx from './context.js';
 import { loadSessionHistory } from './history.js';
 import { startClaudeQuery } from './claude.js';
 import { crewSessions, loadCrewIndex } from './crew.js';
-import { vcrewSessions, saveVCrewIndex, removeVCrewSession, loadVCrewIndex, validateVCrewConfig } from './vcrew.js';
+import { rolePlaySessions, saveRolePlayIndex, removeRolePlaySession, loadRolePlayIndex, validateRolePlayConfig } from './roleplay.js';
 
-// Restore persisted vcrew sessions on module load (agent startup)
-loadVCrewIndex();
+// Restore persisted roleplay sessions on module load (agent startup)
+loadRolePlayIndex();
 
 // 不支持的斜杠命令（真正需要交互式 CLI 的命令）
 const UNSUPPORTED_SLASH_COMMANDS = ['/help', '/bug', '/login', '/logout', '/terminal-setup', '/vim', '/config'];
@@ -38,7 +38,7 @@ export function parseSlashCommand(message) {
   return { type: null, message };
 }
 
-// 发送 conversation 列表（含活跃 crew sessions + 索引中已停止的 crew sessions + vcrew sessions）
+// 发送 conversation 列表（含活跃 crew sessions + 索引中已停止的 crew sessions + roleplay sessions）
 export async function sendConversationList() {
   const list = [];
   for (const [id, state] of ctx.conversations) {
@@ -51,10 +51,10 @@ export async function sendConversationList() {
       userId: state.userId,
       username: state.username
     };
-    // vcrew conversations are stored in ctx.conversations but also tracked in vcrewSessions
-    if (vcrewSessions.has(id)) {
-      entry.type = 'virtualCrew';
-      entry.vcrewRoles = vcrewSessions.get(id).roles;
+    // roleplay conversations are stored in ctx.conversations but also tracked in rolePlaySessions
+    if (rolePlaySessions.has(id)) {
+      entry.type = 'rolePlay';
+      entry.rolePlayRoles = rolePlaySessions.get(id).roles;
     }
     list.push(entry);
   }
@@ -118,21 +118,21 @@ export async function createConversation(msg) {
   const { conversationId, workDir, userId, username, disallowedTools } = msg;
   const effectiveWorkDir = workDir || ctx.CONFIG.workDir;
 
-  // Validate and sanitize vcrewConfig if provided
-  let vcrewConfig = null;
-  if (msg.vcrewConfig) {
-    const result = validateVCrewConfig(msg.vcrewConfig);
+  // Validate and sanitize rolePlayConfig if provided
+  let rolePlayConfig = null;
+  if (msg.rolePlayConfig) {
+    const result = validateRolePlayConfig(msg.rolePlayConfig);
     if (!result.valid) {
-      console.warn(`[createConversation] Invalid vcrewConfig: ${result.error}`);
-      sendError(conversationId, `Invalid vcrewConfig: ${result.error}`);
+      console.warn(`[createConversation] Invalid rolePlayConfig: ${result.error}`);
+      sendError(conversationId, `Invalid rolePlayConfig: ${result.error}`);
       return;
     }
-    vcrewConfig = result.config;
+    rolePlayConfig = result.config;
   }
 
   console.log(`Creating conversation: ${conversationId} in ${effectiveWorkDir} (lazy start)`);
   if (username) console.log(`  User: ${username} (${userId})`);
-  if (vcrewConfig) console.log(`  VCrew: teamType=${vcrewConfig.teamType}, roles=${vcrewConfig.roles?.length}`);
+  if (rolePlayConfig) console.log(`  RolePlay: teamType=${rolePlayConfig.teamType}, roles=${rolePlayConfig.roles?.length}`);
 
   // 只创建 conversation 状态，不启动 Claude 进程
   // Claude 进程会在用户发送第一条消息时启动 (见 handleUserInput)
@@ -149,7 +149,7 @@ export async function createConversation(msg) {
     userId,
     username,
     disallowedTools: disallowedTools || null,  // null = 使用全局默认
-    vcrewConfig: vcrewConfig || null,
+    rolePlayConfig: rolePlayConfig || null,
     usage: {
       inputTokens: 0,
       outputTokens: 0,
@@ -159,18 +159,18 @@ export async function createConversation(msg) {
     }
   });
 
-  // Register in vcrewSessions for type inference in sendConversationList
-  if (vcrewConfig) {
-    vcrewSessions.set(conversationId, {
-      roles: vcrewConfig.roles,
-      teamType: vcrewConfig.teamType,
-      language: vcrewConfig.language,
+  // Register in rolePlaySessions for type inference in sendConversationList
+  if (rolePlayConfig) {
+    rolePlaySessions.set(conversationId, {
+      roles: rolePlayConfig.roles,
+      teamType: rolePlayConfig.teamType,
+      language: rolePlayConfig.language,
       projectDir: effectiveWorkDir,
       createdAt: Date.now(),
       userId,
       username,
     });
-    saveVCrewIndex();
+    saveRolePlayIndex();
   }
 
   ctx.sendToServer({
@@ -180,7 +180,7 @@ export async function createConversation(msg) {
     userId,
     username,
     disallowedTools: disallowedTools || null,
-    vcrewConfig: vcrewConfig || null
+    rolePlayConfig: rolePlayConfig || null
   });
 
   // 立即发送 agent 级别的 MCP servers 列表（从 ~/.claude.json 读取的）
@@ -232,10 +232,10 @@ export async function resumeConversation(msg) {
 
   // 只创建 conversation 状态并保存 claudeSessionId，不启动 Claude 进程
   // Claude 进程会在用户发送第一条消息时启动 (见 handleUserInput)
-  // Restore vcrewConfig from persisted vcrewSessions if available
-  const vcrewEntry = vcrewSessions.get(conversationId);
-  const vcrewConfig = vcrewEntry
-    ? { roles: vcrewEntry.roles, teamType: vcrewEntry.teamType, language: vcrewEntry.language }
+  // Restore rolePlayConfig from persisted rolePlaySessions if available
+  const rolePlayEntry = rolePlaySessions.get(conversationId);
+  const rolePlayConfig = rolePlayEntry
+    ? { roles: rolePlayEntry.roles, teamType: rolePlayEntry.teamType, language: rolePlayEntry.language }
     : null;
 
   ctx.conversations.set(conversationId, {
@@ -251,7 +251,7 @@ export async function resumeConversation(msg) {
     userId,
     username,
     disallowedTools: disallowedTools || null,  // null = 使用全局默认
-    vcrewConfig,
+    rolePlayConfig,
     usage: {
       inputTokens: 0,
       outputTokens: 0,
@@ -317,9 +317,9 @@ export function deleteConversation(msg) {
     ctx.conversations.delete(conversationId);
   }
 
-  // Clean up vcrew session if applicable
-  if (vcrewSessions.has(conversationId)) {
-    removeVCrewSession(conversationId);
+  // Clean up roleplay session if applicable
+  if (rolePlaySessions.has(conversationId)) {
+    removeRolePlaySession(conversationId);
   }
 
   ctx.sendToServer({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "0.1.60",
+  "version": "0.1.61",
   "description": "Remote agent for Yeaft WebChat — connects worker machines to the central server",
   "main": "index.js",
   "type": "module",

package/{vcrew.js → roleplay.js}

@@ -1,52 +1,68 @@
 /**
- * Virtual Crew — lightweight multi-role collaboration within a single conversation.
+ * Role Play — lightweight multi-role collaboration within a single conversation.
  *
- * Manages vcrewSessions (in-memory + persisted to disk) and builds the
+ * Manages rolePlaySessions (in-memory + persisted to disk) and builds the
  * appendSystemPrompt that instructs Claude to role-play multiple characters.
  */
 
 import { join } from 'path';
 import { homedir } from 'os';
-import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { readFileSync, writeFileSync, existsSync, renameSync } from 'fs';
 
-const VCREW_INDEX_PATH = join(homedir(), '.claude', 'vcrew-sessions.json');
+const ROLEPLAY_INDEX_PATH = join(homedir(), '.claude', 'roleplay-sessions.json');
+// ★ backward compat: old filename before rename
+const LEGACY_INDEX_PATH = join(homedir(), '.claude', 'vcrew-sessions.json');
 
 // In-memory map: conversationId -> { roles, teamType, language, projectDir, createdAt, userId, username }
-export const vcrewSessions = new Map();
+export const rolePlaySessions = new Map();
 
 // ---------------------------------------------------------------------------
 // Persistence
 // ---------------------------------------------------------------------------
 
-export function saveVCrewIndex() {
+export function saveRolePlayIndex() {
   const data = [];
-  for (const [id, session] of vcrewSessions) {
+  for (const [id, session] of rolePlaySessions) {
     data.push({ id, ...session });
   }
   try {
-    writeFileSync(VCREW_INDEX_PATH, JSON.stringify(data, null, 2));
+    writeFileSync(ROLEPLAY_INDEX_PATH, JSON.stringify(data, null, 2));
   } catch (e) {
-    console.warn('[vcrew] Failed to save index:', e.message);
+    console.warn('[roleplay] Failed to save index:', e.message);
   }
 }
 
-export function loadVCrewIndex() {
-  if (!existsSync(VCREW_INDEX_PATH)) return;
+export function loadRolePlayIndex() {
+  let indexPath = ROLEPLAY_INDEX_PATH;
+
+  // ★ backward compat: migrate old vcrew-sessions.json → roleplay-sessions.json
+  if (!existsSync(indexPath) && existsSync(LEGACY_INDEX_PATH)) {
+    try {
+      renameSync(LEGACY_INDEX_PATH, indexPath);
+      console.log('[roleplay] Migrated vcrew-sessions.json → roleplay-sessions.json');
+    } catch (e) {
+      // rename failed (e.g. permissions), fall back to reading old file directly
+      console.warn('[roleplay] Could not rename legacy index, reading in-place:', e.message);
+      indexPath = LEGACY_INDEX_PATH;
+    }
+  }
+
+  if (!existsSync(indexPath)) return;
   try {
-    const data = JSON.parse(readFileSync(VCREW_INDEX_PATH, 'utf-8'));
+    const data = JSON.parse(readFileSync(indexPath, 'utf-8'));
     for (const entry of data) {
       const { id, ...session } = entry;
-      vcrewSessions.set(id, session);
+      rolePlaySessions.set(id, session);
     }
-    console.log(`[vcrew] Loaded ${vcrewSessions.size} sessions from index`);
+    console.log(`[roleplay] Loaded ${rolePlaySessions.size} sessions from index`);
   } catch (e) {
-    console.warn('[vcrew] Failed to load index:', e.message);
+    console.warn('[roleplay] Failed to load index:', e.message);
   }
 }
 
-export function removeVCrewSession(conversationId) {
-  vcrewSessions.delete(conversationId);
-  saveVCrewIndex();
+export function removeRolePlaySession(conversationId) {
+  rolePlaySessions.delete(conversationId);
+  saveRolePlayIndex();
 }
 
 // ---------------------------------------------------------------------------
@@ -60,15 +76,15 @@ const MAX_CLAUDE_MD_LEN = 4096;
 const MAX_ROLES = 10;
 
 /**
- * Validate and sanitize vcrewConfig from the client.
+ * Validate and sanitize rolePlayConfig from the client.
  * Returns { valid: true, config: sanitizedConfig } or { valid: false, error: string }.
  *
- * @param {*} config - raw vcrewConfig from client message
+ * @param {*} config - raw rolePlayConfig from client message
  * @returns {{ valid: boolean, config?: object, error?: string }}
  */
-export function validateVCrewConfig(config) {
+export function validateRolePlayConfig(config) {
   if (!config || typeof config !== 'object') {
-    return { valid: false, error: 'vcrewConfig must be an object' };
+    return { valid: false, error: 'rolePlayConfig must be an object' };
   }
 
   // teamType
@@ -141,13 +157,13 @@ export function validateVCrewConfig(config) {
 // ---------------------------------------------------------------------------
 
 /**
- * Build the appendSystemPrompt that tells Claude about the virtual crew roles
+ * Build the appendSystemPrompt that tells Claude about the role play roles
  * and how to switch between them.
  *
  * @param {{ roles: Array, teamType: string, language: string }} config
  * @returns {string}
  */
-export function buildVCrewSystemPrompt(config) {
+export function buildRolePlaySystemPrompt(config) {
   const { roles, teamType, language } = config;
   const isZh = language === 'zh-CN';