@yeaft/webchat-agent 1.0.418 → 1.0.421

package/connection/message-router.js

@@ -12,7 +12,7 @@ import { handleProxyHttpRequest, handleProxyWsOpen, handleProxyWsMessage, handle
 import {
   handleReadFile, handleWriteFile, handleListDirectory,
   handleGitStatus, handleGitDiff, handleGitAdd, handleGitReset, handleGitRestore, handleGitCommit, handleGitPush,
-  handleFileSearch, handleCreateFile, handleDeleteFiles, handleMoveFiles, handleCopyFiles, handleUploadToDir, handleTransferFiles
+  handleFileSearch, handleResolveFileReferences, handleCreateFile, handleDeleteFiles, handleMoveFiles, handleCopyFiles, handleUploadToDir, handleTransferFiles
 } from '../workbench.js';
 import { handleListHistorySessions, handleListFolders, handleListModels } from '../history.js';
 import {
@@ -288,6 +288,10 @@ export async function handleMessage(msg) {
       await handleFileSearch(msg);
       break;
 
+    case 'resolve_file_references':
+      await handleResolveFileReferences(msg);
+      break;
+
     case 'create_file':
       await handleCreateFile(msg);
       break;

package/index.js

@@ -161,7 +161,7 @@ async function detectCapabilities() {
   // agent build can speak plaintext WS frames. New servers see this and
   // flip `agent.encryptOutbound = false`, stopping outbound encryption
   // to this peer. Old servers ignore the unknown capability token.
-  const capabilities = ['background_tasks', 'file_editor', 'ping_session', 'plaintext-ok', 'workbench_session_routes', SAFE_REMOTE_UPGRADE_CAPABILITY, 'work_center', 'work_center_message_v2', 'session_history_search', 'session_history_outline', 'session_history_window_prefetch'];
+  const capabilities = ['background_tasks', 'file_editor', 'ping_session', 'plaintext-ok', 'workbench_session_routes', SAFE_REMOTE_UPGRADE_CAPABILITY, 'work_center', 'work_center_message_v2', 'session_history_search', 'session_history_outline', 'session_history_window_prefetch', 'file_reference_resolution', 'yeaft_plugins'];
   if (process.platform === 'linux') capabilities.push('work_item_attachments');
   const pty = await loadNodePty();
   if (pty) capabilities.push('terminal');

package/local-runtime/server/handlers/agent-file-terminal.js

@@ -169,7 +169,7 @@ export async function handleAgentFileTerminal(agentId, agent, rawMsg) {
     'terminal_created', 'terminal_output', 'terminal_closed', 'terminal_error',
   ]);
   const oneShotTypes = new Set([
-    'file_content', 'file_saved', 'directory_listing', 'file_op_result',
+    'file_content', 'file_references_resolved', 'file_saved', 'directory_listing', 'file_op_result',
     'git_status_result', 'git_diff_result', 'git_op_result', 'file_search_result',
   ]);
   if (!terminalTypes.has(msg.type) && !oneShotTypes.has(msg.type)) return false;

package/local-runtime/server/handlers/client-conversation.js

@@ -27,6 +27,10 @@ import {
   chatCatalogKey,
   yeaftCatalogKey,
 } from '../session-catalog.js';
+import {
+  agentSupportsYeaftPlugins,
+  YEAFT_PLUGINS_UNSUPPORTED_ERROR,
+} from '../yeaft-plugin-capability.js';
 
 
 function isRetiredCollabSessionId(id) {
@@ -44,6 +48,14 @@ function emptyYeaftToolStats(reason = '') {
   return payload;
 }
 
+function emptyYeaftPluginCatalog(error = null) {
+  return {
+    type: 'yeaft_plugin_catalog_result',
+    catalog: { tools: [], skills: [], mcpServers: [] },
+    ...(error ? { error } : {}),
+  };
+}
+
 async function sendVpSnapshotError(client, msg, error) {
   await sendToWebClient(client, {
     type: 'yeaft_output',
@@ -420,6 +432,7 @@ export async function handleClientConversation(clientId, client, msg, checkAgent
             agentName: agent.name,
             workDir: agent.workDir,
             capabilities: agent.capabilities || ['terminal', 'file_editor', 'background_tasks'],
+            ...(agent.capabilityMetadataProvided === true ? { capabilityMetadataProvided: true } : {}),
             version: agent.version || null,
             conversations: filteredConvs,
             slashCommands: agent.slashCommands || [],
@@ -1628,6 +1641,15 @@ export async function handleClientConversation(clientId, client, msg, checkAgent
           }
           return true;
         }
+        if (relayType === 'yeaft_plugin_catalog'
+            && !agentSupportsYeaftPlugins(agents.get(relayAgentId))) {
+          await sendToWebClient(client, {
+            ...emptyYeaftPluginCatalog(YEAFT_PLUGINS_UNSUPPORTED_ERROR),
+            agentId: relayAgentId,
+            requestId: msg.requestId || null,
+          });
+          return true;
+        }
         const relayAgent = agents.get(relayAgentId);
         if (!relayAgent || relayAgent.ws?.readyState !== 1) {
           if (relayType === 'yeaft_fetch_tool_stats') {

package/local-runtime/server/handlers/client-misc.js

@@ -3,11 +3,27 @@ import {
   sendToWebClient, forwardToAgent, broadcastAgentList
 } from '../ws-utils.js';
 import { resolveWorkbenchRequest } from '../workbench-route.js';
+import {
+  agentSupportsYeaftPlugins,
+  YEAFT_PLUGINS_CAPABILITY,
+  YEAFT_PLUGINS_UNSUPPORTED_ERROR,
+} from '../yeaft-plugin-capability.js';
 
 // Only Agents that explicitly advertise the package-replacement-safe updater
 // may receive remote upgrade commands. Version thresholds are insufficient:
 // builds without this capability may still inherit the installed package cwd.
 export const SAFE_REMOTE_UPGRADE_CAPABILITY = 'remote_upgrade_safe';
+export { YEAFT_PLUGINS_CAPABILITY, YEAFT_PLUGINS_UNSUPPORTED_ERROR };
+
+async function rejectUnsupportedYeaftPlugins(client, msg, agentId) {
+  await sendToWebClient(client, {
+    type: msg.type === 'update_yeaft_plugins' ? 'yeaft_plugins_updated' : 'yeaft_plugins',
+    agentId,
+    requestId: msg.requestId || null,
+    plugins: {},
+    error: YEAFT_PLUGINS_UNSUPPORTED_ERROR,
+  });
+}
 
 export function requiresManualUpgradeBridge(capabilities, platform = null) {
   if (Array.isArray(capabilities) && capabilities.includes(SAFE_REMOTE_UPGRADE_CAPABILITY)) return false;
@@ -204,6 +220,10 @@ export async function handleClientMisc(clientId, client, msg, checkAgentAccess)
       const targetAgentId = msg.agentId || client.currentAgent;
       if (!targetAgentId) break;
       if (!await checkAgentAccess(targetAgentId)) break;
+      if (!agentSupportsYeaftPlugins(agents.get(targetAgentId))) {
+        await rejectUnsupportedYeaftPlugins(client, msg, targetAgentId);
+        break;
+      }
       await forwardToAgent(targetAgentId, {
         type: 'get_yeaft_plugins',
         requestId: msg.requestId || null,
@@ -215,6 +235,10 @@ export async function handleClientMisc(clientId, client, msg, checkAgentAccess)
       const targetAgentId = msg.agentId || client.currentAgent;
       if (!targetAgentId) break;
       if (!await checkAgentAccess(targetAgentId)) break;
+      if (!agentSupportsYeaftPlugins(agents.get(targetAgentId))) {
+        await rejectUnsupportedYeaftPlugins(client, msg, targetAgentId);
+        break;
+      }
       const hasPlugins = Object.prototype.hasOwnProperty.call(msg, 'plugins');
       const hasConfig = Object.prototype.hasOwnProperty.call(msg, 'config');
       await forwardToAgent(targetAgentId, {

package/local-runtime/server/handlers/client-workbench.js

@@ -40,6 +40,7 @@ async function denyWorkbenchRoute(client, msg) {
 const RESPONSE_TYPES = Object.freeze({
   terminal_create: ['terminal_created', 'terminal_error'],
   read_file: ['file_content'],
+  resolve_file_references: ['file_references_resolved'],
   write_file: ['file_saved'],
   list_directory: ['directory_listing'],
   git_status: ['git_status_result'],
@@ -190,6 +191,7 @@ export async function handleClientWorkbench(clientId, client, msg, checkAgentAcc
       break;
     }
 
+    case 'resolve_file_references':
     case 'read_file': {
       const fileAgentId = msg.agentId || client.currentAgent;
       if (!fileAgentId) { console.warn('[Server] read_file: no agentId'); return; }
@@ -200,7 +202,7 @@ export async function handleClientWorkbench(clientId, client, msg, checkAgentAcc
         return;
       }
       const fileConvId = resolved.conversationId || msg.conversationId || client.currentConversation || '_explorer';
-      console.log(`[Server] Forwarding read_file to agent ${fileAgentId}, conv=${fileConvId}, path=${msg.filePath}`);
+      console.log(`[Server] Forwarding ${msg.type} to agent ${fileAgentId}, conv=${fileConvId}${msg.filePath ? `, path=${msg.filePath}` : ''}`);
       await forwardCorrelatedWorkbenchRequest({
         agentId: fileAgentId,
         clientId,

package/local-runtime/server/ws-agent.js

@@ -120,7 +120,13 @@ export function handleAgentConnection(ws, url) {
             return;
           }
 
-          const capabilities = Array.isArray(msg.capabilities) ? msg.capabilities : urlCapabilities;
+          const authCapabilitiesProvided = Array.isArray(msg.capabilities);
+          // Modern Agents always include this query key, including for an
+          // explicit empty list. The key's presence is the metadata signal;
+          // its value only determines the effective capability list.
+          const urlCapabilitiesProvided = url.searchParams.has('capabilities');
+          const capabilityMetadataProvided = authCapabilitiesProvided || urlCapabilitiesProvided;
+          const capabilities = authCapabilitiesProvided ? msg.capabilities : urlCapabilities;
           const agentVersion = msg.version || null;
           const agentPlatform = typeof msg.platform === 'string' && msg.platform
             ? msg.platform
@@ -152,6 +158,7 @@ export function handleAgentConnection(ws, url) {
             pending.workDir,
             authResult.sessionKey,
             capabilities,
+            capabilityMetadataProvided,
             ownerId,
             ownerUsername,
             agentVersion,
@@ -243,7 +250,7 @@ function handleAgentDisconnect(agentId, agentName, ws) {
   broadcastAgentList();
 }
 
-function completeAgentRegistration(ws, agentId, agentName, workDir, sessionKey, capabilities = [], ownerId = null, ownerUsername = null, agentVersion = null, instanceId = null, agentPlatform = null) {
+function completeAgentRegistration(ws, agentId, agentName, workDir, sessionKey, capabilities = [], capabilityMetadataProvided = false, ownerId = null, ownerUsername = null, agentVersion = null, instanceId = null, agentPlatform = null) {
   // 如果是重连，保留 conversations；否则（server 重启）创建空 Map
   const existingAgent = agents.get(agentId);
   const conversations = existingAgent?.conversations || new Map();
@@ -274,6 +281,9 @@ function completeAgentRegistration(ws, agentId, agentName, workDir, sessionKey,
     isAlive: true,
     lastSeenAt: Date.now(),
     capabilities: effectiveCapabilities,
+    // The fallback list supports old UI features but cannot prove that an
+    // Agent made an explicit capability claim.
+    capabilityMetadataProvided,
     proxyPorts,
     slashCommands,
     slashCommandDescriptions,

package/local-runtime/server/ws-client.js

@@ -228,7 +228,7 @@ export function handleWebConnection(ws, url, req = {}) {
 const WORKBENCH_TYPES = new Set([
   ...CLIENT_BROWSER_TYPES,
   'terminal_create', 'terminal_input', 'terminal_resize', 'terminal_close',
-  'read_file', 'write_file', 'create_file', 'delete_files', 'move_files', 'copy_files', 'upload_to_dir', 'file_search',
+  'read_file', 'resolve_file_references', 'write_file', 'create_file', 'delete_files', 'move_files', 'copy_files', 'upload_to_dir', 'file_search',
   'git_status', 'git_diff', 'git_add', 'git_reset', 'git_restore', 'git_commit', 'git_push',
   'proxy_update_ports', 'update_file_tabs', 'restore_file_tabs'
 ]);

package/local-runtime/server/ws-utils.js

@@ -169,6 +169,7 @@ export async function broadcastAgentList() {
           status: agent.status || 'ready',
           latency: agent.latency || null,
           capabilities: agent.capabilities || ['terminal', 'file_editor', 'background_tasks'],
+          ...(agent.capabilityMetadataProvided === true ? { capabilityMetadataProvided: true } : {}),
           version: agent.version || null,
           yeaftStatus: agent.yeaftStatus || null,
           proxyPorts: agent.proxyPorts || [],

package/local-runtime/server/yeaft-plugin-capability.js

@@ -0,0 +1,11 @@
+// Plugin protocol support is omission-compatible: old Agents that never
+// advertised capability metadata keep the legacy relay path. Once an Agent
+// explicitly provides metadata, omitting this token is an explicit refusal.
+export const YEAFT_PLUGINS_CAPABILITY = 'yeaft_plugins';
+export const YEAFT_PLUGINS_UNSUPPORTED_ERROR = 'The selected Agent does not support Plugins; upgrade and restart the Agent';
+
+export function agentSupportsYeaftPlugins(agent) {
+  if (agent?.capabilityMetadataProvided !== true) return true;
+  return Array.isArray(agent.capabilities)
+    && agent.capabilities.includes(YEAFT_PLUGINS_CAPABILITY);
+}

package/local-runtime/version.json

@@ -1 +1 @@
-{"version":"1.0.418"}
+{"version":"1.0.421"}