@dreki-gg/pi-slack 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @dreki-gg/pi-slack
+
+## 0.2.0
+
+### Minor Changes
+
+- Add `slack_post_message` tool to post messages to a channel or reply in a thread. Posting is gated by the Slack app's `chat:write` OAuth scope (the bot must also be a member of the target channel); scope/permission errors from Slack are surfaced clearly.

package/extensions/slack/client/http.ts

@@ -1,4 +1,4 @@
-import { FetchHttpClient, HttpClient } from '@effect/platform';
+import { FetchHttpClient, HttpClient, HttpClientRequest } from '@effect/platform';
 import { Context, Effect, Layer, Schedule } from 'effect';
 import type { SlackCredentials } from '../config.js';
 import { SlackApiError, SlackAuthError, SlackRateLimitError } from './errors.js';
@@ -84,6 +84,56 @@ export function slackGet<T extends SlackOkResponse>(
   );
 }
 
+/**
+ * Make a POST request to a Slack Web API method with a JSON body.
+ * Handles auth injection, rate limiting (with retry), and error mapping.
+ */
+export function slackPost<T extends SlackOkResponse>(
+  method: string,
+  body: Record<string, unknown>,
+  options?: { useUserToken?: boolean },
+) {
+  return Effect.scoped(
+    Effect.gen(function* () {
+      const config = yield* SlackConfig;
+      const client = yield* HttpClient.HttpClient;
+
+      const token = options?.useUserToken ? config.userToken : config.botToken;
+      if (!token) {
+        return yield* new SlackAuthError({
+          reason: options?.useUserToken
+            ? 'SLACK_USER_TOKEN is required for this operation but not set'
+            : 'SLACK_BOT_TOKEN is required but not set',
+        });
+      }
+
+      const request = HttpClientRequest.post(`${SLACK_BASE_URL}/${method}`).pipe(
+        HttpClientRequest.setHeaders({ Authorization: `Bearer ${token}` }),
+        HttpClientRequest.bodyUnsafeJson(body),
+      );
+
+      const response = yield* client.execute(request);
+
+      // Handle rate limiting
+      if (response.status === 429) {
+        const retryAfter = Number(response.headers['retry-after']) || undefined;
+        return yield* new SlackRateLimitError({ method, retryAfter });
+      }
+
+      const json = (yield* response.json) as SlackResponse;
+
+      if (!json.ok) {
+        return yield* new SlackApiError({
+          method,
+          code: (json as SlackErrorResponse).error,
+        });
+      }
+
+      return json as T;
+    }),
+  );
+}
+
 /**
  * Download a file from Slack using bot token authentication.
  * Returns the raw ArrayBuffer.

package/extensions/slack/client/messages.ts

@@ -0,0 +1,43 @@
+import { Effect } from 'effect';
+import { slackPost } from './http.js';
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export interface PostMessageResult {
+  /** Timestamp of the posted message (also used as thread_ts for replies). */
+  ts: string;
+  /** Channel the message was posted to. */
+  channel: string;
+}
+
+// ---------------------------------------------------------------------------
+// Effects
+// ---------------------------------------------------------------------------
+
+export function postMessage(params: {
+  channel: string;
+  text: string;
+  threadTs?: string;
+  replyBroadcast?: boolean;
+}) {
+  return Effect.gen(function* () {
+    const body: Record<string, unknown> = {
+      channel: params.channel,
+      text: params.text,
+    };
+    if (params.threadTs !== undefined) body.thread_ts = params.threadTs;
+    if (params.replyBroadcast !== undefined) body.reply_broadcast = params.replyBroadcast;
+
+    const resp = yield* slackPost<{ ok: true; ts: string; channel: string }>(
+      'chat.postMessage',
+      body,
+    );
+
+    return {
+      ts: resp.ts,
+      channel: resp.channel,
+    } satisfies PostMessageResult;
+  });
+}

package/extensions/slack/format.ts

@@ -1,6 +1,7 @@
 import type { SlackChannel, SlackMessage, ReadMessagesResult } from './client/channels.js';
 import type { SearchResult } from './client/search.js';
 import type { DownloadedFile, SlackFileInfo } from './client/files.js';
+import type { PostMessageResult } from './client/messages.js';
 
 // ---------------------------------------------------------------------------
 // Channels
@@ -80,6 +81,20 @@ export function formatSearchResults(result: SearchResult, query: string): string
   return `${header}\n\n${matches.join('\n\n')}`;
 }
 
