@nimbus-dev/connectors 0.6.0 → 0.7.0

package/connectors/slack/src/tools.ts

@@ -102,9 +102,17 @@ export const SLACK_TOOL_NAMES = [
   "slack_message_post_dm",
   "slack_user_info",
   "slack_chat_post",
+  "slack_views_open",
   "slack_socket_open",
 ] as const;
 
+/** Largest serialised `blocks` array / `view` object Slack accepts from this connector (16 KiB). */
+export const SLACK_PAYLOAD_MAX_BYTES = 16 * 1024;
+
+function serialisedBytes(value: unknown): number {
+  return new TextEncoder().encode(JSON.stringify(value)).length;
+}
+
 export function registerSlackTools(
   server: ConsentServer & { tool: (...args: never) => unknown },
 ): void {
@@ -122,7 +130,7 @@ export function registerSlackTools(
     scopeEnv: "NIMBUS_MCP_SLACK_WRITE_SCOPE",
     // `user` scopes a direct message by the recipient's user id, which is all a DM has before
     // `conversations.open` creates its channel.
-    scopeKinds: ["channel", "user"],
+    scopeKinds: ["channel", "user", "view"],
   });
 
   const slackChannelListSchema = z.object({
@@ -341,7 +349,19 @@ export function registerSlackTools(
       ),
   );
 
-  const slackChatPostSchema = z.object({ channel: z.string().min(1), text: z.string().min(1) });
+  const slackChatPostSchema = z.object({
+    channel: z.string().min(1),
+    text: z.string().min(1),
+    // Block Kit blocks, sent to Slack verbatim beside `text` (which stays the notification fallback).
+    blocks: z
+      .array(z.looseObject({ type: z.string() }))
+      .min(1)
+      .max(50)
+      .refine((b) => serialisedBytes(b) <= SLACK_PAYLOAD_MAX_BYTES, {
+        message: `blocks must serialise to at most ${SLACK_PAYLOAD_MAX_BYTES} bytes`,
+      })
+      .optional(),
+  });
   registerWriteTool(
     "slack_chat_post",
     {
@@ -351,12 +371,43 @@ export function registerSlackTools(
     },
     "Post an operational bot message to a channel (ChatOps reply surface; bot token).",
     slackChatPostSchema,
-    async (parsed) =>
-      slackInvokeJsonWithToken(
+    async (parsed) => {
+      const body: Record<string, unknown> = { channel: parsed.channel, text: parsed.text };
+      if (parsed.blocks !== undefined) {
+        body["blocks"] = parsed.blocks;
+      }
+      return slackInvokeJsonWithToken(
         requireProcessEnv("SLACK_BOT_TOKEN"),
         "chat.postMessage",
-        { channel: parsed.channel, text: parsed.text },
+        body,
         "Slack chat.postMessage",
+      );
+    },
+  );
+
+  const slackViewsOpenSchema = z.object({
+    trigger_id: z.string().min(1),
+    view: z
+      .looseObject({ type: z.literal("modal") })
+      .refine((v) => serialisedBytes(v) <= SLACK_PAYLOAD_MAX_BYTES, {
+        message: `view must serialise to at most ${SLACK_PAYLOAD_MAX_BYTES} bytes`,
+      }),
+  });
+  registerWriteTool(
+    "slack_views_open",
+    {
+      mutates: "slack.views.open",
+      recoverable: true,
+      scopeTargetOf: () => ({ kind: "view", value: "modal" }),
+    },
+    "Open a confirmation modal for a user who clicked a ChatOps card button (ChatOps operational surface; bot token).",
+    slackViewsOpenSchema,
+    async (parsed) =>
+      slackInvokeJsonWithToken(
+        requireProcessEnv("SLACK_BOT_TOKEN"),
+        "views.open",
+        { trigger_id: parsed.trigger_id, view: parsed.view },
+        "Slack views.open",
       ),
   );
 

package/connectors/teams/src/bot-send.ts

@@ -55,10 +55,14 @@ function serviceUrlBase(): string {
   return base.endsWith("/") ? base : `${base}/`;
 }
 
-/** Send a plain-text message activity to a Teams conversation via the Bot Framework. */
+/**
+ * Send a message activity to a Teams conversation via the Bot Framework. `attachments` (an Adaptive
+ * Card) goes into the activity body only when given.
+ */
 export async function teamsBotSendActivity(
   conversationId: string,
   text: string,
+  attachments?: readonly unknown[],
 ): Promise<GraphLikeResult> {
   const appId = requireProcessEnv("TEAMS_BOT_APP_ID");
   const appPassword = requireProcessEnv("TEAMS_BOT_APP_PASSWORD");
@@ -67,6 +71,10 @@ export async function teamsBotSendActivity(
   return fetchBearerAuthorizedJson(url, token, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ type: "message", text }),
+    body: JSON.stringify(
+      attachments === undefined
+        ? { type: "message", text }
+        : { type: "message", text, attachments },
+    ),
   });
 }

package/connectors/teams/src/tools.ts

@@ -14,6 +14,9 @@ import {
 } from "../../../shared/mcp-tool-kit.ts";
 import { teamsBotSendActivity } from "./bot-send.ts";
 
+/** Largest serialised `attachments` array `teams_chat_post` accepts (28 KiB). */
+export const TEAMS_ATTACHMENTS_MAX_BYTES = 28 * 1024;
+
 const GRAPH = "https://graph.microsoft.com/v1.0";
 
 async function graphRequest(
@@ -265,6 +268,20 @@ export function registerTeamsTools(
   const teamsChatPostSchema = z.object({
     conversationId: z.string().min(1),
     text: z.string().min(1),
+    // Exactly one Adaptive Card, sent in the activity verbatim; at most 28 KiB serialised.
+    attachments: z
+      .array(
+        z.object({
+          contentType: z.literal("application/vnd.microsoft.card.adaptive"),
+          content: z.record(z.string(), z.unknown()),
+        }),
+      )
+      .length(1)
+      .refine(
+        (a) => new TextEncoder().encode(JSON.stringify(a)).length <= TEAMS_ATTACHMENTS_MAX_BYTES,
+        { message: `attachments must serialise to at most ${TEAMS_ATTACHMENTS_MAX_BYTES} bytes` },
+      )
+      .optional(),
   });
   registerWriteTool(
     "teams_chat_post",
@@ -276,7 +293,7 @@ export function registerTeamsTools(
     "Post an operational bot message to a Teams conversation (ChatOps reply surface; bot app creds).",
     teamsChatPostSchema,
     async (parsed) => {
-      const r = await teamsBotSendActivity(parsed.conversationId, parsed.text);
+      const r = await teamsBotSendActivity(parsed.conversationId, parsed.text, parsed.attachments);
       return graphListResult(r);
     },
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimbus-dev/connectors",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "publishConfig": {
     "access": "public"
   },