@yeaft/webchat-agent 0.1.250 → 0.1.251

package/claude.js

@@ -310,7 +310,8 @@ async function processClaudeOutput(conversationId, claudeQuery, state) {
             ctx.sendToServer({
               type: 'slash_commands_update',
               conversationId,
-              slashCommands: state.slashCommands
+              slashCommands: state.slashCommands,
+              slashCommandDescriptions: ctx.slashCommandDescriptions
             });
           }
         }

package/connection/message-router.js

@@ -105,6 +105,10 @@ export async function handleMessage(msg) {
       await handleBtwQuestion(msg);
       break;
 
+    case 'stop_background_task':
+      await (await import('../conversation.js')).handleStopBackgroundTask(msg);
+      break;
+
     case 'cancel_execution':
       await handleCancelExecution(msg);
       break;

package/context.js

@@ -14,6 +14,8 @@ export default {
   agentCapabilities: [],
   // Agent 级别的 slash commands 缓存（所有 conversation 共用）
   slashCommands: [],
+  // Slash command 描述映射: { commandName: description } — 从 plugin commands/*.md 提取
+  slashCommandDescriptions: {},
   // MCP servers 列表 (从 ~/.claude.json 读取): [{ name, enabled, source }]
   mcpServers: [],
   // 连接相关

package/conversation.js

@@ -1,3 +1,6 @@
+import { readFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
 import ctx from './context.js';
 import { query } from './sdk/index.js';
 import { loadSessionHistory } from './history.js';
@@ -7,6 +10,114 @@ import { crewSessions, loadCrewIndex } from './crew.js';
 // 不支持的斜杠命令（真正需要交互式 CLI 的命令）
 const UNSUPPORTED_SLASH_COMMANDS = ['/help', '/bug', '/login', '/logout', '/terminal-setup', '/vim', '/config'];
 
+// 内置命令的描述（作为 fallback，这些命令 CLI 不提供 frontmatter 描述）
+const BUILTIN_COMMAND_DESCRIPTIONS = {
+  compact: 'Compact conversation context',
+  context: 'Show context usage',
+  cost: 'Show token costs',
+  init: 'Reinitialize session',
+  review: 'Code review',
+  insights: 'Session insights',
+  'pr-comments': 'PR comment review',
+  'release-notes': 'Generate release notes',
+  'security-review': 'Security review',
+  heapdump: 'Heap dump (debug)',
+};
+
+/**
+ * Load command descriptions from installed plugin commands/*.md files.
+ * Parses YAML frontmatter to extract name and description fields.
+ * Results are cached in ctx.slashCommandDescriptions.
+ */
+export function loadPluginCommandDescriptions() {
+  if (Object.keys(ctx.slashCommandDescriptions).length > 0) return; // already loaded
+
+  try {
+    const installedPath = join(homedir(), '.claude', 'plugins', 'installed_plugins.json');
+    const installed = JSON.parse(readFileSync(installedPath, 'utf-8'));
+
+    for (const [pluginKey, entries] of Object.entries(installed.plugins || {})) {
+      // pluginKey: "yeaft-skills@yeaft-skills-dev"
+      const pluginName = pluginKey.split('@')[0]; // "yeaft-skills"
+      for (const entry of entries) {
+        const commandsDir = join(entry.installPath, 'commands');
+        let files;
+        try {
+          files = readdirSync(commandsDir).filter(f => f.endsWith('.md'));
+        } catch { continue; }
+
+        for (const file of files) {
+          try {
+            const content = readFileSync(join(commandsDir, file), 'utf-8');
+            const fm = parseFrontmatter(content);
+            if (fm.name && fm.description) {
+              // CLI uses pluginName:commandName format (e.g. "yeaft-skills:sprint")
+              const cliName = `${pluginName}:${fm.name}`;
+              // Take first line of description only
+              const desc = fm.description.split('\n')[0].trim();
+              ctx.slashCommandDescriptions[cliName] = desc;
+            }
+          } catch { /* skip unparseable files */ }
+        }
+      }
+    }
+
+    // Add builtin descriptions
+    for (const [name, desc] of Object.entries(BUILTIN_COMMAND_DESCRIPTIONS)) {
+      if (!ctx.slashCommandDescriptions[name]) {
+        ctx.slashCommandDescriptions[name] = desc;
+      }
+    }
+
+    console.log(`[Preload] Loaded ${Object.keys(ctx.slashCommandDescriptions).length} command descriptions`);
+  } catch (err) {
+    console.warn('[Preload] Failed to load plugin command descriptions:', err.message);
+  }
+}
+
+/**
+ * Minimal YAML frontmatter parser for commands/*.md files.
+ * Extracts name and description from --- delimited frontmatter.
+ */
+function parseFrontmatter(content) {
+  const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+  if (!match) return {};
+
+  const fm = {};
+  const lines = match[1].split('\n');
+  let currentKey = null;
+  let multilineValue = '';
+
+  for (const line of lines) {
+    // New key: value pair
+    const kvMatch = line.match(/^(\w+):\s*(.*)/);
+    if (kvMatch) {
+      // Save previous multiline value
+      if (currentKey && multilineValue) {
+        fm[currentKey] = multilineValue.trim();
+      }
+      currentKey = kvMatch[1];
+      const val = kvMatch[2].trim();
+      if (val === '|' || val === '>') {
+        multilineValue = '';
+      } else {
+        fm[currentKey] = val;
+        currentKey = null;
+        multilineValue = '';
+      }
+    } else if (currentKey && (line.startsWith('  ') || line.trim() === '')) {
+      // Continuation of multiline value
+      multilineValue += (multilineValue ? '\n' : '') + line.trimStart();
+    }
+  }
+  // Save last multiline value
+  if (currentKey && multilineValue) {
+    fm[currentKey] = multilineValue.trim();
+  }
+
+  return fm;
+}
+
 /**
  * Prestart Claude CLI process in background (fire-and-forget).
  * When the query starts, processClaudeOutput will receive the system init message
@@ -33,6 +144,10 @@ function prestartClaude(conversationId, workDir, resumeSessionId) {
  */
 export async function preloadSlashCommands(workDir, targetId = '__preload__') {
   const effectiveWorkDir = workDir || ctx.CONFIG.workDir;
+
+  // Eagerly load plugin command descriptions (cached, runs once)
+  loadPluginCommandDescriptions();
+
   try {
     const abortController = new AbortController();
     // Use --print with a cheap built-in command to trigger system init.
@@ -58,7 +173,8 @@ export async function preloadSlashCommands(workDir, targetId = '__preload__') {
           ctx.sendToServer({
             type: 'slash_commands_update',
             conversationId: targetId,
-            slashCommands
+            slashCommands,
+            slashCommandDescriptions: ctx.slashCommandDescriptions
           });
           console.log(`[Preload] ${targetId}: loaded ${slashCommands.length} slash commands from ${effectiveWorkDir}`);
         }
@@ -435,6 +551,36 @@ export async function handleCancelExecution(msg) {
   sendConversationList();
 }
 
+// 停止单个后台任务
+// NOTE: This is a "soft stop" — it marks the task as stopped in our tracking state
+// and notifies the frontend, but does NOT actually kill the underlying subprocess.
+// The Claude SDK's abortController.abort() kills the entire session (all sub-tasks),
+// not individual ones. Per-sub-agent abort is not supported by the SDK.
+// TODO [P2]: Investigate SDK changes that might enable per-task cancellation.
+export async function handleStopBackgroundTask(msg) {
+  const { conversationId, taskId } = msg;
+
+  const state = ctx.conversations.get(conversationId);
+  if (!state) return;
+
+  const taskInfo = state.backgroundTasks?.get(taskId);
+  if (!taskInfo) return;
+
+  // Soft stop: mark as stopped in tracking state (subprocess continues in background)
+  taskInfo.status = 'stopped';
+  taskInfo.endTime = Date.now();
+
+  console.log(`[Tasks] Stopped: ${taskId} in conversation ${conversationId}`);
+
+  // Notify frontend
+  ctx.sendToServer({
+    type: 'background_task_output',
+    conversationId,
+    taskId,
+    task: taskInfo
+  });
+}
+
 // 清空排队消息 — 已移至 server 端管理 (Phase 3.6)
 // handleClearQueue 和 handleCancelQueuedMessage 不再需要
 

package/package.json

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