feat: enrich search with msglib display entities

internal/mcpserver/server.go

@@ -9,15 +9,19 @@ import (
 
 	"isphere-ai-bridge/internal/helperclient"
 	"isphere-ai-bridge/internal/isphere"
+	"isphere-ai-bridge/internal/msglib"
 	"isphere-ai-bridge/internal/tools"
 )
 
 const (
-	ServerName          = "isphere-ai-bridge"
-	ServerTitle         = "iSphere AI Bridge"
-	ServerVersion       = "0.1.0"
-	EnvPacketLogFileKey = "ISPHERE_PACKET_LOG_FILE"
-	EnvPacketLogDirKey  = "ISPHERE_PACKET_LOG_DIR"
+	ServerName             = "isphere-ai-bridge"
+	ServerTitle            = "iSphere AI Bridge"
+	ServerVersion          = "0.1.0"
+	EnvPacketLogFileKey    = "ISPHERE_PACKET_LOG_FILE"
+	EnvPacketLogDirKey     = "ISPHERE_PACKET_LOG_DIR"
+	EnvMsgLibSidecarExeKey = "ISPHERE_MSGLIB_SIDECAR_EXE"
+	EnvMsgLibSQLiteDLLKey  = "ISPHERE_MSGLIB_SQLITE_DLL"
+	EnvMsgLibDBKey         = "ISPHERE_MSGLIB_DB"
 )
 
 func NewServer() *mcp.Server {
@@ -44,10 +48,41 @@ func NewServerFromEnv() (*mcp.Server, error) {
 		}
 		source = loaded
 	}
-	return NewServerWithReceiveSource(source), nil
+	displaySource, err := msgLibDisplayEntitySourceFromEnv()
+	if err != nil {
+		return nil, err
+	}
+	return NewServerWithSources(source, displaySource), nil
+}
+
+func msgLibDisplayEntitySourceFromEnv() (tools.DisplayEntitySource, error) {
+	sidecarExe := strings.TrimSpace(os.Getenv(EnvMsgLibSidecarExeKey))
+	sqliteDLL := strings.TrimSpace(os.Getenv(EnvMsgLibSQLiteDLLKey))
+	dbPath := strings.TrimSpace(os.Getenv(EnvMsgLibDBKey))
+	configured := 0
+	for _, value := range []string{sidecarExe, sqliteDLL, dbPath} {
+		if value != "" {
+			configured++
+		}
+	}
+	if configured == 0 {
+		return nil, nil
+	}
+	if configured != 3 {
+		return nil, fmt.Errorf("configure MsgLib source: set all of %s, %s, and %s, or set none", EnvMsgLibSidecarExeKey, EnvMsgLibSQLiteDLLKey, EnvMsgLibDBKey)
+	}
+	cfg, err := msglib.ConfigFromEnv()
+	if err != nil {
+		return nil, fmt.Errorf("configure MsgLib source: %w", err)
+	}
+	return msglib.NewClient(cfg), nil
 }
 
 func NewServerWithReceiveSource(source tools.ReceiveMessagesSource) *mcp.Server {
+	return NewServerWithSources(source, nil)
+}
+
+func NewServerWithSources(source tools.ReceiveMessagesSource, displaySource tools.DisplayEntitySource) *mcp.Server {
 	server := mcp.NewServer(&mcp.Implementation{
 		Name:    ServerName,
 		Title:   ServerTitle,
@@ -55,8 +90,8 @@ func NewServerWithReceiveSource(source tools.ReceiveMessagesSource) *mcp.Server
 	}, nil)
 	tools.RegisterWinHelperTools(server, helperclient.Client{})
 	tools.RegisterISphereReadTools(server, source)
-	tools.RegisterISphereContactTools(server, source)
-	tools.RegisterISphereGroupTools(server, source)
+	tools.RegisterISphereContactToolsWithDisplayEntities(server, source, displaySource)
+	tools.RegisterISphereGroupToolsWithDisplayEntities(server, source, displaySource)
 	tools.RegisterISphereFileTools(server, source)
 	return server
 }

internal/mcpserver/server_test.go

@@ -9,6 +9,7 @@ import (
 	"os"
 	"reflect"
 	"sort"
+	"strings"
 	"testing"
 	"time"
 
@@ -63,7 +64,21 @@ func TestNewServerRegistersN8WinHelperToolsWithoutCallingHelper(t *testing.T) {
 	}
 }
 
+func TestNewServerFromEnvRejectsPartialMsgLibConfig(t *testing.T) {
+	clearMsgLibEnvForServerTest(t)
+	t.Setenv(EnvMsgLibSidecarExeKey, `C:\tools\MsgLibReadSidecar.exe`)
+
+	_, err := NewServerFromEnv()
+	if err == nil {
+		t.Fatal("NewServerFromEnv returned nil error for partial MsgLib config")
+	}
+	if !strings.Contains(err.Error(), EnvMsgLibSQLiteDLLKey) || !strings.Contains(err.Error(), EnvMsgLibDBKey) {
+		t.Fatalf("error = %v, want missing MsgLib env context", err)
+	}
+}
+
 func TestNewServerFromEnvUsesPacketLogFile(t *testing.T) {
+	clearMsgLibEnvForServerTest(t)
 	plaintext := `--------------------------------------------------------------------------------------------------------------------------------------------
 2026/7/7 15:30:07
 <message id="msg-env-1" from="sender@imopenfire1-lanzhou/imp_pc_4.1.2.6842" to="receiver@imopenfire1-lanzhou" type="chat">
@@ -128,6 +143,7 @@ func TestNewServerFromEnvUsesPacketLogFile(t *testing.T) {
 }
 
 func TestNewServerFromEnvUsesPacketLogDirectory(t *testing.T) {
+	clearMsgLibEnvForServerTest(t)
 	plaintext := `--------------------------------------------------------------------------------------------------------------------------------------------
 2026/7/7 15:30:07
 <message id="msg-dir-1" from="sender@imopenfire1-lanzhou/imp_pc_4.1.2.6842" to="receiver@imopenfire1-lanzhou" type="chat">
@@ -181,6 +197,14 @@ func TestNewServerFromEnvUsesPacketLogDirectory(t *testing.T) {
 	}
 }
 
+func clearMsgLibEnvForServerTest(t *testing.T) {
+	t.Helper()
+	t.Setenv(EnvMsgLibSidecarExeKey, "")
+	t.Setenv(EnvMsgLibSQLiteDLLKey, "")
+	t.Setenv(EnvMsgLibDBKey, "")
+	t.Setenv("ISPHERE_MSGLIB_PASSWORD", "")
+}
+
 func writeEncryptedPacketLogDirectoryForServerTest(t *testing.T, plaintext string) string {
 	t.Helper()
 	dir := t.TempDir()