+// ---------------------------------------------------------------------------
+// Posting
+// ---------------------------------------------------------------------------
+
+export function formatPostedMessage(
+  result: PostMessageResult,
+  threadTs?: string,
+): string {
+  const where = threadTs
+    ? `thread ${threadTs} in ${result.channel}`
+    : `${result.channel}`;
+  return `✅ Message posted to ${where} (ts: ${result.ts})`;
+}
+
 // ---------------------------------------------------------------------------
 // Files
 // ---------------------------------------------------------------------------

package/extensions/slack/index.ts

@@ -14,12 +14,14 @@ import { listChannels } from './client/channels.js';
 import { readMessages, readThread } from './client/channels.js';
 import { searchMessages } from './client/search.js';
 import { downloadFile } from './client/files.js';
+import { postMessage } from './client/messages.js';
 import {
   formatChannelList,
   formatMessages,
   formatThread,
   formatSearchResults,
   formatDownloadedFile,
+  formatPostedMessage,
 } from './format.js';
 import {
   TOOL_GUIDELINES,
@@ -28,6 +30,7 @@ import {
   readThreadParams,
   searchParams,
   downloadFileParams,
+  postMessageParams,
 } from './tools.js';
 
 // ---------------------------------------------------------------------------
@@ -286,6 +289,51 @@ export default function slackExtension(pi: ExtensionAPI) {
     },
   });
 
+  // -------------------------------------------------------------------------
+  // slack_post_message
+  // -------------------------------------------------------------------------
+
+  pi.registerTool({
+    name: 'slack_post_message',
+    label: 'Slack Post Message',
+    description:
+      'Post a message to a Slack channel or reply in a thread. Requires the bot token to have the `chat:write` scope and the bot to be a member of the channel.',
+    promptSnippet: 'Post a message to a Slack channel or thread',
+    promptGuidelines: TOOL_GUIDELINES,
+    parameters: postMessageParams,
+
+    async execute(
+      _toolCallId: string,
+      params: {
+        channel: string;
+        text: string;
+        thread_ts?: string;
+        reply_broadcast?: boolean;
+      },
+    ) {
+      const creds = getCredentials();
+      if (!creds) return missingCredentials('bot');
+
+      try {
+        const result = await runSlack(
+          creds,
+          postMessage({
+            channel: params.channel,
+            text: params.text,
+            threadTs: params.thread_ts,
+            replyBroadcast: params.reply_broadcast,
+          }),
+        );
+        return textResult(formatPostedMessage(result, params.thread_ts), {
+          channel: result.channel,
+          ts: result.ts,
+        });
+      } catch (err) {
+        return errorResult(`❌ ${(err as Error).message}`);
+      }
+    },
+  });
+
   // -------------------------------------------------------------------------
   // /slack command — status check
   // -------------------------------------------------------------------------

package/extensions/slack/tools.ts

@@ -11,6 +11,7 @@ export const TOOL_GUIDELINES = [
   'Use `slack_read_thread` to read all replies in a thread. You need both the channel ID and the thread timestamp (thread_ts).',
   'Use `slack_search` for full-text search across the workspace. Requires SLACK_USER_TOKEN to be set.',
   'Use `slack_download_file` to download images or files shared in Slack. The tool saves files to a temp directory and returns the path — use `read` to view images.',
+  'Use `slack_post_message` to send a message to a channel or reply in a thread. The bot token must have the `chat:write` scope and the bot must be a member of the target channel.',
   'When messages reference files or images (shown with 📎), download them with `slack_download_file` using the file ID to get visual context.',
   'Channel IDs look like C0123ABC456. Thread timestamps look like 1512085950.000216.',
 ];
@@ -113,3 +114,23 @@ export const downloadFileParams = Type.Object({
     description: 'Slack file ID to download (e.g. F0123ABC456).',
   }),
 });
+
+export const postMessageParams = Type.Object({
+  channel: Type.String({
+    description: 'Channel ID (e.g. C0123ABC456) or #channel-name to post to.',
+  }),
+  text: Type.String({
+    description: 'Message text. Supports Slack mrkdwn formatting.',
+  }),
+  thread_ts: Type.Optional(
+    Type.String({
+      description: 'Reply within this thread (the parent message ts).',
+    }),
+  ),
+  reply_broadcast: Type.Optional(
+    Type.Boolean({
+      description:
+        'When replying in a thread, also broadcast the reply to the channel. Default false.',
+    }),
+  ),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreki-gg/pi-slack",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Slack read tools for pi — messages, threads, channels, search, and file/image downloads with Effect-powered client",
   "keywords": [
     "pi-package",