feat(slack): close platform tools gap for assistants

.changeset/slack-platform-tools-expansion.md

@@ -0,0 +1,5 @@
+---
+"server": minor
+---
+
+Slack assistants can now manage the full message and channel lifecycle: edit, delete, and ephemeral messages; pull permalinks; open DMs; create, join, leave, invite, archive, and rename channels; manage pins, bookmarks, usergroup membership, reminders, file uploads, canvases, and presence/DND. Closes the previous gap where assistants could read Slack but barely write to it.

client/dashboard/src/pages/assistants/onboarding/slackManifest.ts

@@ -23,6 +23,115 @@ export const SLACK_TOOL_SCOPES: Record<string, readonly string[]> = {
   get_reactions: ["reactions:read"],
   list_reactions: ["reactions:read"],
   list_emoji: ["emoji:read"],
+  update_message: ["chat:write"],
+  delete_message: ["chat:write"],
+  post_ephemeral: ["chat:write"],
+  get_permalink: [],
+  delete_scheduled_message: ["chat:write"],
+  list_scheduled_messages: [],
+  me_message: ["chat:write"],
+  get_channel_info: ["channels:read", "groups:read", "im:read", "mpim:read"],
+  list_channel_members: [
+    "channels:read",
+    "groups:read",
+    "im:read",
+    "mpim:read",
+  ],
+  open_conversation: [
+    "channels:manage",
+    "groups:write",
+    "im:write",
+    "mpim:write",
+  ],
+  create_channel: ["channels:manage", "groups:write", "im:write", "mpim:write"],
+  join_channel: ["channels:join"],
+  leave_channel: ["channels:manage", "groups:write", "im:write", "mpim:write"],
+  invite_to_channel: [
+    "channels:manage",
+    "channels:write.invites",
+    "groups:write",
+    "groups:write.invites",
+    "im:write",
+    "mpim:write",
+  ],
+  set_channel_topic: [
+    "channels:manage",
+    "channels:write.topic",
+    "groups:write",
+    "groups:write.topic",
+    "im:write",
+    "im:write.topic",
+    "mpim:write",
+    "mpim:write.topic",
+  ],
+  set_channel_purpose: [
+    "channels:manage",
+    "channels:write.topic",
+    "groups:write",
+    "groups:write.topic",
+    "im:write",
+    "im:write.topic",
+    "mpim:write",
+    "mpim:write.topic",
+  ],
+  mark_conversation: [
+    "channels:manage",
+    "groups:write",
+    "im:write",
+    "mpim:write",
+  ],
+  archive_channel: [
+    "channels:manage",
+    "groups:write",
+    "im:write",
+    "mpim:write",
+  ],
+  unarchive_channel: [
+    "channels:manage",
+    "groups:write",
+    "im:write",
+    "mpim:write",
+  ],
+  rename_channel: ["channels:manage", "groups:write", "im:write", "mpim:write"],
+  remove_from_channel: [
+    "channels:manage",
+    "groups:write",
+    "im:write",
+    "mpim:write",
+  ],
+  lookup_user_by_email: ["users:read", "users:read.email"],
+  list_user_conversations: [
+    "users:read",
+    "channels:read",
+    "groups:read",
+    "im:read",
+    "mpim:read",
+  ],
+  get_user_presence: ["users:read"],
+  get_user_profile_fields: ["users.profile:read"],
+  get_user_dnd: ["dnd:read"],
+  get_team_dnd: ["dnd:read"],
+  upload_file: ["files:write"],
+  get_file_info: ["files:read"],
+  list_files: ["files:read"],
+  delete_file: ["files:write"],
+  pin_message: ["pins:write"],
+  unpin_message: ["pins:write"],
+  list_pins: ["pins:read"],
+  add_bookmark: ["bookmarks:write"],
+  edit_bookmark: ["bookmarks:write"],
+  remove_bookmark: ["bookmarks:write"],
+  list_bookmarks: ["bookmarks:read"],
+  list_usergroups: ["usergroups:read"],
+  list_usergroup_members: ["usergroups:read"],
+  get_team_info: ["team:read"],
+  create_canvas: ["canvases:write"],
+  edit_canvas: ["canvases:write"],
+  delete_canvas: ["canvases:write"],
+  lookup_canvas_sections: ["canvases:read"],
+  set_canvas_access: ["canvases:write"],
+  remove_canvas_access: ["canvases:write"],
+  create_channel_canvas: ["canvases:write"],
 };
 
 // Always grant the full user-scope superset alongside bot scopes. Slack mints
