@slates-integrations/sharepoint 0.2.0-rc.7 → 0.3.0

package/README.md

@@ -1,11 +1,15 @@
 # <img src="https://provider-logos.metorial-cdn.com/sharepoint-icon.svg" height="20"> Sharepoint
 
-Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Subscribe to webhooks for list and library change notifications. Retrieve site properties and search for sites across Microsoft 365.
+Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Subscribe to webhooks for list and library change notifications. Retrieve site properties and search for sites across Microsoft 365.
 
 ## Authentication
 
 When registering the OAuth app in Microsoft Entra ID for local CLI auth, use `http://localhost:45873/callback` as the redirect URI.
 
+SharePoint uses both Microsoft Graph and SharePoint REST APIs. Graph-backed tools use a Graph access token, while SharePoint REST-backed tools such as site user lookup require a token for the tenant SharePoint host.
+
+Custom Microsoft Entra applications must configure delegated permissions for both API resources. In addition to the Microsoft Graph permissions shown during connection setup, add the Office 365 SharePoint Online delegated `AllSites.Manage` permission and grant tenant consent when required. Microsoft Graph `Sites.Manage.All` does not replace SharePoint `AllSites.Manage` because access tokens are issued for a specific API resource. Reconnect SharePoint after adding or changing either resource's permissions.
+
 ## Tools
 
 ### Get Content Types
@@ -24,13 +28,17 @@ Retrieve the version history of a file in a SharePoint document library. Returns
 
 Retrieve detailed information about a SharePoint site. Look up a site by its ID, hostname and path, or get the root site. Also supports listing subsites of a given site.
 
+### Get Site User
+
+Resolve a user email or UPN to the numeric SharePoint site-scoped user ID required for Person/Group list column `{fieldName}LookupId` values. This reads an existing site user record and does not create or ensure users on the site.
+
 ### List Sites
 
 Search for SharePoint sites by keyword, or list subsites of a given site. Returns a list of matching sites with their IDs and URLs.
 
 ### Manage Columns
 
-List, create, update, or delete columns (fields) on a SharePoint list. Columns define the schema and metadata structure of a list. Supports various column types including text, number, boolean, dateTime, choice, currency, and personOrGroup.
+List, create, update, or delete columns (fields) on a SharePoint list. Columns define the schema and metadata structure of a list. Supports various column types including text, number, boolean, dateTime, choice, currency, personOrGroup, and hyperlinkOrPicture.
 
 ### Manage File
 
@@ -38,7 +46,7 @@ Upload, download, move, copy, rename, or delete files and folders in a SharePoin
 
 ### Manage List Items
 
-Full CRUD operations on SharePoint list items. Create, read, update, delete, or list items in a SharePoint list. Supports OData filtering and ordering when listing items. Field values match the list's column schema.
+Full CRUD operations on SharePoint list items. Create, read, update, delete, or list items in a SharePoint list. Supports OData filtering and ordering when listing items. Field values match the list's column schema, including Hyperlink updates with URL and description values.
 
 ### Manage List