@@ -43,6 +152,8 @@ export const SLACK_USER_SCOPES: readonly string[] = [
   "mpim:read",
   "pins:read",
   "reactions:read",
+  "reminders:read",
+  "reminders:write",
   "search:read",
   "users:read",
   "users:read.email",

server/internal/platformtools/registry.go

@@ -64,6 +64,165 @@ var registry = []toolFactory{
 	func(deps Dependencies) PlatformToolExecutor {
 		return platformslack.NewListEmojiTool(deps.SlackHTTPClient)
 	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewChatUpdateTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewChatDeleteTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewChatPostEphemeralTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewChatGetPermalinkTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewChatDeleteScheduledMessageTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewChatListScheduledMessagesTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewChatMeMessageTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewGetChannelInfoTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewListChannelMembersTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewOpenConversationTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewCreateChannelTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewJoinChannelTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewLeaveChannelTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewInviteToChannelTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewSetChannelTopicTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewSetChannelPurposeTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewMarkConversationTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewArchiveChannelTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewUnarchiveChannelTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewRenameChannelTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewRemoveFromChannelTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewLookupUserByEmailTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewListUserConversationsTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewGetUserPresenceTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewGetUserProfileFieldsTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewGetUserDndTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewGetTeamDndTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewAddReminderTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewListRemindersTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewCompleteReminderTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewDeleteReminderTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewGetReminderTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewUploadFileTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewGetFileInfoTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewListFilesTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewDeleteFileTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewPinMessageTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewUnpinMessageTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewListPinsTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewAddBookmarkTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewEditBookmarkTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewRemoveBookmarkTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewListBookmarksTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewListUsergroupsTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewListUsergroupMembersTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewGetTeamInfoTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewCreateCanvasTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewEditCanvasTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewDeleteCanvasTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewLookupCanvasSectionsTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewSetCanvasAccessTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewRemoveCanvasAccessTool(deps.SlackHTTPClient)
+	},
+	func(deps Dependencies) PlatformToolExecutor {
+		return platformslack.NewCreateChannelCanvasTool(deps.SlackHTTPClient)
+	},
 }
 
 // BuildExecutors materializes executors for built-in plus caller-supplied

server/internal/platformtools/slack/canvas_types.go

@@ -0,0 +1,6 @@
+package slack
+
+type canvasDocumentContent struct {
+	Type     string `json:"type" jsonschema:"Document content type. Slack currently accepts \"markdown\"."`
+	Markdown string `json:"markdown" jsonschema:"Canvas body authored in Slack-flavoured markdown."`
+}

server/internal/platformtools/slack/tool_add_bookmark.go

@@ -0,0 +1,86 @@
+package slack
+
+import (
+	"context"
+	"io"
+
+	"github.com/speakeasy-api/gram/server/internal/guardian"
+	"github.com/speakeasy-api/gram/server/internal/platformtools/core"
+	"github.com/speakeasy-api/gram/server/internal/toolconfig"
+)
+
+const toolNameAddBookmark = "platform_slack_add_bookmark"
+
+type addBookmarkInput struct {
+	ChannelID string  `json:"channel_id" jsonschema:"Slack conversation ID to attach the bookmark to."`
+	Title     string  `json:"title" jsonschema:"Title shown in the channel bookmark bar."`
+	Type      string  `json:"type" jsonschema:"Bookmark type. Slack currently accepts \"link\"."`
+	Link      string  `json:"link" jsonschema:"URL the bookmark resolves to."`
+	Emoji     *string `json:"emoji,omitempty" jsonschema:"Optional emoji tag (e.g. \":memo:\") displayed alongside the bookmark."`
+	EntityID  *string `json:"entity_id,omitempty" jsonschema:"Optional ID of the bookmarked entity (messages or files only)."`
+	ParentID  *string `json:"parent_id,omitempty" jsonschema:"Optional ID of a parent bookmark to nest under."`
+}
+
+func NewAddBookmarkTool(httpClient *guardian.HTTPClient) core.PlatformToolExecutor {
+	readOnly := false
+	destructive := false
+	idempotent := false
+	openWorld := true
+
+	return &slackTool{
+		descriptor: core.ToolDescriptor{
+			SourceSlug:  sourceSlack,
+			HandlerName: "add_bookmark",
+			Name:        toolNameAddBookmark,
+			Description: "Add a bookmark to a Slack channel using the server's Slack token from SLACK_BOT_TOKEN or SLACK_TOKEN.",
+			InputSchema: core.BuildInputSchema[addBookmarkInput](),
+			Variables:   nil,
+			Annotations: slackToolAnnotations(readOnly, destructive, idempotent, openWorld),
+			Managed:     true,
+			OwnerKind:   nil,
+			OwnerID:     nil,
+		},
+		client: newAPIClient(defaultSlackAPIBaseURL, httpClient),
+		callFn: callAddBookmark,
+	}
+}
+
+func callAddBookmark(ctx context.Context, client *apiClient, env toolconfig.ToolCallEnv, payload io.Reader, wr io.Writer) error {
+	var input addBookmarkInput
+	if err := decodePayload(payload, &input); err != nil {
+		return err
+	}
+
+	channelID, err := requireString("channel_id", input.ChannelID)
+	if err != nil {
+		return err
+	}
+	title, err := requireString("title", input.Title)
+	if err != nil {
+		return err
+	}
+	bookmarkType, err := requireString("type", input.Type)
+	if err != nil {
+		return err
+	}
+	link, err := requireString("link", input.Link)
+	if err != nil {
+		return err
+	}
+
+	request := map[string]any{
+		"channel_id": channelID,
+		"title":      title,
+		"type":       bookmarkType,
+		"link":       link,
+	}
+	setOptionalString(request, "emoji", input.Emoji)
+	setOptionalString(request, "entity_id", input.EntityID)
+	setOptionalString(request, "parent_id", input.ParentID)
+
+	body, err := client.call(ctx, "bookmarks.add", request, tokenPreferBot, env)
+	if err != nil {
+		return err
+	}
+	return writeResponse(wr, body)
+}